---
name: abyss-self-diagnostic-spine
description: Apply the aoa-session-self-diagnose workflow inside an abyss-* repository using repo-relative runtime evidence, bounded diagnostic-session artifacts, last-good comparison posture, and honest owner-aware handoff. Use when the base diagnosis workflow is correct but one abyss repo needs a thin runtime-owned diagnostic read model before any repair claim becomes honest. Do not use when the request is really for silent repair, when no concrete target path exists, or when the base skill is already sufficient without local adaptation.
license: Apache-2.0
compatibility: Designed for Codex or similar coding agents with repository file access and an interactive shell. Network access is optional and only needed when repository validation or referenced workflows require it.
metadata:
  aoa_scope: project
  aoa_status: scaffold
  aoa_invocation_mode: explicit-preferred
  aoa_source_skill_path: skills/abyss-self-diagnostic-spine/SKILL.md
  aoa_source_repo: 8Dionysus/aoa-skills
  aoa_technique_dependencies: AOA-T-0080,AOA-T-0081
  aoa_portable_profile: codex-facing-wave-3
---

# abyss-self-diagnostic-spine

## Intent
Use this skill to adapt `aoa-session-self-diagnose` to an `abyss-*` repository
when the local repo needs one runtime-owned diagnostic session artifact that can
cite runtime evidence, compare against last-good posture, and hand off honestly
toward the reviewed session diagnosis family.

## Trigger boundary
Use this skill when:
- the base `aoa-session-self-diagnose` workflow is already correct, but an `abyss-*` repo needs one runtime-owned diagnostic session artifact with repo-relative evidence refs
- a concrete runtime path must be diagnosed before any repair claim becomes honest
- multiple runtime-body signals exist but remain scattered across local docs, logs, or checks
- reviewed session evidence exists and should be cited rather than absorbed into runtime canon
- the next honest move may be retest, governed repair, quest follow-up, progression lift, or manual regrounding

Do not use this skill when:
- the route is asking for immediate silent repair; use `aoa-session-self-repair` only after reviewed diagnosis exists
- there is no concrete target path to diagnose
- the material is still a live unreviewed session that belongs in the session-harvest family first
- no `abyss-*` repo adaptation is needed and the base `aoa-session-self-diagnose` skill is sufficient
- the work would widen into broader project doctrine instead of a thin local overlay

## Inputs
- resolved or requested preset / profile selectors
- runtime-body signals such as doctor, machine-fit, render-truth, smoke, autonomy, or related evidence refs
- optional reviewed session or harvest packet refs
- optional last-good comparison ref
- base skill reference

## Outputs
- one bounded runtime-owned `diagnostic_session_v1`
- one explicit `exit_class`
- named drift classes with evidence refs and unknowns when needed
- optional handoff recommendation toward:
  - `aoa-session-self-diagnose`
  - `aoa-session-self-repair`
  - `aoa-session-progression-lift`
  - `aoa-quest-harvest`
- a concise verification note for the local repo surface

## Procedure
1. start from `aoa-session-self-diagnose` instead of inventing a new project-family workflow
2. resolve the diagnostic target before interpreting symptoms
3. gather repo-relative runtime-body evidence refs without widening ownership
4. normalize the evidence into multi-axis verdicts and explicit drift classes
5. compare against last-good posture when a bounded anchor exists
6. choose one exit class
7. if reviewed session evidence exists, cite the next honest owner-facing handoff
8. emit the artifact without mutating quest, repair, or progression authority

## Contracts
- preserve the base skill meaning
- the overlay stays read-only and citation-friendly
- this overlay does not replace `aoa-doctor`
- this overlay does not grant free self-repair
- reviewed session packets remain packet-shaped and owner-aware
- quest state is not auto-mutated by this overlay
- public-safe defaults stay strong

## Risks and anti-patterns
- treating one axis failure as total collapse
- confusing runtime drift with source-owned doctrine drift
- using diagnosis to smuggle mutation authority
- turning every repeated issue into automatic progression or quest promotion
- hiding unknowns instead of naming them
- silently changing the base workflow instead of adapting the local repo surface

## Verification
- confirm the base skill is still the correct workflow
- confirm a concrete target exists
- confirm the produced artifact stays runtime-owned and citation-friendly
- confirm drift classes are named explicitly
- confirm one exit class is chosen
- confirm any handoff points to the right owner layer
- confirm no silent repair authority was added

## Technique traceability
Manifest-backed techniques:
- AOA-T-0080 from `8Dionysus/aoa-techniques` at `5c6f0496edc3c2e74590baa35627c85fe58ef765` using path `techniques/agent-workflows/session-drift-taxonomy/TECHNIQUE.md` and sections: Intent, Outputs, Risks, Validation
- AOA-T-0081 from `8Dionysus/aoa-techniques` at `5c6f0496edc3c2e74590baa35627c85fe58ef765` using path `techniques/agent-workflows/diagnosis-from-reviewed-evidence/TECHNIQUE.md` and sections: Intent, Inputs, Outputs, Core procedure, Contracts, Validation

## Adaptation points
- repo-relative runtime evidence refs
- local diagnostic target and last-good posture
- local drift-taxonomy examples
- local handoff notes toward reviewed diagnosis, repair, progression, and quest surfaces
- family review doc and bundle-local review checklist