Skip to content

Phase 3D: Reports placement enforcement and consolidation #1544

Closed

Description

@ashleyshaw

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


Fastest Phase 3 sub-task: 2–3 hour timeline

Activity

  1. linear-code commented on Aug 5, 2026

    @linear-code
  2. github-actions commented on Aug 5, 2026

    @github-actions
    Contributor

    ⚠️ This issue does not follow a required issue template.

    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.

  3. github-actions commented on Aug 5, 2026

    @github-actions
    Contributor

    ⏱️ 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-05T11:31:08.813Z

    Maintained by project-meta-sync workflow.

  4. self-assigned this
    on Aug 5, 2026
  5. added theissue type on Aug 5, 2026
  6. added this to the v1.0 milestone on Aug 5, 2026
  7. ashleyshaw commented on Aug 7, 2026

    @ashleyshaw
    MemberAuthor

    ✅ COMPLETE: Phase 3D Reports Placement Enforcement merged (PR #1581). Reports properly placed in .github/reports/ and .github/projects/active/. Consolidation complete.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Type

Fields

Priority

None yet

Projects

No projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions