[Child of #653] Audit: Current File Organization vs. CLAUDE.md Boundaries

[ashleyshaw]

Overview

Audit current repository file organization against the planned structure defined in CLAUDE.md to identify misalignments.

Scope

• Map current structure of .github/, root folders, and all major directories
• Compare against CLAUDE.md definitions for reusable vs. GitHub-native assets
• Identify misplacements of files/folders
• Document what's in the wrong location according to CLAUDE.md

Audit Checklist

• Extract current directory structure
• Review CLAUDE.md repository boundaries section (source of truth)
• Create mapping: Current Location | Expected Location (per CLAUDE.md) | Status
• Identify items in wrong location
• Identify missing expected folders
• Identify unexpected items in .github/
• Document rationale for any current misplacements

Deliverables

• Current state audit report
• Mapping document: Path | Current Location | Expected Location | Status
• List of misaligned items
• Impact assessment (what needs to move, what's OK as is)

Related Files

• All folders and major files across repository
• .github/ (entire folder)
• Root level folders: agents/, scripts/, schemas/, docs/, workflows/, etc.

Related Documentation

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

[linear-code]

LS-845

[ashleyshaw]

Phase 1 deliverable completed.\n\nDeliverable report:\n- https://github.com/lightspeedwp/.github/blob/develop/.github/reports/audits/2026-06-03-file-organisation-vs-claude-boundaries-audit-671.md\n\nIncludes:\n- current structure mapping\n- GitHub-native vs reusable placement analysis\n- impact assessment

[ashleyshaw]

Status update (2026-06-03): Changes affecting this issue are now merged into develop via PR #814 (commit ea285b6). Current issue state remains as-is and reflects the delivered work.