✨ Migration intelligence package skeleton

[ibolton336]

Summary

Adds packages/migration-intelligence/ — a standalone package containing built-in skills, prompts, and agent instructions for Konveyor-guided migrations. This is the intelligence layer described in konveyor/enhancements#274, built on top of the pluggable agent backend infrastructure from #1351.

What this PR adds

packages/migration-intelligence/
├── package.json                          # Standalone package (@editor-extensions/migration-intelligence)
├── AGENTS.md                             # Agent instructions (Claude Code, Cursor, etc.)
├── SKILL.md                              # Top-level Agent Skills entry point
├── skills/
│   ├── create-migration-guide/
│   │   ├── SKILL.md                      # Workflow: explore codebase + interview user → skill file
│   │   └── references/
│   │       └── example-migration-guide.md
│   ├── generate-migration-plan/
│   │   └── SKILL.md                      # Workflow: guide + analysis results → phased plan
│   └── execute-migration-phase/
│       └── SKILL.md                      # Workflow: execute one phase, re-analyze, prompt user
└── prompts/
    ├── skill-creation.md                 # Prompt template for skill creation workflow
    ├── plan-generation.md                # Prompt template for plan generation workflow
    └── phase-execution.md               # Prompt template for phase execution workflow

Key design decisions

• Agent Skills format — skills follow agentskills.io for compatibility with Goose, OpenCode, Claude Code, and Codex. No IDE-specific tooling required.
• Portable by design — the package has its own package.json so any agent can consume it directly by pointing at the package directory, not just the VS Code extension.
• Markdown-only skeleton — no code in this PR. Wiring into the extension (skill discovery, prompt loading, profile bundle extraction) follows in subsequent PRs.
• Three-layer intelligence — skills from this package are defaults; hub-distributed and workspace-local skills extend or override them (see AGENTS.md).

Relationship to enhancements#274

This PR implements the Migration Intelligence Package section of konveyor/enhancements#274. The three skills map directly to the three phases described in the spec:

• Phase 1 (Skill Creation) → create-migration-guide
• Phase 2 (Plan Generation) → generate-migration-plan
• Phase 3 (Phased Execution) → execute-migration-phase

Depends on

• ✨ Pluggable agent backend infrastructure (Goose, OpenCode, Claude, Codex) #1351 — pluggable agent backend (provides the runtime this intelligence layer runs on)

Intentionally deferred

• Skill discovery/loading in the extension (reading from .konveyor/skills/ + package defaults)
• Profile bundle extraction of skills/ and prompts/ directories
• promptBuilder.ts replacement with skill-based prompt loading
• Hub API for skill CRUD on profiles

[coderabbitai]

Warning

Rate limit exceeded

@ibolton336 has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 52 minutes and 0 seconds before requesting another review.

Your organization is not enrolled in usage-based pricing. Contact your admin to enable usage-based pricing to continue reviews beyond the rate limit, or try again in 52 minutes and 0 seconds.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: e801925f-4fca-4b93-9425-65817fabf9c9

📥 Commits

Reviewing files that changed from the base of the PR and between 4580862 and cd4dfcb.

📒 Files selected for processing (11)

• changes/unreleased/1352-migration-intelligence-package.yaml
• packages/migration-intelligence/AGENTS.md
• packages/migration-intelligence/SKILL.md
• packages/migration-intelligence/package.json
• packages/migration-intelligence/prompts/phase-execution.md
• packages/migration-intelligence/prompts/plan-generation.md
• packages/migration-intelligence/prompts/skill-creation.md
• packages/migration-intelligence/skills/create-migration-guide/SKILL.md
• packages/migration-intelligence/skills/create-migration-guide/references/example-migration-guide.md
• packages/migration-intelligence/skills/execute-migration-phase/SKILL.md
• packages/migration-intelligence/skills/generate-migration-plan/SKILL.md

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feature/migration-intelligence-package

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}