Repository navigation
Description
Phase 3D: Reports Placement Enforcement and Consolidation
Epic: Repository Restructuring Initiative
Depends on: #1295 (Phase 2) ✅, #1542 (Phase 3B) ✅
Parallel with: #1535 (Phase 3A), #1543 (Phase 3C)
Type: Phase 3 sub-task (reports consolidation)
Priority: High
Overview
Phase 2 completed migration of reports and project artifacts to .github/projects/active/. Phase 3D enforces the new structure with proper documentation, validation, and cross-referencing.
Status: Ready to execute
Estimated effort: 2–3 hours
Timeline: Execute in parallel with Phase 3A & 3C
Tasks
Task 1: Verify Reports Location Consolidation
Confirm all active project reports are in .github/projects/active/{slug}/:
Key projects to verify:
- repo-restructuring-2026-07-25/ (Phase 1–3 audit reports)
- template-enforcement-governance/
- release-wf-fix/ (release workflow monitoring)
- issue-type-workflow-automation/
- Any other active projects
Actions:
- List all directories in
.github/projects/active/ - Verify each has proper README and index files
- Check no reports remain in root
projects/directory (should be empty) - Update CLAUDE.md "Active projects note" with current list
Task 2: Update All References to Reports
Batch update references across codebase:
P0 Critical (10–15 refs):
- CLAUDE.md (Path Reference section)
- AGENTS.md (Related Documentation)
- docs/ folder README files
- .github/projects/active/README (if exists)
P1 High (20–30 refs):
- Issue templates that reference project paths
- Workflow files that link to reports
- Custom instructions in .github/custom-instructions.md
- Documentation standards files
P2 Medium (10–20 refs):
- Comments in code mentioning report paths
- Script documentation
- Examples and cookbooks
Task 3: Documentation & Governance Update
Actions:
- Create/update
.github/projects/active/README.md(index of all active projects) - Add "Active Projects Index" section to CLAUDE.md
- Document project lifecycle (active → archived → deleted)
- Update AGENTS.md "Related Documentation" with project links
- Verify all audit reports linked from governance docs
Content to create:
# Active Projects Index
## Phase 1–3: Repository Restructuring
- [repo-restructuring-2026-07-25/] — Phase 1 audits, Phase 2 governance, Phase 3 migration
## Release Management
- [release-wf-fix/] — Post-v2.0.0 release workflow monitoring
## Governance & Standards
- [template-enforcement-governance/] — Issue/PR template standards
- [issue-type-workflow-automation/] — Issue type automation
...Task 4: Validation & Enforcement
Actions:
- Add validation script to ensure projects only exist in
.github/projects/active/ - Create pre-commit hook to prevent root
projects/directory creation - Document project creation process in contribution guides
- Verify no stale references to old project paths
Validation commands:
# Check for root projects/ directory (should not exist)
test ! -d projects/ && echo "✓ No root projects/ dir" || echo "✗ Found root projects/"
# Count active projects
ls -1 .github/projects/active/ | wc -l
# Find any remaining references to root projects/
grep -r "projects/active/" --include="*.md" --include="*.yml" | grep -v ".github/projects"Success Criteria (DoD)
- All active projects verified in
.github/projects/active/only - All references updated (50+ docs across codebase)
- No references remain to root
projects/directory - Project index created and documented
- CLAUDE.md active projects note updated
- Validation script created (if needed)
- All files pass linting
- PR created, reviewed, merged to develop
- Link this issue in commit/PR for traceability
Related Issues
- Repository Structure Realignment Initiative #1290 — Repository restructuring epic
- docs: Phase 2 governance updates with Phase 1 audit findings (#1295) #1534 — Phase 2: Governance ✅ MERGED
- task: documentation - migrate files and update references #1535 — Phase 3A: Instructions migration
- Phase 3B: Schema consolidation completion & path consistency #1542 — Phase 3B: Schema consolidation ✅ COMPLETE
- Phase 3C: Agent reorganization and migration #1543 — Phase 3C: Agent reorganization
Fastest Phase 3 sub-task: 2–3 hour timeline
Metadata
Metadata
Assignees
Labels
Type
Fields
Priority
Activity
linear-code commentedon Aug 5, 2026
LS-2282
github-actions commentedon Aug 5, 2026
Missing required section(s): Definition of Ready (DoR), Definition of Done (DoD)
The issue will remain open and flagged until the body is corrected.
Please update the issue with one of the official templates:
If this was opened by automation, update the automation to preserve the template sections before creating the issue.
github-actions commentedon Aug 5, 2026
⏱️ Aging and SLA annotation
Maintained by project-meta-sync workflow.
ashleyshaw commentedon Aug 7, 2026
✅ COMPLETE: Phase 3D Reports Placement Enforcement merged (PR #1581). Reports properly placed in .github/reports/ and .github/projects/active/. Consolidation complete.
feat: Phase 3 label validation enforcement (#1613)
docs: Add Phase 1-3 Completion Report (#1624)
feat: Phase 3 label validation enforcement (#1613)
docs: Add Phase 1-3 Completion Report (#1624)
docs: Add Phase 1-3 Completion Report (#1624)
docs: Add Phase 1 implementation plan and project documentation (#1612)