Skip to content

docs(skills): align agent skills with one-recipe-per-release layout - #190

Merged
schultzp2020 merged 4 commits into
mainfrom
docs/rework-codemod-issue-research-skill
Nov 3, 2026
Merged

schultzp2020 merged 4 commits into
mainfrom
docs/rework-codemod-issue-research-skill

Conversation

@schultzp2020

@schultzp2020 schultzp2020 commented Nov 3, 2026 •

Copy link
Copy Markdown
Contributor

The repo's agent skills now describe the current one-recipe-per-release structure consistently, and the codemod skill is rebased onto upstream v1.1.3.

  • backstage-codemod-issue-research: targets one migration recipe package per release (codemods/v1.<minor>/ with bundled scripts/*.ts) specified by one consolidated GitHub issue. Drops the old recipe-issue step; Step 9 files the single issue with a steps table, per-step detection/transformation/before-after sections, and the manual-only out-of-scope table. Classification granularity becomes "one step = one atomic migration". Prior-art pointers reference feat: Backstage 1.55.0 migration - add v1.55.0 migration recipe workflow #156 (1.55) and feat: Backstage 1.56.0 migration - add v1.56.0 migration recipe #189 (1.56).
  • codemod: rebased onto upstream v1.1.3 (picks up allowed-tools/argument-hint frontmatter, the mining/Insights metrics trigger and authoring bullet, the Performant-codemods requirements, and the --no-interactive --install-skill run step), with the local additions kept on top: the anonymous-feedback section and CLI bullet, parser-backed-file guidance, JSSG file-walking anti-patterns, and the repo-layout rule (one recipe package per release).
  • validate-codemod-recipe: example codemod path updated to the current layout (codemods/v1.55.0); registry-source swapping is marked as legacy-workflow-only since current recipes run local js_file scripts.

Validated against the 1.56.0 research pass that produced #189.

@schultzp2020
schultzp2020 marked this pull request as ready for review November 3, 2026 19:37
@schultzp2020 schultzp2020 changed the title docs(skills): rework release-research skill for one-recipe-per-release layout docs(skills): align agent skills with one-recipe-per-release layout Nov 3, 2026
@schultzp2020
schultzp2020 merged commit 2b8d274 into main Nov 3, 2026
2 checks passed
@schultzp2020
schultzp2020 deleted the docs/rework-codemod-issue-research-skill branch November 3, 2026 19:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant