gepetto

Orchestrate feature planning from research to implementation sections across multiple artifacts.

1|1|Updated Apr 19, 2026
One-click install
npx skills add https://github.com/RamonsDka/the-architect-overlay --skill gepetto-ramonsdka
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gepetto
Source: https://github.com/RamonsDka/the-architect-overlay/tree/main/skills/gepetto
Command: npx skills add https://github.com/RamonsDka/the-architect-overlay --skill gepetto-ramonsdka

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Gepetto orchestrates a multi-step planning process to transform vague feature ideas into concrete, battle-tested implementation plans through structured research, stakeholder interviews, and multi-LLM review.

Core Features & Use Cases

  • Orchestrates Research → Interview → Spec Synthesis → Plan → External Review → Sections to create a comprehensive implementation roadmap.
  • Produces self-contained planning artifacts (claude-research.md, claude-interview.md, claude-spec.md, claude-plan.md, reviews/, sections/) ready for execution.
  • Enables parallelization of section work via a manifest-driven index to accelerate delivery.

Quick Start

Provide a project markdown spec and run /gepetto @path/to/your-spec.md to generate a complete planning workflow.

Frequently Asked Questions about gepetto

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn a rough feature idea into a detailed implementation plan?▼

To turn a rough feature idea into a detailed implementation plan, you provide a project markdown spec and run an orchestrated workflow that generates research, interview, spec, and planning artifacts. This process transforms fuzzy concepts into concrete, parallelizable implementation sections.

What is the best way to plan complex software features from vague requirements?▼

The best way to plan complex software features from vague requirements is using a multi-step workflow that orchestrates research, stakeholder interviews, and spec synthesis. This approach produces battle-tested planning artifacts with external reviews to ensure implementation readiness.

How do I generate parallelizable implementation sections for my engineering team?▼

You generate parallelizable implementation sections by running an end-to-end planning workflow that outputs a manifest-driven index. This organizes the generated spec and plan into self-contained section artifacts that engineers can implement directly and concurrently.

Can I use a multi-LLM review process for software architecture planning?▼

Yes, you can incorporate a multi-LLM review process for software architecture planning by orchestrating external reviews within the workflow. This evaluates your synthesized specs and plans to produce battle-tested implementation roadmaps before development begins.

What planning artifacts do I need for end-to-end feature development?▼

For end-to-end feature development, you need self-contained planning artifacts including research, interview, spec, and plan markdown files, plus directories for external reviews and implementation sections. These artifacts guide teams from initial concepts to direct execution.

Does feature planning work without writing a project spec first?▼

Feature planning requires a project markdown spec as input to initiate the workflow. Providing this initial document allows the orchestration process to accurately guide research, interviews, and synthesis into concrete implementation sections.