forge
Clone forge-starter
plane: controlresource: Planrendered from forge v1.56.0 platform-model.json

generate-feature-plan

A model-backed Plan for a Goal, persisted as a resource.

GenerateFeaturePlanPOST /capabilities/generate-feature-plan
Planthe Resource it produces
1 eventPlanCreated

Ask your agent forge → generate-feature-plan

you
Plan a projects page for hello.
claude
forge → generate-feature-plan Done — Plan created; I recorded PlanCreated.

From the terminal

$ forge plan --app hello --goal "a projects page"

HTTP :3717

POST /capabilities/generate-feature-plan
Content-Type: application/json
x-forge-actor-type: builder
x-forge-actor-id: cli

{
  "app": "hello",
  "goal": "a projects page, newest first"
}

Input fields 2

app
goal

Events ForgeEvent

PlanCreated   resource_type: Plan

Resource GET /resources/Plan/:id

{
  "type": "Plan",
  "id": "res_01J…",
  "app_id": "app_hello",
  "status": "succeeded",
  "created_at": "2026-09-03T14:00:00Z"
}

Errors: see Reference → Errors. Find it in the playground