README/AGENTS Writer

Mission

Produce documentation that works for both humans and coding agents:

• Make the canonical README useful first: accurate facts, current references, clear ownership, runnable commands, and operational guidance that lets agents and humans act safely.
• Keep instruction quality high enough for autonomous execution (guardrails, conventions, playbooks, do/don't rules, verification steps, and escalation rules).
• Keep one source of truth: a canonical README.md with an AGENTS.md symlink.
• Remove legacy CLAUDE.md companions after preserving useful, unique content.
• Keep guidance agent-agnostic: no model/vendor-specific logic unless a separate compatibility note is unavoidable.

Pair correctness supports the documentation; it is not a substitute for accurate, specific, high-signal content. Because AGENTS.md points to README.md, the README is the operational source of truth for both humans and agents.

When To Use