feat: Add story draft command and prompt for Jira-ready proposals with clear requirements
This commit is contained in:
60
.opencode/commands/story-draft.md
Normal file
60
.opencode/commands/story-draft.md
Normal file
@@ -0,0 +1,60 @@
|
||||
---
|
||||
description: Draft a Jira story proposal with Fidelity-ready context and acceptance criteria
|
||||
---
|
||||
|
||||
Draft a future Jira story from rough notes, findings, or follow-up ideas.
|
||||
|
||||
This command should optimize for:
|
||||
|
||||
- professional story wording
|
||||
- explicit scope
|
||||
- useful acceptance criteria
|
||||
- clear ownership framing
|
||||
- natural US English that Jeff can reuse or forward without rewriting
|
||||
|
||||
Input notes or rough idea:
|
||||
|
||||
$ARGUMENTS
|
||||
|
||||
Read:
|
||||
|
||||
@prompts/story-draft.md
|
||||
@ai/AGENTS.md
|
||||
@ai/context/project.md
|
||||
@ai/context/people/manager.md
|
||||
@ai/context/people/jeff-dewitte.md
|
||||
@ai/context/people/index.md
|
||||
@ai/state/current.md
|
||||
@ai/state/work-items.md
|
||||
@knowledge/communication-rules.md
|
||||
@knowledge/agent-memory-rules.md
|
||||
|
||||
Today's log, if present:
|
||||
|
||||
!`if [ -f ai/logs/$(date +%F).md ]; then cat ai/logs/$(date +%F).md; else echo "No log exists for today yet."; fi`
|
||||
|
||||
Latest Mattermost context, if available:
|
||||
|
||||
!`if [ -s ai/inbox/mattermost-latest.md ]; then cat ai/inbox/mattermost-latest.md; elif [ -s scripts/mattermost/generated/mattermost_context.jsonl ]; then cat scripts/mattermost/generated/mattermost_context.jsonl; else echo "No Mattermost context available."; fi`
|
||||
|
||||
Requirements:
|
||||
|
||||
- Preserve the exact technical meaning of the input
|
||||
- Rewrite fully when needed so the output sounds like a fluent senior engineer wrote it
|
||||
- Choose the most appropriate story framing: bug, enhancement, spike, task, or follow-up
|
||||
- Keep the title short, concrete, and Jira-ready
|
||||
- Make the description specific enough that another engineer can understand the intended work
|
||||
- Separate current problem, root-cause suspicion, workaround, and follow-up work when relevant
|
||||
- Do not overstate certainty; if something is still a hypothesis, label it clearly
|
||||
- Make ownership explicit when helpful: XFlow vs consumer app vs service/configuration vs other framework
|
||||
- Acceptance criteria should be testable and scoped to the proposed story
|
||||
- If the story looks too large or too ambiguous, say so explicitly and suggest spike framing instead
|
||||
- If useful, include a short note about dependencies, blockers, or coordination needed
|
||||
|
||||
Return:
|
||||
|
||||
1. Suggested story type
|
||||
2. Jira-ready title
|
||||
3. Description
|
||||
4. Acceptance criteria
|
||||
5. Optional notes on dependencies / blockers / sizing concerns
|
||||
Reference in New Issue
Block a user