fix(vision-to-backlog): organize artifacts in .product-strategy/ directory

Create .product-strategy/ directory to organize all strategy artifacts
instead of cluttering root directory.

Changes:
- Step 2: Create .product-strategy/ directory early in workflow
- Each agent spawn: Specify output path (e.g., .product-strategy/problem-map.md)
- Agents reference prior artifacts by path
- Final report lists all artifact locations

Artifacts saved:
- .product-strategy/problem-map.md
- .product-strategy/context-map.md
- .product-strategy/domain-*.md (one per context)
- .product-strategy/capabilities.md
- .product-strategy/backlog.md

Keeps root directory clean and strategy artifacts organized.

Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
2026-01-12 18:53:47 +01:00
parent eead1e15dd
commit fd713c8697

View File

@@ -39,7 +39,16 @@ cat ./vision.md
Verify both files exist. If vision doesn't exist, help user create it following product-strategy framework.
### 2. Vision Decision Gate
### 2. Create Artifacts Directory
Create directory for strategy artifacts:
```bash
mkdir -p .product-strategy
```
All artifacts will be saved here to keep root clean.
### 3. Vision Decision Gate
Show vision to user and ask:
@@ -52,7 +61,7 @@ Show vision to user and ask:
If NO → help refine vision first, don't proceed.
If YES → continue to problem space.
### 3. Spawn Problem Space Analyst
### 4. Spawn Problem Space Analyst
Use Task tool to spawn `problem-space-analyst` agent:
@@ -70,12 +79,14 @@ Output:
- Irreversible vs reversible actions
- Where mistakes are expensive
Save artifact to: .product-strategy/problem-map.md
Follow problem-space-analyst agent instructions.
```
Agent returns Problem Map artifact.
Agent returns Problem Map artifact saved to `.product-strategy/problem-map.md`.
### 4. Problem Space Decision Gate
### 5. Problem Space Decision Gate
Show Problem Map to user and ask:
@@ -83,14 +94,14 @@ Show Problem Map to user and ask:
- If NO → problem space needs more work
- If YES → continue to context mapping
### 5. Spawn Context Mapper
### 6. Spawn Context Mapper
Use Task tool to spawn `context-mapper` agent:
```
Identify bounded contexts from the problem space.
Problem Map: [from previous step]
Problem Map: .product-strategy/problem-map.md
Codebase: [current directory]
Analyze:
@@ -103,12 +114,14 @@ Output:
- Boundary rules
- Refactoring needs (if brownfield)
Save artifact to: .product-strategy/context-map.md
Follow context-mapper agent instructions.
```
Agent returns Bounded Context Map.
Agent returns Bounded Context Map saved to `.product-strategy/context-map.md`.
### 6. Context Decision Gate
### 7. Context Decision Gate
Show Bounded Context Map to user and ask:
@@ -119,14 +132,14 @@ Show Bounded Context Map to user and ask:
If NO → revise contexts
If YES → continue to domain modeling
### 7. Spawn Domain Modeler (Per Context)
### 8. Spawn Domain Modeler (Per Context)
For each bounded context, spawn `domain-modeler` agent:
```
Model the domain for bounded context: [CONTEXT_NAME]
Context: [context details from map]
Context: [context details from .product-strategy/context-map.md]
Codebase: [current directory]
Identify:
@@ -138,12 +151,14 @@ Identify:
Compare with existing code if present.
Save artifact to: .product-strategy/domain-[context-name].md
Follow domain-modeler agent instructions.
```
Agent returns Domain Model for this context.
Agent returns Domain Model saved to `.product-strategy/domain-[context-name].md`.
### 8. Domain Model Decision Gate
### 9. Domain Model Decision Gate
For each context, verify:
@@ -151,25 +166,27 @@ For each context, verify:
- If NO → simplify (might be read model or policy)
- If YES → continue
### 9. Spawn Capability Extractor
### 10. Spawn Capability Extractor
Use Task tool to spawn `capability-extractor` agent:
```
Extract product capabilities from domain models.
Domain Models: [all contexts]
Domain Models: .product-strategy/domain-*.md
Output:
- Capability Map
- System abilities that cause meaningful domain changes
Save artifact to: .product-strategy/capabilities.md
Follow capability-extractor agent instructions.
```
Agent returns Capability Map.
Agent returns Capability Map saved to `.product-strategy/capabilities.md`.
### 10. Capability Decision Gate
### 11. Capability Decision Gate
Show Capability Map to user and ask:
@@ -178,15 +195,15 @@ Show Capability Map to user and ask:
- Let user select subset
- Prioritize if needed
### 11. Spawn Backlog Builder
### 12. Spawn Backlog Builder
Use Task tool to spawn `backlog-builder` agent:
```
Generate features and issues from selected capabilities.
Selected Capabilities: [user selection]
Domain Models: [all contexts]
Selected Capabilities: [user selection from .product-strategy/capabilities.md]
Domain Models: .product-strategy/domain-*.md
Codebase: [current directory]
For each capability:
@@ -196,12 +213,14 @@ For each capability:
Follow issue-writing skill format.
Save artifact to: .product-strategy/backlog.md
Follow backlog-builder agent instructions.
```
Agent returns Features + Issues.
Agent returns Features + Issues saved to `.product-strategy/backlog.md`.
### 12. Feature Decision Gate
### 13. Feature Decision Gate
Show generated features and ask:
@@ -211,9 +230,9 @@ Show generated features and ask:
If NO → refine features
If YES → continue to issue creation
### 13. Issue Review
### 14. Issue Review
Present all generated issues to user:
Present all generated issues from `.product-strategy/backlog.md` to user:
```
## Generated Backlog
@@ -237,7 +256,7 @@ Ask user:
- If YES → automatically proceed to create all issues (step 14)
- If NO → ask what to modify, regenerate, ask again
### 14. Create Issues in Gitea (automatic after approval)
### 15. Create Issues in Gitea (automatic after approval)
**After user approves in step 13, automatically create all issues.**
@@ -253,14 +272,14 @@ Apply labels:
- `bounded-context/[context-name]`
- `capability/[capability-name]`
### 15. Link Dependencies
### 16. Link Dependencies
For issues with dependencies:
```bash
tea issues deps add <dependent-issue> <blocker-issue>
```
### 16. Final Report
### 17. Final Report
Show created issues with links:
@@ -279,6 +298,13 @@ Show created issues with links:
Total: 6 issues created across 2 contexts
View backlog: [gitea issues link]
All artifacts saved in .product-strategy/:
- problem-map.md
- context-map.md
- domain-*.md (one per context)
- capabilities.md
- backlog.md
```
## Guidelines