@event4u/agent-config 3.3.0 → 4.1.0

package/docs/distribution/registry-submissions.md

@@ -0,0 +1,85 @@
+---
+stability: beta
+keep-beta-until: 2026-08-26
+roadmap_ref: road-to-adoption-proof-and-ci-green.md
+---
+
+# Registry Submissions — tracking sheet
+
+> Phase C Step 2 of [`road-to-adoption-proof-and-ci-green.md`](../../agents/roadmaps/road-to-adoption-proof-and-ci-green.md).
+> Post-submission tracking sheet. The submission shape, schedule, and
+> the maintainer's automation contract live in
+> [`registries.md`](registries.md); this file is the operational
+> ledger.
+
+## Why a separate tracking sheet
+
+`registries.md` defines **what** to submit (the entry template, the
+audit cadence, the GitHub Discussions setup). This file records
+**what happened** — one row per submission, with status, link, and
+maintainer notes. Splitting them keeps `registries.md` editable as
+the submission shape evolves; this file accumulates history.
+
+## Status legend
+
+| Status | Meaning |
+|---|---|
+| `pending` | Pre-submission. Entry text staged but the maintainer has not opened the PR / submitted the form yet. |
+| `submitted` | PR opened or form submitted. Awaiting upstream review. |
+| `accepted` | Upstream merged the PR or accepted the directory entry. |
+| `rejected` | Upstream declined. Maintainer notes the reason. |
+| `stalled` | ≥ 60 days in `submitted` with no upstream response. Treated as effectively `rejected` for adoption-tracking purposes. |
+
+## Tracking rows
+
+| # | Registry | Submission shape | Status | PR / form URL | Date | Maintainer notes |
+|---|---|---|---|---|---|---|
+| 1 | `punkpeye/awesome-mcp-servers` | One-line entry under agent-tooling section; PR via `scripts/mcp_registry_submit.sh` | `pending` | — | — | Scaffold ready. Run `bash scripts/mcp_registry_submit.sh --dry-run` once before live; the live path needs the maintainer's GitHub identity. |
+| 2 | `mcp.so` | Directory form submission (web form, no programmatic API) | `pending` | — | — | Form URL: <https://mcp.so/>. Submission shape: same one-line entry, paste into the form's `description` field. |
+| 3 | `mcpservers.org` | Directory form submission (web form, verify URL at submission time) | `pending` | — | — | Form URL: <https://mcpservers.org/>. Submission shape: one-line entry; check the site is live before posting. |
+
+## How to update a row
+
+When a row transitions:
+
+1. **`pending` → `submitted`.** Set `Status: submitted`, `Date: YYYY-MM-DD`, `PR / form URL: <link>`. Add one-sentence maintainer note (e.g. "PR #142; reviewer assigned").
+2. **`submitted` → `accepted`.** Set `Status: accepted`. Append the merge timestamp to the maintainer notes. Cross-link the merge commit / form-confirmation in the notes.
+3. **`submitted` → `rejected`.** Set `Status: rejected`. Append the reviewer's stated reason verbatim (or paraphrase if the conversation is verbal).
+4. **`submitted` → `stalled`.** Set `Status: stalled` once the row has been in `submitted` for ≥ 60 days with no upstream movement. The agent's `task adoption:status` (Phase C Step 6) flags any `stalled` row.
+
+The dates are UTC.
+
+## Maintainer-side checklist
+
+Before flipping a row from `pending` to `submitted`:
+
+- [ ] The `README.md` hero block is current (no stale claims about deferred features).
+- [ ] `task ci:status --branch main` is green (per `ci-green-floor.md`).
+- [ ] The submission template in `registries.md` § Submission template matches the package's current positioning.
+- [ ] The PR body (or form description) cites concrete reality, not aspiration — `task adoption:status` outputs the recent green-check tally + npm install delta the maintainer can paste into the submission.
+
+If any row stays `pending` for more than four weeks, the maintainer
+re-validates the readiness checklist; positioning that was current
+in week 1 can age out by week 4.
+
+## Adoption-tracking signal
+
+Each row's status contributes to the adoption-dimension score
+tracked in
+[`road-to-employee-product-and-external-proof.md`](../../agents/roadmaps/road-to-employee-product-and-external-proof.md)
+Phase 0 § Adoption surface:
+
+- ≥ 1 row in `accepted` — adoption-dimension lifts from "scaffolded"
+  to "evidence" for the next review round.
+- ≥ 2 rows in `accepted` — registries are no longer the bottleneck;
+  next adoption-dimension lift requires recruit-session reports
+  (Phase B of this roadmap).
+- All rows in `pending` after four weeks — the bottleneck is the
+  human-owner action, not the scaffold; the scaffold is solid.
+
+## See also
+
+- [`registries.md`](registries.md) — submission template + audit cadence + Discussions setup.
+- [`scripts/mcp_registry_submit.sh`](../../scripts/mcp_registry_submit.sh) — automation for row 1.
+- [`mcp-submission-checklist.md`](mcp-submission-checklist.md) — MCP-specific pre-submission floor.
+- `task adoption:status` (Phase C Step 6) — one-screen adoption dashboard.

package/docs/distribution/telemetry-schema.md

@@ -10,7 +10,7 @@
 This is **install-funnel** telemetry. It is distinct from
 `telemetry.artifact_engagement` (agent-runtime skill/rule/command usage,
 stored locally per consumer project — see
-[`artifact-engagement-flow`](../../packages/core/.agent-src.uncompressed/contexts/contracts/artifact-engagement-flow.md)).
+[`artifact-engagement-flow`](../../packages/core/.agent-src.uncondensed/contexts/contracts/artifact-engagement-flow.md)).
 The two systems do not share storage, transport, or opt-in state.
 
 ## Goals

package/docs/getting-started-by-role.md

@@ -4,7 +4,7 @@
 
 `agent-config` ships ~210 skills, ~67 rules, and ~124 commands. You do not need all of them. Each role below filters to the slice that pays back in week one; the rest stays available and shows up on demand when a task references it.
 
-> **Quickstart for every role.** Run `npx -y @event4u/agent-config init` — the browser wizard auto-launches and walks you through role, pack, and identity. Headless install path lives at [`docs/wizard.md`](wizard.md#headless--ci--no-browser). The wizard writes `.agent-settings.yml`, `.augment/`, and `.claude/` atomically; nothing leaves your disk.
+> **Quickstart for every role.** Run `npx -y @event4u/agent-config init` — the browser wizard auto-launches and walks you through role, ready-made setup, and identity. Headless install path lives at [`docs/wizard.md`](wizard.md#headless--ci--no-browser). The wizard writes `.agent-settings.yml`, `.augment/`, and `.claude/` atomically; nothing leaves your disk.
 
 > **Eval-gated messaging note.** Until `task bench --corpus non-dev` reports `selection_accuracy >= 0.60` (step-12 Phase 1 exit), this page is documentation, not marketing. The skills listed below are the candidates the corpus tests against; their description quality is what the eval validates.
 
@@ -59,7 +59,7 @@ Cinematic-blueprint approach: the agent expands your script into a 12-block scen
 
 **Try the first win →** [`pack-founder-strategy/FIRST_WIN.md`](../packages/pack-founder-strategy/FIRST_WIN.md) — investor question reshaped into a defensible memo in ~10 minutes.
 
-**Install path:** **MCP for advisory work, CLI when you touch code.** Claude Desktop covers strategy / finance / narrative; CLI is needed only when you sit in the repo with the dev team.
+**Install path:** **MCP for advisor work, CLI when you touch code.** Claude Desktop covers strategy / finance / narrative; CLI is needed only when you sit in the repo with the dev team.
 
 ---
 
@@ -75,7 +75,7 @@ Cinematic-blueprint approach: the agent expands your script into a 12-block scen
 
 ---
 
-## Consultant (advisory, freelance, fractional)
+## Consultant (advisor, freelance, fractional)
 
 > **Tailored role experience available →** [`agents/roles/consultant/`](../agents/roles/consultant/index.md) — three first tasks (client-brief refinement, investor memo, deck outline), priority-ordered skill shortlist. Status `draft` until recruit-session 03 lands.
 
@@ -89,6 +89,48 @@ Cinematic-blueprint approach: the agent expands your script into a 12-block scen
 
 ---
 
+## Sales rep (B2B individual contributor)
+
+> **Tailored role experience available →** [`agents/roles/sales/`](../agents/roles/sales/index.md) — three first tasks (answer customer · draft offer · prep discovery call), 5 named prompts, priority-ordered skill shortlist. Status `draft` until a sales-shaped recruit-session lands.
+
+**You want this if:** you sell — usually with the deal half in your head and half in scattered notes from the last three meetings. You spend your day answering customer questions, drafting offers, and prepping discovery calls under time pressure.
+
+- [`voice-and-tone-design`](../.agent-src/skills/voice-and-tone-design/SKILL.md) — lock the deal voice across buyer / procurement / exec sponsor.
+- [`customer-research`](../.agent-src/skills/customer-research/SKILL.md) — frame the buyer's likely concern from LinkedIn / website / inbound context.
+- [`competitive-positioning`](../.agent-src/skills/competitive-positioning/SKILL.md) — surface the ours-vs-theirs delta when the buyer names a competitor.
+
+**Install path:** **MCP recommended.** Claude Desktop opens, the package shows up as a tool, no terminal. See [`docs/mcp.md`](mcp.md).
+
+---
+
+## Support agent (customer success / technical support)
+
+> **Tailored role experience available →** [`agents/roles/support/`](../agents/roles/support/index.md) — three first tasks (summarise ticket · draft reply · escalation analysis), 5 named prompts, priority-ordered skill shortlist. Status `draft` until a support-shaped recruit-session lands.
+
+**You want this if:** you answer tickets — usually under SLA, often as the only person on a thread that turned into eight back-and-forth messages over two weeks. You want an assistant that summarises threads before you reply and flags escalation risks early.
+
+- [`voc-extract`](../.agent-src/skills/voc-extract/SKILL.md) — pulls verbatim customer language from threads for downstream triage.
+- [`voice-and-tone-design`](../.agent-src/skills/voice-and-tone-design/SKILL.md) — lock the support voice so every customer thread reads as one team.
+- [`churn-prevention`](../.agent-src/skills/churn-prevention/SKILL.md) — when the escalation-risk analysis flags churn-signal language.
+
+**Install path:** **MCP recommended.** Support workflows live in the ticketing tool + chat; Claude Desktop is the natural home.
+
+---
+
+## Team leader (engineering manager, function lead, fractional)
+
+> **Tailored role experience available →** [`agents/roles/leadership/`](../agents/roles/leadership/index.md) — three first tasks (weekly status · risk-analysis memo · decision record), 5 named prompts, priority-ordered skill shortlist. Status `draft` until a leadership-shaped recruit-session lands.
+
+**You want this if:** you run a team or a function. Each week you write the same three things: a status summary, a risk memo before a decision, and a decision record after. You want an assistant that turns fuzzy notes into structured documents — without inventing certainty you do not have.
+
+- [`decision-record`](../.agent-src/skills/decision-record/SKILL.md) — ADR-shaped output the team's record system already understands.
+- [`scenario-modeling`](../.agent-src/skills/scenario-modeling/SKILL.md) — best / base / downside frame when the risk memo demands a sweep.
+- [`stakeholder-tradeoff`](../.agent-src/skills/stakeholder-tradeoff/SKILL.md) — when the call has product / ops / exec sponsor pulling in different directions.
+
+**Install path:** **MCP recommended.** Leadership writing is doc-heavy; Claude Desktop is the natural home.
+
+---
+
 ## Galabau owner (Garten- und Landschaftsbau, small-business operator)
 
 > **Tailored role experience available →** [`agents/roles/galabau/`](../agents/roles/galabau/index.md) — three first tasks (offer drafting, customer-email reply, project-brief refinement), priority-ordered skill shortlist. Status `draft` until recruit-session 01 lands.

package/docs/getting-started.md

@@ -106,7 +106,7 @@ Your agent is now:
 - **Respecting your codebase** — no conflicting patterns
 - **Following standards** — consistent code quality
 
-This is enforced automatically by 75 rules. No configuration needed.
+This is enforced automatically by 77 rules. No configuration needed.
 
 ---
 
@@ -146,7 +146,7 @@ Your agent now understands slash commands:
 | `/quality-fix` | Run and fix all quality checks |
 | `/chat-history` | Inspect the persistent chat-history log (read-only `show`) |
 
-→ [Browse all 136 active commands](../.agent-src/commands/)
+→ [Browse all 135 active commands](../.agent-src/commands/)
 
 ---
 

package/docs/guidelines/agent-infra/5w2h-analysis.md

@@ -6,11 +6,11 @@ comprehensive understanding of any topic, problem, or plan. Adopted under
 the **Reference-Guideline Sunset Policy** (see frontmatter `upstream` /
 `refresh_trigger` keys) and cross-referenced from:
 
-- [`deep-reading-analyst`](../../../.agent-src.uncompressed/skills/deep-reading-analyst/SKILL.md)
+- [`deep-reading-analyst`](../../../.agent-src.uncondensed/skills/deep-reading-analyst/SKILL.md)
   — L1 Quick analysis depth.
-- [`refine-ticket`](../../../.agent-src.uncompressed/skills/refine-ticket/SKILL.md)
+- [`refine-ticket`](../../../.agent-src.uncondensed/skills/refine-ticket/SKILL.md)
   — completeness check on a Jira / Linear ticket before estimation.
-- [`bug-investigate`](../../../.agent-src.uncompressed/commands/bug-investigate.md)
+- [`bug-investigate`](../../../.agent-src.uncondensed/commands/bug-investigate.md)
   — gap analysis on an incident report before forming a hypothesis.
 
 > **Core principle:** "Quality of decisions equals quality of questions

package/docs/guidelines/agent-infra/ask-when-uncertain-demos.md

@@ -12,7 +12,7 @@ prose_delta:
 
 > Wrong / right / why demos for the `ask-when-uncertain` Iron Law
 > (one question per turn, vague-request must ask). Linked from
-> [`ask-when-uncertain`](../../.agent-src.uncompressed/rules/ask-when-uncertain.md)
+> [`ask-when-uncertain`](../../.agent-src.uncondensed/rules/ask-when-uncertain.md)
 > § Examples. Outcome baseline at
 > [`tests/golden/outcomes/ask_when_uncertain.json`](../../tests/golden/outcomes/ask_when_uncertain.json).
 

package/docs/guidelines/agent-infra/asking-and-brevity-examples.md

@@ -1,9 +1,9 @@
 # asking-and-brevity-examples
 
 Companion examples for three always-rules:
-[`ask-when-uncertain`](../../../.agent-src.uncompressed/rules/ask-when-uncertain.md),
-[`no-cheap-questions`](../../../.agent-src.uncompressed/rules/no-cheap-questions.md),
-[`direct-answers`](../../../.agent-src.uncompressed/rules/direct-answers.md).
+[`ask-when-uncertain`](../../../.agent-src.uncondensed/rules/ask-when-uncertain.md),
+[`no-cheap-questions`](../../../.agent-src.uncondensed/rules/no-cheap-questions.md),
+[`direct-answers`](../../../.agent-src.uncondensed/rules/direct-answers.md).
 
 The rules carry the Iron Laws and the obligation surface. This file
 carries the illustrative material (example questions, rationale

package/docs/guidelines/agent-infra/carve-out-predicates.md

@@ -1,14 +1,14 @@
 # Decidable Carve-Out Predicates
 
-Companion to [`frugality-charter`](../../../.agent-src.uncompressed/contexts/contracts/frugality-charter.md). Each carve-out below carries a one-sentence test. If the test cannot be answered yes/no from the artifact alone, the carve-out does not fire and default-terse rules apply.
+Companion to [`frugality-charter`](../../../.agent-src.uncondensed/contexts/contracts/frugality-charter.md). Each carve-out below carries a one-sentence test. If the test cannot be answered yes/no from the artifact alone, the carve-out does not fire and default-terse rules apply.
 
 ## Predicates
 
 - **Iron-Law literal** — the prose is an ALL-CAPS fenced block inside a rule whose title appears in [`docs/contracts/kernel-membership.md`](../../contracts/kernel-membership.md).
 
-- **Numbered-options with genuine trade-off** — the options differ in consequence (a chosen path produces a measurably different artifact or state), not in sequencing or output format. Per [`no-cheap-questions § What counts as cheap`](../../../.agent-src.uncompressed/rules/no-cheap-questions.md#what-counts-as-cheap).
+- **Numbered-options with genuine trade-off** — the options differ in consequence (a chosen path produces a measurably different artifact or state), not in sequencing or output format. Per [`no-cheap-questions § What counts as cheap`](../../../.agent-src.uncondensed/rules/no-cheap-questions.md#what-counts-as-cheap).
 
-- **Security-sensitive prompt** — the prompt requires credential input OR modifies auth / tenant / secret state, matching a trigger in [`security-sensitive-stop`](../../../.agent-src.uncompressed/rules/security-sensitive-stop.md).
+- **Security-sensitive prompt** — the prompt requires credential input OR modifies auth / tenant / secret state, matching a trigger in [`security-sensitive-stop`](../../../.agent-src.uncondensed/rules/security-sensitive-stop.md).
 
 - **Structured CLI contract** — the script's stdout is consumed by another script (a downstream parser exists under `scripts/` or `.augment/scripts/`), so the format is part of an interface contract, not narration.
 

package/docs/guidelines/agent-infra/critical-thinking.md

@@ -8,13 +8,13 @@ rebuilds from primitives) and `inversion-thinking` (which negates the
 goal). Adopted under the **Reference-Guideline Sunset Policy** and
 cross-referenced from:
 
-- [`deep-reading-analyst`](../../../.agent-src.uncompressed/skills/deep-reading-analyst/SKILL.md)
+- [`deep-reading-analyst`](../../../.agent-src.uncondensed/skills/deep-reading-analyst/SKILL.md)
   — L2 Standard / L3 Deep evaluation depth.
-- [`receiving-code-review`](../../../.agent-src.uncompressed/skills/receiving-code-review/SKILL.md)
+- [`receiving-code-review`](../../../.agent-src.uncondensed/skills/receiving-code-review/SKILL.md)
   — steelman bot / human review feedback before changing code.
-- [`improve-before-implement`](../../../.agent-src.uncompressed/rules/improve-before-implement.md)
+- [`improve-before-implement`](../../../.agent-src.uncondensed/rules/improve-before-implement.md)
   — challenge weak requirements with evidence-grade analysis.
-- [`adversarial-review`](../../../.agent-src.uncompressed/skills/adversarial-review/SKILL.md)
+- [`adversarial-review`](../../../.agent-src.uncondensed/skills/adversarial-review/SKILL.md)
   — paired stress-test on a diff after critique.
 
 > **Core principle:** "Steelman first, criticize second." — attacking

package/docs/guidelines/agent-infra/direct-answers-demos.md

@@ -13,7 +13,7 @@ prose_delta:
 > Wrong / right / why demos for the three Iron Laws of
 > `direct-answers` (no flattery, no invented facts, brevity by
 > default). Linked from
-> [`direct-answers`](../../.agent-src.uncompressed/rules/direct-answers.md)
+> [`direct-answers`](../../.agent-src.uncondensed/rules/direct-answers.md)
 > § Examples. Outcome baseline at
 > [`tests/golden/outcomes/direct_answers.json`](../../tests/golden/outcomes/direct_answers.json).
 

package/docs/guidelines/agent-infra/first-principles.md

@@ -8,11 +8,11 @@ verified primitives and reconstruct it without inherited convention.
 Adopted under the **Reference-Guideline Sunset Policy** and
 cross-referenced from:
 
-- [`deep-reading-analyst`](../../../.agent-src.uncompressed/skills/deep-reading-analyst/SKILL.md)
+- [`deep-reading-analyst`](../../../.agent-src.uncondensed/skills/deep-reading-analyst/SKILL.md)
   — L3 Deep analysis depth.
 - [`mental-models`](mental-models.md) — Munger's lattice; first
   principles is the foundational physics-style lens.
-- [`improve-before-implement`](../../../.agent-src.uncompressed/rules/improve-before-implement.md)
+- [`improve-before-implement`](../../../.agent-src.uncondensed/rules/improve-before-implement.md)
   — challenge the framing of a request before coding it.
 - [`inversion-thinking`](inversion-thinking.md) — pair: first
   principles rebuilds; inversion stress-tests the rebuild.

package/docs/guidelines/agent-infra/inversion-thinking.md

@@ -4,18 +4,18 @@ Reference guideline for Wing-1 deep-thinking work — Carl Jacobi's
 "invert, always invert" applied to **decisions and arguments**, not
 diffs. The pre-mortem on a strategy, an argument, or a written plan;
 distinct from
-[`adversarial-review`](../../../.agent-src.uncompressed/skills/adversarial-review/SKILL.md)
+[`adversarial-review`](../../../.agent-src.uncondensed/skills/adversarial-review/SKILL.md)
 which stress-tests **diffs**. Adopted under the **Reference-Guideline
 Sunset Policy** (see frontmatter `upstream` / `refresh_trigger` keys)
 and cross-referenced from:
 
-- [`refine-prompt`](../../../.agent-src.uncompressed/skills/refine-prompt/SKILL.md)
+- [`refine-prompt`](../../../.agent-src.uncondensed/skills/refine-prompt/SKILL.md)
   — pre-mortem on a free-form prompt before planning.
-- [`refine-ticket`](../../../.agent-src.uncompressed/skills/refine-ticket/SKILL.md)
+- [`refine-ticket`](../../../.agent-src.uncondensed/skills/refine-ticket/SKILL.md)
   — pre-mortem on a Jira / Linear ticket before estimation.
-- [`threat-modeling`](../../../.agent-src.uncompressed/skills/threat-modeling/SKILL.md)
+- [`threat-modeling`](../../../.agent-src.uncondensed/skills/threat-modeling/SKILL.md)
   — abuse-case generation pairs with goal inversion.
-- [`improve-before-implement`](../../../.agent-src.uncompressed/rules/improve-before-implement.md)
+- [`improve-before-implement`](../../../.agent-src.uncondensed/rules/improve-before-implement.md)
   — challenge weak requirements before writing code.
 
 > **Core principle:** "Invert, always invert." — Carl Jacobi

package/docs/guidelines/agent-infra/layered-settings.md

@@ -18,7 +18,7 @@ on user request.
 | File | Git | Scope | Owner | Example values |
 |---|---|---|---|---|
 | `.agent-project-settings.yml` | **committed** | team / repo | lead maintainer | `project.stack`, `quality.php.tools`, `memory.dogfood` |
-| `~/.event4u/agent-config/agent-settings.yml` | **n/a** (outside repo) | individual developer · cross-project | individual | `name`, `ide`, `cost_profile`, `personal.bot_icon`, `personal.autonomy`, `caveman.speak_scope` (legacy `~/.config/agent-config/agent-settings.yml` read as fallback) |
+| `~/.event4u/agent-config/agent-settings.yml` | **n/a** (outside repo) | individual developer · cross-project | individual | `name`, `ide`, `cost_profile`, `personal.bot_icon`, `personal.autonomy`, `telegraph.speak_scope` (legacy `~/.config/agent-config/agent-settings.yml` read as fallback) |
 | `.agent-settings.yml` | **gitignored** | individual developer · this project | individual | `personal.ide`, `personal.user_name`, `subagents.max_parallel`, `onboarding.onboarded` |
 
 All three are YAML. Schemas:
@@ -55,7 +55,7 @@ ide
 cost_profile
 personal.bot_icon
 personal.autonomy
-caveman.speak_scope
+telegraph.speak_scope
 ```
 
 Loader contract:
@@ -150,6 +150,60 @@ pattern (e.g. `*.yml` in a nested folder) would otherwise match.
   rules](#section-aware-merge-rules) — preserve existing values,
   template order, and comments. No ad-hoc YAML rewrites.
 
+## Module discovery
+
+Module-aware skills and commands (`module-management`, `/module
+explore`, `/module create`, roadmap-writing) consult the `modules:`
+block on the **team** layer
+([`agent-project-settings.example.yml`](../../templates/agents/agent-project-settings.example.yml))
+to find module roots, namespace conventions, and per-module
+`agents/` folders. Lives next to `project.stack` because it
+describes the same thing — repo layout.
+
+| Key | Default | Purpose |
+|---|---|---|
+| `modules.enabled` | `false` | Master switch; when off, every module-aware surface treats the repo as flat |
+| `modules.root_paths` | `[]` | Repo-relative directories whose direct children are modules |
+| `modules.namespace_template` | `""` | Substitution template (`{ModuleName}`) for stacks with a PHP-style namespace |
+| `modules.agent_folder` | `"agents"` | Per-module folder the agent auto-loads on `/module explore <Name>` |
+| `modules.skip_dirs` | `[".module-template", ".example"]` | Directory names skipped during enumeration |
+
+Stack-by-stack starting points (manual setup; the installer fills
+these on opt-in when it detects a known shape):
+
+```yaml
+# Laravel HMVC
+modules:
+  enabled: true
+  root_paths: [app/Modules]
+  namespace_template: "App\\Modules\\{ModuleName}\\App"
+
+# Symfony DDD-lite (or PHP with a single src tree)
+modules:
+  enabled: true
+  root_paths: [src]
+  namespace_template: "App\\{ModuleName}"
+
+# Node monorepo
+modules:
+  enabled: true
+  root_paths: [packages]
+  namespace_template: ""
+
+# Go internal layout
+modules:
+  enabled: true
+  root_paths: [internal]
+  namespace_template: ""
+```
+
+Multi-root repos list each root once; enumeration walks every
+listed root and merges results.
+
+Lock via `locked_keys: [modules.root_paths]` when the layout must
+not drift between developers — typical for compliance-critical or
+multi-team repos.
+
 ## Persona-list merge semantics
 
 Persona configuration does **not** follow the simple "higher layer

package/docs/guidelines/agent-infra/mental-models.md

@@ -6,11 +6,11 @@ lens at a time. Adopted under the **Reference-Guideline Sunset Policy**
 (see frontmatter `upstream` / `refresh_trigger` keys) and cross-referenced
 from:
 
-- [`deep-reading-analyst`](../../../.agent-src.uncompressed/skills/deep-reading-analyst/SKILL.md)
+- [`deep-reading-analyst`](../../../.agent-src.uncondensed/skills/deep-reading-analyst/SKILL.md)
   — L3 Deep analysis depth.
-- [`refine-prompt`](../../../.agent-src.uncompressed/skills/refine-prompt/SKILL.md)
+- [`refine-prompt`](../../../.agent-src.uncondensed/skills/refine-prompt/SKILL.md)
   — multi-lens prompt refinement.
-- [`judge-bug-hunter`](../../../.agent-src.uncompressed/skills/judge-bug-hunter/SKILL.md)
+- [`judge-bug-hunter`](../../../.agent-src.uncondensed/skills/judge-bug-hunter/SKILL.md)
   — diff review through more than the bug-hunter lens.
 
 > **Core principle:** "To a man with only a hammer, every problem looks

package/docs/guidelines/agent-infra/roadmap-progress-mechanics.md

@@ -2,7 +2,7 @@
 
 > Any touch to agents/roadmaps/ — create/rename/delete/move, edit checkboxes ([x]/[~]/[-]), add/rename/remove phases — must regenerate dashboard and archive if 0 open items, same response
 
-_Origin: migrated from `.agent-src.uncompressed/rules/roadmap-progress-sync.md` per P4.2 of `road-to-kernel-and-router.md`._
+_Origin: migrated from `.agent-src.uncondensed/rules/roadmap-progress-sync.md` per P4.2 of `road-to-kernel-and-router.md`._
 
 <!-- cloud_safe: degrade -->
 <!-- Authoring discipline applies in cloud; local script + regen are no-ops there. -->
@@ -147,7 +147,7 @@ dashboard, commit if commit policy allows.
 A reply that lands a verified step without flipping its checkbox is a rule violation.
 
 **Deterministic flip-guard.** The autonomous loop carries a per-step
-guard at [`roadmap-process-loop § 5b`](../../.agent-src.uncompressed/contexts/execution/roadmap-process-loop.md#5b-flip-guard--deterministic):
+guard at [`roadmap-process-loop § 5b`](../../.agent-src.uncondensed/contexts/execution/roadmap-process-loop.md#5b-flip-guard--deterministic):
 after the atomic flip, the loop runs
 `git diff --name-only -- agents/roadmaps/<file>.md` and halts loudly
 when the diff is empty. The `command:` triggers on

package/docs/guidelines/agent-infra/rule-type-governance.md

@@ -2,7 +2,7 @@
 
 > Creating or editing rules, or auditing rule types — decides when a rule should be always vs auto
 
-_Origin: migrated from `.agent-src.uncompressed/rules/rule-type-governance.md` per P4.2 of `road-to-kernel-and-router.md`._
+_Origin: migrated from `.agent-src.uncondensed/rules/rule-type-governance.md` per P4.2 of `road-to-kernel-and-router.md`._
 
 # rule-type-governance
 

package/docs/guidelines/agent-infra/scqa-framework.md

@@ -17,16 +17,16 @@ refresh trigger.
 
 Cross-referenced from:
 
-- [`deep-reading-analyst`](../../../.agent-src.uncompressed/skills/deep-reading-analyst/SKILL.md)
+- [`deep-reading-analyst`](../../../.agent-src.uncondensed/skills/deep-reading-analyst/SKILL.md)
   — Step 2B structural decomposition (always run, all depths).
-- [`agent-docs-writing`](../../../.agent-src.uncompressed/skills/agent-docs-writing/SKILL.md)
+- [`agent-docs-writing`](../../../.agent-src.uncondensed/skills/agent-docs-writing/SKILL.md)
   — narrative structure for module docs and AGENTS.md.
-- [`requesting-code-review`](../../../.agent-src.uncompressed/skills/requesting-code-review/SKILL.md)
+- [`requesting-code-review`](../../../.agent-src.uncondensed/skills/requesting-code-review/SKILL.md)
   — PR description structure (S = current state, C = pain point,
   Q = scope, A = the diff).
-- [`refine-prompt`](../../../.agent-src.uncompressed/skills/refine-prompt/SKILL.md)
+- [`refine-prompt`](../../../.agent-src.uncondensed/skills/refine-prompt/SKILL.md)
   — reconstruct a free-form prompt into S-C-Q-A acceptance criteria.
-- [`refine-ticket`](../../../.agent-src.uncompressed/skills/refine-ticket/SKILL.md)
+- [`refine-ticket`](../../../.agent-src.uncondensed/skills/refine-ticket/SKILL.md)
   — Jira / Linear ticket clarification through the four-element lens.
 
 > **The 4 elements:** S (Situation) · C (Complication) · Q (Question)

package/docs/guidelines/agent-infra/self-improvement-pipeline.md

@@ -92,7 +92,7 @@ blocks — it does not hand a half-filled doc to the next stage.
   proposal doc as the PR body. Standard package CI runs.
   Frontmatter `stage: upstream` and `upstream_pr_url` set.
 - **Guardrails:** no `upstream-contribute` invocation ever edits
-  `.agent-src.uncompressed/` in the consumer repo. Writes happen
+  `.agent-src.uncondensed/` in the consumer repo. Writes happen
   in the fork / PR branch of the package repo only.
 
 ## Stage ownership
@@ -122,7 +122,7 @@ unreviewed upstream changes is not.
   need the evidence in one place.
 - **Do NOT** promote a learning with one piece of evidence. Two
   independent sources is the minimum; the gate enforces it.
-- **Do NOT** edit `.agent-src.uncompressed/` directly in a consumer
+- **Do NOT** edit `.agent-src.uncondensed/` directly in a consumer
   project "just to try it out". Drafts live in `agents/proposals/`.
 - **Do NOT** treat a `block` verdict as a personal rejection. The
   gate checks structural shape, not author intent.

package/docs/guidelines/agent-infra/six-hats.md

@@ -7,12 +7,12 @@ separate thinking modes and avoid the cross-talk that derails group
 decisions. Adopted under the **Reference-Guideline Sunset Policy** and
 cross-referenced from:
 
-- [`deep-reading-analyst`](../../../.agent-src.uncompressed/skills/deep-reading-analyst/SKILL.md)
+- [`deep-reading-analyst`](../../../.agent-src.uncondensed/skills/deep-reading-analyst/SKILL.md)
   — L2 Standard analysis depth (multi-perspective sweep).
-- [`ai-council`](../../../.agent-src.uncompressed/skills/ai-council/SKILL.md)
+- [`ai-council`](../../../.agent-src.uncondensed/skills/ai-council/SKILL.md)
   — multi-model consultation pattern; Six Hats is the per-perspective
   decomposition the council voices use when adjudicating a decision.
-- [`/council`](../../../.agent-src.uncompressed/commands/council.md)
+- [`/council`](../../../.agent-src.uncondensed/commands/council.md)
   — internal council orchestrator routing to per-hat persona prompts.
 
 > **Core principle:** "Wear one hat at a time." — separating thinking

package/docs/guidelines/agent-infra/skill-quality-checklist.md

@@ -2,7 +2,7 @@
 
 > Creating, editing, or reviewing skills — minimum quality standard, every skill must be executable, validated, and self-contained
 
-_Origin: migrated from `.agent-src.uncompressed/rules/skill-quality.md` per P4.2 of `road-to-kernel-and-router.md`._
+_Origin: migrated from `.agent-src.uncondensed/rules/skill-quality.md` per P4.2 of `road-to-kernel-and-router.md`._
 
 # Skill Quality
 
@@ -50,14 +50,14 @@ If a skill is not executable without opening a guideline, it is broken.
 **Litmus test:** Cover all guideline references in the Procedure. Is it still executable?
 If not → the skill needs more own steps, decisions, and validation — not more guideline links.
 
-## Merge & Compression Preservation
+## Merge & Condensation Preservation
 
-When merging or compressing skills, the result MUST preserve the
+When merging or condensing skills, the result MUST preserve the
 strongest validation, strongest examples, all anti-patterns, all
 decision criteria, and trigger quality. Full preservation invariants
-and "merge is invalid if …" / "compression may remove …" lists in
+and "merge is invalid if …" / "condensation may remove …" lists in
 [`contexts/communication/rules-auto/skill-quality-mechanics.md`](../contexts/communication/rules-auto/skill-quality-mechanics.md)
-§ Merge Preservation and § Compression Preservation.
+§ Merge Preservation and § Condensation Preservation.
 
 ## Refactor Safety
 

package/docs/guidelines/agent-infra/systems-thinking.md

@@ -7,7 +7,7 @@ feedback loops, leverage points, and cross-domain archetypes that
 reveal where intervention has the highest impact. Adopted under the
 **Reference-Guideline Sunset Policy** and cross-referenced from:
 
-- [`deep-reading-analyst`](../../../.agent-src.uncompressed/skills/deep-reading-analyst/SKILL.md)
+- [`deep-reading-analyst`](../../../.agent-src.uncondensed/skills/deep-reading-analyst/SKILL.md)
   — L3 Deep analysis depth.
 - [`mental-models`](mental-models.md) — Munger's lattice; systems
   thinking is one of the strongest engineering / biology lenses.

package/docs/guidelines/agent-infra/verify-before-complete-demos.md

@@ -13,7 +13,7 @@ prose_delta:
 > Wrong / right / why demos for the `verify-before-complete` Iron
 > Law (no completion claim without fresh evidence in this message).
 > Linked from
-> [`verify-before-complete`](../../.agent-src.uncompressed/rules/verify-before-complete.md)
+> [`verify-before-complete`](../../.agent-src.uncondensed/rules/verify-before-complete.md)
 > § Examples. Outcome baseline at
 > [`tests/golden/outcomes/verify_before_complete.json`](../../tests/golden/outcomes/verify_before_complete.json).
 

package/docs/guidelines/augment-portability-patterns.md

@@ -2,7 +2,7 @@
 
 > Editing or creating files inside .augment/ directory — skills, rules, commands, templates, contexts must be project-agnostic
 
-_Origin: migrated from `.agent-src.uncompressed/rules/augment-portability.md` per P4.2 of `road-to-kernel-and-router.md`._
+_Origin: migrated from `.agent-src.uncondensed/rules/augment-portability.md` per P4.2 of `road-to-kernel-and-router.md`._
 
 # Package Portability
 
@@ -39,8 +39,8 @@ content into any of them pollutes downstream projects or misleads agents.
 Skills, rules, commands, guidelines, personas, and context docs run in
 **consumer projects**, which may not have Task installed. **Never**
 reference a `task <something>` invocation inside any artefact file
-under `.agent-src.uncompressed/{skills,rules,commands,guidelines,personas,contexts}/`
-(and therefore also not in the compressed mirror under `.agent-src/`).
+under `.agent-src.uncondensed/{skills,rules,commands,guidelines,personas,contexts}/`
+(and therefore also not in the condensed mirror under `.agent-src/`).
 Use direct script invocations instead.
 
 ## Consumer CLI — `./agent-config`
@@ -61,7 +61,7 @@ invocation.
 
 ## Enforcement
 
-`scripts/check_portability.py` scans `.augment/`, `.agent-src.uncompressed/`,
+`scripts/check_portability.py` scans `.augment/`, `.agent-src.uncondensed/`,
 and the package repo's root `AGENTS.md` + `.github/copilot-instructions.md`
 for forbidden identifiers, for any `task <name>` invocation inside
 artefact files, and for direct script invocations that bypass the

package/docs/guidelines/cross-role-handoff.md

@@ -93,7 +93,7 @@ Council Q3 (2026-05-05) locks the disambiguation between L4
   shipping — becomes **input to L4**. The escalation is one-way:
   L4 produces the dissent log that decides whether C8's verdict
   is overridden, with the override recorded in
-  [`decision-record`](../../.agent-src.uncompressed/skills/decision-record/SKILL.md).
+  [`decision-record`](../../.agent-src.uncondensed/skills/decision-record/SKILL.md).
 
 The boundary keeps the two skills sharp — neither absorbs the other —
 and gives the agent a deterministic rule for which one to load when
@@ -123,5 +123,5 @@ No cluster collision, no tier mismatch, no untyped drift.
 - [`docs/contracts/context-spine.md`](../contracts/context-spine.md)
   — orthogonal context-slot mechanism, often used together with a
   handoff (e.g. delegate reads `team` slot the initiator opted in to).
-- `.agent-src.uncompressed/skills/subagent-orchestration/SKILL.md` § mode 6
+- `.agent-src.uncondensed/skills/subagent-orchestration/SKILL.md` § mode 6
   — when the chain runs in fresh worktrees.

package/docs/guidelines/php/php-coding-patterns.md

@@ -2,7 +2,7 @@
 
 > Writing or reviewing PHP code — strict types, naming, comparisons, early returns, Eloquent conventions
 
-_Origin: migrated from `.agent-src.uncompressed/rules/php-coding.md` per P4.2 of `road-to-kernel-and-router.md`._
+_Origin: migrated from `.agent-src.uncondensed/rules/php-coding.md` per P4.2 of `road-to-kernel-and-router.md`._
 
 # PHP Coding Rules