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

Add agent change process (C0/C1/C2) and docs-mikado tool (#225)

Browse source 
## Summary
- Introduce C0/C1/C2 change classification based on the Mikado method, where documentation cards serve as persistent context for agents across sessions
- Add `docs-mikado` mise task to visualize active Mikado dependency chains from `status: active` and `requires` frontmatter fields
- Rename `zk-docs` task to `ai-docs`

## Changes
- **New:** `docs/how-to/agent-change-process.md` — methodology card
- **New:** `mise-tasks/docs-mikado` — Python uv script for dependency graph visualization
- **Renamed:** `mise-tasks/zk-docs` → `mise-tasks/ai-docs`
- **Updated:** `CLAUDE.md` — added Change Classification section, updated references
- **Updated:** `ai-assistance-guide.md`, `exploring-the-docs.md`, `how-to.md` — updated references and index

## Verification
- [x] `mise run ai-docs` works
- [x] `mise run docs-mikado` runs (no active chains yet, as expected)
- [x] `docs-check-links` — all valid
- [x] `docs-check-index` — all indexed
- [x] `docs-check-frontmatter` — all valid
- [x] All pre-commit hooks pass

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Reviewed-on: https://forge.ops.eblu.me/eblume/blumeops/pulls/225
This commit is contained in:
Erich Blume 2026-02-20 08:15:20 -08:00
commit c1f7b2a9a3
9 changed files with 439 additions and 14 deletions
Download patch file Download diff file Expand all files Collapse all files

6
docs/tutorials/exploring-the-docs.md
View file

@ -33,7 +33,7 @@ You probably want quick access to operational details:
- [[plans]] captures migration and transition plans for future execution
- [[reference]] has service URLs, commands, and config locations
- [[ai-assistance-guide]] explains how to work effectively with Claude
- Run `mise run zk-docs` to prime AI context with key documentation
- Run `mise run ai-docs` to prime AI context with key documentation
### For Claude/AI Agents
@ -77,10 +77,10 @@ Pre-commit hooks automatically validate that all wiki-links point to existing fi
## AI Context Priming
The `zk-docs` mise task concatenates key documentation files for AI context:
The `ai-docs` mise task concatenates key documentation files for AI context:
```bash
mise run zk-docs -- --style=header --color=never --decorations=always
mise run ai-docs -- --style=header --color=never --decorations=always
```
This outputs the AI assistance guide, reference index, how-to index, architecture overview, and tutorials index - providing Claude with essential context for BlumeOps operations.