Versona-owned execution tasklets (Docker / browser / API)
Cognition tasklets (Cursor rules) live under Forge tasklets/. Execution tasklets are recipes or wrappers that run outside the IDE LLM and return artifacts (files, logs, exit codes) for a Versona or human to review.
Pattern
- Versona or meta-agent defines inputs, success criteria, and expected artifacts (e.g.
export.pdf,screenshots/,run.log). - Recipe under
agents/recipes/<name>/implements the run (seeORCHESTRATION.md). - Cursor / CI invokes the recipe; the LLM does not replace the container — it interprets outputs.
flowchart TB
subgraph cognition [Cognition_plane]
Versona[Versona_or_meta]
CTasklets[Cursor_tasklets]
end
subgraph execution [Execution_plane]
Recipe[agents_recipes_run_sh]
Docker[Docker_job]
end
Versona --> CTasklets
Versona -->|"manifest_JSON"| Recipe
Recipe --> Docker
Docker -->|"artifacts_logs"| Versona
Example manifest (conceptual)
Project-specific JSON or env file passed to the recipe (not frozen in blueprints):
{
"recipe": "notebooklm-export",
"inputs": { "source_dir": "docs/product/vision", "template": "exec-brief" },
"outputs_expected": ["artifacts/deck-spec.json", "artifacts/run.log"],
"secrets": "env:NOTEBOOKLM_SESSION"
}
Security
- No secrets in blueprint Markdown. Use CI secrets and gitignored
.envpatterns perPOLICY.md. - Network and browser recipes are high risk — restrict images, cap runtime, log URLs.
Related
STRUCTURE.md— L5 recipes, L6 optional runnersdlc/methodologies/forge/tasklets/TASKLET-TAXONOMY.md— execution plane row