reconcile-proposal
Reconcile Proposal
Make the thread-root proposal.md faithfully reflect the decisions that govern it. You read the thread's authoritative inputs and the proposal, correct the proposal wherever the fix follows from those inputs, recheck what you changed, and hand any discrepancy that needs a fresh human decision to /emit-pending-decisions. You edit only the proposal; you never touch its authority sources, and you produce no separate report. Writing the corrected proposal is where you stop — do not stage, commit, or push.
Procedure
-
Resolve the thread. Work inside one thread root at
docs/threads/<YYMMDDHHMMSSZ-slug>/. Ifcwdalready sits inside a thread root, that is the thread. Two situations make a pending bundle physically impossible —.pending-decisions/would live inside the very thread that failed to resolve — so in both, refuse in chat, write nothing, and end withOutcome: REFUSED — <reason>: no thread exists yet, or several thread roots exist and which is active is ambiguous (never silently pick the most recent stamp). -
Load the authority. Read the thread's
seed.md(why the thread exists) anddecisions.md(what has been settled), plus any artifact the invocation explicitly points you at. These are your authoritative inputs — the standard the proposal is measured against. Then read the thread-rootproposal.md, your one editable target. If noproposal.mdexists at the thread root, tell the user there is nothing to reconcile, write nothing, and end withOutcome: REFUSED — no proposal.md to reconcile. -
Find the discrepancies. Read the proposal against the authority once, end to end, and identify where they disagree:
- Omissions — a settled decision the proposal should reflect but does not.
- Contradictions — a proposal statement that conflicts with a settled decision.
- Unsupported additions — a commitment, direction, or constraint the proposal asserts that neither the seed nor any decision authorizes.
-
Correct what the authority settles. Edit
proposal.mdin place for every discrepancy whose fix follows directly from the authoritative inputs: fold in the omitted decision's substance, resolve the contradiction toward the settled decision, and remove or walk back the unsupported addition. Preserve legitimate elaboration — proposal detail that extends the decisions without contradicting them is not an error. -
Recheck. After editing, read the proposal against the authority again to confirm each correction holds and introduced no new discrepancy.