@event4u/agent-config 3.3.0 → 4.2.0

package/.agent-src/rules/preservation-guard.md

@@ -2,17 +2,17 @@
 type: "auto"
 tier: "2b"
 alwaysApply: false
-description: "Merging/refactoring/compressing skills, rules, commands, or guidelines — prevent quality loss"
+description: "Merging/refactoring/condensing skills, rules, commands, or guidelines — prevent quality loss"
 source: package
 triggers:
   - intent: "merge skill"
-  - intent: "compress rule"
+  - intent: "condense rule"
   - intent: "refactor artifact"
   - keyword: "Iron Law"
 validator_ignore:
   - type: "substring"
-    pattern: ".agent-src.uncompressed/"
-    reason: "Rule references the authoring tree as the operand of compression/preservation."
+    pattern: ".agent-src.uncondensed/"
+    reason: "Rule references the authoring tree as the operand of condensation/preservation."
 workspaces:
   - agent-config-maintainer
 packs:
@@ -29,10 +29,10 @@ install:
 
 # Preservation Guard
 
-When transforming any agent artifact (merge, refactor, compress, split, restructure),
+When transforming any agent artifact (merge, refactor, condense, split, restructure),
 the result must be **at least as strong** as the original.
 
-## Iron Laws — every passage stays, caveman is fine
+## Iron Laws — every passage stays, telegraph is fine
 
 Sections marked **Iron Law** (any heading matching `# Iron Law`, `# Iron Laws`,
 `# The Iron Law`, at any heading level, including numbered variants like
@@ -45,21 +45,21 @@ preservation:
 - [ ] **Negation clauses preserved** — `NO X`, `NEVER Y`, `NOT Z` stay in. These
   are the load-bearing exception denials, not filler.
 - [ ] **Every passage stays** — every paragraph, every list item, and every
-  fenced code block from the source survives in the compressed output, in
+  fenced code block from the source survives in the condensed output, in
   order. One paragraph → one paragraph; one bullet → one bullet. Dropping
   whole sentences, merging two paragraphs into one, or skipping a list item
   is forbidden, even if the surviving prose still "makes the point".
 - [ ] **No Iron Law downgrades** — `## Iron Law` MUST NOT become `### Iron Law`,
   `**Iron Law:**`, or inline prose. Heading level is part of the prominence.
 
-**Caveman style is encouraged for Iron Law bodies** — drop articles ("the",
+**Telegraph style is encouraged for Iron Law bodies** — drop articles ("the",
 "a"), shorten phrasing, primitive grammar, terse cave-speak. Word count is
 not a budget; the structural unit count is. As long as every paragraph,
-bullet, and code block from the source is present, compress as hard as you
+bullet, and code block from the source is present, condense as hard as you
 want. What's forbidden is **deletion**: the rationale paragraph stays, the
 canonical-failure example stays, every "NEVER X" bullet stays.
 
-`scripts/check_compression.py` enforces these mechanically — any violation is
+`scripts/check_condensation.py` enforces these mechanically — any violation is
 an `error`, not a warning.
 
 ## Mandatory preservation checklist
@@ -94,13 +94,13 @@ Before completing any transformation, verify:
 - Skill merges (combining two skills into one)
 - Skill splits (extracting part of a skill)
 - Refactoring (restructuring without behavior change)
-- Compression (`.agent-src.uncompressed/` → `.agent-src/`)
+- Condensation (`.agent-src.uncondensed/` → `.agent-src/`)
 - Rule consolidation
 - Guideline restructuring
 
 ## References
 
-- Skill: `skill-management` — compression/refactoring modes
-- Skill: `skill-reviewer` — compression safety checks
-- Command: `/compress` — compression quality checklist
-- Linter: `scripts/skill_linter.py` — `check_compression_quality()`
+- Skill: `skill-management` — condensation/refactoring modes
+- Skill: `skill-reviewer` — condensation safety checks
+- Command: `/condense` — condensation quality checklist
+- Linter: `scripts/skill_linter.py` — `check_condensation_quality()`

package/.agent-src/rules/roadmap-ci-steps-policy.md

@@ -5,7 +5,7 @@ description: "Authoring or executing roadmaps — forbid task ci / make test / n
 source: package
 triggers:
   - path_prefix: "agents/roadmaps/"
-  - path_prefix: "app/Modules/"
+  - path_prefix: "{module_root}/"  # resolved via modules.root_paths; Laravel shape: app/Modules/
   - keyword: "task ci"
   - keyword: "make test"
   - keyword: "npm run check"
@@ -75,7 +75,8 @@ step's `- [ ]` line or its immediate inline `<!-- … -->` / `(…)` note.
 | `vendor/bin/phpunit` (whole-suite, no path arg) | `vendor/bin/phpunit` |
 | `php artisan test` (no `--filter`) | `php artisan test` |
 
-Targeted commands (`vendor/bin/phpstan analyse app/Modules/X`,
+Targeted commands (`vendor/bin/phpstan analyse <module-path>` such as
+`vendor/bin/phpstan analyse app/Modules/X` in Laravel,
 `php artisan test --filter=…`, `npm run lint -- --fix path/`) are
 **not** CI-shaped — narrow verifications, allowed regardless of the
 setting.
@@ -101,7 +102,10 @@ setting.
 
 `task lint-roadmap-ci-steps` (wired into `task ci-fast` /
 `lint-roadmap-complexity` cadence) scans `agents/roadmaps/*.md` and
-`app/Modules/*/agents/roadmaps/*.md`. Exit code:
+per-module roadmap dirs resolved via
+`scripts/_lib/agent_settings.py::enumerate_modules()`
+(`{module_path}/{modules.agent_folder}/roadmaps/*.md`; Laravel shape:
+`app/Modules/*/agents/roadmaps/*.md`). Exit code:
 
 - `0` — no CI-shaped steps, or setting is `true`, or every match is
   carve-out-marked.

package/.agent-src/rules/rule-type-governance.md

@@ -4,7 +4,7 @@ tier: "2a"
 description: "Creating/editing rules, or auditing rule types — decides when a rule should be always vs auto"
 source: package
 triggers:
-  - path_prefix: ".agent-src.uncompressed/rules/"
+  - path_prefix: ".agent-src.uncondensed/rules/"
 routes_to:
   - "guideline:agent-infra/rule-type-governance"
 workspaces:

package/.agent-src/rules/skill-quality.md

@@ -4,7 +4,7 @@ tier: "mechanical-already"
 description: "Creating/editing/reviewing skills — minimum quality standard; every skill executable, validated, self-contained"
 source: package
 triggers:
-  - path_prefix: ".agent-src.uncompressed/skills/"
+  - path_prefix: ".agent-src.uncondensed/skills/"
 routes_to:
   - "guideline:agent-infra/skill-quality-checklist"
 workspaces:

package/.agent-src/rules/{caveman-speak.md → telegraph-speak.md}

@@ -1,7 +1,7 @@
 ---
 type: "auto"
 tier: "1"
-description: "When caveman.speak_scope != off — compress prose to caveman grammar with carve-outs for numbered options, Iron-Law, code, paths, error markers"
+description: "When telegraph.speak_scope != off — condense prose to telegraph grammar with carve-outs for numbered options, Iron-Law, code, paths, error markers"
 source: package
 triggers:
   - intent: "any reply"
@@ -19,21 +19,21 @@ install:
   removable: false
 ---
 
-# Caveman Speak
+# Telegraph Speak
 
-Compress reply prose to caveman grammar per `caveman.speak_scope`. Body
+Condense reply prose to telegraph grammar per `telegraph.speak_scope`. Body
 prose only — carve-outs preserved byte-for-byte.
 
 ## Scope
 
-Read `caveman.speak_scope` from `.agent-settings.yml`:
+Read `telegraph.speak_scope` from `.agent-settings.yml`:
 
 - `off` — rule inactive.
-- `prose_only` (default) — caveman in body prose; carve-outs preserved.
-- `aggressive` — caveman everywhere except Iron-Law literals.
+- `prose_only` (default) — telegraph in body prose; carve-outs preserved.
+- `aggressive` — telegraph everywhere except Iron-Law literals.
 
-Compile-time toggle `caveman.speak`: `false` → rule omitted from
-`dist/router.json` (zero runtime cost). `caveman.enabled: false` forces all
+Compile-time toggle `telegraph.speak`: `false` → rule omitted from
+`dist/router.json` (zero runtime cost). `telegraph.enabled: false` forces all
 sub-switches off regardless.
 
 ## Carve-outs — byte-for-byte preserved
@@ -58,9 +58,9 @@ Mangling these breaks Iron Laws. Apply regardless of `speak_scope`:
 
 Post-rewrite validator runs on every reply when `speak_scope != off`:
 
-1. **Snapshot** — before compression, hash each line in carve-out
+1. **Snapshot** — before condensation, hash each line in carve-out
    regions (1–7 above).
-2. **Rewrite** — compress body prose to caveman grammar.
+2. **Rewrite** — condense body prose to telegraph grammar.
 3. **Validate** — re-scan; for each carve-out region whose line hash
    differs from the snapshot, **restore the original prose**.
 4. **Emit** — the validated reply.
@@ -68,9 +68,9 @@ Post-rewrite validator runs on every reply when `speak_scope != off`:
 The rule documents the algorithm; agents apply it inline before
 sending. The mechanism is the rule, not a hidden script.
 
-Optional CI-side regression lock: [`scripts/validate_caveman_carveouts.py`](../../scripts/validate_caveman_carveouts.py) takes pre/post reply pair and asserts byte-identical preservation across all seven carve-out categories — runtime mechanism stays algorithmic; script is offline check.
+Optional CI-side regression lock: [`scripts/validate_telegraph_carveouts.py`](../../scripts/validate_telegraph_carveouts.py) takes pre/post reply pair and asserts byte-identical preservation across all seven carve-out categories — runtime mechanism stays algorithmic; script is offline check.
 
-## Caveman grammar
+## Telegraph grammar
 
 - Drop articles (`the`, `a`, `an`).
 - Drop linking auxiliaries (`is`, `are`, `was`, `be`) where
@@ -85,8 +85,8 @@ Example: *"I will now check the file and see if it exists"* →
 
 | Key | Default | Effect |
 |---|---|---|
-| `caveman.enabled` | `true` | Master — `false` forces all sub-switches off. |
-| `caveman.speak` | `true` | Compile-time include in `dist/router.json`. |
-| `caveman.speak_scope` | `prose_only` | Runtime scope of caveman grammar. |
+| `telegraph.enabled` | `true` | Master — `false` forces all sub-switches off. |
+| `telegraph.speak` | `true` | Compile-time include in `dist/router.json`. |
+| `telegraph.speak_scope` | `prose_only` | Runtime scope of telegraph grammar. |
 
 Cross-rule index: [`frugality-charter § cross-references`](../contexts/contracts/frugality-charter.md#cross-references--frugality-canon-rules).

package/.agent-src/rules/token-optimizer-maintenance.md

@@ -14,7 +14,7 @@ routes_to:
   - "skill:token-optimizer"
 validator_ignore:
   - type: "substring"
-    pattern: ".agent-src.uncompressed/"
+    pattern: ".agent-src.uncondensed/"
     reason: "Rule lists the authoring-tree paths that must stay in sync with the catalog."
 workspaces:
   - agent-config-maintainer
@@ -43,10 +43,10 @@ THE CI LINK VALIDATOR IS A BACKSTOP, NOT A SUBSTITUTE FOR CARE.
 
 About to edit any of:
 
-- `.agent-src.uncompressed/rules/cli-output-handling.md`
-- `.agent-src.uncompressed/rules/token-efficiency.md`
-- `.agent-src.uncompressed/rules/direct-answers.md`
-- `.agent-src.uncompressed/skills/rtk-output-filtering/SKILL.md`
+- `.agent-src.uncondensed/rules/cli-output-handling.md`
+- `.agent-src.uncondensed/rules/token-efficiency.md`
+- `.agent-src.uncondensed/rules/direct-answers.md`
+- `.agent-src.uncondensed/skills/rtk-output-filtering/SKILL.md`
 - `.claude/skills/agent-handoff/SKILL.md`
 - Any other asset cited by
   [`token-optimizer`](../skills/token-optimizer/SKILL.md) (catalog
@@ -61,7 +61,7 @@ If the edit touches:
 - **The asset's path / location** (rename, move, deletion)
 
 then in the same commit, update the matching row in
-`.agent-src.uncompressed/skills/token-optimizer/SKILL.md` —
+`.agent-src.uncondensed/skills/token-optimizer/SKILL.md` —
 the catalog table AND the relevant tree leaf.
 
 ## Out of scope

package/.agent-src/skills/agent-docs-writing/SKILL.md

@@ -115,11 +115,17 @@ agents/
 **Structure rule:** Structural docs directly in `agents/`, features/roadmaps in subdirectories.
 **Templates** live in `.augment/templates/`, NOT in `agents/` subdirectories.
 
-### Layer 6: `app/Modules/*/agents/` — Module-specific documentation
+### Layer 6: `{module_root}/{Module}/{agent_folder}/` — Module-specific documentation
+
+`{module_root}` comes from `modules.root_paths` and `{agent_folder}` from
+`modules.agent_folder` in `.agent-project-settings.yml`. Discover via
+`scripts/_lib/agent_settings.py::enumerate_modules()`. Common shapes:
+Laravel `app/Modules/{Module}/agents/`, Symfony `src/Bundle/{Bundle}/agents/`,
+monorepo `packages/{Pkg}/agents/`.
 
 ```
-app/Modules/ClientSoftware/
-├── agents/
+{module_root}/{Module}/                  ← e.g. app/Modules/ClientSoftware/
+├── {agent_folder}/                      ← e.g. agents/
 │   ├── module-description.md
 │   ├── features/               ← Module-scoped feature plans
 │   │   └── {feature-name}.md
@@ -137,8 +143,8 @@ app/Modules/ClientSoftware/
 ### Layer 7: `Docs/` — Technical documentation
 
 ```
-Docs/                           ← Project-level technical docs
-app/Modules/*/Docs/             ← Module-level technical docs
+Docs/                                    ← Project-level technical docs
+{module_root}/{Module}/Docs/             ← Module-level technical docs
 ```
 
 **Purpose:** Technical documentation for humans (setup guides, architecture diagrams, API docs).
@@ -164,9 +170,9 @@ When starting work, read documentation in this order:
 2. `.github/copilot-instructions.md` (if it exists) — coding standards
 4. `agents/overrides/` — check for project-level overrides of skills/rules/commands
 5. `./agents/` — project-specific docs relevant to the task
-6. `app/Modules/{Module}/agents/` — if working on a module
-7. `agents/features/` or module `agents/features/` — if related feature plan exists
-8. `agents/roadmaps/` or module `agents/roadmaps/` — if continuing existing work
+6. `{module_root}/{Module}/{agent_folder}/` — if working on a module (resolved via `modules.root_paths` + `modules.agent_folder`; Laravel: `app/Modules/{Module}/agents/`, Symfony: `src/Bundle/{Bundle}/agents/`, monorepo: `packages/{Pkg}/agents/`)
+7. `agents/features/` or module `{agent_folder}/features/` — if related feature plan exists
+8. `agents/roadmaps/` or module `{agent_folder}/roadmaps/` — if continuing existing work
 
 ## Procedure: Create or update agent docs
 
@@ -177,7 +183,7 @@ When starting work, read documentation in this order:
 
 | Trigger | Action |
 |---|---|
-| New module created | Create `app/Modules/{Module}/agents/` with module description |
+| New module created | Create `{module_root}/{Module}/{agent_folder}/` with module description (Laravel example: `app/Modules/{Module}/agents/`) |
 | Significant multi-step change | Ask user about creating a roadmap in `agents/roadmaps/` |
 | New convention introduced | Update relevant doc in `./agents/` or `.augment/guidelines/` |
 | Database schema changed | Update `agents/reference/docs/database-setup.md` |
@@ -199,7 +205,7 @@ After completing a significant code change, run this mental checklist:
 |---|---|
 | Database schema (migration) | `agents/reference/docs/database-setup.md` |
 | New API endpoint | OpenAPI annotations, `AGENTS.md` API section |
-| New module created | Create `app/Modules/{Module}/agents/` |
+| New module created | Create `{module_root}/{Module}/{agent_folder}/` (resolve via `modules.root_paths` + `modules.agent_folder`) |
 | Service/repository signature changed | Check if referenced in `agents/reference/docs/services-and-repos.md` |
 | New environment variable | `.env.example`, `AGENTS.md` environment section |
 | Docker/compose change | `agents/reference/docs/docker.md`, `Makefile` documentation |
@@ -232,7 +238,7 @@ Do NOT auto-update docs without the user's knowledge. Flag what needs updating a
 - Don't create documentation files unless explicitly requested — the scope-control rule overrides this skill.
 - Always check if a doc already exists before creating a new one — duplicates are worse than gaps.
 - AGENTS.md and copilot-instructions.md have different audiences — don't copy content between them.
-- Module docs go in `app/Modules/*/agents/`, NOT in the central `agents/` directory.
+- Module docs go in `{module_root}/{Module}/{agent_folder}/` (per `modules.root_paths`), NOT in the central `agents/` directory.
 
 ## Frugality Standards
 

package/.agent-src/skills/agents-md-thin-root/SKILL.md

@@ -29,7 +29,7 @@ install:
 
 Use when:
 - Editing `AGENTS.md` at the package root.
-- Editing `packages/core/.agent-src.uncompressed/templates/AGENTS.md` (consumer-shipped template).
+- Editing `packages/core/.agent-src.uncondensed/templates/AGENTS.md` (consumer-shipped template).
 - Reviewing a PR that changes either file.
 - Running `/optimize/agents`.
 - A budget meter (`scripts/measure_augment_budget.py`) flags the package-root AGENTS.md as the dominant cost.
@@ -37,7 +37,7 @@ Use when:
 ## Do NOT
 
 - Edit `.github/copilot-instructions.md` with this skill (use `copilot-agents-optimization` instead).
-- Edit other `.md` files under `.augment/`, `packages/*/.agent-src.uncompressed/`, or `agents/` with this skill.
+- Edit other `.md` files under `.augment/`, `packages/*/.agent-src.uncondensed/`, or `agents/` with this skill.
 - Add a section to AGENTS.md without first checking whether an outboard target already exists in `agents/settings/contexts/` or `docs/contracts/`.
 - Replace prose with a bare link `[label](path)` — every pointer needs a *why*-clause ≥ 60 chars or it does not count toward the 40 % ratio.
 - Reuse the package-root anatomy in the consumer template — caps and target paths differ.
@@ -55,7 +55,7 @@ Every entry describes **what** the project does or **where** to learn more — n
 | File | FAIL above | WARN above | Target |
 |---|---|---|---|
 | `AGENTS.md` (package root) | 3,000 chars | 2,800 chars | ≤ 2,800 |
-| `packages/core/.agent-src.uncompressed/templates/AGENTS.md` (consumer) | 2,500 chars | 2,300 chars | ≤ 2,300 |
+| `packages/core/.agent-src.uncondensed/templates/AGENTS.md` (consumer) | 2,500 chars | 2,300 chars | ≤ 2,300 |
 
 Char-count is raw file size (`wc -c`), frontmatter included. Enforcement: `scripts/lint_agents_md.py` (Phase 7), wired into the package's CI pipeline via the `lint-agents-md` task. WARN is a soft signal in CI; FAIL blocks merge.
 
@@ -93,7 +93,7 @@ Every substantive pointer specifies, on the same line or the immediately followi
 
 ## The contract — emergency-triage block
 
-Every Thin-Root AGENTS.md MUST contain an **Emergency Triage** section verbatim from `packages/core/.agent-src.uncompressed/contexts/contracts/emergency-triage-block.md` (Phase 6.4 will create that file as the canonical source). The block lists the five questions a host agent answers from the root file alone when network / tool access is degraded:
+Every Thin-Root AGENTS.md MUST contain an **Emergency Triage** section verbatim from `packages/core/.agent-src.uncondensed/contexts/contracts/emergency-triage-block.md` (Phase 6.4 will create that file as the canonical source). The block lists the five questions a host agent answers from the root file alone when network / tool access is degraded:
 
 1. What is this repository?
 2. What language(s) does this repository accept?
@@ -107,22 +107,22 @@ Each answer must fit on one line. The block exists so the root never silently de
 
 1. **Measure baseline.** `wc -c AGENTS.md` and `python3 scripts/measure_augment_budget.py`. Record current char-count and the gap to 2,200 / 2,500.
 2. **Inventory sections.** List every `## ` heading and its char-count. Mark each as `keep-inline` (Iron-Law-adjacent, ≤ 200 chars, no good outboard target) or `outboard-candidate` (longer-form prose, table-only sections, narrative).
-3. **Identify outboard targets.** For each `outboard-candidate`, name the destination — `packages/core/.agent-src.uncompressed/contexts/`, `docs/contracts/`, an existing rule body, an existing skill body. Never invent a new top-level directory.
+3. **Identify outboard targets.** For each `outboard-candidate`, name the destination — `packages/core/.agent-src.uncondensed/contexts/`, `docs/contracts/`, an existing rule body, an existing skill body. Never invent a new top-level directory.
 4. **Move content; insert pointer.** Cut the section into the target file. Replace it in AGENTS.md with a single substantive pointer per anatomy above. Verify the *why*-clause length.
 5. **Re-measure.** `wc -c AGENTS.md` again. If above 2,200, repeat steps 2–4 on the next-largest section. Above 2,500 = must outboard further before commit.
 6. **Validate pointer ratio.** Count non-blank lines and substantive-pointer lines. Ratio < 0.40 = collapse decorative or boilerplate lines into a single pointer or remove.
-7. **Verify emergency-triage block.** Diff the in-file block against `packages/core/.agent-src.uncompressed/contexts/contracts/emergency-triage-block.md`. Drift = revert to canonical.
+7. **Verify emergency-triage block.** Diff the in-file block against `packages/core/.agent-src.uncondensed/contexts/contracts/emergency-triage-block.md`. Drift = revert to canonical.
 8. **Run lints.** `task lint-agents-md && task check-refs && task lint-skills`. All green before commit.
 
 ## Procedure — apply Thin-Root to consumer template
 
-Same procedure, applied to `packages/core/.agent-src.uncompressed/templates/AGENTS.md`. Hard cap shifts to 2,000 / 1,700. The consumer template intentionally lacks the package-self-references — its pointers target files that exist in the **consumer's** repo (`.augment/skills/`, `agents/settings/contexts/`, ...), not this package's authoring tree.
+Same procedure, applied to `packages/core/.agent-src.uncondensed/templates/AGENTS.md`. Hard cap shifts to 2,000 / 1,700. The consumer template intentionally lacks the package-self-references — its pointers target files that exist in the **consumer's** repo (`.augment/skills/`, `agents/settings/contexts/`, ...), not this package's authoring tree.
 
 ## Gotchas
 
-- **Outboarding to a new top-level dir.** Inventing `agents/explainers/` or `docs/notes/` for the moved content silently widens the contract surface. Outboard only into `packages/core/.agent-src.uncompressed/contexts/`, `docs/contracts/`, an existing rule body, or an existing skill body.
+- **Outboarding to a new top-level dir.** Inventing `agents/explainers/` or `docs/notes/` for the moved content silently widens the contract surface. Outboard only into `packages/core/.agent-src.uncondensed/contexts/`, `docs/contracts/`, an existing rule body, or an existing skill body.
 - **Pointer-ratio inflation by decoration.** Adding boilerplate "Browse all skills" / "See also" links to lift the ratio above 40 % defeats the purpose. The lint counts only substantive pointers (with a *why*-clause ≥ 60 chars); decorative links get filtered out and the ratio drops back below threshold.
-- **Emergency-triage drift.** Editing the in-file emergency-triage block instead of the canonical `packages/core/.agent-src.uncompressed/contexts/contracts/emergency-triage-block.md` causes the package-root and consumer-template versions to diverge silently. Always edit the canonical file and let the lint diff pull both back in sync.
+- **Emergency-triage drift.** Editing the in-file emergency-triage block instead of the canonical `packages/core/.agent-src.uncondensed/contexts/contracts/emergency-triage-block.md` causes the package-root and consumer-template versions to diverge silently. Always edit the canonical file and let the lint diff pull both back in sync.
 - **Cap inversion under WARN.** A 2,250-char AGENTS.md (above 2,200 WARN, below 2,500 FAIL) is a yellow signal not a green one — every additional sentence raises the probability of the next FAIL. Treat WARN as the spend boundary, not a buffer.
 - **Char-count includes frontmatter.** `wc -c` counts every byte including the YAML preamble, blank lines, and the trailing newline. Stripping a section to "look smaller" without re-running `wc -c` understates the true budget impact.
 - **Path enumeration.** A run of three or more bare `` `path/to/dir/` `` bullets without *why*-clauses is the classic re-bloat pattern. The lint emits a WARN at ≥ 3 such lines. Collapse them into one capability-style pointer — see the recipe in [`agents-md-anatomy § Iron Law`](../../contexts/contracts/agents-md-anatomy.md#iron-law--capabilities-over-structure).

package/.agent-src/skills/check-refs/SKILL.md

@@ -32,7 +32,7 @@ install:
 Use this skill when:
 
 - A skill, rule, command, guideline, or context has been renamed or deleted
-- Linking a newly added artifact from elsewhere in `.agent-src.uncompressed/`
+- Linking a newly added artifact from elsewhere in `.agent-src.uncondensed/`
 - Preparing a PR that touches cross-references between agent artifacts
 - CI's `check-refs` job failed and the broken reference needs to be located
 
@@ -40,7 +40,7 @@ Do NOT use when:
 
 - Only the body of a single file changed and no names or paths were touched
 - Checking frontmatter shape or required sections — use `lint-skills` instead
-- Verifying compressed vs uncompressed pairs — use `bash scripts/compress.sh --check` instead
+- Verifying condensed vs uncondensed pairs — use `bash scripts/condense.sh --check` instead
 
 ## Procedure
 

package/.agent-src/skills/code-refactoring/SKILL.md

@@ -130,8 +130,8 @@ After the code changes are verified, update all affected documentation:
 |---|---|---|
 | **Project docs** | When conventions, patterns, or key files change | `agents/reference/docs/*.md` |
 | **Project contexts** | When architecture or high-level flow changes | `agents/settings/contexts/*.md` |
-| **Module agent docs** | When module-specific behavior changes | `app/Modules/*/agents/` |
-| **Module Docs/** | When module internals change | `app/Modules/*/Docs/` |
+| **Module agent docs** | When module-specific behavior changes | `{module_root}/*/{agent_folder}/` (per `modules.root_paths` + `modules.agent_folder`) |
+| **Module Docs/** | When module internals change | `{module_root}/*/Docs/` |
 | **AGENTS.md** | When project-wide conventions change | `AGENTS.md` |
 | **Roadmaps** | When a roadmap step is completed | `agents/roadmaps/*.md` |
 

package/.agent-src/skills/command-writing/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: command-writing
-description: "Use when creating or editing a slash command in .agent-src.uncompressed/commands/ — frontmatter, numbered steps, safety gates — even when the user just says 'add a /command for X'."
+description: "Use when creating or editing a slash command in .agent-src.uncondensed/commands/ — frontmatter, numbered steps, safety gates — even when the user just says 'add a /command for X'."
 source: package
 domain: process
 workspaces:
@@ -23,7 +23,7 @@ install:
 
 ## When to use
 
-* Creating a new slash command in `.agent-src.uncompressed/commands/{name}.md`
+* Creating a new slash command in `.agent-src.uncondensed/commands/{name}.md`
 * Rewriting an existing command (not a typo fix)
 * Deciding whether a request should be a command at all
 * Splitting an oversized command into smaller ones
@@ -47,8 +47,8 @@ author as a skill and add a thin command that delegates to it.
 
 ## Commands ARE Claude skills (projection reality)
 
-Every `.agent-src.uncompressed/commands/{name}.md` projects to
-`.claude/skills/{slug}/SKILL.md` via `scripts/compress.py`
+Every `.agent-src.uncondensed/commands/{name}.md` projects to
+`.claude/skills/{slug}/SKILL.md` via `scripts/condense.py`
 (`generate_claude_commands`). Nested commands flatten with `-`
 (`council/default.md` → `council-default`). Skills + commands share the
 **same `.claude/skills/` namespace** — Claude does not distinguish them.
@@ -84,7 +84,7 @@ Research → Draft from the
 
 * **Understand** — what user-facing problem does `/{name}` solve in one
   session? What are the inputs, outputs, side effects?
-* **Research** — **inspect** `.agent-src.uncompressed/templates/command.md`,
+* **Research** — **inspect** `.agent-src.uncondensed/templates/command.md`,
   grep `commands/` for overlap, and **analyze** 1–2 peer commands
   (e.g. `create-pr`, `commit`).
 * **Draft** — propose frontmatter (`name`, `description`) first, then the
@@ -92,7 +92,7 @@ Research → Draft from the
 
 ### 1. Use the template
 
-Canonical source: `.agent-src.uncompressed/templates/command.md`.
+Canonical source: `.agent-src.uncondensed/templates/command.md`.
 
 Minimum frontmatter:
 
@@ -142,7 +142,7 @@ no silent edits, max two rounds.
 Required sections in this order:
 
 1. `# /{name}` heading + one-line summary
-2. **Source of truth note** — works on `.agent-src.uncompressed/`, never on
+2. **Source of truth note** — works on `.agent-src.uncondensed/`, never on
    generated directories
 3. `## Steps` — numbered sub-headings `### 1.`, `### 2.`, ...
 4. Final step **presents findings** and asks the user before destructive
@@ -154,16 +154,16 @@ Required sections in this order:
 * No auto-apply of destructive actions without user confirmation.
 * Every step with side effects (git push, file delete, PR merge) asks first.
 * If the command calls external APIs, list required keys / permissions.
-* If the command edits agent files, target `.agent-src.uncompressed/` only.
+* If the command edits agent files, target `.agent-src.uncondensed/` only.
 
 ### 3b. Path conventions in command body
 
 Body links to guidelines / contracts use the verbatim relative form
 (`../../docs/guidelines/...`, `../../docs/contracts/...`); the
-compress-time rewriter handles depth. Do not pre-rewrite in source. Do
-not write `.agent-src.uncompressed/` in any markdown link target — the
+condense-time rewriter handles depth. Do not pre-rewrite in source. Do
+not write `.agent-src.uncondensed/` in any markdown link target — the
 file ships into `.augment/commands/` and the prefix breaks consumer
-resolution. The only legitimate `.agent-src.uncompressed/` strings in a
+resolution. The only legitimate `.agent-src.uncondensed/` strings in a
 command file are prose mentions and step instructions about where to
 edit (per § 2 above). Canonical reference: `rule-writing` § 3b.
 
@@ -183,10 +183,10 @@ multi-paragraph explanation, extract it into a skill and call it.
 
 ### 5. Validate
 
-* Run `python3 scripts/skill_linter.py .agent-src.uncompressed/commands/{name}.md`
+* Run `python3 scripts/skill_linter.py .agent-src.uncondensed/commands/{name}.md`
   → 0 FAIL.
-* Run `bash scripts/compress.sh --sync` → regenerates `.agent-src/commands/{name}.md`.
-* Run `python3 scripts/compress.py --generate-tools` → creates the Claude symlink at
+* Run `bash scripts/condense.sh --sync` → regenerates `.agent-src/commands/{name}.md`.
+* Run `python3 scripts/condense.py --generate-tools` → creates the Claude symlink at
   `.claude/skills/{name}/SKILL.md`.
 * Run the full CI pipeline locally (see `Taskfile.yml` in this repo for
   the script list) — must exit 0 except for tolerated warnings.
@@ -213,7 +213,7 @@ See `agents/evidence/analysis/lint-warning-triage.md` for the 3-bucket reference
 
 ## Output format
 
-1. Complete command file at `.agent-src.uncompressed/commands/{name}.md`
+1. Complete command file at `.agent-src.uncondensed/commands/{name}.md`
 2. Frontmatter populated, `disable-model-invocation: true` present
 3. Linter output showing 0 FAIL
 4. Generated Claude symlink verified
@@ -225,7 +225,7 @@ See `agents/evidence/analysis/lint-warning-triage.md` for the 3-bucket reference
 * Numbered options without a "skip" / "no change" path.
 * Steps that silently apply destructive changes — always show summary + ask.
 * Referring to `.augment/` paths for editing — source of truth is
-  `.agent-src.uncompressed/`.
+  `.agent-src.uncondensed/`.
 * Duplicating another command's workflow instead of delegating via `skills:`.
 
 ## Frugality Standards
@@ -262,7 +262,7 @@ to every command you author.
 ## Cloud Behavior
 
 On cloud surfaces (Claude.ai Web, Skills API) the package's
-`scripts/skill_linter.py`, `scripts/compress.py`, and the `task`
+`scripts/skill_linter.py`, `scripts/condense.py`, and the `task`
 runner are not available. This skill still applies — but with
 prose-only validation:
 
@@ -274,9 +274,9 @@ prose-only validation:
 * Self-check the body shape: numbered steps, explicit safety gates,
   no inline skill-level detail.
 * Tell the user to save the file under
-  `.agent-src.uncompressed/commands/{name}.md` and run
+  `.agent-src.uncondensed/commands/{name}.md` and run
   `task sync && task lint-skills` locally before committing.
-* Skip every reference to running the linter, compressor, or
+* Skip every reference to running the linter, condenseor, or
   generators yourself — they only run on the user's machine.
 
 ## Examples

package/.agent-src/skills/comp-banding/SKILL.md

@@ -33,7 +33,7 @@ Do NOT use as a payroll / equity-administration substitute (this skill produces
 ## Cognition cluster
 
 - **Mental model 1 — First principles.** Strip every comp question to: *what behavior are we paying for, over what horizon, with what risk-bearing?* Cash pays for present effort; equity pays for future co-built value with risk; bonus pays for outcome-linked behavior. Mixing the levers without first-principles intent produces confusion. See [`mental-models.md`](../../../docs/contracts/mental-models.md) § 1.
-- **Mental model 28 — Inversion.** *"What comp shape would force our best people to leave?"* Inversion surfaces the load-bearing risks (compression at senior levels, equity refresh gaps, geo arbitrage that punishes loyalty).
+- **Mental model 28 — Inversion.** *"What comp shape would force our best people to leave?"* Inversion surfaces the load-bearing risks (condensation at senior levels, equity refresh gaps, geo arbitrage that punishes loyalty).
 - **Mental model 26 — Optionality.** Each comp lever preserves or forecloses future options. Above-band offers preserve hire optionality but foreclose internal-equity optionality. Equity-heavy mix preserves cash runway but forecloses people who need liquidity. Read every move as an optionality trade.
 - **Mental model 21 — Second-order thinking.** A raise to one person ripples (perceived parity, retention pressure on peers, expectation-setting for next cycle). A band shift ripples (new-hire offers anchor higher, internal expectations re-anchor). Comp moves rarely stay isolated.
 - **Context-spine — org-stage + customer-segment + regulatory-regime.** Read **org-stage** for what's affordable and credible (pre-seed: cash-light, equity-heavy; growth: cash-competitive at 50th–75th; late: cash-led, equity less load-bearing). Read **customer-segment** for which talent pool we compete in (enterprise sales needs enterprise pay shape). Read **regulatory-regime** for pay-transparency / disclosure obligations (EU directive, CA / CO / NY state laws).