gherkin-to-code

Gherkin to Code — Feature Implementation

Đọc Gherkin feature file từ living docs → phân tích technical solution → gen step definitions + implementation code. Skill này là bridge từ WHAT (feature file) sang HOW (code).

Triết lý

Feature file là contract. Code phải thỏa mãn contract đó — không hơn, không kém.

Skill này KHÔNG quyết định stack, framework, hay conventions — đó là việc của CLAUDE.md và existing code trong repo. Skill này chỉ hướng dẫn process: đọc gì → phân tích gì → gen gì → verify gì.

Ngôn ngữ

• Code comments, commit messages: theo convention repo (CLAUDE.md)
• Technical solution summary: tiếng Việt (consistent với PRD và feature file)
• Code: theo ngôn ngữ lập trình của repo

---

Phase 1 — Technical Analysis (bắt buộc, engineer review trước khi code)

Phase này là bước architecture cho feature-level. KHÔNG skip — gen code mà không có technical analysis sẽ dẫn tới refactor.

1.1. Đọc và hiểu feature file

Input: .feature file (hoặc nhiều files nếu feature span nhiều module)

Extract:
├── Feature name + narrative → hiểu context
├── Rules → list business rules cần implement
├── Scenarios per Rule → behaviors cần thỏa mãn
├── Tags → test layer (@api/@web/@integration), priority (@p2/@future)
├── # PRD link → đọc PRD nếu cần thêm context
└── # TODO comments → decisions chưa resolve

1.2. Scan codebase hiện tại

Đọc repo qua git submodule hoặc trực tiếp:

Scan:
├── CLAUDE.md → stack, conventions, patterns
├── Existing step definitions → pattern đang dùng
├── Domain models / entities → data model hiện tại
├── API routes / controllers → endpoints hiện có
├── Database schema → tables, relationships
└── Related features code → follow existing patterns

1.3. Đề xuất Technical Solution

Output dạng summary để engineer review:

## Technical Solution: [Feature Name]

### Tổng quan
[1-2 câu: approach chính để implement feature này]

### Components cần thay đổi

| Component | Thay đổi | Lý do (Rule ID) | Impact |
|-----------|----------|-----------------|--------|
| [service/module] | [new/modify/extend] | [BR-Mxx] | [low/medium/high] |

### Data model changes
| Entity | Thay đổi | Fields | Migration? |
|--------|----------|--------|-----------|
| [entity] | [new table / add columns / modify] | [field list] | [yes/no] |

### API changes
| Endpoint | Method | Thay đổi | Guards (Rules) |
|----------|--------|----------|---------------|
| [path] | [GET/POST/...] | [new/modify] | [BR-Mxx] |

### Quyết định kỹ thuật
- [Decision 1]: [option chọn] — *lý do: [ngắn gọn]*
- [Decision 2]: [option chọn] — *lý do: [ngắn gọn]*

### Breaking changes
- [ ] [Mô tả breaking change nếu có] → *ảnh hưởng: [ai/service nào]*

### Implementation order
1. [Component/step đầu tiên] — *vì: [dependency reason]*
2. [Component/step tiếp theo]
3. ...