mirror of
https://github.com/bmad-code-org/BMAD-METHOD.git
synced 2026-09-19 08:11:52 +08:00
pbean
24bc95c488
Add references/deferred-work-entry.md — byte-identical in bmad-build and bmad-code-review, pinned by test-template-sync — as the single way to write the deferred-work ledger: read the whole file first; an open match on location and substance gets a seen-again line instead of a new entry; a closed match gets a new entry naming the closed id; entries are native ### DW-<n> blocks with origin, location, source_spec, severity, a two-sentence reason, and status: open; ids are minted from the highest existing and existing lines are never rewritten. The four bmad-build write sites and bmad-code-review's present step point at it; the "## Deferred from: code review" heading shape is gone. bmad-code-review: the Blind Hunter drops its ten-finding floor; step-01 loads the spec's prior review record and open ledger entries as triage input; step-03 carries forward verdicts for unchanged code, verifies from cited evidence, treats undemonstrated findings as false, routes out-of-scope findings on their merits, makes patch a locality test and defer a five-part test, and keeps an ambiguous fix at decision_needed even without a spec — the user is present. Story-file defer bullets carry their DW id. Docs: build-a-change describes the ledger contract, dedupe, and carry-forward and no longer suggests one fresh run per entry; review-a-change describes the five-way verdict instead of the retired dismiss and assign-severity steps. Renderer test asserts the reference is published and referenced from every write site.
Test Suite
Tests for the BMAD-METHOD tooling infrastructure.
Quick Start
# Run all quality checks
npm run quality
# Run individual test suites
npm run test:install # Installation component tests
npm run test:refs # File reference CSV tests
npm run validate:refs # File reference validation (strict)
Test Scripts
Installation Component Tests
File: test/test-installation-components.js
Validates that the installer compiles and assembles agents correctly.
File Reference Tests
File: test/test-file-refs-csv.js
Tests the CSV-based file reference validation logic.
Test Fixtures
Located in test/fixtures/:
test/fixtures/
└── file-refs-csv/ # Fixtures for file reference CSV tests