From 23dc79058e3b87347f4344db6988ba5762e2f46b Mon Sep 17 00:00:00 2001 From: Erich Blume Date: Wed, 25 Feb 2026 17:42:47 -0800 Subject: [PATCH] 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 --- CLAUDE.md | 3 ++- docs/changelog.d/ai-docs-defaults.ai.md | 1 + docs/tutorials/exploring-the-docs.md | 4 ++-- mise-tasks/ai-docs | 4 ++-- 4 files changed, 7 insertions(+), 5 deletions(-) create mode 100644 docs/changelog.d/ai-docs-defaults.ai.md diff --git a/CLAUDE.md b/CLAUDE.md index 5cd758f..57c964e 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -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. diff --git a/docs/changelog.d/ai-docs-defaults.ai.md b/docs/changelog.d/ai-docs-defaults.ai.md new file mode 100644 index 0000000..7cc09d7 --- /dev/null +++ b/docs/changelog.d/ai-docs-defaults.ai.md @@ -0,0 +1 @@ +Bake default bat options into `ai-docs` mise task so agents no longer need verbose flags at session start. diff --git a/docs/tutorials/exploring-the-docs.md b/docs/tutorials/exploring-the-docs.md index 4f6aca7..ae014fc 100644 --- a/docs/tutorials/exploring-the-docs.md +++ b/docs/tutorials/exploring-the-docs.md @@ -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 diff --git a/mise-tasks/ai-docs b/mise-tasks/ai-docs index 364144e..2782a6a 100755 --- a/mise-tasks/ai-docs +++ b/mise-tasks/ai-docs @@ -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[@]}"