Skip to content

deliberate: amendments are first-class specs - #511

Merged
aarontrowbridge merged 1 commit into
mainfrom
510-deliberate-amendment-review-clause
Aug 23, 2026
Merged

deliberate: amendments are first-class specs#511
aarontrowbridge merged 1 commit into
mainfrom
510-deliberate-amendment-review-clause

Conversation

@aarontrowbridge

@aarontrowbridge aarontrowbridge commented Aug 22, 2026

Copy link
Copy Markdown
Member

Closes #510.

Adds the amendment-review clause to the deliberate skill: amendments to approved specs get the same three-lens adversarial review and round budget as originals, with a line-by-line re-read of the parent spec (invariants, D-decisions, Measurement Protocol, prior amendments) before drafting. Evidence: the two same-day amendment incidents on the vault-distillation spec (see its review notes) — both cheap-talk drafts, both caught only by post-hoc review.

Summary by CodeRabbit

  • Documentation
    • Added guidance for reviewing amendments to approved specifications.
    • Amendments now follow the same three-lens, three-round review process as original specifications.
    • Clarified requirements for validating contracts, related amendments, and recording review outcomes separately from revision notes.

…et as originals

Two same-day incidents (2026-08-22): post-conversation amendment drafts
contradicted their parent specs' frozen contracts (6 and 9 blockings,
caught only by post-hoc review). The skill now mandates the full review
loop for amendments and the line-by-line re-read before drafting.

Closes #510.
@coderabbitai

coderabbitai Bot commented Aug 22, 2026

Copy link
Copy Markdown

Review Change Stack

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: ce67967c-4866-4406-a624-8758724ca65e

📥 Commits

Reviewing files that changed from the base of the PR and between 8ec70c1 and 55db68e.

📒 Files selected for processing (1)
  • packages/extension/skills/deliberate/SKILL.md

📝 Walkthrough

Walkthrough

The deliberate skill now treats amendments to approved specs as first-class specs. It requires parent-spec and sibling-amendment consistency checks, the same three-lens review process and round budget, and separate review records.

Changes

Approved spec amendment guidance

Layer / File(s) Summary
Amendment review requirements
packages/extension/skills/deliberate/SKILL.md
Adds guidance for drafting amendments from the parent spec, checking exact contracts and sibling amendments, running the full review process, and recording review separately from revision notes.

Estimated code review effort: 1 (Trivial) | ~5 minutes

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch 510-deliberate-amendment-review-clause

Comment @coderabbitai help to get the list of available commands.

@aarontrowbridge
aarontrowbridge marked this pull request as ready for review August 23, 2026 11:57
@aarontrowbridge
aarontrowbridge merged commit f018f46 into main Aug 23, 2026
8 checks passed
@aarontrowbridge
aarontrowbridge deleted the 510-deliberate-amendment-review-clause branch August 23, 2026 11:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

deliberate skill: amendments are first-class specs (same review budget as originals)

1 participant