Record development notes and decisions in Claude Code
Write short development logs for changes, rationale, rejected options, and follow-up, choosing the decision type for significant choices.
中文Install in Claude Code
A Claude Code project with a development log directory. Check whether the topic already has an entry.
- Review `.claude/skills/devlog/SKILL.md` and its requirements at the pinned GitHub commit.
- Create `.claude/skills/devlog/` in your project and save the reviewed file as `.claude/skills/devlog/SKILL.md`.
- Start Claude Code from that project's root, then select `/devlog` in the slash menu.
Example task
On 2026-07-09 a fictional project chose to reuse its rehearsal filter. The notes say `{topic:'rehearsal-filter',decision:'reuse shared filter',rejected:'add second filter',reason:'avoid duplicate state'}`. No existing log entry covers it.What to check
Name the entry `2026-07-09-rehearsal-filter.md` and set `type: decision`. Record why reuse avoids duplicate state and why a second filter was declined. Add checking the narrow layout as an open question.
Original SKILL.md on GitHub · Updated
Frequently asked question
When should a development log use the decision type?
Use the decision type for a choice that will shape future design. Record the rationale, rejected alternatives, and open questions. Consider extending an existing entry for the same topic.