Spec-Driven
The Spec is the single source of truth for what is correct. Issues track progress, PRs record changes, ADRs record why.
SpecIssuePRADR
AI-Native Development Suite
Forge software from idea to delivery.
Foundry turns your coding agent into a disciplined engineering workflow — spec-driven, test-first, UX-aware, and gated at every step.
$ git clone https://github.com/MaoyuanYang/foundry.git
$ cp -r foundry/skills/* ~/.agents/skills/The Lifecycle
One suite. Three phases.
Greenfield, brownfield takeover, and continuous delivery — one continuous workflow.
1
0 → 1coding-start
Greenfield discovery, macro design, DRAFT specs.
2
Takeoverproject-onboard
Baseline, reconstruction, AS-IS documentation.
3
1 → Nfeature-dev
Spec, gates, test design, coding, delivery.
Why Foundry
Built for engineering discipline
Every step is defined, gated, and traceable.
Gated Workflow
SPEC READY → UI READY → TEST DESIGN READY → DONE. No gate, no code.
SPEC READYUI READYTEST DESIGN READYDONE
Test Design First
Define how correctness is proven before writing a single line.
UX Before UI
User goals and flows come before pixels. No starting from button colors.
Evidence over Assumption
Existing code is evidence, not the standard. Existing UI is evidence, not the design system.
OBSERVEDCONFIRMEDINFERRED
Authorization Gates
Write, build, git, and remote actions each require explicit approval.
Language Policy
English-first engineering artifacts; product copy follows product requirements.
Design Change Control
L1 / L2 / L3 impact levels with named decision authority.
Adaptive Grilling
Focused interviews: 2–5 related questions in STANDARD, one decision question per round in DEEP, then a mandatory Challenge Pass.
STANDARDDEEPCHALLENGE PASS
AS-IS before TO-BE
Takeovers reconstruct a verified AS-IS baseline first. Existing code is evidence — never auto-promoted to the standard.
AS-ISTO-BERECONSTRUCTED
Quick Start
Start forging in seconds
New project
"Initialize a greenfield project: a community local-services platform."
Takeover
"Take over this repo and build an AS-IS baseline."
Feature
"Implement feature F001 per the workflow."