specsmd 0.0.0-dev.49 → 0.0.0-dev.50

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.
@@ -71,17 +71,44 @@ Initialize a new FIRE project by detecting workspace type and setting up standar
71
71
  </output>
72
72
  </step>
73
73
 
74
- <step n="4" title="Create Structure">
74
+ <step n="4" title="Choose Autonomy Level">
75
+ <output>
76
+ How autonomous should FIRE be when executing work items?
77
+
78
+ **[1] Autonomous** — AI executes more freely, fewer checkpoints
79
+ (medium complexity → autopilot, high → confirm)
80
+
81
+ **[2] Balanced** — Standard checkpoints based on complexity (Recommended)
82
+ (low → autopilot, medium → confirm, high → validate)
83
+
84
+ **[3] Controlled** — More human oversight, more checkpoints
85
+ (low → confirm, medium/high → validate)
86
+
87
+ Choose [1/2/3]:
88
+ </output>
89
+ <check if="response == 1">
90
+ <set>workspace.autonomy_bias = autonomous</set>
91
+ </check>
92
+ <check if="response == 2">
93
+ <set>workspace.autonomy_bias = balanced</set>
94
+ </check>
95
+ <check if="response == 3">
96
+ <set>workspace.autonomy_bias = controlled</set>
97
+ </check>
98
+ <note>Can be changed later in .specs-fire/state.yaml</note>
99
+ </step>
100
+
101
+ <step n="5" title="Create Structure">
75
102
  <action>Create .specs-fire/ directory</action>
76
103
  <action>Create .specs-fire/intents/</action>
77
104
  <action>Create .specs-fire/runs/</action>
78
105
  <action>Create .specs-fire/standards/</action>
79
- <action>Generate .specs-fire/state.yaml</action>
106
+ <action>Generate .specs-fire/state.yaml (include autonomy_bias)</action>
80
107
  <action>Generate .specs-fire/standards/tech-stack.md</action>
81
108
  <action>Generate .specs-fire/standards/coding-standards.md</action>
82
109
  </step>
83
110
 
84
- <step n="5" title="Complete">
111
+ <step n="6" title="Complete">
85
112
  <output>
86
113
  FIRE initialized!
87
114
 
@@ -26,6 +26,7 @@ Display current FIRE project status.
26
26
 
27
27
  **Project**: {project.name}
28
28
  **Workspace**: {workspace.type} / {workspace.structure}
29
+ **Autonomy**: {workspace.autonomy_bias}
29
30
 
30
31
  ## Intents
31
32
 
@@ -71,6 +72,7 @@ Display current FIRE project status.
71
72
 
72
73
  **Project**: my-saas-app
73
74
  **Workspace**: brownfield / monolith
75
+ **Autonomy**: balanced
74
76
 
75
77
  ## Intents
76
78
 
@@ -46,14 +46,13 @@ Break an intent into discrete, executable work items.
46
46
  </step>
47
47
 
48
48
  <step n="3" title="Assess Complexity">
49
- <action>For each work item, assess complexity:</action>
49
+ <action>For each work item, assess RAW complexity:</action>
50
50
 
51
51
  <complexity level="low">
52
52
  - Single file or few files
53
53
  - Well-understood pattern
54
54
  - No external dependencies
55
55
  - Examples: bug fix, config change, simple utility
56
- → Mode: autopilot
57
56
  </complexity>
58
57
 
59
58
  <complexity level="medium">
@@ -61,7 +60,6 @@ Break an intent into discrete, executable work items.
61
60
  - Standard patterns with some decisions
62
61
  - May touch existing code
63
62
  - Examples: new endpoint, new component, feature addition
64
- → Mode: confirm
65
63
  </complexity>
66
64
 
67
65
  <complexity level="high">
@@ -69,10 +67,29 @@ Break an intent into discrete, executable work items.
69
67
  - Security or data implications
70
68
  - Core system changes
71
69
  - Examples: auth system, payment flow, database migration
72
- → Mode: validate
73
70
  </complexity>
74
71
  </step>
75
72
 
73
+ <step n="3b" title="Apply Autonomy Bias">
74
+ <action>Read workspace.autonomy_bias from state.yaml</action>
75
+ <action>Apply bias to determine final execution mode:</action>
76
+
77
+ <bias-table>
78
+ | Raw Complexity | autonomous | balanced | controlled |
79
+ |----------------|------------|----------|------------|
80
+ | low | autopilot | autopilot| confirm |
81
+ | medium | autopilot | confirm | validate |
82
+ | high | confirm | validate | validate |
83
+ </bias-table>
84
+
85
+ <note>
86
+ This allows user preference to shift thresholds:
87
+ - autonomous: trusts AI more, fewer checkpoints
88
+ - balanced: standard behavior (default)
89
+ - controlled: more human oversight
90
+ </note>
91
+ </step>
92
+
76
93
  <step n="4" title="Define Acceptance Criteria">
77
94
  <action>For each work item, define:</action>
78
95
  <substep>What must be true when complete</substep>
@@ -26,7 +26,7 @@ state:
26
26
  workspace:
27
27
  - type: "greenfield | brownfield"
28
28
  - structure: "monolith | monorepo | multi-part"
29
- - default_mode: "autopilot | confirm | validate"
29
+ - autonomy_bias: "autonomous | balanced | controlled"
30
30
  - scanned_at: "ISO 8601 timestamp (brownfield)"
31
31
  - parts: "List of project parts (monorepo)"
32
32
  intents:
@@ -102,8 +102,30 @@ execution_modes:
102
102
  complexity: high
103
103
  description: "Design doc review, then plan confirmation, then execution"
104
104
 
105
- # Work Item Complexity Mapping
105
+ # Work Item Complexity Mapping (default, when autonomy_bias = balanced)
106
106
  complexity_modes:
107
107
  low: autopilot
108
108
  medium: confirm
109
109
  high: validate
110
+
111
+ # Autonomy Bias - Shifts complexity→mode thresholds
112
+ # User preference captured at project init, stored in workspace.autonomy_bias
113
+ autonomy_bias:
114
+ autonomous:
115
+ description: "AI executes more freely, fewer checkpoints"
116
+ mapping:
117
+ low: autopilot
118
+ medium: autopilot # shifted down
119
+ high: confirm # shifted down
120
+ balanced:
121
+ description: "Standard checkpoints based on complexity"
122
+ mapping:
123
+ low: autopilot
124
+ medium: confirm
125
+ high: validate
126
+ controlled:
127
+ description: "More human oversight, more checkpoints"
128
+ mapping:
129
+ low: confirm # shifted up
130
+ medium: validate # shifted up
131
+ high: validate
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "specsmd",
3
- "version": "0.0.0-dev.49",
3
+ "version": "0.0.0-dev.50",
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": {