Files
sar/.claude/skills/wds-5-agentic-development/data/guides/SESSION-PROTOCOL.md
julian 17c08e6392 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>
2026-05-27 14:34:20 +00:00

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