## 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
25 lines
870 B
Bash
Executable file
25 lines
870 B
Bash
Executable file
#!/usr/bin/env bash
|
|
#MISE description="Prime AI context with key BlumeOps documentation (formerly zk-docs)"
|
|
|
|
set -euo pipefail
|
|
|
|
DOCS_DIR="$(cd "$(dirname "$0")/.." && pwd)/docs"
|
|
|
|
# Key files for AI context priming, in order of importance
|
|
FILES=(
|
|
"$DOCS_DIR/tutorials/ai-assistance-guide.md"
|
|
"$DOCS_DIR/how-to/agent-change-process.md"
|
|
"$DOCS_DIR/index.md"
|
|
"$DOCS_DIR/reference/reference.md"
|
|
"$DOCS_DIR/how-to/how-to.md"
|
|
"$DOCS_DIR/how-to/operations/troubleshooting.md"
|
|
"$DOCS_DIR/how-to/plans/plans.md"
|
|
"$DOCS_DIR/how-to/plans/completed/completed.md"
|
|
"$DOCS_DIR/explanation/explanation.md"
|
|
"$DOCS_DIR/explanation/architecture.md"
|
|
"$DOCS_DIR/tutorials/tutorials.md"
|
|
)
|
|
|
|
# Concatenate files with headers showing paths
|
|
# Pass through any args to bat (e.g., --style=header --color=never --decorations=always)
|
|
bat "$@" "${FILES[@]}"
|