root-archetype

Lint, query, and maintain the project knowledge base. Use when auditing KB health, searching for compiled knowledge, or checking governance hygiene. Do not use when ingesting new research (use research-intake if available).

Ingest external sources into structured knowledge base. Use when user provides research material, URLs, papers, or says "research intake", "ingest this", "add to knowledge base". Do NOT use for querying existing knowledge (use project-wiki instead).

Create a structured handoff document for cross-session or cross-agent work tracking. Use when user says "new handoff", "create handoff", "track work item", "document this for next session", or needs to pass work to another session/agent. Do NOT use for reading or updating existing handoffs.

Guided project initialization wizard. Use when .needs-init exists in project root (detected by session-start hook). Do NOT use on already-initialized projects. Walks through 9 interactive setup steps.

Scaffold a new Claude Code skill with correct folder structure, YAML frontmatter, gotchas section, and progressive disclosure. Use when user says "create a skill", "new skill", "scaffold skill", "add a skill", or wants to build a reusable capability. Do NOT use when user wants to edit an existing skill.

Commit changes with staged-diff secret scanning and branch protection guardrails. Use when user says "safe commit", "safe-commit", or "commit with checks". Do NOT use for regular commits — this is an opt-in extra layer on top of normal git workflow.

Review changed code for reuse, quality, and efficiency, then fix any issues found. Use when user says "simplify", "review code", "clean up", "refactor", "reduce complexity", or after completing a significant code change. Do NOT use for general code questions, debugging, or feature implementation.