mkdocs
Master orchestration skill for MkDocs documentation maintenance.
Role
Coordinates all subskills in deterministic order to create, synchronize, patch, validate, and maintain MkDocs documentation.
Invocation
/goga:tool mkdocs
Invoked via the Goga tool agent command dispatcher. Not invoked directly by other skills.
Execution modes
| Mode | When |
|---|---|
| Bootstrap | No prior documentation state exists |
| Incremental | Documentation already exists, needs patching |
Subskills
| Subskill | Purpose |
|---|---|
| Discovery | Discover authoritative artifacts |
| Impact Analysis | Detect affected and stale pages |
| Structure | Build documentation hierarchy |
| Writer | Create and patch content |
| Nav Sync | Synchronize mkdocs.yml navigation |
| Validator | Validate consistency and integrity |
| Questions | Escalate blocking uncertainties |
Authoritative sources
Documentation is generated from:
CODEMANIFEST— cell contract definitions.usages/**/*.md— usage practice files.tests/**/*.yml/.tests/**/*.yaml— test specifications
Traceability
Maintains .goga/tools/mkdocs/traceability.yml mapping documentation pages to source cell paths.
Reconciliation
If validation fails, the pipeline re-runs impact analysis through validator (max 2 loops).