Command
| Argument | Required | Description |
|---|---|---|
preview-url | Yes | The Lovable preview URL |
github-url | No | GitHub repo with Lovable source code |
additional-details | No | Extra requirements or context |
How it works
Discovery phase (first run)
- Clones Lovable source (if GitHub URL provided)
- Explores the prototype via browser automation
- Screenshots every route, state, and interaction
- Creates a feature inventory
- Populates initial TODO with gaps
The loop (subsequent runs)
Priority order
When multiple gaps exist, they’re fixed in this order:- TypeScript errors — code must compile
- Mock data — wire real APIs before visual polish
- Missing features — implement all inventory items
- Missing states — empty, loading, error
- Broken interactions — buttons, forms, navigation
- Layout/spacing — structural issues
- Visual refinement — fine-tuning
TODO format
Design system rule
The agent translates UX patterns, not CSS. It uses your app’s design system exclusively (<Button>, .card, var(--ui-*)) rather than copying Lovable’s styles.
Example
- Clones the Lovable repo
- Opens the preview in the browser
- Screenshots every page and interaction
- Creates feature inventory
- Identifies where this fits in your app
- Starts implementing, fixing gaps one by one
- Reports progress after each iteration
Tips
- Provide the GitHub URL if available for better source analysis
- The agent will ask questions if requirements are unclear
- Review
TODO.mdto see what gaps remain