Scope
- This skill owns shared observability/reporting runtime entrypoints.
- Commands here support diagnostics, inventory generation, execution logs, and graph/report exports.
- Stage orchestration ownership remains in stage skills,
feature-dev-aidd:aidd-flow-state, andfeature-dev-aidd:aidd-loop.
Canonical shared Python entrypoints
python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-observability/runtime/doctor.pypython3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-observability/runtime/tools_inventory.pypython3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-observability/runtime/tests_log.pypython3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-observability/runtime/dag_export.pypython3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-observability/runtime/identifiers.py
Command contracts
python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-observability/runtime/doctor.py
- When to run: when environment/runtime path drift or tooling prerequisites are suspected.
- Inputs: optional workspace and diagnostics flags.
- Outputs: deterministic environment health report and actionable remediation hints.
- Failure mode: non-zero exit if required dependencies/path assumptions fail validation.
- Next action: apply reported environment fixes and rerun doctor before stage retry.
python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-observability/runtime/tools_inventory.py
- When to run: when ownership/runtime API inventory must be regenerated for audits.
- Inputs: plugin root with optional output path filters.
- Outputs: normalized inventory snapshot for skills/runtime ownership checks.
- Failure mode: non-zero exit on inventory generation or schema serialization failures.
- Next action: fix inventory generation issue and rerun the command.
Ownership guard
- Observability/reporting command modules must live under
skills/aidd-observability/runtime/*. - Consumers should reference
skills/aidd-observability/runtime/*as canonical command paths.
Additional resources
- references/inventory-contract.md (when: ownership/inventory output is in question; why: keep report schema and consumers aligned).
- references/diagnostics.md (when: environment/diagnostics behavior is unclear; why: keep doctor/tests-log output deterministic).