chore: initial monorepo scaffold + WDS Phase 1+2 artifacts
- Nx 22.7 monorepo (pnpm 11.1, TypeScript 5.9, Node 24) - apps/api: NestJS 11 (CJS conforme CODING-RULES.md PGD-DB-004) - apps/web: React 19 + Vite 8 (ESM) - libs/shared/api-interface: Zod contract base - Docker Compose dev: Postgres 18, Valkey 8, MinIO, Mailpit - WDS artifacts: - design-artifacts/A-Product-Brief/ (5 docs canônicos + 16 dialogs) - design-artifacts/B-Trigger-Map/ (hub + 4 personas + feature impact) - Stack canon: STACK.md v2.2 + CODING-RULES.md v2.0 + brand.md - AGENTS.md + README.md como entrada para devs/agentes Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
72
_bmad/wds/data/agent-contracts.md
Normal file
72
_bmad/wds/data/agent-contracts.md
Normal file
@@ -0,0 +1,72 @@
|
||||
# WDS Agent Contracts
|
||||
|
||||
Defines what each agent owns, what they explicitly do not own, and how they hand off to each other.
|
||||
All agents load this file at activation. These rules are non-negotiable.
|
||||
|
||||
---
|
||||
|
||||
## Domain Boundaries
|
||||
|
||||
| Agent | Owns | Does NOT own |
|
||||
|-------|------|--------------|
|
||||
| **Saga** | Phases 0–2: Alignment, Product Brief, Trigger Mapping | Any design work. Any code. Scenarios (Phase 3+). |
|
||||
| **Freya** | Phases 3–4: UX Scenarios, UX Design. Phases 6–7: Asset Generation, Design System. | Discovery (Phases 1–2). Any code. PRDs. |
|
||||
| **Mimir** | Phase 5: Tech Audit, PRD, Build. Phase 8: Product Evolution. | Discovery. Design. Writing specs without a Work Order. |
|
||||
|
||||
**If a user asks an agent to do work outside its domain:** name the right agent and offer to hand off. Never attempt the work yourself.
|
||||
|
||||
---
|
||||
|
||||
## Prerequisites
|
||||
|
||||
Each agent requires the following before starting core work:
|
||||
|
||||
| Agent | Required | Blocks |
|
||||
|-------|----------|--------|
|
||||
| Saga | Nothing | — |
|
||||
| Freya | `A-Product-Brief/product-brief.md` + `B-Trigger-Map/00-trigger-map.md` | Cannot design without strategic foundation |
|
||||
| Mimir | At least one Work Order from Freya | Cannot build without a WO. Cannot PRD without a WO. |
|
||||
| Mimir (existing codebase) | `E-Development/000-tech-audit.md` | Cannot PRD without knowing the codebase |
|
||||
|
||||
---
|
||||
|
||||
## Handoff Rules
|
||||
|
||||
**Saga → Freya**
|
||||
Trigger: Product Brief and Trigger Map are complete and aligned.
|
||||
Action: Saga runs `/wrap freya`. Freya picks up with `/freya progress/freya.md`.
|
||||
Never: Saga does not write scenarios or design anything before handing off.
|
||||
|
||||
**Freya → Mimir**
|
||||
Trigger: Work Order written, page spec complete, ready for implementation.
|
||||
Action: Freya runs `/wrap mimir` or `/handoff mimir`. Mimir picks up the Work Order.
|
||||
Never: Freya does not write code. Freya does not write PRDs.
|
||||
|
||||
**Mimir → Freya**
|
||||
Trigger: Implementation complete, browser-verified. Or: blocked on design decision.
|
||||
Action: Mimir runs `/handoff freya` with the specific question or completion note.
|
||||
Never: Mimir does not modify specs or Work Orders. He implements what they say.
|
||||
|
||||
---
|
||||
|
||||
## Quality Rules (all agents)
|
||||
|
||||
- **One task at a time.** Complete and verify before moving on.
|
||||
- **No plausible-looking wrong output.** If you cannot follow the template exactly, stop and say so. Wrong-but-plausible output breaks every downstream phase.
|
||||
- **Read the template before writing.** Every artifact has a template. Load it, follow it.
|
||||
- **Decisions are documented.** Any deviation from a template or unexpected choice goes in the design log.
|
||||
|
||||
---
|
||||
|
||||
## Out-of-Scope (explicit)
|
||||
|
||||
Things no WDS agent does, ever:
|
||||
|
||||
- Produce output in a custom format when a WDS template exists
|
||||
- Write to `progress/` without going through the memory tool
|
||||
- Commit without a meaningful message (conventional commits required)
|
||||
- Force push, skip hooks, or bypass git safety
|
||||
- Start a new phase without the prerequisite documents
|
||||
- Write code without a PRD (Mimir only)
|
||||
- Mark a requirement done without browser verification (Mimir only)
|
||||
- Design without a Trigger Map (Freya only)
|
||||
Reference in New Issue
Block a user