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

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

View file

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