implement-story

name	implement-story
description	Implement a backlog story following the layer order (Domain, Database, API, Frontend, E2E) with TDD.
disable-model-invocation	true

Steps

1. Check branch — verify you are NOT on main. If on main, create and switch to a feature branch (e.g., feat/e2-us01-jwt-token-security) before proceeding. Never commit directly to main.
2. Read the story — read the story file from docs/backlog/
3. Understand the acceptance criteria — every checkbox must be satisfied
4. Follow layer order — Domain → Database → API → Frontend → Mobile → E2E
5. TDD for each layer:
   • Write failing test
   • Write minimum implementation
   • Verify test passes
   • Refactor if needed
6. Add E2E tests — use /add-e2e-tests skill. Must include both API tests (@api tag) and UI browser tests (@ui tag)
7. Verify everything passes:

   pnpm lint
   pnpm test
   pnpm test:e2e
   pnpm test:e2e:mobile  # if mobile layer is affected
   

8. Update story status — mark checkboxes and set status to "Done"
9. Update epic README — set the story's status column to "Done" in the epic README table
10. Update USER_FEATURES.md — add new features for affected user types

Example: Implementing a Note use case

# 1. Write domain test
packages/domain/src/use-cases/__tests__/CreateNote.test.ts

# 2. Write domain implementation
packages/domain/src/use-cases/CreateNote.ts

# 3. Write database test
packages/database/src/adapters/__tests__/DrizzleNoteRepository.test.ts

# 4. Write database adapter
packages/database/src/adapters/DrizzleNoteRepository.ts

# 5. Wire up API controller
packages/api/src/controllers/notes.controller.ts

# 6. Build frontend feature
packages/frontend/src/features/notes/

# 7. Build mobile feature (if applicable)
packages/mobile/src/features/notes/

# 8. Add E2E tests (Playwright for web, Maestro for mobile)
e2e/tests/notes/crud.spec.ts
packages/mobile/maestro/flows/notes/

Definition of Done

• All acceptance criteria checked
• Unit tests pass (pnpm test)
• Lint passes (pnpm lint)
• E2E API tests pass (@api tagged tests)
• E2E UI tests pass (@ui tagged tests)
• Story status updated to "Done"
• Epic README status column updated to "Done"
• USER_FEATURES.md updated