Handbook

Forge tasklets — small Cursor operations

Tasklets are single-operation Cursor rules (.mdc) with a fixed output shape. A meta-Versona (for example Sampling Versona) can invoke them in sequence and merge results into a report shaped like a §5 pass or other agreed…

They are not a replacement for discipline Versonas (virtual personas for Product Management, BA, Testing, …). Use tasklets as building blocks and teaching aids.

Full taxonomy (execution plane, operation class, discipline overlay): Tasklet taxonomy.

Mental model: layers

Swimlane diagram template

Install: file flow

Swimlane diagram template

Install (project root)

From a repository that already contains the blueprints/ submodule (run at repository root):

bash blueprints/sdlc/methodologies/forge/tasklets/install-tasklets.sh

Options:

Flag Effect
--dry-run Print planned copies only
--force Overwrite existing files in .cursor/rules/
--no-sampling Install only tasklets; skip versona-sampling.mdc

Optional target directory (default: current directory):

bash blueprints/sdlc/methodologies/forge/tasklets/install-tasklets.sh /path/to/repo

What gets installed

Installed file Purpose
.cursor/rules/forge-tasklet-extract-assumptions.mdc Pull explicit/implicit assumptions from text or context
.cursor/rules/forge-tasklet-list-unknowns.mdc List unknowns, missing evidence, unresolved decisions
.cursor/rules/forge-tasklet-quick-triage.mdc Short severity triage table (max five signals)
.cursor/rules/versona-sampling.mdc Demo meta-Versona that runs the three tasklets and merges output

After install, tune globs: in each .mdc for your repo (defaults are empty = manual / @-rule invocation).

Bundled meta-Versona

See versona-sampling.mdc.template — Sampling Versona demonstrates meta-Versona + tasklets with a simple, readable flow. Install copies it to .cursor/rules/versona-sampling.mdc.

Relationship to execution-plane work

Tasklets in this folder are cognition-plane (in-IDE LLM only). Docker / browser / API steps belong in Agents blueprint (automation) recipes; a Versona can reference those as execution tasklets with a manifest — see agents/docs/VERSONA-EXECUTION-TASKLETS.md.

See also