@izkac/forgekit 0.3.12 → 0.3.13

package/vendor/skills/forge/references/forge-layout.md

@@ -1,85 +1,85 @@
-# `.forge/` session layout
-
-Gitignored scratch space. Only [`.forge/README.md`](../../../.forge/README.md) is committed.
-
-## Per-checkout active session
-
-`.forge/active.json`:
-
-```json
-{
-  "sessionId": "2026-06-05T143022Z-my-feature-a3f9b2",
-  "sessionPath": ".forge/sessions/2026-06-05T143022Z-my-feature-a3f9b2",
-  "updatedAt": "2026-06-05T14:30:22.000Z"
-}
-```
-
-One active session per checkout (same pattern as `.impeccable/active.json`).
-Optional `cursorChatId` on `session.json` when available — not required.
-
-## Session directory
-
-```
-.forge/
-  active.json
-  models.local.json            ← optional; only after `forge:models -- <lane>`
-  preferences.local.json       ← optional; only after `forge:prefs -- <pace>`
-  sessions/<session-id>/
-    session.json
-    status.json
-    brainstorm/
-      notes.md
-      decisions.md
-    plan.md                    ← throwaway plans only
-    verify-evidence.md         ← tier 3 (scope from pace)
-    tasks/
-      01-<slug>/
-        brief.md
-        test-evidence.md
-        task-review.md
-    reviews/
-      final-review.md
-```
-
-Bare `forge models` / `forge:prefs` **print** effective values from committed
-defaults and do **not** create the `*.local.json` files. See [pace.md](./pace.md) and
-[docs/forge.md](../docs/forge.md) § Checkout-local overrides.
-
-## session.json fields
-
-| Field | Description |
-| ----- | ----------- |
-| `id` | Session directory name |
-| `slug` | Short kebab label |
-| `phase` | Current Forge phase |
-| `planType` | `openspec` (default for new work), or legacy `throwaway` / `direct` |
-| `openspecChange` | Change folder name when `planType: openspec` |
-| `forgeSkipped` | `true` if user invoked `/forge:skip` |
-| `tasksTotal` / `tasksComplete` | Implementation progress |
-| `pace` | Requested pace (`auto` \| `thorough` \| `standard` \| `brisk` \| `lite`) |
-| `resolvedPace` | Concrete pace after auto resolve or pin |
-| `paceReason` | Why auto picked this pace |
-| `paceSignal` | Text used for auto resolve |
-| `pacePinned` | `true` when checkout/session set an explicit concrete pace |
-
-Under `standard` (`review.perTask: per-group`), also write `group-review.md` when an OpenSpec `tasks.md` section completes (see [pace.md](./pace.md)).
-
-| `preferencesOverride` | Optional session-only prefs patch |
-| `createdAt` / `updatedAt` | ISO timestamps |
-
-## Retention
-
-**14 days.** Run `forge cleanup` to prune old or finished sessions.
-
-## Scripts
-
-| Script | Purpose |
-| ------ | ------- |
-| `forge new <slug>` | Create session + set active (resolves pace; warn-only doctor) |
-| `forge status` | Read active session (+ effective pace) |
-| `forge prefs` | Get/set pace preferences |
-| `forge doctor` | OpenSpec project + CLI check |
-| `forge phase <phase>` | Update phase |
-| `forge cleanup` | Prune stale sessions |
-
-Pace matrix: [pace.md](./pace.md).
+# `.forge/` session layout
+
+Gitignored scratch space. Only [`.forge/README.md`](../../../.forge/README.md) is committed.
+
+## Per-checkout active session
+
+`.forge/active.json`:
+
+```json
+{
+  "sessionId": "2026-06-05T143022Z-my-feature-a3f9b2",
+  "sessionPath": ".forge/sessions/2026-06-05T143022Z-my-feature-a3f9b2",
+  "updatedAt": "2026-06-05T14:30:22.000Z"
+}
+```
+
+One active session per checkout (same pattern as `.impeccable/active.json`).
+Optional `cursorChatId` on `session.json` when available — not required.
+
+## Session directory
+
+```
+.forge/
+  active.json
+  models.local.json            ← optional; only after `forge:models -- <lane>`
+  preferences.local.json       ← optional; only after `forge:prefs -- <pace>`
+  sessions/<session-id>/
+    session.json
+    status.json
+    brainstorm/
+      notes.md
+      decisions.md
+    plan.md                    ← throwaway plans only
+    verify-evidence.md         ← tier 3 (scope from pace)
+    tasks/
+      01-<slug>/
+        brief.md
+        test-evidence.md
+        task-review.md
+    reviews/
+      final-review.md
+```
+
+Bare `forge models` / `forge:prefs` **print** effective values from committed
+defaults and do **not** create the `*.local.json` files. See [pace.md](./pace.md) and
+[docs/forge.md](../docs/forge.md) § Checkout-local overrides.
+
+## session.json fields
+
+| Field | Description |
+| ----- | ----------- |
+| `id` | Session directory name |
+| `slug` | Short kebab label |
+| `phase` | Current Forge phase |
+| `planType` | `openspec` (default for new work), or legacy `throwaway` / `direct` |
+| `openspecChange` | Change folder name when `planType: openspec` |
+| `forgeSkipped` | `true` if user invoked `/forge:skip` |
+| `tasksTotal` / `tasksComplete` | Implementation progress |
+| `pace` | Requested pace (`auto` \| `thorough` \| `standard` \| `brisk` \| `lite`) |
+| `resolvedPace` | Concrete pace after auto resolve or pin |
+| `paceReason` | Why auto picked this pace |
+| `paceSignal` | Text used for auto resolve |
+| `pacePinned` | `true` when checkout/session set an explicit concrete pace |
+
+Under `standard` (`review.perTask: per-group`), also write `group-review.md` when an OpenSpec `tasks.md` section completes (see [pace.md](./pace.md)).
+
+| `preferencesOverride` | Optional session-only prefs patch |
+| `createdAt` / `updatedAt` | ISO timestamps |
+
+## Retention
+
+**14 days.** Run `forge cleanup` to prune old or finished sessions.
+
+## Scripts
+
+| Script | Purpose |
+| ------ | ------- |
+| `forge new <slug>` | Create session + set active (resolves pace; warn-only doctor) |
+| `forge status` | Read active session (+ effective pace) |
+| `forge prefs` | Get/set pace preferences |
+| `forge doctor` | OpenSpec project + CLI check |
+| `forge phase <phase>` | Update phase |
+| `forge cleanup` | Prune stale sessions |
+
+Pace matrix: [pace.md](./pace.md).

package/vendor/skills/forge/references/pace.md

@@ -1,115 +1,115 @@
-# Forge pace (thoroughness)
-
-Checkout-local preferences control how much review/verify ceremony Forge runs.
-Defaults live in `preferences.defaults.json`; optional overrides in
-gitignored `.forge/preferences.local.json` (**file appears only after a set**).
-
-```bash
-forge prefs                         # print effective — does NOT write a file
-forge prefs -- auto|thorough|standard|brisk|lite   # WRITE preferences.local.json
-forge prefs -- --set review.perTask=always
-forge prefs --session-set brisk  # this session only (no local file)
-forge prefs -- --resolve --signal "add stripe refund"
-forge doctor                        # OpenSpec project + CLI
-```
-
-Billing lane (orthogonal): `forge models` prints only;
-`forge models included|metered` writes `.forge/models.local.json`.
-See [docs/forge.md](../docs/forge.md) § Checkout-local overrides.
-
-## Announce
-
-At session start: `Using Forge for this work. Pace: auto → brisk (…)` (use
-`resolved` from `forge status` / session reminder).
-
-## Presets (effort matrix)
-
-| Knob | `thorough` | `standard` | `brisk` | `lite` |
-|------|------------|------------|---------|--------|
-| **review.perTask** | always | per-group | high-risk-only | never\* |
-| **review.final** | always | always | high-risk-only | never\* |
-| **review.depth** | full | full | spec-only | spec-only |
-| **review.maxRounds** | 3 | 2 | 1 | 0 |
-| **verify.tier3** | full-workspace | full-workspace | affected-only | audit-tier2-only |
-| **models.bias** | default | default | prefer-fast | prefer-fast |
-| **brainstorm.depth** | full | full | short (≤2–3 options) | minimal |
-
-\*Hard floor: money / auth / shared contracts / migrations / secrets **always**
-get a per-task review (and final review if the session touched high-risk work),
-even under `lite` / `brisk` / mid-group `standard`.
-
-**`thorough` vs `standard`:** thorough reviews **every task**; standard reviews once per **OpenSpec group** (top-level `##` section in `tasks.md`), except high-risk tasks which still get an immediate per-task review.
-
-**`auto`:** resolve once at session start from signals; sticky for the session (not a separate knob matrix).
-
-## Auto signals (stricter wins)
-
-1. money, payment, stripe, billing, auth, oauth, hmac, secret, migration, contract, gdpr → **thorough**
-2. ecosystem, cross-workspace, multi-file, openapi, public API, shared package, **worker**, **job queue**, **pipeline**, **etl**, **service(s)**, **platform**, **orchestration**, **openspec**, **forge:apply**, **harmonization** → **standard**
-3. docs, readme, rename, typo, scaffold, wording, comment, changelog → **lite**
-4. fix, tweak, button, toolbar, style, padding, alignment, copy, label (explicitly small) → **brisk**
-5. else (including empty / unrecognized scope) → **standard** (fail closed — never default to brisk)
-
-### Task-count escalation
-
-When `forge phase … --tasks-total N` sets **N ≥ 15** and the session's
-`resolvedPace` is still `brisk` or `lite` (and pace is **not** user-pinned),
-Forge escalates the session to **`standard`** with
-`paceReason: "escalated: N tasks"`. Slug keywords are a poor proxy for scope;
-task count is known at plan time.
-
-## Runtime integrity
-
-Always-on rules (all paces): [runtime-integrity.md](./runtime-integrity.md) —
-no stubs / false success, runtime owner required, tests must fail on a no-op,
-specs beat narrow tasks, E2E-or-BLOCKED before done. Defaults:
-`integrity.forbidStubs`, `integrity.specsBeatNarrowTasks`,
-`integrity.requireE2E` in `preferences.defaults.json` (surfaced by `forge status`).
-
-## Agent rules by knob
-
-### `review.perTask`
-
-Cadence for the task/group reviewer (name is historical — values cover more than “per task”):
-
-- `always` — dispatch task reviewer after **every** implementer (`thorough`).
-- `per-group` — dispatch one reviewer when an OpenSpec **group** completes (`standard`). A group is a top-level `##` section in `openspec/changes/<name>/tasks.md` (all `- [ ]` items under that heading until the next `##`). Mid-group low-risk tasks get a pace self-check `task-review.md` only. If `tasks.md` has **no** section headings, treat the whole file as one group (review once when all tasks are done). High-risk tasks still get an **immediate** per-task review (hard floor).
-- `high-risk-only` — skip reviewer for low-risk tasks; still write a short self-check note in `task-review.md` (`APPROVED (pace: brisk/lite — self-check)`).
-- `never` — same as high-risk-only after hard floor (low-risk may self-check only).
-
-### `review.final`
-
-- Skip final reviewer subagent when `never` / `high-risk-only` and session is not high-risk; write `reviews/final-review.md` noting `SKIPPED (pace=…)`.
-
-### `review.depth`
-
-- `spec-only` — task reviewer checks spec compliance + tests evidence; skip broad quality essay.
-- `full` — spec then quality (existing task-reviewer prompt).
-
-### `review.maxRounds`
-
-- Cap fix→re-review loops; after the cap, escalate to the human with remaining findings.
-
-### `verify.tier3`
-
-- `full-workspace` — current verify.md behavior.
-- `affected-only` — run tests only for workspaces touched by the change (still record `verify-evidence.md`).
-- `audit-tier2-only` — audit per-task evidence; do **not** run full suite; note deferred to push/CI in `verify-evidence.md`.
-
-### `models.bias`
-
-- `prefer-fast` — prefer `--tier fast` for implementers when the brief is mechanical; reviewers use `fast` unless high-risk (then `standard`).
-- `default` — existing role-based tiers.
-
-### `brainstorm.depth`
-
-- `full` — existing brainstorming skill.
-- `short` — at most 2–3 approaches; faster approval.
-- `minimal` — confirm intent + one approach; skip long exploration when design is obvious.
-
-## Unchanged (all paces)
-
-- Tier 1 TDD + tier 2 `test-evidence.md` for behavior changes.
-- No autonomous git commit/push.
-- OpenSpec propose/apply/archive when in Forge.
-- `/forge:skip` still exits Forge entirely.
+# Forge pace (thoroughness)
+
+Checkout-local preferences control how much review/verify ceremony Forge runs.
+Defaults live in `preferences.defaults.json`; optional overrides in
+gitignored `.forge/preferences.local.json` (**file appears only after a set**).
+
+```bash
+forge prefs                         # print effective — does NOT write a file
+forge prefs -- auto|thorough|standard|brisk|lite   # WRITE preferences.local.json
+forge prefs -- --set review.perTask=always
+forge prefs --session-set brisk  # this session only (no local file)
+forge prefs -- --resolve --signal "add stripe refund"
+forge doctor                        # OpenSpec project + CLI
+```
+
+Billing lane (orthogonal): `forge models` prints only;
+`forge models included|metered` writes `.forge/models.local.json`.
+See [docs/forge.md](../docs/forge.md) § Checkout-local overrides.
+
+## Announce
+
+At session start: `Using Forge for this work. Pace: auto → brisk (…)` (use
+`resolved` from `forge status` / session reminder).
+
+## Presets (effort matrix)
+
+| Knob | `thorough` | `standard` | `brisk` | `lite` |
+|------|------------|------------|---------|--------|
+| **review.perTask** | always | per-group | high-risk-only | never\* |
+| **review.final** | always | always | high-risk-only | never\* |
+| **review.depth** | full | full | spec-only | spec-only |
+| **review.maxRounds** | 3 | 2 | 1 | 0 |
+| **verify.tier3** | full-workspace | full-workspace | affected-only | audit-tier2-only |
+| **models.bias** | default | default | prefer-fast | prefer-fast |
+| **brainstorm.depth** | full | full | short (≤2–3 options) | minimal |
+
+\*Hard floor: money / auth / shared contracts / migrations / secrets **always**
+get a per-task review (and final review if the session touched high-risk work),
+even under `lite` / `brisk` / mid-group `standard`.
+
+**`thorough` vs `standard`:** thorough reviews **every task**; standard reviews once per **OpenSpec group** (top-level `##` section in `tasks.md`), except high-risk tasks which still get an immediate per-task review.
+
+**`auto`:** resolve once at session start from signals; sticky for the session (not a separate knob matrix).
+
+## Auto signals (stricter wins)
+
+1. money, payment, stripe, billing, auth, oauth, hmac, secret, migration, contract, gdpr → **thorough**
+2. ecosystem, cross-workspace, multi-file, openapi, public API, shared package, **worker**, **job queue**, **pipeline**, **etl**, **service(s)**, **platform**, **orchestration**, **openspec**, **forge:apply**, **harmonization** → **standard**
+3. docs, readme, rename, typo, scaffold, wording, comment, changelog → **lite**
+4. fix, tweak, button, toolbar, style, padding, alignment, copy, label (explicitly small) → **brisk**
+5. else (including empty / unrecognized scope) → **standard** (fail closed — never default to brisk)
+
+### Task-count escalation
+
+When `forge phase … --tasks-total N` sets **N ≥ 15** and the session's
+`resolvedPace` is still `brisk` or `lite` (and pace is **not** user-pinned),
+Forge escalates the session to **`standard`** with
+`paceReason: "escalated: N tasks"`. Slug keywords are a poor proxy for scope;
+task count is known at plan time.
+
+## Runtime integrity
+
+Always-on rules (all paces): [runtime-integrity.md](./runtime-integrity.md) —
+no stubs / false success, runtime owner required, tests must fail on a no-op,
+specs beat narrow tasks, E2E-or-BLOCKED before done. Defaults:
+`integrity.forbidStubs`, `integrity.specsBeatNarrowTasks`,
+`integrity.requireE2E` in `preferences.defaults.json` (surfaced by `forge status`).
+
+## Agent rules by knob
+
+### `review.perTask`
+
+Cadence for the task/group reviewer (name is historical — values cover more than “per task”):
+
+- `always` — dispatch task reviewer after **every** implementer (`thorough`).
+- `per-group` — dispatch one reviewer when an OpenSpec **group** completes (`standard`). A group is a top-level `##` section in `openspec/changes/<name>/tasks.md` (all `- [ ]` items under that heading until the next `##`). Mid-group low-risk tasks get a pace self-check `task-review.md` only. If `tasks.md` has **no** section headings, treat the whole file as one group (review once when all tasks are done). High-risk tasks still get an **immediate** per-task review (hard floor).
+- `high-risk-only` — skip reviewer for low-risk tasks; still write a short self-check note in `task-review.md` (`APPROVED (pace: brisk/lite — self-check)`).
+- `never` — same as high-risk-only after hard floor (low-risk may self-check only).
+
+### `review.final`
+
+- Skip final reviewer subagent when `never` / `high-risk-only` and session is not high-risk; write `reviews/final-review.md` noting `SKIPPED (pace=…)`.
+
+### `review.depth`
+
+- `spec-only` — task reviewer checks spec compliance + tests evidence; skip broad quality essay.
+- `full` — spec then quality (existing task-reviewer prompt).
+
+### `review.maxRounds`
+
+- Cap fix→re-review loops; after the cap, escalate to the human with remaining findings.
+
+### `verify.tier3`
+
+- `full-workspace` — current verify.md behavior.
+- `affected-only` — run tests only for workspaces touched by the change (still record `verify-evidence.md`).
+- `audit-tier2-only` — audit per-task evidence; do **not** run full suite; note deferred to push/CI in `verify-evidence.md`.
+
+### `models.bias`
+
+- `prefer-fast` — prefer `--tier fast` for implementers when the brief is mechanical; reviewers use `fast` unless high-risk (then `standard`).
+- `default` — existing role-based tiers.
+
+### `brainstorm.depth`
+
+- `full` — existing brainstorming skill.
+- `short` — at most 2–3 approaches; faster approval.
+- `minimal` — confirm intent + one approach; skip long exploration when design is obvious.
+
+## Unchanged (all paces)
+
+- Tier 1 TDD + tier 2 `test-evidence.md` for behavior changes.
+- No autonomous git commit/push.
+- OpenSpec propose/apply/archive when in Forge.
+- `/forge:skip` still exits Forge entirely.

package/vendor/skills/forge/references/plan-routing.md

@@ -1,51 +1,52 @@
-# Plan routing — engine from project config
-
-Forge always produces a tracked change; the **engine** comes from
-`.forge/config.json` → `plan.engine` (written by `forge init`):
-
-| `plan.engine` | Plan phase | Change location |
-| ------------- | ---------- | --------------- |
-| `openspec` (or config missing + `openspec/config.yaml` present) | [../phases/plan-openspec.md](../phases/plan-openspec.md) | `openspec/changes/<name>/` |
-| `specs` | [../phases/plan-specs.md](../phases/plan-specs.md) | `<plan.dir>/changes/<name>/` (default `specs/`) |
-
-<HARD-GATE>
-Do NOT ask the user to choose a plan mode or engine. The engine is project
-config, not conversation. After brainstorm approval, proceed directly to the
-configured engine's propose flow.
-</HARD-GATE>
-
-## Rule
-
-**If work warrants Forge, it warrants a tracked change.** Work that is too
-small for a tracked change should **not** enter Forge — execute directly or
-use `/forge:skip`.
-
-## After brainstorm approval
-
-Follow the phase file for the configured engine — prefix (OpenSpec projects),
-propose, set-phase, approval. Do **not** offer throwaway `.forge/.../plan.md`
-or direct-from-brainstorm implementation paths.
-
-## Engine not configured
-
-If `.forge/config.json` has no `plan` block and there is no
-`openspec/config.yaml`, tell the user to run `forge init` (which offers
-OpenSpec setup or the built-in specs engine) — do not invent a layout.
-
-## Triage alignment
-
-Triage rules live in [substantial-work.md](./substantial-work.md). Before
-bootstrapping a session, confirm the work would produce a tracked change under
-the configured engine; when ambiguous, ask one clarifying question.
-
-## Legacy plan types
-
-`planType: throwaway` and `planType: direct` on **existing** sessions may
-finish per [../phases/finish.md](../phases/finish.md). Do not start new
-sessions with those modes.
-
-## Scope growth mid-session
-
-If implement scope grows beyond the approved change, stop and extend the
-current change (or propose a follow-up change) — do not fall back to throwaway
-or direct planning.
+# Plan routing — engine from project config
+
+Forge always produces a tracked change; the **engine** comes from
+`.forge/config.json` → `plan.engine` (written by `forge init`):
+
+| `plan.engine` | Plan phase | Change location |
+| ------------- | ---------- | --------------- |
+| `openspec` (or config missing + `openspec/config.yaml` present) | [../phases/plan-openspec.md](../phases/plan-openspec.md) | `openspec/changes/<name>/` |
+| `specs` | [../phases/plan-specs.md](../phases/plan-specs.md) | `<plan.dir>/changes/<name>/` (default `specs/`; set `plan.dir: openspec` to reuse an OpenSpec tree) |
+
+
+<HARD-GATE>
+Do NOT ask the user to choose a plan mode or engine. The engine is project
+config, not conversation. After brainstorm approval, proceed directly to the
+configured engine's propose flow.
+</HARD-GATE>
+
+## Rule
+
+**If work warrants Forge, it warrants a tracked change.** Work that is too
+small for a tracked change should **not** enter Forge — execute directly or
+use `/forge:skip`.
+
+## After brainstorm approval
+
+Follow the phase file for the configured engine — prefix (OpenSpec projects),
+propose, set-phase, approval. Do **not** offer throwaway `.forge/.../plan.md`
+or direct-from-brainstorm implementation paths.
+
+## Engine not configured
+
+If `.forge/config.json` has no `plan` block and there is no
+`openspec/config.yaml`, tell the user to run `forge init` (which offers
+OpenSpec setup or the built-in specs engine) — do not invent a layout.
+
+## Triage alignment
+
+Triage rules live in [substantial-work.md](./substantial-work.md). Before
+bootstrapping a session, confirm the work would produce a tracked change under
+the configured engine; when ambiguous, ask one clarifying question.
+
+## Legacy plan types
+
+`planType: throwaway` and `planType: direct` on **existing** sessions may
+finish per [../phases/finish.md](../phases/finish.md). Do not start new
+sessions with those modes.
+
+## Scope growth mid-session
+
+If implement scope grows beyond the approved change, stop and extend the
+current change (or propose a follow-up change) — do not fall back to throwaway
+or direct planning.