code-generator

Code Generator Skill

Overview

Structured workflow for implementing code from design documents with clear phase separation, cost estimation, and modification tracking.

When to Use

Use this skill when you need to:

• Implement a new module or system from a design document
• Add features to existing codebase
• Refactor or replace existing components
• Generate implementation code with clear execution plan

Core Principles

1. Phase-Based Execution

• Break implementation into logical phases
• Each phase has clear dependencies
• Execute sequentially, phase by phase

2. Operation Type Declaration

• Create: New file that doesn't exist
• Modify: Existing file requiring changes
• Delete: Remove existing file (rare, requires explicit confirmation)

3. Cost Transparency

• Estimate token cost for each operation
• Calculate total cost before execution
• Allow user to adjust scope based on budget

4. Modification Preview

• For modify operations, show before/after diff
• Highlight key changes
• No surprises for user

5. Capability Boundaries

• Can Do: Code generation, file read/write
• Cannot Do: Git operations, database changes, compilation, external API calls

Workflow

Step 1: Analyze Design Document

Read and understand:

• Architecture overview
• File list and dependencies
• Key design decisions
• Interface contracts

Step 2: Create Execution Plan

Use this format:

## 📋 [ProjectName] Implementation Plan

### Execution Capability Statement

| Operation | Capability |
|-----------|------------|
| Code generation | ✅ Can execute |
| Database operations | ❌ Cannot execute (user handles) |
| Git/SVN operations | ❌ Do not execute |
| Compilation | ❌ Do not execute (user triggers) |

### Phase [N]: [Phase Name]

| Order | File | Path | Operation | Content | Time | Token Cost |
|-------|------|------|-----------|---------|------|------------|
| 1 | `FileName.h` | `Path/` | Create/Modify | Brief description | X min | ~X,XXX |

**Phase Subtotal**: ~X,XXX tokens

### Modification Preview

For modify operations only:

`FileName.h`:
```cpp
// Before: [current state or "None"]
// After: [new code to be added]

Phase Dependencies

Phase 1 ──► Phase 2 ──► Phase 3

Total Cost Summary

Phase	Time	Token Cost
1	X min	~X,XXX
2	X min	~X,XXX
Total	X hours	~XX,XXX

User Confirmation Items

1. [Specific question 1]
2. [Specific question 2]
3. Start confirmation: Reply "Approve plan" to begin