Broken References Report

ID Collisions (Critical)

The following Spec IDs are claimed by multiple documents. This makes cross-referencing ambiguous and potentially incorrect.

ADR-011

• specs\shared\adr\011-internal-federated-ledger.md (Claims ADR-011)
• specs\shared\adr\011-automated-documentation-generation.md (Claims ADR-011) Impact: References to ADR-011 are ambiguous. Found usage in both IFL and Documentation contexts.

(automated-documentation-generation.md is actually ADR-024)

SDS-010

• specs\shared\sds\010-internal-federated-ledger-service.md (Claims SDS-010)
• specs\shared\sds\002-documentation-orchestrator-service.md (Claims SDS-010) Impact: References to SDS-010 are ambiguous.

SDS-011

• specs\cognitive-extension\sds\011-pet-prompt-judge.md (Claims SDS-011)
• specs\shared\sds\003-project-context-analyzer-service.md (Claims SDS-011)

SDS-006

• specs\cognitive-extension\sds\006-softmax-router-agent-pattern.md (Claims SDS-006)
• specs\cognitive-extension\sds\003-cadsl-runtime-renderer.md (Claims SDS-006)

SDS-007

• specs\architectural-governance\sds\001-calm-cli-service.md (Claims SDS-007)
• specs\cognitive-extension\sds\007-crl-math-reasoning-service.md (Claims SDS-007)

SDS-008

• specs\cognitive-extension\sds\008-context-materialization-service.md (Claims SDS-008)
• specs\cognitive-extension\sds\004-ai-agent-configuration-service.md (Claims SDS-008)

SDS-020

• specs\shared\sds\020-ci-semantic-gates.md (Claims SDS-020)
• specs\shared\sds\020-semantic-observability.md (Claims SDS-020)

Fixes Applied

1. ADR-011 Duplication:
   • 011-automated-documentation-generation.md renamed to ADR-024 (024-automated-documentation-generation.md).
   • References updated in PRD-001, PRD-017, SDS-025.
2. SDS-010 Duplication:
   • 002-documentation-orchestrator-service.md renamed to SDS-025 (025-documentation-orchestrator-service.md).
   • Context Map updated.
3. SDS-011 Duplication:
   • 003-project-context-analyzer-service.md renamed to SDS-026 (026-project-context-analyzer-service.md).
   • Context Map updated.
4. SDS-006 Duplication:
   • 003-cadsl-runtime-renderer.md renamed to SDS-027 (027-cadsl-runtime-renderer.md).
   • Context Map updated.
5. SDS-007 Duplication:
   • 001-calm-cli-service.md renamed to SDS-028 (028-calm-cli-service.md).
   • Context Map updated.
6. SDS-008 Duplication:
   • 004-ai-agent-configuration-service.md renamed to SDS-029 (029-ai-agent-configuration-service.md).
   • Context Map updated.
7. SDS-020 Duplication:
   • 020-semantic-observability.md renamed to SDS-030 (030-semantic-observability.md).
   • Context Map updated.

Remaining Actions

• Verify broken links inside documents (other than collisions).
• Validate anchors.