eblume/blumeops
1
1
Fork 0
Code Issues Pull requests Projects Releases 83 Packages Wiki Activity Actions

Document ai-sources in AI guide, change process, and mise-tasks ref

Browse source 
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Erich Blume 2026-03-15 18:43:39 -07:00
commit 5b008a6ab6
3 changed files with 6 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

2
docs/how-to/agent-change-process.md
View file

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

3
docs/reference/tools/mise-tasks.md
View file

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

3
docs/tutorials/ai-assistance-guide.md
View file

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