# Java Architecture Guidelines

> Use for Java architecture in middleware and platform projects: module layering, domain model, service orchestration, concurrency model, exception boundary, interface contract and maintainable package design from requirements and architecture tasks.

- Skill: `ailearneryang/java-architecture-guidelines` (Agent Skill)
- Install (CLI): `npx skillmds@latest add ailearneryang/java-architecture-guidelines`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ailearneryang/java-architecture-guidelines/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: ailearneryang (https://skillmd.com/u/ailearneryang)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ailearneryang/java-architecture-guidelines

---


# Java Architecture Guidelines

## 适用场景

- 需求涉及 Java 服务编排、领域模型、模块分层、Android Java 服务或平台 Java 组件。
- 需要设计包结构、接口契约、线程模型、状态仓库和异常边界。

## 必须补充的设计点

- package/module 边界、接口可见性、依赖方向和禁止循环依赖策略。
- 领域模型、DTO、Repository、UseCase、Facade 等职责分工。
- 线程池、串行队列、回调、Future、消息分发、状态一致性约束。
- checked / unchecked 异常边界、错误码转换、审计与日志脱敏。
- 面向测试的接口抽象、可替换实现和稳定扩展点。

## 输出约束

- 文档中必须说明 Java 模块如何支撑可维护性与可测试性。
- 必须说明状态流、异常流和并发模型，而不是只给类名清单。
- 如果 Java 只是桥接层，必须说明它与 C++/native 层的桥接契约。