@vpxa/aikit 0.1.65 → 0.1.67

package/scaffold/flows/aikit-basic/steps/design/README.md

@@ -18,13 +18,14 @@ Classify the task into one of these categories:
 | **Refactor** | Code cleanup, rename, restructure, no behavior change | → **Auto-skip** to next step |
 | **Small feature** | New behavior, new endpoint, new component, UI change | → Run **Quick Design** below |
 
-**If the task is a bug fix or refactor**, produce a minimal `design-decisions.md`:
+**If the task is a bug fix or refactor**, write `{{artifacts_path}}/design-decisions.md` to disk:
 ```markdown
 ## Design Decisions
 - **Task type**: Bug fix / Refactor
 - **Design gate**: Auto-skipped — no design work needed
 - **Proceed to**: Assessment
 ```
+**You MUST create this file on disk** at the exact `{{artifacts_path}}/design-decisions.md` path — do not just present the content in chat.
 Then report `DONE` to the Orchestrator so the flow advances.
 
 ### 2. Quick Design (Small Features Only)
@@ -39,7 +40,7 @@ For small features that need minimal design:
 3. **Decision Protocol** (if technical decisions exist) — Delegate to 2-4 Researcher agents in parallel:
    - Each researcher evaluates a different approach
    - Synthesize findings into a recommendation
-4. **Produce `design-decisions.md`**:
+4. **Write `{{artifacts_path}}/design-decisions.md`** to disk:
 
 ```markdown
 ## Design Decisions
@@ -66,9 +67,13 @@ When complete, report status:
 
 **Do NOT call `flow_step`** — let the Orchestrator advance the flow.
 
+## Outputs
+
+Write `{{artifacts_path}}/design-decisions.md` to disk. **You MUST create this file** using `create_file` or equivalent — do not just present content in chat. This file is a prerequisite for the next step.
+
 ## Produces
 
-- `design-decisions.md` — Task classification, FORGE tier, key design decisions
+- `{{artifacts_path}}/design-decisions.md` — Task classification, FORGE tier, key design decisions
 
 ## Agents
 
@@ -96,6 +101,10 @@ Load these skills BEFORE executing this step:
 
 ## Completion Criteria
 
+- [ ] `{{artifacts_path}}/design-decisions.md` written to disk (NOT just presented in chat)
+- [ ] FORGE tier determined (for small features)
+- [ ] Key design decisions documented
+
 ## Knowledge Capture
 
 Before completing this step, persist important findings using `remember()`:

package/scaffold/flows/aikit-basic/steps/implement/README.md

@@ -39,7 +39,9 @@ If any prerequisites are missing or incomplete:
 
 ## Outputs
 
-Produce `{{artifacts_path}}/progress.md` with:
+Write `{{artifacts_path}}/progress.md` to disk. **You MUST create this file** using `create_file` or equivalent — do not just present content in chat.
+
+Template:
 
 ```markdown
 # Implementation Progress: <task title>

package/scaffold/flows/aikit-basic/steps/verify/README.md

@@ -42,7 +42,9 @@ If any prerequisites are missing or incomplete:
 
 ## Outputs
 
-Produce `{{artifacts_path}}/verify-report.md` with:
+Write `{{artifacts_path}}/verify-report.md` to disk. **You MUST create this file** using `create_file` or equivalent — do not just present content in chat.
+
+Template:
 
 ```markdown
 # Verification Report: <task title>