What problem does it solve? Structural changes in agent-operated repositories often go undocumented, leaving decisions trapped in chat context, stale plan files polluting the repo, and documentation drifting away from the project's charter. This Skill enforces a complete Decide → Document → Cleanup governance loop so every architectural decision is recorded, living docs stay current, and scratch artifacts are removed. ## Core Features & Use Cases - Governance Loop Orchestration: Walks agents through ethics checks, North Star impact classification (none, applies, clarifies, sub_star, amends, conflicts), ADR authoring, FAQ updates, brand tone enforcement, and plan hygiene. - Decision & Documentation Standards: Bundled references define MADR/Nygard ADR formats with T1-T8 decision checkpoints, DESIGN_FAQ/DX_FAQ structuring rules, brand guidelines with banned marketing words, and evidence routing rules. - Drift & Claim Verification: Routes claim upgrades through steward claim check evidence gates and dispositions stale docs into keep, merge, ADR, FAQ, skill, check, evidence, or delete outcomes. - Use Case: An agent proposes making repair-first the new center of a repository. The Skill classifies this as an amends North Star impact, requires an ADR plus a North Star diff before implementation, updates the DESIGN_FAQ, and deletes the temporary planning files once knowledge is durable. ## Quick Start Ask the agent to write an ADR and update the DESIGN_FAQ for a proposed architectural change using the repository-governance-lifecycle skill.
