arkgate 4.6.0 → 4.6.2

package/templates/skills/ark-contract.md

@@ -1,40 +1,24 @@
 ---
 name: ark-contract
-description: Safely edit ark.config.json layers/rules and arkrules/* (structure + invariants); land business rules under the dual plane. Validated with strict ark-check. Deep source evidence required.
+description: Shortcut to /ark-adopt (session 0) or /ark-autopilot (later config tighten). Deprecated as a first-class door.
 ---
 
-# /ark-contract — Change the architecture contract (safely)
+# /ark-contract — Shortcut to adopt / autopilot
 
-## Improvement compass (process preflight)
+**Not a first-run door.** This leftover name is a shortcut. Writing `ark.config.json` is
+**`/ark-adopt`** at session 0 and **`/ark-autopilot`** afterward. Do that job now.
 
-When doctor is available, read `doctor.improvementCompass` (or the human **Improvement compass** section).
-Name 1–3 **residual** lenses in plain language before skill-shopping. Always `notAScore` — never invent
-0–10 scores or Excellent/Good ranks.
+## Autonomy contract
 
-**What the user should feel next:** fewer blocked AI writes, clearer folders, safer domain — then jargon.
-
-**Anti false-done:** empty plan A + residual lenses / design-weak → **Incomplete? yes**. Green edges alone
-are not “architecture finished.”
-
-**AI-easy architecture:** ports over concrete I/O in domain; one concern per module; golden pattern for
-new files; place before write (`/ark-place` / prepare-write).
-
-**Out of scope (honest):** scalability/performance, full app-security tooling (SAST), and full resilience
-patterns are **out-of-scope** lenses — say so; do not invent Ark enforcement for them.
-
-**Contract edits are last resort.** Policy-delta honesty; do not weaken rules to clear compass residual.
+Invoking this leftover name **is** the approval to write an honest config. Do not
+preview-only. Never weaken the architecture config.
 
 ## When / not when
 
-| Use `/ark-contract` when… | Do **not** use it when… |
-|---------------------------|-------------------------|
-| Edit layers/rules/includes/intents with source evidence | Move product code without config change → `/ark-fix` / `/ark-loop` |
-| Concentrated-edge / false-green STOP from other skills | Full map without config edit → `/ark-explore` |
-
-The **one sanctioned way** to change layers/rules/`intentPrefixes`/includes.
-Also used to **land mined business rules** into the executable manifest (`ark.config.json` +
-intent naming that the project-bound `ark_manifest` tool exposes authoritatively).
-
+| Use this leftover name when… | Prefer instead |
+|------------------------------|----------------|
+| Layers / include / ArkRules need an edit | **`/ark-adopt`** (path) or **`/ark-autopilot`** (tighten) |
+| False-green / concentrated edge | **`/ark-adopt`** — write the honest config |
 
 ## Dual engine (mandatory)
 
@@ -45,8 +29,6 @@ intent naming that the project-bound `ark_manifest` tool exposes authoritatively
 
 The CLI is a **sensor**, never the whole job. Claiming done without the exploratory bar for this skill is **incomplete**.
 
-
-
 ## MCP workspace binding (mandatory)
 
 Before any `ark_*` MCP tool, call `ark_identity` with `project.expectedRoot` set to the exact
@@ -58,90 +40,27 @@ restart/retargeting is required. `ark://manifest` never satisfies this preflight
 
 ## Dual plane — layers + ArkRules (mandatory, except /ark-runtime)
 
-ArkGate has **two opt-in planes**. The user chooses which to use; you **always label** findings so they never blur.
-
-| Plane | What it protects | Where it lives | Sensors / tools |
-|-------|------------------|----------------|-----------------|
-| **Layers** (inter-layer) | Who may import whom, capabilities, pure/forbiddenGlobals, peerIsolation | `ark.config.json` → `layers[]`, `rules[]` | graph check, baseline edges, doctor coverage % |
-| **ArkRules** (intra-layer) | Structure inside a layer + domain invariants as data | `arkRules` map + `arkrules/<ExactLayerName>.json` | structure sensors, invariant coverage, `--rules-inventory`, doctor `rulesUnderContract` |
-
-**Rules for every report / answer:**
-1. Prefix each finding or next step with **`[Layer]`** or **`[ArkRules]`** (or a two-column table with those headers).
-2. Never call an import-edge violation an “invariant” or an aggregate sensor a “layer deny.”
-3. Absence of `arkRules` is **valid** — do not force ArkRules unless the user wants them or residual inventory clearly wants a pilot.
-4. Editing `arkrules/*` or promoting modes is **`/ark-contract`**; fixing code under a structure sensor is **`/ark-fix`** / **`/ark-loop`** (judgment, never invent mechanical-safe).
-5. CLI helpers: `ark-check --rules-inventory --json`, doctor JSON `rulesUnderContract`, sensors emit `ARKRULE_*` / `INVARIANT_UNCOVERED` with `evidence.arkruleId`.
-
-
-### Contract + ArkRules
-- You own **both** `layers/rules` and `arkRules`/`arkrules/*.json`.
-- Report diffs in two blocks: **[Layer] config** and **[ArkRules] files**.
-- Promotion ladder: advisory→enforced only with coverage; demote = hash-ack weakening.
+Label findings **`[Layer]`** vs **`[ArkRules]`**. Absence of `arkRules` is valid.
 
 ## Subagent fan-out (optional, host-dependent)
 
-If the host supports **parallel subagents** and the task splits cleanly (e.g. multiple
-dirs to sample), fan out read-only scouts; otherwise **fall back to sequential**.
-Parent merges and still emits the **### Completion** contract. Never parallel-write
-the same files or weaken the gate.
+If the host supports **parallel subagents**, fan out read-only scouts; otherwise
+**fall back to sequential**. Never weaken the gate.
 
 ## Related onboarding
 
-- **Greenfield:** `/ark-architect` or `ark-check --recommend` / `ark start`.
-- **Brownfield:** `/ark-adopt` — match contract to reality; do not force a starter preset.
-- **Default path:** `ark start` → `/ark-autopilot` → `ark-check --doctor`.
-
-## Anti-wrapper rule (mandatory)
-
-**Forbidden:** editing globs from vibes without reading the directories those globs claim to cover.
-
-**Required:**
-1. Snapshot before using CLI as **sensor**: coverage + check JSON.
-2. **Read source** in dirs you reclassify (sample files).
-3. **“Así te lo re-soluciono”** — exact JSON fields + which files become governed/ungoverned.
-4. After write: `ark-check --strict-config` must be the validation gate (dead pattern noise is advisory; unclassified + real violations still matter).
-
-## What you may edit
-
-- `include` / `exclude`
-- `layers[]` (`name`, `patterns`, `optional`, `forbiddenGlobals`, `intentPrefixes`, layer `exclude`)
-- `rules[]` (from/to/allowed)
-- **`arkRules` map + `arkrules/<Layer>.json`** (ADR 0012/0014) — structure sensors + invariant catalog;
-  promote advisory→enforced only with coverage evidence; demote/delete requires hash-bound policy ack
-- Never: disable the check, delete CI gates, or add blanket `allowed: true` for a bad edge without a facade design
+- **Greenfield:** `/ark-adopt` or `ark-check --recommend` / `ark start`.
+- **Brownfield:** `/ark-adopt` — match config to reality.
 
 ## Steps
 
-1. **Snapshot** — coverage governed%, unclassified samples, current violations.
-2. **Smallest edit** for the user intent:
-   - New layer + neighbor rules
-   - Expand patterns for ungoverned dirs (`suggestions` from coverage)
-   - Facade: public surface patterns more specific than internals
-   - **Business rules → manifiesto:**
-     - Add/adjust `intentPrefixes` (`Domain.`, `Application.`, …)
-     - Point Domain patterns at real pure folders (`**/domain/**`, not bare `**/types.ts`)
-     - Document proposed intent names for the app to register (kernel) or for agents to use
-3. **Impact** — re-run coverage/check; report before/after governed% and violation delta.
-4. **Rollback** if strict fails for reasons other than pre-existing debt the user accepted.
-
-## Operating modes
-
-Contract edits are most common in **Align (Adapt)**. In **Guard (Enforce)**, treat edits as high-risk product decisions.
-
-## Critical handoffs
-
-- After contract is honest but residual violations remain: **STOP — do not continue this skill as complete.** **STOP — bulk residual debt: invoke /ark-loop or /ark-autopilot** instead of ad-hoc multi-file grinding without a plan.
-- New artifact home after reclassify: **STOP — do not continue this skill as complete.** **STOP — new file placement: invoke /ark-place** when the user needs a new artifact home.
-
-## Done
-
-- Diff of `ark.config.json` explained in plain language.
-- **Así te lo re-soluciono en el manifiesto** when intents/Domain were part of the request.
-- Strict check result captured.
+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`.
 
 ## Completion contract (skill incomplete if missing)
 
-End with **exactly** these headings (markdown `###`):
+Skill incomplete if missing any field below.
 
 ### Completion
 - **Sensor:** commands/tools run
@@ -149,8 +68,5 @@ End with **exactly** these headings (markdown `###`):
 - **Result:** one-line outcome
 - **Planes:** one-line split of residual **[Layer]** vs **[ArkRules]** (or `n/a` if unused)
 - **Compass:** top residual lenses | `n/a`
-- **Handoff:** `/ark-…` / CLI / `none`
+- **Handoff:** `/ark-adopt` / `/ark-autopilot` / `none`
 - **Incomplete?** `no` | `yes — <what is missing>`
-
-If a **STOP** handoff applies and you continued as if done, set **Incomplete?** to `yes`.
-**Skill incomplete if missing** any of the bullets above.

package/templates/skills/ark-coverage.md

@@ -5,6 +5,10 @@ description: Ark adoption fitness audit — governed%, gates, baseline honesty,
 
 # /ark-coverage — Ark adoption fitness (not full recon)
 
+**Not a first-run door.** Fitness numbers only (governed files, gates, baseline).
+Session 0 → **`/ark-adopt`**. Leftover design → **`/ark-explore`**. Apply → **`/ark-autopilot`**.
+Do not send the user to leftover `/ark-contract` or `/ark-fix`.
+
 You audit **how this repo uses ArkGate** (coverage, gates, baseline, host write path) and
 what adoption gaps remain. Work autonomously. End with a ranked fitness report.
 
@@ -53,7 +57,7 @@ patterns are **out-of-scope** lenses — say so; do not invent Ark enforcement f
 2. **Product surface** — name the app/package(s) in one line (not a full recon).
 3. **Read real source** in the top ungoverned / high-risk clusters (minimum **10 files**
    across at least **4 directories**). Prefer domain, features, adapters, routes — not only config.
-4. **“Así te lo re-soluciono”** for adoption gaps (globs, install, baseline, intents).
+4. **“How to fix”** for adoption gaps (globs, install, baseline, intents).
 5. If plan A is empty but you see design-weak / concurrent patterns / god modules:
    list them briefly and **STOP — do not continue this skill as complete** for pattern work —
    **handoff `/ark-explore` (dual-plan seed or shape-focus)**. Do not invent a second explore report here.
@@ -156,7 +160,7 @@ because governed% is 100% and plan is empty.
 2. **Adoption map** — clusters you read for *fitness* (paths) — keep short.
 3. **Ranked table** (adoption residual + install/capability opportunities)
 
-| # | Kind | Gap / opportunity | Evidence (path or CLI) | Así te lo re-soluciono (concrete) | Next |
+| # | Kind | Gap / opportunity | Evidence (path or CLI) | How to fix (concrete) | Next |
 
 Kinds: `debt` | `false-green` | `shape` | `manifiesto` | `gates` | `opportunity` | `design-weak`
 
@@ -166,7 +170,7 @@ Kinds: `debt` | `false-green` | `shape` | `manifiesto` | `gates` | `opportunity`
 ## Done criteria
 
 - ≥10 source files read and cited; product surface named.
-- At least one **Así te lo re-soluciono** block with real paths or install commands.
+- At least one **How to fix** block with real paths or install commands.
 - CLI numbers used as evidence, not as the whole report.
 - Design residual either absent with evidence or explicitly handed to `/ark-explore`.
 

package/templates/skills/ark-explain.md

@@ -5,6 +5,10 @@ description: Explain this project's architecture in plain language and generate
 
 # /ark-explain — Understand this project's architecture
 
+**Not a first-run door.** Teach / HTML tour only. Session 0 → **`/ark-adopt`**.
+Map → **`/ark-explore`**. Apply → **`/ark-autopilot`**.
+Do not send the user to leftover `/ark-contract` or `/ark-fix`.
+
 The user wants to understand the architecture, a specific rule, or why the gate blocked them.
 
 ## Improvement compass (process preflight)
@@ -31,7 +35,7 @@ patterns are **out-of-scope** lenses — say so; do not invent Ark enforcement f
 | Use `/ark-explain` when… | Do **not** use it when… |
 |--------------------------|-------------------------|
 | Plain-language tour of layers/rules/report | Decision-grade recon / dual-plan → `/ark-explore` |
-| “Why did the gate block me?” pedagogy | Apply fixes → `/ark-fix` / `/ark-autopilot` |
+| “Why did the gate block me?” pedagogy | Apply fixes → `/ark-autopilot` |
 | Generate / walk HTML showcase report | Fitness numbers only → `/ark-coverage`; brownfield action → `/ark-adopt` |
 Your job is to **teach with this repo's real data** and leave a shareable visual artifact.
 
@@ -68,7 +72,7 @@ ArkGate has **two opt-in planes**. The user chooses which to use; you **always l
 1. Prefix each finding or next step with **`[Layer]`** or **`[ArkRules]`** (or a two-column table with those headers).
 2. Never call an import-edge violation an “invariant” or an aggregate sensor a “layer deny.”
 3. Absence of `arkRules` is **valid** — do not force ArkRules unless the user wants them or residual inventory clearly wants a pilot.
-4. Editing `arkrules/*` or promoting modes is **`/ark-contract`**; fixing code under a structure sensor is **`/ark-fix`** / **`/ark-loop`** (judgment, never invent mechanical-safe).
+4. Editing `arkrules/*` or applying structure fixes is **`/ark-adopt`** / **`/ark-autopilot`** (never invent `mechanical-safe`).
 5. CLI helpers: `ark-check --rules-inventory --json`, doctor JSON `rulesUnderContract`, sensors emit `ARKRULE_*` / `INVARIANT_UNCOVERED` with `evidence.arkruleId`.
 
 
@@ -186,7 +190,7 @@ when residual signals remain.
    - If a DI/kernel framework border exists, explain public surface vs internals.
 3. **If asked about a specific rule or block**, answer with: the rule, the consequence it
    prevents, and the sanctioned fix (usually a port). If they want it fixed now:
-   **STOP — do not continue this skill as complete.** **STOP — fix requested: invoke /ark-fix.**
+   **STOP — do not continue this skill as complete.** **STOP — fix requested:** invoke `/ark-autopilot`.
    This skill stays read-only.
 4. **If asked "what's a port/adapter/saga…"**, two sentences + this-repo example or conventional path.
 
@@ -206,7 +210,7 @@ when residual signals remain.
 
 ## Related
 
-- Onboarding: `/ark-architect`, `ark-check --recommend`, `docs/enthusiast/README.md`
+- Onboarding: `/ark-adopt` (or leftover `/ark-architect`), `ark-check --recommend`, `docs/enthusiast/README.md`
 - Brownfield: `/ark-adopt`, `docs/brownfield-adoption.md`
 - Autopilot: `/ark-autopilot` after the user understands the contract
 

package/templates/skills/ark-explore.md

@@ -1,13 +1,30 @@
 ---
 name: ark-explore
-description: Specialized map skill — decision-grade recon of layers + ArkRules opportunities + dual-plan seed (no apply). Primary post-green door when leftover design work remains. Not the default day-to-day path (use doctor + place/gate; guided apply is /ark-autopilot). CLI is a sensor; you read the tree. No gate bypass.
+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.
 ---
 
 # /ark-explore — Recon the real project (map only)
 
-**Specialized escape**, not the default curriculum. Use when you need a decision-grade map
-or the post-green Shape door; hand off to `/ark-autopilot` to apply. Day-to-day place + gate
-work does not require this skill.
+**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
+incomplete. **Do not write** config or product code (that is `/ark-adopt` / `/ark-autopilot`).
+**CLI budget:** one doctor / coverage; then open ≥12 files across ≥4 dirs; then the map.
+
+**Still never:** weaken the config; invent `mechanical-safe` kinds; claim healthy because
+plan A is empty while leftover design work remains.
+
+Use when you need a decision-grade map or the **Primary post-green door**; hand off to
+`/ark-autopilot` to apply. Day-to-day place + gate work does not require this skill.
 
 You are a **staff engineer doing architecture reconnaissance** on *this* repository.
 Ark’s CLI is a **sensor** (coverage, doctor, plan). **You** open source, entry points,
@@ -58,15 +75,15 @@ If the consumer tree has a **domain glossary**, prefer its terms for layer/slice
 
 | Use `/ark-explore` when… | Do **not** use it when… |
 |--------------------------|-------------------------|
-| Map / “what next?” / residual after ENFORCE | User wants edits applied → `/ark-autopilot` or `/ark-fix` |
+| Map / “what next?” / residual after ENFORCE | User wants edits applied → `/ark-autopilot` |
 | **Primary post-green door:** messy / leftover design work / “clarify for AI” | Skill-shopping coverage or think for the same leftover work |
 | Spaghetti brownfield: patterns concurrent, design-weak under green check | Only “governed% + gates installed?” numbers → `/ark-coverage` |
 | Dual-plan **seed** (A remediation + B pattern bets) without applying | One design trade-off between 2–3 options already mapped → `/ark-think` |
 | Path-correct vs design-correct honesty | Plain-language tour / HTML report → `/ark-explain` |
 
 **Post-green single path:** when doctor `postGreenPath` / ENFORCE · leftover design work is active, **this skill
-(shape-focus / dual-plan seed) is the map half of the one door** — then `/ark-autopilot` only
-to apply B with user OK. Do not send the user to coverage or think as equal first choices.
+(shape-focus / dual-plan seed) is the map half of the one door** — then `/ark-autopilot`
+applies one B pilot. Do not send the user to coverage or think as equal first choices.
 
 ### Status lights (rank residual; not settings)
 
@@ -82,8 +99,8 @@ to apply B with user OK. Do not send the user to coverage or think as equal firs
 
 ## Related onboarding
 
-- **Greenfield / thin tree:** `/ark-architect` or `ark-check --recommend` / `ark start`.
-- **Brownfield action (write contract/baseline):** `/ark-adopt` after the map.
+- **Greenfield / thin tree:** `/ark-adopt` or `ark-check --recommend` / `ark start`.
+- **Brownfield action (write config/baseline):** `/ark-adopt` after the map.
 - **Execute dual plan:** `/ark-autopilot` (explore seeds; autopilot applies A, proposes B).
 - **Default path:** `ark start` → `ark-check --doctor` → `/ark-autopilot` for guided apply; use this skill for map-only or post-green Shape residual.
 
@@ -129,7 +146,7 @@ ArkGate has **two opt-in planes**. The user chooses which to use; you **always l
 1. Prefix each finding or next step with **`[Layer]`** or **`[ArkRules]`** (or a two-column table with those headers).
 2. Never call an import-edge violation an “invariant” or an aggregate sensor a “layer deny.”
 3. Absence of `arkRules` is **valid** — do not force ArkRules unless the user wants them or residual inventory clearly wants a pilot.
-4. Editing `arkrules/*` or promoting modes is **`/ark-contract`**; fixing code under a structure sensor is **`/ark-fix`** / **`/ark-loop`** (judgment, never invent mechanical-safe).
+4. Editing `arkrules/*` or applying structure fixes is **`/ark-adopt`** / **`/ark-autopilot`** — explore does not write (never invent `mechanical-safe`).
 5. CLI helpers: `ark-check --rules-inventory --json`, doctor JSON `rulesUnderContract`, sensors emit `ARKRULE_*` / `INVARIANT_UNCOVERED` with `evidence.arkruleId`.
 
 
@@ -300,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):
 
@@ -333,8 +350,8 @@ Empty plan A + design-weak is **not** architecture finished. Plan B is judgment
 | 1. Confirm residual | `designFitness.designWeak` **or** non-empty `patternBets` / `designSmells` | You would claim healthy finished because plan A is empty |
 | 2. Pick **one** pilot | `pilotLoop.nextPilot` (preferred) **or** one ranked B bet with a path scope | Multi-pilot batch / “fix all smells this PR” |
 | 3. Write extraction card | Pilot · Smell · Move · Do not · Success · **Kill-switch** · Next | Missing kill-switch or success signal |
-| 4. User OK | Explicit approval before edit (or stay map-only) | Silent auto-apply of plan B |
-| 5. Apply **only** that pilot | Via `/ark-autopilot` (apply B) or `/ark-fix` (one cluster) | Opening a second pilot before re-doctor |
+| 4. Stay map-only here | Explore does not edit | Silent auto-apply of plan B |
+| 5. Apply **only** that pilot | Via `/ark-autopilot` (one cluster) | Opening a second pilot before re-doctor |
 | 6. Re-doctor | Success = reduced evidence on pilot paths; residual outside pilot may remain | Declaring whole-tree done from one pilot |
 
 **Hard lines (never break):**
@@ -356,7 +373,7 @@ Do not:
   - open a second pilot before re-doctor
 Success: <observable / falsifiable — re-doctor>
 Kill-switch: <stop condition — e.g. if pilot does not clear smell evidence in 1 PR → stop / re-map>
-Next: /ark-autopilot (apply with user ok) | /ark-fix (one cluster) | re-doctor
+Next: /ark-autopilot (apply one pilot) | re-doctor
 ```
 
 When doctor JSON is available, prefer smell `id`s from `designSmells` / `patternBets[].smellId`
@@ -366,24 +383,24 @@ 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**.
 6. **Top 3 bets** — first bet = highest leverage residual, even when plan A is empty (design-correct / agent-dx / field honesty — **not** “run loop on zero steps”).
-   On false-green dominant: **STOP — do not continue this skill as complete.** **STOP — false-green: invoke /ark-adopt or /ark-contract before claiming ENFORCE.** Do not claim goal.met / ENFORCE from type-only cleanup while doctor reports `contract-false-green-io-under-application`.
-   On concentrated edge dominant: **STOP — do not continue this skill as complete.** **STOP — concentrated edge: invoke /ark-contract with source evidence** (do not freeze a wrong contract or grind N freezes).
+   On false-green dominant: **STOP — do not continue this skill as complete.** **STOP — false-green:** name the honesty gap; next door is `/ark-adopt` (write). Do not claim goal.met / ENFORCE from type-only cleanup while doctor reports `contract-false-green-io-under-application`.
+   On concentrated edge dominant: **STOP — do not continue this skill as complete.** **STOP — concentrated edge:** name the config smell with source evidence; next door is `/ark-adopt` (do not freeze a wrong config or grind N freezes).
 7. **Dual-plan seed** — required in dual-plan seed / shape-focus (and when §G auto-upgrades); A + B cap 3–5; extraction cards for I/O bets.
-8. **Deterministic residue** — plan completeness, steps, violations, doctor top action. Point to `/ark-loop` / `/ark-fix` **only when A steps exist**; never call a `partial`/`unavailable` plan met, and never pretend loop is the architecture story when a complete goal is already met.
+8. **Deterministic residue** — plan completeness, steps, violations, doctor top action. Point to `/ark-autopilot` **when A steps exist**; never call a `partial`/`unavailable` plan met, and never pretend an empty plan is the architecture story when leftover design remains.
 
 Optional: **Diff vs naive sensor-only read** (what reading the tree changed).
 
@@ -397,7 +414,7 @@ Optional: **Diff vs naive sensor-only read** (what reading the tree changed).
 - When §G fires: phase named, design smells listed with paths, dual-plan B or shape-focus B present.
 - Every Top-3 / B bet has a **success signal**; new-layer bets have a **kill-switch** + pilot.
 - Mode respected: no multi-week roadmap in recon mode; dual-plan seed capped at 3–5 B bets.
-- Clear handoff: `/ark-adopt` | `/ark-contract` | `/ark-autopilot` | `/ark-loop` | `/ark-fix` | CLI | `stop`.
+- Clear handoff: `/ark-adopt` | `/ark-autopilot` | `/ark-place` | CLI | `stop`.
 - No gate weakening; no false ENFORCE claim; no README echo as primary content.
 
 ## Completion contract (skill incomplete if missing)