Skip to content

weyj4/api_twins

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 

Repository files navigation

API Twins

A collection of PRDs (Product Requirements Documents) for building shallow clones ("twins") of popular public APIs. Each twin returns correctly-shaped JSON with dummy data — no real business logic, no persistent storage required. The goal is drop-in replacements for integration tests and local development.

What's in here

Each subdirectory targets one public API and contains:

File Purpose
*_spec.md Human-readable API specification / reference
prd.json Machine-readable PRD in Ralph format, ready to be fed to Ralph Wiggum for autonomous implementation

Available API Twins

API Directory Status
Stripe stripe/ PRD ready

How it works

  1. Research the target API's public documentation
  2. Generate a spec ({api}_spec.md) covering endpoints, request/response shapes, auth, pagination, and error formats
  3. Create a PRD (prd.json) from the spec using the /prd skill, broken into incremental user stories
  4. Convert to Ralph format using the /ralph skill so Ralph Wiggum can build it autonomously
  5. Build — point Ralph at the prd.json and let it implement the twin story-by-story

Adding a new API twin

mkdir {api_name}
# Then use Claude Code with /prd and /ralph to generate the spec and prd.json

See CLAUDE.md for detailed instructions on using the skills to generate new twins.

About

PRDs for building shallow clones of popular public APIs, ready for Ralph Wiggum to implement autonomously

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors