worknotes

Installation
SKILL.md

Working documents go in _agent/docs/

Applies to every codebase, not one project.

Any document written as the output of a session - an investigation, a root-cause writeup, an analysis, a plan, a draft message, review notes - goes in the current codebase's _agent/docs/ directory. Permanent project documentation (docs/, README.md, ADRs, RFCs) is a different thing and follows that repo's own rules.

_agent/ is the one folder for everything an agent leaves behind in a repo: _agent/docs/ for these documents, _agent/handoff/ for the handoff skill's step logs. It is never committed.

The instructions

1. Write it to <repo-root>/_agent/docs/

Installs
1
GitHub Stars
1
First Seen
Oct 3, 2026