@nforma.ai/nforma 0.2.1 → 0.29.0

package/bin/verify-quorum-health.cjs

@@ -85,7 +85,7 @@ function pMajorityExternal(agents) {
 // Atomically updates maxDeliberation in the XState machine and config.json,
 // then regenerates formal specs. Returns { success, newValue, machineUpdated, configUpdated, specsRegenerated, error, rolledBack }
 function applyMaxDeliberationUpdate(newValue, options = {}) {
-  const machineFile = options.machineFile || path.join(ROOT, 'src', 'machines', 'qgsd-workflow.machine.ts');
+  const machineFile = options.machineFile || path.join(ROOT, 'src', 'machines', 'nf-workflow.machine.ts');
   const configFile = options.configFile || path.join(ROOT, '.planning', 'config.json');
   const skipSpecGen = options.skipSpecGen || false; // For testing without generate-formal-specs.cjs
 
@@ -135,6 +135,40 @@ function applyMaxDeliberationUpdate(newValue, options = {}) {
   }
 }
 
+// computePassAtKRates(conformanceEventsPath)
+// Reads a JSONL conformance events file and computes pass@k consensus efficiency
+// rates from quorum_complete APPROVE events that have a pass_at_k field.
+// Excludes cache-hit events (pass_at_k === 0) and pre-PASSK events (no pass_at_k field).
+// Returns { total, pass_at_1, pass_at_3, avg_k } — rates as floats 0.0-1.0.
+function computePassAtKRates(conformanceEventsPath) {
+  const result = { total: 0, pass_at_1: 0, pass_at_3: 0, avg_k: 0 };
+  if (!fs.existsSync(conformanceEventsPath)) return result;
+
+  const lines = fs.readFileSync(conformanceEventsPath, 'utf8')
+    .split('\n')
+    .filter(l => l.trim().length > 0);
+
+  const qualifying = [];
+  for (const line of lines) {
+    try {
+      const evt = JSON.parse(line);
+      if (evt.action !== 'quorum_complete') continue;
+      if (evt.outcome !== 'APPROVE') continue;
+      if (typeof evt.pass_at_k !== 'number') continue; // skip pre-PASSK events
+      if (evt.pass_at_k === 0) continue; // skip cache hits
+      qualifying.push(evt.pass_at_k);
+    } catch { /* skip malformed lines */ }
+  }
+
+  if (qualifying.length === 0) return result;
+
+  result.total = qualifying.length;
+  result.pass_at_1 = qualifying.filter(k => k === 1).length / qualifying.length;
+  result.pass_at_3 = qualifying.filter(k => k <= 3).length / qualifying.length;
+  result.avg_k = qualifying.reduce((sum, k) => sum + k, 0) / qualifying.length;
+  return result;
+}
+
 // ── CLI Handler ───────────────────────────────────────────────────────────────
 
 function main() {
@@ -145,7 +179,7 @@ function main() {
 
   // ── Load XState machine (source of truth for MaxDeliberation) ─────────────────
   const machineSrc = fs.readFileSync(
-    path.join(ROOT, 'src', 'machines', 'qgsd-workflow.machine.ts'), 'utf8'
+    path.join(ROOT, 'src', 'machines', 'nf-workflow.machine.ts'), 'utf8'
   );
   const maxDelibMatch = machineSrc.match(/maxDeliberation:\s*(\d+)/);
   const maxDelib = maxDelibMatch ? parseInt(maxDelibMatch[1], 10) : null;
@@ -193,7 +227,7 @@ function main() {
   const pPriorWithinK = k => 1 - Math.pow(1 - P_PRIOR_PER_ROUND, k);
 
   // ── Report ────────────────────────────────────────────────────────────────────
-  process.stdout.write('\n[verify-quorum-health] QGSD Quorum Reliability Report\n');
+  process.stdout.write('\n[verify-quorum-health] nForma Quorum Reliability Report\n');
   process.stdout.write('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n');
 
   process.stdout.write('Per-agent effective approval probability (tp_rate × availability):\n');
@@ -233,6 +267,33 @@ function main() {
   // ── Gate ──────────────────────────────────────────────────────────────────────
   const pass = pActual >= TARGET_CONFIDENCE;
 
+  // ── Pass@k Consensus Efficiency ──────────────────────────────────────────
+  try {
+    let conformancePath;
+    try {
+      const pp = require('./planning-paths.cjs');
+      conformancePath = pp.resolve(ROOT, 'conformance-events');
+    } catch (_) {
+      // Fallback: try both canonical and legacy paths directly
+      const canonical = path.join(ROOT, '.planning', 'telemetry', 'conformance-events.jsonl');
+      const legacy = path.join(ROOT, '.planning', 'conformance-events.jsonl');
+      conformancePath = fs.existsSync(canonical) ? canonical : legacy;
+    }
+    const passAtK = computePassAtKRates(conformancePath);
+    process.stdout.write('## Pass@k Consensus Efficiency\n');
+    if (passAtK.total > 0) {
+      process.stdout.write('  pass@1:              ' + (passAtK.pass_at_1 * 100).toFixed(1) + '%\n');
+      process.stdout.write('  pass@3:              ' + (passAtK.pass_at_3 * 100).toFixed(1) + '%\n');
+      process.stdout.write('  avg rounds:          ' + passAtK.avg_k.toFixed(1) + '\n');
+      process.stdout.write('  total quorum events: ' + passAtK.total + '\n');
+    } else {
+      process.stdout.write('  No pass@k data available yet (requires quorum runs after v0.28-02).\n');
+    }
+    process.stdout.write('\n');
+  } catch (_) {
+    // Fail-open: pass@k reporting is informational, never blocks the gate
+  }
+
   if (pass) {
     process.stdout.write('✓ PASS  P(within ' + maxDelib + ' rounds) = ' + (pActual * 100).toFixed(1) + '% ≥ ' + (TARGET_CONFIDENCE * 100).toFixed(0) + '% target\n\n');
   } else {
@@ -256,7 +317,7 @@ function main() {
       }
     } else {
       process.stderr.write('        Run with --auto-apply to apply automatically, or manually update:\n' +
-        '        src/machines/qgsd-workflow.machine.ts and re-run: node bin/generate-formal-specs.cjs && node bin/check-spec-sync.cjs\n\n');
+        '        src/machines/nf-workflow.machine.ts and re-run: node bin/generate-formal-specs.cjs && node bin/check-spec-sync.cjs\n\n');
       process.exit(1);
     }
   }
@@ -264,7 +325,7 @@ function main() {
 
 // ── Exports ───────────────────────────────────────────────────────────────────
 
-module.exports = { suggestMaxDeliberation, applyMaxDeliberationUpdate, computeRates, pMajorityExternal };
+module.exports = { suggestMaxDeliberation, applyMaxDeliberationUpdate, computeRates, pMajorityExternal, computePassAtKRates };
 
 // ── CLI Execution ─────────────────────────────────────────────────────────────
 

package/bin/xstate-to-tla.cjs

@@ -12,11 +12,11 @@
 //
 // Usage:
 //   node bin/xstate-to-tla.cjs <machine-file.ts>
-//   node bin/xstate-to-tla.cjs src/machines/qgsd-workflow.machine.ts \
-//       --module=QGSDQuorum \
-//       --config=.planning/formal/tla/guards/qgsd-workflow.json
+//   node bin/xstate-to-tla.cjs src/machines/nf-workflow.machine.ts \
+//       --module=NFQuorum \
+//       --config=.planning/formal/tla/guards/nf-workflow.json
 //   node bin/xstate-to-tla.cjs src/machines/account-manager.machine.ts \
-//       --module=QGSDAccountManager \
+//       --module=NFAccountManager \
 //       --config=.planning/formal/tla/guards/account-manager.json \
 //       --dry
 //

package/bin/xstate-trace-walker.cjs

@@ -19,11 +19,11 @@ let _cachedMachineModule = null;
 
 function loadMachineModule() {
   if (_cachedMachineModule) return _cachedMachineModule;
-  const repoDist    = path.join(__dirname, '..', 'dist', 'machines', 'qgsd-workflow.machine.cjs');
-  const installDist = path.join(__dirname, 'dist', 'machines', 'qgsd-workflow.machine.cjs');
+  const repoDist    = path.join(__dirname, '..', 'dist', 'machines', 'nf-workflow.machine.js');
+  const installDist = path.join(__dirname, 'dist', 'machines', 'nf-workflow.machine.js');
   const machinePath = fs.existsSync(repoDist) ? repoDist : installDist;
   if (!fs.existsSync(machinePath)) {
-    throw new Error('Cannot find qgsd-workflow.machine.cjs at ' + repoDist + ' or ' + installDist);
+    throw new Error('Cannot find nf-workflow.machine.js at ' + repoDist + ' or ' + installDist);
   }
   _cachedMachineModule = require(machinePath);
   return _cachedMachineModule;

package/commands/{qgsd → nf}/add-phase.md

@@ -1,5 +1,5 @@
 ---
-name: qgsd:add-phase
+name: nf:add-phase
 description: Add phase to end of current milestone in roadmap
 argument-hint: <description>
 allowed-tools:
@@ -19,7 +19,7 @@ Routes to the add-phase workflow which handles:
 </objective>
 
 <execution_context>
-@~/.claude/qgsd/workflows/add-phase.md
+@~/.claude/nf/workflows/add-phase.md
 </execution_context>
 
 <context>
@@ -29,7 +29,7 @@ Roadmap and state are resolved in-workflow via `init phase-op` and targeted tool
 </context>
 
 <process>
-**Follow the add-phase workflow** from `@~/.claude/qgsd/workflows/add-phase.md`.
+**Follow the add-phase workflow** from `@~/.claude/nf/workflows/add-phase.md`.
 
 The workflow handles all logic including:
 1. Argument parsing and validation

package/commands/{qgsd → nf}/add-requirement.md

@@ -1,5 +1,5 @@
 ---
-name: qgsd:add-requirement
+name: nf:add-requirement
 description: Add a single requirement to .planning/formal/requirements.json with duplicate and conflict checks
 argument-hint: [--id=PREFIX-NN] [--text="..."] [--category="..."] [--phase=vX.XX-NN] [--dry-run]
 allowed-tools:
@@ -15,10 +15,10 @@ Add a single requirement to the formal requirements envelope (`.planning/formal/
 </objective>
 
 <execution_context>
-@~/.claude/qgsd/workflows/add-requirement.md
+@~/.claude/nf/workflows/add-requirement.md
 </execution_context>
 
 <process>
-Execute the add-requirement workflow from @~/.claude/qgsd/workflows/add-requirement.md end-to-end.
+Execute the add-requirement workflow from @~/.claude/nf/workflows/add-requirement.md end-to-end.
 Pass through all --flags from arguments. If required fields (id, text, category, phase) are not provided as arguments, prompt the user interactively.
 </process>

package/commands/{qgsd → nf}/add-todo.md

@@ -1,5 +1,5 @@
 ---
-name: qgsd:add-todo
+name: nf:add-todo
 description: Capture idea or task as todo from current conversation context
 argument-hint: [optional description]
 allowed-tools:
@@ -23,7 +23,7 @@ Routes to the add-todo workflow which handles:
 </objective>
 
 <execution_context>
-@~/.claude/qgsd/workflows/add-todo.md
+@~/.claude/nf/workflows/add-todo.md
 </execution_context>
 
 <context>
@@ -33,7 +33,7 @@ State is resolved in-workflow via `init todos` and targeted reads.
 </context>
 
 <process>
-**Follow the add-todo workflow** from `@~/.claude/qgsd/workflows/add-todo.md`.
+**Follow the add-todo workflow** from `@~/.claude/nf/workflows/add-todo.md`.
 
 The workflow handles all logic including:
 1. Directory ensuring

package/commands/{qgsd → nf}/audit-milestone.md

@@ -1,5 +1,5 @@
 ---
-name: qgsd:audit-milestone
+name: nf:audit-milestone
 description: Audit milestone completion against original intent before archiving
 argument-hint: "[version] [--auto]"
 allowed-tools:
@@ -12,13 +12,13 @@ allowed-tools:
   - AskUserQuestion
 ---
 <objective>
-Verify milestone achieved its definition of done. Check requirements coverage, cross-phase integration, and end-to-end flows.
+Verify milestone achieved its definition of done. Check requirements coverage, cross-phase integration, and end-to-end flows. Auto-remediates tech debt and gaps via solve→plan→execute loop.
 
 **This command IS the orchestrator.** Reads existing VERIFICATION.md files (phases already verified during execute-phase), aggregates tech debt and deferred gaps, then spawns integration checker for cross-phase wiring.
 </objective>
 
 <execution_context>
-@~/.claude/qgsd/workflows/audit-milestone.md
+@~/.claude/nf/workflows/audit-milestone.md
 </execution_context>
 
 <context>
@@ -32,6 +32,6 @@ Glob: .planning/phases/*/*-VERIFICATION.md
 </context>
 
 <process>
-Execute the audit-milestone workflow from @~/.claude/qgsd/workflows/audit-milestone.md end-to-end.
+Execute the audit-milestone workflow from @~/.claude/nf/workflows/audit-milestone.md end-to-end.
 Preserve all workflow gates (scope determination, verification reading, integration check, requirements coverage, routing).
 </process>

package/commands/{qgsd → nf}/check-todos.md

@@ -1,5 +1,5 @@
 ---
-name: qgsd:check-todos
+name: nf:check-todos
 description: List pending todos and select one to work on
 argument-hint: [area filter]
 allowed-tools:
@@ -21,7 +21,7 @@ Routes to the check-todos workflow which handles:
 </objective>
 
 <execution_context>
-@~/.claude/qgsd/workflows/check-todos.md
+@~/.claude/nf/workflows/check-todos.md
 </execution_context>
 
 <context>
@@ -31,7 +31,7 @@ Todo state and roadmap correlation are loaded in-workflow using `init todos` and
 </context>
 
 <process>
-**Follow the check-todos workflow** from `@~/.claude/qgsd/workflows/check-todos.md`.
+**Follow the check-todos workflow** from `@~/.claude/nf/workflows/check-todos.md`.
 
 The workflow handles all logic including:
 1. Todo existence checking

package/commands/{qgsd → nf}/cleanup.md

@@ -1,5 +1,5 @@
 ---
-name: qgsd:cleanup
+name: nf:cleanup
 description: Archive accumulated phase directories from completed milestones
 ---
 <objective>
@@ -9,10 +9,10 @@ Use when `.planning/phases/` has accumulated directories from past milestones.
 </objective>
 
 <execution_context>
-@~/.claude/qgsd/workflows/cleanup.md
+@~/.claude/nf/workflows/cleanup.md
 </execution_context>
 
 <process>
-Follow the cleanup workflow at @~/.claude/qgsd/workflows/cleanup.md.
+Follow the cleanup workflow at @~/.claude/nf/workflows/cleanup.md.
 Identify completed milestones, show a dry-run summary, and archive on confirmation.
 </process>

package/commands/{qgsd → nf}/close-formal-gaps.md

@@ -18,11 +18,11 @@ Close formal model coverage gaps by generating new formal specifications for unc
 </objective>
 
 <execution_context>
-@/Users/jonathanborduas/.claude/qgsd/workflows/close-formal-gaps.md
+@/Users/jonathanborduas/.claude/nf/workflows/close-formal-gaps.md
 </execution_context>
 
 <process>
-Execute the close-formal-gaps workflow from @/Users/jonathanborduas/.claude/qgsd/workflows/close-formal-gaps.md end-to-end.
+Execute the close-formal-gaps workflow from @/Users/jonathanborduas/.claude/nf/workflows/close-formal-gaps.md end-to-end.
 Pass through all --flags from arguments:
   --batch                     Fully autonomous mode — skip all user prompts, auto-approve clusters
   --category="Category Name"  Focus on a specific category

package/commands/{qgsd → nf}/complete-milestone.md

@@ -1,6 +1,6 @@
 ---
 type: prompt
-name: qgsd:complete-milestone
+name: nf:complete-milestone
 description: Archive completed milestone and prepare for next version
 argument-hint: <version>
 allowed-tools:
@@ -19,8 +19,8 @@ Output: Milestone archived (roadmap + requirements), PROJECT.md evolved, git tag
 <execution_context>
 **Load these files NOW (before proceeding):**
 
-- @~/.claude/qgsd/workflows/complete-milestone.md (main workflow)
-- @~/.claude/qgsd/templates/milestone-archive.md (archive template)
+- @~/.claude/nf/workflows/complete-milestone.md (main workflow)
+- @~/.claude/nf/templates/milestone-archive.md (archive template)
   </execution_context>
 
 <context>
@@ -42,19 +42,19 @@ Output: Milestone archived (roadmap + requirements), PROJECT.md evolved, git tag
 0. **Check for audit:**
 
    - Look for `.planning/milestones/v{{version}}-MILESTONE-AUDIT.md` (or legacy `.planning/v{{version}}-MILESTONE-AUDIT.md`)
-   - If missing or stale: recommend `/qgsd:audit-milestone` first
-   - If audit status is `gaps_found`: recommend `/qgsd:plan-milestone-gaps` first
+   - If missing or stale: recommend `/nf:audit-milestone` first
+   - If audit status is `gaps_found`: recommend `/nf:plan-milestone-gaps` first
    - If audit status is `passed`: proceed to step 1
 
    ```markdown
    ## Pre-flight Check
 
    {If no v{{version}}-MILESTONE-AUDIT.md in milestones/ or root:}
-   ⚠ No milestone audit found. Run `/qgsd:audit-milestone` first to verify
+   ⚠ No milestone audit found. Run `/nf:audit-milestone` first to verify
    requirements coverage, cross-phase integration, and E2E flows.
 
    {If audit has gaps:}
-   ⚠ Milestone audit found gaps. Run `/qgsd:plan-milestone-gaps` to create
+   ⚠ Milestone audit found gaps. Run `/nf:plan-milestone-gaps` to create
    phases that close the gaps, or proceed anyway to accept as tech debt.
 
    {If audit passed:}
@@ -108,7 +108,7 @@ Output: Milestone archived (roadmap + requirements), PROJECT.md evolved, git tag
    - Ask about pushing tag
 
 8. **Offer next steps:**
-   - `/qgsd:new-milestone` — start next milestone (questioning → research → requirements → roadmap)
+   - `/nf:new-milestone` — start next milestone (questioning → research → requirements → roadmap)
 
 </process>
 
@@ -132,5 +132,5 @@ Output: Milestone archived (roadmap + requirements), PROJECT.md evolved, git tag
 - **Archive before deleting:** Always create archive files before updating/deleting originals
 - **One-line summary:** Collapsed milestone in ROADMAP.md should be single line with link
 - **Context efficiency:** Archive keeps ROADMAP.md and REQUIREMENTS.md constant size per milestone
-- **Fresh requirements:** Next milestone starts with `/qgsd:new-milestone` which includes requirements definition
+- **Fresh requirements:** Next milestone starts with `/nf:new-milestone` which includes requirements definition
   </critical_rules>

package/commands/{qgsd → nf}/debug.md

@@ -1,6 +1,6 @@
 ---
-name: qgsd:debug
-description: Debug loop with quorum consensus on next step. Feed failure context to 4 quorum workers — each identifies the single most likely root cause and next debugging step. Renders a NEXT STEP table. Call repeatedly: run test → fail → /qgsd:debug → apply step → run test again.
+name: nf:debug
+description: Debug loop with quorum consensus on next step. Feed failure context to 4 quorum workers — each identifies the single most likely root cause and next debugging step. Renders a NEXT STEP table. Call repeatedly: run test → fail → /nf:debug → apply step → run test again.
 argument-hint: "[failure context: test output, error trace, or symptom description]"
 allowed-tools:
   - Task
@@ -16,7 +16,7 @@ Dispatch the full quorum debug process to a subagent. The main command stays cle
 
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- QGSD ► QUORUM-DEBUG: Dispatching debug subagent...
+ nForma ► QUORUM-DEBUG: Dispatching debug subagent...
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ```
 
@@ -29,7 +29,7 @@ Task(
   subagent_type="general-purpose",
   description="Quorum debug orchestration",
   prompt="""
-You are the QGSD quorum debug orchestrator. Run the full process below for this failure.
+You are the nForma quorum debug orchestrator. Run the full process below for this failure.
 
 ARGUMENTS: $ARGUMENTS
 
@@ -50,7 +50,7 @@ If test files exist, run them:
 Store as $TEST_OUTPUT and $EXIT_CODE. If exit code is 0 and ARGUMENTS is empty, stop and return:
 
   QUORUM-DEBUG: No failure detected — tests pass (exit 0).
-  If you have a symptom not captured by tests, run: /qgsd:debug [describe the symptom]
+  If you have a symptom not captured by tests, run: /nf:debug [describe the symptom]
 
 ### Step B: Assemble bundle
 
@@ -64,7 +64,7 @@ Compose $BUNDLE:
 
 Worker prompt template (inline $BUNDLE verbatim in each):
 
-  You are a debugging advisor for the QGSD project.
+  You are a debugging advisor for the nForma project.
 
   <bundle>
   $BUNDLE
@@ -102,7 +102,7 @@ Consensus rules:
 Return this output:
 
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- QGSD ► QUORUM-DEBUG RESULTS
+ nForma ► QUORUM-DEBUG RESULTS
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 ┌──────────────┬──────────────┬─────────────────────────────────────────────┐
@@ -146,14 +146,14 @@ IF consensus was reached:
   Report what was done.
   Then return:
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-    Consensus step executed. Run /qgsd:debug again to continue.
+    Consensus step executed. Run /nf:debug again to continue.
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 IF no consensus:
   Return:
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
     No consensus — review recommendations above and apply the most relevant step.
-    Then run /qgsd:debug again with updated output.
+    Then run /nf:debug again with updated output.
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 """
 )

package/commands/{qgsd → nf}/discuss-phase.md

@@ -1,5 +1,5 @@
 ---
-name: qgsd:discuss-phase
+name: nf:discuss-phase
 description: Gather phase context through adaptive questioning before planning
 argument-hint: "<phase> [--auto]"
 allowed-tools:
@@ -25,8 +25,8 @@ Extract implementation decisions that downstream agents need — researcher and
 </objective>
 
 <execution_context>
-@~/.claude/qgsd/workflows/discuss-phase.md
-@~/.claude/qgsd/templates/context.md
+@~/.claude/nf/workflows/discuss-phase.md
+@~/.claude/nf/templates/context.md
 </execution_context>
 
 <context>

package/commands/{qgsd → nf}/execute-phase.md

@@ -1,5 +1,5 @@
 ---
-name: qgsd:execute-phase
+name: nf:execute-phase
 description: Execute all plans in a phase with wave parallelization and automated checkpoint:verify gates via quorum-test.
 argument-hint: "<phase-number>"
 allowed-tools:
@@ -15,11 +15,11 @@ allowed-tools:
 ---
 
 <objective>
-Execute all plans in a phase. Delegates to the gsd:execute-phase workflow for wave-based plan execution. Extends the workflow with automated verification gates: when a plan step has type checkpoint:verify, the executor runs /qgsd:quorum-test instead of waiting for human input. Escalates to checkpoint:human-verify only on failure.
+Execute all plans in a phase. Delegates to the gsd:execute-phase workflow for wave-based plan execution. Extends the workflow with automated verification gates: when a plan step has type checkpoint:verify, the executor runs /nf:quorum-test instead of waiting for human input. Escalates to checkpoint:human-verify only on failure.
 </objective>
 
 <execution_context>
-@~/.claude/qgsd/workflows/execute-phase.md
+@~/.claude/nf/workflows/execute-phase.md
 </execution_context>
 
 <context>
@@ -31,16 +31,16 @@ Phase: $ARGUMENTS
 
 <process>
 
-Execute the execute-phase workflow from @~/.claude/qgsd/workflows/execute-phase.md end-to-end, applying the checkpoint type handling rules below at every plan step.
+Execute the execute-phase workflow from @~/.claude/nf/workflows/execute-phase.md end-to-end, applying the checkpoint type handling rules below at every plan step.
 
-## Agent Substitution (QGSD override)
+## Agent Substitution (nForma override)
 
 The GSD workflow uses GSD-specific agent types. When following that workflow, substitute:
 
-| GSD agent type (in workflow) | Use instead (QGSD) |
+| GSD agent type (in workflow) | Use instead (nForma) |
 |------------------------------|---------------------|
-| `gsd-executor` | `qgsd-executor` |
-| `gsd-verifier` | `qgsd-verifier` |
+| `gsd-executor` | `nf-executor` |
+| `gsd-verifier` | `nf-verifier` |
 
 This applies everywhere the workflow calls `Task(subagent_type="gsd-executor", ...)` or `Task(subagent_type="gsd-verifier", ...)`. All other agent types pass through unchanged.
 
@@ -56,7 +56,7 @@ When the executor reads a plan step whose type is `checkpoint:verify`, it MUST:
 
 a. NOT pause for human input.
 b. Identify the test scope from the step's verify section (test file paths or test command).
-c. Call `/qgsd:quorum-test` with that scope.
+c. Call `/nf:quorum-test` with that scope.
 d. Evaluate the consensus verdict:
    - **PASS:** log `checkpoint:verify PASSED — quorum consensus` and continue execution.
    - **BLOCK or REVIEW-NEEDED:** enter the debug loop (see Rule 3).
@@ -72,13 +72,13 @@ When the executor reads a plan step whose type is `checkpoint:human-verify`, it
 
 ### Rule 3 — Debug loop (3 rounds max)
 
-Triggered when `/qgsd:quorum-test` returns BLOCK or REVIEW-NEEDED on a `checkpoint:verify` step.
+Triggered when `/nf:quorum-test` returns BLOCK or REVIEW-NEEDED on a `checkpoint:verify` step.
 
 Round N (N = 1, 2, 3):
 
-1. Call `/qgsd:debug` with the quorum-test failure context as `$ARGUMENTS`.
-2. Apply the consensus next step from `/qgsd:debug` (code fix, test correction, or config update as directed by the consensus).
-3. Re-run `/qgsd:quorum-test` with the same scope.
+1. Call `/nf:debug` with the quorum-test failure context as `$ARGUMENTS`.
+2. Apply the consensus next step from `/nf:debug` (code fix, test correction, or config update as directed by the consensus).
+3. Re-run `/nf:quorum-test` with the same scope.
 4. If result is PASS: log `checkpoint:verify PASSED after N debug round(s)` and continue.
 5. If result is still BLOCK/REVIEW-NEEDED and N < 3: increment round, repeat.
 
@@ -90,7 +90,7 @@ After 3 rounds with no PASS: escalate to `checkpoint:human-verify` (Rule 4).
 
 Display a failure summary:
 - The `checkpoint:verify` step that failed
-- Number of `/qgsd:debug` rounds attempted
+- Number of `/nf:debug` rounds attempted
 - Final quorum-test verdict and concerns from each model
 
 Then pause: request human review and corrective action before resuming.
@@ -111,7 +111,7 @@ Then pause: request human review and corrective action before resuming.
 After all plans in the phase complete, display:
 
 ```
-All plans complete. Run /qgsd:verify-work to confirm goal achievement.
+All plans complete. Run /nf:verify-work to confirm goal achievement.
 ```
 
 </process>

package/commands/{qgsd → nf}/fix-tests.md

@@ -1,5 +1,5 @@
 ---
-name: qgsd:fix-tests
+name: nf:fix-tests
 description: Autonomously discover, batch, run, categorize, and fix test failures across large suites
 allowed-tools:
   - Read
@@ -19,9 +19,9 @@ This command is execution-only — it does NOT invoke quorum workers (R2.1 / INT
 </objective>
 
 <execution_context>
-@~/.claude/qgsd/workflows/fix-tests.md
+@~/.claude/nf/workflows/fix-tests.md
 </execution_context>
 
 <process>
-Follow the fix-tests workflow from @~/.claude/qgsd/workflows/fix-tests.md end-to-end.
+Follow the fix-tests workflow from @~/.claude/nf/workflows/fix-tests.md end-to-end.
 </process>

package/commands/{qgsd → nf}/formal-test-sync.md

@@ -1,5 +1,5 @@
 ---
-name: qgsd:formal-test-sync
+name: nf:formal-test-sync
 description: Cross-reference formal model invariants with unit test coverage, validate constants, and generate test stubs
 argument-hint: [--report-only] [--dry-run] [--json] [--stubs-dir=<path>]
 allowed-tools:

package/commands/{qgsd → nf}/health.md

@@ -1,5 +1,5 @@
 ---
-name: qgsd:health
+name: nf:health
 description: Diagnose planning directory health and optionally repair issues
 argument-hint: [--repair] [--force]
 allowed-tools:
@@ -13,10 +13,10 @@ Validate `.planning/` directory integrity and report actionable issues. Checks f
 </objective>
 
 <execution_context>
-@~/.claude/qgsd/workflows/health.md
+@~/.claude/nf/workflows/health.md
 </execution_context>
 
 <process>
-Execute the health workflow from @~/.claude/qgsd/workflows/health.md end-to-end.
+Execute the health workflow from @~/.claude/nf/workflows/health.md end-to-end.
 Parse --repair flag from arguments and pass to workflow.
 </process>

package/commands/{qgsd → nf}/help.md

@@ -1,5 +1,5 @@
 ---
-name: qgsd:help
+name: nf:help
 description: Show available GSD commands and usage guide
 ---
 <objective>
@@ -13,10 +13,10 @@ Output ONLY the reference content below. Do NOT add:
 </objective>
 
 <execution_context>
-@~/.claude/qgsd/workflows/help.md
+@~/.claude/nf/workflows/help.md
 </execution_context>
 
 <process>
-Output the complete GSD command reference from @~/.claude/qgsd/workflows/help.md.
+Output the complete GSD command reference from @~/.claude/nf/workflows/help.md.
 Display the reference content directly — no additions or modifications.
 </process>

package/commands/{qgsd → nf}/insert-phase.md

@@ -1,5 +1,5 @@
 ---
-name: qgsd:insert-phase
+name: nf:insert-phase
 description: Insert urgent work as decimal phase (e.g., 72.1) between existing phases
 argument-hint: <after> <description>
 allowed-tools:
@@ -17,7 +17,7 @@ Purpose: Handle urgent work discovered during execution without renumbering enti
 </objective>
 
 <execution_context>
-@~/.claude/qgsd/workflows/insert-phase.md
+@~/.claude/nf/workflows/insert-phase.md
 </execution_context>
 
 <context>
@@ -27,6 +27,6 @@ Roadmap and state are resolved in-workflow via `init phase-op` and targeted tool
 </context>
 
 <process>
-Execute the insert-phase workflow from @~/.claude/qgsd/workflows/insert-phase.md end-to-end.
+Execute the insert-phase workflow from @~/.claude/nf/workflows/insert-phase.md end-to-end.
 Preserve all validation gates (argument parsing, phase verification, decimal calculation, roadmap updates).
 </process>