Skip to content

feat(spec): comprehensive spec-driven workflow with 44 features - #179

Merged
Patel230 merged 11 commits into
mainfrom
feat/spec-driven-and-hooks
Aug 5, 2026
Merged

feat(spec): comprehensive spec-driven workflow with 44 features#179
Patel230 merged 11 commits into
mainfrom
feat/spec-driven-and-hooks

Conversation

@Patel230

@Patel230 Patel230 commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

Summary

Implements a comprehensive spec-driven development workflow — the most complete of any open-source AI coding agent, based on deep research of GitHub Spec Kit (121K★), Spec-Driven Develop (953★), BMAD-METHOD (51K★), Tessl, OpenSpec, and traceSDD research.

What's New (39 features)

Workflow Phases

  • Proposal → Specify + Design (parallel) → Plan → Tasks → Approve → Implementing
  • Constitution enforced as prerequisite before Specify/Design
  • Phase gates (Simplicity, Anti-Abstraction, Integration-First, Test-First) at Plan transition
  • EARS notation validation (The system shall, WHEN...THEN, SHALL NOT)
  • NEEDS CLARIFICATION enforcement (max 3, blocks Plan if unresolved)

Traceability & Quality

  • REQ-XXX.Y.Z requirement IDs with extraction from spec and code
  • Requirements Traceability Matrix (forward, backward, bidirectional)
  • Orphan REQ hallucination detection (88% TDR from traceSDD research)
  • Spec drift detection (coverage percentage)
  • Self-correction loop from test/lint feedback

Architecture & Design

  • S.U.P.E.R architecture health scoring (5 dimensions)
  • Architecture Decision Records (ADR)
  • BDD/Gherkin scenario generation
  • Scale-adaptive planning depth (L0-4 based on complexity)
  • Multiple plan variations with comparison

Execution & Review

  • Parallel subagent execution with dependency analysis
  • Post-implementation work review
  • Adaptive control with drift detection (20%/40%/60% thresholds)
  • Cross-session progress continuity (MASTER.md)

Hooks & Automation

  • Command hooks from .md frontmatter
  • File-watch bridge with test execution
  • Reactive test runs on file save
  • Spec versioning in VCS with REQ-referenced commits

Test Results

  • 124 packages pass, 0 failures
  • Lint clean (errcheck, unused, gosec all pass)
  • Conventional commits verified

Research Sources

  • GitHub Spec Kit (121K★) — Constitution + 4-phase workflow
  • Spec-Driven Develop (953★) — S.U.P.E.R + Adaptive Control
  • BMAD-METHOD (51K★) — Scale-adaptive L0-4
  • Tessl — [@test] linking, drift detection
  • OpenSpec — ADR, Git discipline
  • traceSDD research — 88% hallucination detection

…ed hooks

Add Proposal and Design stages to the spec workflow so Specify and Design
can run in parallel after Proposal, then converge for Plan → Tasks → Implementing.

Implement command hook loading from .md frontmatter, fsnotify bridge for
file_changed events, and real built-in hook implementations.
…ion detection

Phase 1: Constitution enforced as prerequisite before Specify/Design.
Phase gates (Simplicity, Anti-Abstraction, Integration-First) checked at Plan.
Constitution injected into system prompt at all spec stages.

Phase 2: EARS notation validation (The system shall, WHEN...THEN, SHALL NOT).
REQ-XXX.Y.Z requirement IDs with extraction from spec and code.
Orphan REQ detection (code cites REQ not in spec = hallucination).
Missing REQ detection (REQ in spec not in code = gap).

Phase 3: NEEDS CLARIFICATION enforcement (max 3, blocks Plan if unresolved).

Phase 4: Hallucination detection via inline citations.
ScanCodeForReqIDs scans source files for [REQ-XXX] comments.
FindOrphanReqIDs and FindMissingReqIDs in spec validator.

Phase 5: Task dependency analysis and parallel group identification.
ParseTasks extracts file refs, REQ IDs, and dependencies.
AnalyzeTaskGroups identifies parallel-safe vs sequential tasks.

Phase 6: Auto convergence with REQ coverage checks.
ConvergeTool now detects orphan and missing REQs.

Phase 7: Enhanced file-watcher with source/test file detection.
@Patel230 Patel230 changed the title feat(spec): comprehensive spec-driven workflow with 39 features feat(spec): comprehensive spec-driven workflow with 41 features Aug 5, 2026
@Patel230 Patel230 changed the title feat(spec): comprehensive spec-driven workflow with 41 features feat(spec): comprehensive spec-driven workflow with 42 features Aug 5, 2026
@Patel230 Patel230 changed the title feat(spec): comprehensive spec-driven workflow with 42 features feat(spec): comprehensive spec-driven workflow with 43 features Aug 5, 2026
@Patel230 Patel230 changed the title feat(spec): comprehensive spec-driven workflow with 43 features feat(spec): comprehensive spec-driven workflow with 44 features Aug 5, 2026
@Patel230
Patel230 merged commit 12c0903 into main Aug 5, 2026
23 checks passed
@Patel230
Patel230 deleted the feat/spec-driven-and-hooks branch August 5, 2026 15:25
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