codebase-design
Translate DDD decisions into concrete packages, seams, adapters, files, and tests. Use after architecture design and before implementation planning.
How do I install this agent skill?
npx skills add https://github.com/omegafrog/harness-codex --skill codebase-designIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides design guidelines for organizing a codebase according to Domain-Driven Design (DDD) principles. It does not contain any executable code, network operations, or requests for sensitive data.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
codebase-design
What it does
codebase-design turns the DDD shape into an implementation contract for the codebase. It decides which packages, seams, adapters, tests, and files change, without reopening the DDD decisions themselves.
Inputs
- Architecture Spec
ddd-designoutputcode-researchsummaryeffective-java-notes.mdwhen writing Java
Package layout
The default Java package shape is:
ui
app
domain
infra
uiholds outward-facing entry points and presentation adapters.appholds orchestration application services only.appis the transaction boundary.domainholds entities, value objects, domain methods, domain services, aggregates, and domain policies.infraholds adapters that implement ports.
Process
- Translate the
event-stormingpolicy output into unit-testable behavior. - Keep
domainbehavior in domain methods or domain services. - Model aggregate relationships through entity IDs, not through broad object graphs.
- Put orchestration-only application services in
app. - Put port implementations and external-system adapters in
infra. - Map the minimum set of files, modules, interfaces, seams, and tests needed to realize the design.
- Consult
effective-java-notes.mdbefore writing Java code.
Completion
- The code structure is concrete enough to implement.
- Domain decisions are not re-litigated here.
- The package shape stays
ui / app / domain / infra. - The transaction boundary stays in
app. - Policy behavior is covered by unit tests.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/omegafrog/harness-codex/codebase-design">View codebase-design on skillZs</a>