Origin Foundry

Getting Started with Origin Foundry

Set up Claude Code to work on specs locally or on the web.

Using Claude Code (Local)

1. Install Claude Code

npm install -g @anthropic-ai/claude-code

2. Clone the repo

git clone git@github.com:darwin-homes/origin-foundry.git && cd origin-foundry

3. Initialize submodules (backend + frontend codebases)

git submodule update --init --recursive

4. Open Claude Code

claude

Working on a spec

Check out your spec branch:

git checkout spec/your-feature-slug

Run the spec command:

/update-spec your-feature-slug

CC handles the rest — detects the phase, walks you through it step by step.

Works with any CLI that supports Claude Code: Terminal, Cursor, Conductor, etc.

Using Claude Code (Web)

1. Setup

  • Go to claude.ai and open a project
  • Connect the origin-foundry repository
  • Note: submodules (darwin/, client/) need separate access for codebase-grounded phases

2. Working on a spec

  • Tell CC which spec to work on: /update-spec your-feature-slug
  • CC will check out the right branch and detect the phase automatically

Phase Flow

PhaseWhat CC doesOutput
draftInterviews you, writes specspec.md
product-refineReviews requirements and scopeenrichment/product.refined.md
eng-constraintsInvestigates codebase constraintsenrichment/eng.constraints.md
design-flowsDesigns UX flows and statesenrichment/design.flows.md
eng-tech-requirementsWrites technical requirementsenrichment/eng.tech-requirements.md
product-trackingSpecifies Segment tracking eventsenrichment/product.tracking.md
reviewMulti-domain reviewcomments/*.comments.md
final-sign-offMerge readiness gatecomments/*.comments.md