project-iris 0.0.16 → 0.0.17

package/flows/aidlc/agents/inception-agent.md

@@ -49,47 +49,55 @@ When user invokes `/iris-inception-agent`:
 4 - **requirements**: Gather requirements
     → `.iris/aidlc/skills/inception/requirements.md`
 
-5 - **context**: Define system context
+5 - **risks**: Define risk register
+    → `.iris/aidlc/skills/inception/risks.md`
+
+6 - **context**: Define system context
     → `.iris/aidlc/skills/inception/context.md`
 
-6 - **units**: Decompose into units
+7 - **units**: Decompose into units
     → `.iris/aidlc/skills/inception/units.md`
 
-7 - **stories**: Create user stories
+8 - **stories**: Create user stories
     → `.iris/aidlc/skills/inception/story-create.md`
 
-8 - **bolt-plan**: Plan construction bolts
+9 - **bolt-plan**: Plan construction bolts
     → `.iris/aidlc/skills/inception/bolt-plan.md`
 
-9 - **review**: Review and complete
+10 - **review**: Review and complete
     → `.iris/aidlc/skills/inception/review.md`
 
 ---
 
-## Inception Workflow (4 Checkpoints)
+## Inception Workflow (5 Checkpoints)
 
 ```text
 [User Request]
       |
 [Checkpoint 1] Clarifying Questions --> User answers
       |
-[Generate Requirements]
+[Generate Requirements (FRs + NFRs + SLOs)]
       |
 [Checkpoint 2] Requirements Review --> User approves
       |
+[Generate Risk Register]
+      |
+[Checkpoint 3] Risk Register Review --> User approves
+      |
 [Generate Context + Units + Stories + Bolt Plan]  <-- AUTO-CONTINUE
       |
-[Checkpoint 3] Artifacts Review --> User approves
+[Checkpoint 4] Artifacts Review --> User approves
       |
-[Checkpoint 4] Ready for Construction? --> Route to Construction
+[Checkpoint 5] Ready for Construction? --> Route to Construction
 ```
 
 ### Checkpoint Locations
 
 - **Checkpoint 1**: After clarifying questions (requirements skill)
 - **Checkpoint 2**: After requirements generated (requirements skill)
-- **Checkpoint 3**: After all artifacts generated (review skill)
-- **Checkpoint 4**: Ready for construction (review skill)
+- **Checkpoint 3**: After risk register generated (risks skill)
+- **Checkpoint 4**: After all artifacts generated (review skill)
+- **Checkpoint 5**: Ready for construction (review skill)
 
 ### Auto-Continue Rule (CRITICAL)
 
@@ -101,7 +109,7 @@ context → units → stories → bolt-plan → review
 
 When a skill completes, immediately execute the next skill without prompting the user.
 
-Only stop at designated checkpoints (1-4 above).
+Only stop at designated checkpoints (1-5 above).
 
 ---
 
@@ -110,6 +118,9 @@ Only stop at designated checkpoints (1-4 above).
 - **Requirements** → `{intent}/requirements.md`
   Template: `templates/inception/requirements-template.md`
 
+- **Risks** → `{intent}/risks.md`
+  Template: `templates/inception/risks-template.md`
+
 - **System Context** → `{intent}/system-context.md`
   Template: `templates/inception/system-context-template.md`
 

package/flows/aidlc/memory-bank.yaml

@@ -73,6 +73,9 @@ naming:
 # Schema Definition (Source of Truth for Agents)
 schema:
   intents: "memory-bank/intents/{intent-name}/"
+  requirements: "memory-bank/intents/{intent-name}/requirements.md"
+  risks: "memory-bank/intents/{intent-name}/risks.md"
+  system_context: "memory-bank/intents/{intent-name}/system-context.md"
   units: "memory-bank/intents/{intent-name}/units/{unit-name}/"
   stories: "memory-bank/intents/{intent-name}/units/{unit-name}/stories/"
   bolts: "memory-bank/bolts/{bolt-id}/"

package/flows/aidlc/skills/construction/bolt-start.md

@@ -19,6 +19,8 @@
 - ✅ Activities listed with completion status
 - ✅ Artifacts created listed with paths
 - ✅ Checkpoint prompts clear and actionable
+- ✅ Code references stories (comments: `// Story: S-XXX`)
+- ✅ Tests reference acceptance criteria they verify
 
 ## Failure Modes
 
@@ -26,6 +28,8 @@
 - ❌ Starting stage work without updating bolt file status
 - ❌ Skipping checkpoints defined by bolt type
 - ❌ Not reading bolt type definition first
+- ❌ Code without story traceability comments
+- ❌ Tests without acceptance criteria references
 
 ---
 

package/flows/aidlc/skills/inception/bolt-plan.md

@@ -36,12 +36,13 @@ Show at start of this skill:
 ### Inception Progress
 - [x] Intent created
 - [x] Requirements gathered
+- [x] Risks defined
 - [ ] Generating artifacts...  ← current
     - [x] System Context
     - [x] Units
     - [x] Stories
     - [ ] Bolt Plan  ← this skill
-- [ ] Artifacts reviewed (Checkpoint 3)
+- [ ] Artifacts reviewed (Checkpoint 4)
 - [ ] Ready for Construction
 ```
 

package/flows/aidlc/skills/inception/context.md

@@ -35,12 +35,13 @@ Show at start of this skill:
 ### Inception Progress
 - [x] Intent created
 - [x] Requirements gathered
+- [x] Risks defined
 - [ ] Generating artifacts...  ← current
     - [ ] System Context  ← this skill
     - [ ] Units
     - [ ] Stories
     - [ ] Bolt Plan
-- [ ] Artifacts reviewed (Checkpoint 3)
+- [ ] Artifacts reviewed (Checkpoint 4)
 - [ ] Ready for Construction
 ```
 

package/flows/aidlc/skills/inception/navigator.md

@@ -68,11 +68,12 @@ Scan artifacts **in order** - first missing item is the suggested next step:
 
 1. No intent folder exists → **Create Intent**
 2. `requirements.md` missing → **Gather Requirements**
-3. `system-context.md` missing → **Define Context**
-4. `units.md` missing → **Decompose Units**
-5. `story-index.md` missing → **Create Stories**
-6. `bolt-plan.md` missing → **Plan Bolts**
-7. All complete → **Review & Complete**
+3. `risks.md` missing → **Define Risks**
+4. `system-context.md` missing → **Define Context**
+5. `units.md` missing → **Decompose Units**
+6. `story-index.md` missing → **Create Stories**
+7. `bolt-plan.md` missing → **Plan Bolts**
+8. All complete → **Review & Complete**
 
 **CRITICAL**: The suggested step becomes **Option 1** in the menu.
 
@@ -121,6 +122,7 @@ When user selects an option:
 
 ### Progress
 - {✅ or [ ]} Requirements gathered {← current if next step}
+- {✅ or [ ]} Risks defined {← current if next step}
 - {✅ or [ ]} System context defined {← current if next step}
 - {✅ or [ ]} Units decomposed {← current if next step}
 - {✅ or [ ]} Stories created {← current if next step}
@@ -145,7 +147,7 @@ When user selects an option:
 **Type 1 to continue, or a number for other actions.**
 ```
 
-**Example: Requirements done, context missing**
+**Example: Requirements done, risks missing**
 
 ```markdown
 ## Inception Agent
@@ -155,7 +157,8 @@ When user selects an option:
 
 ### Progress
 - ✅ Requirements gathered
-- [ ] System context defined ← current
+- [ ] Risks defined ← current
+- [ ] System context defined
 - [ ] Units decomposed
 - [ ] Stories created
 - [ ] Bolts planned
@@ -165,7 +168,7 @@ When user selects an option:
 
 ### Continue This Intent
 
-1 - **Define Context** ← Next step
+1 - **Define Risks** ← Next step
 2 - Revisit Requirements
 
 ### Other Actions
@@ -191,6 +194,7 @@ When user selects an option:
 All inception artifacts have been created:
 
 - ✅ Requirements gathered
+- ✅ Risks defined
 - ✅ System context defined
 - ✅ Units decomposed
 - ✅ Stories created
@@ -198,6 +202,7 @@ All inception artifacts have been created:
 - ✅ Review complete
 
 ### Summary
+- Risks identified: {n}
 - Units defined: {n}
 - Stories created: {n}
 - Bolts planned: {n}