@event4u/agent-config 3.3.0 → 4.2.0

package/.agent-src/README.md

@@ -1,8 +1,8 @@
 # Agent Infrastructure
 
 > **⚠️ DO NOT edit files in `.agent-src/` or `.augment/` directly.**
-> The source of truth is `.agent-src.uncompressed/`. Edit there, then run `task sync`.
-> See `.agent-src.uncompressed/commands/compress.md` for the full workflow.
+> The source of truth is `.agent-src.uncondensed/`. Edit there, then run `task sync`.
+> See `.agent-src.uncondensed/commands/condense.md` for the full workflow.
 
 This directory contains the shared agent infrastructure: skills, commands, rules, guidelines,
 templates, and contexts that power the AI coding assistant across all projects.

package/.agent-src/commands/agent-handoff.md

@@ -5,8 +5,9 @@ skills: [agent-docs-writing]
 description: Generate a context summary for continuing work in a fresh chat. Replaces the session system.
 disable-model-invocation: true
 suggestion:
-  eligible: false
-  rationale: "Explicit fresh-chat handoff — must be deliberate, never inferred from prose."
+  eligible: true
+  trigger_description: "user asks for an agent handoff, fresh-chat summary, or context-summary to paste into a new chat"
+  trigger_context: "explicit verbatim ask — 'agent handoff', 'agend handoff' (typo), 'fasse für neuen chat zusammen', 'handoff summary', 'context summary for fresh chat'. Never inferred without a direct handoff / summary intent."
 workspaces:
   - agent-config-maintainer
 packs:
@@ -70,6 +71,33 @@ Show the handoff prompt in a fenced code block and say:
 > Copy this into a new chat to continue where we left off.
 ```
 
+## Iron Law — output is ALWAYS a fenced code block
+
+```
+THE HANDOFF MUST BE WRAPPED IN A FENCED ```markdown CODE BLOCK
+SO THE USER CAN COPY IT IN ONE CLICK. NEVER RENDER IT AS LIVE
+MARKDOWN. NEVER SPLIT IT ACROSS MULTIPLE BLOCKS.
+```
+
+Use ` ```markdown ` as the fence so consumers get syntax highlighting
+and the inner content is preserved verbatim. Add one short prose line
+above the block (e.g. *"Copy this into a new chat:"*) and nothing
+after — no follow-up questions, no numbered options.
+
+## Detection — when natural-language triggers count as explicit
+
+The user does not need to type `/agent-handoff` literally. Treat as
+explicit invocation when the prompt contains a verbatim mention of:
+
+- `agent handoff` / `agend handoff` (typo) / `handoff`
+- `fresh chat`, `neuer chat`, `for a new chat`
+- `context summary for {fresh,new} chat`
+- `fasse … für … chat zusammen`
+
+A vague *"summarize this conversation"* without handoff/new-chat
+framing → NOT a trigger. Surface `/agent-handoff` as a numbered option,
+do not auto-execute.
+
 ## Rules
 
 - **Keep it concise** — the prompt should be <30 lines. More context = more input tokens in the new chat.
@@ -78,6 +106,7 @@ Show the handoff prompt in a fenced code block and say:
 - **Open tasks are critical** — the new chat needs to know what's left.
 - **Decisions are important** — prevents the new chat from re-asking settled questions.
 - **File list is optional** — only include if the new chat will need to edit specific files.
+- **NEVER render the handoff as live markdown** — see Iron Law above.
 
 ## When to use this vs. `agents/runtime/.agent-chat-history`
 

package/.agent-src/commands/agent-status.md

@@ -69,19 +69,19 @@ Extract from latest record:
 Pricing source: [`internal/bench/pricing.yaml`](../../bench/pricing.yaml). Reader
 implementation: [`scripts/cost/track.mjs`](../../scripts/cost/track.mjs).
 
-### 3b. Read caveman delta + per-conversation cost lens
+### 3b. Read telegraph delta + per-conversation cost lens
 
 Run two read-only Python helpers (stdlib-only, no-op safe if JSONL missing):
 
-- `python3 scripts/caveman_stats.py --format json` — per-session +
-  per-conversation + lifetime caveman delta. Honors suspended
-  multiplier (see [`docs/contracts/caveman-telemetry.md`](../docs/contracts/caveman-telemetry.md)) — delta reads `0` while suspended; display version + ACTIVE/SUSPENDED state regardless.
+- `python3 scripts/telegraph_stats.py --format json` — per-session +
+  per-conversation + lifetime telegraph delta. Honors suspended
+  multiplier (see [`docs/contracts/telegraph-telemetry.md`](../docs/contracts/telegraph-telemetry.md)) — delta reads `0` while suspended; display version + ACTIVE/SUSPENDED state regardless.
 - `python3 scripts/cost_by_conversation.py --format json` — per-conversation
   total cost + model breakdown for current conversation, sourced
   from same `agents/cost-tracking/sessions.jsonl` ledger.
 
 Surface in dashboard as one line:
-`[caveman: {lifetime.delta_tokens:+,} tok lifetime · {current_conv.delta_tokens:+,} this conv · multiplier v{multiplier_version} {ACTIVE|SUSPENDED}] · [conv cost: ${current_conv.total_cost_usd:.4f}]`.
+`[telegraph: {lifetime.delta_tokens:+,} tok lifetime · {current_conv.delta_tokens:+,} this conv · multiplier v{multiplier_version} {ACTIVE|SUSPENDED}] · [conv cost: ${current_conv.total_cost_usd:.4f}]`.
 
 If both JSONLs missing or empty, omit line silently.
 

package/.agent-src/commands/agents/audit.md

@@ -32,7 +32,7 @@ duplicate triggers, verifies the Thin-Root contract, and flags stale references.
 **Suggest only — never auto-apply.** Fixes happen via `/agents optimize` (file
 refactor) or rule-/skill-level commands.
 
-**Source of truth:** `.agent-src.uncompressed/` — never read or edit
+**Source of truth:** `.agent-src.uncondensed/` — never read or edit
 `.agent-src/` or `.augment/` directly.
 
 ## Steps
@@ -43,7 +43,7 @@ Count lines affecting token consumption:
 
 ```bash
 # Always-loaded (per chat)
-for f in .agent-src.uncompressed/rules/*.md; do
+for f in .agent-src.uncondensed/rules/*.md; do
   type=$(head -5 "$f" | grep 'type:' | sed 's/.*"\(.*\)"/\1/')
   [ "$type" = "auto" ] && continue
   lines=$(wc -l < "$f"); echo "always | $lines | $(basename "$f")"
@@ -51,15 +51,15 @@ done | sort -t'|' -k2 -rn
 agents=$(wc -l < AGENTS.md); echo "always | $agents | AGENTS.md"
 
 # Auto-loaded rules
-for f in .agent-src.uncompressed/rules/*.md; do
+for f in .agent-src.uncondensed/rules/*.md; do
   type=$(head -5 "$f" | grep 'type:' | sed 's/.*"\(.*\)"/\1/')
   [ "$type" != "auto" ] && continue
   lines=$(wc -l < "$f"); echo "auto | $lines | $(basename "$f")"
 done | sort -t'|' -k2 -rn
 
 # Skills (top 20 by size)
-for f in .agent-src.uncompressed/skills/*/SKILL.md; do
-  name=$(echo "$f" | sed 's|.agent-src.uncompressed/skills/||;s|/SKILL.md||')
+for f in .agent-src.uncondensed/skills/*/SKILL.md; do
+  name=$(echo "$f" | sed 's|.agent-src.uncondensed/skills/||;s|/SKILL.md||')
   lines=$(wc -l < "$f"); echo "$lines | $name"
 done | sort -rn | head -20
 ```
@@ -74,7 +74,7 @@ Report totals (always + auto + skills + AGENTS.md).
 - **Merge candidates**: rules under 15 lines that belong inside a sibling rule.
 
 ```bash
-for f in .agent-src.uncompressed/rules/*.md; do
+for f in .agent-src.uncondensed/rules/*.md; do
   desc=$(head -5 "$f" | grep 'description:' | sed 's/.*"\(.*\)"/\1/')
   [ -n "$desc" ] && echo "$desc | $(basename "$f")"
 done | sort | awk -F' \\| ' '{descs[$1]=descs[$1] " " $2} END {for (d in descs) {n=split(descs[d], a, " "); if (n>1) print "⚠️  " d " →" descs[d]}}'
@@ -115,7 +115,7 @@ python3 scripts/check_references.py
 ```
 
 Confirm counts/lists in `.augment/contexts/augment-infrastructure.md` and
-`docs/architecture.md` match the actual `.agent-src.uncompressed/` tree.
+`docs/architecture.md` match the actual `.agent-src.uncondensed/` tree.
 
 ### 6. Run skill linter
 
@@ -150,7 +150,7 @@ Then ask:
 - **No edits** — read-only audit. Fixes route to `/agents optimize`,
   `skill-reviewer`, or `/optimize skills`.
 - **No edits to `.agent-src/` or `.augment/`** — those regenerate from
-  `.agent-src.uncompressed/`. Edit the source.
+  `.agent-src.uncondensed/`. Edit the source.
 - **No `agents/` folder ops** — scaffolding, folder-audit, folder-cleanup
   live in `/optimize agents-dir`.
 - **No commits, no push, no PR** — finishing the audit is a user decision

package/.agent-src/commands/agents/init.md

@@ -156,7 +156,31 @@ Next steps:
   3. Run `/agents optimize` periodically to deduplicate against .augment/
 ```
 
-### 7. Follow-ups
+### 7. Module-root proposal (optional)
+
+Surface configurable-module candidates so the team file can opt in to
+module-aware skills (road-to-configurable-modules Phase B). Skips
+silently when the helper finds no candidates.
+
+```bash
+python3 scripts/propose_modules_config.py --json
+```
+
+If the JSON `candidates` array is non-empty, render the proposed
+`modules:` block as numbered options:
+
+```
+> 1. Accept all candidates — patch .agent-project-settings.yml
+> 2. Pick a subset — choose root paths interactively
+> 3. Skip — leave modules.enabled: false (default)
+```
+
+On accept, append the `modules:` block to the team file
+`.agent-project-settings.yml` (preserve comments + ordering per the
+[`layered-settings`](../../docs/guidelines/agent-infra/layered-settings.md)
+contract). On skip, do nothing — the block stays opt-in.
+
+### 8. Follow-ups
 
 If `agents/` directory does not exist, suggest running `/optimize agents-dir --scaffold`.
 If `.agent-settings.yml` does not exist, suggest running `scripts/install` (then `/onboard` for first-run setup).

package/.agent-src/commands/agents/optimize.md

@@ -60,7 +60,7 @@ Default: the AGENTS.md the user is editing right now. If unclear,
 ask:
 
 > 1. project root — `AGENTS.md`
-> 2. consumer template — `.agent-src.uncompressed/templates/AGENTS.md`
+> 2. consumer template — `.agent-src.uncondensed/templates/AGENTS.md`
 > 3. package root — `AGENTS.md` of `event4u/agent-config` itself
 > 4. monorepo package — `<path>/AGENTS.md` (specify path)
 
@@ -110,7 +110,7 @@ For every link in the file, verify:
 
 ```bash
 diff <(awk '/^## Emergency triage/,/^## [^E]/' "$target") \
-     .agent-src.uncompressed/contexts/contracts/emergency-triage-block.md
+     .agent-src.uncondensed/contexts/contracts/emergency-triage-block.md
 ```
 
 Drift = revert in-file block to the canonical variant (package-root
@@ -176,7 +176,7 @@ final reply per
 ## What this command does NOT do
 
 - **No edits to** `.augment/` **or** `.agent-src/` — those regenerate
-  from `.agent-src.uncompressed/`. Edit the source.
+  from `.agent-src.uncondensed/`. Edit the source.
 - **No commits, no push, no PR** — finishing the refactor is a user
   decision; cite [`commit-policy`](../../rules/commit-policy.md).
 - **No broader agent-infra audit** — for token overhead, rule

package/.agent-src/commands/agents/user.md

@@ -68,7 +68,7 @@ Schema contract:
 - **Do NOT introduce network code** in this package. External
   enrichment is rejected for v1 — see the
   [determinism floor](../../../docs/contracts/agent-user-schema.md#determinism-floor).
-- **Edit `.agent-src.uncompressed/` only.** `.agent-src/` and
+- **Edit `.agent-src.uncondensed/` only.** `.agent-src/` and
   `.augment/` regenerate from source.
 
 ## See also

package/.agent-src/commands/agents.md

@@ -65,5 +65,5 @@ Sub-command names match the locked contract in
 - **Do NOT chain sub-commands.** One `/agents <sub>` per turn.
 - If the user invokes `/agents` with no argument, **show the menu** — do
   not guess which sub-command they meant.
-- **Edit `.agent-src.uncompressed/` only.** `.agent-src/` and `.augment/`
+- **Edit `.agent-src.uncondensed/` only.** `.agent-src/` and `.augment/`
   regenerate from source.

package/.agent-src/commands/analyze-reference-repo.md

@@ -106,7 +106,7 @@ rather than guess.
 ### 4. Compare against this project
 
 Add a **this-repo** column per axis. Sources of truth:
-`.agent-src.uncompressed/` (skills/rules/commands), `docs/architecture.md`
+`.agent-src.uncondensed/` (skills/rules/commands), `docs/architecture.md`
 (stable/experimental), `scripts/` (installer), `.github/workflows/` (CI).
 Never invent capabilities — if we don't have it, say so.
 

package/.agent-src/commands/check-current-md.md

@@ -101,12 +101,12 @@ Apply all fixes** for ≤2 findings or when all are pure translations.
 
 Edit only the source-of-truth file:
 
-- Path under `.agent-src.uncompressed/` → edit there directly
+- Path under `.agent-src.uncondensed/` → edit there directly
 - Path under `.agent-src/` → edit the matching
-  `.agent-src.uncompressed/` file instead, then run
-  `bash scripts/compress.sh --sync`
+  `.agent-src.uncondensed/` file instead, then run
+  `bash scripts/condense.sh --sync`
 - Path under `.augment/` → same as `.agent-src/` (it's a projection)
-- Path under `agents/` → edit directly (no compression layer)
+- Path under `agents/` → edit directly (no condensation layer)
 
 After all fixes, re-run:
 
@@ -114,21 +114,21 @@ After all fixes, re-run:
 python3 scripts/check_md_language.py <path> [<path> …]
 ```
 
-### 6. Mark hashes (only if `.agent-src.uncompressed/` was edited)
+### 6. Mark hashes (only if `.agent-src.uncondensed/` was edited)
 
 For each modified source file:
 
 ```bash
-python3 scripts/compress.py --mark-done "{relative_path}"
+python3 scripts/condense.py --mark-done "{relative_path}"
 ```
 
-This keeps `.compression-hashes.json` consistent with the new content.
+This keeps `.condensation-hashes.json` consistent with the new content.
 
 ## Rules
 
 - **Never edit `.augment/` directly** — it's a generated projection.
   Per [`augment-source-of-truth`](../rules/augment-source-of-truth.md),
-  the source is `.agent-src.uncompressed/`.
+  the source is `.agent-src.uncondensed/`.
 - **Per-line ignore marker is reserved** for meta-documentation that
   must quote German tokens; do NOT use it as a generic mute.
 - **Frontmatter is exempt** — the checker skips YAML frontmatter at

package/.agent-src/commands/{compress.md → condense.md}

@@ -1,8 +1,8 @@
 ---
-name: compress
+name: condense
 tier: 1
 skills: []
-description: Compress .md files from .agent-src.uncompressed/ into caveman format and write to .agent-src/
+description: Condense .md files from .agent-src.uncondensed/ into telegraph format and write to .agent-src/
 disable-model-invocation: true
 suggestion:
   eligible: false
@@ -21,44 +21,44 @@ install:
   removable: false
 ---
 
-# compress
+# condense
 
-Compress agent config `.md` files from `.agent-src.uncompressed/` into token-efficient caveman format
-and write the compressed output to `.agent-src/`.
+Condense agent config `.md` files from `.agent-src.uncondensed/` into token-efficient telegraph format
+and write the condensed output to `.agent-src/`.
 
-Uses SHA-256 hashes to track which source files changed since last compression.
-Only changed files need recompression — saving tokens and time.
+Uses SHA-256 hashes to track which source files changed since last condensation.
+Only changed files need recondensation — saving tokens and time.
 
 ## Step 1: Sync non-.md files
 
 ```bash
-bash scripts/compress.sh --sync
+bash scripts/condense.sh --sync
 ```
 
 This copies non-`.md` files (`.php`, etc.), deletes stale files, and shows the count of
-changed `.md` files that need compression.
+changed `.md` files that need condensation.
 
 ## Step 2: Get changed files
 
 ```bash
-bash scripts/compress.sh --changed
+bash scripts/condense.sh --changed
 ```
 
-This lists only `.md` files whose source has changed since the last compression (based on
+This lists only `.md` files whose source has changed since the last condensation (based on
 stored SHA-256 hashes). If no files changed → you're done.
 
 If you need to see ALL files regardless of change status:
-`bash scripts/compress.sh --list`.
+`bash scripts/condense.sh --list`.
 
-## Step 3: Compress each changed .md file
+## Step 3: Condense each changed .md file
 
-**Core principle:** Compression must improve execution quality, not just reduce length.
-A compressed file should be easier to scan, easier to trigger, and easier to execute than the original.
+**Core principle:** Condensation must improve execution quality, not just reduce length.
+A condensed file should be easier to scan, easier to trigger, and easier to execute than the original.
 
 For each changed `.md` file:
 
-1. Read the source from `.agent-src.uncompressed/{path}`
-2. Compress the prose using these rules:
+1. Read the source from `.agent-src.uncondensed/{path}`
+2. Condense the prose using these rules:
    - **Remove:** articles (a, an, the), filler (just, really, basically, actually, simply, essentially),
      pleasantries, hedging, connective fluff (however, furthermore, additionally),
      redundant wording, obvious framework knowledge, repeated explanations, decorative prose
@@ -79,18 +79,18 @@ For each changed `.md` file:
    - **Drop:** "you should", "make sure to", "remember to" — state action directly
    - **Merge** redundant bullets that say the same thing differently
    - **Prefer** bullets over prose, direct instructions over explanatory paragraphs, one-line decisions over paragraphs
-3. **Copy-paste first, compress second:**
-   Before compressing ANY prose, extract and set aside these elements from the source.
-   They go into the compressed output **unchanged, byte-for-byte**:
+3. **Copy-paste first, condense second:**
+   Before condensing ANY prose, extract and set aside these elements from the source.
+   They go into the condensed output **unchanged, byte-for-byte**:
    - **All code blocks** (``` fenced or indented) — copy EVERY code block from source to output FIRST
    - **YAML frontmatter** — copy verbatim
    - **All inline code** (`backtick content`)
    - **All URLs, links, file paths, commands**
    - **All H1/H2 headings** — exact text preserved
-   - **Tables** (structure preserved, compress cell text only)
+   - **Tables** (structure preserved, condense cell text only)
    - **Technical terms, library names, API names**
    - **Dates, version numbers, numeric values**
-   Then compress ONLY the prose around these preserved elements.
+   Then condense ONLY the prose around these preserved elements.
 4. **NEVER remove (even if verbose):**
    - Trigger clarity (When to use / description)
    - Decision hints that prevent mistakes
@@ -98,7 +98,7 @@ For each changed `.md` file:
    - Gotchas based on real failure patterns
    - Anti-patterns that prevent recurring failures
    - **Iron Law sections** — see "Iron Laws — do not touch" below
-5. **Enrich (SKILL.md files only):** During compression, also improve agent-effectiveness:
+5. **Enrich (SKILL.md files only):** During condensation, also improve agent-effectiveness:
    - **Validation steps:** If a Procedure ends with a vague validation ("check if it works"),
      replace with concrete checks (expected output, commands to verify, specific conditions)
    - **Mini examples:** If no `Examples` section exists, add a short safe/unsafe or good/bad example
@@ -109,16 +109,16 @@ For each changed `.md` file:
    - **Do NOT invent content.** Only concretize what the source implies. If the source says
      "validate copy/paste safety", you can add "Check: no nested backticks, fully selectable".
      But don't add unrelated sections.
-   - **Do NOT compress weak skills.** If the source has no procedure or no validation, fix structure first.
-   - **Reference skill:** See `.agent-src.uncompressed/skills/skill-writing/SKILL.md` for the gold standard
-6. Write the compressed output to `.agent-src/{path}`
-7. **MANDATORY: Run compression quality check on this file:**
+   - **Do NOT condense weak skills.** If the source has no procedure or no validation, fix structure first.
+   - **Reference skill:** See `.agent-src.uncondensed/skills/skill-writing/SKILL.md` for the gold standard
+6. Write the condensed output to `.agent-src/{path}`
+7. **MANDATORY: Run condensation quality check on this file:**
 
 ```bash
-python3 scripts/check_compression.py --format text 2>&1 | grep "{path}"
+python3 scripts/check_condensation.py --format text 2>&1 | grep "{path}"
 ```
 
-If the output contains 🔴 (error) for this file: **STOP. Fix the compressed file before continuing.**
+If the output contains 🔴 (error) for this file: **STOP. Fix the condensed file before continuing.**
 Common errors and how to fix them:
 - `lost_code_blocks` → You dropped a code block. Copy ALL code blocks from source.
 - `modified_code_block` → Code block content changed. Replace with exact source content.
@@ -126,12 +126,12 @@ Common errors and how to fix them:
 
 **Do NOT call `mark-done` until this file has zero 🔴 errors.**
 
-8. Show word count: `{original} → {compressed} words ({saved}% saved)`
-9. **Mark as done:** `bash scripts/compress.sh --mark-done {path}`
+8. Show word count: `{original} → {condensed} words ({saved}% saved)`
+9. **Mark as done:** `bash scripts/condense.sh --mark-done {path}`
 
 ### Batch processing
 
-When compressing multiple files, process them in batches of ~10.
+When condensing multiple files, process them in batches of ~10.
 Mark each file done after writing it. After each batch, show a progress summary:
 
 ```
@@ -143,13 +143,13 @@ Batch 1/5 complete: 10 files, avg 42% saved
 Run BOTH checks. Both must pass before finishing.
 
 ```bash
-bash scripts/compress.sh --check
+bash scripts/condense.sh --check
 ```
 
 Must show ✅ (hashes in sync).
 
 ```bash
-python3 scripts/check_compression.py
+python3 scripts/check_condensation.py
 ```
 
 Must show **zero 🔴 errors**. Warnings (🟡) are acceptable.
@@ -161,23 +161,23 @@ Read `verbosity.post_action_reports` from `.agent-settings.yml` (default
 `minimal`).
 
 - `off` → emit nothing on success; surface errors only.
-- `minimal` (default) → one line: `→ N files compressed (avg X% savings)`.
-- `full` → multi-line table with per-category stats (files compressed,
+- `minimal` (default) → one line: `→ N files condensed (avg X% savings)`.
+- `full` → multi-line table with per-category stats (files condensed,
   avg savings).
 
 ## Hash management
 
-- Hashes are stored in `.augment/.compression-hashes.json` (committed to Git).
-- `bash scripts/compress.sh --sync` automatically cleans up hashes for deleted source files.
-- `bash scripts/compress.sh --mark-all-done` marks ALL current `.md` files as compressed
-  (useful after an initial full compression or when bootstrapping the hash file).
+- Hashes are stored in `.augment/.condensation-hashes.json` (committed to Git).
+- `bash scripts/condense.sh --sync` automatically cleans up hashes for deleted source files.
+- `bash scripts/condense.sh --mark-all-done` marks ALL current `.md` files as condensed
+  (useful after an initial full condensation or when bootstrapping the hash file).
 - A file with no stored hash is always treated as "changed".
 
 ## Iron Laws — do not touch
 
 Sections under headings matching `Iron Law`, `Iron Laws`, or `The Iron Law` (any
 heading level, numbered variants like `Iron Law 1` included) are **load-bearing
-behavioral rules**. Compression rules above do **not** apply to them.
+behavioral rules**. Condensation rules above do **not** apply to them.
 
 For every Iron Law section in a source file:
 
@@ -187,27 +187,27 @@ For every Iron Law section in a source file:
   breaks, and trailing punctuation.
 - **Copy the negation clauses verbatim** — `NO X`, `NEVER Y`, `NOT Z`. These
   are the law's exception denials; stripping them weakens the rule.
-- **Caveman the prose, keep every passage** — every paragraph, every list
+- **Telegraph the prose, keep every passage** — every paragraph, every list
   item, and every fenced code block from the source must appear in the
-  compressed output, in order. Drop articles, shorten phrasing, primitive
+  condensed output, in order. Drop articles, shorten phrasing, primitive
   grammar, terse cave-speak — all encouraged. What's forbidden is dropping
   whole sentences, merging two paragraphs into one, or skipping a bullet.
   One paragraph → one paragraph; one bullet → one bullet.
-- **No word-count budget** — compress the prose as hard as caveman style
+- **No word-count budget** — condense the prose as hard as telegraph style
   allows. The check is structural (passage count), not quantitative.
 
-`scripts/check_compression.py` enforces these mechanically — `iron_law_missing`,
+`scripts/check_condensation.py` enforces these mechanically — `iron_law_missing`,
 `iron_law_passage_dropped`, and `iron_law_heading_downgrade` are `error`-level
 and block CI.
 
 If an Iron Law section genuinely contains filler (rare): edit the SOURCE in
-`.agent-src.uncompressed/`, not the compressed copy. Source is the truth.
+`.agent-src.uncondensed/`, not the condensed copy. Source is the truth.
 
-## Compression quality checklist
+## Condensation quality checklist
 
-**Also apply the `preservation-guard` rule** — strongest validation, example, anti-pattern, and decision hints must survive compression. Iron Laws are non-negotiable.
+**Also apply the `preservation-guard` rule** — strongest validation, example, anti-pattern, and decision hints must survive condensation. Iron Laws are non-negotiable.
 
-After compressing each file, verify:
+After condensing each file, verify:
 
 - [ ] All code blocks preserved exactly (no content changes)
 - [ ] All inline code, URLs, file paths unchanged
@@ -216,11 +216,11 @@ After compressing each file, verify:
 - [ ] Tables structure preserved (cell text may be shortened)
 - [ ] "NEVER", "MUST", "Do NOT" and other strong language preserved
 - [ ] Technical terms, library names, API names unchanged
-- [ ] No meaning lost — compressed version says the same thing, shorter
+- [ ] No meaning lost — condensed version says the same thing, shorter
 - [ ] No sections accidentally removed
 - [ ] Word count reduction is 20-50% (typical range for prose-heavy files)
 
-### Safe vs unsafe compression
+### Safe vs unsafe condensation
 
 Safe:
 - "You should always make sure to run the tests before committing" → "Run tests before commit"
@@ -236,8 +236,8 @@ Unsafe (DO NOT do this):
 ## Rules
 
 - **Do NOT commit or push.** Only write files.
-- **Do NOT modify `.agent-src.uncompressed/`** — it is the source of truth.
-- **Only write to `.augment/`** — the compressed output directory.
-- **Preserve ALL technical content** — only compress natural language prose.
+- **Do NOT modify `.agent-src.uncondensed/`** — it is the source of truth.
+- **Only write to `.augment/`** — the condensed output directory.
+- **Preserve ALL technical content** — only condense natural language prose.
 - **YAML frontmatter** in command/skill files must be preserved exactly.
-- **Always run `bash scripts/compress.sh --mark-done {path}`** after writing each compressed file.
+- **Always run `bash scripts/condense.sh --mark-done {path}`** after writing each condensed file.

package/.agent-src/commands/context/create.md

@@ -44,18 +44,21 @@ Examples:
 
 ### 2. Determine scope (module vs. project-wide)
 
-Check if `app/Modules/` exists. If yes, ask:
+Resolve module roots via `scripts/_lib/agent_settings.py::enumerate_modules()`
+(reads `modules.root_paths` + `modules.agent_folder` from
+`.agent-project-settings.yml`). If at least one module is discovered, ask:
 
 ```
 Should the context be created in a module or in the project root?
 
-1. 📦 In a module → app/Modules/{Module}/agents/settings/contexts/
+1. 📦 In a module → {module_root}/{Module}/{agent_folder}/settings/contexts/
 2. 🌐 Project root → agents/settings/contexts/
 ```
 
 If module:
-- List available modules and ask which one.
-- Target: `app/Modules/{Module}/agents/settings/contexts/`
+- Render the list of modules from `enumerate_modules()` and ask which one.
+- Target: `{module_root}/{Module}/{agent_folder}/settings/contexts/`
+  (Laravel example: `app/Modules/{Module}/agents/settings/contexts/`)
 - Create directory if it doesn't exist.
 
 If project-wide:

package/.agent-src/commands/context/refactor.md

@@ -30,7 +30,9 @@ install:
 ### 1. Find the context
 
 - List all context documents in `agents/settings/contexts/`.
-- Also check module-level `app/Modules/*/agents/settings/contexts/`.
+- Also check module-level contexts via `enumerate_modules()` — for each
+  module, look in `{module_path}/{modules.agent_folder}/settings/contexts/`
+  (Laravel shape: `app/Modules/*/agents/settings/contexts/`).
 
 If only one context exists, ask if that's the one to refactor.
 If the user has a context file open in their editor, use that one.

package/.agent-src/commands/feature/dev.md

@@ -59,7 +59,7 @@ Do NOT use for single-line fixes, trivial changes, or urgent hotfixes.
    - Architecture patterns in the affected area
    - Key files, services, models, routes involved
 2. Read identified files to build deep understanding.
-3. Check module docs (`app/Modules/*/agents/`) if applicable.
+3. Check module docs via `enumerate_modules()` — for each module, look in `{module_path}/{modules.agent_folder}/` (Laravel shape: `app/Modules/*/agents/`) if applicable.
 4. Check existing contexts (`agents/settings/contexts/`) for the affected area.
 5. Present findings with file references.
 

package/.agent-src/commands/feature/explore.md

@@ -128,7 +128,7 @@ While exploring, proactively research:
 
 - Use `codebase-retrieval` to find related code, existing patterns, and affected areas.
 - Check `agents/features/` for existing feature plans that might overlap.
-- Check the module structure (`app/Modules/`) for where this would live.
+- Check the module structure via `enumerate_modules()` (resolves `modules.root_paths`; Laravel shape: `app/Modules/`) for where this would live.
 - Look for existing services, models, or endpoints that could be extended.
 
 **Share findings naturally:**