forge-orkes 0.9.0 → 0.9.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forge-orkes",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "Set up the Forge meta-prompting framework for Claude Code in your project",
   "bin": {
     "create-forge": "./bin/create-forge.js"

package/template/.claude/skills/discussing/SKILL.md

@@ -23,16 +23,33 @@ Structured conversation: approach, trade-offs, decisions. Clarity, not artifacts
 
 ## Progressive Persistence
 
-**Decisions persist immediately.** After each user response that confirms a decision, write it to `.forge/context.md` right away. Don't accumulate in working memory.
+**Decisions persist immediately. This is a hard gate — not a guideline.**
 
-### Rules
+After each user response that confirms a decision:
 
-1. **Create `context.md` on first decision** if it doesn't exist (from template `.forge/templates/context.md`)
-2. **Scope by milestone.** Add decisions under `### M{id} — {name} (drafting)` inside `## Locked Decisions`
-3. **Append, don't rewrite.** Each confirmed decision → append one `- **[Topic]**: [Decision]. Reason: [Why]` line
-4. **Deferred ideas too.** User says "not now" / "later" / "skip" → append to `## Deferred Ideas` immediately
-5. **Discretion areas too.** Left to agent judgment → append to `## Discretion Areas` immediately
-6. **Phase Handoff promotes.** Rename `(drafting)` → `(locked {date})` at convergence. No content change needed — decisions are already written
+1. **STOP** — do not continue the discussion
+2. **Write to disk** — append to `.forge/context.md` (create from template if missing)
+3. **THEN** continue to the next question
+
+Never accumulate decisions in working memory. Never batch writes to convergence.
+
+### Write Protocol
+
+**On first decision of the session:**
+- Check if `.forge/context.md` exists. If not → create it from `.forge/templates/context.md`
+- Add a milestone heading inside `## Locked Decisions`: `### M{id} — {name} (drafting)` (use "M?" if no milestone yet)
+
+**On each confirmed decision:**
+- Append under the milestone heading: `- **[Topic]**: [Decision]. Reason: [Why]`
+
+**On deferred ideas** (user says "not now" / "later" / "skip"):
+- Append to `## Deferred Ideas` immediately: `- [Idea] — Deferred because: [reason]`
+
+**On discretion areas** (left to agent judgment):
+- Append to `## Discretion Areas` immediately
+
+**At Phase Handoff:**
+- Rename `(drafting)` → `(locked {date})` — decisions are already written, just finalize the heading
 
 ### Why
 
@@ -145,7 +162,13 @@ Apply Functionality Distillation (above), grounded in research findings.
 
 **After each user response:** write confirmed behavioral decisions to `context.md` immediately.
 
-### Step 5: Converge
+### Step 5: Pre-Convergence Audit
+
+**Before summarizing, read `.forge/context.md` and verify all confirmed decisions are present.**
+
+If any decision from the conversation is missing from the file → write it now. Do not proceed to the summary until the file matches the conversation. This is a hard gate.
+
+### Step 6: Converge
 
 Summarize decided items, then confirm: