Quarkus REST API (Java)
A Java JSON API on Quarkus with Quarkus REST and Jackson, built with Maven and make. One error envelope for every failure, a validated config mapping, request ids and structured JSON logs, readiness checks, Error Prone and NullAway at compile time, and tests through @QuarkusTest and the packaged application.
What done means
Your agent follows the brief, then runs stacks verify without weakening or skipping checks. What happens next
Declared steps: install, fmt-check, lint, compile, test, test-integration, build, api, readme-filled. View commands
Use this stack
Paste the prompt into the coding agent working on your project.
Uses the stack’s default fragments. Review the brief with your agent.Uses stated defaults and omits deploy, release, and app fragments unless explicitly requested.
View prompt
Use the quarkus-api stack for this project.
1. Run npx @steamfield/stacks show quarkus-api --json and check that it fits the project. If it does not, explain why before changing files.
2. Run npx @steamfield/stacks new quarkus-api and follow the brief it prints.
3. From the generated project directory, run npx @steamfield/stacks verify. Fix failures without weakening or skipping verification steps.
4. Summarize what changed and the verification result. Quote published stats only when they are available, including their interval and sample size.
The stacks docs, written for agents, are at https://stacks.steamfield.io/llms.txt.
Use the quarkus-api stack for a quick local experiment.
1. Run npx @steamfield/stacks show quarkus-api --json and check that it fits the project. If it does not, explain why before changing files.
2. Run npx @steamfield/stacks new quarkus-api --sandbox and follow the brief it prints.
3. From the generated project directory, run npx @steamfield/stacks verify. Fix failures without weakening or skipping verification steps.
4. Summarize what changed and the verification result. Quote published stats only when they are available, including their interval and sample size.
The stacks docs, written for agents, are at https://stacks.steamfield.io/llms.txt.
Or use the terminal
npx @steamfield/stacks new quarkus-apinpx @steamfield/stacks new quarkus-api --sandbox| Step | Phase | Layer | Command |
|---|---|---|---|
| install | setup | install | make install |
| fmt-check | check | lint | make fmt-check |
| lint | check | lint | make lint |
| compile | check | typecheck | make compile |
| test | check | test | make coverage |
| test-integration | check | test | make test-integration |
| build | check | build | make build |
| api | serve | serve | make serve |
| readme-filled | check | check | test -s README.md && ! grep -n 'stacks:fill' README.md |
Usage and outcomes
Usage over time
Showing 180 days of history.
History
The 28-day green rate at each weekly observation. Gaps mean the sample was too small to publish.
Shaded band: 95% Wilson interval. Dashed rules: content changes. Missing observations remain gaps.
Stacks projects · 28 days through 4 Nov 2026. Counts rounded to 5.
Data table
| Through | Green rate | Projects | Content change |
|---|---|---|---|
| 5 Jul 2026 | hidden: too few projects | – | – |
| 12 Jul 2026 | 71% (65–76%, n=275) | 410 | – |
| 19 Jul 2026 | 73% (69–76%, n=570) | 860 | – |
| 26 Jul 2026 | 73% (71–76%, n=995) | 1,530 | – |
| 2 Aug 2026 | 74% (71–76%, n=1,470) | 2,295 | – |
| 9 Aug 2026 | 74% (71–76%, n=1,710) | 2,740 | – |
| 16 Aug 2026 | 73% (71–75%, n=1,970) | 3,175 | – |
| 23 Aug 2026 | 72% (70–74%, n=2,150) | 3,470 | – |
| 30 Aug 2026 | 72% (70–74%, n=2,280) | 3,700 | – |
| 6 Sept 2026 | 72% (70–74%, n=2,455) | 3,965 | – |
| 13 Sept 2026 | 72% (70–73%, n=2,605) | 4,200 | – |
| 20 Sept 2026 | 72% (70–73%, n=2,695) | 4,375 | – |
| 27 Sept 2026 | 72% (70–73%, n=2,900) | 4,640 | – |
| 4 Oct 2026 | 73% (71–74%, n=3,085) | 4,905 | – |
| 11 Oct 2026 | 73% (71–74%, n=3,250) | 5,185 | – |
| 18 Oct 2026 | 73% (72–75%, n=3,400) | 5,410 | – |
| 25 Oct 2026 | 73% (71–74%, n=3,510) | 5,620 | – |
| 1 Nov 2026 | 72% (71–73%, n=3,545) | 5,710 | – |
Weekly projects by preset
Non-overlapping seven-day project counts, grouped by the preset used to start the project.
- default
- sandbox
Stacks projects per UTC week through 4 Nov 2026. Published preset counts only; hidden cells are not zero.
Data table
| Week ending | Preset | Projects |
|---|---|---|
| 5 Jul 2026 | default | – |
| 12 Jul 2026 | default | 265 |
| 19 Jul 2026 | default | 315 |
| 26 Jul 2026 | default | 440 |
| 2 Aug 2026 | default | 480 |
| 9 Aug 2026 | default | 540 |
| 16 Aug 2026 | default | 575 |
| 23 Aug 2026 | default | 605 |
| 30 Aug 2026 | default | 650 |
| 6 Sept 2026 | default | 720 |
| 13 Sept 2026 | default | 690 |
| 20 Sept 2026 | default | 715 |
| 27 Sept 2026 | default | 820 |
| 4 Oct 2026 | default | 895 |
| 11 Oct 2026 | default | 920 |
| 18 Oct 2026 | default | 880 |
| 25 Oct 2026 | default | 940 |
| 1 Nov 2026 | default | 945 |
| 5 Jul 2026 | sandbox | – |
| 12 Jul 2026 | sandbox | 145 |
| 19 Jul 2026 | sandbox | 135 |
| 26 Jul 2026 | sandbox | 230 |
| 2 Aug 2026 | sandbox | 285 |
| 9 Aug 2026 | sandbox | 310 |
| 16 Aug 2026 | sandbox | 315 |
| 23 Aug 2026 | sandbox | 360 |
| 30 Aug 2026 | sandbox | 345 |
| 6 Sept 2026 | sandbox | 395 |
| 13 Sept 2026 | sandbox | 430 |
| 20 Sept 2026 | sandbox | 425 |
| 27 Sept 2026 | sandbox | 440 |
| 4 Oct 2026 | sandbox | 490 |
| 11 Oct 2026 | sandbox | 480 |
| 18 Oct 2026 | sandbox | 485 |
| 25 Oct 2026 | sandbox | 530 |
| 1 Nov 2026 | sandbox | 525 |
By preset
Green verify outcomes by the preset chosen at scaffold time.
default
70%68–72%, n=2,090
sandbox
76%74–79%, n=1,155
Stacks projects · 28 days through 4 Nov 2026. Counts rounded to 5.
Data table
| Name | Green rate | Projects |
|---|---|---|
| default | 70% (68–72%, n=2,090) | 3,380 |
| sandbox | 76% (74–79%, n=1,155) | 1,865 |
By agent
Within this stack, listed alphabetically. These are project outcomes, not an agent ranking.
claude
71%69–73%, n=1,805
codex
76%73–79%, n=775
cursor
71%65–75%, n=330
none
69%59–78%, n=90
opencode
71%63–77%, n=165
other
77%66–84%, n=80
Stacks projects · 28 days through 4 Nov 2026. Counts rounded to 5.
Data table
| Name | Green rate | Projects |
|---|---|---|
| claude | 71% (69–73%, n=1,805) | 2,950 |
| codex | 76% (73–79%, n=775) | 1,255 |
| cursor | 71% (65–75%, n=330) | 510 |
| none | 69% (59–78%, n=90) | 150 |
| opencode | 71% (63–77%, n=165) | 250 |
| other | 77% (66–84%, n=80) | 125 |
Time to green
Published time summaries on a shared minutes scale. First passing test is a median; 75% reached green by the 75th percentile.
- Verify runs to green
- 1
Stacks projects · 28 days through 4 Nov 2026. Counts rounded to 5.
Data table
| Measure | Time / runs |
|---|---|
| Median to green | 23 minutes |
| 75th percentile | 32 minutes |
| First passing test | 14 minutes |
| Verify runs to green | 1 |
Where it breaks
A run can fail more than one step. Environment failures are shown separately.
test-integration25%
test23%
lint12%
build10%
install6%
api6%
readme-filled6%
compile6%
fmt-check5%
Environment blocked0%
Share of failed runs before first green. Environment blocked describes the machine, not the stack.
Data table
| Step | Share |
|---|---|
| test-integration | 25% |
| install | 6% |
| api | 6% |
| test | 23% |
| readme-filled | 6% |
| build | 10% |
| compile | 6% |
| lint | 12% |
| fmt-check | 5% |
| Environment blocked | 0% |
What people change
Defaults people keep, and optional fragments they choose to attach.
Default, kept rate
agent-ops92%
git-hooks92%
ci-github92%
rest-api92%
Optional, attach rate
rr16%
ce-plugin17%
Share of the window's 5,245 projects. Kept rate is 1 minus the without rate.
Data table
| Fragment | Measure | Share |
|---|---|---|
| agent-ops | Kept | 92% |
| git-hooks | Kept | 92% |
| ci-github | Kept | 92% |
| rest-api | Kept | 92% |
| rr | Attached | 16% |
| ce-plugin | Attached | 17% |
By composition 53 fingerprints
Each row is a distinct fragment composition, with its own sample and content history.
| Composition | Green rate | Seen | Change in life |
|---|---|---|---|
| defaults + ce-plugin + rr − git-hooks · 01928d5e | hidden: too few projects | 26 Jul 2026 – 1 Nov 2026 | None |
| defaults + rr − agent-ops − ci-github − git-hooks · 0670981d | hidden: too few projects | 11 Oct 2026 – 1 Nov 2026 | None |
| defaults + rr − ci-github − git-hooks · 07d9b52f | hidden: too few projects | 9 Aug 2026 – 1 Nov 2026 | None |
| defaults + ce-plugin + rr − agent-ops − rest-api · 0919a056 | hidden: too few projects | 16 Aug 2026 – 1 Nov 2026 | None |
| defaults + ce-plugin − ci-github − rest-api · 0b4f7675 | hidden: too few projects | 12 Jul 2026 – 1 Nov 2026 | None |
| defaults − ci-github − git-hooks − rest-api · 0c4d2447 | hidden: too few projects | 12 Jul 2026 – 1 Nov 2026 | None |
| defaults + rr − git-hooks − rest-api · 10f17706 | hidden: too few projects | 19 Jul 2026 – 1 Nov 2026 | None |
| defaults + ce-plugin + rr − git-hooks − rest-api · 157df966 | hidden: too few projects | 13 Sept 2026 – 1 Nov 2026 | None |
| defaults + rr − agent-ops − ci-github − rest-api · 17dfed26 | hidden: too few projects | 1 Nov 2026 – 1 Nov 2026 | None |
| defaults + ce-plugin − agent-ops − ci-github − git-hooks · 2a75c2d2 | hidden: too few projects | 9 Aug 2026 – 1 Nov 2026 | None |
| defaults + ce-plugin + rr − rest-api · 31f8873e | hidden: too few projects | 26 Jul 2026 – 1 Nov 2026 | None |
| defaults + ce-plugin + rr − agent-ops · 38010779 | hidden: too few projects | 12 Jul 2026 – 1 Nov 2026 | None |
| defaults − git-hooks − rest-api · 3cf5621b | hidden: too few projects | 12 Jul 2026 – 1 Nov 2026 | None |
| defaults − agent-ops − ci-github − git-hooks · 4ed3cf9b | hidden: too few projects | 12 Jul 2026 – 1 Nov 2026 | None |
| defaults − agent-ops · 5140a88c | hidden: too few projects | 12 Jul 2026 – 1 Nov 2026 | None |
| defaults + rr − agent-ops · 572c7248 | hidden: too few projects | 12 Jul 2026 – 1 Nov 2026 | None |
| defaults − ci-github − rest-api · 58e49c7a | hidden: too few projects | 12 Jul 2026 – 1 Nov 2026 | None |
| defaults − git-hooks · 5e0af5a8 | hidden: too few projects | 12 Jul 2026 – 1 Nov 2026 | None |
| defaults + ce-plugin + rr − ci-github − git-hooks · 635a2033 | hidden: too few projects | 6 Sept 2026 – 1 Nov 2026 | None |
| defaults + ce-plugin − rest-api · 6a813228 | hidden: too few projects | 12 Jul 2026 – 1 Nov 2026 | None |
| defaults + ce-plugin − agent-ops − rest-api · 6c17d505 | hidden: too few projects | 12 Jul 2026 – 1 Nov 2026 | None |
| defaults + ce-plugin + rr − ci-github − rest-api · 6e447fc6 | hidden: too few projects | 2 Aug 2026 – 1 Nov 2026 | None |
| defaults − ci-github · 6e9a49e0 | hidden: too few projects | 12 Jul 2026 – 1 Nov 2026 | None |
| defaults + ce-plugin − agent-ops − git-hooks · 6ff6011b | hidden: too few projects | 12 Jul 2026 – 1 Nov 2026 | None |
| defaults − agent-ops − git-hooks − rest-api · 7331c5b0 | hidden: too few projects | 2 Aug 2026 – 1 Nov 2026 | None |
| defaults − agent-ops − rest-api · 7776b017 | hidden: too few projects | 12 Jul 2026 – 1 Nov 2026 | None |
| defaults + ce-plugin − git-hooks − rest-api · 7bfe0578 | hidden: too few projects | 19 Jul 2026 – 1 Nov 2026 | None |
| defaults + rr · 7f37a290 | 75% (71–79%, n=430) | 12 Jul 2026 – 1 Nov 2026 | None |
| defaults − agent-ops − ci-github − rest-api · 8fe6cb90 | hidden: too few projects | 19 Jul 2026 – 1 Nov 2026 | None |
| defaults + ce-plugin − ci-github · 961c5a7d | hidden: too few projects | 12 Jul 2026 – 1 Nov 2026 | None |
| defaults + rr − rest-api · 96b64a92 | hidden: too few projects | 12 Jul 2026 – 1 Nov 2026 | None |
| defaults + ce-plugin + rr − ci-github · 9b35cd80 | hidden: too few projects | 26 Jul 2026 – 1 Nov 2026 | None |
| defaults + rr − agent-ops − rest-api · 9f28fec3 | hidden: too few projects | 26 Jul 2026 – 1 Nov 2026 | None |
| defaults + ce-plugin − agent-ops − ci-github · 9f62e980 | hidden: too few projects | 2 Aug 2026 – 1 Nov 2026 | None |
| defaults − agent-ops − ci-github · a323d34d | hidden: too few projects | 12 Jul 2026 – 1 Nov 2026 | None |
| defaults − ci-github − git-hooks · a44dd648 | hidden: too few projects | 12 Jul 2026 – 1 Nov 2026 | None |
| defaults + rr − agent-ops − git-hooks · a98d1cb3 | hidden: too few projects | 2 Aug 2026 – 1 Nov 2026 | None |
| defaults + ce-plugin · af72626b | 74% (70–78%, n=480) | 12 Jul 2026 – 1 Nov 2026 | None |
| defaults + rr − git-hooks · b4176d87 | hidden: too few projects | 12 Jul 2026 – 1 Nov 2026 | None |
| defaults + ce-plugin − git-hooks · b6a7b511 | hidden: too few projects | 12 Jul 2026 – 1 Nov 2026 | None |
| defaults + rr − ci-github · b91a95a5 | hidden: too few projects | 12 Jul 2026 – 1 Nov 2026 | None |
| defaults + rr − ci-github − rest-api · c1fd8ba5 | hidden: too few projects | 26 Jul 2026 – 1 Nov 2026 | None |
| defaults + ce-plugin + rr − agent-ops − git-hooks · c45cc4a0 | hidden: too few projects | 9 Aug 2026 – 1 Nov 2026 | None |
| defaults + ce-plugin + rr − ci-github − git-hooks − rest-api · c9dd8a77 | hidden: too few projects | 1 Nov 2026 – 1 Nov 2026 | None |
| defaults + ce-plugin − ci-github − git-hooks · ca6479f6 | hidden: too few projects | 16 Aug 2026 – 1 Nov 2026 | None |
| defaults + rr − agent-ops − git-hooks − rest-api · cb3af451 | hidden: too few projects | 26 Jul 2026 – 1 Nov 2026 | None |
| defaults + rr − agent-ops − ci-github · d09ffcdf | hidden: too few projects | 19 Jul 2026 – 1 Nov 2026 | None |
| defaults − rest-api · da56ceb6 | hidden: too few projects | 12 Jul 2026 – 1 Nov 2026 | None |
| defaults · e392a227 | 71% (69–73%, n=2,260) | 12 Jul 2026 – 1 Nov 2026 | None |
| defaults + ce-plugin − agent-ops · e4534560 | hidden: too few projects | 12 Jul 2026 – 1 Nov 2026 | None |
| defaults + ce-plugin + rr − agent-ops − ci-github · ec736350 | hidden: too few projects | 20 Sept 2026 – 1 Nov 2026 | None |
| defaults − agent-ops − git-hooks · ede48f0e | hidden: too few projects | 12 Jul 2026 – 1 Nov 2026 | None |
| defaults + ce-plugin + rr · f036749f | 74% (63–83%, n=75) | 12 Jul 2026 – 1 Nov 2026 | None |
Computed 5 Nov 2026, through 4 Nov 2026. Numbers describe stacks projects, not the ecosystem.