Skip to content

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

@ashleyshaw

Description

@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

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Priority

    None yet

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions