roleplay-sim

What problem does it solve?

Roleplay a multi-agent orchestration simulation using the filament CLI. Accepts either a custom scenario definition (JSON/YAML format) or falls back to the built-in "web app rewrite" scenario. Exercises entities, relations, tasks, messaging, escalations, reservations, export/import. Triggers on: "start rp", "pause rp", "end rp", "roleplay", "simulation", "simulate agents", "run simulation".

Core Features & Use Cases

• Orchestrated roleplay: drive multiple agents through defined cycles to validate workflows and dependencies.
• Scenario flexibility: supports both built-in and custom scenario definitions with validation of seeds, agents, modules, tasks, and relations.
• Narrative orchestration: narrates cycles and actions, while executing real CLI commands against a local Filament project.
• Knowledge graph interactions: leverages entities, relations, plans, docs, and exports to demonstrate graph analytics and reproducibility.

Quick Start

Start a default RP scenario with the filament CLI and watch the narrated cycles unfold in /tmp/fl-sim/.