manage-docs
Installation
SKILL.md
manage-docs
Register and maintain project spec documents (PRD, SRS, ERD, ADR, sitemap, architecture notes) so AI agents know where to find them when they need product or design context.
This skill manages document location and registration, not document content. It does not read status fields, sync content between sources, resolve merge conflicts, or validate document quality. See Out of Scope for the boundaries.
Two modes are supported:
- In-repo folder — A managed
INDEX.mdlives next to spec files (e.g.,docs/specs/INDEX.md). The index is the source of truth for which specs exist and are active. - External platform — Specs live in Notion, Linear, Confluence, GitBook, Obsidian, or another tool with an MCP server. The platform itself is the index; this skill only adds usage convention to AGENTS.md.
Guardrails
| # | Check | On failure |
|---|---|---|
| 1 | CWD is a Git repository | "Please run this inside a Git repository." |
| 2 | AGENTS.md exists (warning, non-blocking) | "AGENTS.md not found. Run /init-public-rules first for best results. Continuing." |
| 3 | Attempting to register an out-of-scope file (README, CHANGELOG, AGENTS.md, auto-generated docs) | " is not a managed spec type. See references/managed-doc-types.md for the in-scope list. Stopping." |
Related skills