Production-ready project starter with DDD layout, layered agent enforcement, and multi-project monorepo support.
uv sync --dev
make verifyExpected output:
ruff check ......... All checks passed
ruff format ........ 37 files already formatted
mypy --strict ...... Success: no issues found
pytest ............. 52 passed, 88% coverage
| Layer | Mechanism | Gates |
|---|---|---|
| L0: Tooling | make verify (ruff + mypy + pytest) |
Mechanical — fails CI if violated |
| L1: Self-Verification | 9-item checklist agent must complete | Behavioral — agent self-reports violations |
| L2: Workflow | TDD, debug cycle, compose > inherit, DDD | Agent follows prescribed process |
| L3: Domain Contracts | 6 standards docs with compliance checklists | Read-before-touch gates |
| L4: Agent Memory | ADRs, domain glossary | Persistent project context |
| L5: Monorepo | Per-package AGENTS.md, dependency direction | Cross-package verification |
| Skill | Enforces |
|---|---|
tdd-workflow |
Red-green-refactor cycle |
code-review |
SOLID, OOP, DDD, type safety, code smells |
structure-check |
File tree matches STRUCTURE.md |
init-project |
Bootstrap new projects from template |
starter/
├── AGENTS.md ← L0-L5 layered enforcement (the differentiator)
├── AGENTS.md.template ← Template for new projects
├── CLAUDE.md / GEMINI.md ← Platform shims
├── .agents/skills/ ← 4 enforcement skills
├── docs/
│ ├── adr/ ← Architecture Decision Records
│ ├── standards/ ← 6 domain contracts
│ └── TODO.md ← Future work
├── packages/{core,cli,api,infra} ← 4-package monorepo
├── src/application/ ← Flat starter (facade shims)
├── tests/integration/ ← Application-level assembly tests
├── scripts/ ← Utility scripts (bootstrap, etc.)
├── LICENSE ← Apache 2.0
└── CONTRIBUTING.md
| Command | Purpose |
|---|---|
make install |
Install dev dependencies |
make lint |
Run ruff check + format verify |
make typecheck |
Run mypy strict type checking |
make test |
Run tests with coverage (threshold: 75%) |
make verify |
Run lint + typecheck + test |
make clean |
Remove caches and build artifacts |
- OOP — encapsulation, composition over inheritance
- SOLID — SRP, OCP, LSP, ISP, DIP
- DDD — entities, value objects, repositories, aggregates
- GoF Patterns — factory, strategy, observer
- Immutability — frozen dataclasses, no setters
Full details: docs/standards/DESIGN.md
See docs/TODO.md for planned improvements including:
- Pre-commit hooks and CI pipeline
- Project bootstrap script
- TypeScript and Go variants
- Observability and security standards
Apache 2.0 © Contributors
See LICENSE for the full text.