{"repo":"bestcow/dear-agent","free":true,"listed":false,"github":"https://github.com/bestcow/dear-agent","clone":"git clone https://github.com/bestcow/dear-agent.git","description":"Dear agent: everything you need to resume this project. A 5-file docs convention + workspace template for AI coding agents.","language":"Python","stars":11,"topics":["agents-md","ai-agents","claude-code","documentation","template"],"license":"MIT","category":"ai-agents","readme_excerpt":"Dear Agent, English 한국어 A tiny, opinionated documentation system for projects built with AI coding agents (Claude Code and friends) — the letter your project leaves for the next session's agent. The problem: agents forget everything between sessions. Every new session starts with you re-explaining what the project is, where it stopped, and what to do next. The fix: five small markdown files per project — each with exactly one job, zero overlap — plus a generator that turns them into a workspace-wide project map once you have many projects. Tier 1 — one project (30 seconds) Copy the five files from templates/ into your repo and fill them in: File Job Update when --- --- --- PLAN.md goals, scope, tech decisions decisions change HANDOFF.md current state: last work / next steps / blockers, + status frontmatter every session end LOG.md one line per notable change features/fixes land README.md how to run it run steps change CLAUDE.md agent ops guide: commands, code map, pitfalls build/structure changes The heart is HANDOFF.md . Its YAML frontmatter is the single source of truth for project state: An agent reads it at session start and knows exactly where to pick up — no re-explaining. Using an agent other than Claude Code? Copy or symlink CLAUDE.md to AGENTS.md . Tier 2 — many projects (a workspace) When projects multiply, this repo doubles as a workspace template : category folders hold projects, and a generator scans every HANDOFF.md frontmatter to build tables of contents. Run e","default_branch":null,"files":null,"tree":[],"storefront":"/r/bestcow","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/bestcow/dear-agent/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}