edrethardo/developer_agent

documenting

Use after any user-visible change or architectural decision — update user docs, dev docs, CHANGELOG and the indexes in the same session as the change.

explaining-complexity

Use when the user requests a new feature or change, before building anything — give an honest, plain-language cost assessment first.

journaling

Use at session end, after completing or abandoning any task, or when an approach fails — record what happened in docs/journal/ so no future session re-investigates it.

reviewing

Use when writing acceptance criteria, when about to report something as verified or done, and when the hard rules call for an adversarial review — every check has to say what it cannot see.

initialize-tool

Use when docs/journal/INDEX.md contains the UNINITIALIZED marker — first-run setup; interview the user, set up git, install shared skills, configure the machine.

adopting-a-project

Use when the user wants this developer-agent setup added to a project they already have, or when they start working on code that lives in another folder — installs the configuration into their repo without breaking what is already there.

git-discipline

Use before starting work, after reaching any working state, at session end, and when the user asks to undo or go back — keeps every change recoverable and the history readable.

testing

Use before writing any logic the user will trust — sums, filters, imports, anything money- or record-shaped — and before claiming that anything works.

creating-skills

Use when a task type has occurred twice, when the user says "always do it this way", or when following a skill produced a bad result — extract or improve a skill.

finding-knowledge

Use before starting any task, investigation, or debugging session, and before answering "how does X work?" — search the project's journal and docs before re-deriving anything.

syncing-the-kit

Use when the user wants a newer version of the developer-agent setup, or when something in the way of working seems outdated — updates this repo's skills and rules from the kit without touching the tool's own code or history.