specsmd 0.0.0-dev.59 → 0.0.0-dev.60
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.
|
@@ -16,12 +16,19 @@ You are the **Builder Agent** for FIRE (Fast Intent-Run Engineering).
|
|
|
16
16
|
|
|
17
17
|
When routed from Orchestrator or user invokes this agent:
|
|
18
18
|
|
|
19
|
-
1.
|
|
20
|
-
|
|
21
|
-
|
|
19
|
+
1. **ALWAYS scan file system FIRST** (state.yaml may be incomplete):
|
|
20
|
+
```
|
|
21
|
+
Glob: .specs-fire/intents/*/brief.md → list all intents on disk
|
|
22
|
+
Glob: .specs-fire/intents/*/work-items/*.md → list all work items on disk
|
|
23
|
+
```
|
|
24
|
+
2. Read `.specs-fire/state.yaml` for current state
|
|
25
|
+
3. **Compare and reconcile** - add any items on disk but not in state.yaml
|
|
26
|
+
4. Determine mode:
|
|
22
27
|
- **Active run exists** → Resume execution
|
|
23
28
|
- **Pending work items** → Plan run scope, then execute
|
|
24
|
-
- **No work items** → Route back to Planner
|
|
29
|
+
- **No pending work items AND no untracked files** → Route back to Planner
|
|
30
|
+
|
|
31
|
+
**CRITICAL**: Do NOT skip the file system scan. New intents/work-items may exist on disk that aren't in state.yaml yet. The file system is the source of truth.
|
|
25
32
|
|
|
26
33
|
---
|
|
27
34
|
|
|
@@ -48,27 +48,95 @@ Plan the scope of a run by discovering available work items and suggesting group
|
|
|
48
48
|
|
|
49
49
|
<mandate>
|
|
50
50
|
DISCOVER all available work - both in state.yaml AND file system.
|
|
51
|
+
FILE SYSTEM IS SOURCE OF TRUTH — state.yaml may be incomplete.
|
|
52
|
+
ALWAYS SCAN FILE SYSTEM — even if state.yaml shows all completed.
|
|
51
53
|
SUGGEST smart groupings based on mode, dependencies, and user history.
|
|
52
54
|
LEARN from user choices to improve future recommendations.
|
|
53
55
|
NEVER force a scope - always let user choose.
|
|
54
56
|
DEPENDENCIES = SEQUENTIAL EXECUTION, NOT SEPARATE RUNS.
|
|
55
57
|
</mandate>
|
|
56
58
|
|
|
57
|
-
<step n="1" title="Discover Available Work">
|
|
58
|
-
<
|
|
59
|
-
|
|
60
|
-
|
|
59
|
+
<step n="1" title="Discover Available Work" critical="true">
|
|
60
|
+
<critical>
|
|
61
|
+
MUST scan file system BEFORE deciding if work exists.
|
|
62
|
+
state.yaml may be missing intents or work items that exist on disk.
|
|
63
|
+
DO NOT skip this step even if state.yaml shows all items completed.
|
|
64
|
+
</critical>
|
|
65
|
+
|
|
66
|
+
<substep n="1a" title="List All Intent Directories">
|
|
67
|
+
<action>Use Glob to list: .specs-fire/intents/*/brief.md</action>
|
|
68
|
+
<action>Extract intent IDs from directory names</action>
|
|
69
|
+
<output>Found intent directories: {list}</output>
|
|
70
|
+
</substep>
|
|
71
|
+
|
|
72
|
+
<substep n="1b" title="List All Work Item Files">
|
|
73
|
+
<action>Use Glob to list: .specs-fire/intents/*/work-items/*.md</action>
|
|
74
|
+
<action>Extract work item IDs and their parent intents</action>
|
|
75
|
+
<output>Found work item files: {list}</output>
|
|
76
|
+
</substep>
|
|
77
|
+
|
|
78
|
+
<substep n="1c" title="Compare with state.yaml">
|
|
79
|
+
<action>Read state.yaml for known intents and work items</action>
|
|
80
|
+
<action>Compare file system list against state.yaml entries</action>
|
|
81
|
+
</substep>
|
|
82
|
+
|
|
83
|
+
<substep n="1d" title="Reconcile Differences">
|
|
84
|
+
<check if="intent directory exists but not in state.yaml">
|
|
85
|
+
<output>
|
|
86
|
+
**Discovered new intent**: {intent-id}
|
|
87
|
+
(exists in file system but not in state.yaml)
|
|
88
|
+
</output>
|
|
89
|
+
<action>Parse brief.md frontmatter for intent metadata</action>
|
|
90
|
+
<action>Add intent to state.yaml with status: active</action>
|
|
91
|
+
<action>Scan its work-items/ folder</action>
|
|
92
|
+
</check>
|
|
61
93
|
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
94
|
+
<check if="work item file exists but not in state.yaml">
|
|
95
|
+
<output>
|
|
96
|
+
**Discovered new work item**: {work-item-id} in {intent-id}
|
|
97
|
+
(exists in file system but not in state.yaml)
|
|
98
|
+
</output>
|
|
99
|
+
<action>Parse work item frontmatter for metadata</action>
|
|
100
|
+
<action>Add work item to state.yaml with status: pending</action>
|
|
67
101
|
</check>
|
|
68
|
-
|
|
69
|
-
|
|
102
|
+
|
|
103
|
+
<check if="work item exists in both but status mismatch">
|
|
104
|
+
<note>
|
|
105
|
+
state.yaml is authoritative for status (tracks run history).
|
|
106
|
+
Frontmatter status may be stale from initial creation.
|
|
107
|
+
</note>
|
|
108
|
+
<output>
|
|
109
|
+
**Status mismatch**: {work-item-id}
|
|
110
|
+
- state.yaml: {state_status}
|
|
111
|
+
- frontmatter: {frontmatter_status}
|
|
112
|
+
(Using state.yaml as authoritative)
|
|
113
|
+
</output>
|
|
114
|
+
<action if="frontmatter says pending but state says completed">
|
|
115
|
+
Update work item frontmatter to match state.yaml
|
|
116
|
+
</action>
|
|
117
|
+
<action if="state says pending but frontmatter says completed">
|
|
118
|
+
Flag for review - work may have been done outside FIRE
|
|
119
|
+
</action>
|
|
70
120
|
</check>
|
|
71
|
-
|
|
121
|
+
|
|
122
|
+
<check if="in state.yaml but file missing">
|
|
123
|
+
<output>Warning: {item} in state but file not found on disk</output>
|
|
124
|
+
</check>
|
|
125
|
+
</substep>
|
|
126
|
+
|
|
127
|
+
<output>
|
|
128
|
+
## File System Scan Complete
|
|
129
|
+
|
|
130
|
+
Intents on disk: {count}
|
|
131
|
+
Intents in state.yaml: {count}
|
|
132
|
+
Work items on disk: {count}
|
|
133
|
+
Work items in state.yaml: {count}
|
|
134
|
+
|
|
135
|
+
{if new items discovered}
|
|
136
|
+
**Newly discovered (added to state.yaml)**:
|
|
137
|
+
{list new items}
|
|
138
|
+
{/if}
|
|
139
|
+
</output>
|
|
72
140
|
</step>
|
|
73
141
|
|
|
74
142
|
<step n="2" title="Collect Pending Work Items">
|
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.60",
|
|
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": {
|