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/, forge-logs/ (with versona-track/ placeholder), 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. Optional: append --write-adoption-manifest to emit .forge/versona-adoption-manifest.json (Skills / tasklets / recipes pointers; not a SHA manifest). 6b. Optional — version / release notes hook — After a blueprints/ submodule update, you may reinstall: bash blueprints/sdlc/methodologies/forge/setup/install-version-release-hook.sh. Add .forge/version-release.json from methodologies/forge/setup/templates/version-release.manifest.example.json. Policy: Versioning and release notes (consuming repositories).
  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 status --preset recommended or diff --preset recommended before sync … --force.
  5. Cursor — tasklets (optional) — bash blueprints/sdlc/methodologies/forge/tasklets/install-tasklets.sh adds forge-tasklet-*.mdc. versona-sampling.mdc is already in the recommended preset; install tasklets when you want the cognition operation rules.
  6. Optional Skills — Copy from templates/forge/cursor-skills/ into .cursor/skills/ (matrix: Versona skill and tasklet matrix).
  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). Process-first walkthrough: Verification — process-first Versona install (local / manual primary).
  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; status --preset recommended is clean; CI still green if you gate on it.

What to do next