oleh/astrolabe
1
0
Fork 0
mirror of https://github.com/olehomelchenko/astrolabe.git synced 2026-08-08 02:02:33 +00:00
Code Issues Packages Projects Releases Wiki Activity

Docs: deferred review findings get a durable breadcrumb, not a chat mention

Browse Source
This commit is contained in:
Oleh Omelchenko
2026-06-30 17:37:37 +03:00
parent a8696f7195
commit 9b2618cac6
1 changed files with 8 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files
CLAUDE.md
+8 -4
View File
@@ -70,7 +70,11 @@ run the review pass **before** anything is committed:
sweeps stay a deliberate act). sweeps stay a deliberate act).
Run the subagents **sequentially**, not in parallel — both may edit the working tree. Run the subagents **sequentially**, not in parallel — both may edit the working tree.
Relay each report back to the user. Arbitrate findings that needed session context: Relay each report back to the user, then arbitrate each finding to one of three ends —
either accept them, or overrule them **and** record the missing rationale where the **accept and fix**, **accept but defer**, or **overrule** — and **write down the two you
reviewer looked for it — an overruled finding without a writing-down will recur. Then don't act on now**, because a subagent's report is ephemeral and chat is not a record. A
commit only when invited. deferred finding gets a `// TODO:` at the relevant code site (or a line in the closest doc);
an overruled one records the missing rationale where the reviewer looked. Out of scope for
_this session_ is not out of scope for the _project_: with a single maintainer there is no
"someone else's problem", so an unrecorded deferral or beyond-scope note recurs as work
handed to your future self. Then commit only when invited.