Technical Specification

A per-feature engineering document that defines what to build, how to approach it, and how to verify it. Covers technical approach, data changes, API changes, frontend changes, dependencies, testing requirements, and rollout strategy.

Syntax

claude-documentation

1. Feature Description
2. Acceptance Criteria (testable statements)
3. Technical Approach
4. Database Changes
5. API Changes (endpoints, request/response schemas)
6. Frontend Changes
7. Dependencies and Blockers
8. Testing Requirements
9. Rollout Strategy
10. Estimated Complexity

Example

claude-documentation

// Technical spec prompt
Write a technical specification for implementing TOTP two-factor authentication.
Stack: React, Node.js/Express, PostgreSQL, JWT auth.
Include:
- Database schema changes
- Backend API endpoints
- Frontend user flow
- Library recommendations
- Security considerations
- Recovery code implementation
- QA checklist