The Claude/Agents.md Collaboration Contract
joematthewsdev · reddit · 2026-07-20
The author shares their `CLAUDE/AGENTS.md` conventions, reporting "excellent" results. The core idea is to write human-agent collaboration as a shared contract: - Emphasizes pragmatism, curiosity, helpfulness, asking for consent, and semantic unambiguity. - Prefers wrapping CLI tools into custom scripts before passing them to agents; only uses MCP when local CLI falls short. - Requires sketching changes before making actual modifications to avoid jumping the gun. - Outputs results alongside assumptions, making premises visible at the outcome stage. - Mandates the use of ASCII only throughout, avoiding unicode characters entirely.
More from coding & agent
- TokenPrint turns Qwen inference into a DevTools-style visual debugger — Rich-Fruit-326 · 2026-07-21
- This week's must-read AI papers span agents, long-context RL, and robot policies — TheTuringPost · 2026-07-21
- Mingle uses MCP to let agents find collaborators without profiles — PassionGlittering106 · 2026-07-21
- Insight Partners maps the crowded AI automation and agent stack — n_sri_laasya · 2026-07-21
- A broken agent router burned 30.2M tokens in 3.5 hours on Claude Code — RileyRalmuto · 2026-07-21
- A thread maps the code-and-epistemics phrases Codex keeps using — alexisgallagher · 2026-07-21