Skip to content

Convex-Dev/convex / .claude/skills/build-convex

build-convex

Verified

Build the Convex project from source. Use when a contributor wants to compile, test, or package Convex.

Build Convex

Build the Convex Maven project. Requires Java 21+ (JDK 25 recommended). The checked-in wrapper supplies the pinned Maven version.

Run every command from the repository root — that is already the working directory, so do not cd anywhere first. Use ./mvnw on Unix-like shells or .\mvnw.cmd in PowerShell so the build uses the pinned Maven version.

Parse $ARGUMENTS for a module name (any argument starting convex-), e.g. convex-core.

Fast incremental build

The default when no arguments are given:

./mvnw -B -T1C test

Build a single module

./mvnw -B -T1C test -pl <module> -am

-am also builds the modules that one depends on.

Final verification

Use a clean, sequential build before claiming work is done:

./mvnw -B clean verify

Use install only when another local project needs the fresh artifacts: it copies them into ~/.m2.

For a single module's tests:

./mvnw -B -T1C test -pl <module> -am

Report the result — success or failure — and any errors, concisely. On failure, quote the first real compilation or test error rather than the Maven summary.

finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 321kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 321kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 321kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 197kUpdated Claude CodeCodexVerifiedInstall