README/AGENTS/CLAUDE Writer

Mission

Produce documentation that works for both humans and coding agents:

• Keep the 3-file schema strict (README.md, AGENTS.md, CLAUDE.md).
• Keep the instruction quality high enough for autonomous execution (guardrails, conventions, playbooks, do/don't rules, verification steps, and escalation rules).
• Keep guidance agent-agnostic: no model/vendor-specific logic unless a separate compatibility note is unavoidable.

If AGENTS.md and CLAUDE.md symlink to README.md, the README is no longer "just a project readme"; it is the full operational source of truth.

When To Use

• Creating or updating documentation triplets (README.md, AGENTS.md, CLAUDE.md)
• Converting dedicated AGENTS.md / CLAUDE.md files to symlinked companions
• Refactoring large docs while keeping agent guidance accurate, explicit, and current
• Strengthening weak instruction files that are vague, stale, or hard for agents to execute safely