# Audit Java Projects for DDD Compliance

Java architecture can drift across layers, dependencies, and domain models. This skill reviews recent changes or entire projects against practical DDD rules.

## Install

```bash
npx skillstore add bookiosk/ddd-check
```

## Metadata

- Status: approved
- Slug: bookiosk-ddd-check
- Version: 2.0
- Author version: 2.0
- Skillstore revision: r2
- Version status: invalid
- Tree hash: 06e82dd854521b7a9d76725189e842b402bf5a5dd8064007ae34463099c84acd
- Author: bookiosk
- GitHub username: bookiosk
- License: Apache-2.0
- Repository: https://github.com/bookiosk/ddd-check/tree/main/
- Ref: 78a92e43ebef463a25ff4e338201e38672130086
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: network, filesystem, external\_commands
- Quality score: 78
- Quality tier: bronze
- Public page: https://skillstore.pages.dev/skills/bookiosk-ddd-check
- Manifest: https://skillstore.pages.dev/api/skills/bookiosk-ddd-check/manifest

## Capabilities

- Selects incremental or full-project review mode from the requested scope.
- Finds changed Java files with Git for focused pre-commit reviews.
- Discovers production Java files for full architecture audits.
- Checks package placement, naming, base classes, dependencies, and exception handling.
- Identifies anemic models and other documented DDD anti-patterns.
- Produces prioritized violations with rule references and suggested fixes.

## Use Cases

- Review a Feature Branch: Check changed Java files before commit and receive focused DDD violations with practical fixes.
- Audit Layer Boundaries: Evaluate dependencies, package placement, domain behavior, and exception boundaries across a complete project.
- Prioritize Architecture Work: Use severity-ranked findings and layer scores to plan remediation across teams and releases.

## Prompt Templates

### Check Recent Changes

```
Check my changed Java files for DDD compliance. Report only violations, cite the relevant rule, and provide a specific fix.
```

### Review One Layer

```
Review the {layer} layer in {project_path}. Check package placement, naming, base classes, dependencies, and exception handling.
```

### Run a Full Architecture Audit

```
Run a full DDD compliance audit of this Java project. Score each layer, identify cross-layer violations, and rank remediation work by severity.
```

### Trace an Aggregate Workflow

```
Audit the {aggregate_name} workflow end to end. Trace dependencies across layers, detect anemic modeling, and evaluate transaction and exception boundaries.
```

## Limitations

- The rules target the supplied Java architecture conventions, not every valid DDD implementation.
- Repository discovery requires Git, find, grep, and a compatible shell environment.
- The skill reviews source structure but does not compile code or execute tests.
- Intentional architecture exceptions still require confirmation from project maintainers.

## Best Practices

- State whether the review should cover changed files, one layer, or the entire project.
- Provide project-specific base classes, naming rules, and approved architecture exceptions.
- Verify high-severity findings against source context before scheduling remediation.

## Anti Patterns

- Do not apply the supplied Java conventions unchanged to unrelated languages or architectures.
- Do not treat a compliance score as proof of runtime correctness or complete domain modeling.
- Do not request an incremental review when unchanged project files must also be evaluated.

## Security Audit

- Audited at: 2026-07-23T15:51:59.66\+00:00
- Summary: All 70 static findings are false positives caused by license links, Markdown formatting, Java Mapper examples, architecture prose, or fixed read-only repository commands. No prompt injection, exfiltration, destructive command, reconnaissance behavior, or malicious intent was found.

## Stats

- Views: 0
- Downloads: 3
- Favorites: 1
- Popularity score: 0