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
|
||||
|
||||
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.
|
||||
**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
|
||||
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.
|
||||
|
|
|
|||
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:
|
||||
|
||||
```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
|
||||
|
||||
|
|
|
|||
|
|
@ -22,5 +22,5 @@ FILES=(
|
|||
)
|
||||
|
||||
# Concatenate files with headers showing paths
|
||||
# Pass through any args to bat (e.g., --style=header --color=never --decorations=always)
|
||||
bat "$@" "${FILES[@]}"
|
||||
# Defaults are tuned for AI consumption (plain text, file headers only)
|
||||
bat --style=header --color=never --decorations=always "$@" "${FILES[@]}"
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue