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.

FileKindSize
SKILL.mdskill md1.4 KB
---
name: build-convex
description: Build the Convex project from source. Use when a contributor wants to compile, test, or package Convex.
disable-model-invocation: true
allowed-tools: Bash
argument-hint: "[module]"
---

# 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:

```bash
./mvnw -B -T1C test
```

## Build a single module

```bash
./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:

```bash
./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:

```bash
./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: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated 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: 198kUpdated Claude CodeCodexVerifiedInstall