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:
Erich Blume 2026-02-25 17:42:47 -08:00
commit 23dc79058e
4 changed files with 7 additions and 5 deletions

View file

@ -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.

View file

@ -0,0 +1 @@
Bake default bat options into `ai-docs` mise task so agents no longer need verbose flags at session start.

View file

@ -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

View file

@ -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[@]}"