Move the diagnostic skill into its owner home

.agents/AGENTS.md

@@ -5,8 +5,8 @@ first.
 
 ## Scope
 
-This directory owns repo-local agent install and overlay surfaces that need to
-ship with the `abyss-stack` source checkout.
+This directory owns transitional repo-local agent projections and model lanes
+that need to ship with the `abyss-stack` source checkout.
 
 ## Read Before Editing
 
@@ -20,6 +20,7 @@ ship with the `abyss-stack` source checkout.
 ## Directory Contract
 
 - Keep canonical skill law in the owning skill repository.
+- Keep stack-owned canonical packages under `skills/`, not in this projection.
 - Keep local overlays thin, portable, and explicit about the canonical upstream.
 - Keep agent model lanes under `.agents/<lane>/`, not as top-level runtime
   districts.

.agents/README.md

@@ -5,15 +5,15 @@
 
 ## Current Routes
 
-- [skills](skills/AGENTS.md): thin repo-local skill install and overlay
-  surfaces.
+- [skills](skills/AGENTS.md): transitional projection of shared skills;
+  stack-owned canonical packages live under root `skills/`.
 - [spark](spark/README.md): repo-local fast-loop lane for bounded
   infrastructure corrections.
 
 ## Contract
 
-Canonical skill law stays in the owning skill repository. Local files here
-should only adapt that law to source-safe `abyss-stack` runtime contracts and
-current mechanics paths.
+Canonical skill law stays in the owning repository. This lane does not host a
+second copy of a stack-owned package already exposed through the OS user
+profile.
 
 Agent model lanes belong under `.agents/<lane>/`, not as root directories.

.agents/skills/AGENTS.md

@@ -5,25 +5,22 @@ Local guidance for `.agents/skills/` in `abyss-stack`. Read the root
 
 ## Scope
 
-This directory is the repo-local skill install and overlay surface. Most entries
-are symlinks into the stronger `aoa-skills` owner; local directories exist only
-when `abyss-stack` needs a portable overlay tied to stack runtime contracts.
+This directory is the transitional repo-local projection of shared skills.
+Entries are symlinks into the stronger `aoa-skills` owner. Canonical
+`abyss-stack` procedures live under root `skills/` and are exposed through the
+OS user profile, not duplicated here.
 In this workspace, symlinked skills target
 `/srv/AbyssOS/aoa-skills/.agents/skills/<skill-name>`; older flat sibling
 targets are historical drift, not an active route.
 
 ## Local Contract
 
-- Do not move canonical skill law into this repository.
+- Do not move shared skill law into this repository.
+- Do not place stack-owned canonical packages or same-name global copies here.
 - Keep symlinked skill names aligned with the stronger `aoa-skills` source.
 - Keep symlink targets under `/srv/AbyssOS/aoa-skills/.agents/skills/`.
-- Keep local overlays thin, source-safe, and explicit about their canonical
-  upstream.
-- Keep every local overlay `SKILL.md` loadable by Codex: its frontmatter must
-  declare the directory name, a non-empty trigger description, and the current
-  canonical source path under standard `metadata.aoa_*` keys.
-- When an overlay references stack surfaces, point to package-local mechanics
-  paths rather than old root topology.
+- Treat this projection as compatibility state until the global OS profile
+  preserves the shared functions without repository duplicates.
 
 ## Validate
 

AGENTS.md

@@ -29,7 +29,9 @@ It is not the system design. Read `DESIGN.md` for the intended runtime form and
 8. `docs/runtime/ARCHITECTURE.md`
 9. `mechanics/README.md`
 10. The nearest local `AGENTS.md`, README, and validation notes for every touched
-   path
+    path
+11. `skills/AGENTS.md` and `skills/port.manifest.json` when changing an owner
+    skill package
 
 Use `docs/legacy/AGENTS_ROOT_REFERENCE.md` only when the short card is not enough.
 
@@ -112,6 +114,8 @@ This repository owns:
   as `memo/`, when they preserve sibling-owner authority
 - runtime-owned statistical questions under `stats/`, using the shared
   `aoa-stats` grammar without moving runtime meaning into the central organ
+- owner skill packages under `skills/` when the procedure binds stack-owned
+  runtime evidence and tools; global exposure remains an OS profile concern
 
 It does not own:
 

BOUNDARIES.md

@@ -23,13 +23,15 @@ This file names what belongs in `abyss-stack` and what must stay elsewhere.
 - runtime benchmark policies, schemas, normalized manifests, and raw runtime evidence
 - platform-adaptation policies and bounded public-safe/private tuning records
 - runtime-facing return policy, context rebuild posture, and return-event logging
+- canonical agent procedures whose applicability, tool binding, typed output,
+  and termination are owned by this runtime
 
 ## Belongs elsewhere
 
 - AoA ecosystem-level meaning in `Agents-of-Abyss`
 - ToS knowledge architecture meaning in `Tree-of-Sophia`
 - reusable techniques in `aoa-techniques`
-- bounded execution workflows in `aoa-skills`
+- shared bounded execution workflows and skill-system doctrine in `aoa-skills`
 - proof surfaces in `aoa-evals`
 - portable verdict logic for runtime benchmark meaning in `aoa-evals`
 - routing truth in `aoa-routing`

CHANGELOG.md

@@ -9,6 +9,9 @@ Tracking starts with the community-docs baseline for this repository.
 
 ### Added
 
+- `skills/abyss-self-diagnostic-spine` is now the admitted owner package for
+  stack runtime diagnosis, with an explicit procedure contract and
+  OS-user-profile exposure instead of a second repo-local copy.
 - An explicit Gemma 4 E2B `llama-swap` tuning candidate now admits measured
   cold loads through the private `abyss-machine` owner socket, keeps proxy
   history bounded to zero, releases the model after idle, removes inherited
@@ -79,10 +82,9 @@ Tracking starts with the community-docs baseline for this repository.
   launch` admission instead of starting hidden archive scans. Exact agent-event
   usage audits now use their existing indexed read model and defer broad
   consequence expansion through the same owner-admitted route.
-- The repo-local `abyss-self-diagnostic-spine` overlay now carries valid
-  trigger metadata and the current canonical `aoa-skills` source path, while
-  the skill-projection validator rejects missing descriptions, stale canonical
-  routes, and legacy top-level frontmatter before Codex startup.
+- The diagnostic skill now resolves its exact `abyss-stack` owner package from
+  the same-bundle OS source receipt, while the shared skill-projection
+  validator no longer treats a repo-local diagnostic directory as canonical.
 - `aoa-session-memory-mcp` now publishes and validates exact closed-world
   read-only annotations for every tool, allowing Codex approval policy to
   distinguish evidence reads from side-effecting MCP calls without a per-tool

CHARTER.md

@@ -15,11 +15,14 @@ Its job is to keep the runtime body explicit, modular, reviewable, and recoverab
 - lifecycle operations
 - runbook and recovery posture
 - infrastructure helper services
+- owner skill packages for stack-owned runtime procedures
 
 ## It does not own
 
 - ecosystem-level doctrine for AoA as a whole
-- authored meaning from `aoa-techniques`, `aoa-skills`, `aoa-evals`, `aoa-routing`, `aoa-memo`, `aoa-agents`, `aoa-playbooks`, or `aoa-kag`
+- shared or sibling-authored meaning from `aoa-techniques`, `aoa-skills`,
+  `aoa-evals`, `aoa-routing`, `aoa-memo`, `aoa-agents`, `aoa-playbooks`, or
+  `aoa-kag`
 - the primary authored corpus of Tree of Sophia
 
 ## Core rule

DESIGN.AGENTS.md

@@ -28,8 +28,8 @@ The agent route mesh has these layers:
 - **design cards**: `DESIGN.md` for runtime form and this file for agent-surface
   form
 - **district cards**: local cards for `compose/`, `config-templates/`, `env/`,
-  `systemd/`, `scripts/`, `mcp/`, `memo/`, `docs/`, `tests/`, `.agents/`,
-  `.github/`, and other root districts
+  `systemd/`, `scripts/`, `mcp/`, `skills/`, `memo/`, `docs/`, `tests/`,
+  `.agents/`, `.github/`, and other root districts
 - **mechanic package cards**: `mechanics/<package>/AGENTS.md` cards for runtime
   move families
 - **part cards**: `mechanics/<package>/parts/<part>/AGENTS.md` cards when a part

DESIGN.md

@@ -31,8 +31,8 @@ A healthy `abyss-stack` looks like a working runtime map:
   secrets, models, logs, or private captures
 - an explicit deployed runtime root under `/srv/AbyssOS/abyss-stack`
 - clear districts for compose modules, config templates, env examples, systemd
-  units, scripts, mechanics, MCP access planes, local memo and stats ports,
-  docs, tests, and local agent overlays
+  units, scripts, mechanics, MCP access planes, owner skill packages, local
+  memo and stats ports, docs, tests, and local agent overlays
 - profile and preset surfaces that make service selection visible
 - mechanic packages that describe runtime moves as packages and parts, not as a
   flat pile of historical files
@@ -70,6 +70,9 @@ The runtime body has these organs:
   through storage-neutral application ports
 - **MCP access planes**: stdio or authenticated host-local adapters that expose
   bounded live or derived context while keeping owner-layer authority intact
+- **owner skill home**: canonical procedures for stack-owned runtime
+  capabilities, exposed once through the OS user profile while shared skill
+  doctrine remains in `aoa-skills`
 - **local memo port**: runtime-side memory candidates, receipts, exports, and
   local notes that route durable review to `aoa-memo`
 - **local stats port**: runtime-owned statistical questions whose definitions

README.md

@@ -47,6 +47,7 @@ Read only what matches your entry need.
 | Local worker and model trials | [mechanics/inference-pilots](mechanics/inference-pilots/README.md), [LOCAL_AI_TRIALS](mechanics/inference-pilots/parts/local-trials/docs/LOCAL_AI_TRIALS.md), [LLAMACPP_PILOT](mechanics/inference-pilots/parts/llamacpp-pilot/docs/LLAMACPP_PILOT.md), [MODEL_PROFILES](mechanics/machine-fit/parts/inference-tuning/docs/MODEL_PROFILES.md) |
 | Runtime federation seams | [mechanics/federation-seams](mechanics/federation-seams/README.md), [MEMO_RUNTIME_SEAM](mechanics/federation-seams/parts/memo-seam/docs/MEMO_RUNTIME_SEAM.md), [EVAL_RUNTIME_SEAM](mechanics/federation-seams/parts/eval-seam/docs/EVAL_RUNTIME_SEAM.md), [PLAYBOOK_RUNTIME_SEAM](mechanics/federation-seams/parts/playbook-seam/docs/PLAYBOOK_RUNTIME_SEAM.md), [KAG_RUNTIME_SEAM](mechanics/federation-seams/parts/kag-seam/docs/KAG_RUNTIME_SEAM.md) |
 | Diagnostics and repair posture | [mechanics/diagnostic-spine](mechanics/diagnostic-spine/README.md), [DIAGNOSTIC_SPINE](mechanics/diagnostic-spine/parts/diagnostic-surfaces/docs/DIAGNOSTIC_SPINE.md), [diagnostic surface catalog](mechanics/diagnostic-spine/parts/diagnostic-surfaces/generated/diagnostic_surface_catalog.min.json), [scripts/aoa-diagnose](scripts/aoa-diagnose), [mechanics/runtime-repair](mechanics/runtime-repair/README.md) |
+| Stack-owned agent procedure | [skills route card](skills/AGENTS.md), [skill home manifest](skills/port.manifest.json), then the named owner bundle |
 
 ## Route Modes
 
@@ -174,6 +175,7 @@ storage.
 | [kag](kag/README.md) | source-linked provider records and repository indexes |
 | [stats](stats/README.md) | runtime-owned statistical questions using the shared `aoa-stats` grammar |
 | [scripts](scripts/README.md) | stable operator wrappers and repository validators |
+| [skills](skills/AGENTS.md) | canonical agent procedures for stack-owned runtime capabilities |
 | [systemd](systemd/README.md) | user-unit source skeletons and managed working-service adapters |
 | [tests](tests/README.md) | repository-level tests and validation routes |
 | [.agents](.agents/README.md) | repo-local agent overlays and fast-loop lanes |

docs/decisions/ABYSS-STACK-D-0050-diagnostic-spine-validator-module.md

@@ -1,7 +1,8 @@
 # Diagnostic Spine Validator Module
 
 - Decision ID: ABYSS-STACK-D-0050
-- Status: accepted
+- Status: amended
+- Amended by: `ABYSS-STACK-D-0080-diagnostic-skill-owner-home.md`
 - Date: 2026-06-03
 - Owner surface: `scripts/validators/diagnostic_spine.py`
 
@@ -11,14 +12,14 @@
 - Surface classes: validation guard, diagnostic surface, generated read-model
 - Stack lanes: source checkout, runtime mechanics
 - Mechanic parents: diagnostic-spine
-- Guard families: validation lane, diagnostic surface catalog, overlay skill
-- Posture: accepted ninth validator-module split
+- Guard families: validation lane, diagnostic surface catalog, owner skill package
+- Posture: amended ninth validator-module split
 
 ## Context
 
 After federation runtime seams moved out of `scripts/validate_stack.py`, the
 root validator still held diagnostic-spine contracts: route docs, diagnostic
-schemas, public-safe examples, generated catalog refs, and the local
+schemas, public-safe examples, generated catalog refs, and the then-local
 diagnostic overlay skill posture.
 
 Those checks protect runtime-local diagnostic read models and repair handoff
@@ -42,6 +43,11 @@ Keep `scripts/validate_stack.py` as the compatibility entrypoint. Update the
 diagnostic surface catalog validation refs to include the focused module and
 its root-level module test.
 
+`ABYSS-STACK-D-0080` later amended the package boundary: the focused module
+now validates the canonical `skills/abyss-self-diagnostic-spine` owner package
+and its OS user exposure contract directly. It no longer receives a
+repo-local overlay callback.
+
 ## Rationale
 
 The diagnostic spine is a coherent owner surface: it owns self-location,
@@ -52,22 +58,23 @@ federation, service-selection, or source-hygiene checks.
 
 ## Consequences
 
-- Positive: diagnostic docs, schemas, examples, catalog refs, and overlay skill
-  posture now have a focused owner module.
+- Positive: diagnostic docs, schemas, examples, catalog refs, and the canonical
+  owner skill package now have a focused owner module.
 - Positive: the generated diagnostic catalog names the focused validator and
   test that protect it.
 - Positive: existing callers stayed stable during the extraction bridge;
   D-0063 now routes focused callers to `scripts/validators/diagnostic_spine.py`.
-- Tradeoff: the module still receives repo-local overlay skill surfaces from
-  root orchestration because overlay install posture is shared with other
-  repo-local skill routes.
+- Amendment: the diagnostic package no longer depends on the transitional
+  `.agents/skills` projection or a callback from root orchestration.
 
 ## Source surfaces
 
 - `scripts/validators/diagnostic_spine.py`
 - `scripts/validate_stack.py`
 - `mechanics/diagnostic-spine/parts/diagnostic-surfaces/`
 - `mechanics/diagnostic-spine/parts/diagnostic-surfaces/generated/diagnostic_surface_catalog.min.json`
+- `skills/abyss-self-diagnostic-spine/`
+- `skills/port.manifest.json`
 - `tests/test_diagnostic_spine_validator_module.py`
 
 ## Follow-up route