Skip to content

Clean up broken citation links in ARCHITECTURE.md #6

@WesleyMFrederick

Description

@WesleyMFrederick

Problem

ARCHITECTURE.md contains 37 broken citation links identified by citation-manager validation. These are legacy references that need cleanup.

Broken Link Categories

  1. External project references (28 links): Links to <../resume-coach/design-docs/Architecture Principles.md that should reference local ARCHITECTURE-PRINCIPLES.md
  2. Missing internal files (6 links): References to files that don't exist:
    • design-docs/cc-workflows-workspace-prd.md
    • design-docs/research/content-aggregation-research.md
    • design-docs/Psuedocode Style Guide.md
  3. External workspace files (3 links): References to files outside the workspace:
    • ../../agentic-workflows/rules/citation-guidelines.md
    • ../../WORKSPACE-SETUP.md

Acceptance Criteria

  • All 37 broken links either fixed or removed
  • npm run citation:validate ARCHITECTURE.md passes with 0 critical errors
  • External project references (resume-coach) replaced with local ARCHITECTURE-PRINCIPLES.md references
  • Missing internal file references either created or removed as appropriate
  • External workspace file references evaluated: keep if valid, remove if obsolete

Impact

Priority: Medium
Effort: 1-2 hours
Blocks: Architecture documentation clarity, reliable cross-references

Related Documents

Validation Command

npm run citation:validate ARCHITECTURE.md

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationpriority:lowLow priority issue

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions