What problem does it solve? Drafting governance-compliant documentation (GUIDE, RUNBOOK, ADR, SPEC, and more) in the mj-agent repository requires knowing 12 document types, 9 templates, track assignment rules, directory placement rules, and naming conventions. This Skill automates that entire authoring workflow so each document lands in the right directory with the right frontmatter, filename, and template. ## Core Features & Use Cases - Track-aware dispatch: Automatically assigns each document to the code, agent, engineering-workflow, or shared track using the Meta v2.1 path-to-track decision tree. - Full authoring pipeline: Covers ADR/SPEC prechecks, directory placement, template selection, filename construction with glob-based conflict checks, content generation verified against actual code, and handoff to doc validation. - HITL guardrails for in-source docs: Enforces mandatory human review (Q-B1) before writing SKILL.md or prompt files under src/mj_agent, routing changes through runtime propose-diff flows. - Use Case: After a Stage 6 planning session decides a new ADR is needed, invoke this Skill to scan existing ADR numbers, pick the next number, apply TEMPLATE_ADR.md, and produce a draft document ready for validation. ## Quick Start Ask the agent to draft an ADR for the LLM provider abstraction decision in the mj-agent repository and validate it afterward.
