ultimate-pi 0.22.0 → 0.22.1

package/.agents/skills/harness-context/SKILL.md

@@ -8,7 +8,7 @@ description: Compile task-specific harness context using context-mode and graphi
 ## When to use
 
 - Preparing context for `/harness-plan`, `/harness-run`, or `/harness-auto`
-- Navigating harness-related code and ADRs without reading entire repos
+- Navigating harness-related code and governance decisions without reading entire repos
 
 ## Mandatory: context-mode only
 
@@ -25,7 +25,7 @@ Use these in rough priority order — not every tool on every task:
 | Structural code patterns | `sg -p '…'` (ast-grep) |
 | Semantic implementation search | `ccc search` (harness pre-indexes before subprocess spawns) |
 | File detail | context-mode maps/signatures, then targeted reads |
-| Harness governance | `.pi/harness/docs/adrs/README.md` |
+| Harness governance | approved policies and decision logs in the target project |
 
 For `/harness-plan` Phase 1, parent compiles findings into `artifacts/planning-context.yaml` — see **harness-plan** skill.
 
@@ -33,7 +33,7 @@ For `/harness-plan` Phase 1, parent compiles findings into `artifacts/planning-c
 
 Compact context block:
 
-- Relevant ADRs (ids + one-line decision)
+- Relevant governance decisions (id/title + one-line decision)
 - Extension entry points (policy-gate, trace-recorder, harness-telemetry)
 - Schema versions in play
 

package/.agents/skills/harness-debate-plan/SKILL.md

@@ -5,7 +5,7 @@ description: Plan-phase Review Gate debate — pi-messenger threads, lane YAML,
 
 # harness-debate-plan
 
-**Practice map:** `.pi/harness/docs/practice-map.md` (Review Gate RACI).
+Review Gate RACI: parent is chair; lane agents provide structured evidence in sequence.
 
 Use when running **Phase 5** of `/harness-plan` — **Fagan-style structured inspection** per focus (`spec` | `wbs` | `schedule` | `quality`). Parent is **chair**; within-round dialogue (claims → rebuttals → clarifications → counters → integrate).
 
@@ -78,4 +78,4 @@ Resume: `harness_debate_round_status({ round_index: N })` → run listed `next_t
 
 Do not `approve_plan` on `policy_decision: block`. On `human_required` → `ask_user` first.
 
-Rubrics: `.pi/harness/docs/planning-rubrics.md`.
+Rubrics: use the focus-specific checklist ids passed by the parent for the active round.

package/.agents/skills/harness-decisions/SKILL.md

@@ -67,7 +67,7 @@ Use during **`/harness-plan` Phase 0** only. Purpose: disambiguate the **task**
   "options": [
     { "title": "Harness contract only", "description": "Changes under .pi/harness and prompts; harness-verify passes" },
     { "title": "End-to-end feature", "description": "User-visible behavior + tests in the app repo" },
-    { "title": "Docs / ADR only", "description": "No runtime code changes" }
+    { "title": "Docs / decision-record only", "description": "No runtime code changes" }
   ],
   "allowFreeform": true
 }
@@ -94,7 +94,7 @@ Use **`questions[]`** when ≥2 independent dimensions must be resolved together
 ```json
 {
   "question": "Lock the task contract before reconnaissance",
-  "context": "Phase 0 (ADR 0053). Answer both forks to set scope and acceptance.",
+  "context": "Phase 0 task-clarification gate. Answer both forks to set scope and acceptance.",
   "questions": [
     {
       "title": "Scope surface",

package/.agents/skills/harness-eval/SKILL.md

@@ -9,4 +9,4 @@ description: >-
 
 Use **`harness-review`** skill and **`/harness-review`** instead.
 
-The master command runs benchmark + policy verdict (+ adversary unless `--quick`) with `submit_eval_verdict` / `submit_adversary_report` and parent `harness_artifact_ready` gates (ADR 0037, ADR 0039).
+The master command runs benchmark + policy verdict (+ adversary unless `--quick`) with `submit_eval_verdict` / `submit_adversary_report` and parent `harness_artifact_ready` gates.

package/.agents/skills/harness-git-commit/SKILL.md

@@ -67,6 +67,6 @@ Edit project file to change format or co-author for external repos.
 
 ## References
 
-- ADR 0055 — `.pi/harness/docs/adrs/0055-auto-commit-coauthor-lifecycle.md`
+- Auto-commit lifecycle policy: use bootstrap + commit CLI so co-author and message format stay consistent.
 - Scripts — `harness-git-commit.mjs`, `harness-auto-commit-bootstrap.mjs`
 - Library — `.pi/lib/harness-auto-commit-config.mjs`

package/.agents/skills/harness-governor/SKILL.md

@@ -14,10 +14,10 @@ description: Enforce harness governance phases, policy gates, budgets, and promo
 ## Workflow
 
 1. Read current phase from `/harness-policy-status` or session `harness-policy-state`.
-2. Check ADRs: constitution (0001), eval promotion (0003), Sentrux (0006), drift (0007), rules lifecycle (0009), AGT policy (0046), AGT security layers (0047).
+2. Check governance policies: phase constitution, eval promotion rules, Sentrux requirements, drift handling, rules lifecycle, and AGT policy/security layers.
 3. Tool allow/deny is enforced by AGT `PolicyEngine` + `.pi/harness/policies/*.yaml` (parent `policy-gate`, subprocess `harness-subagent-governance`). Disable with `HARNESS_AGT_POLICY=0`. Audit: `.pi/harness/runs/<run_id>/agt-audit.jsonl`.
 4. For promotion: require eval pass, no abort lock, debate consensus if escalated, Sentrux when `HARNESS_SENTRUX_REQUIRED=true` (`artifacts/sentrux-signal.yaml` from `/harness-run`, not executor self-report).
-5. **Intent vs observation:** Sentrux manifest changes → `/harness-sentrux-steward` + chair + ADR when material, then `sentrux-rules-sync --force`. Naming manifest changes → `/harness-ls-lint-steward` + chair, then `ls-lint-rules-sync --force`. CLI degradation after execute → fix paths or replan — do not tune manifest on a single noisy run.
+5. **Intent vs observation:** Sentrux manifest changes → `/harness-sentrux-steward` + chair + formal decision record when material, then `sentrux-rules-sync --force`. Naming manifest changes → `/harness-ls-lint-steward` + chair, then `ls-lint-rules-sync --force`. CLI degradation after execute → fix paths or replan — do not tune manifest on a single noisy run.
 6. After approved Sentrux edits: `harness-sentrux-bootstrap.mjs --force` or `/harness-sentrux-sync`; emit `harness-architecture-changed`. After naming edits: `harness-ls-lint-bootstrap.mjs --force` or `/harness-ls-lint-sync`; emit `harness-naming-changed`.
 7. Run `node "$UP_PKG/.pi/scripts/harness-verify.mjs"` before claiming release readiness (includes AGT policy doctor).
 
@@ -30,13 +30,13 @@ When refining plans from noisy requirements:
 3. When gates return `human_required` or promotion is blocked, the orchestrator calls `ask_user` — do not guess scope.
 4. Reference graphify wiki or `graphify query` for architecture constraints before execute.
 
-## Budgets (ADR 0038)
+## Budgets
 
 - Default: **`HARNESS_BUDGET_ENFORCE` off** — token/debate caps are telemetry-only (`harness-budget-telemetry`, `harness-budget-soft-limit`). They do **not** block phases or debate lanes.
 - Do **not** skip reconnaissance artifacts (`planning-context.yaml`), debate rounds, or `approve_plan` because of soft budget hints in the widget.
 - Re-enable hard caps only with `HARNESS_BUDGET_ENFORCE=1` and `HARNESS_BUDGET_HARD_STOP` / `HARNESS_DEBATE_HARD_STOP`.
 
-## Subagent artifacts (ADR 0037)
+## Subagent artifacts
 
 - Subagents call scoped **`submit_*`** tools; parent verifies with **`harness_artifact_ready`**, not JSON parsing from `finalOutput`.
 - Parent **`write_harness_yaml`** is for merges (`research-brief.yaml`, plan shell) — not subagent payloads.
@@ -44,4 +44,4 @@ When refining plans from noisy requirements:
 ## Rules
 
 - Never auto-merge; harness-auto may open PR only when all gates pass (see release-readiness-report).
-- Do not invoke posthog-analyst in Phase 2 (ADR 0005).
+- Do not invoke posthog-analyst in Phase 2.

package/.agents/skills/harness-ls-lint-setup/SKILL.md

@@ -20,7 +20,7 @@ description: Bootstrap ls-lint filename rules for harness projects — seed nami
 | **Sync** | `ls-lint-rules-sync.mjs`, `/harness-ls-lint-sync` | Regenerates `.ls-lint.yml` from manifest after intent change |
 | **Observation** | `/harness-run`, `/harness-review` | `harness-ls-lint-cli.mjs` → `artifacts/ls-lint-signal.yaml` |
 
-Never auto-sync manifest from directory trees. Material manifest edits need steward evidence + chair approval (ADR 0052).
+Never auto-sync manifest from directory trees. Material manifest edits need steward evidence + chair approval.
 
 ## Canonical layout
 
@@ -54,6 +54,6 @@ Custom YAML **outside** `# --- harness:managed:start/end ---` is preserved on ev
 
 ## References
 
-- ADR 0052 — `.pi/harness/docs/adrs/0052-ls-lint-naming-lifecycle.md`
+- Naming lifecycle policy: steward proposal + chair approval before material manifest changes.
 - Scripts — `ls-lint-rules-sync.mjs`, `harness-ls-lint-bootstrap.mjs`, `harness-ls-lint-cli.mjs`
 - Agent — `harness/ls-lint-steward`

package/.agents/skills/harness-orchestration/SKILL.md

@@ -8,14 +8,14 @@ description: >-
 
 # Harness orchestration
 
-**Practice map:** `.pi/harness/docs/practice-map.md` · **ADR 0040** · **ADR 0041**.
+Follow the orchestration rules and phase sequence in this skill directly.
 
 ## Team management rules
 
 1. **Parallelism law** — Parallel `tasks` only when outputs are independent inputs to a later merge (implementation ∥ stack). Never parallelize debate lanes or decompose ∥ hypothesis.
 2. **Two-pizza cap per batch** — Max 2 research lanes, 1 optional `planning-context` subagent, 1 executor, 1 debate agent per `subagent` call.
 3. **No redundant thinkers** — Downstream agents read artifacts; do not re-derive.
-4. **Sequential dependency chain** — planning context → decompose → hypothesis → research → author → DAG → debate → approve → execute → **/harness-review** → optional **/harness-steer** loop (ADR 0044).
+4. **Sequential dependency chain** — planning context → decompose → hypothesis → research → author → DAG → debate → approve → execute → **/harness-review** → optional **/harness-steer** loop.
 5. **Path-first parent tools** — `approve_plan`, `create_plan`, `submit_*` via `source_path`, `merge_harness_yaml`, `harness_synthesize_repair_brief`.
 6. **Debate = meeting** — Parent is chair; parallel_probes allows evaluator ∥ adversary per batch.
 7. **Tool intelligence** — Parent uses graphify, sg, ccc, and reads by task need; subprocesses optional.
@@ -41,7 +41,7 @@ Harness subprocesses load **`harness-subagent-submit`** (`PI_HARNESS_SUBPROCESS=
 |---------|---------|
 | `/harness-plan` | Parent: planning context (tools) → decompose → hypothesis → Phase 3.5 artifacts → PlanPacket → eligibility + Review Gate → `approve_plan` + `create_plan` |
 | `/harness-run` | `harness/running/executor` (single worker) |
-| `/harness-review` | Parent verify → `evaluator` benchmark → `evaluator` verdict → `adversary` → optional `tie-breaker` (ADR 0039) |
+| `/harness-review` | Parent verify → `evaluator` benchmark → `evaluator` verdict → `adversary` → optional `tie-breaker` |
 | `/harness-eval` | **Deprecated** → `/harness-review` |
 | `/harness-critic` | **Deprecated** → `/harness-review` |
 | `/harness-auto` | plan per `/harness-plan`; `--quick` skips adversary + tie-breaker in review |
@@ -80,5 +80,5 @@ Then execution-plan-author, DAG gate, debate eligibility, sequential debate roun
 
 ## References
 
-- ADR 0032, ADR 0033, ADR 0040, ADR 0041, `.pi/harness/specs/harness-spawn-context.schema.json`
+- Subagent isolation, submit-tool artifact flow, and spawn-context contract: `.pi/harness/specs/harness-spawn-context.schema.json`
 - `node "$UP_PKG/.pi/scripts/harness-agents-manifest.mjs" --check`

package/.agents/skills/harness-plan/SKILL.md

@@ -5,7 +5,7 @@ description: Agent-native harness plans — lakes/context bundles, planning cont
 
 # harness-plan
 
-**Practice map:** `.pi/harness/docs/practice-map.md` · **ADR 0040** · **ADR 0042** · **ADR 0043**.
+Use this skill's phase order, spawn laws, and artifact contract directly.
 
 ## When to use
 
@@ -21,7 +21,7 @@ description: Agent-native harness plans — lakes/context bundles, planning cont
 
 ## Workflow (parent orchestrator)
 
-1. **Phase 0:** `artifacts/task-clarification.yaml` — investigate (code + web OK), `ask_user` until unambiguous, gate before any planning subagent (**ADR 0053**).
+1. **Phase 0:** `artifacts/task-clarification.yaml` — investigate (code + web OK), `ask_user` until unambiguous, gate before any planning subagent.
 2. **Phase 1:** Compile `artifacts/planning-context.yaml` with tools (default) or optional `planning-context` subagent; inherit Phase 0 grounding.
 3. **Sequential** decompose → gate `artifacts/decomposition.yaml`.
 4. **Sequential** hypothesis (requires decomposition).

package/.agents/skills/harness-review/SKILL.md

@@ -9,7 +9,7 @@ description: >-
 
 # harness-review
 
-**Practice map:** `.pi/harness/docs/practice-map.md` (Monitoring and Controlling: measure → judge → red team).
+Monitoring and Controlling flow: measure → judge → red team.
 
 ## When to use
 
@@ -42,7 +42,7 @@ Pass `sentrux-signal.yaml` path to evaluator `mode: benchmark` spawn context. Ev
 
 ## Rules
 
-- Parent never writes eval/adversary YAML — subprocess `submit_*` only (ADR 0037).
+- Parent never writes eval/adversary YAML — subprocess `submit_*` only.
 - Auto-claim run ownership unless `--readonly`.
 - Disk verdict drives `next_recommended_command` (`resolveCompletionStatuses`).
 

package/.agents/skills/harness-sentrux-repair/SKILL.md

@@ -8,7 +8,7 @@ description: |
 
 # harness-sentrux-repair
 
-Structured structural feedback for ultimate-pi harness (ADR 0052). **OSS CLI only.**
+Structured structural feedback for the harness. **OSS CLI only.**
 
 ## Artifacts (per run)
 

package/.agents/skills/harness-sentrux-setup/SKILL.md

@@ -20,7 +20,7 @@ description: Bootstrap Sentrux architectural rules for harness projects — seed
 | **Sync** | `sentrux-rules-sync.mjs`, `/harness-sentrux-sync` | Regenerates `rules.toml` from manifest after intent change |
 | **Observation** | `/harness-run`, `/harness-review` | `harness-sentrux-cli.mjs gate --save` / `check` / `gate` → `artifacts/sentrux-signal.yaml` |
 
-Never auto-sync manifest from directory trees. Material manifest edits need steward evidence + chair approval (ADR 0009).
+Never auto-sync manifest from directory trees. Material manifest edits need steward evidence + chair approval.
 
 ## Canonical layout
 
@@ -63,7 +63,7 @@ Do **not** copy ultimate-pi's layer paths blindly into unrelated layouts — edi
 
 ## References
 
-- ADR 0009 — `.pi/harness/docs/adrs/0009-sentrux-rules-lifecycle.md`
+- Rules lifecycle policy: manifest is source of truth; bootstrap/sync regenerate rules from approved intent.
 - Scripts — `.pi/scripts/sentrux-rules-sync.mjs`, `harness-sentrux-bootstrap.mjs`, `harness-sentrux-cli.mjs`
 - Agents — `harness/sentrux-bootstrap` (setup), `harness/sentrux-steward` (intent proposals)
 - Specs — `sentrux-manifest-proposal.schema.json`, `sentrux-signal.schema.json`

package/.agents/skills/harness-spec/SKILL.md

@@ -17,7 +17,7 @@ description: Draft or refine harness artifact contracts under .pi/harness/specs.
 2. Edit or add schema under `.pi/harness/specs/`.
 3. Update affected extensions to emit matching custom entries.
 4. Run `node "$UP_PKG/.pi/scripts/harness-verify.mjs"` (see `.pi/scripts/README.md`).
-5. Add or update an ADR under `.pi/harness/docs/adrs/` for breaking changes.
+5. Add or update a formal decision record in the target project's standard decision-log location for breaking changes.
 
 ## Rules
 

package/.agents/skills/harness-steer/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: harness-steer
-description: Post-review repair loop via harness-steer and executor repair mode (ADR 0044).
+description: Post-review repair loop via harness-steer and executor repair mode.
 ---
 
 # harness-steer
@@ -11,4 +11,4 @@ Use after `/harness-review` when `artifacts/review-outcome.yaml` has `remediatio
 2. Set policy phase `execute`; spawn `harness/running/executor` with `mode: repair`.
 3. Always follow with `/harness-review`.
 
-See `.pi/prompts/harness-steer.md` and `.pi/harness/docs/adrs/0044-harness-steer-loop.md`.
+See `.pi/prompts/harness-steer.md` for the steer-loop procedure and guardrails.

package/.agents/skills/posthog-analyst/SKILL.md

@@ -264,7 +264,7 @@ status: complete
 | Medium | ... | ... | ... | ... |
 
 ## Next Steps
-[What to do with these findings. Suggest ADR if recommendations are significant.]
+[What to do with these findings. Suggest a formal decision record update if recommendations are significant.]
 ```
 
 After filing, update `vault/wiki/index.md` (add to analyses if category exists, or note inline), update `vault/wiki/log.md` (append entry at TOP), and update `vault/wiki/hot.md` (add key findings to Recent Context).

package/.agents/skills/sentrux/SKILL.md

@@ -42,7 +42,7 @@ Run from the **target repo root** (where `.sentrux/rules.toml` lives), or prefer
 | CI / pre-commit | `node "$UP_PKG/.pi/scripts/harness-sentrux-cli.mjs" check` | Exit 0 = pass, 1 = violations |
 | Before agent work | `node "$UP_PKG/.pi/scripts/harness-sentrux-cli.mjs" gate --save` | Save session baseline |
 | After agent work | `node "$UP_PKG/.pi/scripts/harness-sentrux-cli.mjs" gate` | Detect degradation vs baseline |
-| Harness run/review capture | `harness-sentrux-report.mjs` + `harness-sentrux-diagnostics.mjs` | Single scan → JSON artifacts (ADR 0052) |
+| Harness run/review capture | `harness-sentrux-report.mjs` + `harness-sentrux-diagnostics.mjs` | Single scan → JSON artifacts |
 | Explore structure | `sentrux` or `sentrux .` | GUI treemap (optional) |
 
 Typical agent loop:
@@ -77,7 +77,7 @@ Custom TOML outside `# --- harness:managed:start/end ---` is preserved on sync.
 | `harness-verify.mjs` | Runs rules sync and Sentrux checks when rules are present |
 | **observation-bus** | Maps `harness-sentrux-signal` custom entries → evaluator observations |
 | **harness-sentrux-repair** skill | Report/diagnostics scripts + `sentrux-repair-advisor` + repair plan artifact |
-| **harness-eval** | Evaluate phase may require a Sentrux quality signal per ADR 0006 |
+| **harness-eval** | Evaluate phase may require a Sentrux quality signal before promotion |
 
 High level: **execute** runs one capture (`sentrux-report.json`, `sentrux-diagnostics.json`, signal v1.1.0); **review** may spawn **sentrux-repair-advisor** (Phase 1b); **steer** merges repair plan into `repair-brief.yaml`. No Sentrux Pro or MCP in Pi sessions.
 
@@ -96,6 +96,6 @@ High level: **execute** runs one capture (`sentrux-report.json`, `sentrux-diagno
 
 ## References
 
-- ADR 0006 — `.pi/harness/docs/adrs/0006-sentrux-dual-layer.md`
-- ADR 0009 — `.pi/harness/docs/adrs/0009-sentrux-rules-lifecycle.md`
+- Quality gate policy: require a structural signal for evaluate/promotion decisions when configured.
+- Rules lifecycle policy: manifest is source of truth; sync rules from manifest after approved intent changes.
 - `CONTRIBUTING.md` — Sentrux quick start

package/.agents/skills/web-retrieval/SKILL.md

@@ -160,4 +160,4 @@ Diagnostics: `python3 "$UP_PKG/.pi/scripts/harness-web.py" status` (JSON).
 | `HARNESS_WEB_HEURISTIC_ANGLES_FILE` | — | Extra heuristic angles YAML |
 | `HARNESS_WEB_FAST_MODEL` / `EXPANDER` / `QUALITY` | — | Web subagent models |
 
-See `.pi/harness/docs/harness-web-search.md` for internals.
+Internal implementation notes are package-maintainer-only; this skill already contains the external-facing operating guidance.

package/.pi/agents/harness/ls-lint-steward.md

@@ -7,7 +7,7 @@ max_turns: 16
 
 You are the **Harness ls-lint Steward** — filesystem **naming intent** governance, not setup or execution.
 
-**Practice:** Architecture governance for path hygiene; integrated change control (PMBOK). See `.pi/harness/docs/practice-map.md` phase 4e.
+**Practice:** Architecture governance for path hygiene; integrated change control (PMBOK).
 
 ## Mission
 
@@ -27,7 +27,7 @@ Read `HarnessSpawnContext` (`run_id`, `run_dir`, `plan_packet_path`, `task_summa
 4. Optional: `node "$UP_PKG/.pi/scripts/harness-ls-lint-cli.mjs"` — cite violation messages only; do not rename files.
 5. Classify proposal:
    - `none` — existing rules cover changes
-   - `tune_rule` — adjust a convention for one path glob (e.g. regex for ADRs)
+   - `tune_rule` — adjust a convention for one path glob (e.g. regex for decision-record filenames)
    - `add_scoped_rule` — new directory-specific rules
    - `add_ignore` — exclude generated or third-party trees
    - `change_global` — repo-wide default convention change (material)
@@ -38,7 +38,7 @@ Call **`submit_ls_lint_manifest_proposal`** before exit with document matching `
 
 - `manifest_patch`: JSON Merge Patch against current manifest (minimal diff).
 - `evidence[]`: at least one entry per non-`none` change; prefer `source: graphify` or `ls-lint`.
-- `adr_required: true` and `adr_draft` when material (`change_global`, new top-level convention).
+- When changes are material (`change_global`, new top-level convention), include the schema fields that mark a formal decision record as required and provide draft decision text.
 - `human_required: true` when `change_class` is not `none` and not a narrow `add_ignore` with clear evidence.
 
 ## Guardrails

package/.pi/agents/harness/planning/decompose.md

@@ -7,7 +7,7 @@ max_turns: 12
 
 You are the **Harness problem-framing agent (Phase 2a — lakes / scope)**.
 
-**Inspection role:** Outcome author (lake-sized units, not ticket WBS). See `.pi/harness/docs/practice-map.md` and ADR 0042.
+**Inspection role:** Outcome author (lake-sized units, not ticket WBS).
 
 ## Mission
 

package/.pi/agents/harness/planning/execution-plan-author.md

@@ -22,7 +22,7 @@ Task summary, `PlanDecompositionBrief`, `PlanHypothesisBrief`, draft scope/accep
 5. **Schedule** — `schedule_metadata.critical_path_work_item_ids` for med/high risk tasks.
 6. **wbs_dictionary** — one line per non-trivial work_item (inputs, outputs, owner role).
 7. **risk_register** — ≥3 risks for med/high with mitigation and trigger.
-8. **sprint_contract** — ADR-020 done_criteria types, checkpoints, definition of done.
+8. **sprint_contract** — explicit done_criteria types, checkpoints, and definition of done.
 9. **Quality left** — verify/lint/test work_items in early phases when risk ≥ med.
 10. **done_criteria** — typed per work_item (build | test | verify | docs | deploy as applicable).
 

package/.pi/agents/harness/planning/hypothesis-validator.md

@@ -5,7 +5,7 @@ thinking: medium
 max_turns: 10
 ---
 
-**Inspection role:** Blind verifier (independent verification; debate R1 only). See `.pi/harness/docs/practice-map.md`.
+**Inspection role:** Blind verifier (independent verification; debate R1 only).
 
 ## Your task
 

package/.pi/agents/harness/planning/hypothesis.md

@@ -7,7 +7,7 @@ max_turns: 14
 
 You are the **Harness planning hypothesis generator (Phase 2b — DARWIN)**.
 
-**Role:** Approach author after WBS (Lean hypothesis-driven planning). Requires `artifacts/decomposition.yaml`. See `.pi/harness/docs/practice-map.md`.
+**Role:** Approach author after WBS (Lean hypothesis-driven planning). Requires `artifacts/decomposition.yaml`.
 
 ## Mission
 

package/.pi/agents/harness/planning/plan-adversary.md

@@ -5,7 +5,7 @@ thinking: medium
 max_turns: 14
 ---
 
-**Inspection role:** Red team (adversarial review). See `.pi/harness/docs/practice-map.md`.
+**Inspection role:** Red team (adversarial review).
 
 ## Your task
 

package/.pi/agents/harness/planning/plan-evaluator.md

@@ -5,13 +5,13 @@ thinking: medium
 max_turns: 14
 ---
 
-**Inspection role:** Inspector (neutral Fagan-style checklist). See `.pi/harness/docs/practice-map.md`.
+**Inspection role:** Inspector (neutral Fagan-style checklist).
 
 ## Your task
 
 Score the ExecutionPlan against Validation Checks for one Review Gate round. Emit stable `checks[]` with ids and messenger-ready `claim_ids`. You are not an advocate for the plan.
 
-Parent passes `debate_round_focus`: `spec` | `wbs` | `schedule` | `quality`. Use rubric ids from `.pi/harness/docs/planning-rubrics.md` for that focus.
+Parent passes `debate_round_focus`: `spec` | `wbs` | `schedule` | `quality`. Use focus-specific rubric ids provided in the spawn context for that focus.
 
 ## Process
 

package/.pi/agents/harness/planning/plan-synthesizer.md

@@ -5,7 +5,7 @@ description: Lake-first plan synthesis for low/med risk — problem framing, hyp
 
 # Plan synthesizer
 
-You produce **lake-sized** outcomes (ADR 0042), not ticket-granularity WBS. Read `artifacts/planning-context.yaml`, research briefs, and prior artifacts from disk paths in `HarnessSpawnContext` — do not re-run graphify when coverage is already ok.
+You produce **lake-sized** outcomes, not ticket-granularity WBS. Read `artifacts/planning-context.yaml`, research briefs, and prior artifacts from disk paths in `HarnessSpawnContext` — do not re-run graphify when coverage is already ok.
 
 ## Outputs (all required on disk)
 
@@ -15,7 +15,7 @@ You produce **lake-sized** outcomes (ADR 0042), not ticket-granularity WBS. Read
 
 ## Rules
 
-- Use **`submit_*({ source_path })`** when drafts exist on disk (ADR 0043); otherwise `document`.
+- Use **`submit_*({ source_path })`** when drafts exist on disk; otherwise `document`.
 - Do not spawn subprocesses; you are the subprocess.
 - Match schemas under `.pi/harness/specs/`.
 - Parent runs `validate-plan-dag.mjs` after merge into `plan-packet.yaml`.

package/.pi/agents/harness/planning/review-integrator.md

@@ -5,7 +5,7 @@ thinking: medium
 max_turns: 12
 ---
 
-**Inspection role:** Recorder / integration PM (round synthesis). Parent is chair. See `.pi/harness/docs/practice-map.md`.
+**Inspection role:** Recorder / integration PM (round synthesis). Parent is chair.
 
 ## Your task
 

package/.pi/agents/harness/planning/sprint-contract-auditor.md

@@ -1,22 +1,22 @@
 ---
-description: Plan-phase ADR-020 sprint contract auditor.
+description: Plan-phase sprint contract auditor.
 extensions: false
 thinking: medium
 max_turns: 12
 ---
 
-**Inspection role:** Definition of Done auditor (sprint contract). See `.pi/harness/docs/practice-map.md`.
+**Inspection role:** Definition of Done auditor (sprint contract).
 
 ## Your task
 
-Audit `execution_plan.sprint_contract` and work_item `done_criteria` against ADR-020 (Sprint Contract, Done Criteria Types, Keep Quality Left).
+Audit `execution_plan.sprint_contract` and work_item `done_criteria` against sprint-contract rules (Done Criteria Types, Keep Quality Left).
 
 Required when `debate_round_focus` is `quality` or round_index ≥ 4. Optional spot-check on round 2 if done_criteria are sparse.
 
 ## Process
 
 1. Read `plan-packet.yaml` execution_plan section and sprint_contract block.
-2. Verify done_criteria types cover: build, test, verify, docs (as applicable per ADR-020).
+2. Verify done_criteria types cover: build, test, verify, docs (as applicable).
 3. List checkpoint gaps between phases (missing verify/lint/test work_items when risk ≥ med).
 4. Flag “quality at end only” plans without explicit risk acceptance in risk_register.
 5. Cross-check integrator disputes from same round if transcript provided — do not contradict without note.
@@ -28,7 +28,7 @@ Before ending, call `submit_sprint_audit` exactly once with the full document. P
 
 ## Guardrails
 
-- Cite ADR-020 rule ids in rationale fields.
+- Cite sprint-contract rule ids in rationale fields.
 - Read-only; parent persists artifact.
 
 Bus label: `SprintContractAuditorAgent`.

package/.pi/agents/harness/running/executor.md

@@ -71,7 +71,7 @@ harness-lens may fix indentation on anchored `edit.text` before apply.
 2. **Read** anchored regions you will change.
 3. **Edit** minimally with batched anchored `edit`.
 
-Never use `replace_symbol`, `rename_symbol`, or similar — use `sg` + anchored edit only ([ADR 0045](.pi/harness/docs/adrs/0045-harness-lens-minimal-contract.md)).
+Never use `replace_symbol`, `rename_symbol`, or similar — use `sg` + anchored edit only.
 
 ## Post-edit verification (before handoff)
 

package/.pi/agents/harness/sentrux-repair-advisor.md

@@ -7,7 +7,7 @@ max_turns: 14
 
 You are the **Harness Sentrux Repair Advisor** — turn measured structural debt into a bounded repair plan for steer/executor.
 
-**Practice:** Fitness-function feedback loop (Ford/Richards); generator–evaluator separation. See `.pi/harness/docs/practice-map.md` phase 4e and ADR 0052.
+**Practice:** Fitness-function feedback loop (Ford/Richards); generator–evaluator separation.
 
 ## Mission
 

package/.pi/agents/harness/sentrux-steward.md

@@ -7,7 +7,7 @@ max_turns: 16
 
 You are the **Harness Sentrux Steward** — architectural **intent** governance, not setup or execution.
 
-**Practice:** Architecture governance + fitness functions (Ford/Richards); integrated change control (PMBOK). See `.pi/harness/docs/practice-map.md` phase 4e.
+**Practice:** Architecture governance + fitness functions (Ford/Richards); integrated change control (PMBOK).
 
 ## Mission
 
@@ -38,7 +38,7 @@ Call **`submit_sentrux_manifest_proposal`** before exit with document matching `
 
 - `manifest_patch`: JSON Merge Patch against current manifest (minimal diff).
 - `evidence[]`: at least one entry per non-`none` change; prefer `source: graphify`.
-- `adr_required: true` and `adr_draft` when material (new layer or boundary affecting multiple agents).
+- When changes are material (new layer or boundary affecting multiple agents), include the schema fields that mark a formal decision record as required and provide draft decision text.
 - `human_required: true` when `change_class` is not `none` and not a single numeric `tune_constraint` with clear sentrux evidence.
 
 ## Guardrails

package/.pi/harness/agents.manifest.json

@@ -1,8 +1,8 @@
 {
 	"schema_version": "1.0.0",
 	"package": "ultimate-pi",
-	"package_version": "0.21.0",
-	"generated_at": "2026-05-27T07:05:16.312Z",
+	"package_version": "0.22.0",
+	"generated_at": "2026-05-27T12:07:19.624Z",
 	"policy_sha256": "799782453e74a1d2d15a28715c985c1b5dc4566701ddcce475ec4725294437e4",
 	"agents": {
 		"pi-pi/agent-expert": {
@@ -51,7 +51,7 @@
 		},
 		"harness/ls-lint-steward": {
 			"path": ".pi/agents/harness/ls-lint-steward.md",
-			"sha256": "e35bf59adf2785e7369a7428793a26691cea43d630e02a9541398cb5a5b1f5dc"
+			"sha256": "abbb43da45a2c9c080cd2043384d481a143acaf440e52b657493425218cb951f"
 		},
 		"harness/sentrux-bootstrap": {
 			"path": ".pi/agents/harness/sentrux-bootstrap.md",
@@ -59,11 +59,11 @@
 		},
 		"harness/sentrux-repair-advisor": {
 			"path": ".pi/agents/harness/sentrux-repair-advisor.md",
-			"sha256": "057618de561d90e597be7a319f3abfa2adaa128d4e92850c50b3e35a447f0371"
+			"sha256": "3c9722806338f680db3d165e633a877e087c1485ad74c2b38781d7ba989b48f0"
 		},
 		"harness/sentrux-steward": {
 			"path": ".pi/agents/harness/sentrux-steward.md",
-			"sha256": "d806cbf2c2e211c6b4c95e35893bc250c8a0fab6fae92190766eab16cd091d51"
+			"sha256": "019740bd4313426edaa36f7fa96471088731abe616282a6e5109e9c538ae34eb"
 		},
 		"harness/trace-librarian": {
 			"path": ".pi/agents/harness/trace-librarian.md",
@@ -95,7 +95,7 @@
 		},
 		"harness/running/executor": {
 			"path": ".pi/agents/harness/running/executor.md",
-			"sha256": "0b602c27f8842af3b1bc702623649de8ba775e77fe59bc156bfabf91b5303d85"
+			"sha256": "e8710179def62a9adaa63ba5b05c3f36dee95da6fd751ef34be773bbee65a5c2"
 		},
 		"harness/reviewing/adversary": {
 			"path": ".pi/agents/harness/reviewing/adversary.md",
@@ -111,19 +111,19 @@
 		},
 		"harness/planning/decompose": {
 			"path": ".pi/agents/harness/planning/decompose.md",
-			"sha256": "ef552be75ff92667e6be90a85768e0804501d00e517b753ca37d174b2561618a"
+			"sha256": "35965f8f8eaa19caee72de1b708178f5ce7bba185f25bed28b9b2ff66c51eaed"
 		},
 		"harness/planning/execution-plan-author": {
 			"path": ".pi/agents/harness/planning/execution-plan-author.md",
-			"sha256": "3b83edca1eb393941e04213c5cabe0e4b180e52df59169ba24904341a369ead5"
+			"sha256": "f0251ac5fb423dda3d6b0b4cff1f63a8e5adfa40806b99454a649c1b0fe3adae"
 		},
 		"harness/planning/hypothesis-validator": {
 			"path": ".pi/agents/harness/planning/hypothesis-validator.md",
-			"sha256": "ee68aa5c04b903320116cfa21cea8f130199fd21e1fd1a8a747830bf53920fdb"
+			"sha256": "70d755da14e146755932c2cb3eb9b828ccd6406b4962d61baeba27c38d9f73dc"
 		},
 		"harness/planning/hypothesis": {
 			"path": ".pi/agents/harness/planning/hypothesis.md",
-			"sha256": "c974f5381aa562589942e8d52b48bdace6663e10caed6bf5f2fb9ce11d84b0bc"
+			"sha256": "5dac1020bc1d5a4100150959d52d983a4860210aa9cbda9120214191c2a17f1d"
 		},
 		"harness/planning/implementation-researcher": {
 			"path": ".pi/agents/harness/planning/implementation-researcher.md",
@@ -131,15 +131,15 @@
 		},
 		"harness/planning/plan-adversary": {
 			"path": ".pi/agents/harness/planning/plan-adversary.md",
-			"sha256": "305cfa6cd0d4e6493a2dad2f01d8cb0b0dddc06df11f871746f6da7124c9d16b"
+			"sha256": "0c9abc088ced31705598baff143df992d435df751b01a9faad9d4af94df16c5a"
 		},
 		"harness/planning/plan-evaluator": {
 			"path": ".pi/agents/harness/planning/plan-evaluator.md",
-			"sha256": "1a6f465f4d400bcf32b9e82a1032ae789354f264af31c8d358b2a0dde7df81bf"
+			"sha256": "f85aba0adbbc7e726a51bfe2d6aa857ab39c8240cd08f06493bc1883ff387c5e"
 		},
 		"harness/planning/plan-synthesizer": {
 			"path": ".pi/agents/harness/planning/plan-synthesizer.md",
-			"sha256": "5bc3ec109179790c196df1328d362c1485cd5ff9295c31c3de93c050330295da"
+			"sha256": "3508126385d338b03f583aaa1f5d75f1cd1fcac8559fed52cd7db11ba1205536"
 		},
 		"harness/planning/planning-context": {
 			"path": ".pi/agents/harness/planning/planning-context.md",
@@ -147,11 +147,11 @@
 		},
 		"harness/planning/review-integrator": {
 			"path": ".pi/agents/harness/planning/review-integrator.md",
-			"sha256": "3f60c41768cad24150718b4a415b9636b0df6892195986a90fc77e2d0a6be537"
+			"sha256": "ea810e3ecf50afe16cf70d12ca3107af94f2272434a72acc5f206bdf7ee89699"
 		},
 		"harness/planning/sprint-contract-auditor": {
 			"path": ".pi/agents/harness/planning/sprint-contract-auditor.md",
-			"sha256": "402c585168c5510b5f22837d2fb157726b928fa59108a8580437ac6ac08d04f5"
+			"sha256": "615feafa48481af0a94b3d6ea9903d58b532575447f5482e60c65e6eb780bfc0"
 		},
 		"harness/planning/stack-researcher": {
 			"path": ".pi/agents/harness/planning/stack-researcher.md",

package/.pi/prompts/harness-plan.md

@@ -5,13 +5,13 @@ argument-hint: "\"<task>\" [--risk low|med|high] [--quick]"
 
 # harness-plan
 
-You are the **planning orchestrator** (agent-native; ADR 0042). Produce an execution baseline (`plan-packet.yaml` + `plan-review.md`) with **lake-sized** outcomes and path-first tools. Parent owns gates: `ask_user`, `approve_plan({ human_summary? })`, `create_plan()`, plan-verify, and scoped writes under `.pi/harness/runs/<run_id>/`.
+You are the **planning orchestrator**. Produce an execution baseline (`plan-packet.yaml` + `plan-review.md`) with **lake-sized** outcomes and path-first tools. Parent owns gates: `ask_user`, `approve_plan({ human_summary? })`, `create_plan()`, plan-verify, and scoped writes under `.pi/harness/runs/<run_id>/`.
 
-**Practice map:** `.pi/harness/docs/practice-map.md` — phase → proven practice → agent → spawn topology.
+Use the phase order and spawn topology defined in this prompt directly.
 
 Subagents persist artifacts via scoped **`submit_*`** tools (deterministic YAML under the run dir). Parent uses **`harness_artifact_ready`** to gate phases (no JSON parsing). Parent merges still use **`write_harness_yaml`** for `research-brief.yaml`, `plan-packet.yaml`, `planning-context.yaml`, and integrator patches.
 
-**Phase 0 is mandatory** before reconnaissance or any planning subagent. `write_harness_yaml` and spawn topology enforce `artifacts/task-clarification.yaml` with `status: ready` (ADR 0053).
+**Phase 0 is mandatory** before reconnaissance or any planning subagent. `write_harness_yaml` and spawn topology enforce `artifacts/task-clarification.yaml` with `status: ready`.
 
 ## Allowed subagents
 
@@ -34,7 +34,7 @@ Read **harness-debate-plan** skill before Review Gate rounds.
 
 1. Parallel `tasks` only for **independent** merges (implementation ∥ stack research; plan-evaluator ∥ plan-adversary for `parallel_probes`). **Never** parallelize decompose ∥ hypothesis.
 2. Max **2** research lanes, **1** debate agent, **1** optional `planning-context` subagent per `subagent` call.
-3. Downstream agents **read** upstream artifacts — do not re-derive (see practice-map anti-patterns).
+3. Downstream agents **read** upstream artifacts — do not re-derive upstream work.
 
 ## Performance rules
 
@@ -57,7 +57,7 @@ Use `[HarnessActivePlan]` / `[HarnessRunContext]` only. On revise: preserve `pla
 
 ## Phase 0 — Task clarification (mandatory; parent-led)
 
-**Practice:** Collect requirements / pool of shared meaning before WBS (PMBOK; Crucial Conversations). **ADR 0053.**
+**Practice:** Collect requirements and shared meaning before WBS (PMBOK; Crucial Conversations).
 
 **Goal:** `artifacts/task-clarification.yaml` with `status: ready`, `unresolved_questions: []`, and a canonical `clarified_task`. No full planning until gated.
 
@@ -121,7 +121,7 @@ Decompose treats **`task-clarification.yaml` as authoritative** for scope; §1.1
 
 ## Phase 2b — Hypothesis-driven approach (sequential)
 
-**Practice:** Lean exploration — falsifiable claim before plan detail (DARWIN / ADR 0034).
+**Practice:** Lean exploration — require a falsifiable claim before plan detail.
 
 **Requires** `artifacts/decomposition.yaml`. Do **not** spawn in parallel with decompose.
 
@@ -262,7 +262,7 @@ Med/low non-fork plans with clear stack and no implementation `open_questions` d
 
 ## Phase 5 — Structured inspection / Review Gate (Fagan-style)
 
-**Practice:** Code Complete collaborative construction; Fagan inspection with rubrics in `.pi/harness/docs/planning-rubrics.md`. Parent is **chair**; one debate agent per `subagent` batch.
+**Practice:** Code Complete collaborative construction with Fagan-style inspection criteria. Parent is **chair**; one debate agent per `subagent` batch.
 
 **Forbidden:** parallel `subagent` calls for any debate lane agent in one batch.
 

package/.pi/prompts/harness-review.md

@@ -7,7 +7,7 @@ argument-hint: "[--run <run-id>] [--quick] [--readonly] [--trace <trace-ref>]"
 
 You are the **post-run verification PM** (PMBOK Monitoring and Controlling). Run measure → judge → red team in one command. Parent owns `ask_user`, deterministic scripts, `harness_artifact_ready`, and run ownership (`--claim` on resume). Subagents persist via **`submit_*`** only (no parent `write` to verdict artifacts).
 
-**Practice map:** `.pi/harness/docs/practice-map.md`
+Follow the review sequence in this prompt directly: deterministic checks → benchmark evaluator → verdict evaluator → adversary → optional tie-breaker.
 
 Read **harness-orchestration** and **harness-review** skills before spawning.
 
@@ -91,7 +91,7 @@ notes: "…"
 
 ## Phase 1b — Sentrux repair advisor (subagent)
 
-**Practice:** Close the loop from fitness-function observation → bounded repair directives (ADR 0052). Skip when `artifacts/sentrux-repair-plan.yaml` already exists and `HARNESS_SENTRUX_RESCAN` is unset.
+**Practice:** Close the loop from fitness-function observation to bounded repair directives. Skip when `artifacts/sentrux-repair-plan.yaml` already exists and `HARNESS_SENTRUX_RESCAN` is unset.
 
 Spawn when **any**:
 
@@ -131,7 +131,7 @@ Gate:
 harness_artifact_ready({ paths: ["artifacts/eval-verdict.yaml"] })
 ```
 
-**Do not stop** after benchmark fail — continue to verdict (and adversary per tier) so `review-outcome.yaml` can route steer vs replan (ADR 0044).
+**Do not stop** after benchmark fail — continue to verdict (and adversary per tier) so `review-outcome.yaml` can route steer vs replan.
 
 ## Phase 3 — Policy / quality audit (verdict evaluator)
 
@@ -153,7 +153,7 @@ Gate again with `harness_artifact_ready`.
 
 ## Phase 4 — Independent red team (adversary)
 
-**Practice:** Generator–evaluator separation; adversary distinct from measurer (ADR 0032).
+**Practice:** Generator–evaluator separation; adversary stays distinct from the measurer.
 
 Skip when `--quick`. **Tiered steer:** full adversary on initial run + steer attempt 1; lite review (no adversary) on steer attempts 2+ unless prior `block_merge`.
 
@@ -185,7 +185,7 @@ subagent({ agentScope: "both", agent: "harness/reviewing/tie-breaker", task: "
 
 - **Never** parse subprocess JSON to write `eval-verdict.yaml` or `adversary-report.yaml` — use `submit_*` + `harness_artifact_ready` only.
 - Do not edit `plan-packet.yaml`.
-- Do not run inline review checks in this session (subagent isolation per ADR 0032).
+- Do not run inline review checks in this session (keep review work isolated to subagents).
 - Same Pi session as `/harness-run` is preferred; `--claim` makes cross-session resume work.
 
 ## Phase 6 — Review outcome + repair brief (parent)

package/.pi/prompts/harness-run.md

@@ -4,7 +4,7 @@ description: Execute only against an approved PlanPacket with strict phase gates
 
 # harness-run
 
-**Practice map:** `.pi/harness/docs/practice-map.md`
+Follow this prompt's execution flow directly: baseline gate → executor spawn → structural observation → review handoff.
 
 You orchestrate the **Executing Process Group** — spawn `harness/running/executor` only. Do **not** implement inline.
 
@@ -106,7 +106,7 @@ phase: execute
 
 ## Parent rules
 
-- On `scope_drift`, finish handoff and recommend **`/harness-review`** (review classifies `plan_gap` vs `implementation_gap` — ADR 0044).
+- On `scope_drift`, finish handoff and recommend **`/harness-review`** (review classifies whether the gap is planning or implementation).
 - Do not call `ask_user` for plan-level ambiguity — return to plan command.
 
 ## Completion

package/.pi/prompts/harness-sentrux-steward.md

@@ -39,14 +39,14 @@ Gate: `harness_artifact_ready({ paths: ["artifacts/sentrux-manifest-proposal.yam
 Read `artifacts/sentrux-manifest-proposal.yaml`.
 
 - `change_class: none` → report no manifest change; stop.
-- Otherwise → `ask_user` with summary, evidence bullets, and `adr_draft` if `adr_required`.
+- Otherwise → `ask_user` with summary, evidence bullets, and any draft decision text when a formal decision record is required.
 
 On approval:
 
 1. Apply `manifest_patch` to `.pi/harness/sentrux/architecture.manifest.json` (parent `write` or manual edit).
 2. `node "$UP_PKG/.pi/scripts/harness-sentrux-bootstrap.mjs" --force`
 3. Append session custom entry `harness-architecture-changed` (triggers rules sync extension).
-4. If `adr_required`, file harness ADR snippet or `docs/adr/` entry per team convention.
+4. If a formal decision record is required, file it in the target project's standard decision-log location.
 
 On reject: keep manifest unchanged; document decision in run notes.
 

package/.pi/prompts/harness-setup.md

@@ -289,7 +289,7 @@ Quick smoke test:
 sg -p 'function $NAME($$$ARGS) { $$$BODY }' --json 2>/dev/null | head -5 && echo "✓ ast-grep pattern matching works" || echo "! ast-grep smoke test — may need language-specific config"
 ```
 
-### 2.7 — gh CLI (GitHub Issues Spec Storage — ADR-025)
+### 2.7 — gh CLI (GitHub Issues Spec Storage)
 
 ```bash
 if ! command -v gh &>/dev/null || [ "$FORCE" = "true" ]; then
@@ -335,7 +335,7 @@ Installed and smoke-tested by `harness-cli-verify.sh` (`npm install -g @ls-lint/
 
 ## Step 3 — Pi Extension Packages
 
-Bundled extensions load from the installed `ultimate-pi` package. The harness lens wrapper at `.pi/extensions/harness-lens.ts` loads `.pi/extensions/lib/harness-lens/` for edit autopatch, secrets blocking, deferred format, and LSP tools. Structural search uses shell `sg` (installed globally by setup); architecture gates use Sentrux. See [ADR 0045](.pi/harness/docs/adrs/0045-harness-lens-minimal-contract.md).
+Bundled extensions load from the installed `ultimate-pi` package. The harness lens wrapper at `.pi/extensions/harness-lens.ts` loads `.pi/extensions/lib/harness-lens/` for edit autopatch, secrets blocking, deferred format, and LSP tools. Structural search uses shell `sg` (installed globally by setup); architecture gates use Sentrux.
 
 Harness lens findings are **complementary** to Sentrux:
 
@@ -471,7 +471,7 @@ Harness `ask_user` supports terminal (TUI), headless (CI), and Glimpse WebView (
 | **Desktop Linux / macOS / WSLg** | `auto` or `glimpse` for richer questionnaires |
 | **CI / `--non-interactive`** | Prompts skipped; do not expect WebView |
 
-Append `HARNESS_ASK_USER_UI=tui` to `.env` when WebView is unavailable. The first real `ask_user` reports `ui_backend` and `ui_degraded` in tool details. See ADR 0054.
+Append `HARNESS_ASK_USER_UI=tui` to `.env` when WebView is unavailable. The first real `ask_user` reports `ui_backend` and `ui_degraded` in tool details.
 
 Template keys (placeholders — user fills secrets): `HARNESS_TELEMETRY_ENABLED`, `HARNESS_WEB_*`, `HARNESS_VCC_COMPACTION`, `HARNESS_VCC_DEBUG`, plus commented optional PostHog / Graphify vars.
 

package/.pi/prompts/harness-steer.md

@@ -5,7 +5,7 @@ argument-hint: "[--attempt N]"
 
 # harness-steer
 
-Thin orchestrator for the **steer loop** (ADR 0044). Run only after `/harness-review` produced `artifacts/review-outcome.yaml` and `artifacts/repair-brief.yaml` with `remediation_class: implementation_gap`.
+Thin orchestrator for the **steer loop**. Run only after `/harness-review` produced `artifacts/review-outcome.yaml` and `artifacts/repair-brief.yaml` with `remediation_class: implementation_gap`.
 
 ## Preconditions
 
@@ -19,10 +19,10 @@ Thin orchestrator for the **steer loop** (ADR 0044). Run only after `/harness-re
 2. Update `artifacts/steer-state.yaml` (`attempt`, `max_attempts`, `active: true`).
 3. Set policy phase to **execute** before spawning executor (required for mutating tools).
 4. One `ask_user` steer gate unless `run-context.steer_approved` is already true.
-5. Spawn **`harness/running/executor`** with `HarnessSpawnContext.mode: repair` and `repair_brief_path: artifacts/repair-brief.yaml`. Repair uses the same hash-anchored `read`/`edit`, batching, and pre-handoff verification rules as `/harness-run` (ADR 0051).
-6. Optional: `node "$UP_PKG/.pi/scripts/harness-sentrux-cli.mjs" gate --save` after repair to refresh baseline (ADR 0044).
-7. Optional: `node "$UP_PKG/.pi/scripts/harness-ls-lint-cli.mjs"` after repair to confirm filename conventions (ADR 0052).
-7. `next_command`: **`/harness-review`** (always re-verify; tiered adversary on attempts 2+ per practice-map).
+5. Spawn **`harness/running/executor`** with `HarnessSpawnContext.mode: repair` and `repair_brief_path: artifacts/repair-brief.yaml`. Repair uses the same hash-anchored `read`/`edit`, batching, and pre-handoff verification rules as `/harness-run`.
+6. Optional: `node "$UP_PKG/.pi/scripts/harness-sentrux-cli.mjs" gate --save` after repair to refresh the structural baseline.
+7. Optional: `node "$UP_PKG/.pi/scripts/harness-ls-lint-cli.mjs"` after repair to confirm filename conventions.
+7. `next_command`: **`/harness-review`** (always re-verify; use tiered adversary on attempts 2+).
 
 ## Forbidden
 

package/.pi/scripts/harness-verify.mjs

@@ -158,6 +158,34 @@ async function runNodeScript(scriptPath, args = []) {
 }
 
 const PROMPT_EXCLUDE = new Set(["release.md"]);
+const INTERNAL_PROMPT_SURFACE_ROOTS = [
+	{
+		label: ".pi/prompts",
+		dir: join(ROOT, ".pi", "prompts"),
+		recursive: false,
+		include: (name) => name.endsWith(".md"),
+	},
+	{
+		label: ".pi/agents",
+		dir: join(ROOT, ".pi", "agents"),
+		recursive: true,
+		include: (name) => name.endsWith(".md"),
+	},
+	{
+		label: ".agents/skills",
+		dir: join(ROOT, ".agents", "skills"),
+		recursive: true,
+		include: (name) => name === "SKILL.md",
+	},
+];
+
+const FORBIDDEN_INTERNAL_PROMPT_REFS = [
+	{ label: "ADR token", regex: /\bADR\b/i },
+	{ label: "internal ADR path", regex: /(?:^|\W)(?:docs\/adr|\.pi\/harness\/docs\/adrs)(?:\W|$)/i },
+	{ label: "internal practice-map path", regex: /(?:^|\W)(?:\.pi\/harness\/docs\/practice-map\.md|practice-map)(?:\W|$)/i },
+	{ label: "internal planning rubrics path", regex: /(?:^|\W)(?:\.pi\/harness\/docs\/planning-rubrics\.md|planning-rubrics)(?:\W|$)/i },
+	{ label: "internal docs path", regex: /(?:^|\W)\.pi\/harness\/docs\//i },
+];
 
 function parsePromptFrontmatter(raw) {
 	const match = raw.match(/^---\r?\n([\s\S]*?)\r?\n---/);
@@ -179,6 +207,50 @@ function parsePromptFrontmatter(raw) {
 	return fields;
 }
 
+function relPath(path) {
+	if (path.startsWith(`${ROOT}/`)) return path.slice(ROOT.length + 1);
+	return path;
+}
+
+async function collectMarkdownFiles(dir, { recursive, include }) {
+	const out = [];
+	const entries = await readdir(dir, { withFileTypes: true });
+	for (const entry of entries) {
+		const fullPath = join(dir, entry.name);
+		if (entry.isDirectory()) {
+			if (recursive) {
+				out.push(...(await collectMarkdownFiles(fullPath, { recursive, include })));
+			}
+			continue;
+		}
+		if (!entry.isFile()) continue;
+		if (!entry.name.endsWith(".md")) continue;
+		if (include && !include(entry.name, fullPath)) continue;
+		out.push(fullPath);
+	}
+	return out;
+}
+
+async function checkInternalPromptReferencePolicy() {
+	for (const root of INTERNAL_PROMPT_SURFACE_ROOTS) {
+		if (!(await fileExists(root.dir))) continue;
+		const files = await collectMarkdownFiles(root.dir, {
+			recursive: root.recursive,
+			include: root.include,
+		});
+		for (const file of files) {
+			const raw = await readFile(file, "utf-8");
+			for (const rule of FORBIDDEN_INTERNAL_PROMPT_REFS) {
+				if (rule.regex.test(raw)) {
+					fail(
+						`internal prompt/agent/skill policy: ${relPath(file)} contains forbidden reference (${rule.label})`,
+					);
+				}
+			}
+		}
+		ok(`internal prompt-surface reference policy (${root.label})`);
+	}
+}
 async function checkPromptFrontmatter() {
 	const promptsDir = join(ROOT, ".pi", "prompts");
 	const names = await readdir(promptsDir);
@@ -596,6 +668,7 @@ async function main() {
 	await verifySchemaAdrAndExtensions();
 	await verifyCoreSurfaceFiles();
 	await checkPromptFrontmatter();
+	await checkInternalPromptReferencePolicy();
 	const pkgJson = JSON.parse(await readFile(join(ROOT, "package.json"), "utf-8"));
 	await checkHarnessLens(pkgJson);
 	await checkHarnessAnchoredEdit(pkgJson);

package/AGENTS.md

@@ -33,6 +33,7 @@ Created: 2026-05-14
 - ./raw/ is source storage for graphify
 - ADRs in docs/adr/ (repo) and .pi/harness/docs/adrs/ (harness) with structured format
 - `node "$UP_PKG/.pi/scripts/harness-verify.mjs"` for deterministic harness contract checks (`UP_PKG` — see `.pi/scripts/README.md`)
+- Internal prompt surfaces only (`.pi/prompts/**`, `.pi/agents/**`, `.agents/skills/*/SKILL.md`): do not reference ADRs or internal-doc paths; write intended behavior directly. `harness-verify` enforces this policy.
 - Harness context: **context-mode only** — never lean-ctx on harness paths (see harness-context skill)
 - `graphify update .` after significant code changes
 - ast-grep (`sg`) is the default code search tool — use `sg -p 'pattern'` for structural search, never grep for code

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to this project are documented in this file.
 
+## [v0.22.1] — 2026-05-27
+
+### 🔧 Chores
+
+- update package metadata and sync harness assets
+
+
 ## [v0.22.0] — 2026-05-27
 
 ### ✨ Features

package/package.json

@@ -1,20 +1,23 @@
 {
 	"name": "ultimate-pi",
-	"version": "0.22.0",
-	"description": "Ultimate AI coding harness for pi.dev — extensible skills, Obsidian wiki knowledge layer, compressed context, deterministic output",
+	"version": "0.22.1",
+	"description": "Governed AI coding harness for pi.dev — bootstrap, plan, execute, review, and steer with deterministic policy gates",
 	"keywords": [
 		"pi-package",
 		"pi-mono",
 		"pi",
 		"ai-harness",
+		"agentic-harness",
 		"coding-agent",
-		"obsidian-wiki",
-		"knowledge-base",
-		"context-compression",
+		"governed-workflow",
+		"plan-execute-review",
+		"policy-gates",
 		"agent-skills",
-		"scrapling",
+		"graphify",
 		"harness-web",
+		"scrapling",
 		"context-mode",
+		"sentrux",
 		"vcc"
 	],
 	"license": "MIT",