Build a Feature

​

Workflow

1

Describe the feature

Enter a description of the feature to build. Potpie asks clarifying questions before generating anything.

2

Clarifying questions

Potpie surfaces a set of clarifying questions as multiple choice options. Answers lock in the scope and requirements before the specification begins.

3

Specification

Potpie parses the codebase against the confirmed requirements and generates a specification covering every file to create or modify, implementation details for each change, and dependency relationships between affected components.

4

Plan

Once the spec is confirmed, Potpie generates a plan.

• Summary
• Architecture
• Plan items

An explanation of what changes, which parts of the codebase are in scope, and how the new code fits the existing system.

A dependency graph showing how new components wire into existing services, data models, and API boundaries as they exist in the repository.

Each task lists the target file, implementation intent, dependency order, and the verification criteria checked after each diff is generated.

5

Code generation

Potpie generates the code and presents every change as a diff. Changes match the existing code style and conventions identified during specification.

6

Pull request

Clicking Create PR pushes the full diff to the repository.

​

Multi-agent mode

• Single agent: Potpie handles the full request from start to finish.
• Multi agent: Potpie’s subagents can do research as well as coding.

​

Using the API

​

Example uses