arkgate 4.7.0 → 4.7.2

package/templates/agent-skills/ark-upgrade/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ark-upgrade
-description: Upgrade ArkGate through a content-identity preview, preserve customized files, and verify the active host and architecture contract.
+description: Upgrade ArkGate. Preview first, keep customized files, then apply.
 ---
 
 # /ark-upgrade — managed ArkGate upgrade

package/templates/skills/ark-adopt.md

@@ -1,11 +1,11 @@
 ---
 name: ark-adopt
-description: Session 0 — mark the Ark path. Greenfield scaffold or brownfield honesty. Write ark.config, optional advisory ArkRules, baseline, and gates in this turn. CLI validates.
+description: Session 0 — write the rules file (ark.config.json) to match the real folders. Optional extra rules inside a layer. CLI validates.
 ---
 
 # /ark-adopt — Mark the path (session 0)
 
-**When:** empty tree, or the architecture config does not match the real folders (session 0).
+**When:** empty tree, or the rules file does not match the real folders (session 0).
 **Not when:** a single new file (`/ark-place`) or leftover design after the path is honest (`/ark-explore` then `/ark-autopilot`).
 
 ## Steps

package/templates/skills/ark-architect.md

@@ -1,6 +1,6 @@
 ---
 name: ark-architect
-description: Shortcut to /ark-adopt for greenfield shape. Deprecated as a first-class door. Do adopt’s job.
+description: Shortcut to /ark-adopt for a new tree. Deprecated as a first-class door.
 ---
 
 # /ark-architect — Shortcut to /ark-adopt

package/templates/skills/ark-autopilot.md

@@ -1,6 +1,6 @@
 ---
 name: ark-autopilot
-description: Apply Ark end-to-end — explore first; dual plan A (edges) + B (shape); write mechanical-safe and judgment in this turn; one Shape refactor. Empty plan A is not healthy if leftover design remains. CLI is a sensor; you edit files.
+description: Fix illegal imports and one leftover-design refactor. CLI is a sensor; you edit files.
 ---
 
 # /ark-autopilot — Apply the path
@@ -14,7 +14,7 @@ description: Apply Ark end-to-end — explore first; dual plan A (edges) + B (sh
 2. Fix import-rule debt; if leftover design remains, apply **one** small refactor.
 3. Re-run doctor. Never weaken `ark.config.json`.
 
-**This is the apply door.** Invoking it **is** the approval. Doctor remains the control plane.
+**This is the apply door.** Invoking it **is** the approval. Run `arkgate-check --doctor` for the next step.
 
 ## Autonomy contract
 

package/templates/skills/ark-contract.md

@@ -1,6 +1,6 @@
 ---
 name: ark-contract
-description: Shortcut to /ark-adopt (session 0) or /ark-autopilot (later config tighten). Deprecated as a first-class door.
+description: Shortcut — edit the rules file or extra rules. Use /ark-adopt or /ark-autopilot.
 ---
 
 # /ark-contract — Shortcut to adopt / autopilot
@@ -17,8 +17,9 @@ preview-only. Never weaken the architecture config.
 
 | Use this leftover name when… | Prefer instead |
 |------------------------------|----------------|
-| Layers / include / ArkRules need an edit | **`/ark-adopt`** (path) or **`/ark-autopilot`** (tighten) |
+| Layers / include / ArkRules / **ArkRun extra** need an edit | **`/ark-adopt`** (path, first `arkRun`) or **`/ark-autopilot`** (tighten) |
 | False-green / concentrated edge | **`/ark-adopt`** — write the honest config |
+| Companion install / one kernel candidate | **`/ark-runtime`** — this leftover name does not wire `@arkgate/runtime` |
 
 ## Dual engine (mandatory)
 
@@ -40,7 +41,7 @@ restart/retargeting is required. `ark://manifest` never satisfies this preflight
 
 ## Dual plane — layers + ArkRules (mandatory, except /ark-runtime)
 
-Label findings **`[Layer]`** vs **`[ArkRules]`**. Absence of `arkRules` is valid.
+Label findings **`[Layer]`** vs **`[ArkRules]`** vs **`[ArkRun]`**. Absence of `arkRules` or `arkRun` is valid. First-time extra is **`/ark-adopt`** (advisory). Wire one candidate with **`/ark-runtime`**. New kernel-managed file with **`/ark-place`**. Do not invent `/ark-run`.
 
 ## Subagent fan-out (optional, host-dependent)
 
@@ -54,9 +55,9 @@ If the host supports **parallel subagents**, fan out read-only scouts; otherwise
 
 ## Steps
 
-1. If the path is missing or lying → execute **`/ark-adopt`**.
-2. If the path is honest and you are tightening rules → execute **`/ark-autopilot`**.
-3. `ark-check --strict-config`.
+1. If the path is missing or lying → execute **`/ark-adopt`** (including first advisory `arkRun`).
+2. If the path is honest and you are tightening rules or the ArkRun extra → execute **`/ark-autopilot`**.
+3. Companion / one candidate → **`/ark-runtime`**. `ark-check --strict-config`.
 
 ## Completion contract (skill incomplete if missing)
 
@@ -66,7 +67,7 @@ Skill incomplete if missing any field below.
 - **Sensor:** commands/tools run
 - **Opened:** real paths read (or `n/a` only if pure install/upgrade with no source analysis)
 - **Result:** one-line outcome
-- **Planes:** one-line split of residual **[Layer]** vs **[ArkRules]** (or `n/a` if unused)
+- **Planes:** one-line split of residual **[Layer]** vs **[ArkRules]** vs **[ArkRun]** (or `n/a` if unused)
 - **Compass:** top residual lenses | `n/a`
 - **Handoff:** `/ark-adopt` / `/ark-autopilot` / `none`
 - **Incomplete?** `no` | `yes — <what is missing>`

package/templates/skills/ark-coverage.md

@@ -1,6 +1,6 @@
 ---
 name: ark-coverage
-description: Ark adoption fitness audit — governed%, gates, baseline honesty, capability gaps. CLI is a sensor; read enough source to prove gaps. Full product recon and pattern dual-plan belong to /ark-explore.
+description: How much of the tree the rules file covers. CLI is a sensor; read the source.
 ---
 
 # /ark-coverage — Ark adoption fitness (not full recon)

package/templates/skills/ark-explain.md

@@ -1,6 +1,6 @@
 ---
 name: ark-explain
-description: Explain this project's architecture in plain language and generate the showcase HTML report — layers, rules, coverage, gates, and why the contract exists.
+description: Explain the rules file in plain language and generate the HTML report.
 ---
 
 # /ark-explain — Understand this project's architecture

package/templates/skills/ark-explore.md

@@ -1,6 +1,6 @@
 ---
 name: ark-explore
-description: Map skill — decision-grade recon of layers + ArkRules opportunities + dual-plan seed (no apply). Primary post-green door when leftover design work remains. CLI is a sensor; you read the tree. No gate bypass.
+description: Map import rules and leftover design. No apply. CLI is a sensor; you read the tree.
 ---
 
 # /ark-explore — Recon the real project (map only)

package/templates/skills/ark-fix.md

@@ -1,6 +1,6 @@
 ---
 name: ark-fix
-description: Shortcut to /ark-autopilot for a small violation cluster. Deprecated as a first-class door.
+description: Shortcut to /ark-autopilot for a small illegal-import cluster.
 ---
 
 # /ark-fix — Shortcut to /ark-autopilot

package/templates/skills/ark-loop.md

@@ -1,6 +1,6 @@
 ---
 name: ark-loop
-description: Shortcut to /ark-autopilot for driving plan A to zero. Deprecated as a first-class door. CLI validates — you edit code.
+description: Shortcut to /ark-autopilot for illegal-import fixes. CLI validates — you edit code.
 ---
 
 # /ark-loop — Shortcut to /ark-autopilot

package/templates/skills/ark-place.md

@@ -1,6 +1,6 @@
 ---
 name: ark-place
-description: "Where does new code go? Names the layer, directory, and naming for a new artifact from the contract, and writes it there. Autonomous."
+description: "Where does new code go? Names the folder from the rules file and writes the file there."
 ---
 
 # /ark-place — Where does this code go?

package/templates/skills/ark-runtime.md

@@ -1,6 +1,6 @@
 ---
 name: ark-runtime
-description: Evaluate and wire the experimental ArkRun companion (@arkgate/runtime) against hand-rolled event bus, outbox, saga, projection, policy, or NestJS code. One candidate. Extra on via /ark-adopt; new files via /ark-place. Skills never enforce.
+description: Wire the optional ArkRun extra (@arkgate/runtime). One candidate. Extra on via /ark-adopt.
 ---
 
 # /ark-runtime — Evaluate and wire ArkRun (experimental opt-in)

package/templates/skills/ark-think.md

@@ -1,6 +1,6 @@
 ---
 name: ark-think
-description: Host-side architectural reasoning — 2–3 enforceable options on layer and/or ArkRules planes for ONE decision. Not full recon (use /ark-explore). No gate bypass. No package LLM call.
+description: 2–3 options for one import-rule or ArkRules decision. Not a full map (use /ark-explore).
 ---
 
 # /ark-think — Architectural reasoning (host LLM only)

package/templates/skills/ark-upgrade.md

@@ -1,6 +1,6 @@
 ---
 name: ark-upgrade
-description: Upgrade ArkGate through a content-identity preview, preserve customized files, and verify the active host and architecture contract.
+description: Upgrade ArkGate. Preview first, keep customized files, then apply.
 ---
 
 # /ark-upgrade — managed ArkGate upgrade