| name | development |
| description | Develop new features, functionality, and enhancements. Use when creating new features, adding functionality, building components, or when user says add, create, build, develop, implement. Includes Duplicate Check, JTBD Analysis, TDD approach, UI pattern reuse, and service restart verification. |
Development Protocol
Pre-Action (MANDATORY before coding)
1. Duplicate Check
## DUPLICATE CHECK
**Target:** [what I'm creating]
**Search:** semantic/grep/file -> [found/not found]
**Decision:** CREATE NEW / EXTEND EXISTING / ASK USER
2. JTBD Analysis (for user-facing features)
## JTBD ANALYSIS
**Job Story:** When [context], user wants [action], to get [result] and [benefit]
**Questions:**
1. What task are they solving? -> [answer]
2. What's blocking them? -> [answer]
3. What change will help? -> [answer]
3. Find Working Example
For UI: find a working pattern in the project first. Copy the pattern, then adapt. Do NOT invent CSS classes without checking they work.
4. Control File Size
Plan logic across multiple files. Refer to standard-file-size-limits-agent.mdc rule.
Plan
## DEVELOPMENT PLAN
**Task:** [what to do]
**Expected Output:** [artifacts]
**Test Cases:** [input -> expected output]
Execute (TDD approach)
Follow the tdd-workflow skill for full TDD process (Red → Green → Refactor):
- Fill test cases table BEFORE code (Phase 0)
- Write failing tests (Phase 1 — RED)
- Write minimal code to pass (Phase 2 — GREEN)
- Refactor (Phase 3)
- Restart affected services and verify
Verify
Common Pitfalls
- UI Components: Find working example in project first. Don't use CSS classes without checking they work.
- Type Consistency: Database types may differ from JSON (bigint -> string). Check actual types.
- Backend Modules: Follow pattern: types -> repository -> service -> routes
- External APIs: List/Enum fields may contain IDs, not text. Need mapping.
- Entry Points: Use high-level orchestrator services, not low-level methods.
Additional Resources
For prompt preparation methodology, see PREPARE-PROMPT.md.
