julian
17c08e6392
- Nx 22.7 monorepo (pnpm 11.1, TypeScript 5.9, Node 24) - apps/api: NestJS 11 (CJS conforme CODING-RULES.md PGD-DB-004) - apps/web: React 19 + Vite 8 (ESM) - libs/shared/api-interface: Zod contract base - Docker Compose dev: Postgres 18, Valkey 8, MinIO, Mailpit - WDS artifacts: - design-artifacts/A-Product-Brief/ (5 docs canônicos + 16 dialogs) - design-artifacts/B-Trigger-Map/ (hub + 4 personas + feature impact) - Stack canon: STACK.md v2.2 + CODING-RULES.md v2.0 + brand.md - AGENTS.md + README.md como entrada para devs/agentes Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
4.4 KiB
4.4 KiB
Workflow Prompt Reference
Related: See tmux-commands.md for session naming and management.
Multi-Agent Support
| Agent | CLI Command | Prompt Style |
|---|---|---|
| Claude | claude --dangerously-skip-permissions |
Natural language skill prompt |
| Codex | codex exec --full-auto |
Natural language skill prompt |
All child sessions receive explicit skill and workflow paths. Command wrappers are not required.
Required Prompt Fields
Every generated prompt must include:
- Which skill/workflow to execute
- The
SKILL.mdpath when available - The
workflow.mdorworkflow.yamlpath - The story file pattern in
_bmad-output/implementation-artifacts - The story ID or epic ID
- Any automation instruction such as
#YOLOorauto-fix all issues without prompting
dev-story
tmux send-keys -t "SESSION" 'claude --dangerously-skip-permissions "Execute the BMAD dev-story workflow for story STORY_ID.
READ this skill first: <installed-skill-root>/bmad-dev-story/SKILL.md
READ this workflow file next: <installed-skill-root>/bmad-dev-story/workflow.md
Story file: _bmad-output/implementation-artifacts/STORY_PREFIX-*.md
Implement all tasks marked [ ]. Run tests. Update checkboxes."' Enter
code-review
MUST use the dedicated bmad-story-automator-review skill. Do NOT use a generic Task agent for reviews.
tmux send-keys -t "SESSION" 'claude --dangerously-skip-permissions "Execute the story-automator review workflow for story STORY_ID.
READ this skill first: <installed-skill-root>/bmad-story-automator-review/SKILL.md
READ this workflow file next: <installed-skill-root>/bmad-story-automator-review/workflow.yaml
Then read: <installed-skill-root>/bmad-story-automator-review/instructions.xml
Validate with: <installed-skill-root>/bmad-story-automator-review/checklist.md
Story file: _bmad-output/implementation-artifacts/STORY_PREFIX-*.md
Review implementation, find issues, fix them automatically. auto-fix all issues without prompting"' Enter
Why auto-fix all issues without prompting: The dedicated review workflow normally presents a findings menu. This instruction tells it to automatically fix issues without prompting.
create-story
tmux send-keys -t "SESSION" 'claude --dangerously-skip-permissions "Execute the BMAD create-story workflow for story STORY_ID.
READ this skill first: <installed-skill-root>/bmad-create-story/SKILL.md
READ this workflow file next: <installed-skill-root>/bmad-create-story/workflow.md
Then read: <installed-skill-root>/bmad-create-story/discover-inputs.md
Use template: <installed-skill-root>/bmad-create-story/template.md
Validate with: <installed-skill-root>/bmad-create-story/checklist.md
Create story file at: _bmad-output/implementation-artifacts/STORY_PREFIX-*.md
Story ID: STORY_ID
#YOLO - Do NOT wait for user input."' Enter
CRITICAL: Always pass the story ID (for example, 5.3) to ensure create-story creates only that one story.
automate
tmux send-keys -t "SESSION" 'claude --dangerously-skip-permissions "Execute the BMAD qa-generate-e2e-tests workflow for story STORY_ID.
READ this skill first: <installed-skill-root>/bmad-qa-generate-e2e-tests/SKILL.md
READ this workflow file next: <installed-skill-root>/bmad-qa-generate-e2e-tests/workflow.md
Validate with: <installed-skill-root>/bmad-qa-generate-e2e-tests/checklist.md
Story file: _bmad-output/implementation-artifacts/STORY_PREFIX-*.md
Auto-apply all discovered gaps in tests."' Enter
If bmad-qa-generate-e2e-tests is missing from the installed skill root, story-automator install still succeeds, but the orchestrator should run with Skip Automate = true.
retrospective
tmux send-keys -t "SESSION" 'claude --dangerously-skip-permissions "Execute the BMAD retrospective workflow for epic EPIC_ID.
READ this skill first: <installed-skill-root>/bmad-retrospective/SKILL.md
READ this workflow file next: <installed-skill-root>/bmad-retrospective/workflow.md
Run the retrospective in #YOLO mode and assume the user will NOT provide input."' Enter
Variables
AI_AGENT=claudeorcodexAI_COMMAND= full CLI command override, legacy and deprecatedSTORY_PREFIX= story ID with dots replaced by hyphens, for example6.1->6-1{projectPath}= project root
All commands assume the session was created with STORY_AUTOMATOR_CHILD=true.