@event4u/agent-config 5.10.1 → 6.0.0

package/docs/contracts/smoke-contracts.md

@@ -34,7 +34,7 @@ the paths touched in the PR:
 
 | Tier | Globs that trigger | Script |
 |---|---|---|
-| kernel | `.agent-src.uncondensed/rules/**`, `.agent-src/rules/**`, `dist/router.json`, `scripts/measure_rule_budget.py` | `scripts/smoke/kernel.sh` |
+| kernel | `.agent-src.uncondensed/rules/**`, `dist/agent-src/rules/**`, `dist/router.json`, `scripts/measure_rule_budget.py` | `scripts/smoke/kernel.sh` |
 | router | `dist/router.json`, `.agent-src.uncondensed/rules/**`, `.agent-src.uncondensed/skills/**`, `docs/contracts/**`, `docs/guidelines/**` | `scripts/smoke/router.sh` |
 | schema | `.agent-src.uncondensed/skills/**`, `.agent-src.uncondensed/rules/**`, `scripts/schemas/**`, `scripts/skill_linter.py`, `scripts/validate_frontmatter.py` | `scripts/smoke/schema.sh` |
 | skills | `.agent-src.uncondensed/skills/**` | `scripts/smoke/skills.sh` |
@@ -74,7 +74,7 @@ constant in the script body and the row below.
 ```
 
 - **68 ids** — 10 kernel + 23 tier_1 + 35 tier_2; every id resolves to
-  `.agent-src/rules/<id>.md`.
+  `dist/agent-src/rules/<id>.md`.
 - **0 broken rule pointers** — hard assertion; smoke fails on any miss.
 - **36 routes_to refs** across tier_1 + tier_2; resolver honours the
   four prefixes (`skill:`, `command:`, `guideline:`, `contract:`).
@@ -110,7 +110,7 @@ constant in the script body and the row below.
   `.agent-src.uncondensed/skills/*/SKILL.md` and re-validated via
   `scripts/validate_frontmatter.py`. `agent-config explain skill` is
   **not** invoked — `explain` only supports `{config,rule,route}` today
-  ([`scripts/agent-config/cmd_explain.py`](../../scripts/agent-config/cmd_explain.py));
+  ([`scripts/agent-config/cmd_explain.py`](../../src/scripts/agent-config/cmd_explain.py));
   filesystem-resolution is the contract.
 
 ## § 4 — Local invocation
@@ -132,7 +132,7 @@ the final baseline line) for CI summary parsing.
 |---|---|---|
 | `kernel.sh` reports > 9 missing fences | Kernel rule lost its Iron Law block during edit | Restore the fence; update `EXEMPT_FROM_FENCE` only for new dispatch indexes |
 | `router.sh` reports > 0 broken pointers | `dist/router.json` references an id without a rule file | Add the rule or remove the route — never edit the smoke baseline up |
-| `schema.sh` reports FAILs | A skill / rule lost a required field | Restore via [`scripts/schemas/skill.schema.json`](../../scripts/schemas/skill.schema.json) |
+| `schema.sh` reports FAILs | A skill / rule lost a required field | Restore via [`scripts/schemas/skill.schema.json`](../../src/scripts/schemas/skill.schema.json) |
 | `skills.sh` 5/5 random sample fails | Hand-edit broke frontmatter or renamed directory without updating `name:` | Restore filename ↔ slug coupling |
 
 ## § 6 — See also

package/docs/contracts/telegraph-telemetry.md

@@ -66,10 +66,10 @@ Until a v2 bench (broader corpus or a re-tuned dialect) lifts the
 
 ## Consumers
 
-- [`scripts/telegraph_stats.py`](../../scripts/telegraph_stats.py) — reads
+- [`scripts/telegraph_stats.py`](../../src/scripts/telegraph_stats.py) — reads
   this constant, computes per-session / per-conversation / lifetime
   deltas from `agents/cost-tracking/sessions.jsonl`.
-- [`scripts/cost_summary.py`](../../scripts/cost_summary.py) — emits
+- [`scripts/cost_summary.py`](../../src/scripts/cost_summary.py) — emits
   the stable JSON contract for inter-tool consumption per
   [`cost-summary-schema.md`](cost-summary-schema.md).
 - `agent-status` skill — surfaces the per-session delta in the

package/docs/contracts/trust-and-safety.md

@@ -109,7 +109,7 @@ asserts three invariants over `dist/discovery/discovery-manifest.json`:
    least one artefact whose logical path contains `safety-floor`.
 2. **Banner presence.** Every artefact with
    `trust.human_review_required: true` has its compiled output under
-   `.agent-src/<logical>` and that output contains
+   `dist/agent-src/<logical>` and that output contains
    `<!-- agent-config:human-review-banner -->`.
 3. **Kernel trust floor.** Every rule listed in `dist/router.json` `kernel[]`
    declares `trust.level: core`. No escalation (advisory blocks the
@@ -135,10 +135,10 @@ Exits 0 clean, 1 on any violation. Tests in
 ## § 7 — References
 
 - ADR: [`ADR-018 — Trust & Safety Layer`](../decisions/ADR-018-trust-and-safety-layer.md)
-- Condenseor implementation: [`scripts/condense.py`](../../scripts/condense.py)
+- Condenseor implementation: [`scripts/condense.py`](../../src/scripts/condense.py)
   (`_inject_hrr_banner`, `_HRR_BANNER_MARKER`)
 - Installer implementation: [`packages/core/installer/src/trust-escalation.ts`](../../packages/core/installer/src/trust-escalation.ts)
-- Lint implementation: [`scripts/lint_trust_coherence.py`](../../scripts/lint_trust_coherence.py)
+- Lint implementation: [`scripts/lint_trust_coherence.py`](../../src/scripts/lint_trust_coherence.py)
 - Sibling contracts: [`safety-model`](safety-model.md) ·
   [`kernel-membership`](kernel-membership.md) ·
   [`ADR-013` — discovery frontmatter](../decisions/ADR-013-discovery-frontmatter-contract.md)

package/docs/contracts/universal-skills.md

@@ -18,21 +18,21 @@ The allowlist solves the over-siloing risk identified by the AI Council 2026-05-
 
 | Skill | Why universal |
 |---|---|
-| [`refine-prompt`](../../.agent-src/skills/refine-prompt/SKILL.md) | Every free-form request needs AC + assumption + confidence band before the engine runs. |
-| [`refine-ticket`](../../.agent-src/skills/refine-ticket/SKILL.md) | Every ticket (Jira / Linear / GH issue) needs scoped AC before plan. |
-| [`estimate-ticket`](../../.agent-src/skills/estimate-ticket/SKILL.md) | Sizing + split + risk — applies to any work item, technical or not. |
-| [`verify-completion-evidence`](../../.agent-src/skills/verify-completion-evidence/SKILL.md) | Iron-Law gate: fresh evidence before any "done" claim. Survives every mode. |
-| [`threat-modeling`](../../.agent-src/skills/threat-modeling/SKILL.md) | Pre-implementation abuse-case enumeration — same lens applies to a marketing form and a payment endpoint. |
-| [`systematic-debugging`](../../.agent-src/skills/systematic-debugging/SKILL.md) | Reproduce → isolate → hypothesize → verify — works on broken pipelines, broken docs, broken funnels. |
-| [`doc-coauthoring`](../../.agent-src/skills/doc-coauthoring/SKILL.md) | 3-stage write loop (context → section → reader-test) for any long-form doc. |
-| [`deep-reading-analyst`](../../.agent-src/skills/deep-reading-analyst/SKILL.md) | Article / long-form analysis via SCQA + mental models — used by every role that reads. |
-| [`decision-record`](../../.agent-src/skills/decision-record/SKILL.md) | Trade-off framing before any commit. ADR-shape works for tech, hiring, and pricing. |
-| [`adr-create`](../../.agent-src/skills/adr-create/SKILL.md) | Naming + numbering + index regen — the file mechanics of `decision-record`. |
-| [`risk-officer`](../../.agent-src/skills/risk-officer/SKILL.md) | Blast-radius framing + residual-risk verdict before any commit. |
-| [`adversarial-review`](../../.agent-src/skills/adversarial-review/SKILL.md) | Devil's advocate stress-test — opt-in but always available. |
-| [`customer-research`](../../.agent-src/skills/customer-research/SKILL.md) | Discovery-slice shaping (JTBD, switch-event) — used by founder, GTM, consultant, creator. |
-| [`stakeholder-tradeoff`](../../.agent-src/skills/stakeholder-tradeoff/SKILL.md) | Per-lens framing when stakeholders disagree — applies in every org. |
-| [`md-language-check`](../../.agent-src/skills/md-language-check/SKILL.md) | Hard gate: `.md` files stay English; the agent translates at runtime. |
+| [`refine-prompt`](../../dist/agent-src/skills/refine-prompt/SKILL.md) | Every free-form request needs AC + assumption + confidence band before the engine runs. |
+| [`refine-ticket`](../../dist/agent-src/skills/refine-ticket/SKILL.md) | Every ticket (Jira / Linear / GH issue) needs scoped AC before plan. |
+| [`estimate-ticket`](../../dist/agent-src/skills/estimate-ticket/SKILL.md) | Sizing + split + risk — applies to any work item, technical or not. |
+| [`verify-completion-evidence`](../../dist/agent-src/skills/verify-completion-evidence/SKILL.md) | Iron-Law gate: fresh evidence before any "done" claim. Survives every mode. |
+| [`threat-modeling`](../../dist/agent-src/skills/threat-modeling/SKILL.md) | Pre-implementation abuse-case enumeration — same lens applies to a marketing form and a payment endpoint. |
+| [`systematic-debugging`](../../dist/agent-src/skills/systematic-debugging/SKILL.md) | Reproduce → isolate → hypothesize → verify — works on broken pipelines, broken docs, broken funnels. |
+| [`doc-coauthoring`](../../dist/agent-src/skills/doc-coauthoring/SKILL.md) | 3-stage write loop (context → section → reader-test) for any long-form doc. |
+| [`deep-reading-analyst`](../../dist/agent-src/skills/deep-reading-analyst/SKILL.md) | Article / long-form analysis via SCQA + mental models — used by every role that reads. |
+| [`decision-record`](../../dist/agent-src/skills/decision-record/SKILL.md) | Trade-off framing before any commit. ADR-shape works for tech, hiring, and pricing. |
+| [`adr-create`](../../dist/agent-src/skills/adr-create/SKILL.md) | Naming + numbering + index regen — the file mechanics of `decision-record`. |
+| [`risk-officer`](../../dist/agent-src/skills/risk-officer/SKILL.md) | Blast-radius framing + residual-risk verdict before any commit. |
+| [`adversarial-review`](../../dist/agent-src/skills/adversarial-review/SKILL.md) | Devil's advocate stress-test — opt-in but always available. |
+| [`customer-research`](../../dist/agent-src/skills/customer-research/SKILL.md) | Discovery-slice shaping (JTBD, switch-event) — used by founder, GTM, consultant, creator. |
+| [`stakeholder-tradeoff`](../../dist/agent-src/skills/stakeholder-tradeoff/SKILL.md) | Per-lens framing when stakeholders disagree — applies in every org. |
+| [`md-language-check`](../../dist/agent-src/skills/md-language-check/SKILL.md) | Hard gate: `.md` files stay English; the agent translates at runtime. |
 
 ## Inclusion criteria
 
@@ -44,7 +44,7 @@ A skill earns the universal label when **all three** hold:
 
 ## Exclusion criteria
 
-- **Domain anchor.** `voice-and-tone-design` (creator), `runway-cognition` (founder), `quality-tools` (developer), `pipeline-strategy` (GTM) — strong-fit for one user-type, weak for the other five. These tag via the `recommended_for_user_types:` frontmatter field defined in [`skill.schema.json`](../../scripts/schemas/skill.schema.json).
+- **Domain anchor.** `voice-and-tone-design` (creator), `runway-cognition` (founder), `quality-tools` (developer), `pipeline-strategy` (GTM) — strong-fit for one user-type, weak for the other five. These tag via the `recommended_for_user_types:` frontmatter field defined in [`skill.schema.json`](../../src/scripts/schemas/skill.schema.json).
 - **Tool-specific.** `laravel-horizon`, `nextjs-patterns`, `mcp-builder`, `terraform` — load only when the matching stack flag is set.
 - **Council / role review.** `judge-bug-hunter`, `judge-security-auditor`, `architecture-review-lens` — load via subagent orchestration, not via universal allowlist.
 

package/docs/contracts/value-dashboard-spec.md

@@ -24,9 +24,9 @@ machine-readable source of truth.
 ## Source
 
 - **Chat thread:** 2026-05-27 (the owner's verdict: *"Aktuell bringen
-  diese Benchmarks nichts. Ich weiß worum es geht und verstehe sie nicht
+  diese Benchmarks nichts. Ich weiß worum es geht und verstehe sie nicht  <!-- md-language-check: ignore -->
   mal."*)
-- **Roadmap:** `agents/roadmaps/road-to-readable-value-dashboard.md`
+- **Roadmap:** `road-to-readable-value-dashboard` (archived)
 - **Extends:** archived `road-to-package-impact-benchmark.md` (A/B
   surface) and archived `step-4-measurement-and-benchmark.md`
   (telegraph + selection bench).
@@ -70,18 +70,18 @@ Each rung is a measurement (or a clearly-marked `pending` placeholder),
 not a marketing number. The ladder is **honest about the up-front
 cost**: installing the package first *adds* input tokens (rules load
 into context); condense + rtk + terse then claw that back. The
-**NETTO** line is the real answer.
+**NET** line is the real answer.
 
 Rung order:
 
-1. **Ohne Paket** — baseline. Token delta = 0. Reference rung; the
+1. **Without package** — baseline. Token delta = 0. Reference rung; the
    ladder is computed relative to this.
-2. **Mit Paket (Regeln laden)** — the honest up-front cost. The
+2. **With package (rule load)** — the honest up-front cost. The
    always-loaded kernel + router footprint added to every request's
    input. Token delta is *positive* (the rule body lands in context).
    Source: `metric_a_footprint` from `frugality/baseline.jsonl`.
 3. **+ condense** — the input-side carve-out savings from
-   condensation (`.agent-src.uncondensed` → `.agent-src`). Source:
+   condensation (`.agent-src.uncondensed` → `dist/agent-src`). Source:
    `internal/bench/reports/telegraph-v2.json`. **Excludes Thin-Root
    files** (AGENTS.md variants — they net negative); the Thin-Root
    caveat surfaces as a footnote, not a hidden exclusion.
@@ -100,7 +100,7 @@ Rung order:
 
 The renderer prints, per rung:
 
-- **label** — short German + English ("Mit Paket / +load")
+- **label** — short English ("With package (rule load) / +load")
 - **what-it-does** — one phrase a non-developer understands
 - **token_delta** — signed integer (positive = adds tokens)
 - **eur_delta** — token_delta priced at the reference scale below
@@ -144,7 +144,7 @@ Every rung in the `cost_ladder` array carries:
 
 ```yaml
 id: <kebab-case>                  # e.g. "load", "condense", "rtk"
-label: "<German + English>"       # e.g. "Mit Paket (Regeln laden)"
+label: "<English>"                # e.g. "With package (rule load)"
 what_it_does: "<one phrase>"      # plain language, ≤ 80 chars
 token_delta: <signed int>         # per-request input token delta
 eur_delta: <float>                # token_delta priced at reference scale
@@ -212,7 +212,7 @@ Each metric in the `behaviour` block carries:
 
 ```yaml
 id: <kebab-case>                  # e.g. "selection", "destructive-stops"
-label: "<German + English>"
+label: "<English>"
 what_this_means: "<one line>"     # plain language caption
 with: <value>                     # metric-specific (pct, count, ratio)
 without: <value>
@@ -237,9 +237,9 @@ corpus. This roadmap considered two options:
 product (per the non-goals section of the roadmap). Hiding the
 negative number — even by relocating it to a "quality" panel —
 would betray the for-dummies-honest framing. The rung renders with
-its measured value, `confidence: measured`, and a caption: *"In
-unserem Testkorpus liefert Telegraph mehr Tokens als ein neutrales
-'sei knapp' — wir messen, wir verstecken nicht."*
+its measured value, `confidence: measured`, and a caption: *"In our
+test corpus, telegraph delivers more tokens than a neutral
+'be terse' — we measure, we do not hide."*
 
 ## Glossary (rendered into `docs/value.md`)
 
@@ -258,15 +258,15 @@ copies it verbatim into the dashboard.
   than input. Per-token output costs more than input.
 - **condense** — a build step that shrinks the rule files
   before they ship (`.agent-src.uncondensed` →
-  `.agent-src`). Saves input tokens on every request.
+  `dist/agent-src`). Saves input tokens on every request.
 - **rtk** — the *Rust Token Killer*, a CLI wrapper that strips
   verbose output (`git status`, lint output, test runners) before
   the model reads it. Saves input tokens on tool calls.
 - **terse / telegraph** — a style of output (short phrases,
   dropped articles) the agent uses when condensing replies.
   Saves output tokens — when the corpus rewards it.
-- **Ohne Paket / Mit Paket** — "without the package" /
-  "with the package" — the two arms of the A/B comparison.
+- **Without package / With package** — the two arms of the A/B
+  comparison.
 - **Δ Tokens** — input-token difference per request vs. the baseline.
   The rendered dashboard reports cost in **tokens only** — no € figure.
   A €/USD comparison would assume per-call API pricing, which the many
@@ -292,9 +292,9 @@ actual always-loaded kernel. The real kernel has 10 rules per
 | Metric | Before fix | After fix | Delta |
 |---|---:|---:|---:|
 | `load` token delta | +4 843 | **+8 977** | +4 134 |
-| NETTO token delta | +4 120 | **+8 254** | +4 134 |
-| NETTO `cumulative_pct` | +51.5 % | **+103.2 %** | +51.7 pp |
-| NETTO €/1k requests | +€11.37 | **+€22.78** | +€11.41 |
+| NET token delta | +4 120 | **+8 254** | +4 134 |
+| NET `cumulative_pct` | +51.5 % | **+103.2 %** | +51.7 pp |
+| NET €/1k requests | +€11.37 | **+€22.78** | +€11.41 |
 
 The original dashboard under-reported the base-load by ~4 100
 tokens/request. Panel B's behaviour numbers are unaffected (they
@@ -309,7 +309,7 @@ measure agent behaviour, not token footprint).
 - Phase 5 — tier-1 dead-rule audit closed with zero cuts: of 20 never-matched rules, 19 are bench-blind / measurement-window / cluster-head (load-bearing despite zero corpus hits); the lone demote candidate (`symfony-routing`) is kept to preserve cross-stack portability.
 - Phase 6 — full live Track B re-run skipped: Phase 1-5 made no rule-body or frontmatter edits, so by construction Panel B is unchanged from the 2026-05-28 baseline (`with` 84.6 % completion, `without` 7.7 % completion). Re-running would consume tokens to re-confirm a known value.
 
-**Pass outcome:** NETTO moved from +4 120 (mis-measured) to **+8 254 tokens / request** (honest); Panel B held by construction. The pass's value is the corrected measurement floor + the new telemetry tooling, not any in-place rule cuts. Cuts must wait until the bench corpus is widened to exercise the rules' real trigger surfaces (git, onboarding, roadmap work, long-conversation windows, autonomy moments).
+**Pass outcome:** NET moved from +4 120 (mis-measured) to **+8 254 tokens / request** (honest); Panel B held by construction. The pass's value is the corrected measurement floor + the new telemetry tooling, not any in-place rule cuts. Cuts must wait until the bench corpus is widened to exercise the rules' real trigger surfaces (git, onboarding, roadmap work, long-conversation windows, autonomy moments).
 
 **Optimisation pass 2 close-out (2026-05-29, `road-to-corpus-expansion-evidence-based-cuts`):**
 
@@ -320,7 +320,7 @@ measure agent behaviour, not token footprint).
 - Phase 5 — zero cuts (0 demotes, 0 deletes). Same outcome as pass-1, but for a fundamentally different reason: pass-1 closed with zero cuts because the corpus was blind; pass-2 closes with zero cuts because the widened corpus **proved every tier-1 rule has structural reason to exist**.
 - Phase 6 — full live Track B re-run skipped: Phase 1-5 made zero rule-body / frontmatter / kernel edits — Panel B is unchanged from the 2026-05-28 baseline by construction.
 
-**Pass outcome:** NETTO unchanged at **+8 254 tokens / request** (+103.2 % vs. baseline, +€22.78 per 1 000 requests). The pass's actual deliverable is the **structural categorisation** of the 20 previously-never-matched rules — future audits no longer need to re-debate why these rules don't fire in standard corpora. 5 state-bound + 5 intent-only are permanently classified as router-replay-unreachable. The Pass B (kernel-body refactor) deferral remains intact — no candidate qualifies under the tightened thresholds.
+**Pass outcome:** NET unchanged at **+8 254 tokens / request** (+103.2 % vs. baseline, +€22.78 per 1 000 requests). The pass's actual deliverable is the **structural categorisation** of the 20 previously-never-matched rules — future audits no longer need to re-debate why these rules don't fire in standard corpora. 5 state-bound + 5 intent-only are permanently classified as router-replay-unreachable. The Pass B (kernel-body refactor) deferral remains intact — no candidate qualifies under the tightened thresholds.
 
 **Pass B status: deferred / closed for now.** Zero genuine candidates surfaced; the 4 raw-pareto flags are all false-positives. Reopen only when a tier-1 rule both activates frequently in the widened corpus AND has a body that exceeds the kernel-budget ceiling — current state has neither.
 
@@ -370,7 +370,7 @@ deliberately rewriting this section.
 
 ## See also
 
-- [`agents/roadmaps/road-to-readable-value-dashboard.md`](../../agents/roadmaps/road-to-readable-value-dashboard.md) — the roadmap that built this surface.
+- the `road-to-readable-value-dashboard` roadmap (archived) — built this surface.
 - [`value-report-schema.md`](value-report-schema.md) — per-report JSON shape (sibling contract).
 - [`benchmark-ab-contract.md`](benchmark-ab-contract.md) — A/B variant-axis contract (data source for the rtk, behaviour, completion rungs).
 - [`benchmark-report-schema.md`](benchmark-report-schema.md) — per-report JSON shape for A/B reports.

package/docs/contracts/value-report-schema.md

@@ -6,8 +6,8 @@ keep-beta-until: 2026-08-28
 # Value Report Schema (`value-v1`)
 
 Parser-visible contract for the JSON report emitted by
-[`scripts/_lib/value_report.py`](../../scripts/_lib/value_report.py)
-and consumed by [`scripts/render_value_md.py`](../../scripts/render_value_md.py).
+[`scripts/_lib/value_report.py`](../../src/scripts/_lib/value_report.py)
+and consumed by [`scripts/render_value_md.py`](../../src/scripts/render_value_md.py).
 Sibling of [`benchmark-report-schema.md`](benchmark-report-schema.md);
 companion to [`value-dashboard-spec.md`](value-dashboard-spec.md) which
 owns the semantics this contract types.
@@ -102,7 +102,7 @@ notes:
 - **No saving label on negative.** A rung with `token_delta > 0` is a
   *cost* rung; a rung with `token_delta < 0` is a *saving* rung;
   zero is *neutral*. The linter
-  ([`scripts/lint_value_dashboard.py`](../../scripts/lint_value_dashboard.py))
+  ([`scripts/lint_value_dashboard.py`](../../src/scripts/lint_value_dashboard.py))
   rejects any rendered "saving" label on a positive `token_delta`.
 - **No `measured` without a real source.** A rung that carries
   `confidence: measured` MUST have a `source_report` that exists on
@@ -160,9 +160,9 @@ The optional `.md` dump carries:
 ## Cross-references
 
 - Semantics — [`value-dashboard-spec.md`](value-dashboard-spec.md)
-- Roadmap — [`agents/roadmaps/road-to-readable-value-dashboard.md`](../../agents/roadmaps/road-to-readable-value-dashboard.md)
+- Roadmap — the `road-to-readable-value-dashboard` roadmap (archived)
 - Pricing source — [`internal/bench/pricing.yaml`](../../internal/bench/pricing.yaml)
-- Rung normaliser — [`scripts/_lib/value_ladder.py`](../../scripts/_lib/value_ladder.py)
-- Report assembler — [`scripts/_lib/value_report.py`](../../scripts/_lib/value_report.py)
-- Renderer — [`scripts/render_value_md.py`](../../scripts/render_value_md.py)
-- Linter — [`scripts/lint_value_dashboard.py`](../../scripts/lint_value_dashboard.py)
+- Rung normaliser — [`scripts/_lib/value_ladder.py`](../../src/scripts/_lib/value_ladder.py)
+- Report assembler — [`scripts/_lib/value_report.py`](../../src/scripts/_lib/value_report.py)
+- Renderer — [`scripts/render_value_md.py`](../../src/scripts/render_value_md.py)
+- Linter — [`scripts/lint_value_dashboard.py`](../../src/scripts/lint_value_dashboard.py)

package/docs/customization.md

@@ -100,7 +100,7 @@ duplicating the root file.
 
 The user-global file is created **only on explicit opt-in via the
 setup wizard** (`agent-config setup`). The loader at
-[`scripts/_lib/agent_settings.py`](../scripts/_lib/agent_settings.py)
+[`scripts/_lib/agent_settings.py`](../src/scripts/_lib/agent_settings.py)
 is **read-only** — no script can create or mutate it without explicit
 wizard confirmation. Edit the file by hand for mid-life changes;
 `/sync-agent-settings` stays project-scoped and never touches
@@ -247,7 +247,7 @@ The authoritative matrix of all matrix-controlled settings lives in
 ### Chat-history defaults per profile
 
 `scripts/install.py` fills these placeholders from
-[`config/profiles/*.ini`](../config/profiles) when it writes
+[`src/config/profiles/*.ini`](../config/profiles) when it writes
 `.agent-settings.yml`. Edit the values afterwards if you want different
 behavior — the per-profile table is just the initial default.
 
@@ -373,7 +373,7 @@ fallback). Files under `~/.event4u/agent-config/agents/settings/contexts/` or
 project-shaped and must not leak across projects.
 
 The resolver lives at
-[`scripts/_lib/agents_overlay.py`](../scripts/_lib/agents_overlay.py)
+[`scripts/_lib/agents_overlay.py`](../src/scripts/_lib/agents_overlay.py)
 and is enforced by `scripts/check_overlay_cascade_subdirs.py` — drift
 between the code constants (`CASCADE_ELIGIBLE_KINDS`,
 `USER_GLOBAL_OVERLAY_KINDS`) and the table above breaks the build.
@@ -387,9 +387,9 @@ discovery keys in its frontmatter — `workspaces:`, `packs:`,
 `lifecycle:`, `trust:`, `install:`. The contract is defined in
 [ADR-013](decisions/ADR-013-discovery-frontmatter-contract.md) and the
 closed vocabularies live in
-[`config/discovery/workspaces.yml`](../config/discovery/workspaces.yml)
+[`src/config/discovery/workspaces.yml`](../config/discovery/workspaces.yml)
 (9 workspaces) and
-[`config/discovery/packs.yml`](../config/discovery/packs.yml) (21
+[`src/config/discovery/packs.yml`](../config/discovery/packs.yml) (21
 packs).
 
 At release time, `scripts/build_discovery_manifest.py` walks the source
@@ -442,7 +442,7 @@ the matching packs' commands/skills are the surfaced set:
 - `/profile deactivate` — full surface returns.
 
 The activatable name is a session-profile alias
-(`config/discovery/session-profiles.yml`: `developer`, `po`, `finance`,
+(`src/config/discovery/session-profiles.yml`: `developer`, `po`, `finance`,
 `gtm`, `content`) or a raw pack id. It is **recommendation-bias only** —
 an inactive-pack command still runs (with a one-line notice); execution is
 never blocked. The choice is **ephemeral**: it writes
@@ -495,8 +495,8 @@ Each project decides; the user-global file cannot flip it on or off
 for unrelated projects.
 
 The decision logic lives at
-[`scripts/_lib/update_check.py`](../scripts/_lib/update_check.py); the
-dispatcher integration lives in [`scripts/agent-config`](../scripts/agent-config)
+[`scripts/_lib/update_check.py`](../src/scripts/_lib/update_check.py); the
+dispatcher integration lives in [`scripts/agent-config`](../src/scripts/agent-config)
 (`run_update_check_banner`).
 
 ---

package/docs/decisions/ADR-006-skill-tools-python-pilot.md

@@ -108,7 +108,7 @@ dir, and the `lint-skill-tools` task entry. Mark this ADR
 - Roadmap: [`road-to-better-skills-and-profiles`](../../agents/roadmaps/archive/road-to-better-skills-and-profiles.md) Block D.
 - Council: [`block-d-python-tools-pilot-verdict`](../../agents/runtime/council/responses/block-d-python-tools-pilot-verdict.md). <!-- council-ref-allowed: ADR decision trace -->
 
-- Tools: [`scripts/skill_tools/`](../../scripts/skill_tools/).
-- Linter: [`scripts/lint_skill_tools.py`](../../scripts/lint_skill_tools.py).
+- Tools: [`scripts/skill_tools/`](../../src/scripts/skill_tools/).
+- Linter: [`scripts/lint_skill_tools.py`](../../src/scripts/lint_skill_tools.py).
 - Corpora + report: [`agents/evidence/eval-corpora/block-d/`](../../agents/evidence/eval-corpora/block-d/).
 - Tests: `tests/test_lint_skill_tools.py`, `tests/test_score_skill_relevance.py`, `tests/test_audit_persona_coverage.py`, `tests/test_suggest_skill_for_task.py`.

package/docs/decisions/ADR-007-agent-discovery-scopes.md

@@ -28,7 +28,7 @@ phase: post-v2.1.0 · simplicity-and-everywhere
 
 **Accepted** · 2026-05-12 · signed off by Matze after Council Round 3 convergence. Implementation tracked in `agents/roadmaps/road-to-global-first-install.md`.
 
-Originates from user ask: "Es macht keinen Sinn, das paket nicht
+Originates from user ask: "Es macht keinen Sinn, das paket nicht  <!-- md-language-check: ignore -->
 global zu installieren." Validated through AI Council (2 + 1 rounds,
 2026-05-12 · members claude-sonnet-4-5 + gpt-4o). Council session:
 [`agents/runtime/council/sessions/2026-05-12-global-first-strategy/`](../../agents/runtime/council/sessions/2026-05-12-global-first-strategy/). <!-- council-ref-allowed: ADR decision trace -->

package/docs/decisions/ADR-008-installed-tools-manifest.md

@@ -17,7 +17,7 @@ phase: v2.x · post-global-first-install
 
 Originates from user ask (Matze, 2026-05-12): "Sollten wir auf
 Projektebene festhalten, welche Agents wir initialisiert haben, damit
-bei jedem Sync das Verzeichnis aktualisiert werden kann?" Validated
+bei jedem Sync das Verzeichnis aktualisiert werden kann?" Validated  <!-- md-language-check: ignore -->
 through AI Council Round 1 (claude-sonnet-4-5 + gpt-4o, $0.0298 actual,
 both converged on "yes, separate file"). Council session:
 [`agents/runtime/council/sessions/2026-05-12-project-settings-and-v1-v2/`](../../agents/runtime/council/sessions/2026-05-12-project-settings-and-v1-v2/). <!-- council-ref-allowed: ADR decision trace -->

package/docs/decisions/ADR-009-event4u-namespace.md

@@ -13,7 +13,7 @@ phase: v2.4 · namespace-and-claude-desktop
 ## Status
 
 **Accepted** · 2026-05-13 · signed off by Matze after the user ask
-*"auf globaler ebene sollen unsere dateien in einem
+*"auf globaler ebene sollen unsere dateien in einem  <!-- md-language-check: ignore -->
 .event4u/agent-config Folder im user ordner landen"* combined with the
 Claude Desktop deployment gap surfaced in the same turn (the v1
 `marker-only` integration did not actually make any skill visible to
@@ -180,8 +180,8 @@ zero-data-loss** by design:
 ## References
 
 - [`agents/roadmaps/road-to-event4u-namespace-and-claude-desktop.md`](../../agents/roadmaps/road-to-event4u-namespace-and-claude-desktop.md)
-- [`scripts/_lib/user_global_paths.py`](../../scripts/_lib/user_global_paths.py)
-- [`scripts/_lib/claude_desktop_bundler.py`](../../scripts/_lib/claude_desktop_bundler.py)
+- [`scripts/_lib/user_global_paths.py`](../../src/scripts/_lib/user_global_paths.py)
+- [`scripts/_lib/claude_desktop_bundler.py`](../../src/scripts/_lib/claude_desktop_bundler.py)
 - [`docs/setup/per-ide/claude-desktop.md`](../setup/per-ide/claude-desktop.md)
 - [`docs/migration/v1-to-v2.md`](../migration/v1-to-v2.md) § v2 → v2.4
 - ADR-007 (predecessor — global-first install scopes)

package/docs/decisions/ADR-013-discovery-frontmatter-contract.md

@@ -123,9 +123,11 @@ Amendments to the workspace list require an ADR-013 amendment.
 | `ai-video` | AI video pipeline (per ADR-011, the only heavyweight domain). |
 | `fun` | Non-essential social/fun workflows (prediction-pool tips, etc.). Optional under the `small-business` workspace; `experimental` trust. |
 | `meta` | Artefacts that maintain *this* package (`agent-config` itself). |
+| `git` | Git workflow — commit, pull requests, branch sync. Carries `slug_prefix: git` (ADR-044 §A3); `requires: engineering-base`. Added 2026-06-04 for 6.0.0-D Step 12 Class B1 (`commit`→`git-commit`, `create-pr`→`git-pr-create`). |
+| `frontend-design` | Grounded design intelligence — design-knowledge corpus + BM25 grounding engine, design tokens, stack best-practice and chart/typography knowledge. `requires: engineering-base`; `suggests: react, nextjs`. Added 2026-06-07 (ADR-061). |
 
 Amendments to the pack list require an ADR-013 amendment and the
-matching `config/discovery/packs.yml` row in the same PR.
+matching `src/config/discovery/packs.yml` row in the same PR.
 
 ### Non-overlap rule (ADR-010 alignment)
 
@@ -144,7 +146,7 @@ matching `config/discovery/packs.yml` row in the same PR.
   does not fail.
 - **Phase 4**: every artefact under
   `.agent-src.uncondensed/{skills,rules,commands,templates}` either
-  declares the new keys, or sits in `config/discovery/unassigned-artefacts.yml`
+  declares the new keys, or sits in `src/config/discovery/unassigned-artefacts.yml`
   with a one-line reason.
 - **Phase 4+**: CI flips strict; missing annotation is a fail.
 
@@ -203,7 +205,7 @@ discovery-driven action.
 The five required keys (`workspaces`, `packs`, `lifecycle`, `trust`,
 `install`) are now **strictly enforced** across every artefact under
 `.agent-src.uncondensed/{skills,rules,commands,templates}` by
-[`scripts/lint_artefact_frontmatter.py`](../../scripts/lint_artefact_frontmatter.py),
+[`scripts/lint_artefact_frontmatter.py`](../../src/scripts/lint_artefact_frontmatter.py),
 wired into `task lint-artefact-frontmatter`, `task ci`, and the opt-in
 combined pre-commit hook (`./agent-config hooks:install`). The migration
 rule's "Phase 4+" strict flip described above is therefore in effect.
@@ -222,21 +224,21 @@ Driven by [`agents/roadmaps/monorepo-phase-1-frontmatter-metadata.md`](../../age
 
 ### 2026-05-27 — Additive advisory `cluster:` key on packs
 
-Pack entries in [`config/discovery/packs.yml`](../../config/discovery/packs.yml)
+Pack entries in [`src/config/discovery/packs.yml`](../../config/discovery/packs.yml)
 may carry an optional `cluster: <language-id>` field. It groups a framework
 pack under a programming-language tile in the setup wizard's capability-packs
 step (e.g. `laravel: cluster: php`, `react: cluster: typescript`). Like
 `requires_hint`, it is **advisory only** — the installer does not act on it; it
 drives the wizard UI's collapsible language→framework grouping. The value must
 be a known pack id (and not self-referential), enforced by
-[`scripts/lint_discovery_vocabulary.py`](../../scripts/lint_discovery_vocabulary.py)
+[`scripts/lint_discovery_vocabulary.py`](../../src/scripts/lint_discovery_vocabulary.py)
 and emitted into the discovery manifest. Additive, no vocabulary rename.
 
 Driven by [`agents/roadmaps/road-to-wizard-ux-improvements.md`](../../agents/roadmaps/road-to-wizard-ux-improvements.md) § Phase 4 (AI-council-resolved: reuse `packs.yml` as the single source of truth rather than a second mapping file).
 
 ### 2026-05-27 — Additive advisory `example_roles:` key on workspaces
 
-Workspace entries in [`config/discovery/workspaces.yml`](../../config/discovery/workspaces.yml)
+Workspace entries in [`src/config/discovery/workspaces.yml`](../../config/discovery/workspaces.yml)
 may carry an optional `example_roles: [<title>, …]` list of illustrative job
 titles (e.g. `engineering: [Developer, CTO]`, `finance: [CFO]`). The wizard's
 roles step shows the workspace as the *area* and these titles as examples under
@@ -251,15 +253,32 @@ Additive, no vocabulary rename. (Same change cleaned the `finance` label from
 
 Added pack id `fun` to the closed vocabulary (Non-essential social/fun
 workflows — prediction-pool tip optimization, etc.). Mirrored in
-[`config/discovery/packs.yml`](../../config/discovery/packs.yml) and the
+[`src/config/discovery/packs.yml`](../../config/discovery/packs.yml) and the
 `ADR_PACKS` frozenset in
-[`scripts/lint_discovery_vocabulary.py`](../../scripts/lint_discovery_vocabulary.py).
+[`scripts/lint_discovery_vocabulary.py`](../../src/scripts/lint_discovery_vocabulary.py).
 Optional under the `small-business` workspace (alongside `ai-video`);
 `trust_level_default: experimental`, `install.default: false`. First
 artefacts: the `/prediction-pool` command + `prediction-pool-optimizer` skill in
 `packages/pack-fun/`. Additive, no rename; non-overlap with cost-profile
 and `profile.id` reservations holds.
 
+### 2026-06-07 — New `frontend-design` pack
+
+Added pack id `frontend-design` to the closed vocabulary (grounded design
+intelligence — design-knowledge corpus + BM25 grounding engine, design tokens,
+stack best-practice and chart/typography knowledge, adopted from the MIT
+`nextlevelbuilder/ui-ux-pro-max-skill` corpus per ADR-061). Mirrored in
+[`src/config/discovery/packs.yml`](../../src/config/discovery/packs.yml) and the
+`ADR_PACKS` frozenset in
+[`scripts/lint_discovery_vocabulary.py`](../../src/scripts/lint_discovery_vocabulary.py).
+`workspaces: [engineering]`, `requires: [engineering-base]`,
+`suggests: [react, nextjs]` (the corpus is stack-agnostic data — React is
+suggested, never required), `trust_level_default: professional`,
+`size_class: medium`. Council-resolved 2026-06-07 (anthropic/claude-sonnet-4-5 +
+openai/gpt-4o, converged A2: opt-in pack over inflating `engineering-base`
+with ~1 MB of design data). Additive, no rename; non-overlap with
+cost-profile and `profile.id` reservations holds.
+
 ## Cross-references
 
 - [ADR-007 — Agent Discovery Scopes](ADR-007-agent-discovery-scopes.md):

package/docs/decisions/ADR-015-discovery-manifest-contract.md

@@ -27,10 +27,10 @@ TypeScript installer (Phase 3), the browser wizard (Phase 6), the docs
 site, and any third-party consumer read instead of walking the source
 tree. The invariant from the founder intake:
 
-> Beim Erstellen eines Releases müssen alle Skills, etc. nach Workspace
-> und Pack untersucht werden, so dass das für den Installer gespeichert
-> wird und zur Verfügung steht. Es soll keine manuelle Package &
-> Workspace Liste gepflegt werden.
+> Beim Erstellen eines Releases müssen alle Skills, etc. nach Workspace  <!-- md-language-check: ignore -->
+> und Pack untersucht werden, so dass das für den Installer gespeichert  <!-- md-language-check: ignore -->
+> wird und zur Verfügung steht. Es soll keine manuelle Package &  <!-- md-language-check: ignore -->
+> Workspace Liste gepflegt werden.  <!-- md-language-check: ignore -->
 
 **No manual list. Ever.** The pack and workspace shape grows by stamping
 frontmatter, not by editing a list.
@@ -68,7 +68,7 @@ install-axis without a current consumer. Re-evaluate in Phase 5.
 
 The generator walks `.agent-src.uncondensed/`, **not** `.agent-src/`.
 The Phase-2 roadmap text §Phase 2 says "the condensed canonical tree"
-— that is a documentation slip. `augment-source-of-truth` rule states
+— that is a documentation slip. `source-of-truth` rule states
 that uncondensed is canonical; the condensed tree is a build output
 and may be regenerated. Manifest pipelines that read build outputs are
 fragile to bootstrap order.

package/docs/decisions/ADR-017-monorepo-physical-layout.md

@@ -25,8 +25,8 @@ Companion artefacts:
 - [`agents/roadmaps/monorepo-phase-4-physical-package-layout.md`](../../agents/roadmaps/monorepo-phase-4-physical-package-layout.md)
 - [`dist/migration/move-plan.json`](../../dist/migration/move-plan.json) (94 moves, 432 core, 0 conflicts)
 - [`dist/migration/pre-move-snapshot.json`](../../dist/migration/pre-move-snapshot.json) (744 files hashed)
-- [`scripts/plan_physical_move.py`](../../scripts/plan_physical_move.py) (plan + apply)
-- [`scripts/verify_physical_move.py`](../../scripts/verify_physical_move.py) (post-move diff vs. snapshot)
+- [`scripts/plan_physical_move.py`](../../src/scripts/plan_physical_move.py) (plan + apply)
+- [`scripts/verify_physical_move.py`](../../src/scripts/verify_physical_move.py) (post-move diff vs. snapshot)
 
 ## Context
 
@@ -77,7 +77,7 @@ and ships. The TS installer needs zero behavioural changes — only the
 
 ### 2. Mapping rules (deterministic, lockfile-stable)
 
-Implemented in [`scripts/plan_physical_move.py`](../../scripts/plan_physical_move.py):
+Implemented in [`scripts/plan_physical_move.py`](../../src/scripts/plan_physical_move.py):
 
 1. **Kernel rules** → `packages/core/` (allowlist, sanity-checked against
    [`docs/contracts/kernel-membership.md`](../contracts/kernel-membership.md) §4).
@@ -96,7 +96,7 @@ Implemented in [`scripts/plan_physical_move.py`](../../scripts/plan_physical_mov
 5. **Pack-routable artefacts** → `packages/pack-<id>/`, where `<id>` is
    the first entry in `packs[]`. Tie-breaking by alphabetic pack id.
 6. **Quarantined scaffolds** (the 26 entries in
-   [`config/discovery/unassigned-artefacts.yml`](../../config/discovery/unassigned-artefacts.yml))
+   [`src/config/discovery/unassigned-artefacts.yml`](../../config/discovery/unassigned-artefacts.yml))
    → `packages/core/` with `unassigned scaffold:` reason recorded in the
    move plan. The top-level `.agent-src.uncondensed/README.md` was added
    here during dry-run.
@@ -116,7 +116,7 @@ point; it refuses if any conflict remains. No human-edited paths.
 `task sync` + `task build-discovery` after the move must produce
 `.agent-src/`, `.augment/`, and `dist/discovery/discovery-manifest.json`
 byte-identical to the pre-move snapshot **except** for
-`artefacts[].path` values. [`scripts/verify_physical_move.py`](../../scripts/verify_physical_move.py)
+`artefacts[].path` values. [`scripts/verify_physical_move.py`](../../src/scripts/verify_physical_move.py)
 captures a post-move snapshot and diffs against
 `dist/migration/pre-move-snapshot.json`; the only allowed delta is the
 `path` field per artefact.

package/docs/decisions/ADR-018-trust-and-safety-layer.md

@@ -24,8 +24,8 @@ Session: [`agents/runtime/council/responses/phase-5-trust-safety.json`](../../ag
 Companion artefacts:
 - Contract: [`docs/contracts/trust-and-safety.md`](../contracts/trust-and-safety.md)
 - Roadmap: [`agents/roadmaps/monorepo-phase-5-trust-safety-layer.md`](../../agents/roadmaps/monorepo-phase-5-trust-safety-layer.md)
-- Lint: [`scripts/lint_trust_coherence.py`](../../scripts/lint_trust_coherence.py) + [`tests/test_lint_trust_coherence.py`](../../tests/test_lint_trust_coherence.py)
-- Condenseor: [`scripts/condense.py`](../../scripts/condense.py) (`_inject_hrr_banner`)
+- Lint: [`scripts/lint_trust_coherence.py`](../../src/scripts/lint_trust_coherence.py) + [`tests/test_lint_trust_coherence.py`](../../tests/test_lint_trust_coherence.py)
+- Condenseor: [`scripts/condense.py`](../../src/scripts/condense.py) (`_inject_hrr_banner`)
 - Installer: [`packages/core/installer/src/trust-escalation.ts`](../../packages/core/installer/src/trust-escalation.ts)
 
 ## Context

package/docs/decisions/ADR-019-router-json-dist-location.md

@@ -20,7 +20,7 @@ ADR-015.
 
 Companion artefacts:
 - Contract: [`docs/contracts/rule-router.md`](../contracts/rule-router.md)
-- Compiler: [`scripts/compile_router.py`](../../scripts/compile_router.py)
+- Compiler: [`scripts/compile_router.py`](../../src/scripts/compile_router.py)
 - ADR-rule-kernel-and-router: [`ADR-rule-kernel-and-router.md`](ADR-rule-kernel-and-router.md)
 - Tier ADR: [`docs/adrs/router/0001-three-tier-routing.md`](../adrs/router/0001-three-tier-routing.md)
 
@@ -119,6 +119,6 @@ external uptake**.
 - [`docs/contracts/rule-router.md`](../contracts/rule-router.md) — frontmatter + read-path contract.
 - [`docs/contracts/kernel-membership.md`](../contracts/kernel-membership.md) — kernel cap.
 - [`dist/router.json`](../../dist/router.json) — compiled output.
-- [`scripts/compile_router.py`](../../scripts/compile_router.py) — compiler.
+- [`scripts/compile_router.py`](../../src/scripts/compile_router.py) — compiler.
 - [`ADR-015-discovery-manifest-contract.md`](ADR-015-discovery-manifest-contract.md) — precedent for `dist/` allowlist.
 - [`ADR-rule-kernel-and-router.md`](ADR-rule-kernel-and-router.md) — original kernel-and-router decision.