Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -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"]
Expand All @@ -29,21 +29,25 @@ 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

| Asset type | Count |
| --- | ---: |
| `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 |

Expand All @@ -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.
Comment on lines +74 to +80

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

According to the general rules, migration maps and notes should be documented in a central /docs/MIGRATION.md file to ensure contributors can easily follow migration rules mentioned in README files across the repository. Please ensure the reconciled migration map and these reconciliation notes are documented or referenced in /docs/MIGRATION.md.

References
  1. Document migration maps and notes in a central /docs/MIGRATION.md file to ensure contributors can follow migration rules mentioned in README files across the repository.


## Remediation Links

- Use issue #287 to capture the command and dependency baseline before changing validation behaviour.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,42 +1,91 @@
---
title: "Portable AI Plugin Restructure Legacy Prompt Classification Report"
description: "Classification of legacy prompts as skill, cookbook, archive, delete, or defer."
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"
file_type: "project"
maintainer: "LightSpeed Team"
authors: ["Codex"]
license: "GPL-3.0"
tags: ["prompts", "skills", "cookbook", "migration", "governance"]
tags: ["audit", "prompts", "skills", "cookbook", "ai-ops", "plugin-restructure"]
domain: "governance"
stability: "active"
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."
Comment on lines +16 to +17

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

According to the general rules, migration maps and notes should be documented in a central /docs/MIGRATION.md file to ensure contributors can easily follow migration rules mentioned in README files across the repository. Please ensure this migration map and its classification notes are documented or referenced in /docs/MIGRATION.md.

Suggested change
- path: "portable-ai-plugin-restructure-migration-map-2026-05-15.csv"
description: "Canonical migration decision map."
- path: ../../../../docs/MIGRATION.md
description: Central migration map and notes.
References
  1. Document migration maps and notes in a central /docs/MIGRATION.md file to ensure contributors can follow migration rules mentioned in README files across the repository.

- path: "complete-portable-ai-plugin-restructure.prompt.md"
description: "Project orchestration prompt and dependency order."
---

# Legacy Prompt Classification (2026-05-26)
# Portable AI Plugin Restructure Legacy Prompts Classification Report

Parent epic: #283. Child issue: #299.

## Summary

- Prompt files reviewed: 70
- P0 skill candidates: `pr-review`, `labeling`, `add-frontmatter`
- Cookbook candidates: 19
- Archive/defer candidates: 48
- Delete candidates: 0
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.

## Decisions
## Findings and Risks

| Pattern | Classification | Notes |
| --- | --- | --- |
| `*review*`, `*label*`, `*frontmatter*` | skill | Directly actionable and repeatable. |
| `*blueprint*`, `*breakdown*`, `*story-time*` | cookbook | Better as examples and playbooks. |
| `my-*`, `remember*`, narrow one-off prompts | defer | Keep until replacement workflows are stable. |
- 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).

## Risks
## Remediation Actions

- Moving all prompts to skills would recreate prompt sprawl.
- Several legacy prompts still assume `.github`-relative context.
- 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.

## Remediation
## Acceptance Criteria Status

1. Keep durable operational behaviour in `skills/`.
2. Move teaching content to `cookbook/`.
3. Defer low-value one-offs until pilot plugin feedback is complete.
- [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.
Loading
Loading