Skip to content

Complete PR #1534 governance feedback - content reconciliation #1597

Closed

Description

@ashleyshaw

Follow-up to PR #1534 merge. Remaining CodeRabbit items requiring content updates:

Outstanding Items (4 issues):

  1. Reconcile audit inventory counts (INSTRUCTION_FILES_AUDIT lines 12-20)

    • Align summary totals with detailed breakdowns
    • Define whether archived files are nested or disjoint
    • Update percentages to match definition
  2. Align schema count (SCHEMA_AUDIT_REPORT lines 11-16)

    • Core schemas: currently 23 in .schemas/
    • Define completeness criteria
    • Note missing files (agent-config.example.md, examples/)
  3. Update migration matrix paths (SCHEMA_AUDIT_REPORT lines 255-263)

    • Ensure consistent path references
    • Align status with surrounding rows
  4. Reconcile agent totals (CLAUDE.md/AGENTS.md/.github/custom-instructions.md)

    • Verify total: 19 spec-based + 16 multi-file agents
    • Update all three documents consistently

Related Issue

Linked to PR #1534 review feedback: #1534

Priority

Medium - Governance documentation accuracy


Definition of Ready (DoR)

  • Clear problem statement and expected outcome
  • Acceptance criteria defined
  • Related issues/dependencies identified
  • Required resources/approvals listed

Definition of Done (DoD)

  • All acceptance criteria met
  • Changes tested and validated
  • Documentation updated
  • Changes merged and deployed
  • Stakeholders notified

Activity

  1. linear-code commented on Aug 5, 2026

    @linear-code
  2. self-assigned this
    on Aug 7, 2026
  3. github-actions commented on Aug 9, 2026

    @github-actions
    Contributor

    ⏱️ Aging and SLA annotation

    • Age: 6 day(s)
    • SLA state: Within SLA
    • Thresholds: warn at 7 days, breach at 14 days
    • Last updated: 2026-08-11T15:17:29.327Z

    Maintained by project-meta-sync workflow.

  4. ashleyshaw commented on Aug 11, 2026

    @ashleyshaw
    MemberAuthor

    Reconciliation Complete ✅

    All governance feedback items from PR #1534 have been reconciled and corrected:

    Fixed Issues:

    1. Instruction Files Audit Count ✅

    • Updated line 30: "58 (44 active + 14 archived)"
    • Updated line 34: "14 files (23%, stored separately in archive)"
    • Both counts now consistent: 44 active + 14 archived = 58 total

    2. Schema Count Completeness ✅

    • Added clarification: "Completeness Definition: A location is considered complete when it contains all 25 core portable schemas"
    • Marked .schemas/ as INCOMPLETE (pending Phase 3 migration for agent-config.example.md and examples/)
    • Clarified migration status for missing files

    3. Agent Totals ✅

    • Fixed AGENTS.md: Changed "37 agents catalogued" to "35 agents catalogued"
    • Maintains consistency: 19 spec-based + 16 multi-file = 35 total
    • Now matches CLAUDE.md reference

    Files Updated:

    • .github/projects/active/repo-restructuring-2026-07-25/INSTRUCTION_FILES_AUDIT_2026-08-05.md
    • .github/projects/active/repo-restructuring-2026-07-25/SCHEMA_AUDIT_REPORT.md
    • AGENTS.md

    All changes committed to branch claude/github-issues-review-ea4a2f.

  5. added a commit that references this issue on Aug 11, 2026
    fdbc6c2
  6. github-actions commented on Aug 12, 2026

    @github-actions
    Contributor

    ✅ Issue checklists finalised after closure.

  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:ready
    • migrate:type:documentation
    • migrate:area:documentation
    • priority:medium

    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

No type

Fields

Priority

None yet

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions