claude-dev-env 2.16.0 → 2.17.0

package/.agents/{skills → skills-archived}/anthropic-plan/AGENTS.md

@@ -19,7 +19,7 @@ Creates a repo-local plan packet under `docs/plans/<slug>/` by running the `plan
 | `SKILL.md` | Entry point. Full planning protocol, workflow contract, packet shape, and validation rules. |
 | `workflow/plan-packet.mjs` | Main workflow script. Reads repo context, writes the packet, runs the validator, spawns `plan-packet-validator`, runs the reuse audit, builds the visual HTML, and returns the packet path. |
 | `workflow/plan-packet.contract.test.mjs` | Contract tests for the workflow script. |
-| `packages/claude-dev-env/.agents/skills/anthropic-plan/scripts/validate_packet.py` | Deterministic validator: checks required files, open questions, source-map strength, TDD coverage, and `packet.json` consistency. Exits with code 2 on failure. |
+| `packages/claude-dev-env/.agents/skills-archived/anthropic-plan/scripts/validate_packet.py` | Deterministic validator: checks required files, open questions, source-map strength, TDD coverage, and `packet.json` consistency. Exits with code 2 on failure. |
 | `templates/visual-plan.template.html` | Template for the single-file offline visual HTML the workflow builds after validation. |
 
 ## Entry point

package/.agents/{skills → skills-archived}/bugteam/scripts/reflow_skill_md.py

@@ -1,16 +1,16 @@
-"""Reflow packages/claude-dev-env/.agents/skills/bugteam/SKILL.md to 80 columns.
+"""Reflow packages/claude-dev-env/.agents/skills-archived/bugteam/SKILL.md to 80 columns.
 
 Merge soft line breaks outside fenced blocks (space join; URL path fragments
 joined without a space only inside unfinished markdown link targets), then
 wrap with textwrap. Preserves fenced blocks verbatim.
 
-Same algorithm as ``packages/claude-dev-env/.agents/skills/pr-converge/scripts/reflow_skill_md.py``
+Same algorithm as ``packages/claude-dev-env/.agents/skills-archived/pr-converge/scripts/reflow_skill_md.py``
 from https://github.com/jl-cmd/claude-dev-env/pull/349 (branch
 ``cursor/pr-converge-skill-line-wrap-ecd1``); ``SKILL_PATH`` points at bugteam
 ``SKILL.md``. Link reference definitions (``[id]: url``) are treated as logical
 line starts so they are not merged with prior paragraphs.
 
-Run: python3 packages/claude-dev-env/.agents/skills/bugteam/scripts/reflow_skill_md.py
+Run: python3 packages/claude-dev-env/.agents/skills-archived/bugteam/scripts/reflow_skill_md.py
 """
 
 from __future__ import annotations

package/.agents/{skills → skills-archived}/codex-review/test_skill_scaffold.py

@@ -15,7 +15,7 @@ PACKAGE_ROOT = SKILL_DIRECTORY.parents[2]
 PYPROJECT_PATH = PACKAGE_ROOT / "pyproject.toml"
 EVER_SHIPPED_SKILLS_PATH = PACKAGE_ROOT / "bin" / "ever-shipped-skills.mjs"
 CONSTANTS_PACKAGE_NAME = "codex_review_scripts_constants"
-CONSTANTS_PACKAGE_DIR = ".agents/skills/codex-review/scripts/codex_review_scripts_constants"
+CONSTANTS_PACKAGE_DIR = "_shared/pr-loop/scripts/codex_review_scripts_constants"
 SKILL_NAME = "codex-review"
 MAXIMUM_SKILL_BODY_LINE_COUNT = 500
 

package/.agents/{skills → skills-archived}/copilot-finding-triage/SKILL.md

@@ -124,7 +124,7 @@ present when the caller has not selected a pacer):
 - **Portable pacer** (`pacer=portable`, or no durable wake): do not call
   `ScheduleWakeup` or `send_later`. Hold with an in-session deadline poll, or
   write handoff and stop, per
-  [`../_shared/pr-loop/portable-driver.md`](../_shared/pr-loop/portable-driver.md).
+  [`../../skills/_shared/pr-loop/portable-driver.md`](../../skills/_shared/pr-loop/portable-driver.md).
   Callers may override this step after the ntfy page and apply their own
   portable hold.
 

package/.agents/{skills → skills-archived}/pr-converge/SKILL.md

@@ -15,7 +15,7 @@ Bugbot and Copilot run as terminal confirmation gates, until all are clean on
 the same `HEAD` and mergeable. On `pacer=schedule_wakeup`, one tick runs per
 invocation and the next tick is scheduled. On `pacer=portable`, ticks run
 continuously in-session (see
-[`../_shared/pr-loop/portable-driver.md`](../_shared/pr-loop/portable-driver.md)).
+[`../../skills/_shared/pr-loop/portable-driver.md`](../../skills/_shared/pr-loop/portable-driver.md)).
 
 ## Transport check (before any GitHub step)
 
@@ -50,7 +50,7 @@ python "$HOME/.claude/skills/_shared/pr-loop/scripts/select_converge_pacer.py" \
 - `pacer=schedule_wakeup` — native tick pacing via `ScheduleWakeup` (see
   [`workflows/schedule-wakeup-loop.md`](workflows/schedule-wakeup-loop.md)).
 - `pacer=portable` — continuous in-session driver on
-  [`../_shared/pr-loop/portable-driver.md`](../_shared/pr-loop/portable-driver.md).
+  [`../../skills/_shared/pr-loop/portable-driver.md`](../../skills/_shared/pr-loop/portable-driver.md).
   **Do not abort** because `ScheduleWakeup` is missing.
 
 ### Worktree isolation
@@ -62,7 +62,7 @@ working directory contains `.claude/worktrees/`. If `EnterWorktree` fails,
 report the failure and stop.
 
 When `EnterWorktree` is absent, isolate with git worktree machinery per
-[`../_shared/pr-loop/portable-driver.md`](../_shared/pr-loop/portable-driver.md)
+[`../../skills/_shared/pr-loop/portable-driver.md`](../../skills/_shared/pr-loop/portable-driver.md)
 § Isolation and worktree, then run strict
 `preflight_worktree.py` for the PR's owner/repo. Fail closed only when the
 checkout is not the PR's repo on the PR head ref.
@@ -110,7 +110,7 @@ auto-fix; code-concern verify then confirmed / refuted / inconclusive).
     `send_later` 45-minute hold across ticks; persist the deadline so each tick
     reads it on entry).
   - **`pacer=portable`** — in-session deadline poll or handoff per
-    [`../_shared/pr-loop/portable-driver.md`](../_shared/pr-loop/portable-driver.md);
+    [`../../skills/_shared/pr-loop/portable-driver.md`](../../skills/_shared/pr-loop/portable-driver.md);
     never `ScheduleWakeup` or `send_later`.
   Act on the user's direction inside the window; on timeout, teardown and report
   the findings un-reviewed.
@@ -444,7 +444,7 @@ round as converged. This rule holds every tick, every loop, every PR.
 | `copilot-finding-triage` | Tier, verify, and route each Copilot finding |
 | `bugteam` | Full-diff bug audit in Step 6 (Skill invocation mandatory) |
 | `pr-loop-cloud-transport` | When `gh` is unavailable or unauthenticated |
-| [`../_shared/pr-loop/portable-driver.md`](../_shared/pr-loop/portable-driver.md) | Continuous in-session pacer when `ScheduleWakeup` is absent |
+| [`../../skills/_shared/pr-loop/portable-driver.md`](../../skills/_shared/pr-loop/portable-driver.md) | Continuous in-session pacer when `ScheduleWakeup` is absent |
 | [`../../_shared/pr-loop/fix-protocol.md`](../../_shared/pr-loop/fix-protocol.md) | Shared 13-step fix sequence (TDD, commit, push, reply, resolve) |
 | [`reference/fix-protocol.md`](reference/fix-protocol.md) | pr-converge deltas on the shared fix protocol |
 
@@ -466,4 +466,4 @@ round as converged. This rule holds every tick, every loop, every PR.
 | `reference/obstacles/` | Per-obstacle fix runbooks |
 | `scripts/` | Convergence helpers, Copilot fetch, fix-reply poster, tests |
 | `workflows/schedule-wakeup-loop.md` | ScheduleWakeup pacing (`pacer=schedule_wakeup`) |
-| [`../_shared/pr-loop/portable-driver.md`](../_shared/pr-loop/portable-driver.md) | Portable continuous pacer (`pacer=portable`) |
+| [`../../skills/_shared/pr-loop/portable-driver.md`](../../skills/_shared/pr-loop/portable-driver.md) | Portable continuous pacer (`pacer=portable`) |

package/.agents/{skills → skills-archived}/pr-converge/pr_converge_skill_constants/AGENTS.md

@@ -23,4 +23,4 @@ Importable Python constants module for the `pr-converge` skill. Script-specific
 ## Conventions
 
 - All path templates use `str.format(**kwargs)` with keys `owner`, `repo`, `number`.
-- `packages/claude-dev-env/.agents/skills/pr-converge/scripts/pr_converge_scripts_constants/pr_converge_constants.py` re-exports everything here via `from pr_converge_skill_constants.constants import ...` so scripts can import from either location.
+- `packages/claude-dev-env/.agents/skills-archived/pr-converge/scripts/pr_converge_scripts_constants/pr_converge_constants.py` re-exports everything here via `from pr_converge_skill_constants.constants import ...` so scripts can import from either location.

package/.agents/{skills → skills-archived}/pr-converge/pr_converge_skill_constants/constants.py

@@ -2,7 +2,7 @@
 
 All runtime and API constants live here. Script-specific constants
 (CLI args, markdown patterns, reflow settings) stay in
-``packages/claude-dev-env/.agents/skills/pr-converge/scripts/pr_converge_scripts_constants/pr_converge_constants.py``,
+``packages/claude-dev-env/.agents/skills-archived/pr-converge/scripts/pr_converge_scripts_constants/pr_converge_constants.py``,
 which imports from here.
 """
 

package/.agents/{skills → skills-archived}/pr-converge/reference/multi-pr-orchestration.md

@@ -216,7 +216,7 @@ When bugfix (clean-coder) subagent completes after push:
 5. Advance the pacer: on `pacer=schedule_wakeup`, call `ScheduleWakeup`
    with the appropriate delay; on `pacer=portable`, continue or poll
    in-session per
-   [`../../_shared/pr-loop/portable-driver.md`](../../_shared/pr-loop/portable-driver.md)
+   [`../../../skills/_shared/pr-loop/portable-driver.md`](../../../skills/_shared/pr-loop/portable-driver.md)
    (no `ScheduleWakeup`).
 6. Nothing else.
 

package/.agents/{skills → skills-archived}/pr-converge/reference/per-tick.md

@@ -19,7 +19,7 @@ Run every tick in the parent harness session. Pacing depends on the selected
 pacer from pre-flight (`select_converge_pacer.py`):
 
 - `schedule_wakeup` — [`../workflows/schedule-wakeup-loop.md`](../workflows/schedule-wakeup-loop.md)
-- `portable` — [`../../_shared/pr-loop/portable-driver.md`](../../_shared/pr-loop/portable-driver.md)
+- `portable` — [`../../../skills/_shared/pr-loop/portable-driver.md`](../../../skills/_shared/pr-loop/portable-driver.md)
 
 See [Pacing workflow](#pacing-workflow).
 
@@ -42,7 +42,7 @@ When `pacer=schedule_wakeup`, read
 [`../workflows/schedule-wakeup-loop.md`](../workflows/schedule-wakeup-loop.md)
 (installed copy under `$HOME/.claude/skills/pr-converge/workflows/`) before
 Step 4. When `pacer=portable`, read
-[`../../_shared/pr-loop/portable-driver.md`](../../_shared/pr-loop/portable-driver.md)
+[`../../../skills/_shared/pr-loop/portable-driver.md`](../../../skills/_shared/pr-loop/portable-driver.md)
 and skip `ScheduleWakeup` calls.
 
 - **`/pr-converge`** (default): loops until convergence. After each tick
@@ -546,7 +546,7 @@ Do **not** call `ScheduleWakeup`. After writing state and handoff:
   `/pr-converge <PR URL>` and the persisted phase.
 
 Full portable rules:
-[`../../_shared/pr-loop/portable-driver.md`](../../_shared/pr-loop/portable-driver.md).
+[`../../../skills/_shared/pr-loop/portable-driver.md`](../../../skills/_shared/pr-loop/portable-driver.md).
 
 ## Bugteam execution
 

package/.agents/{skills → skills-archived}/pr-converge/scripts/reflow_skill_md.py

@@ -1,10 +1,10 @@
-"""Reflow packages/claude-dev-env/.agents/skills/pr-converge/SKILL.md to 80 columns.
+"""Reflow packages/claude-dev-env/.agents/skills-archived/pr-converge/SKILL.md to 80 columns.
 
 Merge soft line breaks outside fenced blocks (space join; URL path fragments
 joined without a space only inside unfinished markdown link targets), then
 wrap with textwrap. Preserves fenced blocks verbatim.
 
-Run: python3 packages/claude-dev-env/.agents/skills/pr-converge/scripts/reflow_skill_md.py
+Run: python3 packages/claude-dev-env/.agents/skills-archived/pr-converge/scripts/reflow_skill_md.py
 """
 
 from __future__ import annotations

package/.agents/{skills → skills-archived}/pr-converge/test_portable_pacer_gate.py

@@ -9,7 +9,11 @@ SKILL_ROOT = Path(__file__).resolve().parent
 SKILL_MARKDOWN_PATH = SKILL_ROOT / "SKILL.md"
 PER_TICK_MARKDOWN_PATH = SKILL_ROOT / "reference" / "per-tick.md"
 PORTABLE_DRIVER_PATH = (
-    SKILL_ROOT.parent / "_shared" / "pr-loop" / "portable-driver.md"
+    SKILL_ROOT.parents[1]
+    / "skills"
+    / "_shared"
+    / "pr-loop"
+    / "portable-driver.md"
 )
 
 SELECT_CONVERGE_PACER_SCRIPT = "select_converge_pacer.py"
@@ -18,7 +22,7 @@ PACER_SCHEDULE_WAKEUP_TOKEN = "pacer=schedule_wakeup"
 ABORT_ONLY_PHRASE = "pr-converge requires ScheduleWakeup; aborting"
 PORTABLE_DRIVER_DOC = "portable-driver.md"
 PORTABLE_DRIVER_LINK_PATTERN = re.compile(
-    r"\((?P<relative>(?:\.\./)+_shared/pr-loop/portable-driver\.md)\)"
+    r"\((?P<relative>(?:\.\./)+skills/_shared/pr-loop/portable-driver\.md)\)"
 )
 
 

package/.agents/{skills → skills-archived}/pr-converge/workflows/schedule-wakeup-loop.md

@@ -2,7 +2,7 @@
 
 Load this document when pre-flight selects `pacer=schedule_wakeup`. When
 `pacer=portable`, use
-[`../../_shared/pr-loop/portable-driver.md`](../../_shared/pr-loop/portable-driver.md)
+[`../../../skills/_shared/pr-loop/portable-driver.md`](../../../skills/_shared/pr-loop/portable-driver.md)
 instead. Shared bugbot / bugteam / Fix protocol steps stay in the main
 `SKILL.md`.
 

package/.agents/{skills → skills-archived}/split-pr/reference/proposal-format.md

@@ -12,4 +12,4 @@ Each slice carries `id`, `title` (exactly one conventional prefix), `layer`
 (one of `config` / `backend` / `frontend` / `tests` / `docs` / `other`), and
 `all_paths`. Every path in `all_changed_paths` is assigned to exactly one
 slice. Titles are normalized with `split_pr_title.normalize_split_title`.
-Layer tokens follow `ALL_LAYER_ORDER` in `packages/claude-dev-env/.agents/skills/split-pr/scripts/config/plan_constants.py`.
+Layer tokens follow `ALL_LAYER_ORDER` in `packages/claude-dev-env/.agents/skills-archived/split-pr/scripts/config/plan_constants.py`.

package/AGENTS.md

@@ -1,14 +1,23 @@
 # Scope
 
-  Every rule in this file governs all text everywhere: chat replies, tool-call sentences, plans, questions you ask, code, code comments, test names, commit subjects, pull request and issue bodies, documentation, and every file you write. No rule stops at the edge of a chat message.
+## User-facing language hierarchy
 
-  A rule that names a form in order to forbid it passes its own check, and so does a two-column table that teaches a rewrite.
+ELI5 owns beginner framing and beginner-friendly presentation, large visuals, minimal text, one stable self-contained HTML artifact, update-in-place continuity, and sharing when a response needs that presentation.
+
+`rules/asd-ste100-language.md` owns sentence-level word choice, grammar, tone, punctuation, exact labels, and prose form in every user-facing response and every ELI5 page.
+
+Named capability rules own evidence, questions, current-state documentation, completion, code documentation, durable artifacts, and runtime enforcement. They apply ASD sentence rules and use ELI5 presentation when their user-facing output needs that envelope.
+
+Raw tool output, machine payloads, code, and native repository artifacts keep their required formats. Their user-visible explanations follow the ASD rule.
+
+A responsible human verifies technical accuracy, terminology, safety, confidentiality, and intended meaning.
 
 Ask when ambiguity materially changes scope or implementation. Collect credentials through secure UI only; never request secrets in chat.
 
 ## Documentation
 
-Describe only the current system state. Keep documentation self-contained and free of historical, transitional, conversational, or version-transition language. Never use negative prose or antipatterns. Always state what to do, specifically.
+Describe the current system state. Keep documentation self-contained. Apply `rules/asd-ste100-language.md` for sentence-level prose.
+
 Code and tests
 
 Tests must exercise real behavior, real data, and production paths. Test theater is forbidden.
@@ -18,6 +27,8 @@ For multi-step code tasks:
 Coders consult a warm session-advisor when blocked (Sol xHigh).
 Repair reported findings when that review mode is selected.
 
+Use `~/.claude/agents/session-advisor.md` for advisor selection and consultation protocol.
+
 Research and delegation
 Delegate fact extraction when multiple files or search patterns are required. Request precise file-and-line answers.
 
@@ -31,79 +42,42 @@ Scope every es.exe search.
 
 Never scan an entire drive or network share.
 
+Use `~/.claude/skills/everything-search/SKILL.md` for scoped filesystem searches that require Everything.
+
 Task tracking
 Track every task using `update_plan`.
 
 ## Definitions
 Warm agent: Any agent who has acted within the past 30 minutes.
 
-  # Response and working style
-
-  Mid-run and closing narration follow `rules/opus5-communication-contract.md` (`opus5-communication-contract-v1`): first progress update is one sentence; later updates only for important discoveries or direction changes; the final starts with the outcome.
+# Response and working style
 
-  Keep responses focused, brief, and concise. Keep disclaimers and caveats short, and spend most of the response on the main answer. When asked to explain something, give a high-level summary unless an in-depth explanation is specifically requested.
+ELI5 presentation sets beginner framing, useful visuals, concise detail, stable HTML continuity, and sharing when that capability applies.
 
-  # Word budget
+Sentence-level language follows `rules/asd-ste100-language.md`.
 
-  Say it in the fewest words that stay accurate and complete. Before sending, cut every sentence that does not change what the reader thinks or does.
+Progress and final structure follow the named completion contract.
 
-  Cut these on sight:
+# Word budget
 
-  - Deliberation. State the decision, not the reasoning that reached it, unless the reader has to weigh it themselves.
-  - Why you did not do something. Say what you did; add the reason only if the reader must decide whether to do it.
-  - Incidental findings from your own process. Report one only when the reader must act on it, and give it one line.
-  - Any sentence that restates a fact already stated in a heading, a list, or an earlier line.
+Keep ELI5 pages concise and useful. Use the ASD rule's 20-word procedure target and 25-word descriptive target when the technical content allows.
 
-  When you have more than two facts of the same kind, use a list or a table. Prose paragraphs hide facts; rows expose them.
+# No contrast framing
 
-  # No contrast framing
+Use direct claims and direct actions. The canonical rule owns sentence form; capability contracts own exceptions needed to explain a concrete failure.
 
-  Write the claim. Never prop it up against what it is not.
+# Naming
 
-  The banned shape is a claim paired with a rejected alternative, in any wording:
+Use full capability names for files, modules, functions, variables, branches, and tests. Name reusable components for the capability they provide. Keep workflow words on driver surfaces.
 
-  | Banned | Write instead |
-  |---|---|
-  | Verified against the remote, not just locally | Verified against the remote |
-  | This is a design flaw, not a typo | This is a design flaw |
-  | Not a copy of the shared script, but an ad |
-  | Rather than patching the caller, the fix moves into the helper | The fix moves into the helper |
-  | Instead of three passes, it runs one | It runs one pass |
-  | It is not only faster; it is correct | It is correct and faster |
-  | This is less a bug than a missing feature
-  | Let me read the log rather than guessing | Reading the log. |
-  | I'll patch the helper instead of the caller | Patching the helper. |
-
-  Every wording of the shape is banned, including `X, not Y`, `not Y but X`, `rather than Y, X`, `instead of Y, X`, `X over Y`, `not just X — Y`, `less X than Y`, and a negated sentence followed by its po
-  ──── (152 lines hidden) ─────────────────────────────────────────────────────────────────────────────────────────────
-  the name.
-
-  | Written on the day | Named for the subject |
-  |---|---|
-  | `august_cert_failures.py` | `cert_rejections.py` |
-  | `fix_august_bug()` | `normalize_calendar_color()` |
-  | `AUGUST_REJECTION_CODES` | `REJECTION_CODE
-  | `test_august_failures` | `test_rejects_wrong_calendar_color` |
-  | `jira4821_validator.py` | `manifest_validator.py` |
-  | `q3_migration/` | `add_tenant_id_column/` |
-  | `v2_client.py` | `retrying_client.py` |
-  | `legacy_export.py` | `csv_export.py` |
-  | `temp_fix.py` | `unicode_path_workaround.p
-  | "Fix August cert failures" | "Fix calendar color mismatch in cert export" |
-
-  A branch name is a name. It carries no date,ither. Someone reads it to decide whether to check the branch out, so it has to say what the work does.
-
-  | Written on the day | Named for the subject |
-  |---|---|
-  | `fix/cert-2026-08-b3-calendar-widget-color` | `fix-calendar-widget-color` |
-  | `parse-rejection-emails-cert-2026-08-b3` |
+  # Change size
 
-  One prefix spreads. Once `august_` sits in one name, the next name matches it for consistency, and within a week the month reads as a real domain concept that forty places depend on. Rename it the hour you notice it.
 
-  # Change size
 
   When planning work or opening a pull request, size the change first: one self-contained change, around 100 lines, with its tests. Read the small-changelists guide for the numbers, the allowed exceptions, and how to split.
 
+Use `~/.claude/skills/small-cl/SKILL.md` for change-size guidance and review-sized boundaries.
+
 ## Execution and delegation
 
 Delegate all task work to Tier 3 agents.
@@ -126,10 +100,12 @@ Warm agent: An agent that has acted within the past 30 minutes. Reuse warm agent
 
   When you use a tool, you may say a brief sentence first. If no tool can express what the user asked for, say so. Do not include internal or system XML tags in your response.
 
+Use the named review workflow for code-review response reporting.
+
   # Code review
 
   When reviewing code, report everything you find. Filtering belongs in a separate pass.
 
-  <tone_preference>
-  Keep outputs reasonably concise.
-  </tone_preference>
+<tone_preference>
+ELI5 sets beginner-friendly presentation when it applies. ASD sets sentence-level wording and tone.
+</tone_preference>

package/_shared/AGENTS.md

@@ -2,6 +2,8 @@
 
 Cross-cutting runtime assets shared by multiple skills. The PR-loop skills (`bugteam`, `pr-converge`, `findbugs`, `fixbugs`) are one such cluster; other clusters live here too. Files here are installed into `~/.claude/_shared/` by `bin/install.mjs` alongside the skill directories that import them.
 
+Shared assets use `~/.claude/rules/asd-ste100-language.md` for user-facing word choice, sentence style, tone, punctuation, and prose form. Each asset keeps its workflow-specific structure.
+
 ## Contents
 
 | Entry | Description |

package/_shared/advisor/reference/sol-rung.md

@@ -16,10 +16,10 @@ Every fallback reply carries a `fallback_kind` field: `declined` when policy clo
 Flag on: run the Codex preflight first —
 
 ```
-python ~/.claude/skills/codex-review/scripts/codex_usage_probe.py
+python ~/.claude/_shared/pr-loop/scripts/codex_usage_probe.py
 ```
 
-Repo home: `packages/claude-dev-env/.agents/skills/codex-review/scripts/`.
+Repo home: `packages/claude-dev-env/_shared/pr-loop/scripts/`.
 
 The shared entry point is `~/.claude/_shared/advisor/scripts/codex_sol_advisor.py`; it calls the installed probe and owns Sol bind or resume parsing. Bind with `python ~/.claude/_shared/advisor/scripts/codex_sol_advisor.py --bind --cwd <repo-root>` and pipe the charter on stdin. Resume with `--resume <session_id>` and pipe the delta consult on stdin.
 

package/_shared/advisor/reference/third-party-bind.md

@@ -14,7 +14,7 @@ Open this when binding or re-binding the advisor from a third-party (non-Claude)
    ```
 
    Use `--model fable --effort high` on Fable; use `--model opus --effort xhigh` on Opus.
-   Opus routing follows [`rules/opus5-communication-contract.md`](../../../rules/opus5-communication-contract.md).
+   User-facing wording follows [`rules/asd-ste100-language.md`](../../../rules/asd-ste100-language.md).
    The caller picks the Fable effort from task scope; when the caller cannot judge scope well enough to pick, it asks the user through AskUserQuestion before binding, and defaults to `high` when no caller choice arrives.
    A root advisor bind uses `--routing-mode ordered_account` — walk order, failover, and the `advisor_blocked` terminal status are in [`cli-chain.md`](cli-chain.md).
 4. Stop at the first successful bind.

package/_shared/pr-loop/audit-reply-template.md

@@ -4,6 +4,10 @@ Canonical reply shape for every orchestrator-to-thread reply posted by the PR-lo
 
 Read this doc before authoring any code that posts a reply. The template is the contract emitted by every `clean-coder` reply path; the audit-skill wiring (`bugteam`, `pr-converge`) reads it before authoring a reply.
 
+Use `~/.claude/rules/asd-ste100-language.md` for user-facing word choice,
+sentence style, tone, punctuation, and prose form. This template owns review
+thread fields, evidence slots, and action/status structure.
+
 This doc has two surfaces, called out separately so consumers do not conflate them: the **reply template** (this section and below) shapes the body Claude posts back to a single review thread; the **audit body skeleton** in [Relationship to the audit review body](#relationship-to-the-audit-review-body) shapes the parent review `post_audit_thread.py` posts at audit time. The reply-template consumers are the skills/agents listed above (read-only `clean-room audit` is excluded — it posts an audit review via `post_audit_thread.py` but never authors thread replies). The audit-body-skeleton consumers include `clean-room audit` alongside `bugteam` because both post audit reviews via the same script.
 
 ## Provenance

package/_shared/pr-loop/fix-protocol.md

@@ -7,9 +7,9 @@
 3. **Capture pre-fix file contents** for every file this fix will touch. Used in step 8 for the post-fix self-audit diff.
 4. **TDD where applicable:** when the finding has behavior to test, write a failing test first; for pure doc, comment, or naming nits with no behavior, fix directly.
 5. **Apply each fix:**
-   - Preserve existing comments on lines left unchanged
-   - Add complete type hints on every signature touched
-   - Use positive framing in any new prose (no banned negatives)
+    - Preserve existing comments on lines left unchanged
+    - Add complete type hints on every signature touched
+    - Apply `~/.claude/rules/asd-ste100-language.md` to new user-facing prose
 6. **Validate each modified Python file:** `python -m py_compile <path>`. Halt on syntax error; fix and re-run.
 7. **Compute fix diff:** the diff between pre-fix and post-fix file contents for every modified file.
 8. **Post-fix self-audit:** follow [`audit-contract.md`](audit-contract.md) post-fix self-audit sequence. Internal iteration cap: 3. Three rounds with fresh findings → exit `stuck: post-fix audit not converging`. Only when `gate_findings` empty AND `post_fix_findings` empty → proceed to git add.
@@ -40,10 +40,11 @@
     - `status=could_not_address`: `Could not address this loop` / one-line reason text.
     - `status=hook_blocked`: `Hook blocked the fix commit` / one-line hook summary.
 
-    Transport: post the reply via [`gh-payloads.md`](gh-payloads.md), then call `pull_request_review_write(method="resolve_thread", threadId=<thread_node_id>, ...)` for the same thread before moving to the next finding (this is the PR review thread node ID — `PRRT_kwDOxxx` — distinct from the numeric comment ID; harvest it at audit time when calling `get_review_comments`, see [`skills/bugteam/reference/obstacles/fix-resolve-thread.md`](../../skills/bugteam/reference/obstacles/fix-resolve-thread.md)).
+    Transport: post the reply via [`gh-payloads.md`](gh-payloads.md), then call `pull_request_review_write(method="resolve_thread", threadId=<thread_node_id>, ...)` for the same thread before moving to the next finding (this is the PR review thread node ID — `PRRT_kwDOxxx` — distinct from the numeric comment ID; harvest it at audit time when calling `get_review_comments`; see the archived [`fix-resolve-thread` runbook](../../.agents/skills-archived/bugteam/reference/obstacles/fix-resolve-thread.md)).
 13. **Re-trigger reviewer** when the calling workflow specifies. Workflow-specific:
-    - `pr-converge`: post `bugbot run` issue comment after every push (Cursor Bugbot); when the multi-PR path also needs Copilot, call `requested_reviewers` for Copilot as well
-    - `bugteam`: skip — Claude itself is the reviewer; the next loop iteration audits
+    - **autoconverge** — terminal Bugbot, Copilot, and Codex gates re-run after each fix push per [`../../.agents/skills/autoconverge/reference/convergence.md`](../../.agents/skills/autoconverge/reference/convergence.md)
+    - **Archived pr-converge** — post `bugbot run` after every push; see archived skill reference
+    - **Archived bugteam** — skip external re-trigger; the next loop iteration audits
 
 ## Stuck detection
 

package/_shared/pr-loop/gh-payloads.md

@@ -1,6 +1,7 @@
 # MCP-based payloads
 
-Shared payload shapes for posting PR reviews and replies. Used by `bugteam` and `pr-converge`.
+Shared payload shapes for posting PR reviews and replies. Used by autoconverge
+terminal gates and the archived `bugteam` / `pr-converge` skills.
 
 ## Build payloads with MCP tools
 
@@ -12,9 +13,11 @@ Posting the per-loop audit review is handled by
 [`_shared/pr-loop/scripts/post_audit_thread.py`](scripts/post_audit_thread.py).
 The script owns the review-create/POST/retry flow internally; callers no longer
 build the GitHub reviews-API payload themselves. See
-[`skills/bugteam/SKILL.md` § Audit posting](../../skills/bugteam/SKILL.md#audit-posting)
-for the contract and [`skills/bugteam/PROMPTS.md`](../../skills/bugteam/PROMPTS.md)
-for the AUDIT-step invocation shape.
+[`post-audit-thread-contract.md`](post-audit-thread-contract.md) for the contract
+and the archived
+[`bugteam` audit-posting section](../../.agents/skills-archived/bugteam/SKILL.md)
+for the historical invocation shape in
+[`PROMPTS.md`](../../.agents/skills-archived/bugteam/PROMPTS.md).
 
 ## Review body skeleton
 
@@ -57,7 +60,7 @@ user-facing output (chat reply to the user) rather than in the PR review body.
 
 There is no fallback payload to build. On retry exhaustion
 `post_audit_thread.py` exits `2` and the orchestrator halts — see
-[`./post-audit-thread-contract.md`](./post-audit-thread-contract.md) § Exit codes.
+[`post-audit-thread-contract.md`](post-audit-thread-contract.md) § Exit codes.
 A hard blocker on the audit-posting path is a halt condition, not a degraded
 flat-issue-comment fall-through.
 
@@ -70,4 +73,3 @@ flat-issue-comment fall-through.
 ## SHA capture timing
 
 `commit_id` and any `<head_sha_at_post_time>` reference: `git rev-parse HEAD` immediately before the POST, in the cwd of whichever subagent or process is posting.
-

package/_shared/pr-loop/precatch-rubric.md

@@ -17,11 +17,12 @@ sweep to have cleared them and reviews sweep-clean code.
 
 ## Lane 2 — Doc-vs-code parity
 
-Every doc claim in the diff matches the code it describes. Reuse the
-`pr-consistency-audit` skill's canonical-source cross-reference method
-(`~/.claude/skills/pr-consistency-audit/SKILL.md`, canonical source first) and the
-drift rubric at
-`~/.claude/audit-rubrics/category_rubrics/category-o-docstring-vs-impl-drift.md`.
+Every doc claim in the diff matches the code it describes. Reuse the cross-file
+consistency prompt at
+[`../../.agents/skills/_shared/pr-loop/prompts/pr-consistency-audit.xml`](../../.agents/skills/_shared/pr-loop/prompts/pr-consistency-audit.xml)
+(installed as `~/.claude/skills/_shared/pr-loop/prompts/pr-consistency-audit.xml`)
+and the drift rubric at
+[`../../audit-rubrics/category_rubrics/category-o-docstring-vs-impl-drift.md`](../../audit-rubrics/category_rubrics/category-o-docstring-vs-impl-drift.md).
 
 - Every line citation resolves to the line it names.
 - Every referenced file or script path exists.

package/_shared/pr-loop/scripts/AGENTS.md

@@ -19,6 +19,18 @@ Python scripts invoked at runtime by the PR-loop skills. Each script is a standa
 | `reviewer_availability.py` | Unified reviewer-availability entry point for Copilot and Bugbot: reuses `copilot_quota.py` and `reviews_disabled.py` and exits 0 when the named `--reviewer` may be spawned, non-zero when it is opted out or (for Copilot) out of quota |
 | `fix_hookspath.py` | Repairs a malformed `core.hooksPath` global git config entry |
 | `_claude_permissions_common.py` | Internal helpers shared by the grant/revoke scripts: atomic settings.json writes, list mutation, path helpers |
+| `check_convergence.py` | Single convergence gate check for autoconverge finalize and mark-ready hooks |
+| `check_bugbot_ci.py` | Bugbot CI check-run status on a given SHA |
+| `check_convergence_availability.py` | Reviewer waiver resolution for convergence gates |
+| `check_convergence_gates.py` | GitHub REST leaf checks for convergence gates |
+| `check_convergence_thread_gates.py` | GitHub GraphQL and REST thread gate checks |
+| `check_pending_reviews.py` | Pending review requests and reviewer states |
+| `fetch_copilot_reviews.py` | Copilot reviews filtered to the current HEAD |
+| `post_fix_reply.py` | Inline reply poster for review comment threads |
+| `run_codex_review.py` | Codex review capture wrapper for the autoconverge Codex gate |
+| `codex_usage_probe.py` | Weekly Codex usage probe for gate threshold decisions |
+| `codex_down_classifier.py` | Maps Codex run outcomes to completed or codex_down |
+| `parse_codex_findings.py` | Parses Codex reviewer output into findings |
 
 ## Subdirectories
 
@@ -26,6 +38,9 @@ Python scripts invoked at runtime by the PR-loop skills. Each script is a standa
 |---|---|
 | `code_rules_gate_parts/` | The decomposed modules `code_rules_gate.py` wires together: enforcer loading, git file sets, blob readers, added-line maps, violation scoping, wrapper plumb-through, gate running, staged-test running, and argument parsing |
 | `pr_loop_shared_constants/` | Named constants used by the scripts above |
+| `pr_converge_skill_constants/` | Bot logins, review states, and API templates for convergence scripts |
+| `pr_converge_scripts_constants/` | CLI and reflow constants for convergence scripts |
+| `codex_review_scripts_constants/` | Constants for Codex review capture and classification |
 | `tests/` | pytest suite for all scripts in this directory |
 
 ## Running tests

package/_shared/pr-loop/scripts/_pr_converge_path_setup.py

@@ -0,0 +1,38 @@
+"""Put shared PR-loop script directories on sys.path for standalone runs.
+
+Importing this module makes the convergence constants packages and the shared
+``reviews_disabled`` module resolvable when a script in this directory runs
+as ``__main__``. Each directory is added once, guarded against duplicates.
+
+Scripts ship under ``packages/claude-dev-env/_shared/pr-loop/scripts/`` and
+install to ``~/.claude/_shared/pr-loop/scripts/``.
+"""
+
+import sys
+from pathlib import Path
+
+_scripts_directory = Path(__file__).resolve().parent
+_skill_directory = _scripts_directory.parent
+_skills_directory = _skill_directory.parent
+_skills_home_directory = _skills_directory.parent
+_package_or_user_home = (
+    _skills_home_directory.parent
+    if _skills_home_directory.name == ".agents"
+    else _skills_home_directory
+)
+_shared_under_package = _package_or_user_home / "_shared" / "pr-loop" / "scripts"
+_shared_under_claude = (
+    _package_or_user_home / ".claude" / "_shared" / "pr-loop" / "scripts"
+)
+_shared_pr_loop_scripts_directory = (
+    _shared_under_package
+    if _shared_under_package.is_dir()
+    else _shared_under_claude
+)
+
+if str(_scripts_directory) not in sys.path:
+    sys.path.insert(0, str(_scripts_directory))
+if str(_skill_directory) not in sys.path:
+    sys.path.insert(0, str(_skill_directory))
+if str(_shared_pr_loop_scripts_directory) not in sys.path:
+    sys.path.insert(0, str(_shared_pr_loop_scripts_directory))