specsmd 0.0.0-dev.66 → 0.0.0-dev.68
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -82,18 +82,23 @@ You are the **Planner Agent** for FIRE (Fast Intent-Run Engineering).
|
|
|
82
82
|
<design_document_flow>
|
|
83
83
|
For high-complexity work items requiring Validate mode:
|
|
84
84
|
|
|
85
|
+
<critical>Use LOW degrees of freedom. Follow structure precisely.</critical>
|
|
86
|
+
|
|
85
87
|
```
|
|
86
|
-
[1]
|
|
87
|
-
[2]
|
|
88
|
-
[3]
|
|
88
|
+
[1] Read work item from .specs-fire/intents/{intent-id}/work-items/{work-item-id}.md
|
|
89
|
+
[2] Review standards from .specs-fire/standards/
|
|
90
|
+
[3] Identify key decisions needed
|
|
91
|
+
[4] Draft:
|
|
89
92
|
- Key decisions table (decision, choice, rationale)
|
|
90
93
|
- Domain model (if applicable)
|
|
91
94
|
- Technical approach (component diagram, API contracts)
|
|
92
95
|
- Risks and mitigations
|
|
93
96
|
- Implementation checklist
|
|
94
|
-
[
|
|
95
|
-
[
|
|
96
|
-
[
|
|
97
|
+
[5] Present to user for review (Checkpoint 1)
|
|
98
|
+
[6] Incorporate feedback
|
|
99
|
+
[7] Generate using template: skills/design-doc-generate/templates/design.md.hbs
|
|
100
|
+
[8] Save to .specs-fire/intents/{intent-id}/work-items/{work-item-id}-design.md
|
|
101
|
+
[9] Update state.yaml (mark checkpoint_1: approved)
|
|
97
102
|
```
|
|
98
103
|
</design_document_flow>
|
|
99
104
|
|
|
@@ -12,6 +12,18 @@ checkpoint_1: {{checkpoint_status}}
|
|
|
12
12
|
|
|
13
13
|
{{summary}}
|
|
14
14
|
|
|
15
|
+
## Scope
|
|
16
|
+
|
|
17
|
+
**In Scope:**
|
|
18
|
+
{{#each in_scope}}
|
|
19
|
+
- {{this}}
|
|
20
|
+
{{/each}}
|
|
21
|
+
|
|
22
|
+
**Out of Scope:**
|
|
23
|
+
{{#each out_of_scope}}
|
|
24
|
+
- {{this}}
|
|
25
|
+
{{/each}}
|
|
26
|
+
|
|
15
27
|
## Key Decisions
|
|
16
28
|
|
|
17
29
|
| Decision | Choice | Rationale |
|
|
@@ -20,33 +32,35 @@ checkpoint_1: {{checkpoint_status}}
|
|
|
20
32
|
| {{this.decision}} | {{this.choice}} | {{this.rationale}} |
|
|
21
33
|
{{/each}}
|
|
22
34
|
|
|
23
|
-
|
|
24
|
-
## Domain Model
|
|
35
|
+
## Data Models Affected
|
|
25
36
|
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
37
|
+
{{#if models_created}}
|
|
38
|
+
### Creates
|
|
39
|
+
{{#each models_created}}
|
|
40
|
+
- **{{this.name}}**: {{this.fields}} — {{this.purpose}}
|
|
29
41
|
{{/each}}
|
|
42
|
+
{{/if}}
|
|
30
43
|
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
44
|
+
{{#if models_modified}}
|
|
45
|
+
### Modifies
|
|
46
|
+
{{#each models_modified}}
|
|
47
|
+
- **{{this.name}}**: {{this.changes}} — {{this.reason}}
|
|
34
48
|
{{/each}}
|
|
35
49
|
{{/if}}
|
|
36
50
|
|
|
37
51
|
## Technical Approach
|
|
38
52
|
|
|
39
|
-
###
|
|
53
|
+
### Architecture
|
|
40
54
|
|
|
41
55
|
```
|
|
42
56
|
{{component_diagram}}
|
|
43
57
|
```
|
|
44
58
|
|
|
45
|
-
{{#if
|
|
46
|
-
### API
|
|
59
|
+
{{#if api_changes}}
|
|
60
|
+
### API Changes
|
|
47
61
|
|
|
48
|
-
{{#each
|
|
49
|
-
- `{{this.method}} {{this.path}}`
|
|
62
|
+
{{#each api_changes}}
|
|
63
|
+
- `{{this.method}} {{this.path}}` — {{this.description}}
|
|
50
64
|
{{/each}}
|
|
51
65
|
{{/if}}
|
|
52
66
|
|
|
@@ -58,6 +72,40 @@ checkpoint_1: {{checkpoint_status}}
|
|
|
58
72
|
```
|
|
59
73
|
{{/if}}
|
|
60
74
|
|
|
75
|
+
{{#if dependencies}}
|
|
76
|
+
## Dependencies
|
|
77
|
+
|
|
78
|
+
{{#each dependencies}}
|
|
79
|
+
- {{this}}
|
|
80
|
+
{{/each}}
|
|
81
|
+
{{/if}}
|
|
82
|
+
|
|
83
|
+
## Affected Files
|
|
84
|
+
|
|
85
|
+
| File | Action | Purpose |
|
|
86
|
+
|------|--------|---------|
|
|
87
|
+
{{#each affected_files}}
|
|
88
|
+
| `{{this.path}}` | {{this.action}} | {{this.purpose}} |
|
|
89
|
+
{{/each}}
|
|
90
|
+
|
|
91
|
+
{{#if security_considerations}}
|
|
92
|
+
## Security Considerations
|
|
93
|
+
|
|
94
|
+
{{#each security_considerations}}
|
|
95
|
+
- **{{this.concern}}**: {{this.approach}}
|
|
96
|
+
{{/each}}
|
|
97
|
+
{{/if}}
|
|
98
|
+
|
|
99
|
+
{{#if integration_points}}
|
|
100
|
+
## Integration Points
|
|
101
|
+
|
|
102
|
+
| System | Type | Purpose |
|
|
103
|
+
|--------|------|---------|
|
|
104
|
+
{{#each integration_points}}
|
|
105
|
+
| {{this.system}} | {{this.type}} | {{this.purpose}} |
|
|
106
|
+
{{/each}}
|
|
107
|
+
{{/if}}
|
|
108
|
+
|
|
61
109
|
## Risks & Mitigations
|
|
62
110
|
|
|
63
111
|
| Risk | Impact | Mitigation |
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "specsmd",
|
|
3
|
-
"version": "0.0.0-dev.
|
|
3
|
+
"version": "0.0.0-dev.68",
|
|
4
4
|
"description": "Multi-agent orchestration system for AI-native software development. Delivers AI-DLC, Agile, and custom SDLC flows as markdown-based agent systems.",
|
|
5
5
|
"main": "lib/installer.js",
|
|
6
6
|
"bin": {
|