Forge Platform

Handbook

Forge Platform Cursor Kit (in-repo workflow)

This mirrors the downloadable Forge Platform Cursor Kit bundle: bootstrap script, Composer scripts under .cursor/composer/, and the recommended operator order.

Quick use

  1. Repo root already contains bootstrap_forge_platform_foundation.py.
  2. In Cursor Composer Fast, open .cursor/composer/00-run-bootstrap-foundation.md and follow it, or run directly:
python3 bootstrap_forge_platform_foundation.py
python3 scripts/check_foundation.py
git status --short
  1. Overwrite generated files only when intentional:
python3 bootstrap_forge_platform_foundation.py --force
python3 scripts/check_foundation.py

Use these prompts in order (.cursor/composer/):

  1. 00 — Bootstrap foundation
  2. 02 — Platform assay (prompts/shared/platform-review-assay.md rubric); record results under sprints/M0-platform-charter/evidence/
  3. 03 — Sprint 0 charge (sprints/M0-platform-charter/charge.md)
  4. 05 — Harden schemas (descriptions, enums, samples alignment; re-run check_foundation.py)

Run 04 only when you are ready to touch sibling product repos:

python3 scripts/sync_product_repo_stubs.py

It creates thin docs/forge/product-boundary.md under ../forge-lenses, ../forge-lcdl, ../forge-fleet when missing. It is conservative and skips existing files unless you pass --force.

Handbook and consumers

Markdown here is consumed by forge-platform-website (forge-platform submodule + generator/build-site.py). After substantive doc changes, bump the submodule in that repo, rebuild website/, and deploy per its README.