[Migration] Move plugin-structure.instructions.md to top-level

[ashleyshaw]

Migration Issue

Move plugin-structure.instructions.md from .github/instructions/ to top-level instructions/ folder per CLAUDE.md reusable asset guidelines.

Rationale

Per CLAUDE.md file organisation rules:

Do not place reusable assets under .github/—use the matching top-level folder instead.

plugin-structure.instructions.md is a reusable WordPress plugin structure guide that should live in the top-level instructions/ folder, not .github/instructions/.

Migration Details

Source Path

• Current: .github/instructions/plugin-structure.instructions.md
• Target: instructions/plugin-structure.instructions.md

Files to Update (References)

Need to audit and update all references to the old path:

grep -r "plugin-structure.instructions.md" .github --include="*.md" --include="*.yml"

Validation Plan

1. ✅ Move file from .github/instructions/plugin-structure.instructions.md to instructions/plugin-structure.instructions.md
2. ✅ Search for all references to old path:
   • Update cross-references in documentation
   • Update links in .github/instructions/file-organisation.instructions.md (if present)
   • Update MIGRATION_GUIDE.md if mentioned
   • Update agent specs that reference the file (e.g., plugin-related agents)
3. ✅ Verify no broken links
4. ✅ Lint migrated file (validate frontmatter, Markdown syntax)
5. ✅ Create pull request with migration

References

• CLAUDE.md § Repository Boundaries (file organisation rules)
• MIGRATION_GUIDE.md (instruction consolidation patterns)
• Related: .github/instructions/file-organisation.instructions.md

Acceptance Criteria

• File moved to instructions/plugin-structure.instructions.md
• All references updated (cross-links, applyTo, etc.)
• File lints successfully (0 errors)
• No broken links in documentation
• Migration recorded in commit message with source → target path

Status

Ready for migration.

[linear-code]

LS-762