[Audit] File Organization - Align with CLAUDE.md Repository Boundaries

[ashleyshaw]

Overview

Audit current file organization against the planned structure defined in CLAUDE.md and identify misalignments requiring refactoring.

Current Problems

1. .github/agents/ still exists but agents moved to /agents in root
2. .github/scripts/ exists but scripts moved to /scripts in root
3. .github/schemas/ exists but should be /schema or /schemas in root
4. Documentation in both docs/ and .github/docs/
5. Uncertainty about which folders are reusable vs. GitHub-native

Areas to Audit

See child issues for detailed audits of:

• .github/ contents vs. root-level portable assets
• Agent file locations and migration status
• Script file locations and migration status
• Schema/config file locations
• Documentation folder organization
• Workflows folder structure
• Instructions folder organization

Acceptance Criteria

• Current state mapped against CLAUDE.md
• All misalignments documented
• Migration plan for files created
• Impact assessment completed

Related Files

• CLAUDE.md (source of truth for repo boundaries)
• .github/ (all folders)
• agents/
• scripts/
• schema/ or schemas/
• workflows/
• instructions/

Related Documentation

• CLAUDE.md - Repository Boundaries
• File Organisation Instructions
• AGENTS.md

---

Definition of Ready (DoR)

• Audit scope, checklist, and goals defined
• Areas/components listed
• Dependencies and standards mapped

Definition of Done (DoD)

• Audit performed and findings documented
• Remediation actions assigned
• Documentation/changelog updated (if applicable)
• PR uses correct branch prefix (audit/)

[linear-code]

LS-827