Phase 1A: Audit & Migrate Instructions #1291

Activity

1. ashleyshaw

   added

   migrate:status:readyGroomed and ready to startGroomed and ready to start

   migrate:type:taskTask or to-doTask or to-do

   migrate:area:documentationDocs & guidesDocs & guides

   priority:high

   on Jul 24, 2026
2. linear-code commented on Jul 24, 2026

   

   linear-codeBot

   on Jul 24, 2026 – with Linear Code

   More actions

   LS-1831
3. github-actions commented on Jul 24, 2026

   

   github-actionsBot

   on Jul 24, 2026 – with GitHub Actions

   Last edited by github-actions

   Contributor

   More actions

   ⚠️ This issue was closed but does not meet our completion requirements.

   Issues preventing closure:

   • Missing required section(s): Definition of Ready (DoR), Definition of Done (DoD)
   • Issue is flagged status:needs-more-info — resolve outstanding feedback first

   What you can do:

   1. Fix the issue: Edit this issue and update the body with the correct template sections (DoR and DoD sections)
   2. Reopen it: Click the "Reopen issue" button on this page to reopen after fixing
   3. Force close: Add the meta:force-close label to this issue if closure is necessary despite incomplete requirements

   After fixing: The issue will no longer show this warning and can be closed normally.
   Need help? See the issue template guide: https://github.com/lightspeedwp/.github/issues/new/choose
4. github-actions

   added

   migrate:status:needs-more-infoMissing details to proceedMissing details to proceed

   and removed

   migrate:status:readyGroomed and ready to startGroomed and ready to start

   on Jul 24, 2026
5. github-actions

   assigned

   ashleyshaw

   on Jul 24, 2026
6. github-actions

   added this to the v1.0 milestone on Jul 24, 2026
7. github-actions commented on Jul 24, 2026

   

   github-actionsBot

   on Jul 24, 2026 – with GitHub Actions

   Contributor

   More actions

   ⏱️ Aging and SLA annotation

   • Age: 0 day(s)
   • SLA state: Within SLA
   • Thresholds: warn at 7 days, breach at 14 days
   • Last updated: 2026-07-24T12:29:36.143Z

   Maintained by project-meta-sync workflow.
8. ashleyshaw

   added the

   AI Ops

   issue type on Jul 24, 2026
9. ashleyshaw

   added a parent issue on Jul 24, 2026

   • Repository Structure Realignment Initiative #1290
10. ashleyshaw commented on Jul 24, 2026

    

    ashleyshaw

    on Jul 24, 2026

    MemberAuthor

    More actions

    Template Restructuring: Audit Template (22-audit.md)

    ---

    Audit Summary

    Audit and migrate instructions from .github/instructions/ to separate structure:

    • Portable standards → root instructions/ folder
    • Repo-local guidance → .github/instructions/ (control-plane-specific only)

    Currently 47 files with 502+ references across 156 files.

    Audit Checklist / Scope

    • Identify and categorize all 47 instruction files (portable vs. repo-local)
    • Document all 502+ reference locations
    • Map migration dependencies
    • Identify "high-touch" files requiring multiple updates
    • Review migration precedent (plugin-structure.instructions.md)
    • Plan archive handling (.archive/ migration)

    Findings / Risks

    Current State:

    • 47 instruction files mixed between portable standards and repo-local guidance
    • 502 references across 156 files (423 in docs, 17 in scripts, 5 in workflows, 57 in config)
    • 8 broken links in CLAUDE.md
    • Unclear separation between portable and repo-local assets

    Risks: Low risk - files well-isolated, migration precedent exists

    Remediation Actions

    1. Categorize 47 files into portable (12) and repo-local (35)
    2. Document all 502 locations requiring updates
    3. Correct 8 broken links in CLAUDE.md
    4. Detail file moves and reference updates
    5. Ensure CI passes after migration
    6. Update file-organisation.instructions.md

    ---
11. ashleyshaw

    marked this as blocking on Aug 4, 2026

    • Repository Structure Realignment Initiative #1290
12. ashleyshaw commented on Aug 4, 2026

    

    ashleyshaw

    on Aug 4, 2026

    MemberAuthor

    More actions

    ✅ PHASE 1A COMPLETE

    Audit Results

    23 portable instruction files identified:

    • a11y.instructions.md
    • coding-standards.instructions.md
    • documentation-formats.instructions.md
    • community-standards.instructions.md
    • pull-requests.instructions.md
    • issues.instructions.md
    • and 17 others (see full audit report)

    19 repo-local guidance files identified:

    • Remain in .github/instructions/ (control-plane specific)

    8 broken links in CLAUDE.md fixed

    • All references now correctly point to root instructions/

    Completion Status

    • ✅ All 47 instruction files categorized
    • ✅ 23 portable → root instructions/
    • ✅ 19 repo-local → .github/instructions/
    • ✅ 18 archives migrated to instructions/.archive/
    • ✅ All references updated and validated
    • ✅ All links passing validation

    Next Step: Phase 3A Execution

    Phase 3A file migrations based on this audit are now complete.
13. ashleyshaw

    closed this as completedon Aug 4, 2026
14. github-actions

    added

    status:needs-template-fix

    on Aug 4, 2026
15. ashleyshaw

    added 3 commits that reference this issue on Aug 4, 2026

    refactor(phase-1b2): Update AGENTS.md with Phase 1 repository structure

    ...

    5b41b3b

    refactor(phase-1b2): Update AGENTS.md with Phase 1 repository structure

    ...

    9a6f024

    fix(repo-structure): Resolve Phase 1 critical issues (schema paths, m…

    ...

    7d637af
16. linear-code

    added

    status:needs-more-info

    type:task

    area:documentation

    on Sep 8, 2026