neur0map Prowl durable knowledge
An agent's context window is thrown away at the end of a session, so whatever you
figured out about the project evaporates unless you write it down where the next
agent will find it. prowl-agent stores accepted decisions, concepts, and gotchas
as portable OKF Markdown, separate from the disposable index, and serves them
back through search/context so understanding compounds across agents instead
of being rediscovered every time.
When to capture
Capture a note when you resolve something that cost real effort and will matter again: why a design is the way it is, a convention that is not obvious from the code, a trap that bit you, or the answer to a question the user or a teammate will ask again.
Workflow
- First run only:
prowl-agent knowledge init. - Write the note as OKF Markdown (a decision, concept, claim, or playbook) and
propose it:
prowl-agent knowledge propose --file note.md --target decisions/<slug>.md. The command prints a deterministic diff before anything is stored. - Accept it once reviewed:
prowl-agent knowledge accept <proposal-id>. - Check health anytime:
prowl-agent knowledge listandprowl-agent knowledge lint.
Anchor claims to real code where you can; prowl flags a note as stale when the code region it points at changes, so future readers know when to re-verify. Keep notes short and evidence-backed; do not capture routine steps or anything the code already states plainly.