[Child of #651] Audit: Documentation Folder Structure vs. CLAUDE.md Boundaries #665

Overview

Audit current documentation folder organization against the planned structure in CLAUDE.md to identify misplacements and reorganization needs.

Scope

• Review current structure of docs/, .github/, instructions/, and related folders
• Compare against CLAUDE.md guidance for where documentation should live
• Identify misplaced files
• Identify missing documentation
• Propose reorganization plan with rationale

Audit Checklist

• Extract current documentation file structure
• Review CLAUDE.md repository boundaries section
• Create mapping: Current Location → Expected Location
• Identify files in wrong folder
• Identify folders that need to be created
• Identify files that should be merged or archived
• Document rationale for any reorganization
• Create migration plan with dependencies

Deliverables

• Current state documentation inventory
• Mapping table: File | Current Location | Expected Location (per CLAUDE.md) | Action
• Reorganization proposal with rationale
• Migration plan with step-by-step instructions
• Impact assessment (what breaks if we move X?)

Related Files

• CLAUDE.md (source of truth)
• docs/ (all files)
• .github/ (all subfolders)
• instructions/ (all files)
• README.md (root)

Related Documentation

• CLAUDE.md - Repository Boundaries
• File Organisation Instructions
• Organization Overview

Definition of Ready (DoR)

• Clear problem statement and expected outcome
• Acceptance criteria defined
• Related issues/dependencies identified
• Required resources/approvals listed

Definition of Done (DoD)

• All acceptance criteria met
• Changes tested and validated
• Documentation updated
• Changes merged and deployed
• Stakeholders notified