-
Notifications
You must be signed in to change notification settings - Fork 2
chore: finalize portable AI plugin restructure closeout #415
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| 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
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. According to the general rules, migration maps and notes should be documented in a central
Suggested change
References
|
||||||||||
| - 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. | ||||||||||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
According to the general rules, migration maps and notes should be documented in a central
/docs/MIGRATION.mdfile 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
/docs/MIGRATION.mdfile to ensure contributors can follow migration rules mentioned in README files across the repository.