@event4u/agent-config 3.3.0 → 4.1.0

package/docs/contracts/plain-language-surface.md

@@ -0,0 +1,117 @@
+---
+stability: beta
+keep-beta-until: 2026-08-26
+roadmap_ref: road-to-frictionless-employee-workspace.md
+---
+
+# Plain-Language Surface Contract
+
+> **Status** · v0 / beta · 2026-05-26. Defines the user-facing
+> relabel matrix for non-developer audiences. Phase C of
+> `road-to-frictionless-employee-workspace.md`. The matrix is the
+> single source of truth; lint enforcement lives in
+> `scripts/lint_role_experiences.py --plain-language`.
+
+## What this is
+
+A relabel matrix between the package's **technical vocabulary**
+(council, trust, packs, orchestration, contracts, advisory, …) and
+the **plain-language labels** non-developer audiences (galabau owner,
+sales rep, support agent, team leader, content creator, consultant)
+expect to read.
+
+The matrix does **not** rename the technical vocabulary in
+developer-facing artefacts (`SKILL.md`, rule files, ADRs,
+`docs/contracts/`, `docs/decisions/`, `agents/contexts/`, scripts).
+The technical vocabulary earned its place there. The matrix only
+governs three user-facing surfaces:
+
+1. **Workspace UI strings** (`src/ui/pages/WorkspacePage.tsx` and its
+   child components — buttons, headings, tooltips, banner text).
+2. **`docs/getting-started-by-role.md`** — the non-developer entry
+   surface. Engineering-lead and developer sections keep the
+   technical vocabulary.
+3. **Role experience `index.md` bodies** (`agents/roles/<slug>/index.md`)
+   — the one-paragraph identity + first-task descriptions. The
+   `skills.yml` files are link-targets, not user prose, and keep
+   the skill IDs verbatim.
+
+## Why
+
+The 9.3/10 feedback round (2026-05-25) caught six jargon terms a
+sales rep / galabau owner / support agent does not parse on first
+read: `council`, `trust level`, `pack`, `orchestration`, `contract`,
+`advisory`. Replacing them in the non-developer surface lifts the
+"Daily workspace UX" score from 5.5/10 toward the ≥ 7.5/10 acceptance
+gate; the technical vocabulary survives in the developer-facing
+artefacts where reviewers, contributors, and agents continue to read
+them.
+
+## Matrix
+
+| Technical term | Plain-language label | Applies to surface |
+|---|---|---|
+| `council` | `second-opinion check` | Workspace UI · role indices · getting-started |
+| `trust level` | `reliability score` | Workspace UI · role indices · getting-started |
+| `pack` | `ready-made setup` | Workspace UI · role indices · getting-started |
+| `orchestration` | `multi-step workflow` | Workspace UI · role indices · getting-started |
+| `contract` | `guarantee` | Workspace UI · role indices · getting-started |
+| `advisory` | `recommendation` | Workspace UI · role indices · getting-started |
+
+## Carve-outs — surfaces that keep the technical vocabulary
+
+The matrix MUST NOT apply to:
+
+- `.agent-src.uncondensed/`, `.agent-src/`, `.augment/`, `.claude/`,
+  `.cursor/`, `.windsurf/`, `.clinerules/` — all skill / rule /
+  command / persona artefacts.
+- `docs/contracts/`, `docs/decisions/`, `docs/architecture.md`,
+  `docs/getting-started-laravel.md`, every other developer-facing
+  doc.
+- `agents/contexts/`, `agents/roadmaps/`, `scripts/`, source code,
+  test fixtures, golden output files.
+- The developer / engineering-lead sections inside
+  `docs/getting-started-by-role.md` — those readers are the audience
+  for the technical vocabulary.
+- `agents/roles/<slug>/skills.yml` — the skill IDs are URL slugs,
+  not user prose. The `why:` strings stay neutral so the launcher's
+  shortlist rail is informative; both audiences read them.
+
+## Lint enforcement
+
+`scripts/lint_role_experiences.py --plain-language` scans every
+`agents/roles/<slug>/index.md` body for the six jargon terms.
+Frontmatter and fenced code blocks are excluded. Any hit fails the
+lint with a pointer back to this contract. Phase C Step 5 wires the
+flag into `task ci`.
+
+## Tone scaffold
+
+When a relabel feels awkward, default to the role's own language:
+the galabau owner does not call something a "second-opinion check"
+verbatim either, but they understand it instantly. Compare:
+
+- **Technical:** "the council ruled this trust level is `community`."
+- **Plain:** "the second-opinion check rated this reliability score
+  as community-built (less reviewed than core)."
+
+The plain version is longer; that is the cost of readability for
+non-developer audiences. Workspace UI strings stay short by carrying
+the relabel without the explanation (the explanation lives in the
+plain-explain right-rail toggle).
+
+## Re-audit cadence
+
+Re-audit on each of:
+- A new jargon term entering the user-facing surface (caught either
+  by lint or by a feedback round).
+- A role experience adding a section the matrix does not cover.
+- A reviewer round (recruit-session) that names a relabel the matrix
+  missed.
+
+## See also
+
+- [`docs/getting-started-by-role.md`](../getting-started-by-role.md) — the entry surface.
+- [`docs/contracts/role-experience.md`](role-experience.md) — role artefact shape.
+- [`scripts/lint_role_experiences.py`](../../scripts/lint_role_experiences.py) — lint enforcement.
+- `road-to-frictionless-employee-workspace.md` § Phase C — the roadmap step.

package/docs/contracts/profile-system.md

@@ -18,7 +18,7 @@ keep-beta-until: 2026-08-14
 
 A **profile** declares the user's audience identity. Six seed profiles
 ship; users can declare their own under
-`.agent-src.uncompressed/profiles/<id>.yml`.
+`.agent-src.uncondensed/profiles/<id>.yml`.
 
 | `profile.id` | Audience | README entry-paragraph | Default `preset.id` |
 |---|---|---|---|
@@ -101,7 +101,7 @@ command (Phase 1 item 3).
 ## User-defined profiles
 
 A consumer project MAY ship a custom profile under
-`.agent-src.uncompressed/profiles/<id>.yml`. Constraints:
+`.agent-src.uncondensed/profiles/<id>.yml`. Constraints:
 
 - `id` MUST be unique across seed + user-defined profiles.
 - Shape MUST match the seed contract above (audience / defaults / surface).
@@ -121,7 +121,7 @@ Only changes to the **seed set** require an ADR.
 - A profile YAML references a non-existent `preset_id`.
 - The seed-profile count diverges from this contract's table.
 - `defaults.personas` references a persona id that does not exist
-  under `.agent-src.uncompressed/personas/`.
+  under `.agent-src.uncondensed/personas/`.
 
 ## Non-goals
 

package/docs/contracts/release-pr-gating.md

@@ -0,0 +1,103 @@
+# Release-PR Gating Contract
+
+> **Status:** active · **Owner:** maintainer (`scripts/release.py`) · **Opened:** 2026-05-26
+>
+> Source: `road-to-optimized-ci-and-release-gates.md` Phase A Step 1. Measured
+> baseline (`gh run list --branch main --limit 50`): `Public Install Smoke`
+> avg **413 s** (3-OS × 2-Node matrix), `Tests` avg **218 s** (Linux + macOS
+> + Windows). Both trigger on `package.json`. Release PRs (`release/X.Y.Z`)
+> only touch `package.json`, `CHANGELOG.md`, `marketplace.json`,
+> `packages/*/pack.yaml`, `packages/*/README.md` — verified against PR #238
+> (3.3.0). They cannot regress install or runtime behaviour by construction.
+
+## Release-PR shape
+
+A pull request qualifies as a **release PR** when **both** of the following
+hold:
+
+1. **Head branch matches** `^release/\d+\.\d+\.\d+$` — same regex as
+   `scripts/release.py` § `_RELEASE_BRANCH_RE`.
+2. **Diff file set is a subset of the version-bump allowlist:**
+   - `package.json`
+   - `CHANGELOG.md`
+   - `.claude-plugin/marketplace.json`
+   - `packages/*/pack.yaml`
+   - `packages/*/README.md`
+
+Both predicates are enforced by `scripts/check_release_pr_shape.py`
+(stdlib-only, ≤ 150 LOC). The script exits 0 when both hold; non-zero with
+a per-file diff naming any out-of-allowlist entry otherwise.
+
+## Cut surface — heavy jobs that skip on release PRs
+
+Skipped via `if: !startsWith(github.head_ref, 'release/')` guards on the
+heavy install/test jobs. These are the jobs that release PRs cannot regress
+by construction (no install scripts, no runtime code, no test source in the
+release-PR allowlist):
+
+| Workflow | Job | Why it cuts |
+|---|---|---|
+| `tests.yml` | `install-tests` | release-PR diff has no `install.sh` / `scripts/install.py` / `tests/test_install.sh` |
+| `tests.yml` | `install-aux-tests` | same — orchestrator, key contracts, one-liner smoke all untouched |
+| `tests.yml` | `python-tests` | release-PR diff has no `scripts/**` or `tests/**` (other than CHANGELOG via path filter — see below) |
+| `tests.yml` | `node-tests` | release-PR diff has no `src/**`, `tests/{cli,server,ui}/**`, `packages/core/installer/**` |
+| `tests.yml` | `windows-lockfile-export` | release-PR diff has no `scripts/install_global*.py`, `scripts/cmd_export.py`, lockfile test surface |
+| `smoke-public-install.yml` | `smoke` | release-PR diff has no `scripts/install*`, `setup.sh`, `templates/**`, `package.json` runtime behaviour |
+
+`push:` to `main` and the weekly cron on `smoke-public-install.yml` stay
+**unconditional** — those catch drift the PR matrix can't see.
+
+## Kept surface — release PRs still prove these
+
+The release-PR required-check floor stays equivalent (smaller, faster) to
+the feature-PR floor by adding:
+
+| Workflow | Job | Proves |
+|---|---|---|
+| `consistency.yml` | (existing) | `task consistency` — source-of-truth integrity |
+| `smoke.yml` | `smoke-contracts` | Contract self-checks (kernel, router, hashes) |
+| `release-guard.yml` | `assert-version-matches-tag` | already gates `npm publish`; remains tag-trigger |
+| `migration-dry-run.yml` | (existing) | Migration plan dry-runs |
+| `release-validation.yml` (Phase B) | `release-shape` | shape detector — fails closed if diff exits the allowlist |
+| `release-validation.yml` (Phase B) | `changelog-entry` | CHANGELOG carries an entry matching the head-branch version |
+| `release-validation.yml` (Phase B) | `version-consistency` | `package.json` / `marketplace.json` / pack manifests agree on the version |
+
+## Rollback trigger — fail-closed
+
+The optimisation is **opt-in by shape, not by branch name**. A release-PR
+whose diff contains a stray file outside the allowlist (e.g. a last-minute
+CHANGELOG fixup that also touches `scripts/release.py`) trips the shape
+detector:
+
+1. `check_release_pr_shape.py` exits non-zero with a per-file diff.
+2. The CI dashboard surfaces "release-shape" red.
+3. The maintainer either narrows the diff (move the script edit to a
+   separate PR) or accepts the heavy matrix re-running on the next push.
+
+In other words: the cut applies only when shape is **provably** safe. Branch
+name alone never bypasses the heavy matrix.
+
+## What this contract is not
+
+- **Not a test-deletion contract.** Every existing assertion still runs
+  somewhere in the cadence (PR for feature PRs, push-to-main + weekly cron
+  for smoke).
+- **Not a coverage-reduction contract.** The release-validation jobs are
+  additive, not substitutive.
+- **Not a release-velocity contract.** Release cadence is driven by
+  Conventional Commits in `scripts/release.py`, not by CI cost.
+- **Not a Hard-Floor lift.** No security check is removed.
+  `release-guard.yml`'s `assert-version-matches-tag` job is independent of
+  `Tests` / `Public Install Smoke` and stays mandatory on every tag.
+
+## See also
+
+- `docs/contracts/branch-protection-policy.md` — per-PR-shape required-check
+  matrix (Phase D).
+- `docs/contracts/ci-cost-budget.md` — measured baselines + quarterly review
+  cadence (Phase C).
+- `.github/workflows/release-validation.yml` — the tight release-shape
+  validation workflow (Phase B).
+- `scripts/check_release_pr_shape.py` — the shape detector (Phase A).
+- `scripts/release.py` § `_RELEASE_BRANCH_RE` — source of truth for the
+  release-branch naming convention.

package/docs/contracts/role-experience.md

@@ -1,6 +1,6 @@
 ---
 stability: beta
-keep-beta-until: 2026-08-24
+keep-beta-until: 2026-08-23
 ---
 
 # Role-experience contract
@@ -19,7 +19,7 @@ A folder at `agents/roles/<role>/` that contains:
 
 A role experience is **not**:
 
-- A new skill — the shortlist references existing skills under `packages/<pack>/.agent-src.uncompressed/skills/`. The role experience curates; it does not implement.
+- A new skill — the shortlist references existing skills under `packages/<pack>/.agent-src.uncondensed/skills/`. The role experience curates; it does not implement.
 - A documentation page — `docs/getting-started-by-role.md` is the prose surface and links **to** the role experience, never duplicates it.
 - A persona file under `personas/` — personas are review voices the AI Council uses; role experiences are end-user entry points.
 
@@ -92,7 +92,7 @@ skills:
     why: "Section-by-section drafting flow for longer offers."
 ```
 
-Every `id` must resolve to an existing skill under `packages/<pack>/.agent-src.uncompressed/skills/<id>/SKILL.md` — verified by the lint pass in Phase 3 Step 6.
+Every `id` must resolve to an existing skill under `packages/<pack>/.agent-src.uncondensed/skills/<id>/SKILL.md` — verified by the lint pass in Phase 3 Step 6.
 
 ## Versioning + status
 

package/docs/contracts/rule-classification.md

@@ -7,7 +7,7 @@ keep-beta-until: 2026-08-12
 # Rule Classification — Phase 1.2 of road-to-kernel-and-router
 
 > **Status:** active · **Stability:** beta · **Owner:** road-to-kernel-and-router P1.2
-> · **Source of truth:** `.agent-src.uncompressed/rules/*.md`
+> · **Source of truth:** `.agent-src.uncondensed/rules/*.md`
 
 Migration plan for all 56 source rules. **No edits land here** — this
 document is the disposition map P2 / P4 will execute against.
@@ -16,8 +16,8 @@ document is the disposition map P2 / P4 will execute against.
 
 | code | meaning |
 |---|---|
-| `keep-in-kernel` | Iron Law floor / behaviour / safety / tone / ask-policy. Loaded every session. Compressed to ≤ 2.5k chars (P2.2; raised from 1.5k per Council R2). |
-| `compress-and-keep` | Behavioural rule that stays in `rules/` as auto-tier. Compressed in place per the P2.2 playbook. Loaded by router on trigger match. |
+| `keep-in-kernel` | Iron Law floor / behaviour / safety / tone / ask-policy. Loaded every session. Condensed to ≤ 2.5k chars (P2.2; raised from 1.5k per Council R2). |
+| `condense-and-keep` | Behavioural rule that stays in `rules/` as auto-tier. Condensed in place per the P2.2 playbook. Loaded by router on trigger match. |
 | `move-to-skill:<id>` | Procedural how-to content. Body migrates into the named skill (P4.1); rule shrinks to Iron Law one-liner + `routes_to:`. |
 | `move-to-guideline:<id>` | Reference / examples / mechanics tables. Body migrates into `docs/guidelines/<id>.md` (P4.2); rule keeps Iron Law + pointer. |
 
@@ -51,25 +51,25 @@ yet.
 | scope-control | 4368 | `keep-in-kernel` | Iron Law (safety-floor): no unsolicited refactors / git-ops gate |
 | verify-before-complete | 2344 | `keep-in-kernel` | Iron Law: no completion claims without fresh verification |
 
-**Always-bucket total: 32 403 chars.** Pilot compression rate `r`
+**Always-bucket total: 32 403 chars.** Pilot condensation rate `r`
 locked at **median 0.712** (P1.3, Council R2 amendment); projection
 sum = 23 071 chars, under the 25k hard cap with 1 929 chars headroom.
 Per-rule cap raised to ≤ 2.5k (Council R2). Iron-Law-override ADRs
 may lift individual rules above 2.5k where Iron-Law density forbids
-further compression — currently 2 expected (`direct-answers` +342,
+further condensation — currently 2 expected (`direct-answers` +342,
 `language-and-tone` +1286). See `kernel-membership.md` § 5.
 
 > **Council swap ADR (P2.1 input).** Sonnet 4.5 flagged
 > `agent-authority` as a routing index (no Iron-Law fence; should
 > demote to auto-tier-3) and `autonomous-execution` (currently
-> `compress-and-keep` below) as a mode-independent Band-4 authority
+> `condense-and-keep` below) as a mode-independent Band-4 authority
 > that should promote to kernel. Swap accepted ⇒ +1213 chars over
 > the 25k cap. Decision deferred to P2.1 ADR; current dispositions
 > below remain locked until the ADR resolves.
 
-### § 3.2 — auto-rules: compress-and-keep (22)
+### § 3.2 — auto-rules: condense-and-keep (22)
 
-Behavioural rules with too much Iron-Law content for migration; compress
+Behavioural rules with too much Iron-Law content for migration; condense
 in place per P2.2 playbook. Loaded by router on trigger match.
 
 | id | chars | tier | rationale |
@@ -101,7 +101,7 @@ in place per P2.2 playbook. Loaded by router on trigger match.
 
 Procedural how-to. Rule body migrates into named skill (P4.1); rule
 shrinks to Iron-Law one-liner + `routes_to:`. Skill IDs reference
-existing skills under `.agent-src.uncompressed/skills/`.
+existing skills under `.agent-src.uncondensed/skills/`.
 
 | id | chars | target skill | rationale |
 |---|---:|---|---|
@@ -130,7 +130,7 @@ Reference / examples / mechanics. Body migrates into
 
 | id | chars | target guideline | rationale |
 |---|---:|---|---|
-| artifact-engagement-recording | 3462 | `artifact-engagement-flow` | Mechanics doc lives in `.agent-src.uncompressed/contexts/contracts/` (P4.1) |
+| artifact-engagement-recording | 3462 | `artifact-engagement-flow` | Mechanics doc lives in `.agent-src.uncondensed/contexts/contracts/` (P4.1) |
 | augment-portability | 2956 | `augment-portability-patterns` | Project-agnostic-patterns reference |
 | command-suggestion-policy | 3954 | `command-suggestion-flow` | Flow doc already exists |
 | php-coding | 3433 | `php-coding-patterns` | Reference table; per-stack |
@@ -142,9 +142,9 @@ Reference / examples / mechanics. Body migrates into
 
 | check | command | acceptance |
 |---|---|---|
-| Coverage | `python3 scripts/measure_rule_budget.py` | 56 rules total → 9 kernel + 22 compress + 18 skill + 7 guideline |
+| Coverage | `python3 scripts/measure_rule_budget.py` | 56 rules total → 9 kernel + 22 condense + 18 skill + 7 guideline |
 | Determinism | `python3 scripts/measure_rule_budget.py --json` × 2 | byte-identical output |
-| No-edits | `git diff --stat .agent-src.uncompressed/rules/` | clean (this is plan-only) |
+| No-edits | `git diff --stat .agent-src.uncondensed/rules/` | clean (this is plan-only) |
 
 ## § 5 — Open questions
 
@@ -166,6 +166,6 @@ Reference / examples / mechanics. Body migrates into
    spec; flagged by Council R2 to prevent inconsistent implementer
    calls.
 5. **`think-before-action` / `context-hygiene` / `augment-source-of-
-   truth` boundary.** Currently `compress-and-keep` (auto). Council
+   truth` boundary.** Currently `condense-and-keep` (auto). Council
    did not flag for promotion; revisit only if the swap ADR (#1)
    forces a re-projection.

package/docs/contracts/rule-interactions.md

@@ -6,7 +6,7 @@ keep-beta-until: 2026-08-12
 # Rule-Interaction Matrix
 
 > **Audience:** rule authors and reviewers — anyone editing
-> `.agent-src.uncompressed/rules/*.md` or proposing a new always-rule.
+> `.agent-src.uncondensed/rules/*.md` or proposing a new always-rule.
 > **Authoritative source:** [`rule-interactions.yml`](rule-interactions.yml).
 > **Linter:** `scripts/lint_rule_interactions.py` (run via `task lint-rule-interactions`).
 
@@ -73,8 +73,8 @@ The YAML uses six relation kinds. Definitions:
   conflict: …                                                  # what triggers both
   resolution: …                                                # what the agent does
   evidence:
-    - .agent-src.uncompressed/rules/non-destructive-by-default.md#the-iron-law
-    - .agent-src.uncompressed/rules/autonomous-execution.md#hard-floor--see-non-destructive-by-default
+    - .agent-src.uncondensed/rules/non-destructive-by-default.md#the-iron-law
+    - .agent-src.uncondensed/rules/autonomous-execution.md#hard-floor--see-non-destructive-by-default
 ```
 
 `rules: [a, b]` is ordered: `a` is senior (wins on conflict), `b` is
@@ -117,7 +117,7 @@ source of truth and weaken it. Canonical contracts:
 | Decision-trace shape (what the engine emits per phase) | [`decision-trace-v1.md`](decision-trace-v1.md) |
 | Memory contract (entries, scopes, retention) | [`agent-memory-contract.md`](agent-memory-contract.md) |
 | Memory visibility in the trace (`affected` keys) | [`memory-visibility-v1.md`](memory-visibility-v1.md) |
-| AI-Council consultation flow | [`../skills/ai-council/SKILL.md`](../../.agent-src.uncompressed/skills/ai-council/SKILL.md) |
+| AI-Council consultation flow | [`../skills/ai-council/SKILL.md`](../../.agent-src.uncondensed/skills/ai-council/SKILL.md) |
 
 Where an `always`-rule **does** interact with one of these surfaces
 (e.g. `non-destructive-by-default` gating a memory-driven action), the

package/docs/contracts/rule-interactions.yml

@@ -8,7 +8,7 @@
 # Schema:
 #   version: integer
 #   rules: list of rule slugs that participate in any interaction (each
-#     must exist as `.agent-src.uncompressed/rules/<slug>.md`)
+#     must exist as `.agent-src.uncondensed/rules/<slug>.md`)
 #   pairs: list of pairwise interactions
 #     - id:        kebab-case stable identifier
 #       rules:     [senior, junior] — `senior` wins on conflict
@@ -49,8 +49,8 @@ pairs:
       numbered-options block, wait for explicit user confirmation on
       this turn before proceeding.
     evidence:
-      - .agent-src.uncompressed/rules/non-destructive-by-default.md#the-iron-law
-      - .agent-src.uncompressed/rules/autonomous-execution.md#hard-floor--see-non-destructive-by-default
+      - .agent-src.uncondensed/rules/non-destructive-by-default.md#the-iron-law
+      - .agent-src.uncondensed/rules/autonomous-execution.md#hard-floor--see-non-destructive-by-default
 
   - id: ndd-x-scope-control
     rules: [non-destructive-by-default, scope-control]
@@ -64,9 +64,9 @@ pairs:
       cannot be weakened by future scope-control edits. On any conflict,
       the floor wins.
     evidence:
-      - .agent-src.uncompressed/rules/non-destructive-by-default.md#the-iron-law
-      - .agent-src.uncompressed/rules/scope-control.md#git-operations--permission-gated
-      - .agent-src.uncompressed/rules/scope-control.md#production-infrastructure-bulk-destructive--hard-floor
+      - .agent-src.uncondensed/rules/non-destructive-by-default.md#the-iron-law
+      - .agent-src.uncondensed/rules/scope-control.md#git-operations--permission-gated
+      - .agent-src.uncondensed/rules/scope-control.md#production-infrastructure-bulk-destructive--hard-floor
 
   - id: ndd-x-commit-policy
     rules: [non-destructive-by-default, commit-policy]
@@ -82,8 +82,8 @@ pairs:
       then commit. The four exceptions cover *whether* commits happen;
       the floor covers *which diffs* still need a separate confirmation.
     evidence:
-      - .agent-src.uncompressed/rules/non-destructive-by-default.md#the-iron-law
-      - .agent-src.uncompressed/rules/commit-policy.md#hard-floor-still-applies--bulk-deletions-and-infra-changes
+      - .agent-src.uncondensed/rules/non-destructive-by-default.md#the-iron-law
+      - .agent-src.uncondensed/rules/commit-policy.md#hard-floor-still-applies--bulk-deletions-and-infra-changes
 
   - id: ndd-x-ask-when-uncertain
     rules: [non-destructive-by-default, ask-when-uncertain]
@@ -97,8 +97,8 @@ pairs:
       provides the question shape (one numbered-options block, blocking).
       No conflict; both fire harmoniously.
     evidence:
-      - .agent-src.uncompressed/rules/non-destructive-by-default.md#failure-modes
-      - .agent-src.uncompressed/rules/ask-when-uncertain.md#vague-request-triggers--must-ask
+      - .agent-src.uncondensed/rules/non-destructive-by-default.md#failure-modes
+      - .agent-src.uncondensed/rules/ask-when-uncertain.md#vague-request-triggers--must-ask
 
   - id: ndd-x-verify-before-complete
     rules: [non-destructive-by-default, verify-before-complete]
@@ -112,8 +112,8 @@ pairs:
       verification evidence in the same message. Skipping either is a
       rule violation.
     evidence:
-      - .agent-src.uncompressed/rules/non-destructive-by-default.md#the-iron-law
-      - .agent-src.uncompressed/rules/verify-before-complete.md#the-iron-law
+      - .agent-src.uncondensed/rules/non-destructive-by-default.md#the-iron-law
+      - .agent-src.uncondensed/rules/verify-before-complete.md#the-iron-law
 
   - id: autonomy-x-scope-control
     rules: [scope-control, autonomous-execution]
@@ -127,8 +127,8 @@ pairs:
       suppresses *trivial* questions only; git-shape decisions are
       blocking. Stop and ask.
     evidence:
-      - .agent-src.uncompressed/rules/scope-control.md#git-operations--permission-gated
-      - .agent-src.uncompressed/rules/autonomous-execution.md#blocking--still-ask-regardless-of-personalautonomy
+      - .agent-src.uncondensed/rules/scope-control.md#git-operations--permission-gated
+      - .agent-src.uncondensed/rules/autonomous-execution.md#blocking--still-ask-regardless-of-personalautonomy
 
   - id: autonomy-x-commit-policy
     rules: [commit-policy, autonomous-execution]
@@ -141,8 +141,8 @@ pairs:
       committing unless one of the four exceptions applies. Autonomy
       does not add a fifth exception.
     evidence:
-      - .agent-src.uncompressed/rules/commit-policy.md#the-iron-law
-      - .agent-src.uncompressed/rules/autonomous-execution.md#commit-policy--see-commit-policy
+      - .agent-src.uncondensed/rules/commit-policy.md#the-iron-law
+      - .agent-src.uncondensed/rules/autonomous-execution.md#commit-policy--see-commit-policy
 
   - id: authority-x-ndd
     rules: [agent-authority, non-destructive-by-default]
@@ -155,8 +155,8 @@ pairs:
       Floor's Iron Law lives verbatim in `non-destructive-by-default`
       and wins every conflict. The index points; it never restates.
     evidence:
-      - .agent-src.uncompressed/rules/agent-authority.md#index-rules
-      - .agent-src.uncompressed/rules/non-destructive-by-default.md#the-iron-law
+      - .agent-src.uncondensed/rules/agent-authority.md#index-rules
+      - .agent-src.uncondensed/rules/non-destructive-by-default.md#the-iron-law
 
   - id: authority-x-scope-control
     rules: [agent-authority, scope-control]
@@ -169,8 +169,8 @@ pairs:
       scope-expansion decisions. Index never narrows or weakens the
       gate; canonical rule wins on any wording divergence.
     evidence:
-      - .agent-src.uncompressed/rules/agent-authority.md#index-rules
-      - .agent-src.uncompressed/rules/scope-control.md#git-operations--permission-gated
+      - .agent-src.uncondensed/rules/agent-authority.md#index-rules
+      - .agent-src.uncondensed/rules/scope-control.md#git-operations--permission-gated
 
   - id: authority-x-commit-policy
     rules: [agent-authority, commit-policy]
@@ -184,8 +184,8 @@ pairs:
       edits to commit-policy do not require Index updates unless the
       band ordering changes.
     evidence:
-      - .agent-src.uncompressed/rules/agent-authority.md#index-rules
-      - .agent-src.uncompressed/rules/commit-policy.md#exceptions--when-committing-is-allowed
+      - .agent-src.uncondensed/rules/agent-authority.md#index-rules
+      - .agent-src.uncondensed/rules/commit-policy.md#exceptions--when-committing-is-allowed
 
   - id: scope-x-commit-policy
     rules: [scope-control, commit-policy]
@@ -201,8 +201,8 @@ pairs:
       tag operations. On commit specifics, defer to `commit-policy`;
       on other git ops, defer to `scope-control`.
     evidence:
-      - .agent-src.uncompressed/rules/scope-control.md#git-operations--permission-gated
-      - .agent-src.uncompressed/rules/commit-policy.md#the-iron-law
+      - .agent-src.uncondensed/rules/scope-control.md#git-operations--permission-gated
+      - .agent-src.uncondensed/rules/commit-policy.md#the-iron-law
 
   - id: ask-x-direct-answers
     rules: [ask-when-uncertain, direct-answers]
@@ -218,8 +218,8 @@ pairs:
       `direct-answers` shapes *how* the question reads — no flattery,
       no padding, shortest form that fully states the choice.
     evidence:
-      - .agent-src.uncompressed/rules/ask-when-uncertain.md#iron-law--one-question-per-turn-always
-      - .agent-src.uncompressed/rules/direct-answers.md#iron-law-3--brevity-by-default
+      - .agent-src.uncondensed/rules/ask-when-uncertain.md#iron-law--one-question-per-turn-always
+      - .agent-src.uncondensed/rules/direct-answers.md#iron-law-3--brevity-by-default
 
   - id: scope-x-verify-before-complete
     rules: [verify-before-complete, scope-control]
@@ -240,8 +240,8 @@ pairs:
       Skipping either is a rule violation; satisfying one does not
       satisfy the other.
     evidence:
-      - .agent-src.uncompressed/rules/verify-before-complete.md#the-iron-law
-      - .agent-src.uncompressed/rules/scope-control.md#git-operations--permission-gated
+      - .agent-src.uncondensed/rules/verify-before-complete.md#the-iron-law
+      - .agent-src.uncondensed/rules/scope-control.md#git-operations--permission-gated
 
   - id: language-x-direct-answers
     rules: [language-and-tone, direct-answers]
@@ -256,5 +256,5 @@ pairs:
       flattery-free reply in the user's language. Neither weakens the
       other.
     evidence:
-      - .agent-src.uncompressed/rules/language-and-tone.md#iron-law--mirror-the-users-language-always
-      - .agent-src.uncompressed/rules/direct-answers.md#iron-law-1--no-flattery
+      - .agent-src.uncondensed/rules/language-and-tone.md#iron-law--mirror-the-users-language-always
+      - .agent-src.uncondensed/rules/direct-answers.md#iron-law-1--no-flattery

package/docs/contracts/rule-priority-hierarchy.md

@@ -5,7 +5,7 @@ keep-beta-until: 2026-08-12
 
 # Rule Priority Hierarchy
 
-> **Audience:** anyone reading or editing `.agent-src.uncompressed/rules/*.md`,
+> **Audience:** anyone reading or editing `.agent-src.uncondensed/rules/*.md`,
 > or trying to predict which rule wins when several fire on the same turn.
 > **Machine-readable counterpart:** [`rule-interactions.yml`](rule-interactions.yml)
 > (linted by `scripts/lint_rule_interactions.py`).
@@ -32,15 +32,15 @@ fires — that band's canonical rule decides the turn.
 
 | Band | Rule | What it gates | Lifts under |
 |---|---|---|---|
-| 1 | [`non-destructive-by-default`](../../.agent-src.uncompressed/rules/non-destructive-by-default.md) | Prod-trunk merge · deploy · push · prod data/infra · whimsical bulk deletion · bulk-deletion or infra commit | **Never.** Explicit user confirmation *this turn* only. |
-| 2 | [`security-sensitive-stop`](../../.agent-src.uncompressed/rules/security-sensitive-stop.md) | Auth · billing · tenant boundaries · secrets · file uploads · webhooks · public endpoints | Threat-model pass completed and recorded *before* the edit. |
-| 3 | [`scope-control`](../../.agent-src.uncompressed/rules/scope-control.md) | Git ops (branch · PR · tag · push · merge · rebase) · architectural changes · new libraries · scope expansion | Explicit user permission *this turn* or unrevoked standing instruction. |
-| 4 | [`ask-when-uncertain`](../../.agent-src.uncompressed/rules/ask-when-uncertain.md) | Ambiguous requirements · vague-request triggers · fenced steps | Concrete evidence resolves the ambiguity, **or** user answers the single question. |
-| 5 | [`commit-policy`](../../.agent-src.uncompressed/rules/commit-policy.md) | Any `git commit` | Four exceptions only — explicit "commit now", standing instruction, `/commit*` invocation, roadmap authorization. |
-| 6 | [`verify-before-complete`](../../.agent-src.uncompressed/rules/verify-before-complete.md) | "Done" / "complete" claims · suggestions to commit, push, or PR | Fresh verification evidence in *this* message. |
-| 7 | [`autonomous-execution`](../../.agent-src.uncompressed/rules/autonomous-execution.md) | Trivial-vs-blocking classification · autonomy opt-in detection | Per-step decision; never above bands 1–6. |
-| 8 | [`command-suggestion-policy`](../../.agent-src.uncompressed/rules/command-suggestion-policy.md) | Surfacing slash-command matches as numbered options | User always picks; nothing auto-executes. |
-| 9 | [`language-and-tone`](../../.agent-src.uncompressed/rules/language-and-tone.md) | First-token language of every reply · `.md` always English | Mirror the user's last chat message — no momentum exception. |
+| 1 | [`non-destructive-by-default`](../../.agent-src.uncondensed/rules/non-destructive-by-default.md) | Prod-trunk merge · deploy · push · prod data/infra · whimsical bulk deletion · bulk-deletion or infra commit | **Never.** Explicit user confirmation *this turn* only. |
+| 2 | [`security-sensitive-stop`](../../.agent-src.uncondensed/rules/security-sensitive-stop.md) | Auth · billing · tenant boundaries · secrets · file uploads · webhooks · public endpoints | Threat-model pass completed and recorded *before* the edit. |
+| 3 | [`scope-control`](../../.agent-src.uncondensed/rules/scope-control.md) | Git ops (branch · PR · tag · push · merge · rebase) · architectural changes · new libraries · scope expansion | Explicit user permission *this turn* or unrevoked standing instruction. |
+| 4 | [`ask-when-uncertain`](../../.agent-src.uncondensed/rules/ask-when-uncertain.md) | Ambiguous requirements · vague-request triggers · fenced steps | Concrete evidence resolves the ambiguity, **or** user answers the single question. |
+| 5 | [`commit-policy`](../../.agent-src.uncondensed/rules/commit-policy.md) | Any `git commit` | Four exceptions only — explicit "commit now", standing instruction, `/commit*` invocation, roadmap authorization. |
+| 6 | [`verify-before-complete`](../../.agent-src.uncondensed/rules/verify-before-complete.md) | "Done" / "complete" claims · suggestions to commit, push, or PR | Fresh verification evidence in *this* message. |
+| 7 | [`autonomous-execution`](../../.agent-src.uncondensed/rules/autonomous-execution.md) | Trivial-vs-blocking classification · autonomy opt-in detection | Per-step decision; never above bands 1–6. |
+| 8 | [`command-suggestion-policy`](../../.agent-src.uncondensed/rules/command-suggestion-policy.md) | Surfacing slash-command matches as numbered options | User always picks; nothing auto-executes. |
+| 9 | [`language-and-tone`](../../.agent-src.uncondensed/rules/language-and-tone.md) | First-token language of every reply · `.md` always English | Mirror the user's last chat message — no momentum exception. |
 
 **Read direction:** top-to-bottom is *priority on conflict*, not chronology.
 A turn typically touches several bands at once; the hierarchy decides
@@ -55,9 +55,9 @@ which one's Iron Law gets the final say.
   canonical rule files. This hierarchy points; it does not paraphrase.
 - **Bands 1–2 are *Hard Floors*.** No autonomy setting, no roadmap step,
   no standing instruction lifts them. See
-  [`agent-authority`](../../.agent-src.uncompressed/rules/agent-authority.md)
+  [`agent-authority`](../../.agent-src.uncondensed/rules/agent-authority.md)
   § Index rules for the matching authority statement.
-- **Unsure → ask.** [`ask-when-uncertain`](../../.agent-src.uncompressed/rules/ask-when-uncertain.md)
+- **Unsure → ask.** [`ask-when-uncertain`](../../.agent-src.uncondensed/rules/ask-when-uncertain.md)
   is the universal escape hatch when the band is unclear.
 
 ## Worked examples
@@ -73,7 +73,7 @@ which one's Iron Law gets the final say.
 
 ## Cross-references
 
-- [`agent-authority`](../../.agent-src.uncompressed/rules/agent-authority.md) — the four-band authority router (bands 1–3 + 7 of this hierarchy).
+- [`agent-authority`](../../.agent-src.uncondensed/rules/agent-authority.md) — the four-band authority router (bands 1–3 + 7 of this hierarchy).
 - [`rule-interactions.md`](rule-interactions.md) — pairwise interaction narrative + Mermaid diagram.
 - [`rule-interactions.yml`](rule-interactions.yml) — machine-readable, CI-linted matrix.
 - [`STABILITY.md`](STABILITY.md) — what the `stability: beta` tag means for breaking changes.

package/docs/contracts/rule-router.md

@@ -71,9 +71,9 @@ resolves to the target file under:
 
 | kind | path |
 |---|---|
-| `skill` | `.agent-src.uncompressed/skills/<id>/SKILL.md` |
+| `skill` | `.agent-src.uncondensed/skills/<id>/SKILL.md` |
 | `guideline` | `docs/guidelines/<id>.md` |
-| `command` | `.agent-src.uncompressed/commands/<id>.md` |
+| `command` | `.agent-src.uncondensed/commands/<id>.md` |
 | `contract` | `docs/contracts/<id>.md` |
 
 Linter checks each target exists. `command` is for procedural rules

package/docs/contracts/safety-model.md

@@ -34,7 +34,7 @@ listed there cannot be set to `allow` here.
 ## Schema
 
 ```yaml
-# .agent-src.uncompressed/profiles/<id>.yml — new top-level key
+# .agent-src.uncondensed/profiles/<id>.yml — new top-level key
 profile:
   id: <profile.id>
   # ... existing fields ...