Skip to content
Merged
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
15 changes: 5 additions & 10 deletions _posts/2026-05-26-ai-skills-migration.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -110,14 +110,7 @@ The prompt message already provide to AI important information like:

[source,shell]
----
claude "Migrate this Spring Boot project to Quarkus using the full migration strategy.
Work entirely within this directory.
Do a full migration — convert all source files, build files, config, and tests.
After migration, verify the project compiles with ./mvnw compile and fix any errors.
Then run ./mvnw test and fix any test failures.
If you need to delete code or files, explain why you are deleting them and what you are replacing them with.
If anything could not be converted/migrated explain why - do not just delete/remove it without explaining.
Include a summary of the migration in the end of the output."
claude "Migrate this Spring Boot project to Quarkus using the full migration strategy."
----

[IMPORTANT]
Expand All @@ -134,14 +127,16 @@ image::03-skill-invocation.png[alt="skill invocation",align=left, width=80%]

=== Step 3: Analysis and strategy selection

The agent first scans the application using different tools executed locally and presents to the user a summary:
The agent first scans the application using different tools executed locally and presents to the user a summary. Depending on which agent you use, the tools executed and the mode (code, ask, etc), the result will be different but nevertheless you should be able to see most of the information around a Java application as: JDK, Build tool, version, modules, etc.

.AI analysis overview
image::04-analysis-overview.png[alt="analysis overview",align=left, width=80%]

NOTE: The summary includes the strategy defined part of the user's prompt to be executed.

If your application is a git managed project, then AI will execute the instructions of this https://github.com/quarkusio/skills/blob/main/skills/migrate-spring-to-quarkus/SKILL.md[section] and will propose to create a new branch named according to the convention: `migration/run-01`, `migration/run-02`, ..., created from main. The branch will contain a single commit with all changes plus a migration report. A `draft PR` against main will be created for review — it is never merged but will serve as a permanent diff and discussion record.
If your application is a git managed project, then AI will execute the instructions of this https://github.com/quarkusio/skills/blob/main/skills/migrate-spring-to-quarkus/SKILL.md[section] and will propose to create a new branch named according to the convention: `migration/run-01`, `migration/run-02`, ..., created from main.

This branch will include, at the end of the migration process, a single commit with all changes plus the migration report (see step 6). A `draft PR` will be created for review from this branch. It is not merged and will serve as a permanent diff and discussion record.

=== Step 4: Module selection and execution

Expand Down