Forge Platform

Handbook

Cursor Workflow

Open a Cursor workspace containing forge-platform and the product repos as sibling folders. Blueprints is checked out inside forge-platform as forge-platform/blueprints/ (git submodule); run git submodule update --init…

Workspace setup

Open a Cursor workspace containing forge-platform and the product repos as sibling folders. Blueprints is checked out inside forge-platform as forge-platform/blueprints/ (git submodule); run git submodule update --init --recursive in forge-platform when cloning.

workspace/
  forge-platform/
    blueprints/
    forge/
  forge-lenses/
  forge-lcdl/
  forge-fleet/

Composer Fast usage

Use Composer Fast for small, bounded Sparks:

  • schema additions,
  • local docs updates,
  • sample object changes,
  • static UI wiring,
  • single-product prompt creation.

Use a stronger model or manual review for:

  • architecture changes,
  • product boundary changes,
  • security-sensitive adapters,
  • raw execution pathways,
  • approval model changes.

Prompt rule

Every prompt must include:

  • product boundary,
  • objective,
  • files allowed to edit,
  • files forbidden to edit,
  • contract touched,
  • evidence expected,
  • explicit non-goals.