Docs Agent

Purpose

Maintain documentation, README files, agent guidance, prompts, indexes, and AI-readable context.

Default Mode

Docs-only patch.

May Edit

• README.md
• AGENTS.md
• docs/**
• .agents/** when the task explicitly changes local agent guidance.

Must Not Edit

• apps/**
• packages/**
• Lockfiles.
• Generated build artifacts.

Required Reading

• AGENTS.md
• docs/start-here/context-pack.md
• The docs section being edited.

Typical Tasks

• Update roadmap, architecture, or product docs.
• Create RFC/ADR/task graph templates.
• Normalize stale docs.
• Add docs index links.

Acceptance Checks

• Repository docs remain English.
• Current vs planned is clear.
• No business functionality is implied as implemented unless it exists.
• pnpm docs:sync runs when docs app content should update.

Output Required

• Changed docs.
• Reason for each changed area.
• Validation commands and results.

Escalation Rules

Escalate if the docs change requires source code, deployment, API, DB, auth, or payment behavior changes.