@izkac/forgekit 0.3.12 → 0.3.14

package/vendor/templates/project/claude/commands/forge-apply.md

@@ -1,75 +1,75 @@
----
-name: /forge:apply
-description: Forge — apply a tracked change with subagent TDD, verify, and review
-category: Workflow
-tags: [workflow, forge, openspec]
----
-
-**Forge-owned command.** Use this instead of bare `/opsx:apply` for disciplined implementation of a tracked change (OpenSpec or built-in specs engine — `.forge/config.json` → `plan.engine`).
-
-Read the Forge skill (`~/.claude/skills/forge/SKILL.md`) and `~/.claude/skills/forge/docs/forge.md`.
-
-**Input**: Optionally specify a change name (e.g., `/forge:apply add-auth`). If omitted, infer from context or active Forge session.
-
-## 0. Forge session
-
-1. Announce: "Using Forge apply."
-2. Resume `.forge/active.json` or bootstrap: `forge new <slug>`
-3. Set phase (use the project's engine as plan-type):
-   ```bash
-   forge phase implement --plan-type openspec|specs --openspec "<change>"
-   ```
-
-## 1–5. Load the change
-
-**OpenSpec engine** — vendor CLI, follow `openspec-apply-change` (same as `/opsx:apply` steps 1–5):
-
-1. **Select the change** — announce "Using change: \<name\>"
-2. `openspec status --change "<name>" --json`
-3. `openspec instructions apply --change "<name>" --json`
-4. Read all `contextFiles` from CLI output
-5. Show progress (N/M tasks, schema, remaining tasks)
-
-Handle blocked / all_done states per vendor skill before implementing.
-
-**Specs engine** — no CLI:
-
-1. **Select the change** under `specs/changes/<name>/` — announce "Using change: \<name\>"
-2. Read `proposal.md`, `design.md` (if present), `tasks.md`
-3. Show progress (N/M checkboxes, remaining tasks)
-
-## 6. Implement (Forge — REQUIRED)
-
-Follow ~/.claude/skills/forge/phases/implement.md`:
-
-- **Do not** implement all tasks inline in coordinator context
-- Per pending task: brief → **implementer** subagent (TDD first) → **spec reviewer** → **quality reviewer** → mark `- [x]` in `tasks.md`
-- Bundled skills: `skills/subagent-driven-development` + `skills/test-driven-development`
-
-Pause on unclear tasks, design issues, errors, or user interrupt.
-
-## 7. Verify (Forge — REQUIRED when all tasks done)
-
-Follow ~/.claude/skills/forge/phases/verify.md`:
-
-```bash
-forge phase verify
-```
-
-Run affected workspace tests — **audit per-task `test-evidence.md`**; do not re-run the same commands if subagents already recorded passing runs (see verify phase).
-
-## 8. Review (Forge — REQUIRED)
-
-Follow ~/.claude/skills/forge/phases/review.md`:
-
-```bash
-forge phase review
-```
-
-Final reviewer; save to `.forge/sessions/<id>/reviews/final-review.md`.
-
-## 9. Finish
-
-When verify + review pass: suggest archive — `/opsx:archive` (OpenSpec) or the dated move into `specs/changes/archive/` (specs) — per [finish phase](~/.claude/skills/forge/phases/finish.md).
-
-**Skip Forge for this task only:** `/forge:skip` (runs work without brainstorm/plan/verify chain).
+---
+name: /forge:apply
+description: Forge — apply a tracked change with subagent TDD, verify, and review
+category: Workflow
+tags: [workflow, forge, openspec]
+---
+
+**Forge-owned command.** Use this instead of bare `/opsx:apply` for disciplined implementation of a tracked change (OpenSpec or built-in specs engine — `.forge/config.json` → `plan.engine`).
+
+Read the Forge skill (`~/.claude/skills/forge/SKILL.md`) and `~/.claude/skills/forge/docs/forge.md`.
+
+**Input**: Optionally specify a change name (e.g., `/forge:apply add-auth`). If omitted, infer from context or active Forge session.
+
+## 0. Forge session
+
+1. Announce: "Using Forge apply."
+2. Resume `.forge/active.json` or bootstrap: `forge new <slug>`
+3. Set phase (use the project's engine as plan-type):
+   ```bash
+   forge phase implement --plan-type openspec|specs --openspec "<change>"
+   ```
+
+## 1–5. Load the change
+
+**OpenSpec engine** — vendor CLI, follow `openspec-apply-change` (same as `/opsx:apply` steps 1–5):
+
+1. **Select the change** — announce "Using change: \<name\>"
+2. `openspec status --change "<name>" --json`
+3. `openspec instructions apply --change "<name>" --json`
+4. Read all `contextFiles` from CLI output
+5. Show progress (N/M tasks, schema, remaining tasks)
+
+Handle blocked / all_done states per vendor skill before implementing.
+
+**Specs engine** — no CLI:
+
+1. **Select the change** under `<plan.dir>/changes/<name>/` (default `specs/changes/`) — announce "Using change: \<name\>"
+2. Read `proposal.md`, `design.md` (if present), `tasks.md`
+3. Show progress (N/M checkboxes, remaining tasks)
+
+## 6. Implement (Forge — REQUIRED)
+
+Follow ~/.claude/skills/forge/phases/implement.md`:
+
+- **Do not** implement all tasks inline in coordinator context
+- Per pending task: brief → **implementer** subagent (TDD first) → **spec reviewer** → **quality reviewer** → mark `- [x]` in `tasks.md`
+- Bundled skills: `skills/subagent-driven-development` + `skills/test-driven-development`
+
+Pause on unclear tasks, design issues, errors, or user interrupt.
+
+## 7. Verify (Forge — REQUIRED when all tasks done)
+
+Follow ~/.claude/skills/forge/phases/verify.md`:
+
+```bash
+forge phase verify
+```
+
+Run affected workspace tests — **audit per-task `test-evidence.md`**; do not re-run the same commands if subagents already recorded passing runs (see verify phase).
+
+## 8. Review (Forge — REQUIRED)
+
+Follow ~/.claude/skills/forge/phases/review.md`:
+
+```bash
+forge phase review
+```
+
+Final reviewer; save to `.forge/sessions/<id>/reviews/final-review.md`.
+
+## 9. Finish
+
+When verify + review pass: suggest archive — `/opsx:archive` (OpenSpec) or `forge change archive <name>` (specs; merges deltas into `<plan.dir>/specs/`) — per [finish phase](~/.claude/skills/forge/phases/finish.md).
+
+**Skip Forge for this task only:** `/forge:skip` (runs work without brainstorm/plan/verify chain).

package/vendor/templates/project/claude/commands/forge-brainstorm.md

@@ -1,7 +1,7 @@
----
-description: Forge — brainstorm phase only
----
-
-Brainstorm phase only. Follow ~/.claude/skills/forge/phases/brainstorm.md`.
-
-Invoke bundled **skills/brainstorming**. Save notes to `.forge/sessions/<id>/brainstorm/`. Terminal state: **OpenSpec propose** (`/opsx:propose`) — do not implement until artefacts are approved.
+---
+description: Forge — brainstorm phase only
+---
+
+Brainstorm phase only. Follow ~/.claude/skills/forge/phases/brainstorm.md`.
+
+Invoke bundled **skills/brainstorming**. Save notes to `.forge/sessions/<id>/brainstorm/`. Terminal state: **OpenSpec propose** (`/opsx:propose`) — do not implement until artefacts are approved.

package/vendor/templates/project/claude/commands/forge-build.md

@@ -1,17 +1,17 @@
----
-name: /forge:build
-description: Forge — implement phase (subagent-driven + TDD)
-category: Workflow
-tags: [workflow, forge, openspec]
----
-
-Implement phase. Follow ~/.claude/skills/forge/phases/implement.md`.
-
-**REQUIRED:** forge `skills/subagent-driven-development` + `skills/test-driven-development` per task.
-
-- OpenSpec plan → **`/forge:apply`** (preferred) or `openspec-apply-change` / `/opsx:apply` wrapped in subagent loop
-- Specs plan (`planType: specs`) → **`/forge:apply`** — tasks from `specs/changes/<name>/tasks.md`, no vendor CLI steps
-- Throwaway plan → tasks from `.forge/.../plan.md`
-- Direct → brief from `.forge/.../brainstorm/notes.md` + `decisions.md`
-
-Then verify and review phases.
+---
+name: /forge:build
+description: Forge — implement phase (subagent-driven + TDD)
+category: Workflow
+tags: [workflow, forge, openspec]
+---
+
+Implement phase. Follow ~/.claude/skills/forge/phases/implement.md`.
+
+**REQUIRED:** forge `skills/subagent-driven-development` + `skills/test-driven-development` per task.
+
+- OpenSpec plan → **`/forge:apply`** (preferred) or `openspec-apply-change` / `/opsx:apply` wrapped in subagent loop
+- Specs plan (`planType: specs`) → **`/forge:apply`** — tasks from `<plan.dir>/changes/<name>/tasks.md`, no vendor CLI steps
+- Throwaway plan → tasks from `.forge/.../plan.md`
+- Direct → brief from `.forge/.../brainstorm/notes.md` + `decisions.md`
+
+Then verify and review phases.

package/vendor/templates/project/claude/commands/forge-plan.md

@@ -1,12 +1,12 @@
----
-description: Forge — plan phase (tracked change propose)
----
-
-Plan phase. Follow ~/.claude/skills/forge/references/plan-routing.md`.
-
-**Engine from `.forge/config.json` → `plan.engine`** — do not ask for a plan mode:
-
-- `openspec` → run `/opsx:propose <prefix>-<slug>` or the `openspec-propose` skill per [plan-openspec.md](~/.claude/skills/forge/phases/plan-openspec.md)
-- `specs` → author `specs/changes/<name>/{proposal,tasks}.md` per [plan-specs.md](~/.claude/skills/forge/phases/plan-specs.md)
-
-Get user approval on the change artefacts before `/forge:build` or `/forge:apply`.
+---
+description: Forge — plan phase (tracked change propose)
+---
+
+Plan phase. Follow ~/.claude/skills/forge/references/plan-routing.md`.
+
+**Engine from `.forge/config.json` → `plan.engine`** — do not ask for a plan mode:
+
+- `openspec` → run `/opsx:propose <prefix>-<slug>` or the `openspec-propose` skill per [plan-openspec.md](~/.claude/skills/forge/phases/plan-openspec.md)
+- `specs` → author `<plan.dir>/changes/<name>/{proposal,design,tasks}.md` + delta `specs/<cap>/spec.md` per [plan-specs.md](~/.claude/skills/forge/phases/plan-specs.md) (`forge change new <name> --capability <cap>`)
+
+Get user approval on the change artefacts before `/forge:build` or `/forge:apply`.

package/vendor/templates/project/claude/commands/forge-skip.md

@@ -1,14 +1,14 @@
----
-name: /forge:skip
-description: Explicitly skip Forge for this task
-category: Workflow
-tags: [workflow, forge]
----
-
-User opted out of Forge for **this task only**.
-
-1. If active session exists: `forge phase skipped`
-2. Do **not** brainstorm or plan
-3. Execute the request under normal project rules
-
-Triage defaults to Forge; `/forge:skip` is the explicit override.
+---
+name: /forge:skip
+description: Explicitly skip Forge for this task
+category: Workflow
+tags: [workflow, forge]
+---
+
+User opted out of Forge for **this task only**.
+
+1. If active session exists: `forge phase skipped`
+2. Do **not** brainstorm or plan
+3. Execute the request under normal project rules
+
+Triage defaults to Forge; `/forge:skip` is the explicit override.

package/vendor/templates/project/claude/commands/forge-status.md

@@ -1,16 +1,16 @@
----
-name: /forge:status
-description: Forge — show active session progress
-category: Workflow
-tags: [workflow, forge]
----
-
-Show Forge session status:
-
-```bash
-forge status
-```
-
-Summarize `phase`, `planType`, `openspecChange`, and task progress for the user.
-
-Reference: `~/.claude/skills/forge/docs/forge.md`
+---
+name: /forge:status
+description: Forge — show active session progress
+category: Workflow
+tags: [workflow, forge]
+---
+
+Show Forge session status:
+
+```bash
+forge status
+```
+
+Summarize `phase`, `planType`, `openspecChange`, and task progress for the user.
+
+Reference: `~/.claude/skills/forge/docs/forge.md`

package/vendor/templates/project/claude/commands/forge.md

@@ -1,16 +1,16 @@
----
-name: /forge
-description: Forge — start or resume disciplined development (brainstorm → plan → build → review)
-category: Workflow
-tags: [workflow, forge, planning]
----
-
-Run the **Forge** workflow for substantial work.
-
-Read and follow the Forge skill (`~/.claude/skills/forge/SKILL.md`) and `~/.claude/skills/forge/docs/forge.md`.
-
-1. Triage — substantial work? (skip only if user said `/forge:skip`)
-2. Resume from `.forge/active.json` or `forge new <slug>`
-3. Continue from current `phase` in `session.json`
-
-Subcommands: `/forge:brainstorm`, `/forge:plan`, `/forge:apply`, `/forge:build`, `/forge:status`, `/forge:harness`, `/forge:analyze`, `/forge:skip`
+---
+name: /forge
+description: Forge — start or resume disciplined development (brainstorm → plan → build → review)
+category: Workflow
+tags: [workflow, forge, planning]
+---
+
+Run the **Forge** workflow for substantial work.
+
+Read and follow the Forge skill (`~/.claude/skills/forge/SKILL.md`) and `~/.claude/skills/forge/docs/forge.md`.
+
+1. Triage — substantial work? (skip only if user said `/forge:skip`)
+2. Resume from `.forge/active.json` or `forge new <slug>`
+3. Continue from current `phase` in `session.json`
+
+Subcommands: `/forge:brainstorm`, `/forge:plan`, `/forge:apply`, `/forge:build`, `/forge:status`, `/forge:harness`, `/forge:analyze`, `/forge:skip`

package/vendor/templates/project/claude/hooks/forge-prompt-hook.mjs

@@ -1,73 +1,73 @@
-#!/usr/bin/env node
-/**
- * UserPromptSubmit: when the user invokes /forge or /forge:*, inject session context.
- * Requires `forge` on PATH.
- */
-
-import { spawnSync } from 'node:child_process';
-import fs from 'node:fs';
-import path from 'node:path';
-
-const REPO_ROOT = process.env.CLAUDE_PROJECT_DIR || process.cwd();
-const ACTIVE_FILE = path.join(REPO_ROOT, '.forge', 'active.json');
-
-function readStdin() {
-  return new Promise((resolve) => {
-    let data = '';
-    if (process.stdin.isTTY) return resolve('');
-    process.stdin.setEncoding('utf8');
-    process.stdin.on('data', (chunk) => {
-      data += chunk;
-    });
-    process.stdin.on('end', () => resolve(data));
-    process.stdin.on('error', () => resolve(data));
-    setTimeout(() => resolve(data), 1500);
-  });
-}
-
-function extractPrompt(raw) {
-  if (!raw) return '';
-  try {
-    const j = JSON.parse(raw);
-    return (
-      (typeof j?.prompt === 'string' && j.prompt) ||
-      (typeof j?.user_prompt === 'string' && j.user_prompt) ||
-      (typeof j?.message === 'string' && j.message) ||
-      ''
-    );
-  } catch {
-    return raw;
-  }
-}
-
-function isForgeInvocation(prompt) {
-  return /^\s*\/forge(?::|\s|$)/i.test(prompt);
-}
-
-function emit(message) {
-  process.stdout.write(`<system-reminder>\n${message}\n</system-reminder>\n`);
-}
-
-const raw = await readStdin();
-const prompt = extractPrompt(raw);
-
-if (!isForgeInvocation(prompt)) {
-  process.exit(0);
-}
-
-if (!fs.existsSync(ACTIVE_FILE)) {
-  emit(
-    '[forge] No active session. Bootstrap with `forge new <slug>` then follow the Forge skill.',
-  );
-  process.exit(0);
-}
-
-const r = spawnSync('forge', ['reminder', '--format', 'plain', '--prompt', prompt], {
-  encoding: 'utf8',
-  cwd: REPO_ROOT,
-  shell: true,
-});
-
-if (r.status === 0 && r.stdout.trim()) {
-  emit(r.stdout.trim());
-}
+#!/usr/bin/env node
+/**
+ * UserPromptSubmit: when the user invokes /forge or /forge:*, inject session context.
+ * Requires `forge` on PATH.
+ */
+
+import { spawnSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+
+const REPO_ROOT = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+const ACTIVE_FILE = path.join(REPO_ROOT, '.forge', 'active.json');
+
+function readStdin() {
+  return new Promise((resolve) => {
+    let data = '';
+    if (process.stdin.isTTY) return resolve('');
+    process.stdin.setEncoding('utf8');
+    process.stdin.on('data', (chunk) => {
+      data += chunk;
+    });
+    process.stdin.on('end', () => resolve(data));
+    process.stdin.on('error', () => resolve(data));
+    setTimeout(() => resolve(data), 1500);
+  });
+}
+
+function extractPrompt(raw) {
+  if (!raw) return '';
+  try {
+    const j = JSON.parse(raw);
+    return (
+      (typeof j?.prompt === 'string' && j.prompt) ||
+      (typeof j?.user_prompt === 'string' && j.user_prompt) ||
+      (typeof j?.message === 'string' && j.message) ||
+      ''
+    );
+  } catch {
+    return raw;
+  }
+}
+
+function isForgeInvocation(prompt) {
+  return /^\s*\/forge(?::|\s|$)/i.test(prompt);
+}
+
+function emit(message) {
+  process.stdout.write(`<system-reminder>\n${message}\n</system-reminder>\n`);
+}
+
+const raw = await readStdin();
+const prompt = extractPrompt(raw);
+
+if (!isForgeInvocation(prompt)) {
+  process.exit(0);
+}
+
+if (!fs.existsSync(ACTIVE_FILE)) {
+  emit(
+    '[forge] No active session. Bootstrap with `forge new <slug>` then follow the Forge skill.',
+  );
+  process.exit(0);
+}
+
+const r = spawnSync('forge', ['reminder', '--format', 'plain', '--prompt', prompt], {
+  encoding: 'utf8',
+  cwd: REPO_ROOT,
+  shell: true,
+});
+
+if (r.status === 0 && r.stdout.trim()) {
+  emit(r.stdout.trim());
+}

package/vendor/templates/project/claude/hooks/forge-session-start.mjs

@@ -1,19 +1,19 @@
-#!/usr/bin/env node
-/**
- * Claude Code SessionStart: inject active Forge session when present.
- * Requires `forge` on PATH (npm link @izkac/forgekit or global install).
- */
-
-import { spawnSync } from 'node:child_process';
-
-const REPO_ROOT = process.env.CLAUDE_PROJECT_DIR || process.cwd();
-
-const r = spawnSync('forge', ['reminder', '--format', 'claude-session-start'], {
-  encoding: 'utf8',
-  cwd: REPO_ROOT,
-  shell: true,
-});
-
-if (r.status === 0 && r.stdout.trim()) {
-  process.stdout.write(r.stdout);
-}
+#!/usr/bin/env node
+/**
+ * Claude Code SessionStart: inject active Forge session when present.
+ * Requires `forge` on PATH (npm link @izkac/forgekit or global install).
+ */
+
+import { spawnSync } from 'node:child_process';
+
+const REPO_ROOT = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+
+const r = spawnSync('forge', ['reminder', '--format', 'claude-session-start'], {
+  encoding: 'utf8',
+  cwd: REPO_ROOT,
+  shell: true,
+});
+
+if (r.status === 0 && r.stdout.trim()) {
+  process.stdout.write(r.stdout);
+}