by marv1nnnnn
π rooroo (ε¦ε¦): Minimalist AI Orchestration with Swiss Army Knife Agents π
# Add to your Claude Code skills
git clone https://github.com/marv1nnnnn/roorooVersion: v0.6.3 | Changelog | v0.6.0 Details | v0.5.0 Details
rooroo is a minimalist AI orchestration framework for VS Code, designed to streamline software development using a team of specialized Rooroo agents. It emphasizes a clear, Navigator-led workflow, efficient task management, and robust communication, all while incorporating advanced prompting techniques for enhanced reliability.
Inspired by Buddhist philosophy, "ε¦ε¦" (rΓΊ rΓΊ) or "Thusness" reflects the idea of an underlying, consistent nature. This informs rooroo's minimalist approach, focusing on the essential, specialized role of each agent.
No comments yet. Be the first to share your thoughts!
.rooroo/brainstorming/.rooroo/queue.jsonl for pending tasks..rooroo/tasks/TASK_ID/context.md, prioritizing links over embedded content..rooroo/tasks/TASK_ID/..rooroo/logs/activity.jsonl.ROO# prefixes for easy tracking..roo/rules/ directory for workspace-wide custom instructions to tailor agent behavior, aligning with Roo Code best practices for organization and potential performance improvements.Using rooroo involves these main steps:
.roomodes file.
.roomodes..roomodes (e.g., .roomodes.json)..roo/rules/ directory and add custom instruction files to tailor agent behavior across your workspace.)context.md briefings. These go into the .rooroo/queue.jsonl.context.md and may execute directly or queue the task.context.md and stores outputs in .rooroo/tasks/TASK_ID/.NeedsClarification: Relays question to you.Done/Failed: Logs event, updates queue, informs you. Auto-proceeds with plans if applicable..rooroo/queue.jsonl and .rooroo/logs/activity.jsonl.(Refer to the Workflow Diagram below for a visual representation.)
Each Rooroo agent adheres to core principles like the Principle of Least Assumption and Concise Context File Preparation (linking over embedding).
context.md briefings and can flag ambiguous expert choices for the Navigator to resolve.context.md. Stores outputs in its task folder or modifies project files.context.md. Generates reports in its task folder.context.md. Stores outputs in its task folder..rooroo/brainstorming/.Balance LLM tiers per agent for optimal cost and capability.
rooroo uses a clear, workspace-relative structure under the .rooroo/ directory for all its operations and artifacts.
<Project Root>/
βββ .rooroo/ # Core rooroo operational directory
β βββ queue.jsonl # Pending Tasks (JSON objects, one per line, ROO# IDs, strictly parsable)
β βββ logs/
β β βββ activity.jsonl # Activity Log (JSON objects, one per line, written by Navigator with escaped JSON)
β βββ rules/ # Optional: Workspace-wide custom instruction files (e.g., 01-general.md)
β βββ tasks/ # Directory for all task-specific data
β β βββ ROO#PLAN_20240101120000_initial_project/ # Example Planner Task Directory
β β β βββ context.md # Briefing FOR the Planner (concise, uses links)
β β βββ ROO#SUB_initial_project_S001/ # Example Sub-Task Directory (ROO#SUB_... ID from Planner)
β β β βββ context.md # Task briefing FOR the expert (Created by Planner, concise, uses links)
β β β βββ feature_component.py # Example artifact directly in task folder
β β β βββ data_analysis_report.md # Another example artifact
β β βββ ROO#TASK_20240101130000_fix_login/ # Example Direct Task Directory (ROO#TASK_... ID from Navigator)
β β β βββ context.md # Task briefing FOR the expert (Created by Navigator, concise, uses links)
β β β βββ login_fix.diff # Example artifact directly in task folder
β β βββ ...
β βββ plans/ # Optional: High-level plan overview documents from Rooroo Planner
β β βββ ROO#PLAN_20240101120000_initial_project_plan_overview.md
β βββ brainstorming/ # Optional: Summaries from Rooroo Idea Sparker sessions
β βββ brainstorm_summary_ROO#IDEA_20240101140000.md
β
βββ src/ # Example source code directory (Potentially modified by Rooroo Developer)
βββ ...
Key files driving rooroo operations:
.rooroo/queue.jsonl: Ordered list of tasks (JSON objects per line).
{"taskId": "ROO#SUB_...", "suggested_mode": "rooroo-developer", "context_file_path": ".rooroo/tasks/ROO#SUB_.../context.md", "goal_for_expert": "Build feature X..."}.rooroo/logs/activity.jsonl: Append-only log of key events with severity (INFO, ERROR, etc.).
{"timestamp": "...", "agent_slug": "rooroo-navigator", "severity": "INFO", "task_id": "ROO#...", "event_type": "EXPERT_REPORT", "details": {"status": "Done"}}.rooroo/tasks/TASK_ID/context.md: The comprehensive Markdown briefing for an assigned agent.
.rooroo/tasks/TASK_ID/ (e.g., output.py, analysis_report.md).+----------------------------------------------------------------------+ Phase 0: Optional Brainstorming +----------------------------------------------------------------------+
[User Initiates Brainstorming with π‘ Rooroo Idea Sparker]
+----------------------------------------------------------------------+ Phase 1: User Interaction & Task Triage (Navigator) +------------------------------------------------