Add agent change process (C0/C1/C2) and docs-mikado tool #225
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "feature/agent-change-process"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Summary
docs-mikadomise task to visualize active Mikado dependency chains fromstatus: activeandrequiresfrontmatter fieldszk-docstask toai-docsChanges
docs/how-to/agent-change-process.md— methodology cardmise-tasks/docs-mikado— Python uv script for dependency graph visualizationmise-tasks/zk-docs→mise-tasks/ai-docsCLAUDE.md— added Change Classification section, updated referencesai-assistance-guide.md,exploring-the-docs.md,how-to.md— updated references and indexVerification
mise run ai-docsworksmise run docs-mikadoruns (no active chains yet, as expected)docs-check-links— all validdocs-check-index— all indexeddocs-check-frontmatter— all valid🤖 Generated with Claude Code
@ -0,0 +8,4 @@# Agent Change Process> **Audiences:** AI, OwnerHow-to articles don't need explicit audiences, only tutorials
@ -0,0 +35,4 @@Use the [Mikado method](https://mikadomethod.info/) within a single session:1. Run `mise run ai-docs` to load context2. Attempt the change on a feature branchThis won't work for changes that require commits due to gitops. Instead, encourage the use of amending a single commit, and actually reverting when an error occurs. Same for C2.
@ -0,0 +69,4 @@---title: Deploy Authentikstatus: active # omit when completerequires: # explicit dependenciesAh, lets add something to the frontmatter doc check.
statusandrequiresshould only be permitted for docs withindocs/how-to.@ -0,0 +92,4 @@- Single feature branch per C1/C2 change- Always revert broken working tree changes — don't leave broken code committed- Broken commits may happen (GitOps requires pushing to test) but must be reverted promptlyyeah this is what I was talking about above, so you get the idea
@ -0,0 +3,4 @@# requires-python = ">=3.12"# dependencies = ["pyyaml>=6.0", "rich>=13.0.0", "typer>=0.15.0"]# ///#MISE description="View active Mikado dependency chains for C1/C2 changes"Check some other scripts, I think MISE has a USAGE hint and maybe others which make it so you don't need
-- arg1 arg2to separate the mise task args.@ -0,0 +46,4 @@def build_graph() -> dict[str, dict]:"""Build the dependency graph from all docs."""Do we detect circular dependencies here? let's make sure we do. Just a set of all encountered filenames maybe?
2e692549f2to6f0a72445f