# Use Potpie for spec-driven codebase workflows

> Index a repository with Potpie, turn it into a code knowledge graph, and drive focused implementation or review tasks from specs.

- Skill: `agentskillexchange/use-potpie-for-spec-driven-codebase-workflows` (Agent Skill)
- Install (CLI): `npx skillmds@latest add agentskillexchange/use-potpie-for-spec-driven-codebase-workflows`
- Raw SKILL.md: https://api.skillmd.com/api/skills/agentskillexchange/use-potpie-for-spec-driven-codebase-workflows/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: agentskillexchange (https://skillmd.com/u/agentskillexchange)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/agentskillexchange/use-potpie-for-spec-driven-codebase-workflows

---


# Use Potpie for spec-driven codebase workflows

Index a repository with Potpie, turn it into a code knowledge graph, and drive focused implementation or review tasks from specs.

## Prerequisites

Docker; Git; Python 3.11+; uv; configured LLM provider

## Installation

Use the upstream install or setup path that matches your environment:
- git clone --recurse-submodules https://github.com/potpie-ai/potpie.git
- uv sync
- pnpm build && pnpm start

Requirements and caveats from upstream:
- [Docker](https://docker.com) installed and running
- [Python 3.11+](https://python.org) with [uv](https://docs.astral.sh/uv/)
- This will start Docker services, apply migrations, start the FastAPI app, and start the Celery worker.

Basic usage or getting-started notes:
- [Git](https://git-scm.com) installed
- **Clone the repository**
- bash

- Source: https://github.com/potpie-ai/potpie
- Extracted from upstream docs: https://raw.githubusercontent.com/potpie-ai/potpie/HEAD/README.md

## Documentation

- https://docs.potpie.ai

## Source

- [Agent Skill Exchange](https://agentskillexchange.com/skills/use-potpie-for-spec-driven-codebase-workflows/)