implement-step

What it does

Takes a step number and implementation details, writes the code, validates the build, creates a git commit, and records provenance. This is the tool the AI calls most frequently — once per feature or change.

Input

Parameter	Type	Required	Description
projectPath	string	No	Path to the project directory
stepNumber	number	Yes	Which step from the plan to implement
files	object	Yes	Map of file paths to file contents
description	string	No	Human-readable description of the change

What it does internally

1. Reads the current project state and plan
2. Writes the provided files to disk
3. Runs the build to validate (via npm run build)
4. If the build succeeds, creates a git commit
5. Updates the plan state to mark the step as complete
6. Records provenance (which prompt/step created which files)

Notes

• If the build fails, the tool returns the build errors (parsed by debug-build logic) and does not commit.
• The AI is expected to fix build errors and retry.
• Each successful step is a git commit, so undo-last-change can revert it cleanly.