docs(claude): add delegation and record-keeping sections

delegation says to do installs, builds, test runs and greps in subagents and keep the main context for decisions. record-keeping says a finished task updates the files that describe its subject, writes down what was found, corrects old assumptions in place and verifies against the repository.
This commit is contained in:
pj committed 2026-08-16 17:41:06 +05:30
1 parent 7d6ed32474
commit 2755643195
1 file changed
+27
+27
View File
@@ -67,3 +67,30 @@
- Keep commits small: aim for under 20 lines changed per commit.
- Don't batch multiple unrelated changes into one commit.
- Commit early and often. A working 5-line change is better than a pending 200-line change.
## Delegation
- Do the work in subagents, not in the main context. Installs, builds, test runs,
file-by-file writing, greps across the tree and any multi-step verification go to an
Agent that reports back a short result.
- The main context is for deciding what to do, reviewing what comes back, and talking to
the user. Keep it clean. Never paste build output, test output or file listings into it.
- One specific task per subagent, with the context it needs. Launch independent tasks in
parallel in a single message.
- Give each agent its own scratchpad subdirectory, named for its task, and tell it to
delete nothing it did not create. Agents run concurrently and a shared scratch directory
means one deletes another's work mid-run.
## Keeping the record
- Finishing a task includes updating the files that describe its subject. Status lines,
schedules, gates and readiness notes go stale the moment work lands, and a plan that
says "not started" about something that ran is worse than no plan.
- Write down what was found, not just what was changed. A measurement, a number, a thing
that turned out not to work: it goes in the file where someone would look for it, with
the path, commit or number behind it.
- Correct old assumptions explicitly. When something turns out to be wrong, fix the
sentence that said it rather than adding a newer sentence beside it. Say what it used
to claim if the change matters.
- Verify against the repository rather than recalling. A file that says it was checked
against HEAD and was not is the failure this project exists to catch.