@nforma.ai/nforma 0.2.1 → 0.28.0

package/commands/{qgsd → nf}/mcp-setup.md

@@ -1,5 +1,5 @@
 ---
-name: qgsd:mcp-setup
+name: nf:mcp-setup
 description: Configure quorum agents — first-run linear onboarding for new installs, live-status agent menu for re-runs
 allowed-tools:
   - Bash
@@ -7,7 +7,7 @@ allowed-tools:
 ---
 
 <objective>
-Configure QGSD quorum agents in `~/.claude.json`. Detects whether any MCP servers are configured and routes to the appropriate flow:
+Configure nForma quorum agents in `~/.claude.json`. Detects whether any MCP servers are configured and routes to the appropriate flow:
 - **First-run** (zero configured entries): linear onboarding — select agent templates, collect API keys via keytar, write batch changes with backup, restart agents
 - **Re-run** (existing entries): live-status agent roster menu — view model/provider/key status, select agent, choose action (set key / swap provider / remove)
 </objective>
@@ -53,7 +53,7 @@ Display the welcome banner:
 
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- QGSD ► MCP SETUP — FIRST RUN
+ nForma ► MCP SETUP — FIRST RUN
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 No quorum agents configured. Let's set up your first agent.
@@ -83,12 +83,12 @@ Use AskUserQuestion:
   - "3 — claude-3 (Together.xyz, Qwen3-Coder-480B)"
   - "4 — claude-5 (Together.xyz, Llama-4-M)"
   - "5 — claude-4 (Fireworks, kimi)"
-  - "Skip — configure later via /qgsd:mcp-setup"
+  - "Skip — configure later via /nf:mcp-setup"
 
 If "Skip" is chosen, display:
 
 ```
-⚠ No agents configured. Run /qgsd:mcp-setup when ready.
+⚠ No agents configured. Run /nf:mcp-setup when ready.
 ```
 
 Stop.
@@ -116,7 +116,7 @@ Store the key using this Bash command (substitute AGENT_KEY and API_KEY):
 
 ```bash
 KEY_RESULT=$(node -e "
-const { set, SERVICE } = require('~/.claude/qgsd-bin/secrets.cjs');
+const { set, SERVICE } = require('~/.claude/nf-bin/secrets.cjs');
 const agentKey = process.env.AGENT_KEY;
 const apiKey   = process.env.API_KEY;
 (async () => {
@@ -153,7 +153,7 @@ mkdir -p ~/.claude/debug
 node -e "
 const fs = require('fs');
 const ts = new Date().toISOString();
-const msg = ts + ' QGSD mcp-setup: keytar unavailable for ' + process.env.AGENT_KEY + ' — API key stored unencrypted in env block\n';
+const msg = ts + ' nForma mcp-setup: keytar unavailable for ' + process.env.AGENT_KEY + ' — API key stored unencrypted in env block\n';
 fs.appendFileSync(require('os').homedir() + '/.claude/debug/mcp-setup-audit.log', msg);
 " AGENT_KEY="{agent-name}"
 ```
@@ -177,7 +177,7 @@ If "Finish setup": continue to Step 3.
 If pending batch is empty (all skipped):
 
 ```
-⚠ No agents configured. Run /qgsd:mcp-setup when ready.
+⚠ No agents configured. Run /nf:mcp-setup when ready.
 ```
 
 Stop.
@@ -186,7 +186,7 @@ Display pending summary:
 
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- QGSD ► REVIEW PENDING CHANGES
+ nForma ► REVIEW PENDING CHANGES
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 Agents to add to ~/.claude.json:
@@ -196,7 +196,7 @@ Agents to add to ~/.claude.json:
   [repeat for each pending agent]
 
 Skipped:
-  ○ {agent-name} — run /qgsd:mcp-setup to configure later
+  ○ {agent-name} — run /nf:mcp-setup to configure later
 ```
 
 Use AskUserQuestion:
@@ -298,7 +298,7 @@ process.stdout.write(JSON.stringify({ written: true, count: pendingAgents.length
 
 ```bash
 node -e "
-const { syncToClaudeJson, SERVICE } = require('~/.claude/qgsd-bin/secrets.cjs');
+const { syncToClaudeJson, SERVICE } = require('~/.claude/nf-bin/secrets.cjs');
 syncToClaudeJson(SERVICE)
   .then(() => process.stdout.write('synced\n'))
   .catch(e => process.stderr.write('sync warning: ' + e.message + '\n'));
@@ -309,20 +309,20 @@ syncToClaudeJson(SERVICE)
 
 For each agent in the pending batch:
 
-Invoke `/qgsd:mcp-restart {agent-name}`.
+Invoke `/nf:mcp-restart {agent-name}`.
 
 If restart fails or times out, leave config in written state and display:
 
 ```
 ⚠ {agent-name}: restart failed. Config was written — agent will reload on next Claude Code restart.
-  Manual retry: /qgsd:mcp-restart {agent-name}
+  Manual retry: /nf:mcp-restart {agent-name}
 ```
 
 ### Step 3f: Closing summary
 
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- QGSD ► SETUP COMPLETE ✓
+ nForma ► SETUP COMPLETE ✓
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 Changes applied and agents restarted.
@@ -330,10 +330,10 @@ Changes applied and agents restarted.
   ✓ {agent-name} — restarted
   [repeat for each successfully restarted agent]
 
-  ○ {agent-name} — skipped (run /qgsd:mcp-setup to configure later)
+  ○ {agent-name} — skipped (run /nf:mcp-setup to configure later)
   [repeat for each skipped agent]
 
-Run /qgsd:mcp-status to verify agent health.
+Run /nf:mcp-status to verify agent health.
 ```
 
 ---
@@ -364,7 +364,7 @@ const os   = require('os');
 
     let keyStatus = 'no key';
     try {
-      const { get, SERVICE } = require('~/.claude/qgsd-bin/secrets.cjs');
+      const { get, SERVICE } = require('~/.claude/nf-bin/secrets.cjs');
       const keyName = 'ANTHROPIC_API_KEY_' + name.toUpperCase().replace(/-/g,'_');
       const stored  = await get(SERVICE, keyName);
       keyStatus = stored ? 'key stored' : (env.ANTHROPIC_API_KEY ? 'key in env' : 'no key');
@@ -386,7 +386,7 @@ Display re-run banner:
 
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- QGSD ► MCP SETUP — AGENT ROSTER
+ nForma ► MCP SETUP — AGENT ROSTER
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ```
 
@@ -493,7 +493,7 @@ Store the key using bin/secrets.cjs (agent name and key passed via env vars —
 
 ```bash
 KEY_RESULT=$(node -e "
-const { set, SERVICE } = require('~/.claude/qgsd-bin/secrets.cjs');
+const { set, SERVICE } = require('~/.claude/nf-bin/secrets.cjs');
 const agentKey = process.env.AGENT_KEY;
 const apiKey   = process.env.API_KEY;
 (async () => {
@@ -527,7 +527,7 @@ Parse KEY_RESULT:
   node -e "
   const fs = require('fs');
   const ts = new Date().toISOString();
-  const msg = ts + ' QGSD mcp-setup: keytar unavailable for ' + process.env.AGENT_KEY + ' — API key stored unencrypted in env block\n';
+  const msg = ts + ' nForma mcp-setup: keytar unavailable for ' + process.env.AGENT_KEY + ' — API key stored unencrypted in env block\n';
   fs.appendFileSync(require('os').homedir() + '/.claude/debug/mcp-setup-audit.log', msg);
   " AGENT_KEY="{agent-name}"
   ```
@@ -538,7 +538,7 @@ Show pending summary:
 
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- QGSD ► REVIEW PENDING CHANGES
+ nForma ► REVIEW PENDING CHANGES
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
   ◆ {agent-name}  →  {provider-name}  ({base-url})
@@ -626,12 +626,12 @@ process.stdout.write(JSON.stringify({ written: true }) + '\n');
 4. Sync keytar secrets to ~/.claude.json:
 ```bash
 node -e "
-const { syncToClaudeJson, SERVICE } = require('~/.claude/qgsd-bin/secrets.cjs');
+const { syncToClaudeJson, SERVICE } = require('~/.claude/nf-bin/secrets.cjs');
 syncToClaudeJson(SERVICE).then(() => process.stdout.write('synced\n')).catch(e => process.stderr.write(e.message + '\n'));
 "
 ```
 
-5. Invoke `/qgsd:mcp-restart {agent-name}` to start the new agent process.
+5. Invoke `/nf:mcp-restart {agent-name}` to start the new agent process.
 
 **Step D — Identity ping (AGENT-03)**
 
@@ -648,7 +648,7 @@ If identity responds:
     Version: {identity.version}
     Model:   {identity.model}
 
-Run /qgsd:mcp-status to see full agent roster.
+Run /nf:mcp-status to see full agent roster.
 ```
 
 If identity times out or errors:
@@ -657,7 +657,7 @@ If identity times out or errors:
 
   ◆ {agent-name} — added, restarted (identity ping timed out — agent may need a moment to start)
 
-Run /qgsd:mcp-status to verify agent health.
+Run /nf:mcp-status to verify agent health.
 ```
 
 **Return path:** If this add-slot flow was entered from the Composition Screen (via "Add new slot"), return to Composition Screen after identity ping. Otherwise, return to roster display (re-read roster to show new agent).
@@ -672,7 +672,7 @@ Show a confirmation screen:
 
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- QGSD ► REVIEW PENDING CHANGES
+ nForma ► REVIEW PENDING CHANGES
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
   ◆ {new-slot-name}  →  copied from {source-slot-name}
@@ -718,18 +718,18 @@ process.stdout.write(JSON.stringify({ written: true, newSlot, sourceSlot: srcSlo
 
 If `written: false`: display error and return to roster.
 
-3. Append new slot to `quorum_active` in `~/.claude/qgsd.json`:
+3. Append new slot to `quorum_active` in `~/.claude/nf.json`:
 ```bash
 node -e "
 const fs = require('fs'), os = require('os');
-const qgsdPath = os.homedir() + '/.claude/qgsd.json';
+const nfPath = os.homedir() + '/.claude/nf.json';
 let cfg = {};
-try { cfg = JSON.parse(fs.readFileSync(qgsdPath, 'utf8')); } catch(e) {}
+try { cfg = JSON.parse(fs.readFileSync(nfPath, 'utf8')); } catch(e) {}
 const active = Array.isArray(cfg.quorum_active) ? cfg.quorum_active : [];
 const newSlot = process.env.NEW_SLOT;
 if (!active.includes(newSlot)) {
   cfg.quorum_active = [...active, newSlot];
-  fs.writeFileSync(qgsdPath, JSON.stringify(cfg, null, 2) + '\n');
+  fs.writeFileSync(nfPath, JSON.stringify(cfg, null, 2) + '\n');
   process.stdout.write(JSON.stringify({ added: true, slot: newSlot }) + '\n');
 } else {
   process.stdout.write(JSON.stringify({ added: false, slot: newSlot, reason: 'already present' }) + '\n');
@@ -737,7 +737,7 @@ if (!active.includes(newSlot)) {
 " NEW_SLOT="{new-slot-name}"
 ```
 
-4. Invoke `/qgsd:mcp-restart {new-slot-name}` to start the new agent process.
+4. Invoke `/nf:mcp-restart {new-slot-name}` to start the new agent process.
 
 **Step D — Identity ping** (same as claude-mcp-server path):
 
@@ -754,7 +754,7 @@ If identity responds:
     Version: {identity.version}
     Model:   {identity.model}
 
-Run /qgsd:mcp-status to see full agent roster.
+Run /nf:mcp-status to see full agent roster.
 ```
 
 If identity times out or errors:
@@ -763,7 +763,7 @@ If identity times out or errors:
 
   ◆ {new-slot-name} — added, restarted (identity ping timed out — agent may need a moment to start)
 
-Run /qgsd:mcp-status to verify agent health.
+Run /nf:mcp-status to verify agent health.
 ```
 
 **Return path:** If this add-slot flow was entered from the Composition Screen (via "Add new slot"), return to Composition Screen after identity ping. Otherwise, return to roster display (re-read roster to show new agent).
@@ -790,14 +790,14 @@ try {
   slots = Object.keys(cj.mcpServers || {});
 } catch(e) {}
 try {
-  const qgsd = JSON.parse(fs.readFileSync(os.homedir() + '/.claude/qgsd.json', 'utf8'));
-  active = Array.isArray(qgsd.quorum_active) ? qgsd.quorum_active : [];
+  const nfCfg = JSON.parse(fs.readFileSync(os.homedir() + '/.claude/nf.json', 'utf8'));
+  active = Array.isArray(nf.quorum_active) ? nf.quorum_active : [];
 } catch(e) {}
 process.stdout.write(JSON.stringify({ slots, active }) + '\n');
 ")
 ```
 
-Parse `COMPOSITION_DATA` for `slots` (array of all slot names from `~/.claude.json`) and `active` (current `quorum_active` array from `~/.claude/qgsd.json`).
+Parse `COMPOSITION_DATA` for `slots` (array of all slot names from `~/.claude.json`) and `active` (current `quorum_active` array from `~/.claude/nf.json`).
 
 **Step CS-2: Display composition table**
 
@@ -805,7 +805,7 @@ Display banner:
 
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- QGSD ► QUORUM COMPOSITION
+ nForma ► QUORUM COMPOSITION
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ```
 
@@ -838,7 +838,7 @@ Use AskUserQuestion:
 - question: "Enter slot number to toggle ON/OFF, or choose an option:"
 - options:
   - "1 — {slot-name} [{current PENDING_ACTIVE status}]" (one per slot — show ● ON or ○ OFF based on current PENDING_ACTIVE state)
-  - "Apply — save changes to qgsd.json"
+  - "Apply — save changes to nf.json"
   - "Add new slot — add a slot to ~/.claude.json and quorum_active"
   - "Cancel — discard changes"
 
@@ -857,11 +857,11 @@ Re-display the AskUserQuestion with updated statuses after each toggle.
 ```bash
 node -e "
 const fs = require('fs'), os = require('os');
-const qgsdPath = os.homedir() + '/.claude/qgsd.json';
+const nfPath = os.homedir() + '/.claude/nf.json';
 let cfg = {};
-try { cfg = JSON.parse(fs.readFileSync(qgsdPath, 'utf8')); } catch(e) {}
+try { cfg = JSON.parse(fs.readFileSync(nfPath, 'utf8')); } catch(e) {}
 cfg.quorum_active = JSON.parse(process.env.PENDING_ACTIVE);
-fs.writeFileSync(qgsdPath, JSON.stringify(cfg, null, 2) + '\n');
+fs.writeFileSync(nfPath, JSON.stringify(cfg, null, 2) + '\n');
 process.stdout.write(JSON.stringify({ written: true, count: cfg.quorum_active.length }) + '\n');
 " PENDING_ACTIVE="{JSON.stringify(PENDING_ACTIVE)}"
 ```
@@ -898,7 +898,7 @@ Display agent detail banner:
 
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- QGSD ► {agent-name}
+ nForma ► {agent-name}
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
   Model:    {model}
@@ -923,7 +923,7 @@ Run an inline node script to check whether a key is already stored in keytar for
 
 ```bash
 KEY_CHECK_RESULT=$(node -e "
-const { get, SERVICE } = require('~/.claude/qgsd-bin/secrets.cjs');
+const { get, SERVICE } = require('~/.claude/nf-bin/secrets.cjs');
 (async () => {
   try {
     const agentName = process.env.AGENT_NAME;
@@ -985,7 +985,7 @@ Run inline node script using `set()` from `bin/secrets.cjs`. Pass key via enviro
 
 ```bash
 KEY_STORE_RESULT=$(node -e "
-const { set, SERVICE } = require('~/.claude/qgsd-bin/secrets.cjs');
+const { set, SERVICE } = require('~/.claude/nf-bin/secrets.cjs');
 (async () => {
   try {
     const agentName = process.env.AGENT_NAME;
@@ -1019,7 +1019,7 @@ Parse KEY_STORE_RESULT:
   node -e "
   const fs = require('fs');
   const ts = new Date().toISOString();
-  const msg = ts + ' QGSD mcp-setup: keytar unavailable for ' + process.env.AGENT_KEY + ' — API key stored unencrypted in env block\n';
+  const msg = ts + ' nForma mcp-setup: keytar unavailable for ' + process.env.AGENT_KEY + ' — API key stored unencrypted in env block\n';
   fs.appendFileSync(require('os').homedir() + '/.claude/debug/mcp-setup-audit.log', msg);
   " AGENT_KEY="{agent-name}"
   ```
@@ -1030,7 +1030,7 @@ Show pending summary using the existing "Confirm + Apply + Restart Flow" pattern
 
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- QGSD ► REVIEW PENDING CHANGES
+ nForma ► REVIEW PENDING CHANGES
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
   ◆ {agent-name} — API key updated (stored in system keychain)
@@ -1075,15 +1075,15 @@ process.stdout.write(JSON.stringify({ written: true }) + '\n');
 3. Sync all keytar secrets back to ~/.claude.json:
 ```bash
 node -e "
-const { syncToClaudeJson, SERVICE } = require('~/.claude/qgsd-bin/secrets.cjs');
+const { syncToClaudeJson, SERVICE } = require('~/.claude/nf-bin/secrets.cjs');
 syncToClaudeJson(SERVICE).then(() => process.stdout.write('synced\n')).catch(e => process.stderr.write(e.message + '\n'));
 "
 ```
 
-4. Invoke `/qgsd:mcp-restart {agent-name}` (sequential). If restart fails, leave config written and display:
+4. Invoke `/nf:mcp-restart {agent-name}` (sequential). If restart fails, leave config written and display:
 ```
 ⚠ {agent-name}: restart failed. Config applied — reload on next Claude Code restart.
-  Manual retry: /qgsd:mcp-restart {agent-name}
+  Manual retry: /nf:mcp-restart {agent-name}
 ```
 
 5. Display:
@@ -1092,7 +1092,7 @@ syncToClaudeJson(SERVICE).then(() => process.stdout.write('synced\n')).catch(e =
 
   ✓ {agent-name} — key updated, restarted
 
-Run /qgsd:mcp-status to verify agent health.
+Run /nf:mcp-status to verify agent health.
 ```
 
 Return to Agent Sub-Menu (user can make further changes or go Back).
@@ -1159,7 +1159,7 @@ Show pending summary:
 
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- QGSD ► REVIEW PENDING CHANGES
+ nForma ► REVIEW PENDING CHANGES
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
   ◆ {agent-name} — provider changed to {NEW_PROVIDER_NAME} ({NEW_URL})
@@ -1204,15 +1204,15 @@ process.stdout.write(JSON.stringify({ written: true }) + '\n');
 3. Sync keytar secrets to ~/.claude.json:
 ```bash
 node -e "
-const { syncToClaudeJson, SERVICE } = require('~/.claude/qgsd-bin/secrets.cjs');
+const { syncToClaudeJson, SERVICE } = require('~/.claude/nf-bin/secrets.cjs');
 syncToClaudeJson(SERVICE).then(() => process.stdout.write('synced\n')).catch(e => process.stderr.write(e.message + '\n'));
 "
 ```
 
-4. Invoke `/qgsd:mcp-restart {agent-name}` (sequential). If restart fails, leave config written and display:
+4. Invoke `/nf:mcp-restart {agent-name}` (sequential). If restart fails, leave config written and display:
 ```
 ⚠ {agent-name}: restart failed. Config applied — reload on next Claude Code restart.
-  Manual retry: /qgsd:mcp-restart {agent-name}
+  Manual retry: /nf:mcp-restart {agent-name}
 ```
 
 5. Display:
@@ -1221,7 +1221,7 @@ syncToClaudeJson(SERVICE).then(() => process.stdout.write('synced\n')).catch(e =
 
   ✓ {agent-name} — provider changed to {NEW_PROVIDER_NAME}, restarted
 
-Run /qgsd:mcp-status to verify agent health.
+Run /nf:mcp-status to verify agent health.
 ```
 
 Return to Agent Sub-Menu (user can make further changes or go Back).
@@ -1234,7 +1234,7 @@ Display removal warning:
 
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- QGSD ► REMOVE AGENT
+ nForma ► REMOVE AGENT
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
   ⚠ This will permanently remove {agent-name} from
@@ -1285,7 +1285,7 @@ process.stdout.write(JSON.stringify({ removed: true, agent: agentName }) + '\n')
   ✓ {agent-name} — removed from ~/.claude.json
     The agent will be deregistered on next Claude Code restart.
 
-Run /qgsd:mcp-status to verify the updated agent roster.
+Run /nf:mcp-status to verify the updated agent roster.
 ```
 
 Return to roster display (re-read roster — removed agent no longer appears).
@@ -1302,7 +1302,7 @@ Display pending summary:
 
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- QGSD ► REVIEW PENDING CHANGES
+ nForma ► REVIEW PENDING CHANGES
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
   ◆ {agent-name} — {description of change}
@@ -1329,12 +1329,12 @@ cp ~/.claude.json ~/.claude.json.backup-$(date +%Y-%m-%d-%H%M%S) 2>/dev/null ||
 3. Sync keytar secrets:
 ```bash
 node -e "
-const { syncToClaudeJson, SERVICE } = require('~/.claude/qgsd-bin/secrets.cjs');
+const { syncToClaudeJson, SERVICE } = require('~/.claude/nf-bin/secrets.cjs');
 syncToClaudeJson(SERVICE).then(() => process.stdout.write('synced\n')).catch(e => process.stderr.write(e.message + '\n'));
 "
 ```
 
-4. For each affected agent (sequential, one at a time): invoke `/qgsd:mcp-restart {agent-name}`.
+4. For each affected agent (sequential, one at a time): invoke `/nf:mcp-restart {agent-name}`.
 
 5. Display:
 ```
@@ -1342,13 +1342,13 @@ syncToClaudeJson(SERVICE).then(() => process.stdout.write('synced\n')).catch(e =
 
   ✓ {agent-name} — restarted
 
-Run /qgsd:mcp-status to verify agent health.
+Run /nf:mcp-status to verify agent health.
 ```
 
 If a restart fails, leave config written and display:
 ```
 ⚠ {agent-name}: restart failed. Config applied — reload on next Claude Code restart.
-  Manual retry: /qgsd:mcp-restart {agent-name}
+  Manual retry: /nf:mcp-restart {agent-name}
 ```
 
 </process>
@@ -1366,6 +1366,6 @@ If a restart fails, leave config written and display:
 - Keytar failure: warning + Linux hint + confirmation before env-block fallback + audit log
 - Key value never appears in displayed text, log output, or shell history (passed via env var only)
 - Edit Quorum Composition flow (WIZ-08): re-run menu option "Edit Quorum Composition" → routes to Composition Screen
-- Composition toggle flow (WIZ-09): slot list with ● ON / ○ OFF indicators → toggle updates PENDING_ACTIVE → apply writes quorum_active to ~/.claude/qgsd.json → no restart required
+- Composition toggle flow (WIZ-09): slot list with ● ON / ○ OFF indicators → toggle updates PENDING_ACTIVE → apply writes quorum_active to ~/.claude/nf.json → no restart required
 - Add slot from composition flow (WIZ-10): "Add new slot" → Step A/B/B-native → identity ping → return to Composition Screen showing new slot ● ON
 </success_criteria>

package/commands/{qgsd → nf}/mcp-status.md

@@ -1,5 +1,5 @@
 ---
-name: qgsd:mcp-status
+name: nf:mcp-status
 description: Show status of all connected quorum agents — provider, model, health, and latency
 allowed-tools:
   - Read
@@ -116,7 +116,7 @@ Display as `sub` or `api` in the Auth column.
 Print:
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- QGSD ► MCP STATUS
+ nForma ► MCP STATUS
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 Querying 4 CLI agents + 6 HTTP providers...
@@ -244,7 +244,7 @@ Scoreboard: 156 rounds recorded | Last update: 2026-02-23T14:23:52.301Z
 
 If scoreboard file was absent, show instead:
 ```
-Scoreboard: no data yet (run /qgsd:quorum first to populate)
+Scoreboard: no data yet (run /nf:quorum first to populate)
 ```
 
 Health legend:

package/commands/{qgsd → nf}/mcp-update.md

@@ -1,5 +1,5 @@
 ---
-name: qgsd:mcp-update
+name: nf:mcp-update
 description: Update a quorum agent to its latest version — detects install method from ~/.claude.json and runs the correct update command
 argument-hint: "<agent|all>"
 allowed-tools:
@@ -7,7 +7,7 @@ allowed-tools:
 ---
 
 <objective>
-Update a named quorum agent (or all agents) to their latest version. The install method is detected from `~/.claude.json` mcpServers config: `npx`-based agents update via `npm install -g <package>`; `node`-based local repo agents update via `git pull && npm run build` in their repo directory. The running process is NOT killed — run `/qgsd:mcp-restart <agent>` after updating to load the new binary.
+Update a named quorum agent (or all agents) to their latest version. The install method is detected from `~/.claude.json` mcpServers config: `npx`-based agents update via `npm install -g <package>`; `node`-based local repo agents update via `git pull && npm run build` in their repo directory. The running process is NOT killed — run `/nf:mcp-restart <agent>` after updating to load the new binary.
 </objective>
 
 <process>
@@ -18,7 +18,7 @@ Parse `$ARGUMENTS` as one token: `$TARGET`.
 
 If `$TARGET` is missing, print usage and stop:
 ```
-Usage: /qgsd:mcp-update <agent|all>
+Usage: /nf:mcp-update <agent|all>
 
 Valid agents:
   codex-cli-1, gemini-cli-1, opencode-1, copilot-1,
@@ -143,7 +143,7 @@ Updated $TARGET
   Result: <last line of npm/git output>
 
 Note: The running agent process is still using the old version.
-Run: /qgsd:mcp-restart $TARGET   to load the new binary.
+Run: /nf:mcp-restart $TARGET   to load the new binary.
 ```
 
 ## Step 6 — All-agent mode (if $TARGET = "all")
@@ -229,9 +229,9 @@ Update results:
   claude-6      (shared repo)                        ⚡ SKIPPED
 
 To load new binaries, restart updated agents:
-  /qgsd:mcp-restart codex-cli-1
-  /qgsd:mcp-restart gemini-cli-1
-  /qgsd:mcp-restart opencode-1
+  /nf:mcp-restart codex-cli-1
+  /nf:mcp-restart gemini-cli-1
+  /nf:mcp-restart opencode-1
   (etc. — list only agents that were UPDATED, not SKIPPED)
 ```
 

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

@@ -1,5 +1,5 @@
 ---
-name: qgsd:new-milestone
+name: nf:new-milestone
 description: Start a new milestone cycle — update PROJECT.md and route to requirements
 argument-hint: "[milestone name, e.g., 'v1.1 Notifications']"
 allowed-tools:
@@ -21,15 +21,15 @@ Brownfield equivalent of new-project. Project exists, PROJECT.md has history. Ga
 - `.planning/ROADMAP.md` — phase structure (continues numbering)
 - `.planning/STATE.md` — reset for new milestone
 
-**After:** `/qgsd:plan-phase [N]` to start execution.
+**After:** `/nf:plan-phase [N]` to start execution.
 </objective>
 
 <execution_context>
-@~/.claude/qgsd/workflows/new-milestone.md
-@~/.claude/qgsd/references/questioning.md
-@~/.claude/qgsd/references/ui-brand.md
-@~/.claude/qgsd/templates/project.md
-@~/.claude/qgsd/templates/requirements.md
+@~/.claude/nf/workflows/new-milestone.md
+@~/.claude/nf/references/questioning.md
+@~/.claude/nf/references/ui-brand.md
+@~/.claude/nf/templates/project.md
+@~/.claude/nf/templates/requirements.md
 </execution_context>
 
 <context>
@@ -39,6 +39,6 @@ Project and milestone context files are resolved inside the workflow (`init new-
 </context>
 
 <process>
-Execute the new-milestone workflow from @~/.claude/qgsd/workflows/new-milestone.md end-to-end.
+Execute the new-milestone workflow from @~/.claude/nf/workflows/new-milestone.md end-to-end.
 Preserve all workflow gates (validation, questioning, research, requirements, roadmap approval, commits).
 </process>

package/commands/{qgsd → nf}/new-project.md

@@ -1,5 +1,5 @@
 ---
-name: qgsd:new-project
+name: nf:new-project
 description: Initialize a new project with deep context gathering and PROJECT.md
 argument-hint: "[--auto]"
 allowed-tools:
@@ -25,18 +25,18 @@ Initialize a new project through unified flow: questioning → research (optiona
 - `.planning/ROADMAP.md` — phase structure
 - `.planning/STATE.md` — project memory
 
-**After this command:** Run `/qgsd:plan-phase 1` to start execution.
+**After this command:** Run `/nf:plan-phase 1` to start execution.
 </objective>
 
 <execution_context>
-@~/.claude/qgsd/workflows/new-project.md
-@~/.claude/qgsd/references/questioning.md
-@~/.claude/qgsd/references/ui-brand.md
-@~/.claude/qgsd/templates/project.md
-@~/.claude/qgsd/templates/requirements.md
+@~/.claude/nf/workflows/new-project.md
+@~/.claude/nf/references/questioning.md
+@~/.claude/nf/references/ui-brand.md
+@~/.claude/nf/templates/project.md
+@~/.claude/nf/templates/requirements.md
 </execution_context>
 
 <process>
-Execute the new-project workflow from @~/.claude/qgsd/workflows/new-project.md end-to-end.
+Execute the new-project workflow from @~/.claude/nf/workflows/new-project.md end-to-end.
 Preserve all workflow gates (validation, approvals, commits, routing).
 </process>