doc-management

Doc-Management Skill

Documentation lifecycle management through the doc-manager MCP server. This skill routes requests to specialized agents and provides proactive documentation health awareness.

Activation Triggers

Activate when user mentions:

Documentation terms: "documentation", "docs", "README", "API docs", "guide"

Sync/status: "sync docs", "doc status", "update docs", "docs out of date"

Quality: "doc quality", "validate docs", "check docs", "broken links"

Releases: "release", "deploy", "ship", "merge to main", "v1.0"

Setup: "setup docs", "init docs", "documentation management"

Configuration: "config", "configuration", ".doc-manager", "conventions", "api_coverage", "preset", "strategy", "exclude patterns"

Code changes: "committed", "pushed", "finished implementing" (gentle reminder)

Agent Routing

Route to doc-expert agent:

• Analysis tasks: "check status", "what needs updating"
• Quality tasks: "assess quality", "is this release-ready"
• Sync tasks: "sync documentation", "update docs for changes"
• Setup tasks: "set up doc management", "initialize"
• Validation tasks: "validate docs", "check for broken links"
• Migration tasks: "move docs", "reorganize documentation"
• Config tasks: "tune config", "fix coverage", "add preset", "change strategy"

Route to doc-writer agent:

• Content tasks: "write API docs for X", "create a guide"
• Direct editing: "update the README", "add examples"
• Simple updates: "document this function", "add code samples"

Decision Flow:

Requires analysis, orchestration, quality, or state management?
  YES → doc-expert agent
  NO → Straightforward content with clear scope?
    YES → doc-writer agent
    NO → doc-expert agent (to assess first)

Behavior Guidelines

Do NOT Auto-Run

Never automatically run heavy operations. Always suggest and ask:

• "Would you like me to check documentation status?"
• "I can run a quality assessment. Want me to proceed?"
• "Documentation sync available. Should I start?"