mirror of
https://github.com/priyanshujain/sanderling.git
synced 2026-10-02 11:07:10 +00:00
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:
1 parent
7d6ed32474
commit
2755643195
1 file changed
+27
@@ -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.
|
||||
Reference in new issue
Block a user