/gepetto

Section Index Creation

Create <planning_dir>/sections/index.md to define implementation sections.

Input Files

• <planning_dir>/claude-plan.md - implementation plan

Output

<planning_dir>/sections/
└── index.md

SECTION_MANIFEST Block

index.md MUST start with a SECTION_MANIFEST block:

<!-- SECTION_MANIFEST
section-01-foundation
section-02-config
section-03-parser
section-04-api
END_MANIFEST -->

# Implementation Sections Index

... rest of human-readable content ...

SECTION_MANIFEST Rules

• Must be at the TOP of index.md (before any other content)
• One section per line, format: section-NN-name (e.g., section-01-foundation)
• Section numbers must be two digits with leading zero (01, 02, ... 12)
• Section names use lowercase with hyphens (no spaces or underscores)
• Numbers should be sequential (01, 02, 03...)
• This block is parsed to track progress - the rest of index.md is for humans

Human-Readable Content

After the manifest block, include:

Dependency Graph

Table showing what blocks what:

| Section | Depends On | Blocks | Parallelizable |
|---------|------------|--------|----------------|
| section-01-foundation | - | section-02, section-03 | Yes |
| section-02-config | section-01 | section-04 | No |
| section-03-parser | section-01 | section-04 | Yes |
| section-04-api | section-02, section-03 | - | No |

Execution Order

Which sections can run in parallel:

1. section-01-foundation (no dependencies)
2. section-02-config, section-03-parser (parallel after section-01)
3. section-04-api (requires section-02 AND section-03)

Section Summaries

Brief description of each section:

### section-01-foundation
Initial project setup and configuration.

### section-02-config
Configuration loading and validation.

Guidelines

• Natural boundaries: Split by component, layer, feature, or phase
• Focused sections: One logical unit of work each
• Parallelization: Consider which sections can run independently
• Dependency direction: Earlier sections should not depend on later sections

Example index.md

<!-- SECTION_MANIFEST
section-01-foundation
section-02-core-libs
section-03-api-layer
section-04-frontend
section-05-integration
END_MANIFEST -->

# Implementation Sections Index

## Dependency Graph

| Section | Depends On | Blocks | Parallelizable |
|---------|------------|--------|----------------|
| section-01-foundation | - | all | Yes |
| section-02-core-libs | 01 | 03, 04 | No |
| section-03-api-layer | 02 | 05 | Yes |
| section-04-frontend | 02 | 05 | Yes |
| section-05-integration | 03, 04 | - | No |

## Execution Order

1. section-01-foundation (no dependencies)
2. section-02-core-libs (after 01)
3. section-03-api-layer, section-04-frontend (parallel after 02)
4. section-05-integration (final)

## Section Summaries

### section-01-foundation
Directory structure, config files, base setup.

### section-02-core-libs
Shared utilities and core libraries.

### section-03-api-layer
REST API endpoints and middleware.

### section-04-frontend
UI components and pages.

### section-05-integration
End-to-end integration and final wiring.