Skip to content

verify-first — the TDD skip the protocol never owned, now a recorded decision - #88

Merged
fall-out-bug merged 6 commits into
mainfrom
change/verify-first
Sep 2, 2026
Merged

verify-first — the TDD skip the protocol never owned, now a recorded decision#88
fall-out-bug merged 6 commits into
mainfrom
change/verify-first

Conversation

@fall-out-bug

Copy link
Copy Markdown
Collaborator

What

Openspec change verify-first (docs/process, no product behavior changes). Born from the Governor's observation on 2026-09-02: the process-fabric cycle skipped TDD silently — no spec deltas meant no test-writer pass and no red step, and the skip lived only in task reports.

  • AGENTS.md (one rule line): verification is written before the work; a skipped test-first pass is a recorded decision in the task report, not a default.
  • docs/workflow.md J4 (one procedure bullet): spec-delta tasks get failing acceptance tests from those deltas before implementation (test-writer, then implementer); no-delta tasks restate their verify line as checks run before the work — red where the work is absent; a skip is recorded with what/why/what-covers-it.
  • Merge prep: @portolan/core 0.4.1 → 0.4.2, CHANGELOG entry.

Verification

  • Task 1.1 was executed under the discipline it installs: pre-work checks run red (rule wording absent), post-work green, judgment checks recorded as the manual skip per design D1 — the reports are the first exemplars of the recorded-skip shape.
  • Battery green on the final tree: bun test 372/0 (5 environmental skips named), tsc core+acceptance, validate --specs --strict 10/10, validate --changes --strict 1/1, skill checks, leak-gate.
  • Task 1.1 review: PASS/APPROVED (minor fixed). Whole-change review: PASS/APPROVED (two minors fixed). Socratic pre-archive: SHIP; its one delete candidate (the not a default tail) considered and kept with reason in design.md.
  • skip_specs: true — docs/process only.

fall_out_bug added 6 commits September 2, 2026 13:30
The process-fabric cycle (#87) skipped TDD with no spec deltas and the
skip lived only in task reports; no protocol text owned the discipline.

Rule in AGENTS.md's OpenSpec workflow rules: verification is written
before the work, and a skipped test-first pass is a recorded decision
in the task report, not a default.

Procedure in docs/workflow.md J4: spec-delta tasks get failing
acceptance tests from those deltas before implementation (test-writer,
then implementer); no-delta tasks (docs, process) restate their verify
line as checks run before the work, red where the work is absent; a
skip is recorded with what was skipped, why, and what covers it.

verify-first 1.1
@fall-out-bug
fall-out-bug merged commit 9ca09dd into main Sep 2, 2026
5 checks passed
@fall-out-bug
fall-out-bug deleted the change/verify-first branch September 2, 2026 10:47
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.

1 participant