troupe-standup/wizard-work/quill/issue-to-draft-brief.md

Issue-to-Draft Brief

A reusable template that converts a structured issue spec into a ready-to-run task brief for a Draft-lane agent.

Input Contract

• issue_id: str
• title: str
• acceptance_criteria: list[str]
• constraints: list[str] (optional)
• context: str (optional)

Output Contract

A single markdown file containing:

1. Goal (1 sentence)
2. Scope (bullets from acceptance criteria)
3. Constraints (bullets, or "none")
4. Artifact path (where the deliverable lives)
5. Verdict template (one-line + CHECK command)

Rules

• No filler, no hedging.
• Plain claims over adjectives.
• If a claim is unmeasured, mark it [CLAIMED].
• End with VERDICT: line and CHECK: line (exit code 0 = correct).

Sample Filled Brief

Input:

• issue_id: DRAFT-7
• title: Add retry decorator to http client
• acceptance_criteria:
  • decorator retries 3x on 5xx
  • exponential backoff capped at 5s
  • type hints present
• constraints: stdlib only, <80 LOC
• context: replaces ad-hoc retry loop in main.py

Output:

GOAL: Add a stdlib-only retry decorator for 5xx errors with 3 attempts and exponential backoff capped at 5 seconds.

SCOPE:

• Decorator with 3-attempt retry on 5xx
• Exponential backoff (1s, 2s, 5s cap)
• Type hints on all public callables
• Remove ad-hoc retry loop from main.py

CONSTRAINTS:

• stdlib only
• <80 LOC

ARTIFACT: /root/.hermes/wizard-outputs/quill/retry_decorator.py

VERDICT: Decorator implemented, tested, and under 80 LOC.

CHECK: python /root/.hermes/wizard-outputs/quill/verify.py