Skip to content

README.md

Latest commit

 

History

History
134 lines (102 loc) · 5.19 KB

README.md

File metadata and controls

134 lines (102 loc) · 5.19 KB

VVM Examples

Progressive examples demonstrating VVM language and orchestration features with runnable programs.

Getting Started

Run any example:

/vvm-run examples/01-hello-world.vvm

Compile/validate without running:

/vvm-compile examples/01-hello-world.vvm

State mode examples:

/vvm-run examples/38-rlm-diff-time-machine.vvm --state=filesystem
/vvm-run examples/38-rlm-diff-time-machine.vvm --state=sqlite
/vvm-run examples/38-rlm-diff-time-machine.vvm --state=postgres

Inventory Status

Current runnable examples in this folder: 01-13, 15-39 (14 is intentionally unused).

Core Language and Control Flow

# File Focus
01 hello-world Minimal agent definition and call
02 simple-agent-call Input passing and interpolation
03 semantic-predicate ? semantic predicates
04 match-statement Semantic pattern matching
05 if-elif-else Conditional branching
06 while-loop Bounded iteration with while
07 for-loop Collection iteration and range()
08 with-input Scoped implicit input via it
09 agent-options retry, timeout, backoff, call naming
10 code-council Multi-perspective review council
11 parallel-pmap Parallel map (pmap)
12 functions def and reusable composition
13 skill-imports Skill imports and permissions
15 error-values Error values and graceful fallback
16 try-except-finally Raised-error control flow
17 choose-statement AI-routed branching with choose
18 constrain-require Quality gates with constrain/require
19 refine-loop Iterative optimize/evaluate loop
20 collection-helpers map, filter, reduce, pmap

Workflow and Multi-Agent Patterns

# File Focus
21 devils-advocate Adversarial debate and synthesis
22 full-research-pipeline End-to-end multi-agent PR review pipeline
23 ralph-wiggum-loop Autonomous iterative shipping loop
39 pr-babysitter Continuous autonomous PR maintenance until merge

Persistent Memory Patterns

# File Focus
24 agent-memory-basic Basic persistent memory lifecycle
25 agent-memory-modes continue vs dry_run vs fresh
26 agent-memory-multi-tenant Per-key isolation and tenancy
27 agent-memory-parallel-safe Parallel-safe memory workflow

Artifact and Ref-Oriented State

# File Focus
28 ref-composition Ref passing across calls
29 ref-loop-accumulation Ref accumulation in loops
30 materializer-pattern Controlled ref materialization
31 run-inspector Inspecting run artifacts

Flagship Orchestration

# File Focus
32 ouroboros Meta-programming and self-reference
33 wisdom-of-crowds N-of-M parallel voting (join="any")
34 hydra Resilient racing (join="first")
35 forge Parallel work + sequential memory merge

Workflow Contracts and Composition

# File Focus
36 inputs Module input declarations + export contract
37 debate Callable module composition (* as module)

Recursive Language Model

# File Focus
38 rlm-diff-time-machine Recursive git diff archaeology (default pydantic/pydantic)

Supporting Library Modules

File Purpose
lib/position.vvm Generates a position for a debate stance
lib/critique.vvm Critiques an argument for composition workflows

Contract Semantics (Modules)

For callable modules, VVM derives workflow outputs from export declarations:

  • input ... declares required/optional inputs
  • export name declares contract output keys
  • from "./x.vvm" import * as mod and mod(...) returns an object keyed by exported names

Pattern Map

Examples mapped to common agentic patterns:

Pattern Examples
Augmented LLM 13
Prompt Chaining 22
Routing 04, 17
Parallelization 11, 20, 33, 34
Orchestrator-Workers 10, 21, 35
Evaluator-Optimizer 19
Autonomous Agent 23
Memory-safe Parallelism 27, 35
Recursive Decomposition (RLM) 38
Autonomous PR Operations 39