Skip to content

feat: improve backlog command acceptance criteria and sprint navigation#189

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

feat: improve backlog command acceptance criteria and sprint navigation#189
tractorjuice wants to merge 1 commit intomainfrom
feat/improve-backlog-prompt

Conversation

@tractorjuice
Copy link
Copy Markdown
Owner

Summary

  • Strengthened acceptance criteria rules — every criterion must be testable with a specific pass/fail check; banned vague phrases ("works correctly", "handles errors gracefully"); require measurable thresholds, error/edge case criteria, and NFR ID references
  • Added sprint summary table — at-a-glance table (Sprint | Theme | Points | Key Deliverables) before detailed sprint plans

How these changes were found

Used the autoresearch command prompt optimiser:

Iteration Score Status Change
0 (baseline) 8.0 keep
1 8.8 keep Strengthen acceptance criteria rules
2 9.0 discard Add sprint summary table (delta < 0.3)

Net: +8 lines of prompt, score 8.0 → 8.8

The sprint summary table scored 9.0 (just below the 0.3 noise threshold) but is included as it improves navigation without adding complexity.

Test plan

  • Run /arckit:backlog against a test project and verify acceptance criteria use measurable thresholds
  • Verify no vague criteria ("works correctly", "handles errors gracefully") in output
  • Verify sprint summary table appears before detailed sprint plans
  • Run python scripts/converter.py to regenerate extension formats

🤖 Generated with Claude Code

Strengthen acceptance criteria rules to require measurable, testable
thresholds with specific pass/fail checks. Ban vague criteria like
"works correctly" or "handles errors gracefully". Require error/edge
case criteria and NFR ID references per story.

Add sprint summary table before detailed sprint plans for at-a-glance
navigation of the full sprint roadmap.

Found via autoresearch experiment loop (score 8.0 → 8.8).

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-backlog-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