quarkus-module-build

# Quarkus Module Build Build one or more specific modules in a Quarkus project with parallel execution. ## Overview This skill builds specific Quarkus modules (extensions, libraries, etc.) in parallel using subagents. It's optimized for rapid iteration during development when you only need to rebuild changed modules rather than the entire project. ## When to Use - Building specific modules after local changes - Compiling a subset of extensions for testing - Rebuilding modules after dependency updates - Quick iteration during feature development - After resolving compilation errors in specific modules **When NOT to use:** - For full project builds (use `quarkus-full-build` instead) - For running tests (use `mvn test` directly) - For single commands (just run `mvn` directly) ## Quick Reference **Input format:** Module names separated by spaces or "and" - `/module-build graphql and openapi` - `/module-build security` - `build the graphql rest and mongodb modules` **Build command per module:** ```bash cd <module-path> && mvn clean install -DskipTests ``` **Execution:** Parallel via subagents (all modules build simultaneously) ## Implementation ### Step 1: Parse Module Names Extract module names from user input (available as `$ARGUMENTS`): ```bash # Split on spaces and "and" echo "graphql and openapi rest" | tr ' ' '\n' | grep -v "^and$" # Result: graphql, openapi, rest ``` **Parsing examples:** - `graphql and openapi` → `["graphql", "openapi"]` - `graphql openapi rest` → `["graphql", "openapi", "rest"]` - `build security` → `["security"]` ### Step 2: Find Module Directories For each module name, search the project structure: ```bash find . -maxdepth 5 -type f -name "pom.xml" -path "*/<module-name>/*" | head -5 ``` **Selection priority:** 1. `extensions/<module-name>/` - Extension modules 2. `<module-name>/` - Top-level modules 3. `integration-tests/<module-name>/` - Integration test modules 4. `devtools/<module-name>/` - Developer tools **Example:** ```bash # Looking for "graphql" find . -maxdepth 5 -type f -name "pom.xml" -path "*/graphql/*" | head -5 ``` Might return: ``` ./extensions/graphql/deployment/pom.xml ./extensions/graphql/runtime/pom.xml ./integration-tests/graphql/pom.xml ``` Choose the best match: - For extension builds: `extensions/graphql/` (parent directory) - For specific component: `extensions/graphql/runtime/` ### Step 3: Dispatch Parallel Builds For each module, dispatch a subagent using the Agent tool. **Run all subagents in parallel** (multiple Agent calls in one response). **Subagent prompt template:** ``` Build the Quarkus module at: <module-path> Run the following command: cd <module-path> && mvn clean install -DskipTests Monitor the Maven output and report: 1. Whether the build succeeded or failed 2. If failed, include the relevant error output 3. Build time Module: <module-name> ``` **Example with 3 modules:** ``` Dispatching 3 parallel builds: Agent 1: Build extensions/graphql/ Agent 2: Build extensions/openapi/ Agent 3: Build extensions/rest/ ``` ### Step 4: Monitor Build Progress Each subagent will: 1. Navigate to module directory 2. Run Maven build 3. Monitor for SUCCESS/FAILURE 4. Report back with results You will be notified as each completes - no polling needed. ### Step 5: Report Results After all subagents complete, present a summary: **Format:** ``` Module Build Results (3 modules) ✓ graphql - Built successfully in 2m 15s ✓ openapi - Built successfully in 1m 48s ✗ rest - Build failed Error in rest module: [ERROR] /path/to/RestService.java:[23,15] cannot find symbol symbol: class MissingClass location: package com.example The RestService is trying to import a class that doesn't exist. Next steps: Check if the dependency providing MissingClass is declared in the rest module's pom.xml ``` ### Step 6: Suggest Next Steps **After all succeed:** - Suggest running tests for the built modules - Mention the full build if many modules were changed **After any fail:** - Identify the specific module with issues - Suggest fixes based on error type - Offer to rebuild after fixes ## Advanced Build Options **Build with dependencies:** ```bash mvn install -DskipTests -am -pl :module-name ``` - `-am` = "also make" dependencies - `-pl` = "project list" specific module **Build without clean:** ```bash mvn install -DskipTests ``` Faster for incremental changes. **Build with tests:** ```bash mvn clean install ``` Use when you need verification. ## Finding Module Paths **Common Quarkus patterns:** | Module Type | Path Pattern | |-------------|--------------| | Extension runtime | `extensions/<name>/runtime/` | | Extension deployment | `extensions/<name>/deployment/` | | Extension parent | `extensions/<name>/` | | Integration test | `integration-tests/<name>/` | | Dev tool | `devtools/<name>/` | | Core | `core/<name>/` | **Listing all modules:** ```bash find . -name "pom.xml" -path "*/extensions/*" | sed 's|/pom.xml||' | sort ``` ## Troubleshooting **Module not found:** ```bash # List all available modules mvn help:evaluate -Dexpression=project.modules -q -DforceStdout ``` **Build order issues:** Build the parent module to resolve dependencies: ```bash cd extensions/<module-name> mvn clean install -DskipTests ``` **Stale artifacts:** ```bash cd <module-path> mvn clean mvn install -DskipTests ``` ## Platform Notes This skill is platform-agnostic: - **Claude Code**: Use Agent tool for parallel subagents - **Gemini CLI**: Use SubAgent tool - **Codex**: Use SubAgent equivalents The Maven commands are universal across platforms. ## Related Skills - **quarkus-full-build** - Build entire project - **java-classpath-search** - Find dependencies - **java-decompile** - Inspect compiled classes