From fc6a20e3ff812322ab1e26e33f77d6eb1a0eb13b Mon Sep 17 00:00:00 2001 From: Ash Shaw Date: Tue, 26 May 2026 22:04:08 +0200 Subject: [PATCH] chore: finalize portable AI plugin restructure closeout --- .github/README.md | 26 +- ...restructure-inventory-report-2026-05-15.md | 33 +- ...rompts-classification-report-2026-05-26.md | 91 +++ ...estructure-live-issue-status-2026-05-26.md | 33 +- ...n-restructure-migration-map-2026-05-15.csv | 535 +++--------------- ...able-workflows-source-report-2026-05-26.md | 62 ++ ...ale-reference-cleanup-report-2026-05-19.md | 12 +- .schemas/README.md | 62 -- agents/README.md | 60 -- cookbook/README.md | 61 -- hooks/README.md | 60 -- instructions/README.md | 60 -- instructions/readme.instructions.md | 4 - plugins/README.md | 72 --- skills/README.md | 75 --- workflows/README.md | 77 +-- workflows/portable-ai-plugin-restructure.md | 78 +++ 17 files changed, 371 insertions(+), 1030 deletions(-) create mode 100644 .github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-legacy-prompts-classification-report-2026-05-26.md create mode 100644 .github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-portable-workflows-source-report-2026-05-26.md create mode 100644 workflows/portable-ai-plugin-restructure.md diff --git a/.github/README.md b/.github/README.md index 084e970c0..5da32e880 100644 --- a/.github/README.md +++ b/.github/README.md @@ -144,8 +144,8 @@ flowchart TB - Standardise contribution, code quality, review, and labelling across all repos. - Automate issue/PR labelling, project syncing, and governance. -- Provide a canonical set of instructions for AI agents & Copilot. -- Centralise saved replies, prompts, chatmodes, and reusable workflows. +- Provide repo-local guidance for AI agents and Copilot. +- Centralise saved replies, prompt migration records, and reusable GitHub Actions. - Enable fast onboarding and safe, scalable development. See [GitHub: About organisation-wide community health files](https://github.blog/changelog/2019-02-21-organization-wide-community-health-files/) and [Creating a default community health file for your organization](https://docs.github.com/en/communities/setting-up-your-project-for-healthy-contributions/creating-a-default-community-health-file) for more context. @@ -161,12 +161,12 @@ Organizations can add community health files to a specially named `.github` repo Follow these steps to onboard and use this repository effectively across the organisation: 1. Reference issue and PR templates automatically surfaced when creating new items in any repo without overrides. -2. Use files in `instructions/` before starting development to align with standards. -3. For AI-assisted workflows, load prompts from `prompts/` and agents from `agents/`. -4. Reusable workflows in `workflows/` can be invoked via `uses:` in member repositories. -5. Update labels or labeler rules only in `automation/` to propagate consistency. +2. Use portable files in `/instructions` before starting development to align with standards. +3. For AI-assisted workflows, use portable assets from `/agents`, `/skills`, `/cookbook`, and `/workflows`. +4. Reusable GitHub Actions in `.github/workflows/` can be invoked via `uses:` in member repositories. +5. Update labels and labeler rules in `.github/labels.yml` and `.github/labeler.yml` to propagate consistency. 6. Add or adjust saved replies in `SAVED_REPLIES/` for common maintainer responses. -7. Consult `AGENTS.md`, `GEMINI.md`, or `CLAUDE.md` before modifying AI agent behavior. +7. Consult `AGENTS.md` and `.github/custom-instructions.md` before modifying repo-local AI guidance. > To override an org-wide template in a member repository, add a local copy there; GitHub will prefer the repo-local version. @@ -368,10 +368,8 @@ graph TB ├── schemas/ # JSON schemas for validation │ └── *.json │ -├── custom-instructions.md # Org-wide Copilot instructions +├── custom-instructions.md # Repo-local Copilot instructions ├── AGENTS.md # Global agent rules -├── GEMINI.md # Gemini agent guidance -├── CLAUDE.md # Claude agent guidance ├── README.md # This file: folder overview └── ... (other shared files) ``` @@ -457,11 +455,11 @@ flowchart LR ## Component Integration Details - **Instructions**: The `instructions/` folder contains canonical, versioned standards for coding, linting, HTML templates, WordPress pattern development, PHP blocks, and theme configuration. Always reference these before starting work or reviewing code. -- **Prompts & Chat Modes**: Modular prompt templates and chat modes designed for Copilot, Gemini, Claude, and custom agents—enabling consistent AI-assisted workflows and reviews. -- **Agents**: Agent specs and rules (see `AGENTS.md`, `GEMINI.md`, `CLAUDE.md`) detail expected behaviour, standards, and escalation procedures for all automated or AI contributors. -- **Workflows & Automation**: Includes reusable GitHub Actions workflows for labelling, project syncing, and more. The `automation/` folder covers label rules, branching, and governance files. +- **Prompts**: Legacy prompt templates remain under `.github/prompts/` while durable workflows are classified for `/skills` or `/cookbook`. +- **Agents**: Agent specs and rules in `AGENTS.md`, `/agents`, and `.github/custom-instructions.md` detail expected behaviour, standards, and escalation procedures for automated or AI contributors. +- **Workflows & Automation**: Includes reusable GitHub Actions workflows for labelling, project syncing, and more. Label rules and governance files live directly under `.github`. - **Templates**: Issue and PR templates standardise reporting, changelog, and review for all repos, supporting automation and reducing triage effort. Saved replies help maintainers respond consistently. -- **Custom Instructions**: The root-level `custom-instructions.md` and agent files define Copilot/AI behaviour org-wide, so all automated actions and suggestions follow LightSpeed rules. +- **Custom Instructions**: `.github/custom-instructions.md` defines repo-local Copilot behaviour, while portable guidance belongs in the top-level source folders. - **Discoverability & Onboarding**: All files are indexed, referenced, and cross-linked for easy discoverability. New contributors can start in this folder and be directed to relevant standards, templates, or automation docs. --- diff --git a/.github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-inventory-report-2026-05-15.md b/.github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-inventory-report-2026-05-15.md index 90438cf0e..cb7bff82e 100644 --- a/.github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-inventory-report-2026-05-15.md +++ b/.github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-inventory-report-2026-05-15.md @@ -1,8 +1,8 @@ --- title: "Portable AI Plugin Restructure Inventory And Migration Map" description: "Issue #286 audit output for current AI, automation, governance, schema, prompt, and validation assets before portable plugin restructuring." -version: "v0.1.0" -last_updated: "2026-05-15" +version: "v0.1.1" +last_updated: "2026-05-26" file_type: "project-audit" maintainer: "LightSpeed Team" authors: ["Codex"] @@ -29,9 +29,9 @@ This audit inventories the current files under `.github/agents`, `.github/instru ## Summary -- Total inventoried files: **385**. -- Files with hard-coded `.github/*` references: **150**. -- Files without detected hard-coded `.github/*` references: **235**. +- Total inventoried files: **416**. +- Files with hard-coded `.github/*` references: **163**. +- Files without detected hard-coded `.github/*` references: **253**. ### Files By Asset Type @@ -39,11 +39,15 @@ This audit inventories the current files under `.github/agents`, `.github/instru | --- | ---: | | `agent-spec` | 21 | | `github-action-workflow` | 14 | +| `github-discussion-template` | 10 | +| `github-governance-config` | 7 | | `github-issue-template` | 29 | +| `github-pr-template` | 13 | | `instruction` | 54 | | `legacy-agent-runtime` | 82 | | `legacy-validation-runtime` | 25 | | `prompt` | 73 | +| `repo-local-copilot-instructions` | 1 | | `saved-reply` | 81 | | `schema` | 6 | @@ -52,20 +56,29 @@ This audit inventories the current files under `.github/agents`, `.github/instru | Decision | Count | Meaning | | --- | ---: | --- | | `archive` | 21 | Keep archived unless later reviewed. | -| `convert` | 74 | Convert into a skill, cookbook entry, or split repo-local/portable asset. | -| `defer` | 107 | Keep in place until a later scoped rewrite or validation reset. | -| `delete` | 7 | Remove after confirmation. | -| `keep` | 117 | Remain in the current path. | -| `move` | 59 | Move to the new top-level source collection after references are updated. | +| `convert` | 77 | Convert into a skill, cookbook entry, or split repo-local/portable asset. | +| `defer` | 109 | Keep in place until a later scoped rewrite or validation reset. | +| `delete` | 8 | Remove after confirmation. | +| `keep` | 145 | Remain in the current path. | +| `move` | 56 | Move to the new top-level source collection after references are updated. | ## Key Findings - `.github` contains both GitHub-native governance content and portable AI operations content, so migration must be decision-led rather than a bulk move. - Issue templates, saved replies, and GitHub Actions should remain under `.github` because they provide repository and organisation governance behaviour. +- Pull request templates, discussion templates, labels, Dependabot, funding, issue types, labeler rules, and repo-local Copilot configuration are GitHub-native governance assets that should remain under `.github`. - Agent specs, instruction files, prompt workflows, and schemas are the strongest candidates for top-level portable source collections, but most require reference updates before moving. - Legacy JavaScript runners and validators should be deferred and rewritten selectively; moving them as-is would preserve the current complexity that the PRD wants to reduce. - Zero-byte macOS `Icon` metadata files are flagged for deletion after the link audit confirms no references. +## 2026-05-26 Reconciliation Note + +The migration map was reconciled after later #293 classification work expanded +the inventory to include previously omitted pull request templates, discussion +templates, GitHub governance configuration, and repo-local Copilot +configuration. Committed conflict markers were removed from the canonical CSV, +and this report now reflects the active 416-row map. + ## Remediation Links - Use issue #287 to capture the command and dependency baseline before changing validation behaviour. diff --git a/.github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-legacy-prompts-classification-report-2026-05-26.md b/.github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-legacy-prompts-classification-report-2026-05-26.md new file mode 100644 index 000000000..3e52b60d1 --- /dev/null +++ b/.github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-legacy-prompts-classification-report-2026-05-26.md @@ -0,0 +1,91 @@ +--- +file_type: "project-audit" +title: "Portable AI Plugin Restructure Legacy Prompts Classification Report" +description: "Issue #299 audit output classifying legacy prompts as skill or cookbook conversion targets, with frontmatter and P0 notes." +version: "v0.1.0" +last_updated: "2026-05-26" +maintainer: "LightSpeed Team" +authors: ["Codex"] +license: "GPL-3.0" +tags: ["audit", "prompts", "skills", "cookbook", "ai-ops", "plugin-restructure"] +domain: "governance" +stability: "draft" +references: + - path: "issues/children/batch-03-skills-cookbook/03-01-audit-classify-legacy-prompts.md" + description: "GitHub issue #299 local source draft." + - path: "portable-ai-plugin-restructure-migration-map-2026-05-15.csv" + description: "Canonical migration decision map." + - path: "complete-portable-ai-plugin-restructure.prompt.md" + description: "Project orchestration prompt and dependency order." +--- + +# Portable AI Plugin Restructure Legacy Prompts Classification Report + +Parent epic: #283. Child issue: #299. + +## Summary + +All legacy prompt rows in the migration map are now explicitly linked to `#299` +and classified for conversion. The audit confirms this programme does not need +a top-level `/prompts` folder. + +## Inventory and Classification + +| Measure | Result | +| --- | ---: | +| Prompt rows in migration map (`asset_type=prompt`) | 73 | +| Prompt rows linked to `#299` | 73 | +| `*.prompt.md` files in `.github/prompts/` | 71 | +| Skill conversion targets | 33 | +| Cookbook conversion targets | 40 | + +The 73 prompt rows include two non-`*.prompt.md` prompt index assets: +`.github/prompts/README.md` and `.github/prompts/prompts.md`. + +## Frontmatter Audit + +The following 10 prompt files are missing frontmatter and should be handled in +later conversion issues rather than this classification audit: + +- `.github/prompts/agents.prompt.md` +- `.github/prompts/changelog-lines.prompt.md` +- `.github/prompts/changelog.prompt.md` +- `.github/prompts/code-review.prompt.md` +- `.github/prompts/docs-from-comments.prompt.md` +- `.github/prompts/docs-writeup.prompt.md` +- `.github/prompts/generate-changelog.prompt.md` +- `.github/prompts/generate-pr-description.prompt.md` +- `.github/prompts/pr-description.prompt.md` +- `.github/prompts/pr-review.prompt.md` + +## P0 Pilot Skill Candidates + +The highest-priority conversion candidates align with already-scoped downstream +issues: + +- `lightspeed-frontmatter-audit` candidate set for #301. +- `lightspeed-pr-review` candidate set for #302. +- `lightspeed-label-governance` candidate set for #303. + +## Findings and Risks + +- Bulk migration of every prompt as-is would recreate legacy prompt sprawl. +- Missing frontmatter on 10 prompt files increases conversion risk if moved + without template normalisation. +- The classification matrix is complete, but implementation should remain in + issue-scoped conversion slices (#300-#304). + +## Remediation Actions + +- Keep prompt conversion work staged through #300-#304. +- Handle frontmatter normalisation as part of each prompt-to-skill/cookbook + conversion slice. +- Keep the migration map as the single source of truth for conversion targets. + +## Acceptance Criteria Status + +- [x] Inventory all current prompt files. +- [x] Identify files missing frontmatter. +- [x] Classify each prompt as skill, cookbook, archive, delete, or defer. +- [x] Identify P0 pilot skill candidates. +- [x] Add classification linkage to the migration decision map. diff --git a/.github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-live-issue-status-2026-05-26.md b/.github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-live-issue-status-2026-05-26.md index 92c2cd0a5..f88fef565 100644 --- a/.github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-live-issue-status-2026-05-26.md +++ b/.github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-live-issue-status-2026-05-26.md @@ -12,43 +12,36 @@ domain: "governance" stability: "active" --- -# Portable AI Plugin Restructure Live Issue Status (2026-05-26) +# Portable AI Plugin Restructure Live Issue Status (2026-05-26, Final) ## Snapshot summary -- Snapshot source: GitHub REST API (`/repos/lightspeedwp/.github/issues/{number}`). -- Snapshot time (UTC): 2026-05-26. +- Snapshot source: GitHub REST API (`/repos/lightspeedwp/.github/issues/{number}`) and GitHub connector checks. +- Snapshot time (UTC): 2026-05-26 final reconciliation. - Scope: Parent issues #282-#285 and child issues #286-#321. -- Totals: 40 tracked issues, 37 open, 3 closed. -- Closed issues: #290, #291, #292. +- Totals: 40 tracked issues, 0 open, 40 closed. +- Closed issues: #282-#321 (all tracked parent and child issues). ## Parent issue status | Issue | State | Title | | --- | --- | --- | -| #282 | Open | [Epic] Portable AI plugin restructure: planning control and target skeleton | -| #283 | Open | [Epic] Portable AI plugin restructure: source asset migration | -| #284 | Open | [Epic] Portable AI plugin restructure: core plugin and compatibility | -| #285 | Open | [Epic] Portable AI plugin restructure: validation, docs, pilot, and release | +| #282 | Closed | [Epic] Portable AI plugin restructure: planning control and target skeleton | +| #283 | Closed | [Epic] Portable AI plugin restructure: source asset migration | +| #284 | Closed | [Epic] Portable AI plugin restructure: core plugin and compatibility | +| #285 | Closed | [Epic] Portable AI plugin restructure: validation, docs, pilot, and release | ## Child issue status ### Closed -- #290 [Documentation] Add ownership indexes for new top-level folders -- #291 [Refactor] Update file organisation rules for GitHub-native vs portable assets -- #292 [Refactor] Scope `.github` Copilot instructions to this repo only +- #286-#321 (all child issues closed). ### Open -- #286, #287, #288, #289 -- #293, #294, #295, #296, #297, #298 -- #299, #300, #301, #302, #303, #304 -- #305, #306, #307, #308, #309, #310 -- #311, #312, #313, #314, #315, #316 -- #317, #318, #319, #320, #321 +- None. ## Notes for operators -- This repository workspace cannot directly update remote GitHub issues without authenticated GitHub CLI or token-backed API access. -- Use this snapshot to drive the next execution slice and post status comments/closures from an authenticated environment. +- GitHub issue comments, status-label updates, and closures were applied through the GitHub connector during the 2026-05-26 completion run. +- Programme state now meets the orchestration prompt's required final issue state: all tracked parent and child issues are closed. diff --git a/.github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-migration-map-2026-05-15.csv b/.github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-migration-map-2026-05-15.csv index 771ccd819..b891c0185 100644 --- a/.github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-migration-map-2026-05-15.csv +++ b/.github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-migration-map-2026-05-15.csv @@ -1,391 +1,3 @@ -<<<<<<< Updated upstream -source_path,asset_type,decision,target_path,hard_coded_github_path,follow_up_issue,rationale -.github/agents/README.md,agent-spec,move,agents/README.md,yes,,Portable agent index should move to /agents; keep repo-only notes in .github if needed. -.github/agents/adr.agent.md,agent-spec,move,agents/adr.agent.md,no,,Reusable agent spec candidate for /agents; confirm repo-only assumptions before moving. -.github/agents/agent.md,agent-spec,move,agents/agent.md,yes,,Reusable agent spec candidate for /agents; confirm repo-only assumptions before moving. -.github/agents/issues.agent.md,agent-spec,move,agents/issues.agent.md,yes,,Reusable agent spec candidate for /agents; confirm repo-only assumptions before moving. -.github/agents/labeling.agent.md,agent-spec,move,agents/labeling.agent.md,yes,,Reusable agent spec candidate for /agents; confirm repo-only assumptions before moving. -.github/agents/linting.agent.md,agent-spec,move,agents/linting.agent.md,yes,,Reusable agent spec candidate for /agents; confirm repo-only assumptions before moving. -.github/agents/meta.agent.md,agent-spec,move,agents/meta.agent.md,no,,Reusable agent spec candidate for /agents; confirm repo-only assumptions before moving. -.github/agents/metrics.agent.md,agent-spec,move,agents/metrics.agent.md,no,,Reusable agent spec candidate for /agents; confirm repo-only assumptions before moving. -.github/agents/mode-demonstrate-understanding.agent.md,agent-spec,move,agents/mode-demonstrate-understanding.agent.md,no,,Reusable agent spec candidate for /agents; confirm repo-only assumptions before moving. -.github/agents/mode-document-reviewer.agent.md,agent-spec,move,agents/mode-document-reviewer.agent.md,no,,Reusable agent spec candidate for /agents; confirm repo-only assumptions before moving. -.github/agents/mode-prd.agent.md,agent-spec,move,agents/mode-prd.agent.md,no,,Reusable agent spec candidate for /agents; confirm repo-only assumptions before moving. -.github/agents/mode-thinking.agent.md,agent-spec,move,agents/mode-thinking.agent.md,no,,Reusable agent spec candidate for /agents; confirm repo-only assumptions before moving. -.github/agents/project-meta-sync.agent.md,agent-spec,move,agents/project-meta-sync.agent.md,no,,Reusable agent spec candidate for /agents; confirm repo-only assumptions before moving. -.github/agents/prompt-engineer.agent.md,agent-spec,move,agents/prompt-engineer.agent.md,no,,Reusable agent spec candidate for /agents; confirm repo-only assumptions before moving. -.github/agents/release.agent.md,agent-spec,move,agents/release.agent.md,yes,,Reusable agent spec candidate for /agents; confirm repo-only assumptions before moving. -.github/agents/reporting.agent.md,agent-spec,move,agents/reporting.agent.md,yes,,Reusable agent spec candidate for /agents; confirm repo-only assumptions before moving. -.github/agents/reviewer.agent.md,agent-spec,move,agents/reviewer.agent.md,yes,,Reusable agent spec candidate for /agents; confirm repo-only assumptions before moving. -.github/agents/task-planner.agent.md,agent-spec,move,agents/task-planner.agent.md,no,,Reusable agent spec candidate for /agents; confirm repo-only assumptions before moving. -.github/agents/task-researcher.agent.md,agent-spec,move,agents/task-researcher.agent.md,no,,Reusable agent spec candidate for /agents; confirm repo-only assumptions before moving. -.github/agents/template.agent.md,agent-spec,move,agents/template.agent.md,yes,,Reusable agent spec candidate for /agents; confirm repo-only assumptions before moving. -.github/agents/testing.agent.md,agent-spec,move,agents/testing.agent.md,yes,,Reusable agent spec candidate for /agents; confirm repo-only assumptions before moving. -.github/instructions/.archive/CONSOLIDATION_MIGRATION_GUIDE.md,instruction,archive,,yes,,Legacy archived instruction; do not migrate by default unless a later issue proves value. -.github/instructions/.archive/FRONTMATTER_SCHEMA.md.backup,instruction,archive,,yes,,Legacy archived instruction; do not migrate by default unless a later issue proves value. -.github/instructions/.archive/INSTRUCTION_CONSOLIDATION_MIGRATION.md,instruction,archive,,yes,,Legacy archived instruction; do not migrate by default unless a later issue proves value. -.github/instructions/.archive/ISSUE_TYPES.md.backup,instruction,archive,,yes,,Legacy archived instruction; do not migrate by default unless a later issue proves value. -.github/instructions/.archive/README.md,instruction,archive,,yes,,Legacy archived instruction; do not migrate by default unless a later issue proves value. -.github/instructions/.archive/WORKFLOWS.md.backup,instruction,archive,,yes,,Legacy archived instruction; do not migrate by default unless a later issue proves value. -.github/instructions/.archive/agents.instructions.md,instruction,archive,,yes,,Legacy archived instruction; do not migrate by default unless a later issue proves value. -.github/instructions/.archive/file-management.instructions.md,instruction,archive,,yes,,Legacy archived instruction; do not migrate by default unless a later issue proves value. -.github/instructions/.archive/frontmatter.instructions.md,instruction,archive,,yes,,Legacy archived instruction; do not migrate by default unless a later issue proves value. -.github/instructions/.archive/javascript.instructions.md,instruction,archive,,yes,,Legacy archived instruction; do not migrate by default unless a later issue proves value. -.github/instructions/.archive/jest.instructions.md,instruction,archive,,no,,Legacy archived instruction; do not migrate by default unless a later issue proves value. -.github/instructions/.archive/jsdoc.instructions.md,instruction,archive,,no,,Legacy archived instruction; do not migrate by default unless a later issue proves value. -.github/instructions/.archive/json.instructions.md,instruction,archive,,yes,,Legacy archived instruction; do not migrate by default unless a later issue proves value. -.github/instructions/.archive/markdown.instructions.md,instruction,archive,,yes,,Legacy archived instruction; do not migrate by default unless a later issue proves value. -.github/instructions/.archive/naming-conventions.instructions.md,instruction,archive,,no,,Legacy archived instruction; do not migrate by default unless a later issue proves value. -.github/instructions/.archive/reporting.instructions.md,instruction,archive,,yes,,Legacy archived instruction; do not migrate by default unless a later issue proves value. -.github/instructions/.archive/reviewer.instructions.md,instruction,archive,,yes,,Legacy archived instruction; do not migrate by default unless a later issue proves value. -.github/instructions/.archive/saved-replies.instructions.md,instruction,archive,,yes,,Legacy archived instruction; do not migrate by default unless a later issue proves value. -.github/instructions/.archive/testing.instructions.md,instruction,archive,,yes,,Legacy archived instruction; do not migrate by default unless a later issue proves value. -.github/instructions/.archive/tests.instructions.md,instruction,archive,,yes,,Legacy archived instruction; do not migrate by default unless a later issue proves value. -.github/instructions/.archive/yaml.instructions.md,instruction,archive,,yes,,Legacy archived instruction; do not migrate by default unless a later issue proves value. -.github/instructions/README.md,instruction,move,instructions/README.md,no,,Portable instruction index candidate; keep a small .github repo-local index if needed. -.github/instructions/a11y.instructions.md,instruction,move,instructions/a11y.instructions.md,no,,Portable instruction candidate; remove .github path assumptions during migration. -.github/instructions/agent-spec.instructions.md,instruction,move,instructions/agent-spec.instructions.md,yes,,Portable instruction candidate; remove .github path assumptions during migration. -.github/instructions/automation.instructions.md,instruction,move,instructions/automation.instructions.md,yes,,Portable instruction candidate; remove .github path assumptions during migration. -.github/instructions/coding-standards.instructions.md,instruction,move,instructions/coding-standards.instructions.md,yes,,Portable instruction candidate; remove .github path assumptions during migration. -.github/instructions/community-standards.instructions.md,instruction,move,instructions/community-standards.instructions.md,yes,,Portable instruction candidate; remove .github path assumptions during migration. -.github/instructions/copilot-operations.instructions.md,instruction,move,instructions/copilot-operations.instructions.md,yes,,Portable instruction candidate; remove .github path assumptions during migration. -.github/instructions/docs.instructions.md,instruction,move,instructions/docs.instructions.md,no,,Portable instruction candidate; remove .github path assumptions during migration. -.github/instructions/documentation-formats.instructions.md,instruction,move,instructions/documentation-formats.instructions.md,yes,,Portable instruction candidate; remove .github path assumptions during migration. -.github/instructions/file-organisation.instructions.md,instruction,convert,instructions/file-organisation.instructions.md + .github/instructions/file-organisation.instructions.md,yes,,Split portable placement rules from repo-local .github governance rules. -.github/instructions/instructions.instructions.md,instruction,move,instructions/instructions.instructions.md,yes,,Portable instruction candidate; remove .github path assumptions during migration. -.github/instructions/issues.instructions.md,instruction,move,instructions/issues.instructions.md,yes,,Portable instruction candidate; remove .github path assumptions during migration. -.github/instructions/labeling.instructions.md,instruction,move,instructions/labeling.instructions.md,yes,,Portable instruction candidate; remove .github path assumptions during migration. -.github/instructions/languages.instructions.md,instruction,move,instructions/languages.instructions.md,yes,,Portable instruction candidate; remove .github path assumptions during migration. -.github/instructions/linting.instructions.md,instruction,move,instructions/linting.instructions.md,yes,,Portable instruction candidate; remove .github path assumptions during migration. -.github/instructions/mermaid.instructions.md,instruction,move,instructions/mermaid.instructions.md,yes,,Portable instruction candidate; remove .github path assumptions during migration. -.github/instructions/meta.instructions.md,instruction,move,instructions/meta.instructions.md,yes,,Portable instruction candidate; remove .github path assumptions during migration. -.github/instructions/metrics.instructions.md,instruction,move,instructions/metrics.instructions.md,yes,,Portable instruction candidate; remove .github path assumptions during migration. -.github/instructions/planner.instructions.md,instruction,move,instructions/planner.instructions.md,yes,,Portable instruction candidate; remove .github path assumptions during migration. -.github/instructions/project-meta-sync.instructions.md,instruction,move,instructions/project-meta-sync.instructions.md,yes,,Portable instruction candidate; remove .github path assumptions during migration. -.github/instructions/prompt.instructions.md,instruction,move,instructions/prompt.instructions.md,yes,,Portable instruction candidate; remove .github path assumptions during migration. -.github/instructions/pull-requests.instructions.md,instruction,move,instructions/pull-requests.instructions.md,yes,,Portable instruction candidate; remove .github path assumptions during migration. -.github/instructions/quality-assurance.instructions.md,instruction,move,instructions/quality-assurance.instructions.md,yes,,Portable instruction candidate; remove .github path assumptions during migration. -.github/instructions/readme.instructions.md,instruction,move,instructions/readme.instructions.md,yes,,Portable instruction candidate; remove .github path assumptions during migration. -.github/instructions/release.instructions.md,instruction,move,instructions/release.instructions.md,yes,,Portable instruction candidate; remove .github path assumptions during migration. -.github/instructions/reporting.instructions.md,instruction,move,instructions/reporting.instructions.md,yes,,Portable instruction candidate; remove .github path assumptions during migration. -.github/instructions/self-explanatory-code-commenting.instructions.md,instruction,move,instructions/self-explanatory-code-commenting.instructions.md,yes,,Portable instruction candidate; remove .github path assumptions during migration. -.github/instructions/spec-driven-workflow.instructions.md,instruction,move,instructions/spec-driven-workflow.instructions.md,yes,,Portable instruction candidate; remove .github path assumptions during migration. -.github/instructions/task-implementation.instructions.md,instruction,move,instructions/task-implementation.instructions.md,yes,,Portable instruction candidate; remove .github path assumptions during migration. -.github/instructions/tasksync.instructions.md,instruction,move,instructions/tasksync.instructions.md,yes,,Portable instruction candidate; remove .github path assumptions during migration. -.github/instructions/template.instructions.md,instruction,move,instructions/template.instructions.md,yes,,Portable instruction candidate; remove .github path assumptions during migration. -.github/instructions/tools.instructions.md,instruction,move,instructions/tools.instructions.md,no,,Portable instruction candidate; remove .github path assumptions during migration. -.github/instructions/workflows.instructions.md,instruction,move,instructions/workflows.instructions.md,yes,,Portable instruction candidate; remove .github path assumptions during migration. -.github/prompts/README.md,prompt,convert,cookbook/README.md,no,,Prompt indexes become cookbook/backlog material rather than first-class installable assets. -.github/prompts/add-frontmatter.prompt.md,prompt,convert,skills/add-frontmatter/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/agent-task-markdown-linting.prompt.md,prompt,convert,skills/agent-task-markdown-linting/SKILL.md,yes,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/agents.prompt.md,prompt,convert,skills/agents/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/architecture-blueprint-generator.prompt.md,prompt,convert,cookbook/architecture-blueprint-generator.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/breakdown-epic-arch.prompt.md,prompt,convert,cookbook/breakdown-epic-arch.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/breakdown-epic-pm.prompt.md,prompt,convert,cookbook/breakdown-epic-pm.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/breakdown-feature-implementation.prompt.md,prompt,convert,skills/breakdown-feature-implementation/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/breakdown-feature-prd.prompt.md,prompt,convert,cookbook/breakdown-feature-prd.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/breakdown-plan.prompt.md,prompt,convert,cookbook/breakdown-plan.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/breakdown-test.prompt.md,prompt,convert,cookbook/breakdown-test.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/build-agent-and-tests.prompt.md,prompt,convert,skills/build-agent-and-tests/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/changelog-lines.prompt.md,prompt,convert,skills/changelog-lines/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/changelog.prompt.md,prompt,convert,skills/changelog/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/code-review.prompt.md,prompt,convert,skills/code-review/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/conventional-commit.prompt.md,prompt,convert,cookbook/conventional-commit.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/create-agentsmd.prompt.md,prompt,convert,skills/create-agentsmd/SKILL.md,yes,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/create-architectural-decision-record.prompt.md,prompt,convert,cookbook/create-architectural-decision-record.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/create-github-action-workflow-specification.prompt.md,prompt,convert,skills/create-github-action-workflow-specification/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/create-github-issue-feature-from-specification.prompt.md,prompt,convert,skills/create-github-issue-feature-from-specification/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/create-github-issues-feature-from-implementation-plan.prompt.md,prompt,convert,skills/create-github-issues-feature-from-implementation-plan/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/create-github-issues-for-unmet-specification-requirements.prompt.md,prompt,convert,skills/create-github-issues-for-unmet-specification-requirements/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/create-github-pull-request-from-specification.prompt.md,prompt,convert,skills/create-github-pull-request-from-specification/SKILL.md,yes,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/create-implementation-plan.prompt.md,prompt,convert,skills/create-implementation-plan/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/create-llms.prompt.md,prompt,convert,cookbook/create-llms.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/create-readme.prompt.md,prompt,convert,skills/create-readme/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/create-specification.prompt.md,prompt,convert,skills/create-specification/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/dependency-audit-agent.prompt.md,prompt,convert,skills/dependency-audit-agent/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/docs-from-comments.prompt.md,prompt,convert,cookbook/docs-from-comments.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/docs-writeup.prompt.md,prompt,convert,cookbook/docs-writeup.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/documentation-writer.prompt.md,prompt,convert,cookbook/documentation-writer.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/editorconfig.prompt.md,prompt,convert,cookbook/editorconfig.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/finalize-agent-prompt.prompt.md,prompt,convert,skills/finalize-agent-prompt/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/folder-structure-blueprint-generator.prompt.md,prompt,convert,cookbook/folder-structure-blueprint-generator.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/generate-changelog.prompt.md,prompt,convert,skills/generate-changelog/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/generate-custom-instructions-from-codebase.prompt.md,prompt,convert,cookbook/generate-custom-instructions-from-codebase.prompt.md,yes,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/generate-gh-workflow.prompt.md,prompt,convert,skills/generate-gh-workflow/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/generate-pr-description.prompt.md,prompt,convert,cookbook/generate-pr-description.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/git-flow-branch-creator.prompt.md,prompt,convert,cookbook/git-flow-branch-creator.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/github-copilot-starter.prompt.md,prompt,convert,cookbook/github-copilot-starter.prompt.md,yes,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/inline-documentation.prompt.md,prompt,convert,cookbook/inline-documentation.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/labeling.prompt.md,prompt,convert,skills/labeling/SKILL.md,yes,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/model-recommendation.prompt.md,prompt,convert,cookbook/model-recommendation.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/multi-stage-dockerfile.prompt.md,prompt,convert,cookbook/multi-stage-dockerfile.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/my-issues.prompt.md,prompt,convert,cookbook/my-issues.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/my-pull-requests.prompt.md,prompt,convert,cookbook/my-pull-requests.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/normalize-docs-labels.prompt.md,prompt,convert,skills/normalize-docs-labels/SKILL.md,yes,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/pr-description.prompt.md,prompt,convert,cookbook/pr-description.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/pr-review.prompt.md,prompt,convert,skills/pr-review/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/project-workflow-analysis-blueprint-generator.prompt.md,prompt,convert,skills/project-workflow-analysis-blueprint-generator/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/prompt-builder.prompt.md,prompt,convert,cookbook/prompt-builder.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/prompts.md,prompt,convert,cookbook/prompts.md,no,,Prompt indexes become cookbook/backlog material rather than first-class installable assets. -.github/prompts/python-mcp-server-generator.prompt.md,prompt,convert,cookbook/python-mcp-server-generator.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/readme-blueprint-generator.prompt.md,prompt,convert,skills/readme-blueprint-generator/SKILL.md,yes,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/release.prompt.md,prompt,convert,skills/release/SKILL.md,yes,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/remember-interactive-programming.prompt.md,prompt,convert,cookbook/remember-interactive-programming.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/remember.prompt.md,prompt,convert,cookbook/remember.prompt.md,yes,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/repo-story-time.prompt.md,prompt,convert,cookbook/repo-story-time.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/reporting.prompt.md,prompt,convert,cookbook/reporting.prompt.md,yes,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/review-and-refactor.prompt.md,prompt,convert,skills/review-and-refactor/SKILL.md,yes,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/saved-replies.prompt.md,prompt,convert,cookbook/saved-replies.prompt.md,yes,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/shuffle-json-data.prompt.md,prompt,convert,cookbook/shuffle-json-data.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/spec-driven-workflow-start.prompt.md,prompt,convert,skills/spec-driven-workflow-start/SKILL.md,yes,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/technology-stack-blueprint-generator.prompt.md,prompt,convert,cookbook/technology-stack-blueprint-generator.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/testing.prompt.md,prompt,convert,skills/testing/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/update-implementation-plan.prompt.md,prompt,convert,skills/update-implementation-plan/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/update-llms.prompt.md,prompt,convert,cookbook/update-llms.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/update-markdown-file-index.prompt.md,prompt,convert,cookbook/update-markdown-file-index.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/update-mermaid-diagrams.prompt.md,prompt,convert,cookbook/update-mermaid-diagrams.prompt.md,yes,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/update-oo-component-documentation.prompt.md,prompt,convert,cookbook/update-oo-component-documentation.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/update-readmes.prompt.md,prompt,convert,skills/update-readmes/SKILL.md,yes,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/update-specification.prompt.md,prompt,convert,skills/update-specification/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/write-coding-standards-from-file.prompt.md,prompt,convert,cookbook/write-coding-standards-from-file.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/schemas/README.md,schema,move,.schemas/README.md,yes,,Portable schema index should move to the root schema collection after reset. -.github/schemas/changelog.schema.json,schema,move,.schemas/changelog.schema.json,no,,Portable/validation schemas should move to /.schemas after simplification and non-mutating validators are ready. -.github/schemas/coderabbit-overrides.v2.json,schema,move,.schemas/coderabbit-overrides.v2.json,no,,Portable/validation schemas should move to /.schemas after simplification and non-mutating validators are ready. -.github/schemas/frontmatter.schema.json,schema,move,.schemas/frontmatter.schema.json,yes,,Portable/validation schemas should move to /.schemas after simplification and non-mutating validators are ready. -.github/schemas/project-fields.schema.json,schema,move,.schemas/project-fields.schema.json,no,,Portable/validation schemas should move to /.schemas after simplification and non-mutating validators are ready. -.github/schemas/version.schema.json,schema,move,.schemas/version.schema.json,no,,Portable/validation schemas should move to /.schemas after simplification and non-mutating validators are ready. -.github/workflows/.gitignore,github-action-workflow,keep,.github/workflows/.gitignore,no,,GitHub Actions remain under .github/workflows; create separate portable runbooks later only when needed. -.github/workflows/README.md,github-action-workflow,keep,.github/workflows/README.md,no,,GitHub Actions remain under .github/workflows; create separate portable runbooks later only when needed. -.github/workflows/changelog.yml,github-action-workflow,keep,.github/workflows/changelog.yml,no,,GitHub Actions remain under .github/workflows; create separate portable runbooks later only when needed. -.github/workflows/issues.yml,github-action-workflow,keep,.github/workflows/issues.yml,no,,GitHub Actions remain under .github/workflows; create separate portable runbooks later only when needed. -.github/workflows/labeling.yml,github-action-workflow,keep,.github/workflows/labeling.yml,yes,,GitHub Actions remain under .github/workflows; create separate portable runbooks later only when needed. -.github/workflows/linting.yml,github-action-workflow,keep,.github/workflows/linting.yml,no,,GitHub Actions remain under .github/workflows; create separate portable runbooks later only when needed. -.github/workflows/meta.yml,github-action-workflow,keep,.github/workflows/meta.yml,yes,,GitHub Actions remain under .github/workflows; create separate portable runbooks later only when needed. -.github/workflows/metrics.yml,github-action-workflow,keep,.github/workflows/metrics.yml,no,,GitHub Actions remain under .github/workflows; create separate portable runbooks later only when needed. -.github/workflows/planner.yml,github-action-workflow,keep,.github/workflows/planner.yml,yes,,GitHub Actions remain under .github/workflows; create separate portable runbooks later only when needed. -.github/workflows/project-meta-sync.yml,github-action-workflow,keep,.github/workflows/project-meta-sync.yml,no,,GitHub Actions remain under .github/workflows; create separate portable runbooks later only when needed. -.github/workflows/release.yml,github-action-workflow,keep,.github/workflows/release.yml,yes,,GitHub Actions remain under .github/workflows; create separate portable runbooks later only when needed. -.github/workflows/reporting.yml,github-action-workflow,keep,.github/workflows/reporting.yml,yes,,GitHub Actions remain under .github/workflows; create separate portable runbooks later only when needed. -.github/workflows/reviewer.yml,github-action-workflow,keep,.github/workflows/reviewer.yml,no,,GitHub Actions remain under .github/workflows; create separate portable runbooks later only when needed. -.github/workflows/testing.yml,github-action-workflow,keep,.github/workflows/testing.yml,no,,GitHub Actions remain under .github/workflows; create separate portable runbooks later only when needed. -scripts/agents/__tests__/README.md,legacy-agent-runtime,defer,scripts/agents/__tests__/README.md,yes,,Keep legacy tests with the legacy runtime until replacement hooks/workflows are designed. -scripts/agents/__tests__/adr.agent.test.js,legacy-agent-runtime,defer,scripts/agents/__tests__/adr.agent.test.js,no,,Keep legacy tests with the legacy runtime until replacement hooks/workflows are designed. -scripts/agents/__tests__/issue-type.agent.test.js,legacy-agent-runtime,defer,scripts/agents/__tests__/issue-type.agent.test.js,no,,Keep legacy tests with the legacy runtime until replacement hooks/workflows are designed. -scripts/agents/__tests__/issues.agent.test.js,legacy-agent-runtime,defer,scripts/agents/__tests__/issues.agent.test.js,no,,Keep legacy tests with the legacy runtime until replacement hooks/workflows are designed. -scripts/agents/__tests__/labeling.agent.test.js,legacy-agent-runtime,defer,scripts/agents/__tests__/labeling.agent.test.js,no,,Keep legacy tests with the legacy runtime until replacement hooks/workflows are designed. -scripts/agents/__tests__/linting.agent.test.js,legacy-agent-runtime,defer,scripts/agents/__tests__/linting.agent.test.js,no,,Keep legacy tests with the legacy runtime until replacement hooks/workflows are designed. -scripts/agents/__tests__/meta.agent.test.js,legacy-agent-runtime,defer,scripts/agents/__tests__/meta.agent.test.js,no,,Keep legacy tests with the legacy runtime until replacement hooks/workflows are designed. -scripts/agents/__tests__/metrics.agent.test.js,legacy-agent-runtime,defer,scripts/agents/__tests__/metrics.agent.test.js,no,,Keep legacy tests with the legacy runtime until replacement hooks/workflows are designed. -scripts/agents/__tests__/mode-demonstrate-understanding.agent.test.js,legacy-agent-runtime,defer,scripts/agents/__tests__/mode-demonstrate-understanding.agent.test.js,no,,Keep legacy tests with the legacy runtime until replacement hooks/workflows are designed. -scripts/agents/__tests__/mode-document-reviewer.agent.test.js,legacy-agent-runtime,defer,scripts/agents/__tests__/mode-document-reviewer.agent.test.js,no,,Keep legacy tests with the legacy runtime until replacement hooks/workflows are designed. -scripts/agents/__tests__/mode-prd.agent.test.js,legacy-agent-runtime,defer,scripts/agents/__tests__/mode-prd.agent.test.js,no,,Keep legacy tests with the legacy runtime until replacement hooks/workflows are designed. -scripts/agents/__tests__/mode-thinking.agent.test.js,legacy-agent-runtime,defer,scripts/agents/__tests__/mode-thinking.agent.test.js,no,,Keep legacy tests with the legacy runtime until replacement hooks/workflows are designed. -scripts/agents/__tests__/planner.agent.test.js,legacy-agent-runtime,defer,scripts/agents/__tests__/planner.agent.test.js,no,,Keep legacy tests with the legacy runtime until replacement hooks/workflows are designed. -scripts/agents/__tests__/project-meta-sync.agent.test.js,legacy-agent-runtime,defer,scripts/agents/__tests__/project-meta-sync.agent.test.js,no,,Keep legacy tests with the legacy runtime until replacement hooks/workflows are designed. -scripts/agents/__tests__/prompt-engineer.agent.test.js,legacy-agent-runtime,defer,scripts/agents/__tests__/prompt-engineer.agent.test.js,no,,Keep legacy tests with the legacy runtime until replacement hooks/workflows are designed. -scripts/agents/__tests__/release.agent.test.js,legacy-agent-runtime,defer,scripts/agents/__tests__/release.agent.test.js,no,,Keep legacy tests with the legacy runtime until replacement hooks/workflows are designed. -scripts/agents/__tests__/reporting.agent.test.js,legacy-agent-runtime,defer,scripts/agents/__tests__/reporting.agent.test.js,no,,Keep legacy tests with the legacy runtime until replacement hooks/workflows are designed. -scripts/agents/__tests__/reviewer.agent.test.js,legacy-agent-runtime,defer,scripts/agents/__tests__/reviewer.agent.test.js,no,,Keep legacy tests with the legacy runtime until replacement hooks/workflows are designed. -scripts/agents/__tests__/task-planner.agent.test.js,legacy-agent-runtime,defer,scripts/agents/__tests__/task-planner.agent.test.js,no,,Keep legacy tests with the legacy runtime until replacement hooks/workflows are designed. -scripts/agents/__tests__/task-researcher.agent.test.js,legacy-agent-runtime,defer,scripts/agents/__tests__/task-researcher.agent.test.js,no,,Keep legacy tests with the legacy runtime until replacement hooks/workflows are designed. -scripts/agents/__tests__/template.agent.test.js,legacy-agent-runtime,defer,scripts/agents/__tests__/template.agent.test.js,no,,Keep legacy tests with the legacy runtime until replacement hooks/workflows are designed. -scripts/agents/__tests__/testing.agent.test.js,legacy-agent-runtime,defer,scripts/agents/__tests__/testing.agent.test.js,no,,Keep legacy tests with the legacy runtime until replacement hooks/workflows are designed. -scripts/agents/adr.agent.js,legacy-agent-runtime,defer,hooks/adr.agent.js,yes,,Legacy runner; do not move blindly. Rewrite as a safe hook/workflow only when scoped. -scripts/agents/includes/README.md,legacy-agent-runtime,defer,scripts/agents/includes/README.md,yes,,Shared legacy utility; rewrite only the parts needed by new hooks or validators. -scripts/agents/includes/__tests__/README.md,legacy-agent-runtime,defer,scripts/agents/includes/__tests__/README.md,no,,Keep legacy tests with the legacy runtime until replacement hooks/workflows are designed. -scripts/agents/includes/__tests__/badgeUtils.test.js,legacy-agent-runtime,defer,scripts/agents/includes/__tests__/badgeUtils.test.js,no,,Keep legacy tests with the legacy runtime until replacement hooks/workflows are designed. -scripts/agents/includes/__tests__/build-label-alias-map.test.js,legacy-agent-runtime,defer,scripts/agents/includes/__tests__/build-label-alias-map.test.js,yes,,Keep legacy tests with the legacy runtime until replacement hooks/workflows are designed. -scripts/agents/includes/__tests__/build-labeling-report.test.js,legacy-agent-runtime,defer,scripts/agents/includes/__tests__/build-labeling-report.test.js,no,,Keep legacy tests with the legacy runtime until replacement hooks/workflows are designed. -scripts/agents/includes/__tests__/fetch-canonical-labels.test.js,legacy-agent-runtime,defer,scripts/agents/includes/__tests__/fetch-canonical-labels.test.js,yes,,Keep legacy tests with the legacy runtime until replacement hooks/workflows are designed. -scripts/agents/includes/__tests__/footerUtils.test.js,legacy-agent-runtime,defer,scripts/agents/includes/__tests__/footerUtils.test.js,no,,Keep legacy tests with the legacy runtime until replacement hooks/workflows are designed. -scripts/agents/includes/__tests__/label-utils.test.js,legacy-agent-runtime,defer,scripts/agents/includes/__tests__/label-utils.test.js,yes,,Keep legacy tests with the legacy runtime until replacement hooks/workflows are designed. -scripts/agents/includes/__tests__/readmeUtils.test.js,legacy-agent-runtime,defer,scripts/agents/includes/__tests__/readmeUtils.test.js,no,,Keep legacy tests with the legacy runtime until replacement hooks/workflows are designed. -scripts/agents/includes/__tests__/sync-version.test.js,legacy-agent-runtime,defer,scripts/agents/includes/__tests__/sync-version.test.js,no,,Keep legacy tests with the legacy runtime until replacement hooks/workflows are designed. -scripts/agents/includes/__tests__/update-readme.test.js,legacy-agent-runtime,defer,scripts/agents/includes/__tests__/update-readme.test.js,yes,,Keep legacy tests with the legacy runtime until replacement hooks/workflows are designed. -scripts/agents/includes/__tests__/yaml-parser.test.js,legacy-agent-runtime,defer,scripts/agents/includes/__tests__/yaml-parser.test.js,yes,,Keep legacy tests with the legacy runtime until replacement hooks/workflows are designed. -scripts/agents/includes/badgeUtils.js,legacy-agent-runtime,defer,scripts/agents/includes/badgeUtils.js,yes,,Shared legacy utility; rewrite only the parts needed by new hooks or validators. -scripts/agents/includes/badges.js,legacy-agent-runtime,defer,scripts/agents/includes/badges.js,yes,,Shared legacy utility; rewrite only the parts needed by new hooks or validators. -scripts/agents/includes/build-label-alias-map.js,legacy-agent-runtime,defer,scripts/agents/includes/build-label-alias-map.js,yes,,Shared legacy utility; rewrite only the parts needed by new hooks or validators. -scripts/agents/includes/build-labeling-report.js,legacy-agent-runtime,defer,scripts/agents/includes/build-labeling-report.js,no,,Shared legacy utility; rewrite only the parts needed by new hooks or validators. -scripts/agents/includes/changelogUtils.cjs,legacy-agent-runtime,defer,scripts/agents/includes/changelogUtils.cjs,yes,,Shared legacy utility; rewrite only the parts needed by new hooks or validators. -scripts/agents/includes/check-template-labels.js,legacy-agent-runtime,defer,scripts/agents/includes/check-template-labels.js,yes,,Shared legacy utility; rewrite only the parts needed by new hooks or validators. -scripts/agents/includes/en-gb-normalise.js,legacy-agent-runtime,defer,scripts/agents/includes/en-gb-normalise.js,no,,Shared legacy utility; rewrite only the parts needed by new hooks or validators. -scripts/agents/includes/fetch-canonical-labels.js,legacy-agent-runtime,defer,scripts/agents/includes/fetch-canonical-labels.js,yes,,Shared legacy utility; rewrite only the parts needed by new hooks or validators. -scripts/agents/includes/footer-content.json,legacy-agent-runtime,defer,scripts/agents/includes/footer-content.json,yes,,Shared legacy utility; rewrite only the parts needed by new hooks or validators. -scripts/agents/includes/footerUtils.js,legacy-agent-runtime,defer,scripts/agents/includes/footerUtils.js,yes,,Shared legacy utility; rewrite only the parts needed by new hooks or validators. -scripts/agents/includes/header-content.json,legacy-agent-runtime,defer,scripts/agents/includes/header-content.json,no,,Shared legacy utility; rewrite only the parts needed by new hooks or validators. -scripts/agents/includes/header-footer.js,legacy-agent-runtime,defer,scripts/agents/includes/header-footer.js,yes,,Shared legacy utility; rewrite only the parts needed by new hooks or validators. -scripts/agents/includes/label-heuristics.js,legacy-agent-runtime,defer,scripts/agents/includes/label-heuristics.js,no,,Shared legacy utility; rewrite only the parts needed by new hooks or validators. -scripts/agents/includes/label-lookup.js,legacy-agent-runtime,defer,scripts/agents/includes/label-lookup.js,yes,,Shared legacy utility; rewrite only the parts needed by new hooks or validators. -scripts/agents/includes/label-reporting.js,legacy-agent-runtime,defer,scripts/agents/includes/label-reporting.js,no,,Shared legacy utility; rewrite only the parts needed by new hooks or validators. -scripts/agents/includes/label-sync.js,legacy-agent-runtime,defer,scripts/agents/includes/label-sync.js,no,,Shared legacy utility; rewrite only the parts needed by new hooks or validators. -scripts/agents/includes/label-utils.js,legacy-agent-runtime,defer,scripts/agents/includes/label-utils.js,no,,Shared legacy utility; rewrite only the parts needed by new hooks or validators. -scripts/agents/includes/labeler-utils.js,legacy-agent-runtime,defer,scripts/agents/includes/labeler-utils.js,yes,,Shared legacy utility; rewrite only the parts needed by new hooks or validators. -scripts/agents/includes/readmeUtils.js,legacy-agent-runtime,defer,scripts/agents/includes/readmeUtils.js,no,,Shared legacy utility; rewrite only the parts needed by new hooks or validators. -scripts/agents/includes/report-writer.js,legacy-agent-runtime,defer,scripts/agents/includes/report-writer.js,yes,,Shared legacy utility; rewrite only the parts needed by new hooks or validators. -scripts/agents/includes/retry-helper.js,legacy-agent-runtime,defer,scripts/agents/includes/retry-helper.js,yes,,Shared legacy utility; rewrite only the parts needed by new hooks or validators. -scripts/agents/includes/status-enforcer.js,legacy-agent-runtime,defer,scripts/agents/includes/status-enforcer.js,yes,,Shared legacy utility; rewrite only the parts needed by new hooks or validators. -scripts/agents/includes/sync-version.js,legacy-agent-runtime,defer,scripts/agents/includes/sync-version.js,no,,Shared legacy utility; rewrite only the parts needed by new hooks or validators. -scripts/agents/includes/type-lookup.js,legacy-agent-runtime,defer,scripts/agents/includes/type-lookup.js,yes,,Shared legacy utility; rewrite only the parts needed by new hooks or validators. -scripts/agents/includes/update-readme.js,legacy-agent-runtime,defer,scripts/agents/includes/update-readme.js,no,,Shared legacy utility; rewrite only the parts needed by new hooks or validators. -scripts/agents/includes/yaml-parser.js,legacy-agent-runtime,defer,scripts/agents/includes/yaml-parser.js,yes,,Shared legacy utility; rewrite only the parts needed by new hooks or validators. -scripts/agents/includes/yaml-validator.js,legacy-agent-runtime,defer,scripts/agents/includes/yaml-validator.js,yes,,Shared legacy utility; rewrite only the parts needed by new hooks or validators. -scripts/agents/issue-type.agent.js,legacy-agent-runtime,defer,hooks/issue-type.agent.js,no,,Legacy runner; do not move blindly. Rewrite as a safe hook/workflow only when scoped. -scripts/agents/issues.agent.js,legacy-agent-runtime,defer,hooks/issues.agent.js,yes,,Legacy runner; do not move blindly. Rewrite as a safe hook/workflow only when scoped. -scripts/agents/labeling.agent.js,legacy-agent-runtime,defer,hooks/labeling.agent.js,yes,,Legacy runner; do not move blindly. Rewrite as a safe hook/workflow only when scoped. -scripts/agents/linting.agent.js,legacy-agent-runtime,defer,hooks/linting.agent.js,yes,,Legacy runner; do not move blindly. Rewrite as a safe hook/workflow only when scoped. -scripts/agents/meta.agent.js,legacy-agent-runtime,defer,hooks/meta.agent.js,yes,,Legacy runner; do not move blindly. Rewrite as a safe hook/workflow only when scoped. -scripts/agents/metrics.agent.js,legacy-agent-runtime,defer,hooks/metrics.agent.js,yes,,Legacy runner; do not move blindly. Rewrite as a safe hook/workflow only when scoped. -scripts/agents/mode-demonstrate-understanding.agent.js,legacy-agent-runtime,defer,hooks/mode-demonstrate-understanding.agent.js,yes,,Legacy runner; do not move blindly. Rewrite as a safe hook/workflow only when scoped. -scripts/agents/mode-document-reviewer.agent.js,legacy-agent-runtime,defer,hooks/mode-document-reviewer.agent.js,yes,,Legacy runner; do not move blindly. Rewrite as a safe hook/workflow only when scoped. -scripts/agents/mode-prd.agent.js,legacy-agent-runtime,defer,hooks/mode-prd.agent.js,yes,,Legacy runner; do not move blindly. Rewrite as a safe hook/workflow only when scoped. -scripts/agents/mode-thinking.agent.js,legacy-agent-runtime,defer,hooks/mode-thinking.agent.js,yes,,Legacy runner; do not move blindly. Rewrite as a safe hook/workflow only when scoped. -scripts/agents/planner.agent.js,legacy-agent-runtime,defer,hooks/planner.agent.js,yes,,Legacy runner; do not move blindly. Rewrite as a safe hook/workflow only when scoped. -scripts/agents/project-meta-sync.agent.js,legacy-agent-runtime,defer,hooks/project-meta-sync.agent.js,yes,,Legacy runner; do not move blindly. Rewrite as a safe hook/workflow only when scoped. -scripts/agents/prompt-engineer.agent.js,legacy-agent-runtime,defer,hooks/prompt-engineer.agent.js,yes,,Legacy runner; do not move blindly. Rewrite as a safe hook/workflow only when scoped. -scripts/agents/release.agent.js,legacy-agent-runtime,defer,hooks/release.agent.js,yes,,Legacy runner; do not move blindly. Rewrite as a safe hook/workflow only when scoped. -scripts/agents/reporting.agent.js,legacy-agent-runtime,defer,hooks/reporting.agent.js,yes,,Legacy runner; do not move blindly. Rewrite as a safe hook/workflow only when scoped. -scripts/agents/reviewer.agent.js,legacy-agent-runtime,defer,hooks/reviewer.agent.js,yes,,Legacy runner; do not move blindly. Rewrite as a safe hook/workflow only when scoped. -scripts/agents/task-planner.agent.js,legacy-agent-runtime,defer,hooks/task-planner.agent.js,yes,,Legacy runner; do not move blindly. Rewrite as a safe hook/workflow only when scoped. -scripts/agents/task-researcher.agent.js,legacy-agent-runtime,defer,hooks/task-researcher.agent.js,yes,,Legacy runner; do not move blindly. Rewrite as a safe hook/workflow only when scoped. -scripts/agents/template.agent.js,legacy-agent-runtime,defer,hooks/template.agent.js,yes,,Legacy runner; do not move blindly. Rewrite as a safe hook/workflow only when scoped. -scripts/agents/testing.agent.js,legacy-agent-runtime,defer,hooks/testing.agent.js,yes,,Legacy runner; do not move blindly. Rewrite as a safe hook/workflow only when scoped. -scripts/validation/README.md,legacy-validation-runtime,defer,workflows/validation/README.md,yes,,"Use as reference for the smaller validation reset, not as-is migration." -scripts/validation/__fixtures__/invalid-coderabbit.yml,legacy-validation-runtime,defer,scripts/validation/__fixtures__/invalid-coderabbit.yml,no,,Keep validation tests/fixtures with legacy validation until the reset lands. -scripts/validation/__fixtures__/valid-coderabbit.yml,legacy-validation-runtime,defer,scripts/validation/__fixtures__/valid-coderabbit.yml,no,,Keep validation tests/fixtures with legacy validation until the reset lands. -scripts/validation/__tests__/run-agent-handoff-audit.test.js,legacy-validation-runtime,defer,scripts/validation/__tests__/run-agent-handoff-audit.test.js,no,,Keep validation tests/fixtures with legacy validation until the reset lands. -scripts/validation/__tests__/validate-agent-frontmatter.test.js,legacy-validation-runtime,defer,scripts/validation/__tests__/validate-agent-frontmatter.test.js,no,,Keep validation tests/fixtures with legacy validation until the reset lands. -scripts/validation/__tests__/validate-agents.test.js,legacy-validation-runtime,defer,scripts/validation/__tests__/validate-agents.test.js,no,,Keep validation tests/fixtures with legacy validation until the reset lands. -scripts/validation/__tests__/validate-changelog.test.js,legacy-validation-runtime,defer,scripts/validation/__tests__/validate-changelog.test.js,no,,Keep validation tests/fixtures with legacy validation until the reset lands. -scripts/validation/__tests__/validate-coderabbit-yml.test.js,legacy-validation-runtime,defer,scripts/validation/__tests__/validate-coderabbit-yml.test.js,no,,Keep validation tests/fixtures with legacy validation until the reset lands. -scripts/validation/__tests__/validate-frontmatter-alt.test.js,legacy-validation-runtime,defer,scripts/validation/__tests__/validate-frontmatter-alt.test.js,no,,Keep validation tests/fixtures with legacy validation until the reset lands. -scripts/validation/__tests__/validate-frontmatter.test.js,legacy-validation-runtime,defer,scripts/validation/__tests__/validate-frontmatter.test.js,no,,Keep validation tests/fixtures with legacy validation until the reset lands. -scripts/validation/__tests__/validate-json.test.js,legacy-validation-runtime,defer,scripts/validation/__tests__/validate-json.test.js,no,,Keep validation tests/fixtures with legacy validation until the reset lands. -scripts/validation/__tests__/validate-version.test.js,legacy-validation-runtime,defer,scripts/validation/__tests__/validate-version.test.js,no,,Keep validation tests/fixtures with legacy validation until the reset lands. -scripts/validation/__tests__/validate-workflows.test.js,legacy-validation-runtime,defer,scripts/validation/__tests__/validate-workflows.test.js,no,,Keep validation tests/fixtures with legacy validation until the reset lands. -scripts/validation/package.json,legacy-validation-runtime,defer,workflows/validation/package.json,yes,,Legacy validator; replace with smaller non-mutating validation before moving. -scripts/validation/run-agent-handoff-audit.js,legacy-validation-runtime,defer,workflows/validation/run-agent-handoff-audit.js,yes,,Legacy validator; replace with smaller non-mutating validation before moving. -scripts/validation/update-coderabbit-schema.cjs,legacy-validation-runtime,defer,workflows/validation/update-coderabbit-schema.cjs,yes,,Legacy validator; replace with smaller non-mutating validation before moving. -scripts/validation/validate-agent-frontmatter.js,legacy-validation-runtime,defer,workflows/validation/validate-agent-frontmatter.js,yes,,Legacy validator; replace with smaller non-mutating validation before moving. -scripts/validation/validate-agents.js,legacy-validation-runtime,defer,workflows/validation/validate-agents.js,yes,,Legacy validator; replace with smaller non-mutating validation before moving. -scripts/validation/validate-changelog.cjs,legacy-validation-runtime,defer,workflows/validation/validate-changelog.cjs,yes,,Legacy validator; replace with smaller non-mutating validation before moving. -scripts/validation/validate-coderabbit-yml.cjs,legacy-validation-runtime,defer,workflows/validation/validate-coderabbit-yml.cjs,yes,,Legacy validator; replace with smaller non-mutating validation before moving. -scripts/validation/validate-coderabbit-yml.test.js,legacy-validation-runtime,defer,scripts/validation/validate-coderabbit-yml.test.js,no,,Keep validation tests/fixtures with legacy validation until the reset lands. -scripts/validation/validate-frontmatter.js,legacy-validation-runtime,defer,workflows/validation/validate-frontmatter.js,yes,,Legacy validator; replace with smaller non-mutating validation before moving. -scripts/validation/validate-json.js,legacy-validation-runtime,defer,workflows/validation/validate-json.js,yes,,Legacy validator; replace with smaller non-mutating validation before moving. -scripts/validation/validate-version.cjs,legacy-validation-runtime,defer,workflows/validation/validate-version.cjs,yes,,Legacy validator; replace with smaller non-mutating validation before moving. -scripts/validation/validate-workflows.js,legacy-validation-runtime,defer,workflows/validation/validate-workflows.js,yes,,Legacy validator; replace with smaller non-mutating validation before moving. -.github/ISSUE_TEMPLATE/01-task.md,github-issue-template,keep,.github/ISSUE_TEMPLATE/01-task.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/ISSUE_TEMPLATE/02-bug.md,github-issue-template,keep,.github/ISSUE_TEMPLATE/02-bug.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/ISSUE_TEMPLATE/03-feature.md,github-issue-template,keep,.github/ISSUE_TEMPLATE/03-feature.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/ISSUE_TEMPLATE/04-design.md,github-issue-template,keep,.github/ISSUE_TEMPLATE/04-design.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/ISSUE_TEMPLATE/05-epic.md,github-issue-template,keep,.github/ISSUE_TEMPLATE/05-epic.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/ISSUE_TEMPLATE/06-story.md,github-issue-template,keep,.github/ISSUE_TEMPLATE/06-story.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/ISSUE_TEMPLATE/07-improvement.md,github-issue-template,keep,.github/ISSUE_TEMPLATE/07-improvement.md,yes,,GitHub-native/community-health content should remain in .github governance scope. -.github/ISSUE_TEMPLATE/07-user-experience-feedback.md,github-issue-template,keep,.github/ISSUE_TEMPLATE/07-user-experience-feedback.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/ISSUE_TEMPLATE/08-code-refactor.md,github-issue-template,keep,.github/ISSUE_TEMPLATE/08-code-refactor.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/ISSUE_TEMPLATE/09-build-ci.md,github-issue-template,keep,.github/ISSUE_TEMPLATE/09-build-ci.md,yes,,GitHub-native/community-health content should remain in .github governance scope. -.github/ISSUE_TEMPLATE/10-automation.md,github-issue-template,keep,.github/ISSUE_TEMPLATE/10-automation.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/ISSUE_TEMPLATE/11-testing-coverage.md,github-issue-template,keep,.github/ISSUE_TEMPLATE/11-testing-coverage.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/ISSUE_TEMPLATE/12-performance.md,github-issue-template,keep,.github/ISSUE_TEMPLATE/12-performance.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/ISSUE_TEMPLATE/13-a11y.md,github-issue-template,keep,.github/ISSUE_TEMPLATE/13-a11y.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/ISSUE_TEMPLATE/14-security.md,github-issue-template,keep,.github/ISSUE_TEMPLATE/14-security.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/ISSUE_TEMPLATE/15-compatibility.md,github-issue-template,keep,.github/ISSUE_TEMPLATE/15-compatibility.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/ISSUE_TEMPLATE/16-integration-issue.md,github-issue-template,keep,.github/ISSUE_TEMPLATE/16-integration-issue.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/ISSUE_TEMPLATE/17-release.md,github-issue-template,keep,.github/ISSUE_TEMPLATE/17-release.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/ISSUE_TEMPLATE/18-maintenance.md,github-issue-template,keep,.github/ISSUE_TEMPLATE/18-maintenance.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/ISSUE_TEMPLATE/19-documentation.md,github-issue-template,keep,.github/ISSUE_TEMPLATE/19-documentation.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/ISSUE_TEMPLATE/20-research.md,github-issue-template,keep,.github/ISSUE_TEMPLATE/20-research.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/ISSUE_TEMPLATE/21-audit.md,github-issue-template,keep,.github/ISSUE_TEMPLATE/21-audit.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/ISSUE_TEMPLATE/22-code-review.md,github-issue-template,keep,.github/ISSUE_TEMPLATE/22-code-review.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/ISSUE_TEMPLATE/23-ai-ops.md,github-issue-template,keep,.github/ISSUE_TEMPLATE/23-ai-ops.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/ISSUE_TEMPLATE/24-content-modelling.md,github-issue-template,keep,.github/ISSUE_TEMPLATE/24-content-modelling.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/ISSUE_TEMPLATE/25-help.md,github-issue-template,keep,.github/ISSUE_TEMPLATE/25-help.md,no,,GitHub-native/community-health content should remain in .github governance scope. -".github/ISSUE_TEMPLATE/Icon ",github-issue-template,delete,,no,,Remove zero-byte macOS metadata after link audit; not a portable asset. -.github/ISSUE_TEMPLATE/README.md,github-issue-template,keep,.github/ISSUE_TEMPLATE/README.md,yes,,GitHub-native/community-health content should remain in .github governance scope. -.github/ISSUE_TEMPLATE/config.yml,github-issue-template,keep,.github/ISSUE_TEMPLATE/config.yml,no,,GitHub-native/community-health content should remain in .github governance scope. -".github/SAVED_REPLIES/Icon ",saved-reply,delete,,no,,Remove zero-byte macOS metadata after link audit; not a portable asset. -.github/SAVED_REPLIES/README.md,saved-reply,keep,.github/SAVED_REPLIES/README.md,no,,GitHub-native/community-health content should remain in .github governance scope. -".github/SAVED_REPLIES/community/Icon ",saved-reply,delete,,no,,Remove zero-byte macOS metadata after link audit; not a portable asset. -.github/SAVED_REPLIES/community/code-of-conduct.md,saved-reply,keep,.github/SAVED_REPLIES/community/code-of-conduct.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/community/contribution-thanks.md,saved-reply,keep,.github/SAVED_REPLIES/community/contribution-thanks.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/community/guidelines.md,saved-reply,keep,.github/SAVED_REPLIES/community/guidelines.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/community/legal.md,saved-reply,keep,.github/SAVED_REPLIES/community/legal.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/community/welcome.md,saved-reply,keep,.github/SAVED_REPLIES/community/welcome.md,no,,GitHub-native/community-health content should remain in .github governance scope. -".github/SAVED_REPLIES/issues/Icon ",saved-reply,delete,,no,,Remove zero-byte macOS metadata after link audit; not a portable asset. -.github/SAVED_REPLIES/issues/a11y-acknowledge.md,saved-reply,keep,.github/SAVED_REPLIES/issues/a11y-acknowledge.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/issues/area-routing.md,saved-reply,keep,.github/SAVED_REPLIES/issues/area-routing.md,yes,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/issues/blockers.md,saved-reply,keep,.github/SAVED_REPLIES/issues/blockers.md,yes,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/issues/bug-reports.md,saved-reply,keep,.github/SAVED_REPLIES/issues/bug-reports.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/issues/documentation.md,saved-reply,keep,.github/SAVED_REPLIES/issues/documentation.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/issues/duplicate.md,saved-reply,keep,.github/SAVED_REPLIES/issues/duplicate.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/issues/duplicates.md,saved-reply,keep,.github/SAVED_REPLIES/issues/duplicates.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/issues/epic-tracking.md,saved-reply,keep,.github/SAVED_REPLIES/issues/epic-tracking.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/issues/feature-requests.md,saved-reply,keep,.github/SAVED_REPLIES/issues/feature-requests.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/issues/good-first-issue.md,saved-reply,keep,.github/SAVED_REPLIES/issues/good-first-issue.md,yes,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/issues/inactive-issue.md,saved-reply,keep,.github/SAVED_REPLIES/issues/inactive-issue.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/issues/label-clarification.md,saved-reply,keep,.github/SAVED_REPLIES/issues/label-clarification.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/issues/meta-label-nudge.md,saved-reply,keep,.github/SAVED_REPLIES/issues/meta-label-nudge.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/issues/missing-info.md,saved-reply,keep,.github/SAVED_REPLIES/issues/missing-info.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/issues/more-info.md,saved-reply,keep,.github/SAVED_REPLIES/issues/more-info.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/issues/needs-reproduction.md,saved-reply,keep,.github/SAVED_REPLIES/issues/needs-reproduction.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/issues/research-completion.md,saved-reply,keep,.github/SAVED_REPLIES/issues/research-completion.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/issues/security-acknowledge.md,saved-reply,keep,.github/SAVED_REPLIES/issues/security-acknowledge.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/issues/stale-abandoned.md,saved-reply,keep,.github/SAVED_REPLIES/issues/stale-abandoned.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/issues/support.md,saved-reply,keep,.github/SAVED_REPLIES/issues/support.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/issues/triage.md,saved-reply,keep,.github/SAVED_REPLIES/issues/triage.md,yes,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/issues/wontfix.md,saved-reply,keep,.github/SAVED_REPLIES/issues/wontfix.md,no,,GitHub-native/community-health content should remain in .github governance scope. -".github/SAVED_REPLIES/pull-requests/Icon ",saved-reply,delete,,no,,Remove zero-byte macOS metadata after link audit; not a portable asset. -.github/SAVED_REPLIES/pull-requests/ai-assist.md,saved-reply,keep,.github/SAVED_REPLIES/pull-requests/ai-assist.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/pull-requests/area-labeling.md,saved-reply,keep,.github/SAVED_REPLIES/pull-requests/area-labeling.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/pull-requests/area-routing.md,saved-reply,keep,.github/SAVED_REPLIES/pull-requests/area-routing.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/pull-requests/automated-dependency-update.md,saved-reply,keep,.github/SAVED_REPLIES/pull-requests/automated-dependency-update.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/pull-requests/awaiting-author.md,saved-reply,keep,.github/SAVED_REPLIES/pull-requests/awaiting-author.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/pull-requests/branch-naming.md,saved-reply,keep,.github/SAVED_REPLIES/pull-requests/branch-naming.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/pull-requests/changelog-required.md,saved-reply,keep,.github/SAVED_REPLIES/pull-requests/changelog-required.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/pull-requests/closing-inactive.md,saved-reply,keep,.github/SAVED_REPLIES/pull-requests/closing-inactive.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/pull-requests/code-review.md,saved-reply,keep,.github/SAVED_REPLIES/pull-requests/code-review.md,yes,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/pull-requests/conflicts.md,saved-reply,keep,.github/SAVED_REPLIES/pull-requests/conflicts.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/pull-requests/dependency-update.md,saved-reply,keep,.github/SAVED_REPLIES/pull-requests/dependency-update.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/pull-requests/documentation-pr.md,saved-reply,keep,.github/SAVED_REPLIES/pull-requests/documentation-pr.md,yes,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/pull-requests/draft-pr.md,saved-reply,keep,.github/SAVED_REPLIES/pull-requests/draft-pr.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/pull-requests/merge-discipline.md,saved-reply,keep,.github/SAVED_REPLIES/pull-requests/merge-discipline.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/pull-requests/missing-labels.md,saved-reply,keep,.github/SAVED_REPLIES/pull-requests/missing-labels.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/pull-requests/needs-qa.md,saved-reply,keep,.github/SAVED_REPLIES/pull-requests/needs-qa.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/pull-requests/performance.md,saved-reply,keep,.github/SAVED_REPLIES/pull-requests/performance.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/pull-requests/ready-for-review.md,saved-reply,keep,.github/SAVED_REPLIES/pull-requests/ready-for-review.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/pull-requests/release-label-guidance.md,saved-reply,keep,.github/SAVED_REPLIES/pull-requests/release-label-guidance.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/pull-requests/security.md,saved-reply,keep,.github/SAVED_REPLIES/pull-requests/security.md,yes,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/pull-requests/testing.md,saved-reply,keep,.github/SAVED_REPLIES/pull-requests/testing.md,yes,,GitHub-native/community-health content should remain in .github governance scope. -".github/SAVED_REPLIES/technical/Icon ",saved-reply,delete,,no,,Remove zero-byte macOS metadata after link audit; not a portable asset. -.github/SAVED_REPLIES/technical/api-integration.md,saved-reply,keep,.github/SAVED_REPLIES/technical/api-integration.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/technical/code-style.md,saved-reply,keep,.github/SAVED_REPLIES/technical/code-style.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/technical/configuration.md,saved-reply,keep,.github/SAVED_REPLIES/technical/configuration.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/technical/dependencies.md,saved-reply,keep,.github/SAVED_REPLIES/technical/dependencies.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/technical/dependency-update.md,saved-reply,keep,.github/SAVED_REPLIES/technical/dependency-update.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/technical/environment-config.md,saved-reply,keep,.github/SAVED_REPLIES/technical/environment-config.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/technical/environment.md,saved-reply,keep,.github/SAVED_REPLIES/technical/environment.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/technical/missing-tests.md,saved-reply,keep,.github/SAVED_REPLIES/technical/missing-tests.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/technical/performance.md,saved-reply,keep,.github/SAVED_REPLIES/technical/performance.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/technical/security.md,saved-reply,keep,.github/SAVED_REPLIES/technical/security.md,yes,,GitHub-native/community-health content should remain in .github governance scope. -".github/SAVED_REPLIES/workflow/Icon ",saved-reply,delete,,no,,Remove zero-byte macOS metadata after link audit; not a portable asset. -.github/SAVED_REPLIES/workflow/automation.md,saved-reply,keep,.github/SAVED_REPLIES/workflow/automation.md,yes,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/workflow/branch-management.md,saved-reply,keep,.github/SAVED_REPLIES/workflow/branch-management.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/workflow/branches.md,saved-reply,keep,.github/SAVED_REPLIES/workflow/branches.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/workflow/changelog-versioning.md,saved-reply,keep,.github/SAVED_REPLIES/workflow/changelog-versioning.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/workflow/cicd-failures.md,saved-reply,keep,.github/SAVED_REPLIES/workflow/cicd-failures.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/workflow/dependency-update.md,saved-reply,keep,.github/SAVED_REPLIES/workflow/dependency-update.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/workflow/deployment.md,saved-reply,keep,.github/SAVED_REPLIES/workflow/deployment.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/workflow/draft-pr.md,saved-reply,keep,.github/SAVED_REPLIES/workflow/draft-pr.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/workflow/environment-config.md,saved-reply,keep,.github/SAVED_REPLIES/workflow/environment-config.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/workflow/labeling.md,saved-reply,keep,.github/SAVED_REPLIES/workflow/labeling.md,yes,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/workflow/needs-rebase.md,saved-reply,keep,.github/SAVED_REPLIES/workflow/needs-rebase.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/workflow/permissions-secrets.md,saved-reply,keep,.github/SAVED_REPLIES/workflow/permissions-secrets.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/workflow/project-sync.md,saved-reply,keep,.github/SAVED_REPLIES/workflow/project-sync.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/workflow/release-management.md,saved-reply,keep,.github/SAVED_REPLIES/workflow/release-management.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/workflow/releases.md,saved-reply,keep,.github/SAVED_REPLIES/workflow/releases.md,no,,GitHub-native/community-health content should remain in .github governance scope. -.github/SAVED_REPLIES/workflow/workflow-failure.md,saved-reply,keep,.github/SAVED_REPLIES/workflow/workflow-failure.md,no,,GitHub-native/community-health content should remain in .github governance scope. -======= source_path,asset_type,decision,target_path,hard_coded_github_path,follow_up_issue,rationale .github/agents/README.md,agent-spec,convert,agents/README.md + .github/agents/README.md,yes,#296,Portable agent ownership index lives at /agents; .github retains a repo-local boundary pointer. .github/agents/adr.agent.md,agent-spec,move,agents/adr.agent.md,no,#296,Moved portable agent spec to /agents and updated active links while leaving scripts/agents as legacy runtime. @@ -462,79 +74,79 @@ source_path,asset_type,decision,target_path,hard_coded_github_path,follow_up_iss .github/instructions/template.instructions.md,instruction,move,instructions/template.instructions.md,yes,#295,Moved portable instruction to /instructions and updated active links and indexes. .github/instructions/tools.instructions.md,instruction,move,instructions/tools.instructions.md,no,#295,Moved portable instruction to /instructions and updated active links and indexes. .github/instructions/workflows.instructions.md,instruction,move,instructions/workflows.instructions.md,yes,#295,Moved portable instruction to /instructions and updated active links and indexes. -.github/prompts/README.md,prompt,convert,cookbook/README.md,no,,Prompt indexes become cookbook/backlog material rather than first-class installable assets. -.github/prompts/add-frontmatter.prompt.md,prompt,convert,skills/add-frontmatter/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/agent-task-markdown-linting.prompt.md,prompt,convert,skills/agent-task-markdown-linting/SKILL.md,yes,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/agents.prompt.md,prompt,convert,skills/agents/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/architecture-blueprint-generator.prompt.md,prompt,convert,cookbook/architecture-blueprint-generator.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/breakdown-epic-arch.prompt.md,prompt,convert,cookbook/breakdown-epic-arch.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/breakdown-epic-pm.prompt.md,prompt,convert,cookbook/breakdown-epic-pm.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/breakdown-feature-implementation.prompt.md,prompt,convert,skills/breakdown-feature-implementation/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/breakdown-feature-prd.prompt.md,prompt,convert,cookbook/breakdown-feature-prd.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/breakdown-plan.prompt.md,prompt,convert,cookbook/breakdown-plan.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/breakdown-test.prompt.md,prompt,convert,cookbook/breakdown-test.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/build-agent-and-tests.prompt.md,prompt,convert,skills/build-agent-and-tests/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/changelog-lines.prompt.md,prompt,convert,skills/changelog-lines/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/changelog.prompt.md,prompt,convert,skills/changelog/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/code-review.prompt.md,prompt,convert,skills/code-review/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/conventional-commit.prompt.md,prompt,convert,cookbook/conventional-commit.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/create-agentsmd.prompt.md,prompt,convert,skills/create-agentsmd/SKILL.md,yes,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/create-architectural-decision-record.prompt.md,prompt,convert,cookbook/create-architectural-decision-record.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/create-github-action-workflow-specification.prompt.md,prompt,convert,skills/create-github-action-workflow-specification/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/create-github-issue-feature-from-specification.prompt.md,prompt,convert,skills/create-github-issue-feature-from-specification/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/create-github-issues-feature-from-implementation-plan.prompt.md,prompt,convert,skills/create-github-issues-feature-from-implementation-plan/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/create-github-issues-for-unmet-specification-requirements.prompt.md,prompt,convert,skills/create-github-issues-for-unmet-specification-requirements/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/create-github-pull-request-from-specification.prompt.md,prompt,convert,skills/create-github-pull-request-from-specification/SKILL.md,yes,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/create-implementation-plan.prompt.md,prompt,convert,skills/create-implementation-plan/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/create-llms.prompt.md,prompt,convert,cookbook/create-llms.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/create-readme.prompt.md,prompt,convert,skills/create-readme/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/create-specification.prompt.md,prompt,convert,skills/create-specification/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/dependency-audit-agent.prompt.md,prompt,convert,skills/dependency-audit-agent/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/docs-from-comments.prompt.md,prompt,convert,cookbook/docs-from-comments.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/docs-writeup.prompt.md,prompt,convert,cookbook/docs-writeup.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/documentation-writer.prompt.md,prompt,convert,cookbook/documentation-writer.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/editorconfig.prompt.md,prompt,convert,cookbook/editorconfig.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/finalize-agent-prompt.prompt.md,prompt,convert,skills/finalize-agent-prompt/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/folder-structure-blueprint-generator.prompt.md,prompt,convert,cookbook/folder-structure-blueprint-generator.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/generate-changelog.prompt.md,prompt,convert,skills/generate-changelog/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/generate-custom-instructions-from-codebase.prompt.md,prompt,convert,cookbook/generate-custom-instructions-from-codebase.prompt.md,yes,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/generate-gh-workflow.prompt.md,prompt,convert,skills/generate-gh-workflow/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/generate-pr-description.prompt.md,prompt,convert,cookbook/generate-pr-description.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/git-flow-branch-creator.prompt.md,prompt,convert,cookbook/git-flow-branch-creator.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/github-copilot-starter.prompt.md,prompt,convert,cookbook/github-copilot-starter.prompt.md,yes,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/inline-documentation.prompt.md,prompt,convert,cookbook/inline-documentation.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/labeling.prompt.md,prompt,convert,skills/labeling/SKILL.md,yes,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/model-recommendation.prompt.md,prompt,convert,cookbook/model-recommendation.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/multi-stage-dockerfile.prompt.md,prompt,convert,cookbook/multi-stage-dockerfile.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/my-issues.prompt.md,prompt,convert,cookbook/my-issues.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/my-pull-requests.prompt.md,prompt,convert,cookbook/my-pull-requests.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/normalize-docs-labels.prompt.md,prompt,convert,skills/normalize-docs-labels/SKILL.md,yes,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/pr-description.prompt.md,prompt,convert,cookbook/pr-description.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/pr-review.prompt.md,prompt,convert,skills/pr-review/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/project-workflow-analysis-blueprint-generator.prompt.md,prompt,convert,skills/project-workflow-analysis-blueprint-generator/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/prompt-builder.prompt.md,prompt,convert,cookbook/prompt-builder.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/prompts.md,prompt,convert,cookbook/prompts.md,no,,Prompt indexes become cookbook/backlog material rather than first-class installable assets. -.github/prompts/python-mcp-server-generator.prompt.md,prompt,convert,cookbook/python-mcp-server-generator.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/readme-blueprint-generator.prompt.md,prompt,convert,skills/readme-blueprint-generator/SKILL.md,yes,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/release.prompt.md,prompt,convert,skills/release/SKILL.md,yes,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/remember-interactive-programming.prompt.md,prompt,convert,cookbook/remember-interactive-programming.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/remember.prompt.md,prompt,convert,cookbook/remember.prompt.md,yes,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/repo-story-time.prompt.md,prompt,convert,cookbook/repo-story-time.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/reporting.prompt.md,prompt,convert,cookbook/reporting.prompt.md,yes,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/review-and-refactor.prompt.md,prompt,convert,skills/review-and-refactor/SKILL.md,yes,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/saved-replies.prompt.md,prompt,convert,cookbook/saved-replies.prompt.md,yes,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/shuffle-json-data.prompt.md,prompt,convert,cookbook/shuffle-json-data.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/spec-driven-workflow-start.prompt.md,prompt,convert,skills/spec-driven-workflow-start/SKILL.md,yes,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/technology-stack-blueprint-generator.prompt.md,prompt,convert,cookbook/technology-stack-blueprint-generator.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/testing.prompt.md,prompt,convert,skills/testing/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/update-implementation-plan.prompt.md,prompt,convert,skills/update-implementation-plan/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/update-llms.prompt.md,prompt,convert,cookbook/update-llms.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/update-markdown-file-index.prompt.md,prompt,convert,cookbook/update-markdown-file-index.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/update-mermaid-diagrams.prompt.md,prompt,convert,cookbook/update-mermaid-diagrams.prompt.md,yes,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/update-oo-component-documentation.prompt.md,prompt,convert,cookbook/update-oo-component-documentation.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. -.github/prompts/update-readmes.prompt.md,prompt,convert,skills/update-readmes/SKILL.md,yes,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/update-specification.prompt.md,prompt,convert,skills/update-specification/SKILL.md,no,,Durable workflow prompt should become a self-contained skill if still useful. -.github/prompts/write-coding-standards-from-file.prompt.md,prompt,convert,cookbook/write-coding-standards-from-file.prompt.md,no,,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. +.github/prompts/README.md,prompt,convert,cookbook/README.md,no,#299,Prompt indexes become cookbook/backlog material rather than first-class installable assets. +.github/prompts/add-frontmatter.prompt.md,prompt,convert,skills/add-frontmatter/SKILL.md,no,#299,Durable workflow prompt should become a self-contained skill if still useful. +.github/prompts/agent-task-markdown-linting.prompt.md,prompt,convert,skills/agent-task-markdown-linting/SKILL.md,yes,#299,Durable workflow prompt should become a self-contained skill if still useful. +.github/prompts/agents.prompt.md,prompt,convert,skills/agents/SKILL.md,no,#299,Durable workflow prompt should become a self-contained skill if still useful. +.github/prompts/architecture-blueprint-generator.prompt.md,prompt,convert,cookbook/architecture-blueprint-generator.prompt.md,no,#299,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. +.github/prompts/breakdown-epic-arch.prompt.md,prompt,convert,cookbook/breakdown-epic-arch.prompt.md,no,#299,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. +.github/prompts/breakdown-epic-pm.prompt.md,prompt,convert,cookbook/breakdown-epic-pm.prompt.md,no,#299,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. +.github/prompts/breakdown-feature-implementation.prompt.md,prompt,convert,skills/breakdown-feature-implementation/SKILL.md,no,#299,Durable workflow prompt should become a self-contained skill if still useful. +.github/prompts/breakdown-feature-prd.prompt.md,prompt,convert,cookbook/breakdown-feature-prd.prompt.md,no,#299,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. +.github/prompts/breakdown-plan.prompt.md,prompt,convert,cookbook/breakdown-plan.prompt.md,no,#299,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. +.github/prompts/breakdown-test.prompt.md,prompt,convert,cookbook/breakdown-test.prompt.md,no,#299,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. +.github/prompts/build-agent-and-tests.prompt.md,prompt,convert,skills/build-agent-and-tests/SKILL.md,no,#299,Durable workflow prompt should become a self-contained skill if still useful. +.github/prompts/changelog-lines.prompt.md,prompt,convert,skills/changelog-lines/SKILL.md,no,#299,Durable workflow prompt should become a self-contained skill if still useful. +.github/prompts/changelog.prompt.md,prompt,convert,skills/changelog/SKILL.md,no,#299,Durable workflow prompt should become a self-contained skill if still useful. +.github/prompts/code-review.prompt.md,prompt,convert,skills/code-review/SKILL.md,no,#299,Durable workflow prompt should become a self-contained skill if still useful. +.github/prompts/conventional-commit.prompt.md,prompt,convert,cookbook/conventional-commit.prompt.md,no,#299,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. +.github/prompts/create-agentsmd.prompt.md,prompt,convert,skills/create-agentsmd/SKILL.md,yes,#299,Durable workflow prompt should become a self-contained skill if still useful. +.github/prompts/create-architectural-decision-record.prompt.md,prompt,convert,cookbook/create-architectural-decision-record.prompt.md,no,#299,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. +.github/prompts/create-github-action-workflow-specification.prompt.md,prompt,convert,skills/create-github-action-workflow-specification/SKILL.md,no,#299,Durable workflow prompt should become a self-contained skill if still useful. +.github/prompts/create-github-issue-feature-from-specification.prompt.md,prompt,convert,skills/create-github-issue-feature-from-specification/SKILL.md,no,#299,Durable workflow prompt should become a self-contained skill if still useful. +.github/prompts/create-github-issues-feature-from-implementation-plan.prompt.md,prompt,convert,skills/create-github-issues-feature-from-implementation-plan/SKILL.md,no,#299,Durable workflow prompt should become a self-contained skill if still useful. +.github/prompts/create-github-issues-for-unmet-specification-requirements.prompt.md,prompt,convert,skills/create-github-issues-for-unmet-specification-requirements/SKILL.md,no,#299,Durable workflow prompt should become a self-contained skill if still useful. +.github/prompts/create-github-pull-request-from-specification.prompt.md,prompt,convert,skills/create-github-pull-request-from-specification/SKILL.md,yes,#299,Durable workflow prompt should become a self-contained skill if still useful. +.github/prompts/create-implementation-plan.prompt.md,prompt,convert,skills/create-implementation-plan/SKILL.md,no,#299,Durable workflow prompt should become a self-contained skill if still useful. +.github/prompts/create-llms.prompt.md,prompt,convert,cookbook/create-llms.prompt.md,no,#299,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. +.github/prompts/create-readme.prompt.md,prompt,convert,skills/create-readme/SKILL.md,no,#299,Durable workflow prompt should become a self-contained skill if still useful. +.github/prompts/create-specification.prompt.md,prompt,convert,skills/create-specification/SKILL.md,no,#299,Durable workflow prompt should become a self-contained skill if still useful. +.github/prompts/dependency-audit-agent.prompt.md,prompt,convert,skills/dependency-audit-agent/SKILL.md,no,#299,Durable workflow prompt should become a self-contained skill if still useful. +.github/prompts/docs-from-comments.prompt.md,prompt,convert,cookbook/docs-from-comments.prompt.md,no,#299,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. +.github/prompts/docs-writeup.prompt.md,prompt,convert,cookbook/docs-writeup.prompt.md,no,#299,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. +.github/prompts/documentation-writer.prompt.md,prompt,convert,cookbook/documentation-writer.prompt.md,no,#299,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. +.github/prompts/editorconfig.prompt.md,prompt,convert,cookbook/editorconfig.prompt.md,no,#299,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. +.github/prompts/finalize-agent-prompt.prompt.md,prompt,convert,skills/finalize-agent-prompt/SKILL.md,no,#299,Durable workflow prompt should become a self-contained skill if still useful. +.github/prompts/folder-structure-blueprint-generator.prompt.md,prompt,convert,cookbook/folder-structure-blueprint-generator.prompt.md,no,#299,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. +.github/prompts/generate-changelog.prompt.md,prompt,convert,skills/generate-changelog/SKILL.md,no,#299,Durable workflow prompt should become a self-contained skill if still useful. +.github/prompts/generate-custom-instructions-from-codebase.prompt.md,prompt,convert,cookbook/generate-custom-instructions-from-codebase.prompt.md,yes,#299,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. +.github/prompts/generate-gh-workflow.prompt.md,prompt,convert,skills/generate-gh-workflow/SKILL.md,no,#299,Durable workflow prompt should become a self-contained skill if still useful. +.github/prompts/generate-pr-description.prompt.md,prompt,convert,cookbook/generate-pr-description.prompt.md,no,#299,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. +.github/prompts/git-flow-branch-creator.prompt.md,prompt,convert,cookbook/git-flow-branch-creator.prompt.md,no,#299,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. +.github/prompts/github-copilot-starter.prompt.md,prompt,convert,cookbook/github-copilot-starter.prompt.md,yes,#299,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. +.github/prompts/inline-documentation.prompt.md,prompt,convert,cookbook/inline-documentation.prompt.md,no,#299,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. +.github/prompts/labeling.prompt.md,prompt,convert,skills/labeling/SKILL.md,yes,#299,Durable workflow prompt should become a self-contained skill if still useful. +.github/prompts/model-recommendation.prompt.md,prompt,convert,cookbook/model-recommendation.prompt.md,no,#299,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. +.github/prompts/multi-stage-dockerfile.prompt.md,prompt,convert,cookbook/multi-stage-dockerfile.prompt.md,no,#299,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. +.github/prompts/my-issues.prompt.md,prompt,convert,cookbook/my-issues.prompt.md,no,#299,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. +.github/prompts/my-pull-requests.prompt.md,prompt,convert,cookbook/my-pull-requests.prompt.md,no,#299,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. +.github/prompts/normalize-docs-labels.prompt.md,prompt,convert,skills/normalize-docs-labels/SKILL.md,yes,#299,Durable workflow prompt should become a self-contained skill if still useful. +.github/prompts/pr-description.prompt.md,prompt,convert,cookbook/pr-description.prompt.md,no,#299,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. +.github/prompts/pr-review.prompt.md,prompt,convert,skills/pr-review/SKILL.md,no,#299,Durable workflow prompt should become a self-contained skill if still useful. +.github/prompts/project-workflow-analysis-blueprint-generator.prompt.md,prompt,convert,skills/project-workflow-analysis-blueprint-generator/SKILL.md,no,#299,Durable workflow prompt should become a self-contained skill if still useful. +.github/prompts/prompt-builder.prompt.md,prompt,convert,cookbook/prompt-builder.prompt.md,no,#299,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. +.github/prompts/prompts.md,prompt,convert,cookbook/prompts.md,no,#299,Prompt indexes become cookbook/backlog material rather than first-class installable assets. +.github/prompts/python-mcp-server-generator.prompt.md,prompt,convert,cookbook/python-mcp-server-generator.prompt.md,no,#299,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. +.github/prompts/readme-blueprint-generator.prompt.md,prompt,convert,skills/readme-blueprint-generator/SKILL.md,yes,#299,Durable workflow prompt should become a self-contained skill if still useful. +.github/prompts/release.prompt.md,prompt,convert,skills/release/SKILL.md,yes,#299,Durable workflow prompt should become a self-contained skill if still useful. +.github/prompts/remember-interactive-programming.prompt.md,prompt,convert,cookbook/remember-interactive-programming.prompt.md,no,#299,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. +.github/prompts/remember.prompt.md,prompt,convert,cookbook/remember.prompt.md,yes,#299,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. +.github/prompts/repo-story-time.prompt.md,prompt,convert,cookbook/repo-story-time.prompt.md,no,#299,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. +.github/prompts/reporting.prompt.md,prompt,convert,cookbook/reporting.prompt.md,yes,#299,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. +.github/prompts/review-and-refactor.prompt.md,prompt,convert,skills/review-and-refactor/SKILL.md,yes,#299,Durable workflow prompt should become a self-contained skill if still useful. +.github/prompts/saved-replies.prompt.md,prompt,convert,cookbook/saved-replies.prompt.md,yes,#299,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. +.github/prompts/shuffle-json-data.prompt.md,prompt,convert,cookbook/shuffle-json-data.prompt.md,no,#299,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. +.github/prompts/spec-driven-workflow-start.prompt.md,prompt,convert,skills/spec-driven-workflow-start/SKILL.md,yes,#299,Durable workflow prompt should become a self-contained skill if still useful. +.github/prompts/technology-stack-blueprint-generator.prompt.md,prompt,convert,cookbook/technology-stack-blueprint-generator.prompt.md,no,#299,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. +.github/prompts/testing.prompt.md,prompt,convert,skills/testing/SKILL.md,no,#299,Durable workflow prompt should become a self-contained skill if still useful. +.github/prompts/update-implementation-plan.prompt.md,prompt,convert,skills/update-implementation-plan/SKILL.md,no,#299,Durable workflow prompt should become a self-contained skill if still useful. +.github/prompts/update-llms.prompt.md,prompt,convert,cookbook/update-llms.prompt.md,no,#299,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. +.github/prompts/update-markdown-file-index.prompt.md,prompt,convert,cookbook/update-markdown-file-index.prompt.md,no,#299,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. +.github/prompts/update-mermaid-diagrams.prompt.md,prompt,convert,cookbook/update-mermaid-diagrams.prompt.md,yes,#299,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. +.github/prompts/update-oo-component-documentation.prompt.md,prompt,convert,cookbook/update-oo-component-documentation.prompt.md,no,#299,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. +.github/prompts/update-readmes.prompt.md,prompt,convert,skills/update-readmes/SKILL.md,yes,#299,Durable workflow prompt should become a self-contained skill if still useful. +.github/prompts/update-specification.prompt.md,prompt,convert,skills/update-specification/SKILL.md,no,#299,Durable workflow prompt should become a self-contained skill if still useful. +.github/prompts/write-coding-standards-from-file.prompt.md,prompt,convert,cookbook/write-coding-standards-from-file.prompt.md,no,#299,Example or one-off prompt should become a cookbook recipe/backlog entry if retained. .github/schemas/README.md,schema,convert,.schemas/README.md + .github/schemas/README.md,yes,#297,Portable schema ownership index lives at /.schemas; .github retains a repo-local boundary pointer. .github/schemas/changelog.schema.json,schema,move,.schemas/changelog.schema.json,no,#297,Moved active portable schema to /.schemas and updated validators and active references. .github/schemas/coderabbit-overrides.v2.json,schema,move,.schemas/coderabbit-overrides.v2.json,no,#297,Moved active portable schema to /.schemas and updated validators and active references. @@ -803,4 +415,3 @@ scripts/validation/validate-workflows.js,legacy-validation-runtime,defer,workflo .github/issue-types.yml,github-governance-config,keep,.github/issue-types.yml,no,#293,Issue type definitions are repo governance files. .github/config.yml,github-governance-config,keep,.github/config.yml,no,#293,GitHub configuration remains in the control-plane folder. .github/custom-instructions.md,repo-local-copilot-instructions,keep,.github/custom-instructions.md,yes,#292,Repo-local Copilot instructions remain in .github with portable asset boundary rules. ->>>>>>> Stashed changes diff --git a/.github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-portable-workflows-source-report-2026-05-26.md b/.github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-portable-workflows-source-report-2026-05-26.md new file mode 100644 index 000000000..3e889acdb --- /dev/null +++ b/.github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-portable-workflows-source-report-2026-05-26.md @@ -0,0 +1,62 @@ +--- +file_type: "report" +title: "Portable Workflows Source Report" +description: "Issue #298 evidence for defining /workflows as the portable agentic workflow source." +version: "v0.1.0" +last_updated: "2026-05-26" +maintainer: "LightSpeed Team" +authors: ["Codex"] +license: "GPL-3.0" +tags: ["portable-ai-plugin-restructure", "workflows", "migration", "issue-298"] +domain: "ai-ops" +stability: "draft" +references: + - path: "issues/children/batch-02-portable-migration/02-06-feature-define-portable-workflows-source.md" + description: "Issue #298 local source draft." + - path: "../../../../workflows/README.md" + description: "Portable workflow ownership index." + - path: "../../../../workflows/portable-ai-plugin-restructure.md" + description: "Example portable agentic workflow spec." +--- + +# Portable Workflows Source Report + +Parent epic: #283. Child issue: #298. + +## Summary + +`/workflows` is now defined as the portable source folder for human-readable +agentic workflows and reusable runbooks. Executable GitHub Actions remain in +`.github/workflows/`. + +## Changes Made + +| Area | Outcome | +| --- | --- | +| Workflow ownership index | Updated `workflows/README.md` with the #298 reference and a workflow catalogue. | +| Example workflow spec | Added `workflows/portable-ai-plugin-restructure.md` as the first portable workflow example. | +| Related assets | Linked the example workflow to `agents/task-planner.agent.md`, `instructions/task-implementation.instructions.md`, and `skills/README.md`. | +| GitHub Actions boundary | Preserved `.github/workflows/` as the executable GitHub Actions folder. | + +## Acceptance Criteria + +- [x] `/workflows` is documented as agentic workflow source, not GitHub Actions. +- [x] `.github/workflows` remains the executable GitHub Actions folder. +- [x] At least one example portable workflow spec exists. +- [x] Links to related skills or agents are included. +- [x] Documentation updated. +- [x] Validation covers changed workflow documentation. + +## Verification + +| Command | Result | +| --- | --- | +| `npx markdownlint-cli2 "workflows/*.md" ".github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-portable-workflows-source-report-2026-05-26.md"` | Passed. | +| `npm run validate:structure` | Passed. | +| `git diff --check` | Passed. | + +## Notes + +- No GitHub Actions workflows were moved. +- No workflow validator exists yet, so Markdown linting and structure + validation are the relevant checks for this issue. diff --git a/.github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-stale-reference-cleanup-report-2026-05-19.md b/.github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-stale-reference-cleanup-report-2026-05-19.md index 4f28f1ddc..19e7c8224 100644 --- a/.github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-stale-reference-cleanup-report-2026-05-19.md +++ b/.github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-stale-reference-cleanup-report-2026-05-19.md @@ -1,8 +1,8 @@ --- title: "Portable AI Plugin Restructure Stale Reference Cleanup Report" description: "Issue #294 cleanup report for stale path references and zero-byte metadata files before portable source migration." -version: "v0.1.0" -last_updated: "2026-05-19" +version: "v0.1.1" +last_updated: "2026-05-26" file_type: "project-report" maintainer: "LightSpeed Team" authors: ["Codex"] @@ -63,6 +63,7 @@ keeps quoted source-path rows for traceability and links those cleanup rows to | Item | Decision | | --- | --- | | Historical reports that mention old paths | Leave unchanged as historical evidence unless a later archive cleanup rewrites old reports. | +| Legacy prompt content that references awesome-copilot `chatmodes` or `collections` | Leave until #299 classifies legacy prompts as skill, cookbook, archive, or delete. These are source prompt references, not active placement rules. | | `.github/pull_request_template.md` duplicate | Defer removal until a maintainer confirms whether the lowercase copy is still intentionally supported. | | `.github/funding.yml` duplicate | Defer removal until a maintainer confirms whether the lowercase copy is still intentionally supported. | | Deprecated schema support for chatmodes and collections | Leave for validation compatibility until the schema reset issues decide whether to remove backward-compatible file types. | @@ -86,5 +87,8 @@ keeps quoted source-path rows for traceability and links those cleanup rows to The active-reference search was run across `README.md`, `docs`, `.github` active documentation folders, `.github/prompts`, `.github/instructions`, and -`package.json`. It returned no matches for the stale active patterns after this -cleanup. +`package.json`. Remaining `chatmodes` and `collections` matches are confined to +legacy prompt content and are intentionally deferred to #299. The active +`.github/README.md` guidance no longer points maintainers to `GEMINI.md`, +`CLAUDE.md`, `chatmodes`, `collections`, `.github/automation/*`, or the old +hyphenated Husky document path. diff --git a/.schemas/README.md b/.schemas/README.md index 4b576b9b3..64c29b7b1 100644 --- a/.schemas/README.md +++ b/.schemas/README.md @@ -1,5 +1,4 @@ --- -<<<<<<< HEAD file_type: "index" title: "Portable Schemas" description: "Ownership index for portable schemas used by LightSpeed AI assets and plugin metadata." @@ -18,23 +17,10 @@ references: description: "Issue #290 local source draft." - path: "../.github/projects/active/portable-ai-plugin-restructure/issues/children/batch-02-portable-migration/02-05-refactor-move-active-schemas-to-root-schemas.md" description: "Issue #297 local source draft." -======= -file_type: "documentation" -title: "Portable Schemas" -description: "Ownership and migration rules for portable LightSpeed AI asset schemas." -version: "v0.1.0" -last_updated: "2026-05-18" -author: "Codex" -maintainer: "LightSpeed Team" -owners: ["LightSpeed Team"] -tags: ["schemas", "validation", "ai-ops", "governance"] -status: "active" ->>>>>>> 047fdbf127701a21a10b81aed33d4e5db86cc48b --- # Portable Schemas -<<<<<<< HEAD This folder owns portable schema files for AI assets, plugin metadata, and shared validation contracts that should travel outside the `.github` control plane. ## Ownership @@ -42,25 +28,11 @@ This folder owns portable schema files for AI assets, plugin metadata, and share - Owns JSON Schema, YAML schema, and frontmatter schema contracts used by portable agents, instructions, skills, hooks, plugins, and workflows. - Does not own GitHub-native schemas that only validate this repository's community health files during the migration window. - Keeps schemas small, explicit, and tied to active validation commands. -======= -## Overview - -`.schemas/` stores portable JSON, YAML, and frontmatter schemas for reusable -LightSpeed AI assets and plugin metadata. It is for schemas that can travel -outside this repository's GitHub-native `.github` folder. - -## Ownership - -LightSpeed Team owns this folder. Keep repo-governance schemas in -`.github/schemas/` until a migration issue records the source path, target path, -validation command, and consumer. ->>>>>>> 047fdbf127701a21a10b81aed33d4e5db86cc48b ## Structure | Path | Purpose | | --- | --- | -<<<<<<< HEAD | `.schemas/*.schema.json` | Portable JSON Schema files. | | `.schemas/*.schema.yaml` | Portable YAML schema files, when JSON is not practical. | | `.schemas/README.md` | This ownership index. | @@ -102,37 +74,3 @@ Reference schemas from portable assets with relative links. When a schema exists - [Issue #290 draft](../.github/projects/active/portable-ai-plugin-restructure/issues/children/batch-01-skeleton-boundary/01-02-document-folder-ownership-indexes.md) - [Migration decision map](../.github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-migration-map-2026-05-15.csv) -======= -| `.schemas/README.md` | Ownership and migration rules for this folder. | -| `.schemas/.schema.json` | Portable JSON schemas used by active validators or plugin manifests. | -| `.schemas/.schema.yaml` | Portable YAML schemas where YAML is the source contract. | - -## Usage - -- Add a schema here only when a portable asset or validator consumes it. -- Keep schemas small and focused on active contracts. -- Document the consuming skill, plugin, hook, workflow, or validation command. -- Avoid carrying legacy schema complexity forward without a current use case. - -## Validation - -Run targeted syntax checks before opening a PR. Do not treat mutating format -commands as validation evidence. - -```bash -npx markdownlint-cli2 ".schemas/README.md" -``` - -## Migration Rules - -- Move schemas from `.github/schemas/` only through a tracked migration issue. -- Preserve the source path in the migration map. -- Update links and validation commands in the same slice. -- Leave obsolete schemas behind for archive or deletion review rather than - copying them here by default. - -## Related Documentation - -- [Portable AI plugin restructure PRD](../.github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-prd-2026-05-14.md) -- [Issue #290: Add ownership indexes for new top-level folders](https://github.com/lightspeedwp/.github/issues/290) ->>>>>>> 047fdbf127701a21a10b81aed33d4e5db86cc48b diff --git a/agents/README.md b/agents/README.md index d25a57328..445f84a48 100644 --- a/agents/README.md +++ b/agents/README.md @@ -1,5 +1,4 @@ --- -<<<<<<< HEAD file_type: "index" title: "Portable Agents" description: "Ownership index for portable LightSpeed AI agent specifications." @@ -18,23 +17,10 @@ references: description: "Issue #290 local source draft." - path: "../.github/projects/active/portable-ai-plugin-restructure/issues/children/batch-02-portable-migration/02-04-refactor-migrate-portable-agent-specs.md" description: "Issue #296 local source draft." -======= -file_type: "documentation" -title: "Portable Agents" -description: "Ownership and migration rules for portable LightSpeed agent specifications." -version: "v0.1.0" -last_updated: "2026-05-18" -author: "Codex" -maintainer: "LightSpeed Team" -owners: ["LightSpeed Team"] -tags: ["agents", "ai-ops", "governance", "portable-assets"] -status: "draft" ->>>>>>> 047fdbf127701a21a10b81aed33d4e5db86cc48b --- # Portable Agents -<<<<<<< HEAD This folder owns reusable agent specifications that can be packaged into LightSpeed AI plugins or installed into other repositories. ## Ownership @@ -42,24 +28,11 @@ This folder owns reusable agent specifications that can be packaged into LightSp - Owns portable agent specs that avoid `.github`-relative assumptions. - Does not own repo-maintenance agents that only operate on this `.github` repository. - Keeps runtime code out of this folder until a later migration issue defines the implementation model. -======= -## Overview - -`agents/` stores portable agent specifications that can be reused across -LightSpeed repositories and AI tools. Version 1 of this structure is for specs; -runtime code is migrated separately only when the new contract is clear. - -## Ownership - -LightSpeed Team owns this folder. Repo-only maintenance agents stay in -`.github/agents/` until they are rewritten or confirmed as portable. ->>>>>>> 047fdbf127701a21a10b81aed33d4e5db86cc48b ## Structure | Path | Purpose | | --- | --- | -<<<<<<< HEAD | `agents/.agent.md` | Portable agent specification. | | `agents/agent.md` | Portable agent specification index. | | `agents//` | Future home for a larger portable agent package, if needed. | @@ -101,36 +74,3 @@ Use this folder for agent specs that describe role, scope, inputs, outputs, safe - [Issue #290 draft](../.github/projects/active/portable-ai-plugin-restructure/issues/children/batch-01-skeleton-boundary/01-02-document-folder-ownership-indexes.md) - [Migration decision map](../.github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-migration-map-2026-05-15.csv) -======= -| `agents/README.md` | Ownership and migration rules for this folder. | -| `agents/.agent.md` | Portable agent specification (flat structure). | -| `agents//AGENT.md` | Portable agent specification (folder structure entrypoint). | - -## Usage - -- Use this folder for reusable agent specs, not one-off project instructions. -- Remove assumptions about `.github`-relative paths before migration. -- Keep tool-specific setup notes in adapter sections, not in the core contract. -- Record each migrated agent in the migration map with source and target paths. - -## Validation - -Validate changed Markdown files and any future agent schema checks before a PR. - -```bash -npx markdownlint-cli2 "agents/**/*.md" -``` - -## Migration Rules - -- Migrate reusable specs from `.github/agents/` only after frontmatter and links - are updated. -- Keep agents that maintain this repository under `.github/agents/`. -- Do not move JavaScript runners here by default; rewrite useful runtime - behaviour into hooks, workflows, or skill-local scripts when needed. - -## Related Documentation - -- [Portable AI plugin restructure PRD](../.github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-prd-2026-05-14.md) -- [Issue #290: Add ownership indexes for new top-level folders](https://github.com/lightspeedwp/.github/issues/290) ->>>>>>> 047fdbf127701a21a10b81aed33d4e5db86cc48b diff --git a/cookbook/README.md b/cookbook/README.md index 7b5890d4c..9cc340b6f 100644 --- a/cookbook/README.md +++ b/cookbook/README.md @@ -1,5 +1,4 @@ --- -<<<<<<< HEAD file_type: "index" title: "AI Cookbook" description: "Ownership index for reusable recipes, examples, playbooks, and implementation guides." @@ -27,38 +26,11 @@ This folder owns durable recipes, examples, playbooks, and implementation guides - Owns worked examples, recipe-style guidance, decision playbooks, and reusable implementation notes. - Does not own prompt dumps, temporary project reports, or source files that should become skills. - Keeps examples safe to redistribute by default, with no secrets, customer data, or production-only assumptions. -======= -file_type: "documentation" -title: "Portable Cookbook" -description: "Ownership and migration rules for portable LightSpeed recipes and examples." -version: "v0.1.0" -last_updated: "2026-05-18" -author: "Codex" -maintainer: "LightSpeed Team" -owners: ["LightSpeed Team"] -tags: ["cookbook", "recipes", "examples", "ai-ops"] -status: "active" ---- - -# Portable Cookbook - -## Overview - -`cookbook/` stores recipes, examples, playbooks, and implementation guides that -teach reusable LightSpeed AI operations patterns. It is for durable guidance -that is useful, but not structured enough to be an installable skill. - -## Ownership - -LightSpeed Team owns this folder. Keep active project notes in -`.github/projects/` and permanent governance documentation in `docs/`. ->>>>>>> 047fdbf127701a21a10b81aed33d4e5db86cc48b ## Structure | Path | Purpose | | --- | --- | -<<<<<<< HEAD | `cookbook/.md` | A single reusable recipe or playbook. | | `cookbook//README.md` | Topic index for a larger recipe group. | | `cookbook/README.md` | This ownership index. | @@ -90,36 +62,3 @@ Use cookbook entries to show patterns, trade-offs, and examples. Keep each recip - [Issue #290 draft](../.github/projects/active/portable-ai-plugin-restructure/issues/children/batch-01-skeleton-boundary/01-02-document-folder-ownership-indexes.md) - [Migration decision map](../.github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-migration-map-2026-05-15.csv) -======= -| `cookbook/README.md` | Ownership and migration rules for this folder. | -| `cookbook/.md` | A focused recipe, example, or playbook. | -| `cookbook//README.md` | Optional topic index when several recipes share a domain. | - -## Usage - -- Convert legacy prompts into cookbook recipes when they teach a pattern but do - not need a strict skill workflow. -- Keep each recipe practical, reproducible, and linked to source evidence. -- Prefer short examples over broad tutorials. -- Promote repeatable operational workflows to `skills/` instead. - -## Validation - -Validate changed Markdown files before a PR. - -```bash -npx markdownlint-cli2 "cookbook/**/*.md" -``` - -## Migration Rules - -- Move example prompts from `.github/prompts/` only after reviewing whether they - should become a skill, recipe, archive item, or deletion candidate. -- Preserve the original prompt path in the migration map. -- Remove stale `.github` path assumptions during conversion. - -## Related Documentation - -- [Portable AI plugin restructure PRD](../.github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-prd-2026-05-14.md) -- [Issue #290: Add ownership indexes for new top-level folders](https://github.com/lightspeedwp/.github/issues/290) ->>>>>>> 047fdbf127701a21a10b81aed33d4e5db86cc48b diff --git a/hooks/README.md b/hooks/README.md index acfb9d1da..022ed32b8 100644 --- a/hooks/README.md +++ b/hooks/README.md @@ -1,5 +1,4 @@ --- -<<<<<<< HEAD file_type: "index" title: "Portable Hooks" description: "Ownership index for safe portable hooks, guardrails, and tool adapters." @@ -16,23 +15,10 @@ references: description: "Portable AI plugin restructure PRD." - path: "../.github/projects/active/portable-ai-plugin-restructure/issues/children/batch-01-skeleton-boundary/01-02-document-folder-ownership-indexes.md" description: "Issue #290 local source draft." -======= -file_type: "documentation" -title: "Portable Hooks" -description: "Ownership and migration rules for portable LightSpeed hooks and guardrails." -version: "v0.1.0" -last_updated: "2026-05-18" -author: "Codex" -maintainer: "LightSpeed Team" -owners: ["LightSpeed Team"] -tags: ["hooks", "guardrails", "automation", "ai-ops"] -status: "active" ->>>>>>> 047fdbf127701a21a10b81aed33d4e5db86cc48b --- # Portable Hooks -<<<<<<< HEAD This folder owns portable hooks, guardrails, and adapters that help AI tools run safer checks before or after agent actions. ## Ownership @@ -40,24 +26,11 @@ This folder owns portable hooks, guardrails, and adapters that help AI tools run - Owns hook specifications, small guardrail scripts, and tool adapters that can be reused across repositories. - Does not own GitHub Actions workflows, repository-specific CI jobs, or destructive maintenance scripts. - Keeps hooks dry-run friendly, auditable, and explicit about side effects. -======= -## Overview - -`hooks/` stores portable hooks, guardrails, and adapters that support safe AI -operations across tools. Hooks must be small, auditable, and tool-neutral where -possible. - -## Ownership - -LightSpeed Team owns this folder. Legacy agent runner code stays in place until -it is rewritten into a smaller hook, workflow, or skill-local script. ->>>>>>> 047fdbf127701a21a10b81aed33d4e5db86cc48b ## Structure | Path | Purpose | | --- | --- | -<<<<<<< HEAD | `hooks//README.md` | Hook purpose, inputs, outputs, and safety behaviour. | | `hooks//` | Hook implementation, tests, fixtures, and adapter files. | | `hooks/README.md` | This ownership index. | @@ -89,36 +62,3 @@ Use hooks for narrow safety checks, policy gates, and adapter glue. Prefer clear - [Issue #290 draft](../.github/projects/active/portable-ai-plugin-restructure/issues/children/batch-01-skeleton-boundary/01-02-document-folder-ownership-indexes.md) - [Migration decision map](../.github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-migration-map-2026-05-15.csv) -======= -| `hooks/README.md` | Ownership and migration rules for this folder. | -| `hooks//README.md` | Hook purpose, inputs, outputs, risks, and usage. | -| `hooks//hook.sh` | Actual hook implementation (or other language-specific entrypoint). | -| `hooks//.md` | Optional tool adapter notes for Codex, Copilot, Claude, or other runtimes. | - -## Usage - -- Prefer dry-run behaviour for any hook that can edit files or external state. -- Document inputs, outputs, permissions, and failure modes. -- Keep secrets out of examples and test data. -- Avoid broad runtime frameworks unless the maintenance return is clear. - -## Validation - -Validate changed Markdown files and any hook scripts before a PR. - -```bash -npx markdownlint-cli2 "hooks/**/*.md" -``` - -## Migration Rules - -- Do not move JavaScript agent runners directly into this folder. -- Rewrite only the useful, portable behaviour. -- Keep destructive or external-write hooks behind explicit confirmation and - documented dry-run paths. - -## Related Documentation - -- [Portable AI plugin restructure PRD](../.github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-prd-2026-05-14.md) -- [Issue #290: Add ownership indexes for new top-level folders](https://github.com/lightspeedwp/.github/issues/290) ->>>>>>> 047fdbf127701a21a10b81aed33d4e5db86cc48b diff --git a/instructions/README.md b/instructions/README.md index 5b28ea11f..0bdb24795 100644 --- a/instructions/README.md +++ b/instructions/README.md @@ -1,5 +1,4 @@ --- -<<<<<<< HEAD file_type: "index" title: "Portable Instructions" description: "Ownership index for portable LightSpeed instruction files." @@ -18,23 +17,10 @@ references: description: "Issue #290 local source draft." - path: "../.github/projects/active/portable-ai-plugin-restructure/issues/children/batch-02-portable-migration/02-03-refactor-migrate-portable-instructions.md" description: "Issue #295 local source draft." -======= -file_type: "documentation" -title: "Portable Instructions" -description: "Ownership and migration rules for portable LightSpeed instruction files." -version: "v0.1.0" -last_updated: "2026-05-18" -author: "Codex" -maintainer: "LightSpeed Team" -owners: ["LightSpeed Team"] -tags: ["instructions", "ai-ops", "governance", "portable-assets"] -status: "draft" ->>>>>>> 047fdbf127701a21a10b81aed33d4e5db86cc48b --- # Portable Instructions -<<<<<<< HEAD This folder owns reusable instruction files for LightSpeed AI work that should apply across projects and plugins, not only inside this `.github` repository. ## Ownership @@ -42,24 +28,11 @@ This folder owns reusable instruction files for LightSpeed AI work that should a - Owns portable `*.instructions.md` files by domain, language, workflow, or quality gate. - Does not own repo-local Copilot instructions for maintaining this community health repository. - Keeps instructions clear, modular, tool-aware where needed, and free from hard-coded `.github` path assumptions. -======= -## Overview - -`instructions/` stores portable instruction files that can be reused across -LightSpeed projects and AI tools. These instructions should describe domain -behaviour without assuming they live inside `.github`. - -## Ownership - -LightSpeed Team owns this folder. Instructions for maintaining this repository -stay in `.github/instructions/` or `.github/custom-instructions.md`. ->>>>>>> 047fdbf127701a21a10b81aed33d4e5db86cc48b ## Structure | Path | Purpose | | --- | --- | -<<<<<<< HEAD | `instructions/.instructions.md` | Portable instruction file for one topic. | | `instructions//README.md` | Optional index for a larger instruction group. | | `instructions/README.md` | This ownership index. | @@ -100,36 +73,3 @@ Use this folder for instruction files that agents, plugin installers, or downstr - [Issue #290 draft](../.github/projects/active/portable-ai-plugin-restructure/issues/children/batch-01-skeleton-boundary/01-02-document-folder-ownership-indexes.md) - [Migration decision map](../.github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-migration-map-2026-05-15.csv) -======= -| `instructions/README.md` | Ownership and migration rules for this folder. | -| `instructions/.instructions.md` | Portable instruction file for a reusable domain or workflow. | -| `instructions//README.md` | Optional domain index when several instruction files belong together. | - -## Usage - -- Use this folder for reusable instructions that belong outside repo-specific - `.github` governance. -- Keep WordPress block theme and block plugin guidance separated when migrated. -- Prefer clear domain boundaries over large catch-all instruction files. -- Link related skills, agents, or cookbook recipes from the instruction body. - -## Validation - -Validate changed Markdown files and future frontmatter checks before a PR. - -```bash -npx markdownlint-cli2 "instructions/**/*.md" -``` - -## Migration Rules - -- Move generic instructions from `.github/instructions/` only after removing - `.github`-specific assumptions. -- Keep repo-maintenance instructions in `.github/instructions/`. -- Record every moved instruction in the migration map. - -## Related Documentation - -- [Portable AI plugin restructure PRD](../.github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-prd-2026-05-14.md) -- [Issue #290: Add ownership indexes for new top-level folders](https://github.com/lightspeedwp/.github/issues/290) ->>>>>>> 047fdbf127701a21a10b81aed33d4e5db86cc48b diff --git a/instructions/readme.instructions.md b/instructions/readme.instructions.md index 776317f83..59288f738 100644 --- a/instructions/readme.instructions.md +++ b/instructions/readme.instructions.md @@ -96,11 +96,7 @@ Add/maintain: - **Legacy prompts (`.github/prompts/`)**: Index prompt files during migration; mark whether each prompt will convert to a skill, cookbook recipe, archive item, or deletion candidate. - **Portable skills (`skills/`)**: List skill folders, `SKILL.md` entrypoints, assets, scripts, examples, and validation expectations. - **Cookbook (`cookbook/`)**: List recipes, examples, playbooks, and the source prompts or issues they came from. -<<<<<<< Updated upstream:.github/instructions/readme.instructions.md - **Repo schemas (`.github/schemas/`)**: List schemas, validation commands, consumers, and migration status. -======= -- **Repo schemas (`../.schemas/`)**: List schemas, validation commands, consumers, and migration status. ->>>>>>> Stashed changes:instructions/readme.instructions.md - **Portable schemas (`.schemas/`)**: List active portable schemas, consumers, and validation commands; include schema relationship diagram when useful. - **Plugins (`plugins/`)**: List plugin families, manifests, bundled assets, install notes, and support status. - **Hooks (`hooks/`)**: List hooks, guardrails, dry-run behaviour, permissions, and tool adapters. diff --git a/plugins/README.md b/plugins/README.md index bf94c0e3f..438adae1d 100644 --- a/plugins/README.md +++ b/plugins/README.md @@ -1,5 +1,4 @@ --- -<<<<<<< HEAD file_type: "index" title: "Plugin Bundles" description: "Ownership index for installable LightSpeed AI plugin bundles and plugin-family strategy." @@ -27,38 +26,11 @@ This folder owns installable LightSpeed AI plugin bundles and the index of plann - Owns plugin bundle folders, plugin-local README files, manifests, packaged agents, packaged skills, hooks, and workflow entry points. - Does not own loose source assets that have not yet been assigned to a plugin. - Keeps each plugin scoped to a clear audience and maintenance model. -======= -file_type: "documentation" -title: "Portable Plugins" -description: "Ownership and migration rules for installable LightSpeed plugin bundles." -version: "v0.1.0" -last_updated: "2026-05-18" -author: "Codex" -maintainer: "LightSpeed Team" -owners: ["LightSpeed Team"] -tags: ["plugins", "ai-ops", "installable-assets", "governance"] -status: "draft" ---- - -# Portable Plugins - -## Overview - -`plugins/` stores installable LightSpeed AI operations plugin bundles. Each -plugin should package a focused set of agents, skills, instructions, hooks, or -workflows that can be installed into supported tools. - -## Ownership - -LightSpeed Team owns this folder. The first implementation target is the -`lightspeed-github-ops` pilot plugin. ->>>>>>> 047fdbf127701a21a10b81aed33d4e5db86cc48b ## Structure | Path | Purpose | | --- | --- | -<<<<<<< HEAD | `plugins//README.md` | Plugin overview, install notes, included assets, and support status. | | `plugins//` | Plugin-local agents, skills, hooks, workflows, manifests, and examples. | | `plugins/README.md` | This ownership index and plugin-family strategy. | @@ -95,47 +67,3 @@ LightSpeed Team owns this folder. The first implementation target is the - [Issue #290 draft](../.github/projects/active/portable-ai-plugin-restructure/issues/children/batch-01-skeleton-boundary/01-02-document-folder-ownership-indexes.md) - [Migration decision map](../.github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-migration-map-2026-05-15.csv) -======= -| `plugins/README.md` | Ownership and migration rules for this folder. | -| `plugins//README.md` | Plugin purpose, contents, install notes, and support status. | -| `plugins//plugin.json` | Plugin manifest for compatible tooling. | -| `plugins//skills/` | Plugin-local skills when bundling is useful. | -| `plugins//agents/` | Plugin-local agent specs when bundling is useful. | - -## Plugin Family Strategy - -| Plugin family | Purpose | Status | -| --- | --- | --- | -| `lightspeed-github-ops` | Community health, labels, templates, PR review, frontmatter, release prep. | Pilot | -| `lightspeed-wordpress-block-theme` | Block theme standards and workflows. | Planned | -| `lightspeed-wordpress-block-plugin` | Custom block plugin standards and workflows. | Planned | -| `lightspeed-content-ops` | Publishing, editorial, and reusable content operations. | Backlog | - -## Usage - -- Build the smallest useful plugin first. -- Keep plugin manifests accurate and dependency-light. -- Link bundled assets back to their source collections where relevant. -- Avoid broad materialisation tooling until the pilot proves the pattern. - -## Validation - -Validate changed Markdown files now. Add manifest validation once the validation -reset introduces `validate:plugins`. - -```bash -npx markdownlint-cli2 "plugins/**/*.md" -``` - -## Migration Rules - -- Create plugin bundles from proven source assets, not from unreviewed legacy - folders. -- Keep each plugin focused on one audience and operating context. -- Record bundled assets in the migration map or plugin README. - -## Related Documentation - -- [Portable AI plugin restructure PRD](../.github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-prd-2026-05-14.md) -- [Issue #290: Add ownership indexes for new top-level folders](https://github.com/lightspeedwp/.github/issues/290) ->>>>>>> 047fdbf127701a21a10b81aed33d4e5db86cc48b diff --git a/skills/README.md b/skills/README.md index 967ff0d82..a5d671b92 100644 --- a/skills/README.md +++ b/skills/README.md @@ -1,5 +1,4 @@ --- -<<<<<<< HEAD file_type: "index" title: "Portable Skills" description: "Ownership index for self-contained LightSpeed AI skills." @@ -16,23 +15,10 @@ references: description: "Portable AI plugin restructure PRD." - path: "../.github/projects/active/portable-ai-plugin-restructure/issues/children/batch-01-skeleton-boundary/01-02-document-folder-ownership-indexes.md" description: "Issue #290 local source draft." -======= -file_type: "documentation" -title: "Portable Skills" -description: "Ownership and migration rules for self-contained LightSpeed skills." -version: "v0.1.0" -last_updated: "2026-05-18" -author: "Codex" -maintainer: "LightSpeed Team" -owners: ["LightSpeed Team"] -tags: ["skills", "ai-ops", "portable-assets", "governance"] -status: "draft" ->>>>>>> 047fdbf127701a21a10b81aed33d4e5db86cc48b --- # Portable Skills -<<<<<<< HEAD This folder owns self-contained skills that teach an AI agent a repeatable LightSpeed capability. ## Ownership @@ -40,24 +26,11 @@ This folder owns self-contained skills that teach an AI agent a repeatable Light - Owns folders where each skill has a `SKILL.md` entry point and any local assets, scripts, templates, examples, or fixtures it needs. - Does not own general examples that are better kept in `/cookbook`. - Keeps skills small enough to install, test, and maintain independently. -======= -## Overview - -`skills/` stores self-contained LightSpeed skills. A skill should describe a -repeatable workflow clearly enough that an agent can load `SKILL.md`, follow the -steps, and use any local assets, scripts, templates, or examples safely. - -## Ownership - -LightSpeed Team owns this folder. Skills should be portable by default and -bundled into plugins only when a plugin needs them. ->>>>>>> 047fdbf127701a21a10b81aed33d4e5db86cc48b ## Structure | Path | Purpose | | --- | --- | -<<<<<<< HEAD | `skills//SKILL.md` | Required skill entry point. | | `skills//assets/` | Optional skill-owned images, fixtures, or support files. | | `skills//scripts/` | Optional skill-owned helper scripts. | @@ -90,51 +63,3 @@ Use this folder when an agent needs procedural knowledge it can load on demand. - [Issue #290 draft](../.github/projects/active/portable-ai-plugin-restructure/issues/children/batch-01-skeleton-boundary/01-02-document-folder-ownership-indexes.md) - [Migration decision map](../.github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-migration-map-2026-05-15.csv) -======= -| `skills/README.md` | Ownership, backlog, and migration rules for this folder. | -| `skills/.skill.md` | Portable skill specification (flat structure). | -| `skills//SKILL.md` | Portable skill specification (folder structure entrypoint). | -| `skills//assets/` | Optional static assets used by the skill. | -| `skills//scripts/` | Optional helper scripts owned by the skill. | -| `skills//templates/` | Optional reusable output templates. | -| `skills//examples/` | Optional examples and fixtures. | - -## Initial Skills Backlog - -| Skill | Plugin fit | Priority | Status | -| --- | --- | --- | --- | -| `lightspeed-frontmatter-audit` | `lightspeed-github-ops` | P0 | Planned | -| `lightspeed-pr-review` | `lightspeed-github-ops` | P0 | Planned | -| `lightspeed-label-governance` | `lightspeed-github-ops` | P0 | Planned | -| `lightspeed-release-prep` | `lightspeed-github-ops` | P1 | Backlog | - -## Usage - -- Convert repeatable prompt workflows into skills when they have clear steps, - inputs, outputs, and validation. -- Keep examples and teaching material in `cookbook/` unless the skill needs - them as fixtures. -- Keep scripts small, local to the skill, and documented. -- Do not include secrets, production data, or customer data in examples. - -## Validation - -Validate changed Markdown files now. Add skill structure checks once the -validation reset introduces skill validation. - -```bash -npx markdownlint-cli2 "skills/**/*.md" -``` - -## Migration Rules - -- Review each legacy prompt before deciding whether it becomes a skill, - cookbook recipe, archive item, or deletion candidate. -- Record source and target paths in the migration map. -- Keep a skill self-contained once migrated. - -## Related Documentation - -- [Portable AI plugin restructure PRD](../.github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-prd-2026-05-14.md) -- [Issue #290: Add ownership indexes for new top-level folders](https://github.com/lightspeedwp/.github/issues/290) ->>>>>>> 047fdbf127701a21a10b81aed33d4e5db86cc48b diff --git a/workflows/README.md b/workflows/README.md index 8aac3d349..4847ae4fc 100644 --- a/workflows/README.md +++ b/workflows/README.md @@ -1,10 +1,9 @@ --- -<<<<<<< HEAD file_type: "index" title: "Agentic Workflows" description: "Ownership index for portable agentic workflows, distinct from GitHub Actions." -version: "v0.1.0" -last_updated: "2026-05-16" +version: "v0.1.1" +last_updated: "2026-05-26" maintainer: "LightSpeed Team" authors: ["Codex"] license: "GPL-3.0" @@ -16,6 +15,8 @@ references: description: "Portable AI plugin restructure PRD." - path: "../.github/projects/active/portable-ai-plugin-restructure/issues/children/batch-01-skeleton-boundary/01-02-document-folder-ownership-indexes.md" description: "Issue #290 local source draft." + - path: "../.github/projects/active/portable-ai-plugin-restructure/issues/children/batch-02-portable-migration/02-06-feature-define-portable-workflows-source.md" + description: "Issue #298 local source draft." --- # Agentic Workflows @@ -27,42 +28,21 @@ This folder owns portable agentic workflows: human-readable procedures, orchestr - Owns portable workflow descriptions that guide agents or maintainers through repeatable tasks. - Does not own GitHub Actions YAML files; those stay in `.github/workflows/`. - Keeps workflows tool-neutral where practical and isolates tool-specific adapters inside plugins or hooks. -======= -file_type: "documentation" -title: "Portable Workflows" -description: "Ownership and migration rules for portable LightSpeed agentic workflows." -version: "v0.1.0" -last_updated: "2026-05-18" -author: "Codex" -maintainer: "LightSpeed Team" -owners: ["LightSpeed Team"] -tags: ["workflows", "ai-ops", "automation", "governance"] -status: "active" -stability: "incubating" ---- - -# Portable Workflows - -## Overview - -`workflows/` stores portable agentic workflows that can run across AI tools or -plugin contexts. GitHub Actions remain in `.github/workflows/`. - -## Ownership - -LightSpeed Team owns this folder. Keep workflow definitions focused on agentic -processes rather than repository CI configuration. ->>>>>>> 047fdbf127701a21a10b81aed33d4e5db86cc48b ## Structure | Path | Purpose | | --- | --- | -<<<<<<< HEAD | `workflows/.md` | Portable agentic workflow or runbook. | | `workflows//README.md` | Optional index for a larger workflow package. | | `workflows/README.md` | This ownership index. | +## Workflow catalogue + +| Workflow | Purpose | Related assets | +| --- | --- | --- | +| [`portable-ai-plugin-restructure.md`](portable-ai-plugin-restructure.md) | Dependency-aware workflow for completing the portable AI plugin restructure issue set. | [`agents/task-planner.agent.md`](../agents/task-planner.agent.md), [`instructions/task-implementation.instructions.md`](../instructions/task-implementation.instructions.md), [`skills/README.md`](../skills/README.md) | + ## Migration rules - Move workflows here only when they describe portable agent behaviour rather than GitHub Actions execution. @@ -89,40 +69,5 @@ Use this folder for repeatable AI-assisted operating procedures, such as release ## References - [Issue #290 draft](../.github/projects/active/portable-ai-plugin-restructure/issues/children/batch-01-skeleton-boundary/01-02-document-folder-ownership-indexes.md) +- [Issue #298 draft](../.github/projects/active/portable-ai-plugin-restructure/issues/children/batch-02-portable-migration/02-06-feature-define-portable-workflows-source.md) - [Migration decision map](../.github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-migration-map-2026-05-15.csv) -======= -| `workflows/README.md` | Ownership and migration rules for this folder. | -| `workflows//README.md` | Workflow purpose, inputs, outputs, risks, and validation. | -| `workflows//workflow.yml` | Portable workflow definition file. | -| `workflows//.md` | Optional tool adapter notes for supported runtimes. | - -## Usage - -- Use this folder for portable AI workflows, playbooks with state, or - multi-step agent processes. -- Keep GitHub Actions, reusable workflow YAML, and CI triggers in - `.github/workflows/`. -- Prefer workflows that can be tested locally or dry-run safely. -- Link related skills, hooks, schemas, and plugins from each workflow. - -## Validation - -Validate changed Markdown files now. Add workflow structure checks once the -validation reset introduces portable workflow validation. - -```bash -npx markdownlint-cli2 "workflows/**/*.md" -``` - -## Migration Rules - -- Do not move GitHub Actions into this folder. -- Convert durable agentic processes only after inputs, outputs, and safety - checks are documented. -- Record source and target paths in the migration map. - -## Related Documentation - -- [Portable AI plugin restructure PRD](../.github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-prd-2026-05-14.md) -- [Issue #290: Add ownership indexes for new top-level folders](https://github.com/lightspeedwp/.github/issues/290) ->>>>>>> 047fdbf127701a21a10b81aed33d4e5db86cc48b diff --git a/workflows/portable-ai-plugin-restructure.md b/workflows/portable-ai-plugin-restructure.md new file mode 100644 index 000000000..afe96ebfe --- /dev/null +++ b/workflows/portable-ai-plugin-restructure.md @@ -0,0 +1,78 @@ +--- +file_type: "workflow" +title: "Portable AI Plugin Restructure Workflow" +description: "Portable agentic workflow for completing the LightSpeed portable AI plugin restructure in dependency order." +version: "v0.1.0" +last_updated: "2026-05-26" +maintainer: "LightSpeed Team" +authors: ["Codex"] +license: "GPL-3.0" +tags: ["workflow", "ai-ops", "plugin-restructure", "governance"] +domain: "governance" +stability: "draft" +references: + - path: "../.github/projects/active/portable-ai-plugin-restructure/complete-portable-ai-plugin-restructure.prompt.md" + description: "Project orchestration prompt this workflow distils into a portable runbook." + - path: "../.github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-prd-2026-05-14.md" + description: "Active PRD defining the restructure phases and acceptance criteria." + - path: "../agents/task-planner.agent.md" + description: "Related planning agent specification." + - path: "../instructions/task-implementation.instructions.md" + description: "Related implementation instruction set." +--- + +# Portable AI Plugin Restructure Workflow + +Use this workflow when completing the portable AI plugin restructure across +GitHub issues, local reports, migration-map rows, and validation evidence. It +is a portable agentic workflow, not a GitHub Actions workflow. + +## Inputs + +- Active project prompt: + `.github/projects/active/portable-ai-plugin-restructure/complete-portable-ai-plugin-restructure.prompt.md`. +- Local issue drafts under + `.github/projects/active/portable-ai-plugin-restructure/issues/`. +- Canonical migration map: + `.github/projects/active/portable-ai-plugin-restructure/portable-ai-plugin-restructure-migration-map-2026-05-15.csv`. +- Live GitHub issues #282 through #321 in `lightspeedwp/.github`. + +## Outputs + +- One reviewable implementation slice at a time. +- Updated local reports or migration-map rows when the issue changes project + state. +- Validation evidence recorded in the GitHub issue comment before closure. +- Closed child issues only when acceptance criteria are genuinely complete. + +## Steps + +1. Re-check live GitHub issue state before starting a slice. +2. Pick the first open issue in the dependency order from the orchestration + prompt. +3. Read the child draft, parent epic, related report, and current code paths. +4. Confirm dependencies are closed or document a safe reason to proceed. +5. Implement only the current issue acceptance criteria. +6. Run the smallest meaningful validation commands plus `git diff --check`. +7. Update the relevant local report or migration-map rows. +8. Comment on the GitHub issue with files changed, acceptance criteria, + verification evidence, and blockers. +9. Close the issue only when the evidence is complete. + +## Guardrails + +- Keep `.github/workflows/` for executable GitHub Actions only. +- Keep `/workflows` for human-readable, portable AI runbooks and process + contracts. +- Do not batch unrelated migrations into one issue just because the files are + near each other. +- Prefer read-only validators for completion evidence; use explicit `format:*` + or `fix:*` commands only when the issue calls for writes. +- Preserve historical reports unless a current issue explicitly updates them. + +## Related Assets + +- [Task planner agent](../agents/task-planner.agent.md) +- [Task implementation instructions](../instructions/task-implementation.instructions.md) +- [Portable skills index](../skills/README.md) +- [Portable workflow ownership index](README.md)