makinari-agents-md

To generate a canonical AGENTS.md operating manual, run this skill during bootstrap or when the orchestrator switches flow types. It creates an authoritative operating manual at the repository root, enforcing template guidelines, section order, and append-only revisions.

AGENTS.md versioning works by moving older content into a collapsed Legacy section while writing the new canonical body. This append-only approach ensures historical decisions are preserved and previous content is not overwritten by sibling skills.

You need to update the AGENTS.md governance file at bootstrap or when the orchestrator switches the active flow type. This ensures the repository root maintains a single authoritative operating manual with correct governance rules and anchors for future changes.

Yes, you can maintain consistent project documentation across branches. The skill defines governance rules and anchors for future changes, ensuring a stable, read-mostly operating manual that serves as the primary project contract across teams.

The best way to prevent sibling skills from overwriting repository documentation is using this skill to enforce append-only revisions in AGENTS.md. It moves older content into a Legacy section rather than rewriting, ensuring a stable operating manual.

AGENTS.md generation requires no specific dependencies or components. The skill operates independently to automate the creation and maintenance of the canonical operating manual, applying template guidelines and legacy handling without external module requirements.