Skip to content

feat: improve requirements command prompt quality#187

Closed
tractorjuice wants to merge 1 commit intomainfrom
feat/improve-requirements-prompt
Closed

feat: improve requirements command prompt quality#187
tractorjuice wants to merge 1 commit intomainfrom
feat/improve-requirements-prompt

Conversation

@tractorjuice
Copy link
Copy Markdown
Owner

Summary

  • Expanded NFR subcategories from 5 generic to 7 specific with sub-prefixes (added Availability/Resilience, Usability, Maintainability/Observability)
  • Added explicit use case structure — UC-xxx IDs with main flow, alternative flows, exception flows, business rules
  • Added Given/When/Then acceptance criteria format for functional requirements
  • Added persona structure guidance (2-4 with role, goals, pain points, technical proficiency)

How these changes were found

Used the autoresearch command prompt optimiser — an autonomous experiment loop that runs the command, scores output quality, tweaks the prompt, and keeps/discards based on score delta.

Iteration Score Status Change
0 (baseline) 8.4 keep
1 8.8 keep Expand NFR subcategories
2 9.0 discard Derive NFR targets from context (delta < 0.3)
3 9.2 keep Add use case structure instruction

Net: +6 lines of prompt, score 8.4 → 9.2

Test plan

  • Run /arckit:requirements against a test project and verify output includes all 7 NFR subcategories
  • Verify use cases (UC-xxx) appear with main/alt/exception flows
  • Verify FRs have Given/When/Then acceptance criteria
  • Run python scripts/converter.py to regenerate extension formats

🤖 Generated with Claude Code

Expand NFR subcategories from 5 generic to 7 specific (added
Availability/Resilience, Usability, Maintainability/Observability
with sub-prefixes). Add explicit use case structure (UC-xxx with
main/alt/exception flows), Given/When/Then acceptance criteria,
and persona structure guidance.

Found via autoresearch experiment loop (score 8.4 → 9.2).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
tractorjuice added a commit that referenced this pull request Mar 27, 2026
Merged 6 pre-autoresearch prompt quality PRs into the combined branch:

- #187 requirements: user personas, UC structure, Given/When/Then AC
- #188 adr: measurable consequences with project-specific metrics
- #189 backlog: strict acceptance criteria rules (testable, thresholds)
- #191 wardley: math-validated stage boundaries table
- #192 wardley.value-chain: visibility rationale and validation checklist
- #194 wardley.climate: recommended action field with specificity rules

All autoresearch additions (scores, traceability) preserved alongside
the quality improvements. Lint passes. Converter regenerated.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@tractorjuice
Copy link
Copy Markdown
Owner Author

Merged into #265 (combined autoresearch PR)

@tractorjuice tractorjuice deleted the feat/improve-requirements-prompt branch March 27, 2026 23:52
tractorjuice added a commit that referenced this pull request Apr 6, 2026
Merged 6 pre-autoresearch prompt quality PRs into the combined branch:

- #187 requirements: user personas, UC structure, Given/When/Then AC
- #188 adr: measurable consequences with project-specific metrics
- #189 backlog: strict acceptance criteria rules (testable, thresholds)
- #191 wardley: math-validated stage boundaries table
- #192 wardley.value-chain: visibility rationale and validation checklist
- #194 wardley.climate: recommended action field with specificity rules

All autoresearch additions (scores, traceability) preserved alongside
the quality improvements. Lint passes. Converter regenerated.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
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