Skip to content

task: infrastructure - apply Phase 3A validation fixes #1594

Open

Description

@ashleyshaw

Status Update: Phase 3A Validation Fixes

Status: TRACKING DEFERRED WORK

Current State

Phase 3A PR Status: ✅ MERGED (PR #1582)

  • Commits: 4 commits in PR
  • Work: Instructions migration, file reorganization, 502+ reference updates
  • Status: All merged to develop

Deferred Work (21+ CodeRabbit Issues)

PR #1582 had 21+ CodeRabbit findings that were deferred from validation. These issues were identified but not addressed before merge:

applyTo Pattern Issues (6 files)

  • .github/instructions/template.instructions.md — applyTo pattern targets wrong directory
  • .github/instructions/tools.instructions.md — Fix applyTo pattern
  • .github/instructions/hooks.instructions.md — Fix applyTo pattern
  • .github/instructions/agent-spec.instructions.md — Fix applyTo pattern
  • .github/instructions/prompt.instructions.md — Fix applyTo pattern
  • Additional instruction files with misaligned applyTo patterns

Broken Links & References (10+ files)

  • instructions/saved-replies.instructions.md — Frontmatter + link fixes
  • instructions/reviewer.instructions.md — Frontmatter + link fixes
  • docs/MIGRATION_GUIDE.md — Update references
  • docs/FRONTMATTER_SCHEMA.md — Fix example references
  • .github/instructions/automation.instructions.md — Multiple example fixes
  • .github/instructions/reporting.instructions.md — Example updates
  • .github/instructions/release.instructions.md — Rollback path fixes
  • .github/instructions/meta.instructions.md — Required structure/content
  • .github/instructions/workflows.instructions.md — Required structure/content
  • Multiple archived files with broken references

Frontmatter Validation Issues

  • 15+ instruction files missing or incomplete frontmatter
  • Files need: file_type, title, description, version, last_updated, owners, tags, status

Branch Status

Original Branch: refactor/phase-3a-instructions-migration

Recommendation

Phase 3A structural work is complete and merged. The 21+ validation issues are non-blocking and can be addressed incrementally:

  1. High Priority: applyTo pattern fixes (6 files) — affects file scope
  2. Medium Priority: Broken links/references (10+ files) — documentation clarity
  3. Low Priority: Frontmatter completeness (15+ files) — metadata consistency

These can be tracked and fixed in Phase 4 validation work or separate cleanup PRs.

Next Steps

Linked Issues


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. self-assigned this
    on Aug 5, 2026
  2. linear-code commented on Aug 5, 2026

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

    @github-actions
    Contributor

    ⏱️ Aging and SLA annotation

    • Age: 4 day(s)
    • SLA state: Within SLA
    • Thresholds: warn at 7 days, breach at 14 days
    • Last updated: 2026-08-09T11:40:37.487Z

    Maintained by project-meta-sync workflow.

  4. added theissue type on Aug 5, 2026
  5. added this to the v1.0 milestone on Aug 5, 2026
  6. modified the milestones: v1.0, v1.1 on Aug 29, 2026
  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:priority:important
    • migrate:status:ready
    • migrate:area:infrastructure
    • migrate:type:task

    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.

  8. changed the title [-]Phase 3A Validation Fixes — Instructions Migration Follow-up[/-] [+]task: infrastructure - apply Phase 3A validation fixes[/+] on Sep 8, 2026
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

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions