Show HN: An AI collaboration playbook(AGENTS.md and code map and template)

2 points

5 months ago

Hi HN — I extracted a small “AI collaboration playbook” from my open-source project after repeatedly seeing coding agents go off-track (touch unrelated files, miss entry points, forget constraints in long threads).

The repo includes templates for:

- `AGENTS.md` guardrails + Done criteria - A 1-page index - A code map - Key flows - A plan-first change template (mini design doc)

It’s meant to be copied into any repo and used as a default workflow for Claude/Codex-style agents.

I’d love feedback on what you’ve found actually works to keep agents aligned, and what you think is missing/overkill here.

Links:

- Repo: https://github.com/david-bai00/PrivyDrop - Write-up: https://www.privydrop.app/en/blog/ai-collaboration-playbook

1 comment