Handbook

Setup profile: Forge and Cursor

The middle phase of the Project setup profile: Forge workspace, Cursor rules, optional tasklets and Skills, and validation.

Project setup profile — Forge and Cursor (steps 4–11)

What it is

The middle phase of the Project setup profile: Forge workspace, Cursor rules, optional tasklets and Skills, and validation.

When to use it

After Bootstrap (steps 1–3).

Prerequisites

  • Steps 1–3 complete or equivalent from First hour.

Steps

  1. Forge workspace — ./blueprints/sdlc/methodologies/forge/setup/forge-init.sh
    Creates forge/, ember-logs/, seeds forge/forge.config.yaml.
  2. Configure Forge in YAML — Edit forge/forge.config.yaml; questionnaire: Forge setup questionnaire.
  3. Cursor — install rules — From repo root: bash blueprints/sdlc/methodologies/forge/setup/sync-forge-cursor-rules.sh sync --preset recommended (see Cursor rules — quickstart (Forge + Versonas)). YAML-only / CI: … sync with no --preset. Or copy manually — Forge `forge.config.yaml` ↔ `.cursor/rules/` alignment.
  4. Cursor — optional extras — --preset full or individual --with-* flags add more rules; see alignment doc Reference: granular flags. After git submodule update on blueprints/, run sync-forge-cursor-rules.sh diff --preset recommended (or status) before sync … --force.
  5. Cursor — tasklets + Sampling (optional) — bash blueprints/sdlc/methodologies/forge/tasklets/install-tasklets.sh
  6. Optional Skills — Copy from templates/forge/cursor-skills/ into .cursor/skills/.
  7. Validate alignment — bash blueprints/sdlc/methodologies/forge/setup/sync-forge-cursor-rules.sh check (Python 3 + PyYAML; versona_cursor_rules.py check — same map as YAML-driven install).
  8. Operational start — Forge scripts overview; Forge workspace template for a filled-in consumer layout.

Cursor: Project Setup Versona

How to verify success

  • After steps 4–5: forge/forge.config.yaml exists as in first hour.
  • After steps 6–10: sync-forge-cursor-rules.sh check passes when you use the recommended preset; CI still green if you gate on it.

What to do next