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
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 Versona-style report.
They are not a replacement for discipline Versonas (Product Management, BA, Testing, …). Use them as building blocks and teaching aids.
Full taxonomy (execution plane, operation class, discipline overlay): Tasklet taxonomy.
Mental model: layers
Install: file flow
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
- Versonas — discipline challenge agents — Versona catalog
- Versona contract — output shape for full discipline Versonas
- Setup & adoption — Forge adoption and
forge-init.sh
Canonical source
Edit https://github.com/autowww/blueprints/blob/main/sdlc/methodologies/forge/tasklets/README.md first; regenerate with docs/build-handbook.py.