feat(voyage)!: rename commands, templates, fixtures for v4.0.0 [skip-docs]
This commit is contained in:
parent
a975c9943c
commit
47a4ad47d8
23 changed files with 99 additions and 98 deletions
|
|
@ -1,157 +0,0 @@
|
|||
---
|
||||
type: ultrabrief
|
||||
brief_version: 2.0
|
||||
created: {YYYY-MM-DD}
|
||||
task: "{one-line task description}"
|
||||
slug: {slug}
|
||||
project_dir: .claude/projects/{YYYY-MM-DD}-{slug}/
|
||||
research_topics: {N}
|
||||
research_status: pending # pending | in_progress | complete | skipped
|
||||
auto_research: false # true if user opted into Claude-managed research
|
||||
interview_turns: {N}
|
||||
source: {interview | manual}
|
||||
---
|
||||
|
||||
# Task: {title}
|
||||
|
||||
> Generated by `/ultrabrief-local` on {YYYY-MM-DD}.
|
||||
> This brief is the contract between requirements and planning. `/ultraplan-local`
|
||||
> reads it to produce the implementation plan. Every decision in the plan must
|
||||
> trace back to content in this brief.
|
||||
|
||||
## Intent
|
||||
|
||||
*Why are we doing this? What is the motivation, user need, or strategic context?
|
||||
3-5 sentences. Load-bearing for the plan — every implementation decision must
|
||||
trace back to this intent.*
|
||||
|
||||
{Intent paragraph. Answers "why bother?".}
|
||||
|
||||
## Goal
|
||||
|
||||
*What does success look like concretely? What state will the system be in when
|
||||
this is done? 1 paragraph. Specific enough to disagree with.*
|
||||
|
||||
{Goal paragraph.}
|
||||
|
||||
## Non-Goals
|
||||
|
||||
*What is explicitly out of scope? Prevents plan-critic and scope-guardian from
|
||||
flagging gaps for things we deliberately do not do.*
|
||||
|
||||
- {non-goal 1}
|
||||
- {non-goal 2}
|
||||
|
||||
## Constraints
|
||||
|
||||
*Technical, time, or resource limitations. Hard boundaries the plan must respect.*
|
||||
|
||||
- {constraint 1}
|
||||
- {constraint 2}
|
||||
|
||||
## Preferences
|
||||
|
||||
*Preferred patterns, frameworks, libraries, or approaches. Soft constraints
|
||||
(the plan may deviate with justification).*
|
||||
|
||||
- {preference 1}
|
||||
- {preference 2}
|
||||
|
||||
## Non-Functional Requirements
|
||||
|
||||
*Performance, security, accessibility, scalability, or other quality attributes.
|
||||
Quantified where possible.*
|
||||
|
||||
- {NFR 1 — e.g., "p95 response time < 200ms"}
|
||||
- {NFR 2 — e.g., "Zero new npm dependencies"}
|
||||
|
||||
## Success Criteria
|
||||
|
||||
*Falsifiable, command-checkable conditions that define "done". Each must be
|
||||
verifiable by running a specific command or observing a specific system behavior.*
|
||||
|
||||
- {criterion — e.g., "All existing tests pass: `npm test` exits 0"}
|
||||
- {criterion — e.g., "New endpoint returns 200: `curl -s localhost:3000/api/health | jq .status` → `"ok"`"}
|
||||
- {criterion — e.g., "No TypeScript errors: `npx tsc --noEmit` exits 0"}
|
||||
|
||||
Do NOT write vague criteria:
|
||||
- "It should work" (not testable)
|
||||
- "The feature is implemented" (not falsifiable)
|
||||
- "Performance is acceptable" (no baseline given)
|
||||
|
||||
## Research Plan
|
||||
|
||||
*Explicit research topics that must be answered before `/ultraplan-local` can
|
||||
produce a high-confidence plan. Each topic is phrased as a research question ready
|
||||
to feed into `/ultraresearch-local`. Topics may be empty (N=0) for trivial tasks
|
||||
where the codebase alone is sufficient context.*
|
||||
|
||||
{If research_topics = 0, write a single line: "No external research needed —
|
||||
the codebase and this brief contain sufficient context for planning."}
|
||||
|
||||
### Topic 1: {Short title}
|
||||
|
||||
- **Why this matters:** {How the plan depends on this answer. Which steps or
|
||||
decisions cannot be made confidently without it.}
|
||||
- **Research question:** "{Exact question to feed to /ultraresearch-local.
|
||||
One sentence, ends in `?`.}"
|
||||
- **Suggested invocation:** `/ultraresearch-local --project {project_dir} --external "{question}"`
|
||||
- **Required for plan steps:** {which kinds of steps will consume this — e.g.,
|
||||
"migration strategy", "library selection", "threat model"}
|
||||
- **Confidence needed:** {high | medium | low}
|
||||
- **Estimated cost:** {quick — inline research | standard — agent swarm | deep — with contrarian + gemini}
|
||||
- **Scope hint:** {local | external | both}
|
||||
|
||||
### Topic 2: {Short title}
|
||||
|
||||
- **Why this matters:** ...
|
||||
- **Research question:** "..."
|
||||
- **Suggested invocation:** `/ultraresearch-local --project {project_dir} ...`
|
||||
- **Required for plan steps:** ...
|
||||
- **Confidence needed:** ...
|
||||
- **Estimated cost:** ...
|
||||
- **Scope hint:** ...
|
||||
|
||||
## Open Questions / Assumptions
|
||||
|
||||
*Things still uncertain after the interview. These are carried as `[ASSUMPTION]`
|
||||
entries into the plan and flagged to the user for review.*
|
||||
|
||||
- {question or assumption 1}
|
||||
- {question or assumption 2}
|
||||
|
||||
## Prior Attempts
|
||||
|
||||
*What has been tried before and what happened. Leave blank for fresh tasks.
|
||||
Prior attempts are load-bearing — they prevent the plan from repeating known
|
||||
failures.*
|
||||
|
||||
{Prior attempts narrative, or "None — fresh task."}
|
||||
|
||||
## Metadata
|
||||
|
||||
- **Created:** {YYYY-MM-DD}
|
||||
- **Interview turns:** {N}
|
||||
- **Auto-research opted in:** {yes | no}
|
||||
- **Source:** {ultrabrief interview | manual}
|
||||
|
||||
---
|
||||
|
||||
## How to continue
|
||||
|
||||
Manual (default):
|
||||
|
||||
```bash
|
||||
# Run each research topic (order does not matter):
|
||||
/ultraresearch-local --project {project_dir} --external "{Topic 1 question}"
|
||||
/ultraresearch-local --project {project_dir} --external "{Topic 2 question}"
|
||||
|
||||
# Then plan:
|
||||
/ultraplan-local --project {project_dir}
|
||||
|
||||
# Then execute:
|
||||
/ultraexecute-local --project {project_dir}
|
||||
```
|
||||
|
||||
Auto (opt-in during `/ultrabrief-local`): research and planning run
|
||||
automatically; only execution is manual.
|
||||
Loading…
Add table
Add a link
Reference in a new issue