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:
2026-05-27 14:34:20 +00:00
commit 17c08e6392
3631 changed files with 855518 additions and 0 deletions

View File

@@ -0,0 +1,89 @@
---
name: design-solution
description: Sketch and specify the update for a scoped improvement
borrows_from: Phase 4 (UX design)
---
# Design Solution
**Goal:** Design the solution for a scoped improvement — from quick sketch to development-ready specification.
---
## INITIALIZATION
### Design Log
Read `{output_folder}/_progress/00-design-log.md`. Check Current and Backlog for context.
## Steps
### Step 1: Load Scenario
Read the scenario from [S] Scope Improvement:
- Target description
- Current vs desired state
- User journey
- Pages and components affected
### Step 2: Choose Design Approach
Based on the change scope, pick an approach:
- **Quick fix** — Small visual/copy change → Skip to Step 4 (specify directly)
- **Sketch first** — Layout or flow change → Sketch the before/after, then specify
- **Generate design** — Significant visual change → Use Phase 6 asset generation tools
### Step 3: Design the Change
For sketch or generate approaches:
1. **Before snapshot** — Capture or describe the current view
2. **After concept** — Sketch, generate, or describe the desired view
3. **Diff view** — Explicitly mark what changes: layout, components, content, behavior
4. **Edge cases** — What happens on mobile? With long text? With empty state?
Present design to user for feedback. Iterate until approved.
### Step 4: Write Specification
Create a mini page-spec at `{output_folder}/evolution/specs/`:
```markdown
# [Page/View Name] — Update Specification
## Change Summary
[One paragraph describing the change]
## Before
[Current state description or reference]
## After
[Detailed specification of the new state]
## Components
[List each component with its new properties/behavior]
## Responsive Behavior
[How the change adapts across breakpoints]
## Acceptance Criteria
[Testable criteria from the scenario]
```
### Step 5: Approve Specification
Present the specification for user sign-off:
- Does it match the scenario intent?
- Are acceptance criteria testable?
- Is scope still manageable?
---
## AFTER COMPLETION
1. Update design log
2. Suggest next action
3. Return to activity menu