Uh oh!
There was an error while loading. Please reload this page.
Phase 2: Reports folder structure & project linking - #1752
Merged
Conversation
Add detailed step-by-step execution guide for Phase 2 work including: - Complete file categorization map for all 106 reports - Bash commands for reports migration - Project linking instructions for all 31 projects - PR template with full description - Success criteria and timeline Enables immediate Phase 2 execution on next session. Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
Reorganize .github/reports/ from flat structure into active/archive with proper categorization of all 118 reports. Archive subfolders: - archive/weekly-summaries/: 25 weekly reports - archive/deprecated-audits/: 10 old audits - archive/workflow-artifacts/: 3 branch cleanup reports - archive/a11y-completed/: 4 accessibility reports - archive/historical/: 2 migration guides Active: 73 currently referenced reports Resolves Phase 2 folder organization per audit results. Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
Add 'Related Issues' section to all 31 active project READMEs using bidirectional linking standard established in Phase 1. **Special Links:** - openspec: #1733, #1739-1742 (agent-tool-permission-alignment) - markdown-audit-ci-optimization: #1733, #1737 All other projects: #1733 (Phase 2: Folder Structure & Linking) Enables coordination between projects and GitHub issues per Phase 2 plan. Resolves#1733, #1736, #1737 Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
Contributor
Important Review skippedToo many files! This PR contains 134 files, which is 34 over the limit of 100. To get a review, reduce the PR to 100 files or fewer by splitting it into smaller PRs or changing its base branch. Upgrade to a paid plan to raise the limit. This review couldn't start because sufficient usage credits or metered capacity aren't available. Add credits or update usage-based reviews in the billing tab, then retry. ⚙️ Run configurationConfiguration used: Repository YAML (base), Organization UI (inherited) Review profile: CHILL Plan: Pro Plus Run ID: ⛔ Files ignored due to path filters (7)
📒 Files selected for processing (134)
You can disable this status message by setting the 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. Comment |
Contributor
✅ Template check passed after update. Thanks for fixing the PR description. |
Contributor
⏱️ Aging and SLA annotation
Maintained by project-meta-sync workflow. |
Contributor
📄 README Validation❌ One or more README checks failed.
|
Contributor
🔍 Reviewer Summary for PR #1752CI Status: ❌ Recommendations
|
Contributor
🎨 Mermaid Diagram Validation✅ All Mermaid diagram checks passed.
|
Contributor
There was a problem hiding this comment.
Pull request overview
This PR is Phase 2 of the Reports & Projects restructuring, moving report artefacts into a new .github/reports/active/ and .github/reports/archive/ layout and adding “Related Issues” linking to project READMEs to support bidirectional project↔issue navigation.
Changes:
- Added new archived report artefacts (weekly summaries, audits, workflow artefacts, a11y spreadsheets) under
.github/reports/archive/*. - Added/relocated “active” reports under
.github/reports/active/. - Appended “Related Issues” sections to multiple
.github/projects/active/*/README.mdfiles (including OpenSpec and markdown-audit-ci-optimisation).
Reviewed changes
Copilot reviewed 24 out of 141 changed files in this pull request and generated 4 comments.
Show a summary per file
| File | Description |
|---|---|
| .github/reports/archive/workflow-artifacts/branch-cleanup-2026-07-25T08-20-01.md | Archived branch-cleanup dry-run report. |
| .github/reports/archive/workflow-artifacts/branch-cleanup-2026-07-23T16-44-03.md | Archived branch-cleanup dry-run report. |
| .github/reports/archive/workflow-artifacts/branch-cleanup-2026-07-22T18-01-32.md | Archived branch-cleanup dry-run report. |
| .github/reports/archive/weekly-summaries/weekly-summary-2026-06-01.md | Archived weekly summary report (includes structure + references). |
| .github/reports/archive/weekly-summaries/weekly-summary-2026-05-25.md | Archived weekly summary frontmatter stub. |
| .github/reports/archive/weekly-summaries/weekly-summary-2026-05-18.md | Archived weekly summary frontmatter stub. |
| .github/reports/archive/weekly-summaries/weekly-summary-2026-05-11.md | Archived weekly summary frontmatter stub. |
| .github/reports/archive/weekly-summaries/weekly-summary-2026-05-04.md | Archived weekly summary frontmatter stub. |
| .github/reports/archive/weekly-summaries/weekly-summary-2026-04-27.md | Archived weekly summary frontmatter stub. |
| .github/reports/archive/weekly-summaries/weekly-summary-2026-04-20.md | Archived weekly summary frontmatter stub. |
| .github/reports/archive/weekly-summaries/weekly-summary-2026-04-13.md | Archived weekly summary frontmatter stub. |
| .github/reports/archive/weekly-summaries/weekly-summary-2026-04-06.md | Archived weekly summary frontmatter stub. |
| .github/reports/archive/weekly-summaries/weekly-summary-2026-03-30.md | Archived weekly summary frontmatter stub. |
| .github/reports/archive/weekly-summaries/weekly-summary-2026-03-23.md | Archived weekly summary frontmatter stub. |
| .github/reports/archive/weekly-summaries/weekly-summary-2026-03-16.md | Archived weekly summary frontmatter stub. |
| .github/reports/archive/weekly-summaries/weekly-summary-2026-03-09.md | Archived weekly summary frontmatter stub. |
| .github/reports/archive/weekly-summaries/weekly-summary-2026-03-02.md | Archived weekly summary frontmatter stub. |
| .github/reports/archive/weekly-summaries/weekly-summary-2026-02-23.md | Archived weekly summary frontmatter stub. |
| .github/reports/archive/weekly-summaries/weekly-summary-2026-02-16.md | Archived weekly summary frontmatter stub. |
| .github/reports/archive/weekly-summaries/weekly-summary-2026-02-09.md | Archived weekly summary frontmatter stub. |
| .github/reports/archive/weekly-summaries/weekly-summary-2026-02-02.md | Archived weekly summary frontmatter stub. |
| .github/reports/archive/weekly-summaries/weekly-summary-2026-01-26.md | Archived weekly summary frontmatter stub. |
| .github/reports/archive/weekly-summaries/weekly-summary-2026-01-19.md | Archived weekly summary frontmatter stub. |
| .github/reports/archive/weekly-summaries/weekly-summary-2026-01-12.md | Archived weekly summary frontmatter stub. |
| .github/reports/archive/weekly-summaries/weekly-summary-2026-01-05.md | Archived weekly summary frontmatter stub. |
| .github/reports/archive/weekly-summaries/weekly-summary-2025-12-29.md | Archived weekly summary frontmatter stub. |
| .github/reports/archive/weekly-summaries/weekly-summary-2025-12-22.md | Archived weekly summary frontmatter stub. |
| .github/reports/archive/weekly-summaries/weekly-summary-2025-12-15.md | Archived weekly summary frontmatter stub. |
| .github/reports/archive/historical/changelog-workflow-fix.md | Archived historical write-up of a changelog workflow fix. |
| .github/reports/archive/deprecated-audits/2026-06-07-private-project-issue-field-write-verification-879.md | Archived audit/verification record for project-meta-sync boundaries. |
| .github/reports/archive/deprecated-audits/2026-06-03-labeling-docs-consolidation-audit-664.md | Archived audit report about labelling documentation consolidation. |
| .github/reports/archive/deprecated-audits/2026-06-03-issue-template-inventory-standardization-audit-654.md | Archived audit of issue template inventory and alignment. |
| .github/reports/archive/deprecated-audits/2026-06-03-issue-template-automation-trigger-mapping-audit-655.md | Archived audit of issue template → automation trigger mapping. |
| .github/reports/archive/deprecated-audits/2026-06-03-issue-labeling-rules-in-labeler-audit-656.md | Archived audit of issue labelling coverage in labeler rules. |
| .github/reports/archive/deprecated-audits/2026-06-03-issue-fields-config-vs-github-api-audit-660.md | Archived audit of issue fields config vs GitHub API constraints. |
| .github/reports/archive/deprecated-audits/2026-06-03-file-organisation-vs-claude-boundaries-audit-671.md | Archived audit of file organisation vs documented boundaries. |
| .github/reports/archive/deprecated-audits/2026-06-03-file-organisation-migration-plan-673.md | Archived migration plan report (includes Mermaid diagrams). |
| .github/reports/archive/deprecated-audits/2026-06-03-docs-folder-structure-vs-claude-boundaries-audit-665.md | Archived audit of docs folder structure vs boundaries. |
| .github/reports/archive/deprecated-audits/2026-06-03-agent-script-migration-status-audit-672.md | Archived audit of agent/script migration status. |
| .github/reports/archive/a11y-completed/mermaid-diagram-audit-spreadsheet.csv | Archived Mermaid diagram validation spreadsheet. |
| .github/reports/archive/a11y-completed/mermaid-diagram-accessibility-spreadsheet.csv | Archived Mermaid accessibility compliance spreadsheet. |
| .github/reports/active/weekly-summary-2025-12-08.md | Active weekly summary frontmatter stub. |
| .github/reports/active/wave-4c-audit-report.md | Active Wave 4C audit report content. |
| .github/reports/active/SKILLS_POPULARITY_MATRIX.csv | Active skills usage/popularity matrix (CSV). |
| .github/reports/active/SKILLS_AUDIT_2026-07-23.md | Active skills audit report content. |
| .github/reports/active/reports-folder-structure-audit-2025-12-10.md | Active report about prior reports folder structure audit. |
| .github/reports/active/mermaid-diagram-audit.md | Active Mermaid syntax audit write-up. |
| .github/reports/active/issues-prs-300plus-metadata.csv | Active metadata extract CSV for issues/PRs. |
| .github/reports/active/issue-pr-metadata-audit-300plus-2026-05-27.md | Active audit stub for issue/PR metadata. |
| .github/reports/active/issue-95-orphan-labels-audit-2026-05-27.md | Active labels audit frontmatter. |
| .github/reports/active/issue-32-closeout-comments-2026-05-26.md | Active prepared closeout comments document. |
| .github/reports/active/governance-change-management-audit-2026-05-27.md | Active governance change-management audit frontmatter. |
| .github/reports/active/governance-change-management-audit-2026-05-19.md | Active governance change-management audit frontmatter (variant). |
| .github/reports/active/footer-injection-2026-08-04.json | Active JSON output from footer injection run. |
| .github/reports/active/findings.csv | Active Mermaid findings CSV. |
| .github/reports/active/file-organization-migration-2025-12-09.md | Active write-up of prior file organisation migration. |
| .github/reports/active/colour-contrast-report-2026-06-18.md | Active Mermaid colour contrast report. |
| .github/reports/active/changelog-keepachangelog-audit-2026-07-29.md | Active Keep a Changelog conformance audit report. |
| .github/reports/active/audit-report-2026-05-28.md | Active Wave 3A README/Mermaid audit report. |
| .github/reports/active/2026-08-04-status-needs-review-audit.md | Active audit of status:needs-review issues. |
| .github/reports/active/2026-08-04-script-organization-concern.md | Active report documenting script organisation concern. |
| .github/reports/active/2026-08-04-release-workflow-fix-summary.md | Active executive summary for release workflow fix. |
| .github/reports/active/2026-08-04-issue-tracking.md | Active tracking doc linking release workflow testing issues. |
| .github/reports/active/2026-08-04-issue-1486-cleanup-progress.md | Active progress report for infra cleanup issue. |
| .github/reports/active/2026-08-04-eslint-fix-specification.md | Active linting fix specification report. |
| .github/projects/active/wave-5-documentation-audit/README.md | Project README updated with Related Issues section. |
| .github/projects/active/test-coverage-implementation/README.md | Project README updated with Related Issues section. |
| .github/projects/active/template-enforcement-governance/README.md | Project README updated with Related Issues section. |
| .github/projects/active/repository-restructuring-phase-1/README.md | Project README updated with Related Issues section. |
| .github/projects/active/repo-restructuring-2026-07-25/README.md | Project README updated with Related Issues section. |
| .github/projects/active/release-workflow-authorization-fixes/README.md | Project README updated with Related Issues section. |
| .github/projects/active/release-process-redesign-2026-08-05/README.md | Project README updated with Related Issues section. |
| .github/projects/active/prd-combined-agent/README.md | Project README updated with Related Issues section. |
| .github/projects/active/pr-review-project-planning-2026-08-04/README.md | Project README updated with Related Issues section. |
| .github/projects/active/openspec/README.md | Project README updated with Related Issues section. |
| .github/projects/active/nodejs-upgrade-2026-q3/README.md | Project README updated with Related Issues section. |
| .github/projects/active/nodejs-upgrade-2026-q3-post-merge-monitoring/README.md | Project README updated with Related Issues section. |
| .github/projects/active/milestone-planning-v1/README.md | Project README updated with Related Issues section. |
| .github/projects/active/markdown-audit-ci-optimization/README.md | Project README updated with Related Issues section (issue-linked project). |
| .github/projects/active/label-prefix-enforcement-2026-08-05/README.md | Project README updated with Related Issues section. |
| .github/projects/active/label-prefix-audit-2026-08-05/README.md | Project README updated with Related Issues section. |
| .github/projects/active/issue-type-workflow-automation/README.md | Project README updated with Related Issues section. |
| .github/projects/active/issue-triage-automation-system/README.md | Project README updated with Related Issues section. |
| .github/projects/active/issue-metadata-triage-expansion/README.md | Project README updated with Related Issues section. |
| .github/projects/active/github-projects-creation-system/README.md | Project README updated with Related Issues section. |
| .github/projects/active/changelog-automation-hardening/README.md | Project README updated with Related Issues section. |
| .github/projects/active/agent-standards-initiative/README.md | Project README updated with Related Issues section. |
| .github/projects/active/agent-skills-standards-comprehensive/README.md | Project README updated with Related Issues section. |
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
Comment on lines
64
to
+72
| *Built by 🧱 LightSpeedWP with ☕, 🚀, and open-source spirit!* | ||
| ## Related Issues | ||
| This project is coordinated with: | ||
| - [#1733](https://github.com/lightspeedwp/.github/issues/1733) — Phase 2: Folder Structure & Linking | ||
| See [Linking Standard](https://github.com/lightspeedwp/.github/blob/develop/.github/projects/active/reports-projects-restructuring-2026-08-11/LINKING_STANDARD.md) for linking patterns. |
| - [#1741](https://github.com/lightspeedwp/.github/issues/1741) — OpenSpec: Specification Tracking Model | ||
| - [#1742](https://github.com/lightspeedwp/.github/issues/1742) — OpenSpec: GitHub Issue Coordination | ||
| See [Linking Standard](https://github.com/lightspeedwp/.github/blob/develop/.github/projects/active/reports-projects-restructuring-2026-08-11/LINKING_STANDARD.md) for linking patterns. |
Comment on lines
+72
to
+74
| - [#1733](https://github.com/lightspeedwp/.github/issues/1733) — Phase 2: Folder Structure & Linking | ||
| See [Linking Standard](https://github.com/lightspeedwp/.github/blob/develop/.github/projects/active/reports-projects-restructuring-2026-08-11/LINKING_STANDARD.md) for linking patterns. |
| - [#1733](https://github.com/lightspeedwp/.github/issues/1733) — Phase 2: Folder Structure & Linking | ||
| - [#1737](https://github.com/lightspeedwp/.github/issues/1737) — Phase 2: Link markdown-audit-ci-optimization | ||
| See [Linking Standard](https://github.com/lightspeedwp/.github/blob/develop/.github/projects/active/reports-projects-restructuring-2026-08-11/LINKING_STANDARD.md) for linking patterns. |
This was referenced Aug 11, 2026
ashleyshaw added a commit
that referenced
this pull request
Aug 12, 2026
Final cleanup and documentation for the Reports & Projects Restructuring initiative. ## Changes **Cleanup:** - Archived 5 stub files from .github/reports/active/ to archive/deprecated-audits/ **Documentation:** - Create .github/reports/README.md with folder lifecycle policy - Publish PROJECT_ISSUE_LINKING_STANDARD.md to docs/ - Update CLAUDE.md with reports folder structure reference - Update project README with Phase 4 completion status (all phases now ✅ complete) ## Summary ✅ Phase 1 (2026-08-11): Audit & Planning → PR #1730 merged ✅ Phase 2 (2026-08-11): Folder Structure & Linking → PR #1752 merged ✅ Phase 3 (2026-08-11): Archive Workflow & CI Validation → PR #1767 merged ✅ Phase 4 (2026-08-12): Cleanup & Documentation → Complete Reports and projects fully restructured, linked, and validated. Resolves#1735 Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Phase 2 of Reports & Projects Restructuring: reorganize 118 reports into
structured active/archive folders and establish bidirectional project-to-issue
linking for all 31 projects.
Linked issues
Changes
Reports Reorganization
.github/reports/active/for actively referenced reports (73 files).github/reports/archive/with 5 subcategories:weekly-summaries/— 25 archived weekly summariesdeprecated-audits/— 10 superseded audit reportsworkflow-artifacts/— 3 release automation artifactsa11y-completed/— 4 accessibility audit reportshistorical/— 2 pre-restructuring migration guidesProject Linking
Validation
✅ All 118 reports migrated (0 orphaned in root except README.md)
✅ All 31 projects have ≥1 linked issue
✅ Bidirectional linking established
✅ Archive subcategories match audit recommendations
Changelog
Changed
Added
Checklist (Global DoD / PR)
🤖 Generated with Claude Code