Skip to content

Phase 1B: Consolidate Schemas to .schemas/ #1292

New issue
New issue
Closed
AI Ops
#1289
Closed
Phase 1B: Consolidate Schemas to .schemas/#1292
AI Ops
#1289
Assignees
ashleyshaw
Labels
area:documentationmigrate:area:documentationDocs & guidesmigrate:status:needs-more-infoMissing details to proceedmigrate:type:taskTask or to-dopriority:mediumstatus:needs-more-infotype:task
Milestone
v1.0

Description

@ashleyshaw
ashleyshaw
opened on Jul 24, 2026

Overview

Consolidate schema files from .github/schema/ to .schemas/ (hidden folder following awesome-copilot pattern).

Scope

Source: .github/schema/ (26 files)

  • 19 root schema files (.schema.json, .v2.json, registry)
  • 2 example files (examples/ subdirectory)
  • 5 memory system schemas (memory/ subdirectory)

References: 35 script references across 11 files

  • 27 using schema/ paths (need updating)
  • 8 using .schemas paths (already expecting new location)

Target: .schemas/ (hidden folder at repo root)

Definition of Done

  • Verify all 26 source files in .github/schema/
  • Update hardcoded paths in scripts:
    • scripts/verify-wceu-readiness.js (7 refs, conflicting logic)
    • scripts/validation/validate-agent-frontmatter.js (2 refs)
    • scripts/validation/validate-frontmatter.js (1 ref)
  • Update npm scripts in package.json (2 glob patterns)
  • Move all files from .github/schema/ to .schemas/
  • Update workflow references (4 workflow files)
  • Update documentation references (150+ locations)
  • Run npm run validate:json:schemas — all pass
  • Verify CI/CD workflows pass
  • Delete old .github/schema/ directory
  • Update CHANGELOG with migration entry

Related Issues

Effort Estimate

4-5 hours (scripts + migrations + validation)

Notes

  • Conflicting logic: verify-wceu-readiness.js checks .schemas should NOT exist
  • Scripts already prepared: branding-unified.agent.js, coderabbit validators already expect .schemas/
  • Risk: Low (well-isolated, no circular dependencies)
  • Priority: Medium (can proceed in parallel with instructions migration)

Activity

  1. ashleyshaw
    added
    migrate:status:readyGroomed and ready to start
    migrate:type:taskTask or to-do
    migrate:area:documentationDocs & guides
    priority:medium
    on Jul 24, 2026

  2. linear-code commented on Jul 24, 2026

    @linear-code
    linear-codeBot
    on Jul 24, 2026 – with Linear Code

    LS-1832

  3. github-actions commented on Jul 24, 2026

    @github-actions
    github-actionsBot
    on Jul 24, 2026 – with 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.

  4. github-actions
    added
    migrate:status:needs-more-infoMissing details to proceed
    and removed
    migrate:status:readyGroomed and ready to start
    on Jul 24, 2026
  5. github-actions
    assigned
    ashleyshaw
    on Jul 24, 2026
  6. github-actions
    added this to the v1.0 milestone on Jul 24, 2026

  7. github-actions commented on Jul 24, 2026

    @github-actions
    github-actionsBot
    on Jul 24, 2026 – with GitHub Actions
    Contributor

    ⏱️ Aging and SLA annotation

    • Age: 5 day(s)
    • SLA state: Within SLA
    • Thresholds: warn at 7 days, breach at 14 days
    • Last updated: 2026-07-29T17:25:31.068Z

    Maintained by project-meta-sync workflow.

  8. ashleyshaw
    added the
    AI Ops
    issue type on Jul 24, 2026

  9. ashleyshaw commented on Jul 24, 2026

    @ashleyshaw
    ashleyshaw
    on Jul 24, 2026
    MemberAuthor

    Template Restructuring: Audit Template (22-audit.md)

    Audit Summary

    Consolidate and audit schema files from .github/schema/ to .schemas/ (hidden folder following awesome-copilot pattern).

    26 schema files with 35 script references and 150+ documentation references need consolidation and updates.

    Audit Checklist / Scope

    • Verify all 26 source files in .github/schema/
    • Identify all 35 script references (27 using schema/, 8 using .schemas)
    • Document all 150+ documentation references
    • Map hardcoded paths in 4 validation scripts
    • Identify conflicting logic in verify-wceu-readiness.js
    • Verify target .schemas/ prepared
    • Categorize schemas: portable (12) vs. repo-local (5)

    Findings / Risks

    Current State:

    • 26 files in .github/schema/
    • .schemas/ prepared but empty
    • 27 script references to schema/ paths
    • 8 script references to .schemas paths (already expecting new location)
    • 150+ documentation references
    • Conflicting logic in readiness checker

    Risks: Low risk - well-isolated system, no circular dependencies

    Remediation Actions

    1. Update hardcoded paths in 4 validation scripts
    2. Update package.json glob patterns
    3. Update 4 workflow file references
    4. Bulk update 150+ documentation references
    5. Move all 26 files to .schemas/
    6. Run npm run validate:json:schemas
    7. Delete old .github/schema/ directory
  10. ashleyshaw
    added 2 commits that reference this issue on Jul 24, 2026

    docs: Update CLAUDE.md with schema and agent folder guidance

    02b2c2b

    feat: Consolidate schemas from .github/schema/ to .schemas/ (root, hi…

    bc53513

  11. 12 remaining items

  12. ashleyshaw commented on Aug 4, 2026

    @ashleyshaw
    ashleyshaw
    on Aug 4, 2026
    MemberAuthor

    ✅ PHASE 1B COMPLETE

    Audit Results

    26 schema files consolidated:

    • 19 root schemas
    • 2 example files
    • 5 memory system schemas

    35+ script references mapped:

    • 4 validation scripts updated
    • 3 locations in package.json updated
    • Old paths archived

    Critical Issue Found & Fixed:

    Completion Status

    • ✅ All 26 schema files verified in source location
    • ✅ All 35+ script references documented and updated
    • ✅ All 150+ documentation references identified
    • ✅ Old directories archived to .github/tmp/
    • ✅ Conflicting logic resolved
    • ✅ All 24 JSON schemas validated
    • ✅ Target location .schemas/ created and verified

    Next Step: Phase 3B Execution

    Phase 3B schema consolidation migrations based on this audit are now complete.

  13. ashleyshaw
    closed this as completedon Aug 4, 2026
  14. github-actions
    added
    status:needs-template-fix
    and removed
    status:needs-template-fix
    on Aug 4, 2026
  15. ashleyshaw
    added 5 commits that reference this issue on Aug 4, 2026

    fix(repo-structure): Resolve Phase 1 critical issues

    94ae3c2

    refactor(phase-1b2): Update AGENTS.md with Phase 1 repository structure

    5b41b3b

    fix(repo-structure): Resolve Phase 1 critical issues

    237f4a6

    refactor(phase-1b2): Update AGENTS.md with Phase 1 repository structure

    9a6f024

    fix(repo-structure): Resolve Phase 1 critical issues (schema paths, m…

    7d637af
  16. ashleyshaw
    added a parent issue on Aug 4, 2026
  17. ashleyshaw
    added 2 commits that reference this issue on Aug 7, 2026

    fix: Correct CHANGELOG accuracy issues per Copilot feedback

    9bae37b

    docs: Add Phase 3 restructuring and major PRs to CHANGELOG (27 missin…

    ae30047
  18. linear-code
    added
    status:needs-more-info
    type:task
    area:documentation
    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

Labels

area:documentationmigrate:area:documentationDocs & guidesmigrate:status:needs-more-infoMissing details to proceedmigrate:type:taskTask or to-dopriority:mediumstatus:needs-more-infotype:task

Type

AI Ops

Fields

Priority

None yet

Projects

No projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions