Skip to content

feat(quality-depth): add build depth & documentation guidance#49

Merged
MacAttak merged 3 commits intomainfrom
feat/build-depth-docs
Feb 26, 2026
Merged

feat(quality-depth): add build depth & documentation guidance#49
MacAttak merged 3 commits intomainfrom
feat/build-depth-docs

Conversation

@MacAttak
Copy link
Contributor

Summary

  • Add post-build code review with heuristic trigger (4+ tasks, 5+ files, security-tagged) to sw-build
  • Add as-built notes guidance (plan deviations to plan.md, spec untouched) to sw-build
  • Update DESIGN.md token target from 600 to 800, replace estimated protocol tokens with actual measured values
  • Resolve AUD-008 and AUD-009 in AUDIT.md

Acceptance Criteria

# Criterion Status
AC-1 Post-build review guidance exists in sw-build PASS
AC-2 As-built notes guidance exists in sw-build PASS
AC-3 DESIGN.md token target updated PASS
AC-4 AUD-008 and AUD-009 resolved in AUDIT.md PASS
AC-5 sw-build token budget managed PASS

Gate Results

Gate Status Findings (B/W/I)
gate-build SKIP Markdown-only unit
gate-tests SKIP Markdown-only unit
gate-security SKIP Markdown-only unit
gate-wiring SKIP Markdown-only unit
gate-spec PASS 0/0/0

Evidence

  • Spec compliance: .specwright/work/quality-depth/units/build-depth-docs/evidence/spec-compliance.md
  • Protocol extraction used to manage sw-build token budget (1,135 words with protocols/build-quality.md for detail)

Work unit: quality-depth/build-depth-docs (Unit 3 of 3 — final unit)

MacAttak and others added 3 commits February 26, 2026 15:46
build-depth-docs task-1: units qualifying (4+ tasks, 5+ files, or
security-tagged criteria) get a specwright-reviewer code review.
Detail extracted to protocols/build-quality.md to manage token budget.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
build-depth-docs task-2: as-built notes append plan deviations to
plan.md after unit completion. spec.md untouched, gate-spec doesn't
consume. Primary consumer: sw-learn. Detail in build-quality.md.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
build-depth-docs task-3: raise SKILL.md target from 600 to 800 tokens,
replace estimated protocol token counts with actual measured word counts,
add build-quality.md to protocol table. AUD-008 and AUD-009 resolved
in local .specwright/AUDIT.md.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@MacAttak MacAttak merged commit a8be05e into main Feb 26, 2026
2 checks passed
@MacAttak MacAttak deleted the feat/build-depth-docs branch February 26, 2026 22:37
@github-actions github-actions bot mentioned this pull request Feb 26, 2026
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