forge-orkes 0.9.0 → 0.9.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forge-orkes",
-  "version": "0.9.0",
+  "version": "0.9.2",
   "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:
 

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

@@ -99,9 +99,8 @@ No match → fall through to Step 2B (tier detection).
 
 ### Parent Session Model Advisory
 
-Check `models.parent_session` from `project.yml`. **Always display:** *"Session model: {current}. Project recommends: {parent_session}."*
-Mismatch → append: *"Use `/model` to switch."*
-- Advisory only -- no block. Reviewer enforces at review gate.
+Check `models.parent_session` from `project.yml`. Show only on mismatch: *"Session model: {current}. Project recommends: {parent_session} — use `/model {parent_session}` to switch."*
+- Advisory only — no block. Reviewer enforces at review gate.
 
 ## Step 2A: Project Init
 
@@ -157,11 +156,11 @@ Read `models` from `project.yml`:
 2. `models.default` → fallback
 3. Inherit parent session
 
-Resolve `{model}` for `{next}` skill using precedence above. **Always display** the resolved model in the routing briefing and its source:
+Resolve `{model}` for `{next}` skill using precedence above. Show only on mismatch:
 
-*"Skill {next} expects {model} (from {source}). Running {current_model}."*
+*"Session: {current_model}. {next} expects {model} (from {source}) — use `/model {model}` to switch."*
 
-Where `{source}` = `skills.{name}` | `models.default` | `parent session`. Show on every transition, not just mismatch. If mismatch, append: *"Use `/model` to switch."*
+Where `{source}` = `skills.{name}` | `models.default` | `parent session`. Suppress when session model matches expected.
 
 **Model routing is advisory.** All phases use `Skill()`. Display expected model at each transition. Mismatch → suggest `/model {expected}`. Review gate logs model used.