Handbook
Tasklet taxonomy
**Tasklets** are small, **single-operation** units (typically Cursor `.mdc` rules). A **Versona** supplies **discipline overlay**: phase intensity, scope boundaries, severity, and merge into [`VERSONA
Tasklet taxonomy
Tasklets are small, single-operation units (typically Cursor .mdc rules). A Versona supplies discipline overlay: phase intensity, scope boundaries, severity, and merge into Versona contract output.
1. Execution plane (where work runs)
| Plane | Mechanism | Examples |
|---|---|---|
| Cognition | In-IDE LLM (rules, Skills, chat) | Extract assumptions, triage table |
| Local tool | Approved host scripts | Lint, codegen, format |
| Container / recipe | agents/recipes/*/run.sh + Docker |
Headless browser, batch export |
| Remote API | Script or MCP wrapper | Tickets, analytics, vendor UI |
Cognition tasklets live in .cursor/rules/ after install. Execution-plane steps are not the same process as the LLM: they exchange manifests and artifacts (stdin/JSON → files + logs) that the Versona or human reviews.
2. Operation class (what the step does)
| Class | Typical output |
|---|---|
| Extract | Lists (assumptions, entities, risks) |
| Transform | Spec → test cases, outline → deck spec |
| Verify | Pass/fail, rubric scores, diff commentary |
| Act | Commit, PR, run recipe — usually human-gated |
3. Lifecycle / Forge alignment (filters)
Tag or invoke tasklets by Ore / Ingot / Spark, SDLC A–F, or Spark prefix (discover:, build:, …). Aligns with forge-versona.mdc routing.
4. Artifact binding (optional globs)
Use Cursor globs: so rules attach when relevant paths are open (e.g. docs/product/**/*). See Recommended Cursor `globs` for Product Versonas for Product Versonas.
5. Discipline overlay (required for “neutral” tasklets)
| Layer | Responsibility |
|---|---|
| Tasklet | Mechanical I/O schema; minimal normative text |
| Versona | Chooses tasklets, adds constraints (“Testing: falsifiability”), merges report |
| Optional tag | Catalog metadata: neutral, product-family, engineering-family, governance |
See also
- Forge tasklets — small Cursor operations — install and bundled examples
- Versonas — discipline challenge agents — Versona catalog + Sampling
- Orchestration — new agent / recipe — container recipes
Canonical source
Edit https://github.com/autowww/blueprints/blob/main/sdlc/methodologies/forge/tasklets/TASKLET-TAXONOMY.md first; regenerate with docs/build-handbook.py.