Skip to content

Phase 1D: Enforce Reports Placement (.github/reports/) #1294

Closed

Description

@ashleyshaw

Overview

Enforce correct placement of audit/report files in .github/reports/ instead of repository root.

Scope

Misplaced Files (at repo root):

  • CHANGELOG-CONSOLIDATION-AUDIT.md
  • PHASE-2B-SKILLS-AUDIT.md

Target Location: .github/reports/audits/

Related: Audit reports for instructions, schemas, agents, metrics

Definition of Done

  • Move CHANGELOG-CONSOLIDATION-AUDIT.md to .github/reports/audits/
  • Move PHASE-2B-SKILLS-AUDIT.md to .github/reports/audits/
  • Create .github/reports/audits/ directory structure if needed
  • Update any references to old report locations
  • Document report placement guidelines in governance files
  • Add note to CLAUDE.md about correct report placement
  • Verify no reports remain at repo root
  • Update future audit workflows to save to .github/reports/

Related Issues

Effort Estimate

1-2 hours (file moves + reference updates + documentation)

Notes

  • Low effort: Only 2 files to move
  • Cleanup task: Enforce pattern for future audits
  • Priority: Low (can be done quickly, non-blocking)
  • Can be done in parallel with other initiatives

Activity

  1. linear-code commented on Jul 24, 2026

    @linear-code
  2. github-actions commented on Jul 24, 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. added this to the v1.0 milestone on Jul 24, 2026
  4. github-actions commented on Jul 24, 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-07-24T12:29:52.647Z

    Maintained by project-meta-sync workflow.

  5. added theissue type on Jul 24, 2026
  6. ashleyshaw commented on Aug 4, 2026

    @ashleyshaw
    MemberAuthor

    ✅ PHASE 1D COMPLETE

    Audit Results

    2 misplaced files identified:

    1. CHANGELOG-CONSOLIDATION-AUDIT.md (7.2 KB, at repo root)
    2. PHASE-2B-SKILLS-AUDIT.md (67.6 KB, in projects/active/)

    6 documentation references found:

    • docs/MAINTENANCE.md:121
    • projects/active/phase-2b-skills-audit/* (3 files, 5 occurrences)
    • .github/reports/agents/AGENT_SKILLS_INVENTORY.md (1 occurrence)

    Target Location: .github/reports/audits/

    Completion Status

    • ✅ Both audit files located and identified
    • ✅ All 6 documentation references mapped
    • ✅ Target directory structure verified
    • ✅ Date-prefixed naming convention documented (YYYY-MM-DD-{descriptor})
    • ✅ Governance rule confirmed (reports in .github/reports/{category}/)
    • ✅ Non-blocking: Can be done independently

    Next Step: Phase 3D Execution

    Phase 3D reports relocation based on this audit is now complete:

    • Files relocated with proper naming
    • All references updated
    • Governance rules enforced
  7. github-actions commented on Sep 8, 2026

    @github-actions
    Contributor

    ⚠️ Bare Labels Detected

    This issue has labels that are not in the canonical taxonomy:

    • migrate:status:needs-more-info
    • migrate:type:task
    • migrate:area:documentation
    • priority:low
    • status:needs-template-fix

    Valid Canonical Labels

    Please use labels with a prefix from the canonical taxonomy:

    • Type: type:bug, type:feature, type:task, type:documentation, etc.
    • Status: status:needs-triage, status:in-progress, status:done, etc.
    • Priority: priority:critical, priority:high, priority:normal, priority:low
    • Area: area:ci, area:docs, area:labels, area:security, etc.
    • Meta: meta:needs-changelog, meta:duplicate, meta:blocked, etc.

    For the complete list, see .github/labels.yml.

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