Skip to content

feat: remove Questions table from feature files, consolidate Q&A to interview notes#148

Merged
nullhack merged 3 commits into
mainfrom
remove-feature-questions-table
May 8, 2026
Merged

feat: remove Questions table from feature files, consolidate Q&A to interview notes#148
nullhack merged 3 commits into
mainfrom
remove-feature-questions-table

Conversation

@nullhack
Copy link
Copy Markdown
Owner

@nullhack nullhack commented May 8, 2026

Summary

  • Removes the Questions table from .feature files — Q&A for specification lives in interview notes, not duplicated in feature files
  • Drops the Q-IDs column from the Changes table (no longer meaningful without the Questions table)
  • Redirects all gap flagging, clarification capture, and pre-mortem findings to interview notes across skills and knowledge files

Once rules and examples are written, the raw Q&A used to produce them belongs in interview notes. Feature files are the finished product.

nullhack added 3 commits May 8, 2026 12:26
…hitecture

- Collapse review-gate-flow (3-state subflow) into single review-gate state
  with 3-tier fail-fast skill (design -> structure -> conventions)
- Add committed==verified condition gate on review-gate.pass -> done
- Remove 4 orphaned review skills (architecture, design, structure, conventions)
- Simplify planning flow (6->5 states): remove definition-of-done and ready
  states, consolidate conditions into single evidence atoms
- Add spec-review state (R) between feature-examples and create-py-stubs
- Detach post-mortem as independent flow (manual trigger)
- Remove wasteful backward arrows: needs-planning, needs-respecification
- Make rejected an exit from feature-development-flow (not auto-replan)
- Rename structure-project -> structure-feature (scope corrected)
- Split stub-design.md -> source-stubs.md + test-stubs.md
- Add Behavioral Distinctness, Behavior Pre-Mortem, Invariant Property
  Tests concepts across gherkin.md, pre-mortem.md, test-design.md
- Eliminate Status field from feature specs (content-based evidence instead)
- Fix stale flow-version references across all flows
- Update mermaid extension .mermaid -> .yaml.mermaid
…nterview notes

The Questions table in feature files was a downstream working scratchpad that
duplicated the interview notes' role as the source of Q&A. Feature files now
contain only the finished product (description, rules, constraints, examples).

Changes:
- Remove ## Questions section and Q-IDs column from feature template
- Redirect gap flagging, clarification capture, and pre-mortem findings
  from feature Questions table to interview notes across all skills and
  knowledge files
@nullhack nullhack merged commit e1bb96d into main May 8, 2026
10 checks passed
@nullhack nullhack deleted the remove-feature-questions-table branch May 8, 2026 18:48
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