Bake default display options into ai-docs mise task
The --style=header --color=never --decorations=always flags are now built into the script so callers can just run `mise run ai-docs`. Also adds a note to CLAUDE.md to never truncate the output. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
parent
de54b4e33d
commit
23dc79058e
4 changed files with 7 additions and 5 deletions
|
|
@ -12,8 +12,9 @@ blumeops is Erich Blume's GitOps repository for personal infrastructure, orchest
|
||||||
|
|
||||||
## Rules
|
## Rules
|
||||||
|
|
||||||
1. **Always run `mise run ai-docs -- --style=header --color=never --decorations=always` at session start**
|
1. **Always run `mise run ai-docs` at session start**
|
||||||
This will refresh your context with important information you will be assumed to know and follow.
|
This will refresh your context with important information you will be assumed to know and follow.
|
||||||
|
**Read the full output** — never truncate, pipe to `head`/`tail`, or skip sections.
|
||||||
2. **Always use `--context=minikube-indri` with kubectl** (or `--context=k3s-ringtail` for ringtail services) - work contexts must never be touched
|
2. **Always use `--context=minikube-indri` with kubectl** (or `--context=k3s-ringtail` for ringtail services) - work contexts must never be touched
|
||||||
3. **Classify the change as C0/C1/C2 before starting** (see below) — this determines branching and PR requirements
|
3. **Classify the change as C0/C1/C2 before starting** (see below) — this determines branching and PR requirements
|
||||||
4. **Feature branches + PRs for C1/C2** - checkout main, pull, create branch, open PR via `tea pr create`. C0 goes direct to main.
|
4. **Feature branches + PRs for C1/C2** - checkout main, pull, create branch, open PR via `tea pr create`. C0 goes direct to main.
|
||||||
|
|
|
||||||
1
docs/changelog.d/ai-docs-defaults.ai.md
Normal file
1
docs/changelog.d/ai-docs-defaults.ai.md
Normal file
|
|
@ -0,0 +1 @@
|
||||||
|
Bake default bat options into `ai-docs` mise task so agents no longer need verbose flags at session start.
|
||||||
|
|
@ -80,10 +80,10 @@ Pre-commit hooks automatically validate that all wiki-links point to existing fi
|
||||||
The `ai-docs` mise task concatenates key documentation files for AI context:
|
The `ai-docs` mise task concatenates key documentation files for AI context:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
mise run ai-docs -- --style=header --color=never --decorations=always
|
mise run ai-docs
|
||||||
```
|
```
|
||||||
|
|
||||||
This outputs the AI assistance guide, reference index, how-to index, architecture overview, and tutorials index - providing Claude with essential context for BlumeOps operations.
|
This outputs the AI assistance guide, reference index, how-to index, architecture overview, and tutorials index in plain text with file headers - providing Claude with essential context for BlumeOps operations.
|
||||||
|
|
||||||
## Related
|
## Related
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -22,5 +22,5 @@ FILES=(
|
||||||
)
|
)
|
||||||
|
|
||||||
# Concatenate files with headers showing paths
|
# Concatenate files with headers showing paths
|
||||||
# Pass through any args to bat (e.g., --style=header --color=never --decorations=always)
|
# Defaults are tuned for AI consumption (plain text, file headers only)
|
||||||
bat "$@" "${FILES[@]}"
|
bat --style=header --color=never --decorations=always "$@" "${FILES[@]}"
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue