arkgate 4.6.1 → 4.6.2

package/templates/skills/ark-explore.md

@@ -5,6 +5,15 @@ description: Map skill — decision-grade recon of layers + ArkRules opportuniti
 
 # /ark-explore — Recon the real project (map only)
 
+**When:** you need a map, or leftover design work remains after imports look green.
+**Not when:** the user wants edits applied (`/ark-autopilot`) or session 0 (`/ark-adopt`).
+
+## Steps
+
+1. Read `arkgate-check --doctor`.
+2. Open the real tree (≥12 files across ≥4 dirs). CLI JSON alone is incomplete.
+3. Rank leftover work. Hand off to `/ark-autopilot` to apply one refactor. Do not write config or product code here.
+
 ## Autonomy contract
 
 Invoking this skill **is** the approval to **map**. Open the real tree. CLI JSON alone is
@@ -308,7 +317,7 @@ Prefer bets the user can run next (`command` / skill), not vague “improve DX
 | **Stabilize** | ENFORCE + honest baseline only for real debt | 0 new edges; doctor not lying about write path/CI |
 | **Shape** | One **golden** pattern + pilot cluster | Pilot smells cleared; rest is migrate-on-touch; B bets have success signals |
 
-ENFORCE without Shape progress is **`ENFORCE · design-weak`** — say that out loud. It is **not** “healthy finished.”
+ENFORCE without Shape progress is leftover design work — say that out loud. It is **not** “healthy finished.”
 
 **Agent-detected design smells** (list any that apply; paths required — these may predate doctor IDs):
 
@@ -374,16 +383,16 @@ and the ranked **`pilotLoop.nextPilot`**.
 
 State **Mode: recon | dual-plan seed | shape-focus** and **Phase: Align | Stabilize | Shape** in the first lines.
 
-1. **Headline** — product one sentence + honesty (mode, governed%, false-green / semantic false-green / **ENFORCE·design-weak** / false-promise risk). ENFORCE is context, not the story.
+1. **Headline** — product one sentence + honesty (mode, governed%, false-green / leftover design work / false-promise risk). ENFORCE is context, not the story.
 2. **Map** — entry points, major dirs, shape name (or “no honest shape yet”). One screen. **Patterns concurrent** table when §B/§G requires it.
 3. **What I opened** — paths + sensors (include field/hook/origin when used).
 4. **Ranked table** — **only rows that change a decision**. Prefer **3–6** hard rows.
 
-| # | Kind | Finding | Evidence (path) | Así te lo re-soluciono | Success signal | Next skill / command |
+| # | Kind | Finding | Evidence (path) | How to fix | Success signal | Next skill / command |
 
 Kinds: `risk` | `false-green` | `debt` | `opportunity` | `shape` | `manifiesto` | `agent-dx` | `design-weak`
 
-**Así te lo re-soluciono** must be concrete: files to touch, command to run.  
+**How to fix** must be concrete: files to touch, command to run.  
 **Success signal** must be falsifiable (see §F).
 
 5. **Field path summary**.

package/templates/skills/ark-fix.md

@@ -5,7 +5,7 @@ description: Shortcut to /ark-autopilot for a small violation cluster. Deprecate
 
 # /ark-fix — Shortcut to /ark-autopilot
 
-**Deprecated as a first-class door.** Gate violations and judgment remediations are
+**Not a first-run door.** This leftover name is a shortcut. Gate violations are
 **`/ark-autopilot`**. Do that job now. CLI only validates.
 
 ## Autonomy contract

package/templates/skills/ark-loop.md

@@ -5,7 +5,7 @@ description: Shortcut to /ark-autopilot for driving plan A to zero. Deprecated a
 
 # /ark-loop — Shortcut to /ark-autopilot
 
-**Deprecated as a first-class door.** Driving `--plan` to `goal.met` is **`/ark-autopilot`**.
+**Not a first-run door.** This leftover name is a shortcut. Driving `--plan` to `goal.met` is **`/ark-autopilot`**.
 Do that job now. Auto-apply only the four `mechanical-safe` kinds; judgment you write.
 
 ## Autonomy contract

package/templates/skills/ark-place.md

@@ -5,6 +5,15 @@ description: "Where does new code go? Names the layer, directory, and naming for
 
 # /ark-place — Where does this code go?
 
+**When:** you are adding a new file or artifact and need the layer, folder, and name.
+**Not when:** session 0 / config is missing or lying (`/ark-adopt`) or an existing violation cluster (`/ark-autopilot`).
+
+## Steps
+
+1. Bind identity if using MCP (`ark_identity` with the exact project root).
+2. Place the file (`ark_place` or read `ark.config.json`).
+3. Write it there. Then `arkgate-check`.
+
 ## Autonomy contract
 
 Invoking this skill **is** the approval. If the user described an artifact, **write the
@@ -155,7 +164,7 @@ the same files or weaken the gate.
 
 - If the user needs bulk adoption / wrong config, not a single artifact: **STOP — do not continue this skill as complete.** Switch to **`/ark-adopt`** (write the path) instead of ad-hoc multi-file grinding without a plan.
 - If the config lacks a home for the artifact: add the layer **in this turn**, then write the file.
-- If doctor is **ENFORCE · design-weak** and the user is asking to reshape existing structure
+- If doctor shows leftover design work and the user is asking to reshape existing structure
   (not place one new artifact): place only the new file under the golden/contract home, then
   hand off **one** pilot via `pilotLoop.nextPilot` / `/ark-explore` shape-focus — never multi-pilot
   batch reshape from this skill.

package/templates/skills/ark-think.md

@@ -5,8 +5,9 @@ description: Host-side architectural reasoning — 2–3 enforceable options on
 
 # /ark-think — Architectural reasoning (host LLM only)
 
-**Shortcut.** One decision only. Full map → **`/ark-explore`**. Apply → **`/ark-autopilot`**.
-Session 0 → **`/ark-adopt`**.
+**Not a first-run door.** One decision only. Session 0 → **`/ark-adopt`**.
+Full map → **`/ark-explore`**. Apply → **`/ark-autopilot`**.
+Do not send the user to leftover `/ark-contract` or `/ark-fix`.
 
 You are the user's architecture thinking partner **inside** the project's Ark contract.
 This skill does **not** call any LLM API from the arkgate package. **You** (the host agent)

package/templates/skills/ark-upgrade.md

@@ -5,9 +5,16 @@ description: Upgrade ArkGate through a content-identity preview, preserve custom
 
 # /ark-upgrade — managed ArkGate upgrade
 
-Upgrade the published `arkgate` package and its managed gates without treating a
-filename, package version, or similar-looking file as proof of ownership. The
-preview is the source of truth: inspect it before applying anything.
+**When:** bump the published `arkgate` package and refresh managed gates.
+**Not when:** session 0 (`/ark-adopt`) or leftover design (`/ark-explore`).
+
+## Steps
+
+1. Preview: `arkgate upgrade` (no writes).
+2. Apply in this turn: `arkgate upgrade --apply` (needs `--plan-digest` when applying managed files).
+3. Re-run `arkgate-check --doctor`. Customized files stay unless you pass `--accept-conflicts` / `--refresh-skills`.
+
+The preview is the source of truth. Do not treat a filename or package version as proof of ownership.
 
 ## Autonomy contract