- 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>
1.4 KiB
1.4 KiB
Session Start Protocol
When starting or resuming a session, always follow this sequence before implementing anything:
1. Read the Dialog Document
Read the dialog file completely to understand:
- What steps are done
- What steps remain
- Any blockers or change requests
- Current context and decisions
2. Verify Plan Against Reality
The plan may be outdated. Check if:
- Steps marked "To Do" have actually been implemented
- Steps marked "Done" are truly complete
- Numbering is sequential and accurate
If the plan is outdated → Update it before proceeding.
3. Present Current Status
Summarize for the designer:
- What's done (with step numbers)
- What's remaining (with step numbers)
- Any change requests pending
4. Before Implementing a Step
Always check the specification/sketches first:
Agent: "Before implementing step 20, let me check the sketches..."
Agent: "I see this requires a nested drawer pattern, not inline buttons.
Should I break this into sub-steps?"
This prevents building the wrong thing and wasting effort.
Why This Matters
Sessions can be interrupted. Context can be lost. The dialog document survives — but only if it's kept accurate. This protocol ensures:
- No duplicate work (re-implementing what exists)
- No missed work (skipping what's actually needed)
- Correct understanding of requirements before implementation