From 5b008a6ab6c822c7a062a14b27ec6aecb4f0c40f Mon Sep 17 00:00:00 2001 From: Erich Blume Date: Sun, 15 Mar 2026 18:43:39 -0700 Subject: [PATCH] Document ai-sources in AI guide, change process, and mise-tasks ref Co-Authored-By: Claude Opus 4.6 (1M context) --- docs/how-to/agent-change-process.md | 2 ++ docs/reference/tools/mise-tasks.md | 3 ++- docs/tutorials/ai-assistance-guide.md | 3 ++- 3 files changed, 6 insertions(+), 2 deletions(-) diff --git a/docs/how-to/agent-change-process.md b/docs/how-to/agent-change-process.md index ed7702d..dca2b36 100644 --- a/docs/how-to/agent-change-process.md +++ b/docs/how-to/agent-change-process.md @@ -23,6 +23,8 @@ Before starting work, classify the change: When in doubt, start at C1. Upgrade to C2 if complexity spirals or the user requests it. +**Context loading:** All change classes start with `mise run ai-docs` (~85K tokens of documentation). For problems with a large surface area, ask the user if `mise run ai-sources` should also be run — it concatenates all non-doc source files (~270K tokens). Together they cover the full codebase without overlap. + ## C0 — Quick Fix A change where the risk is low enough that problems can be quickly fixed forward. diff --git a/docs/reference/tools/mise-tasks.md b/docs/reference/tools/mise-tasks.md index baacf10..d2385a6 100644 --- a/docs/reference/tools/mise-tasks.md +++ b/docs/reference/tools/mise-tasks.md @@ -17,7 +17,8 @@ Run `mise tasks --sort name` for the live list with descriptions. | Task | Description | |------|-------------| -| `ai-docs` | Prime AI context with key documentation and doc tree | +| `ai-docs` | All documentation concatenated for AI context (~85K tokens) | +| `ai-sources` | All non-doc source files for deep AI context (~270K tokens) | | `docs-check-frontmatter` | Check required frontmatter fields | | `docs-check-links` | Validate wiki-links resolve correctly (supports path-based links) | | `docs-mikado` | View active Mikado dependency chains (C2 changes) | diff --git a/docs/tutorials/ai-assistance-guide.md b/docs/tutorials/ai-assistance-guide.md index 8b54290..9138526 100644 --- a/docs/tutorials/ai-assistance-guide.md +++ b/docs/tutorials/ai-assistance-guide.md @@ -91,7 +91,8 @@ BlumeOps operations are driven by mise tasks. Run `mise tasks` to list all avail | Task | When to Use | |------|-------------| -| `ai-docs` | At session start - review infrastructure documentation (see [[mise-tasks]]) | +| `ai-docs` | At session start - all documentation concatenated for AI context (~85K tokens, see [[mise-tasks]]) | +| `ai-sources` | Deep context - all non-doc source files (~270K tokens). Ask user before running; useful for problems with a large surface area | | `docs-mikado` | View active Mikado dependency chains for C2 changes | | `docs-mikado --resume` | Resume a C2 chain: detect branch, show state and next steps | | `provision-indri` | Deploy changes to [[indri]]-hosted services via Ansible |