refactor: Phase 3D - Reports Placement Enforcement by ashleyshaw · Pull Request #1581 · lightspeedwp/.github

ashleyshaw · 2026-08-05T09:07:47Z

Summary

Phase 3D of the repository restructuring initiative: enforce active project placement governance and consolidate reports documentation.

Linked issues

Resolves #1544

Changes

Verified all 23 active projects in .github/projects/active/
Confirmed root projects/ directory is empty (correct state)
Created comprehensive project index (v2.0) with categories and governance
Updated 50+ references across codebase
Documented project creation process and lifecycle
Standardized all path references in documentation

Changelog

Added

Comprehensive project index (v2.0) in .github/projects/active/README.md with full project tracking and governance rules

Changed

Updated 50+ reference paths across .github/custom-instructions.md, configuration files, and documentation for governance alignment
Reorganized .github/projects/active/README.md from v1.0 to v2.0 with enhanced project categorization

Fixed

Active project placement enforcement rules in CLAUDE.md
Project documentation consistency across all active projects

Verification

All 23 projects verified in correct location
Linting: markdownlint-cli2 + prettier
Relative paths validated
No stale references to root projects/ directory

Risk & Rollback

Risk level: Low
Rollback plan: Revert commit to restore previous project documentation state

Checklist (Global DoD / PR)

Code follows project standards
Tests pass (where applicable)
Documentation updated
Ready for review

## Summary Execute Phase 3D of repository restructuring initiative: enforce reports placement in `.github/projects/active/` and update 50+ references across codebase. ## Changes ### Reports & Projects Consolidation - **Verified placement:** All 23 active projects correctly located in `.github/projects/active/` - **Removed incorrect paths:** Root `projects/` directory verified empty (no cleanup needed) - **Updated core references (P0 Critical):** - `.github/custom-instructions.md`: Fixed 3 project reference paths (Phase 1 audit reports) - `.github/projects/README.md`: Updated project path references for clarity - `.github/CHANGELOG_CONTRIBUTOR_CHECKLIST.md`: Fixed relative path references ### Code & Configuration Updates (P1 High) - `eslint.config.cjs`: Fixed linting ignore patterns (projects/active → .github/projects/active) - `.github/reports/footer-audit-2026-08-04.json`: Fixed 21 path references in audit report ### Documentation & Index Updates (P2 Medium) - `.github/projects/active/README.md`: Complete rewrite - Added comprehensive index of all 23 active projects - Added project categorization (Infrastructure, Standards, Documentation, Testing, Release, Planning, Agents) - Added status summary table - Added project creation process documentation - Added governance enforcement notes for Phase 3D - `.remember/phase-3.2-continuation-prompt.md`: Fixed directory structure visualization ## Project Index (23 Active) ### Core Infrastructure - Repository Restructuring Phase 1 (2026-07-25) - Repository Maintenance Infrastructure - Workflows Consolidation 2026-Q3 ### Agent & Skill Standards - Agent Skills Standards Comprehensive - Agent Standards Initiative - Phase 2B Skills Audit ### Documentation & Governance - Template Enforcement Governance - Wave 5 Documentation Audit - Changelog Automation Hardening - Markdown Audit CI Optimization ### Testing & QA - Test Coverage Implementation - Issue Triage Automation System - Status Needs Review Audit 2026-08-04 ### Issue & Workflow Systems - Issue Type Workflow Automation - GitHub Projects Creation System ### Release & Deployment - Release Workflow Authorization Fixes - Node.js Upgrade 2026-Q3 - Node.js Upgrade 2026-Q3 Post-Merge Monitoring ### Planning & Strategy - Milestone Planning v1 - Repository Restructuring Phase 1 - PR Review Project Planning 2026-08-04 - PRD Combined Agent - OpenSpec ## Governance Enforcement **Key Principle:** All active project artefacts MUST be in `.github/projects/active/{slug}/` only. Root `projects/` directory is not permitted. This phase completes: - ✅ Reports placement verification (23 projects confirmed) - ✅ Path reference updates (50+ references fixed) - ✅ Active projects index (comprehensive documentation) - ✅ Creation process documentation (guidelines added) - ✅ Governance rules enforcement (CLAUDE.md aligned) ## Phase 3D Scope Completion - [x] Verify active projects locations - [x] Ensure no reports in root `projects/` directory - [x] Update critical references (P0: governance files) - [x] Update high-priority references (P1: core docs) - [x] Update medium-priority references (P2: reports) - [x] Create/update `.github/projects/active/README.md` - [x] Update CLAUDE.md "Active projects note" section - [x] Document project creation process - [x] Verify no stale references to root `projects/` - [x] Run validation and linting ## Testing - Verified all 23 active project directories exist in `.github/projects/active/` - Confirmed root `projects/` directory does not exist (correct state) - Verified no remaining incorrect `projects/active` references without `.github/` prefix - Validated JSON structure in footer-audit report - Confirmed relative paths in `.github/` files resolve correctly Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

coderabbitai · 2026-08-05T09:08:03Z

Warning

Review limit reached

@ashleyshaw, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 52 minutes

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details

⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: 6308c1e7-f400-4e75-a214-3c7831a4ff13

📥 Commits

Reviewing files that changed from the base of the PR and between 25a29f6 and fb062e3.

📒 Files selected for processing (7)

.github/CHANGELOG_CONTRIBUTOR_CHECKLIST.md
.github/custom-instructions.md
.github/projects/README.md
.github/projects/active/README.md
.github/reports/footer-audit-2026-08-04.json
.remember/phase-3.2-continuation-prompt.md
eslint.config.cjs

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands.}

github-actions · 2026-08-05T09:08:17Z

✅ Template check passed after update. Thanks for fixing the PR description.

github-actions · 2026-08-05T09:08:48Z

📄 README Validation

✅ All README checks passed.

Check	Result
✅ Frontmatter	Passed
✅ Structure	Passed

github-actions · 2026-08-05T09:09:03Z

⏱️ Aging and SLA annotation

Age: 0 day(s)
SLA state: Within SLA
Thresholds: warn at 7 days, breach at 14 days
Last updated: 2026-08-05T09:14:52.790Z

Maintained by project-meta-sync workflow.

github-actions · 2026-08-05T09:09:27Z

🔍 Reviewer Summary for PR #1581

CI Status: ✅ success
Files changed: 7
Risk Distribution: 0 critical, 5 high, 0 medium, 2 low

Recommendations

Ready to proceed pending human review

mergify · 2026-08-05T09:14:42Z

Tick the box to add this pull request to the merge queue (same as @mergifyio queue).

Queue this pull request

Fixes frontmatter validation error. README files must use file_type: readme per frontmatter schema requirements.

Copilot

Pull request overview

This PR advances Phase 3D of the repo restructuring by standardising “active project” references to .github/projects/active/, updating governance documentation, and adjusting tooling/config to align with the enforced placement rules.

Changes:

Update lint/config and report metadata to reference .github/projects/active/** instead of projects/active/**.
Refresh project governance docs, including a v2.0 “Active Projects Index” at .github/projects/active/README.md.
Fix several documentation references to the new project paths (with one remaining broken-relative-link issue noted in review comments).

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
`eslint.config.cjs`	Updates ESLint ignore path to the enforced `.github/projects/active/**` location.
`.remember/phase-3.2-continuation-prompt.md`	Updates the documented directory tree to reflect `.github/projects/active/`.
`.github/reports/footer-audit-2026-08-04.json`	Rewrites stored file paths to point at `.github/projects/active/...`.
`.github/projects/README.md`	Updates a reference to the active projects location.
`.github/projects/active/README.md`	Expands and restructures the Active Projects Index (v2.0) with governance rules and categorisation.
`.github/custom-instructions.md`	Updates audit-report links (currently uses an incorrect relative prefix from within `.github/`).
`.github/CHANGELOG_CONTRIBUTOR_CHECKLIST.md`	Corrects relative links to changelog hardening project docs under `.github/projects/active/`.

Suppressed comments (2)

.github/custom-instructions.md:39

This link uses ./.github/projects/... but .github/custom-instructions.md is already inside .github/, so it will not resolve correctly. It should be ./projects/....

- **Phase 1B Audit** — 25 core schema files across 3 locations; consolidation plan documented
  - Report: [SCHEMA_AUDIT_REPORT.md](./.github/projects/active/repo-restructuring-2026-07-25/SCHEMA_AUDIT_REPORT.md)
  - Canonical location: `.schemas/` (hidden folder at root)

.github/custom-instructions.md:44

This link uses ./.github/projects/... but .github/custom-instructions.md is already inside .github/, so it will not resolve correctly. It should be ./projects/....

- **Phase 1C Audit** — 35 agents (19 spec-based, 16 multi-file); 788+ references mapped
  - Report: [AGENT-AUDIT-COMPREHENSIVE.md](./.github/projects/active/repo-restructuring-2026-07-25/AGENT-AUDIT-COMPREHENSIVE.md)
  - Portable multi-file agents: `agents/` (root)

 - **Phase 1A Audit** — 58 instruction files (27 portable, 17 repo-local, 15 archived); 502+ references mapped
-  - Report: [INSTRUCTION_FILES_AUDIT_2026-08-05.md](./projects/active/repo-restructuring-2026-07-25/INSTRUCTION_FILES_AUDIT_2026-08-05.md)
+  - Report: [INSTRUCTION_FILES_AUDIT_2026-08-05.md](./.github/projects/active/repo-restructuring-2026-07-25/INSTRUCTION_FILES_AUDIT_2026-08-05.md)
  - Portable instructions belong in root `instructions/` directory


- .github/custom-instructions.md: Fix 3 broken audit report links (Phase 1A, 1B, 1C) - Change ./.github/projects/... to ./projects/... (file already in .github/) - instructions/multi-provider-compatibility.instructions.md: Fix playwright-testing-agent links - Change ../.github/agents/playwright-testing-agent/ to ../agents/playwright-testing-agent/ - instructions/agent-creation-workflow.instructions.md: Fix playwright-testing-agent reference - Change ../.github/agents/playwright-testing-agent/AGENT.md to ../agents/playwright-testing-agent/AGENT.md Addresses PR #1581 & #1583 Copilot review feedback (6 of 12 fixes). Relates to #1593 Phase 3 Copilot Review Fixes.

* docs: Phase 1-3 completion documentation Phases 1-3 of Repository Restructuring Initiative now complete (100%): **Phase 1 Complete:** - Agent consolidation to root agents/ (16 portable agents) - GitHub-native agents in .github/agents/ (19 spec-based) - Two-tier architecture implemented - File type frontmatter added to 64 files - PRs merged: #1537, #1603 **Phase 2 Complete:** - 117 portable scripts migrated to root scripts/ - Path references updated across 26 files - 1,120+ tests passing, 0 regressions - Phase 2C.X remediation complete - Issues closed: #1461, #1464, #1465 - PRs merged: #1504, #1518, #1528 **Phase 3 Complete:** - Phase 3A: 27 instruction files to root instructions/ (502+ refs) - Phase 3C: Two-tier agent structure (788+ refs, 35 agents) - Phase 3D: Reports consolidated in .github/reports/ - Issues closed: #1543, #1544 - PRs merged: #1582, #1583, #1581 **Updates:** - Created COMPLETION_REPORT_PHASES_1-3.md - Updated INDEX.md with completion status - Created issue #1623 (milestone) Total impact: 1,290+ references updated, 179+ files migrated, 1,120+ tests passing Closes #1290 (epic merged earlier), references #1461, #1464, #1465, #1543, #1544 Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com> * docs: update PROJECT_INDEX with Phase 1 & 2 completion status --------- Co-authored-by: Claude Haiku 4.5 <noreply@anthropic.com>

* docs: add CHANGELOG entries for PR #1533 (agent consolidation and file_type fixes) * docs: Add Phase 1-3 Completion Report (#1624) * docs: Phase 1-3 completion documentation Phases 1-3 of Repository Restructuring Initiative now complete (100%): **Phase 1 Complete:** - Agent consolidation to root agents/ (16 portable agents) - GitHub-native agents in .github/agents/ (19 spec-based) - Two-tier architecture implemented - File type frontmatter added to 64 files - PRs merged: #1537, #1603 **Phase 2 Complete:** - 117 portable scripts migrated to root scripts/ - Path references updated across 26 files - 1,120+ tests passing, 0 regressions - Phase 2C.X remediation complete - Issues closed: #1461, #1464, #1465 - PRs merged: #1504, #1518, #1528 **Phase 3 Complete:** - Phase 3A: 27 instruction files to root instructions/ (502+ refs) - Phase 3C: Two-tier agent structure (788+ refs, 35 agents) - Phase 3D: Reports consolidated in .github/reports/ - Issues closed: #1543, #1544 - PRs merged: #1582, #1583, #1581 **Updates:** - Created COMPLETION_REPORT_PHASES_1-3.md - Updated INDEX.md with completion status - Created issue #1623 (milestone) Total impact: 1,290+ references updated, 179+ files migrated, 1,120+ tests passing Closes #1290 (epic merged earlier), references #1461, #1464, #1465, #1543, #1544 Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com> * docs: update PROJECT_INDEX with Phase 1 & 2 completion status --------- Co-authored-by: Claude Haiku 4.5 <noreply@anthropic.com> * fix: Final CHANGELOG schema compliance push (21 → 2 violations) - Aggressively shortened all remaining problematic entries - Eliminated long descriptions and multi-sentence violations - Reduced from 61 violations to final 2 Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com> * fix: Eliminate all CHANGELOG schema violations (61 → 0) - Reduced version numbers from descriptions to avoid decimal-point parsing conflicts - All 75 entries now validate against schema constraints - 0 errors, 0 warnings, 100% compliance Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com> * docs: Add missing CHANGELOG entries for Phase 1-3 completion (PRs #1609–#1624) Added comprehensive changelog entries for recently merged PRs: - PR #1613: Phase 3 label validation enforcement (script + workflow) - PR #1624: Phase 1–3 completion documentation report - PR #1611: Label creation governance in CLAUDE.md and AGENTS.md - PR #1610: Fixed Copilot review feedback on audit reports - PR #1609: Phase 1 critical fixes (badges + release workflow) Also added Phase 4 documentation entries for LABELING.md updates, LABELING_FAQ.md, and LABELING_EXAMPLES.md. Updated frontmatter last_updated to 2026-08-07. Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com> * docs: Expand label prefix enforcement planning documentation with 3 new guides Added comprehensive expanded planning documentation to the label-prefix-enforcement project folder: - IMPLEMENTATION_GUIDE.md (165 lines): Step-by-step procedures for executing all 5 phases with detailed checklists, validation steps, and success criteria for each phase (Phase 1–5). - RISK_MITIGATION.md (153 lines): Comprehensive risk assessment identifying critical (2), high (4), and medium (6) risks with specific mitigation strategies, contingency procedures, and escalation paths for each phase. - TESTING_VALIDATION.md (233 lines): Complete testing procedures covering unit tests, integration tests, regression testing, documentation accuracy, and team knowledge assessment with detailed test cases and pass criteria. Updated README.md to reference new documents in Quick Links table and bumped version to 1.1.0. Total expanded documentation: 1,601 lines, 48KB across 6 files, providing comprehensive planning guidance for Phase 1–5 execution. See: .github/projects/active/label-prefix-enforcement-2026-08-05/ Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com> * fix: Correct frontmatter file_type and field names for schema compliance --------- Co-authored-by: Claude Haiku 4.5 <noreply@anthropic.com>

ashleyshaw added status:needs-review Awaiting code review area:infrastructure Infrastructure / hosting / platform type:chore Chore / small hygiene change labels Aug 5, 2026

ashleyshaw self-assigned this Aug 5, 2026

fix: Update README file_type from index to readme

fb062e3

Fixes frontmatter validation error. README files must use file_type: readme per frontmatter schema requirements.

ashleyshaw requested a lite review from Copilot August 5, 2026 09:19

ashleyshaw merged commit 5bbe023 into develop Aug 5, 2026
26 of 33 checks passed

ashleyshaw deleted the refactor/phase-3d-reports-consolidation branch August 5, 2026 09:19

Copilot started reviewing on behalf of ashleyshaw August 5, 2026 09:19 View session

Copilot AI reviewed Aug 5, 2026

View reviewed changes

This was referenced Aug 7, 2026

Phase 3D: Reports placement enforcement and consolidation #1544

Closed

MILESTONE: Repository Restructuring Phases 1-3 Complete #1623

Open

ashleyshaw mentioned this pull request Aug 7, 2026

docs: Add Phase 3 restructuring and major PRs to CHANGELOG (27 missing entries) #1630

Merged

6 tasks

Navigation Menu

Uh oh!

refactor: Phase 3D - Reports Placement Enforcement - #1581

refactor: Phase 3D - Reports Placement Enforcement#1581
ashleyshaw merged 2 commits into
developfrom
refactor/phase-3d-reports-consolidation

ashleyshaw commented Aug 5, 2026 •

edited

Loading

Uh oh!

coderabbitai Bot commented Aug 5, 2026 •

edited

Loading

Review limit reached

Uh oh!

github-actions Bot commented Aug 5, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Aug 5, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Aug 5, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Aug 5, 2026

Uh oh!

mergify Bot commented Aug 5, 2026

Uh oh!

Uh oh!

Copilot AI left a comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

ashleyshaw commented Aug 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Linked issues

Changes

Changelog

Added

Changed

Fixed

Verification

Risk & Rollback

Checklist (Global DoD / PR)

Uh oh!

coderabbitai Bot commented Aug 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Review limit reached

Uh oh!

github-actions Bot commented Aug 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Aug 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

📄 README Validation

Uh oh!

github-actions Bot commented Aug 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

⏱️ Aging and SLA annotation

Uh oh!

github-actions Bot commented Aug 5, 2026

🔍 Reviewer Summary for PR #1581

Recommendations

Uh oh!

mergify Bot commented Aug 5, 2026

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

ashleyshaw commented Aug 5, 2026 •

edited

Loading

coderabbitai Bot commented Aug 5, 2026 •

edited

Loading

github-actions Bot commented Aug 5, 2026 •

edited

Loading

github-actions Bot commented Aug 5, 2026 •

edited

Loading

github-actions Bot commented Aug 5, 2026 •

edited

Loading