57 lines
1.5 KiB
Markdown
57 lines
1.5 KiB
Markdown
# 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
|