aidd-observability

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, and feature-dev-aidd:aidd-loop.

Canonical shared Python entrypoints

• python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-observability/runtime/doctor.py
• python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-observability/runtime/tools_inventory.py
• python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-observability/runtime/tests_log.py
• python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-observability/runtime/dag_export.py
• python3 ${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).