tibursocampos/agent-dev-toolkit / core/skills/java-developer
java-developer
VerifiedImplement or fix small-to-medium Java features without full SDD (Spring Boot default). Use for isolated JVM/Spring Boot work or when invoking /java-developer.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.3 KB |
| reference.md | markdown | 459 B |
| references/execute-flow.md | markdown | 3.3 KB |
| references/must-not.md | markdown | 707 B |
| references/scope.md | markdown | 560 B |
SKILL.md
View on GitHub---
name: java-developer
description: Implement or fix small-to-medium Java features without full SDD (Spring Boot default). Use for isolated JVM/Spring Boot work or when invoking /java-developer.
---
## STOP - Read before ANY tool call
Read `_shared/skill-boilerplate.md` first. It holds the guardrails read, the session gate rule, the user `sim` rule, the one-step rule, the gate check, and the user chat language rule. The steps below are skill-specific only.
---
# Skill: java-developer
## Trigger
**Negative signal:** applies as defined in `_shared/skill-boilerplate.md`; the skill-specific signals are listed below.
Invoke when the user asks for: `/java-developer`, `java fix`, `implement Spring Boot feature`, or for **small** JVM backend work that does not need a full PRD/PLAN cycle.
## Outcome
Working **Java** (Spring Boot by default) code and tests in the open workspace: build and tests green, on a valid feature branch, with optional commit handoff. Does not replace SDD for multi-step or cross-repo features.
## Lazy-load (only when needed)
| When | Path (after syncing the active adapter) |
|------|----------------------------------------|
| Repo context | `{{TOOLKIT_ROOT}}/skills/_shared/developer-common/step-0-context.md` |
| Before coding | `{{TOOLKIT_ROOT}}/skills/_shared/developer-common/step-0.5-review-guidelines.md` |
| Structure / quality (when coding) | `{{TOOLKIT_ROOT}}/skills/_shared/code-guidelines/principles/structure-and-quality.md` |
| Branching | `{{TOOLKIT_ROOT}}/rules/branch-validation.mdc`, `{{TOOLKIT_ROOT}}/skills/_shared/developer-common/step-3-branching.md` |
| Pre-commit | `{{TOOLKIT_ROOT}}/skills/_shared/developer-common/step-3.5-precommit-validation.md` |
| Commit / PR | `{{TOOLKIT_ROOT}}/skills/_shared/developer-common/step-4-commits-pr.md`, `{{TOOLKIT_ROOT}}/rules/conventional-commits.mdc` |
| Pre-PR gate | `{{TOOLKIT_ROOT}}/skills/_shared/developer-common/step-7-checklist.md` |
| Spring Boot defaults | `{{TOOLKIT_ROOT}}/skills/_shared/java-guidelines/spring-boot-defaults.md` |
| Layers / packages | `{{TOOLKIT_ROOT}}/skills/_shared/java-guidelines/layered-structure.md` |
| Architecture boundaries | `{{TOOLKIT_ROOT}}/skills/_shared/java-guidelines/architecture-boundaries.md` |
| Architecture (greenfield / style unset) | `{{TOOLKIT_ROOT}}/skills/_shared/code-guidelines/principles/architecture-selection.md` — then **one** approved style only |
| Architecture (ARCH = concentric / clean / hexagonal) | `{{TOOLKIT_ROOT}}/skills/_shared/java-guidelines/architecture/clean-hexagonal.md` (+ optional `principles/architecture/concentric-dependency.md`) |
| Architecture (ARCH = vertical-slice / modulith) | `{{TOOLKIT_ROOT}}/skills/_shared/java-guidelines/architecture/modulith-vertical.md` (+ optional `principles/architecture/vertical-slice.md`) |
| Architecture (ARCH = ddd / tactical DDD) | `{{TOOLKIT_ROOT}}/skills/_shared/java-guidelines/architecture/ddd-tactical.md` (+ optional `principles/architecture/ddd-tactical.md`) |
| Architecture (ARCH = event-driven / EDA) | `{{TOOLKIT_ROOT}}/skills/_shared/java-guidelines/architecture/event-driven.md` (+ optional `principles/architecture/event-driven.md`) |
| Java style | `{{TOOLKIT_ROOT}}/skills/_shared/java-guidelines/java-style.md` |
| Build / BOM | `{{TOOLKIT_ROOT}}/skills/_shared/java-guidelines/build-and-bom.md` |
| Configuration | `{{TOOLKIT_ROOT}}/skills/_shared/java-guidelines/configuration.md` |
| Testing | `{{TOOLKIT_ROOT}}/skills/_shared/java-guidelines/testing.md` |
| Security basics | `{{TOOLKIT_ROOT}}/skills/_shared/java-guidelines/security-basics.md` |
| Resilience (outbound timeouts / retry when touched) | `{{TOOLKIT_ROOT}}/skills/_shared/java-guidelines/resilience.md` |
| Final checklist | `{{TOOLKIT_ROOT}}/skills/_shared/java-guidelines/checklist.md` |
| Subagent-first / SPAWN.md | `{{TOOLKIT_ROOT}}/skills/_shared/developer-common/subagent-first.md`, `{{TOOLKIT_ROOT}}/skills/_shared/agents/SPAWN.md` |
| Caveman Mode (if active) | `{{TOOLKIT_ROOT}}/skills/_shared/caveman/CAVEMAN.md` - **Full cap** |
| Reference index (routing only) | `{{TOOLKIT_ROOT}}/skills/java-developer/reference.md` |
| Process step detail (lazy) | `{{TOOLKIT_ROOT}}/skills/java-developer/references/<section>.md` |
Do **not** preload other stack guideline packs or corporate pipeline docs. Load only the `java-guidelines` rows needed for the current task. **MUST NOT** glob `architecture/**` — load **one** style overlay from ARCH/CONTINUITY (brownfield: discover-first if style omitted).
**Never by default:** do not preload all `references/*.md`. do not preload other stack guideline packs. Load only Java/Spring rows needed for the current task. Do not dump full stack guideline packs or memory-bank. Load **one** section per Process step (`SKILL-REFERENCE-RETRIEVAL.md`).
## Reference routing
| Situation | Path |
|-----------|------|
| Scope / SDD escalation / design brief | `references/scope.md` |
| Implement flow | `references/execute-flow.md` |
| Must not (full) | `references/must-not.md` |
## Process
Read `references/<section>.md` for procedural detail — **not** full `reference.md`.
### Step -1b - Caveman Mode (Full cap)
1. Read `{{SDD_ROOT}}/preferences.json` (create `{ "caveman_mode": false, "caveman_level": "full" }` if missing).
2. If `caveman_mode` is false: continue without compression.
3. If true: load `{{TOOLKIT_ROOT}}/skills/_shared/caveman/CAVEMAN.md`; apply **Full** participation cap + prefs `caveman_level` (Lite skills never escalate); show once: `[Caveman] Modo ativo (respostas compactas, level={effective}). Digite caveman off para desativar.`
4. Honor `caveman on|off|status|lite|full|ultra` (and `stop caveman` / `normal mode`) during the session.
5. Auto-Clarity + never-compress gates/drafts/paths per `CAVEMAN.md`.
### 0. Scope
Follow `references/scope.md` (SDD escalation, design brief / host detection when present).
### 1. Execute
Follow `references/execute-flow.md` (subagent-first, workspace → guidelines → branch → implement → tests → handoff).
## Must not
Enforce the full list in `references/must-not.md`. Critical: no guideline dumps into children; no auto-commit; lazy-load stack guidelines only — never dump full packs or memory-bank.
## Handoff
| Situation | Next |
|-----------|------|
| Commit | `/commit` |
| Review | `/code-review` |
| Large scope | `/sdd-spec` -> `sdd-plan` -> `sdd-develop` |
| Next PLAN step | New chat -> `/sdd-develop - PLAN/... - Step N` |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |