Workspace de Referência para Projetos Java
bernardladenthin/workspace
Camada compartilhada canônica para múltiplos projetos Java com Claude
Ver no GitHubRepositório centralizado que funciona como fonte única de verdade para guias, políticas e instruções de Claude Code Agent compartilhadas entre múltiplos projetos Java. Contém convenções de código, guias de TDD, políticas de qualidade e templates padronizados que alimentam toda uma família de repositórios irmãos.
Instalação
npx convez-ai bernardladenthin/workspace1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Centralizar guias de escrita de código e testes em Java (8 e 21)
- Manter políticas consistentes (Javadoc, SpotBugs, jqwik) entre repositórios
- Fornecer skills de TDD reutilizáveis para Claude Code Agent
- Definir workflows padrão de PR e templates de configuração
Veredito

Padrão empresarial robusto para governança de código em ecossistema multi-repo Java. Recomendado para equipes que precisam escalar guias e políticas com versionamento explícito e rastreabilidade — especialmente eficaz quando Claude é usado como agente de validação e geração de código.
README
A tradução para o português deste README ainda está na fila.
workspace
Cross-repo shared layer for Bernard Ladenthin's Java repositories.
This repo is the single source of truth for content that applies to
every sibling Java project — Claude Code skills, code/test writing
guides, shared policies (jqwik pin, Javadoc conventions, SpotBugs
suppressions), the standard CLAUDE.md template, and the cross-repo
PR workflow.
Sibling repos
Layout
.claude/skills/java-tdd-guide/SKILL.md Canonical Java TDD skill (Jupiter, Java 8 baseline)
guides/src/CODE_WRITING_GUIDE-8.md Production-code conventions (Java 8 baseline)
guides/src/CODE_WRITING_GUIDE-21.md Java 21 production-code supplement (extends -8.md)
guides/test/TEST_WRITING_GUIDE-8.md Test conventions (Java 8 baseline, Jupiter + Hamcrest)
guides/test/TEST_WRITING_GUIDE-21.md Java 21 test supplement (extends -8.md)
policies/javadoc-conventions.md HTML-entity rules for Javadoc
policies/spotbugs-suppressions.md spotbugs-exclude.xml maintenance
policies/jqwik-prompt-injection.md jqwik pin + incident note
policies/code-quality-todos.md Recurring per-repo audits
workflows/pull-request-workflow.md gh / MCP PR steps
templates/CLAUDE.md.template Standard per-repo CLAUDE.md
crossrepostatus.md Live cross-repo status table
Versioned guide chain
Inside guides/src/ and guides/test/, files are named
<NAME>-<JAVA-VERSION>.md. A higher-version file extends every
lower-version file in its chain — read every file from the lowest
applicable version up to the highest one your repo's pom.xml
<release> allows.
The baseline -8.md files apply to every sibling repo.
BitcoinAddressFinder is on Java 21 and additionally follows the
-21.md supplements. The other three repos (streambuffer,
java-llama.cpp, llamacpp-ai-index-maven-plugin) target Java 8 and
must not use Java 21 idioms.
Style ground truth
BitcoinAddressFinder and streambuffer are hand-written by the
owner and are the authoritative references for code style. The
other two repos are predominantly AI-generated; their patterns are
data points, not canon.
How sibling repos consume this
Each sibling repo carries its own CLAUDE.md with repo-specific
content only: project overview, build commands, architecture,
dependencies, repo-specific TODOs. Sections that are identical across
all four repos (Javadoc HTML entities, SpotBugs rules, jqwik policy,
the three recurring code-quality audits, the PR workflow) are replaced
in each repo by a one-line pointer to the canonical doc here.
The java-tdd-guide skill lives only in this repo; sibling repos
carry a SKILL.pointer.md marker file naming the canonical path.
Claude sessions reach the skill by having workspace in their session
scope alongside the active sibling repo.
License
Apache 2.0 — see LICENSE.