doctrine-drift-check

name	doctrine-drift-check
description	HADES doctrine drift detection: query caronte code-graph for all code/spec/doc references to doctrine keys; compare against current HADES design config; report mismatches by severity. Use when operator invokes /hades:doctrine-drift-check.
license	Proprietary
agentskills_version	1
keywords	["doctrine-drift","caronte","drift-detection","HADES design","cross-reference","hades"]

HADES — doctrine-drift-check skill (doctrine drift detection)

This skill detects doctrine drift by querying caronte code-graph for all references to doctrine keys and cross-referencing with the current HADES design doctrine config. Triggered by /hades:doctrine-drift-check [project].

When to use

• Operator invokes /hades:doctrine-drift-check
• Pre-merge gate (part of make verify-doctrine-drift)
• Morning brief (hades day includes drift summary)
• When investigating discrepancy between code/spec and active doctrine

Workflow

1. Get current doctrine config

curl --unix-socket /tmp/hades-system.sock -s \
     "http://unix/v1/doctrine/show?project=$PROJECT" | jq '.doctrine_config'

2. Query caronte code-graph for each doctrine key

curl --unix-socket /tmp/hades-system.sock \
     -X POST \
     -d '{"tool":"mcp_hades-system_caronte_query","query":"references_to:doctrine.<key>"}' \
     http://unix/v1/mcpgateway

3. Cross-reference values

For each (key, reference) pair: compare asserted value at reference site vs daemon config. Mismatch → drift detected.

4. Three-severity output

• HIGH: doctrine ceiling references (most critical)
• MEDIUM: threshold/config references in tests (may cause future failures)
• LOW: comment/doc references (awareness only)

5. Audit anchor

Emits DoctrineDriftCheckCompleted event anchored in HADES design audit chain.

Cross-references

• HADES design doctrine schema (canonical source of truth)
• HADES design §3.1 mcpgateway (caronte in-process; tool name mcp_hades-system_caronte_query)
• /hades:doctrine-drift-check slash command handler