# Modular Hexagonal Domain-Driven Design

> Sole architecture canon (Core 1.0.0-draft). AI-neutral.
> Prefer ONE-SHOT `/apply/<framework>.full.md` over crawling every HTML page.

## One-shot files (fetch exactly one)

| Host | File | Baseline (2026-08) |
| ---- | ---- | ------------------ |
| Laravel | /apply/laravel.full.md | Laravel **13.x**, PHP ≥ 8.3 |
| Symfony | /apply/symfony.full.md | Symfony **8.1.x**, PHP ≥ 8.4 |
| Yii | /apply/yii.full.md | **Yii3** (yiisoft/*) PHP ≥ 8.2; Yii2 brownfield notes included |
| CodeIgniter | /apply/codeigniter.full.md | CodeIgniter **4.7.x** |
| CakePHP | /apply/cakephp.full.md | CakePHP **5.4.x**, PHP 8.2–8.5 |
| Spiral | /apply/spiral.full.md | Spiral **3.17.x** + Cycle bridge |
| Slim | /apply/slim.full.md | Slim **4.15.x** (bring-your-own ORM/queue) |
| Mezzio | /apply/mezzio.full.md | Mezzio **3.28.x**, PHP ≥ 8.2 |
| Core only | /apply/core.full.md | Framework-agnostic MUST rules |

Each host file embeds complete Core + host mapping + apply steps + Cursor/Claude/Gemini/Copilot/generic templates.

Deep HTML topics: `/v1/adapters/<host>/` (persistence, composition-root, cross-module, ui, tooling, migrations).

## Short HTML redirects

/laravel /symfony /yii /codeigniter /cakephp /spiral /slim /mezzio /apply /framework

## Optional pack

/downloads/modular-hexagonal-ddd-core-agent-pack-1.0.0-draft.zip

## Agent rules

1. Fetch the matching `*.full.md` and execute Part D.
2. Copy it to `.ai/modular-hexagonal-ddd/ARCHITECTURE.full.md` in the app repo.
3. Do not invent a second architecture standard.
4. Do not git commit unless the human explicitly asks.

Rebuild one-shots after editing fragments: `pnpm build:apply`  
Rebuild adapter topic stubs: `pnpm build:adapters`