@event4u/agent-config 14.10.0 → 14.11.0

package/dist/agent-src/skills/existing-ui-audit/SKILL.md

@@ -88,7 +88,7 @@ Detect markers, in order. **Stop at the first match** — projects rarely run mo
 | Marker | Signal | Where |
 |---|---|---|
 | Flux | `livewire/flux` in `composer.json`, `<flux:*>` tags in views | `composer.json`, grep `resources/views` |
-| shadcn/ui | `components.json` exists at repo root | `components.json` |
+| shadcn/ui | `components.json` exists at the **workspace** root — the package that owns it; in a monorepo this is never the repository root | `components.json` |
 | Headless UI | `@headlessui/react` or `@headlessui/vue` in `package.json` | `package.json` |
 | Radix | `@radix-ui/*` in `package.json` (without shadcn marker) | `package.json` |
 | Material/Chakra/Mantine/Ant | their package names in `package.json` | `package.json` |
@@ -125,7 +125,7 @@ read, so easing and duration stop being values the brief silently regenerates.
 
 ### 4. Detect shadcn inventory (only when `state.stack.frontend == "react-shadcn"`)
 
-Read `components.json` for the registered style + base color, then read `package.json` for `@radix-ui/*` and any locally vendored `components/ui/*.tsx` files. Write into `state.ui_audit.shadcn_inventory`:
+Read `components.json` for the registered style + base color, then read the `package.json` **of the scope root** — `state.stack.scope_root`, relative to the project root, empty when the project root *is* the scope — for `@radix-ui/*` or the unified `radix-ui` package, plus any locally vendored `components/ui/*.tsx` files. In a monorepo the repository root carries neither the marker nor the dependency, so reading it finds nothing. Write into `state.ui_audit.shadcn_inventory`:
 
 ```
 {
@@ -137,6 +137,23 @@ Read `components.json` for the registered style + base color, then read `package
 }
 ```
 
+### 4b. Prefer a live Storybook read over the hand-read inventory — when one is running
+
+When the project carries `@storybook/addon-mcp` **and** a Storybook is running, query it
+instead of reading files: `list-all-documentation` for the inventory, then `get-documentation`
+for the components that matter. **The live read wins; the hand-read inventory of step 4 is the
+fallback and is never removed** — an agent that cannot reach a running Storybook must still be
+able to inventory the library. The channel disappearing is normal, not an error.
+
+**React-only while the toolset is in preview.** Storybook's own MCP FAQ (docs **10.5**,
+`docs/ai/mcp/overview` § FAQ) states the documentation toolset supports React only during
+preview, so Vue, Angular, and Web Components take the file-read path. Stated here rather than
+discovered at runtime, because the failure otherwise looks like a broken MCP server.
+
+Discipline for what the live read returns is [`storybook-workshop`](../storybook-workshop/SKILL.md)'s
+— in particular: never use a prop the manifest does not document, and fetch the project's
+story instructions before writing a story.
+
 ### 5. List reusable patterns
 
 Categorize what already exists. Empty arrays are valid, never omit the keys.
@@ -264,7 +281,7 @@ tool produces, so the import path is uniform.
 
 - The model tends to skip the audit and start designing straight from the request — the dispatcher gate at `directives/ui/audit.ts` enforces "no design without audit findings". Never treat this skill as optional for non-trivial UI.
 - The model tends to misidentify a single Tailwind utility as a "design token" — tokens come from the config or `:root`, not from class strings in templates.
-- Don't assume a Radix-only `package.json` means shadcn — shadcn requires `components.json` at repo root.
+- Don't assume a Radix-only `package.json` means shadcn — shadcn requires `components.json` at the workspace root that owns the components. Each workspace carries its own; the repository root carries none, which is the layout the shadcn CLI scaffolds.
 - `state.ui_audit.shadcn_inventory.version` is often missing; the shadcn CLI does not always pin itself in `package.json`. Record `null` rather than guessing.
 - Greenfield is detected, not assumed — a project with one Blade layout and no components is still greenfield only if tokens AND design system markers AND components are all empty.
 - **There is no mtime cache.** An earlier revision told you to cache by

package/dist/agent-src/skills/fe-design/SKILL.md

@@ -22,6 +22,16 @@ dispatching this?**
 |---|---|---|
 | A ticketed run — the UI directive set is dispatching | `directives/ui/*` | a reference it cites |
 | Anything else — "build me the page", "improve this form", "implement the approved design" | **you, in this turn** | the executor |
+| A renderer axis is in play — WebGL / Three.js / canvas / scroll-scrubbed video | **still you** — the renderer is a grounding question, not a second executor | the executor, grounded via `search_stack` |
+
+The third row is an **axis**, not an owner. Renderer selection resolves through
+machinery that already exists: `search_stack` in
+[`corpus-grounding`](../corpus-grounding/SKILL.md)
+(`scripts/decision_engine.ts`), whose stack corpus carries `threejs.csv` among
+its stacks, read beside the register in
+[`design-intelligence`](../design-intelligence/references/context-and-registers.md)
+§ Register. No second frontend executor is declared, and none is needed: a
+renderer changes what you ground against, never who writes the UI.
 
 Outside the engine, nothing else owns the design quality of a UI write. Reading
 this skill and then writing the UI from priors is the failure it exists to
@@ -65,42 +75,36 @@ else runs the loop.
    artifact's own markup/CSS/JS is stack-compatible, adapt **that code**;
    re-deriving it from scratch is a deviation needing confirmation
    (`design-fidelity-mechanics` § Adopt the code).
-5. **Review** — run [`design-review`](../design-review/SKILL.md) before calling
-   it done, and scope the verdict honestly: render-scoped when you can render
-   it, otherwise explicitly static-scoped, naming which checks actually ran.
-   "Looks good" with neither scope named is a verdict without evidence.
-
-### The heuristics — here, not one hop away
-
-The load-bearing subset, inline so that "loaded" means the content is in
-context. Depth stays in [`references/design-patterns.md`](references/design-patterns.md).
-
-1. **Audit outranks heuristic.** A token, primitive or convention the audit
-   found wins over anything on this list; say `[audit override]` when it does.
-2. **Reuse tokens, never raw values.** A hex, font or px literal where the
-   audit found a token is off-brand by construction.
-3. **All five states are designed.** `empty` is a helpful message, not a blank
-   region; `loading` prefers a skeleton over a spinner (it shows structure, so
-   it reads as faster); `error` says what to do next.
-4. **Labels are always visible.** No placeholder-only inputs.
-5. **Validate on blur and on submit**, never on every keystroke; the message
-   goes below the field and is specific.
-6. **Mobile-first, and 320 px actually works.** Default styles are the small
-   viewport; complexity is added at larger breakpoints, never removed at
-   smaller ones.
-7. **A11y minimums are non-negotiable:** 4.5:1 contrast for text (3:1 large),
-   every interactive element reachable by Tab, a visible focus ring, semantic
-   elements over `div`, and an `aria-label` wherever there is no visible text.
-8. **Every action gets feedback.** Users read silence as failure.
-9. **Prefer undo over a confirmation dialog** — confirmations get clicked
-   through; an undo affordance actually protects the user.
-10. **Tables:** numbers right-aligned, text left-aligned, a designed empty
-    state, and a sticky header on anything long enough to scroll.
-11. **No placeholder microcopy ships.** Lorem ipsum, `TODO`, and
-    `[Your text here]` are unfinished output, not drafts.
-
-Before proposing a direction, run the anti-slop scan named under
-[Anti-slop discipline](#anti-slop-discipline) below.
+5. **Review, then re-enter** — run [`design-review`](../design-review/SKILL.md)
+   before calling it done, and scope the verdict honestly: render-scoped when
+   you can render it, otherwise explicitly static-scoped, naming which checks
+   actually ran. "Looks good" with neither scope named is a verdict without
+   evidence. Findings → fix them and **re-enter step 5**, at most **2 rounds**,
+   and **stop early on a null**: a round that produces **no new finding** ends
+   the loop, and a round that produces only findings the provided artifact
+   already covers produces no new finding. At the 2-round ceiling with findings
+   still open, stop and hand the remaining list back — ship-as-is or abort is
+   the user's call, never another silent pass. Judgement alone never buys a
+   third round.
+
+   The ceiling is **2**, the same number the engine enforces
+   (`directives/ui/polish.ts`, `POLISH_CEILING`), so the ad-hoc path and the
+   ticketed path bound the loop identically rather than by two conventions that
+   can drift. Fixtures: `daf-adhoc-converges` (round 2 is a null, loop ends) and
+   `daf-adhoc-ceiling` (findings remain at the ceiling, loop hands back).
+
+### The floors — pulled immediately before the write
+
+```
+PULL references/craft-floor.md IMMEDIATELY BEFORE THE WRITE, NOT AT SKILL LOAD.
+```
+
+Twelve universal floors that do not vary by mode, register, intent or stack.
+They were inline here until the delivery point moved: a floor read at skill-load
+time can be a compaction away from the write it governs (`ADR-227`).
+
+One precedence rule stays here because it is authority, not craft: **the audit
+outranks every heuristic.** Say `[audit override]` when it does.
 
 ## Positioning — reference inside the engine, executor outside it
 
@@ -212,13 +216,42 @@ When this skill's content is folded into a design brief or review:
 - Heuristics in this reference apply across stacks; do not promote them to project rules without checking the audit.
 - Mobile-first is not optional — every layout must work on 320px width.
 
+## Read the authority object — never re-infer it
+
+Read the resolved `ui_authority`
+([contract](../../../docs/contracts/ui-authority.md)) before the loop:
+`surface_mode`, `register`, `change_intent`, `reference_maturity`,
+`constraints`. This skill is a **declared consumer** — a second decision table
+beside the object is a drift surface, so do not re-derive any field.
+
+`surface_mode` sets density, hierarchy and expressiveness only, per
+[`design-modes`](../../../docs/guidelines/design-modes.md) § The second axis.
+
+```
+QUALITY FLOORS DO NOT VARY BY SURFACE MODE.
+A FLOOR THAT MOVES WITH THE MODE IS A PREFERENCE WEARING A FLOOR'S NAME.
+```
+
+### The source-led path
+
+`reference_maturity: runnable-artifact` → the artifact's own markup, CSS and JS
+is the data basis; adapting it is the **default** and a from-scratch
+re-derivation is a deviation. Sort every mechanic into `honoured` / `translated`
+/ `flagged`; one present, absent and unflagged is a **silent drop**, target zero.
+Procedure and the vanishing-mechanic classes:
+[`references/source-led-port.md`](references/source-led-port.md).
+
+Maturity is not decided here — it arrives on the authority object, and per-value
+provenance belongs to `road-to-frontend-fidelity-calibration` Phases 0 and 2.
+
 ## Anti-slop discipline
 
-Before proposing any UI layout, component, or aesthetic direction, pull
-[`docs/guidelines/design-antipatterns.md`](../../../docs/guidelines/design-antipatterns.md)
-and scan the Visual (V1–V7), Layout (L1–L8), and Quality-floors (Q1–Q12) sections.
-If the first-impulse design matches a listed pattern, either choose a different
-approach or explicitly invoke the override condition in the design brief.
+Before proposing a direction, scan the Visual (V1–V7) and Layout (L1–L8)
+sections of [`design-antipatterns`](../../../docs/guidelines/design-antipatterns.md).
+On a match, choose differently or invoke the entry's own override condition in
+the brief — every entry has one, and they are register-scoped. The Q* floors are
+in [`references/craft-floor.md`](references/craft-floor.md) instead of here, so
+they arrive at the write rather than at skill load.
 
 ## Do NOT
 

package/dist/agent-src/skills/fe-design/evals/triggers.json

@@ -1,55 +1,67 @@
 {
-    "skill": "fe-design",
-    "last_eval": "2026-08-12",
-    "description": "Should-trigger covers BOTH halves of this skill's two modes: planning/exploration (give me directions, explore, plan the flow, pattern choice) AND — new — ad-hoc implementation, because outside a ticketed run no other artefact owns the design quality of a UI write. The implementation query used to be labelled should-not-trigger on the reasoning that it belongs to the apply step; that step only exists as a dispatch target inside the engine, so the label routed ad-hoc implementation prompts to nobody. Should-not-trigger keeps the genuine near-misses: inventorying existing UI (existing-ui-audit owns it in both modes), a ui-trivial one-line edit, and non-UI work.",
-    "queries": [
-        {
-            "q": "give me three directions for the pricing page",
-            "trigger": true
-        },
-        {
-            "q": "explore a few visual directions for the dashboard before we commit",
-            "trigger": true
-        },
-        {
-            "q": "design the multi-step onboarding flow",
-            "trigger": true
-        },
-        {
-            "q": "should this filter be a modal or an inline panel?",
-            "trigger": true
-        },
-        {
-            "q": "plan the responsive layout for the settings screen",
-            "trigger": true
-        },
-        {
-            "q": "implement the selected checkout design in React exactly as approved",
-            "trigger": true
-        },
-        {
-            "q": "build the settings page",
-            "trigger": true
-        },
-        {
-            "q": "improve this form, it feels clunky",
-            "trigger": true
-        },
-        {
-            "q": "what form components do we already have in the codebase?",
-            "trigger": false
-        },
-        {
-            "q": "change the primary button colour to green",
-            "trigger": false
-        },
-        {
-            "q": "add a database index on orders.status",
-            "trigger": false
-        },
-        {
-            "q": "fix the failing unit test in the auth module",
-            "trigger": false
-        }
-    ]
+  "skill": "fe-design",
+  "last_eval": "2026-08-12",
+  "description": "Should-trigger covers BOTH halves of this skill's two modes: planning/exploration (give me directions, explore, plan the flow, pattern choice) AND \u2014 new \u2014 ad-hoc implementation, because outside a ticketed run no other artefact owns the design quality of a UI write. The implementation query used to be labelled should-not-trigger on the reasoning that it belongs to the apply step; that step only exists as a dispatch target inside the engine, so the label routed ad-hoc implementation prompts to nobody. Should-not-trigger keeps the genuine near-misses: inventorying existing UI (existing-ui-audit owns it in both modes), a ui-trivial one-line edit, and non-UI work. Scroll-storytelling rows added 2026-08-23: a scroll-driven narrative build is an ad-hoc UI write and routes here, and the renderer axis is a third row in this skill's mode table rather than a second executor. The should-NOT-trigger row is the one that matters \u2014 \"scroll position resets when I navigate back\" is a state/restoration bug and belongs to the frontend-engineer lens, not to design. Without it the word \"scroll\" alone would route every scroll bug to a design skill.",
+  "queries": [
+    {
+      "q": "give me three directions for the pricing page",
+      "trigger": true
+    },
+    {
+      "q": "explore a few visual directions for the dashboard before we commit",
+      "trigger": true
+    },
+    {
+      "q": "design the multi-step onboarding flow",
+      "trigger": true
+    },
+    {
+      "q": "should this filter be a modal or an inline panel?",
+      "trigger": true
+    },
+    {
+      "q": "plan the responsive layout for the settings screen",
+      "trigger": true
+    },
+    {
+      "q": "implement the selected checkout design in React exactly as approved",
+      "trigger": true
+    },
+    {
+      "q": "build the settings page",
+      "trigger": true
+    },
+    {
+      "q": "improve this form, it feels clunky",
+      "trigger": true
+    },
+    {
+      "q": "what form components do we already have in the codebase?",
+      "trigger": false
+    },
+    {
+      "q": "change the primary button colour to green",
+      "trigger": false
+    },
+    {
+      "q": "add a database index on orders.status",
+      "trigger": false
+    },
+    {
+      "q": "fix the failing unit test in the auth module",
+      "trigger": false
+    },
+    {
+      "q": "build the scroll-driven story section for the launch page",
+      "trigger": true
+    },
+    {
+      "q": "make the hero pin and scrub through three beats as you scroll",
+      "trigger": true
+    },
+    {
+      "q": "the scroll position resets when I navigate back \u2014 fix the restoration bug",
+      "trigger": false
+    }
+  ]
 }

package/dist/agent-src/skills/fe-design/references/craft-floor.md

@@ -0,0 +1,52 @@
+# Craft floor — load this immediately before the write
+
+Universal floors. They do not vary by surface mode, register, change intent or
+stack. Taste and direction stay mode-scoped in
+[`fe-design`](../SKILL.md); nothing on this page is a preference.
+
+**Why this is a separate page rather than inline.** The skill body used to carry
+these inline, on the argument that "loaded" should mean the content is in
+context. That argument is kept and the delivery point moved: a floor read at
+*skill-load* time can be many turns and a compaction away from the write it
+governs, and `ADR-227` records that a path-scoped carrier is not re-injected
+after `/compact`. This page is pulled **immediately before the write**, which is
+the moment the floor has to be present. Same content, later delivery.
+
+## The floors
+
+1. **Reuse tokens, never raw values.** A hex, font or px literal where the audit
+   found a token is off-brand by construction.
+2. **All five states are designed.** `empty` is a helpful message, not a blank
+   region. `loading` prefers a skeleton over a spinner — it shows structure, so
+   it reads as faster. `error` says what to do next.
+3. **Labels are always visible.** No placeholder-only inputs.
+4. **Validate on blur and on submit**, never on every keystroke. The message
+   goes below the field and is specific.
+5. **Mobile-first, and 320 px actually works.** Default styles are the small
+   viewport; complexity is added at larger breakpoints, never removed at smaller
+   ones. `agent-config ui:render` captures 320 px so this is measurable rather
+   than asserted.
+6. **Accessibility minimums are non-negotiable.** 4.5:1 contrast for text (3:1
+   large), every interactive element reachable by Tab, a visible focus ring,
+   semantic elements over `div`, and an `aria-label` wherever there is no
+   visible text.
+7. **Every action gets feedback.** Users read silence as failure.
+8. **Prefer undo over a confirmation dialog.** Confirmations get clicked
+   through; an undo affordance actually protects the user.
+9. **Tables:** numbers right-aligned, text left-aligned, a designed empty state,
+   and a sticky header on anything long enough to scroll.
+10. **No placeholder microcopy ships.** Lorem ipsum, `TODO` and
+    `[Your text here]` are unfinished output, not drafts.
+11. **A default font pick is declared or changed.** Inter, Roboto, DM Sans,
+    Geist, Space Grotesk and Instrument Serif are the AI defaults. In the
+    product register "one reliable family" is a complete reason — but state it.
+    An undeclared pick is an undeclared choice (T7).
+12. **Zero silent drops.** A mechanic present in a supplied source and absent
+    from the output, with no `flagged` entry, is a silent drop.
+
+## What is NOT on this page
+
+Density, hierarchy, expressiveness, palette character, type personality,
+motion register. Those are surface-mode and register decisions and they live in
+`fe-design`. Putting them here would make a preference look like a floor, which
+is the failure this split exists to prevent.

package/dist/agent-src/skills/fe-design/references/source-led-port.md

@@ -0,0 +1,36 @@
+# Source-led port — adopt the mechanics, do not re-derive them
+
+Pulled when `ui_authority.reference_maturity` is `runnable-artifact`. Contract:
+[`ui-authority`](../../../../../docs/contracts/ui-authority.md).
+
+When `reference_maturity` is `runnable-artifact`, the artifact's own markup, CSS
+and JS is the data basis and adapting it is the DEFAULT. A from-scratch
+re-derivation is a deviation and needs the same confirmation as a swapped
+control (per [`design-fidelity`](../../rules/design-fidelity.md)).
+
+Account for every mechanic the source carries, in the engine's own vocabulary
+(`COVERAGE_BUCKETS`, shared rather than copied — `agent-config ui:audit`
+re-exports it):
+
+- **`honoured`** — carried across intact.
+- **`translated`** — expressed differently in the target stack, same observable
+  behaviour. Name the substitution.
+- **`flagged`** — cannot be carried; say so explicitly.
+
+```
+A MECHANIC THAT IS PRESENT IN THE SOURCE AND ABSENT FROM THE OUTPUT WITH NO
+`flagged` ENTRY IS A SILENT DROP. TARGET: ZERO.
+```
+
+`container-type` / `@container`, `clamp()` type scales, `:has()` state
+selectors, `IntersectionObserver` reveals and view transitions are the classes
+that vanish most often, because each one *looks* like decoration and is
+actually behaviour. `tests/eval/frontend-corpus/near-miss/artifact-source-not-rederived`
+is the pinned case: three mechanics, and an output that silently becomes a plain
+media-query grid fails it.
+
+**Maturity itself is not decided here.** `reference_maturity` arrives on the
+authority object, and per-value provenance for a comp belongs to
+`road-to-frontend-fidelity-calibration` Phases 0 and 2. This skill adds no
+second maturity discriminator.
+

package/dist/agent-src/skills/file-editor/SKILL.md

@@ -3,6 +3,11 @@ model_tier: lite
 name: file-editor
 description: "Use when opening edited files in the user's IDE. Reads settings from .agent-settings.yml to determine IDE and whether auto-open is enabled."
 domain: process
+scope:
+  write:
+    - pattern: "**"
+      access: "write"
+  verification_reason: "the write target IS the caller's argument — this skill edits whatever path it is pointed at, so its scope is the tree by construction. A narrower glob would be false, not tighter."
 execution:
   type: assisted
   handler: shell

package/dist/agent-src/skills/finishing-a-development-branch/SKILL.md

@@ -61,7 +61,7 @@ or [`fix-pr-comments`](../../commands/fix-pr-comments.md) instead.
 ### 2. Verify readiness
 
 Run the end-of-work gate before presenting any options — see
-[`verify-before-complete`](../verify-before-complete/SKILL.md).
+[`verify-completion-evidence`](../verify-completion-evidence/SKILL.md).
 Steps 1–3 run only when `quality.local_auto_run: true`; under the
 default (`false` / missing) skip them without asking — the user runs
 quality tools manually, remote CI on the PR is the authoritative gate,
@@ -226,7 +226,7 @@ After the chosen option completes, report:
 
 ## When to hand over to another skill / command
 
-* Final pre-merge verification → [`verify-before-complete`](../verify-before-complete/SKILL.md)
+* Final pre-merge verification → [`verify-completion-evidence`](../verify-completion-evidence/SKILL.md)
 * Rebasing the stack before PR → [`prepare-for-review`](../../commands/prepare-for-review.md)
 * Writing the commit for any last-minute tweaks →
   [`commit`](../../commands/commit.md),

package/dist/agent-src/skills/git-workflow/SKILL.md

@@ -3,6 +3,9 @@ model_tier: medium
 name: git-workflow
 description: "Use when working with Git — branch naming, commit messages, PR creation, rebasing, or the code review process — even when the user says 'push this' or 'merge the branch' without naming Git."
 domain: process
+scope:
+  write: []
+  verification_reason: "execution.handler is internal, so this skill spawns no subprocess — writes happen through the agent's declared allowed_tools. No command can prove a scope the skill never executes."
 execution:
   type: assisted
   handler: internal

package/dist/agent-src/skills/html-deck/SKILL.md

@@ -12,6 +12,9 @@ trust:
   level: professional
 install:
   removable: true
+scope:
+  write: []
+  verification_reason: "execution declares no handler, so this skill runs nothing of its own — every write is the calling agent's, under the rules that govern it. No command can prove a scope the skill never executes."
 execution:
   type: manual
 ---

package/dist/agent-src/skills/iconography/SKILL.md

@@ -12,6 +12,9 @@ trust:
   level: professional
 install:
   removable: true
+scope:
+  write: []
+  verification_reason: "execution declares no handler, so this skill runs nothing of its own — every write is the calling agent's, under the rules that govern it. No command can prove a scope the skill never executes."
 execution:
   type: manual
 ---

package/dist/agent-src/skills/image-editing/SKILL.md

@@ -12,6 +12,9 @@ trust:
   level: experimental
 install:
   removable: true
+scope:
+  write: []
+  verification_reason: "execution declares no handler, so this skill runs nothing of its own — every write is the calling agent's, under the rules that govern it. No command can prove a scope the skill never executes."
 execution:
   type: manual
 ---

package/dist/agent-src/skills/image-generation/SKILL.md

@@ -12,6 +12,9 @@ trust:
   level: experimental
 install:
   removable: true
+scope:
+  write: []
+  verification_reason: "execution declares no handler, so this skill runs nothing of its own — every write is the calling agent's, under the rules that govern it. No command can prove a scope the skill never executes."
 execution:
   type: manual
 ---

package/dist/agent-src/skills/image-provider-routing/SKILL.md

@@ -12,6 +12,9 @@ trust:
   level: experimental
 install:
   removable: true
+scope:
+  write: []
+  verification_reason: "execution declares no handler, so this skill runs nothing of its own — every write is the calling agent's, under the rules that govern it. No command can prove a scope the skill never executes."
 execution:
   type: manual
 ---

package/dist/agent-src/skills/incident-commander/SKILL.md

@@ -143,3 +143,13 @@ Post-mortem owner: <role>
 - Do NOT close an incident without a post-mortem owner assigned.
 - Do NOT edit the timeline after the fact; corrections are new
   entries.
+
+## See also
+
+- [`alerting-doctrine`](../alerting-doctrine/SKILL.md) — what earned the page
+  that opened this incident, and the runbook contract the first responder reads.
+  A page arrives with an owner, a runbook and a first diagnostic step; if it did
+  not, that is a configuration defect to record in the post-mortem.
+- [`logging-monitoring`](../logging-monitoring/SKILL.md) — the signal posture the
+  incident is being diagnosed through, and why a `proposed` threshold is not a
+  breach.