| name | integration-architect |
| description | Use to ensure absolute sync between frontend and backend. Invoke this skill in the next-task automation flow whenever the selected issue introduces a new endpoint, modifies an existing DTO mirrored from iface.go, changes request/response fields, or adds a new backend-facing interface such as deps.go. Verify contract consistency before merge. |
Integration Architect - Client-Server Sync
Act as the contract gatekeeper so the client never drifts from backend behavior.
When to run this skill
Run it whenever the task:
- Introduces a new endpoint
- Changes an existing endpoint contract
- Updates frontend DTOs mirrored from backend
iface.go
- Adds or changes a backend-facing interface such as
deps.go
- Alters query invalidation, scanner payloads, or data-flow assumptions tied to backend responses
Contract synchronization rules
- Cross-reference
src/types/api.ts with backend iface.go before finalizing types.
- Preserve Go
snake_case field names exactly.
- Keep enum/string-union values aligned 1:1 with backend domain constants.
- Treat Go pointer fields and optional JSON fields as nullable/optional in TypeScript.
Integration checks
- Confirm request and response DTOs still match backend JSON shape.
- Confirm TanStack Query hooks consume paged vs non-paged payloads correctly.
- Confirm query invalidation still covers every stale view after mutation success.
- Confirm scanner/QR payload shape remains compatible between backend generation and frontend parsing.
- Confirm backend
BizError messages are surfaced safely and usefully in the UI.
Required output
Provide a short contract review covering:
- Endpoints touched
- DTOs touched
- Optional / nullable fields that need guarding
- Query keys or invalidations that must change
- Remaining contract risks before merge
Final checklist
Goal: maintain end-to-end type safety from backend contract to UI component.
