Handbook

Setup & adoption

A guided flow for consuming repos to adopt Forge SDLC. Includes a questionnaire to determine team configuration, a scaffold script to create directories and files, and a Cursor rule for conversational setup.

Adoption steps

  1. Answer the questionnaire — determine team size, roles, product stage, and active disciplines.
  2. Run the scaffold script — creates forge/, ember-logs/, and initial configuration.
  3. Install Cursor rules — bash blueprints/sdlc/methodologies/forge/setup/sync-forge-cursor-rules.sh sync --preset recommended (quick ref: Cursor rules — quickstart (Forge + Versonas)); or copy templates manually per Forge `forge.config.yaml` ↔ `.cursor/rules/` alignment.
  4. Validate — bash blueprints/sdlc/methodologies/forge/setup/sync-forge-cursor-rules.sh check; after blueprint updates, sync-forge-cursor-rules.sh diff --preset recommended then sync … --force if appropriate.
  5. Start working — first refinement, first Charge, first Ember Log entry.

Full checklist (submodule → Cursor alignment): see Project setup checklist. Project Setup Versona (orchestrated gap analysis; trigger setup): copy ../versona/catalog/workflow/versona-project-setup.mdc.template to .cursor/rules/versona-project-setup.mdc. For interactive YAML and team choices, use forge-setup.mdc.template as @forge-setup.

Files

File Purpose
Forge setup questionnaire Questions to determine Forge configuration
Git branching and commit conventions (Forge) Git branching by Forge scale + commit message/body rules (agents & search)
forge-init.sh Scaffold script — creates workspace directories and seed files
forge.config.template.yaml Configuration template
forge-setup.mdc.template Cursor rule for guided setup (questionnaire)
../versona/catalog/workflow/versona-project-setup.mdc.template Cursor rule — Project setup Versona (setup / @versona-project-setup); checklist + commands
../tasklets/install-tasklets.sh Copy example tasklets + Sampling Versona into .cursor/rules/
Cursor rules — quickstart (Forge + Versonas) Short onboarding: sync, status, diff, presets
Forge `forge.config.yaml` ↔ `.cursor/rules/` alignment Map forge.config.yaml versona.* flags → expected versona-*.mdc files
versona_cursor_rules.py Shared map: forge.config.yaml → templates; CLI check | install | diff | status
sync-forge-cursor-rules.sh One entry: sync | diff | status | check
install-versona-cursor-rules.sh Thin wrapper → sync sync
diff-versona-cursor-rules.sh Thin wrapper → sync diff
check-forge-cursor-alignment.sh Thin wrapper → sync check

Quick start

From the consuming repository root:

./blueprints/sdlc/methodologies/forge/setup/forge-init.sh

This creates the minimal Forge workspace. Then configure using the questionnaire or the Cursor rule.