forge
Clone forge-starter
Start from a Goalnot from a file
Design firstthe screen before the code
Prove itbuild · test · lint · health

Your first feature

Goal“a projects page”Spec · Plangenerate-feature-planDesignthe screen, firstImplementunder app/Validatebuild · test · lintVerifydev server up · inspect health · you look at itall greennext Goal — or “not yet”: back to Implementa failure → explain-failure → fixResources left behind:Plan · Build · TestRun · CheckRun · DevServer · InspectionEvents: PlanCreated · BuildSucceeded/Failed · TestRunSucceeded · CheckRunSucceeded · DevServerStarted · InspectionCreated
The loop the add-a-feature skill runs, and the same loop by hand. Validate is where a failure turns into an Analysis instead of a log to read.

Ask your agent add-a-feature

you
Add a projects page that lists the projects in the database, newest first.
claude
spec design implement forge → build · test · lint forge → dev · inspect health
Done — /projects is up, 2 tests added, health ok. Want it on the home nav?

From the terminal

$ ./forge plan --app hello --goal "projects page, newest first" → Plan
 edit app/ your editor, your agent
$ ./forge build --app hello && ./forge test --app hello && ./forge lint --app hello
$ ./forge dev --app hello && ./forge inspect health --app hello