How do I install the Roo Foundation skill?

Run npx skillmds@latest add ryan-brosas/roo-foundation in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Roo Foundation safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Roo Foundation?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Roo Foundation free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Roo Foundation?

ryan-brosas (@ryan-brosas) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Roo Foundation by ryan-brosas — Agent Skill

Name: Roo Foundation
Author: ryan-brosas

Roo Foundation

Use when building an agent harness's safety layer AND context plane: pure approval classification with timeout auto-answer, budget-window spend caps, tool repetition breakers, model-driven persona routing, promise-gated late config, stack-driven request loops, shadow-git checkpoints, non-destructive condense/truncate history management, dual-log persistence with rewind reconciliation, execution-time tool gating, native tool-call stream parsing with fail-fast validation, fuzzy SEARCH/REPLACE diff application, .rooignore access control, mention-to-context pipelines, multi-instance task history stores, budgeted prompt-cache breakpoint placement, bounded ripgrep search transport, tree-sitter definition-outline extraction over a lazy WASM grammar loader, AND a whole-file-mined workspace→Qdrant code-index RAG pipeline (scanner/parser/watcher/orchestrator, 8-embedder batching kernel, pathSegments filter grammar, in-collection indexing markers, dimension-mismatch recreation).

ryan-brosas 8753a7b 105 files · 408.6 KB Updated Sep 17, 2026

File contents

Roo-Code Foundation

Foundation contract

This is a cold, source-specific foundation, not an operational procedure. It is historical, revision-pinned evidence rather than timeless guidance. Current project source, tests, requirements, and runtime behavior outrank this projection and decide what ships.

Provenance and revision

Source record: roo; portable upstream identity, license, coverage caveats, and retrieval history are preserved in the index.
Recorded revision: main@b867ec9145750d0ae1ff7f02d35406e9bf2a0b16.
Full provenance, coverage caveats, boundaries, and preserved evidence: references/index.md.

Topic map

Representative topics: Safety & approvals; Personas & tools; Loop resilience; Context plane (non-destructive history); State & UI; State & UI (multi-instance history); Native tool-call streaming & protocol; Config plane.
Scope and retrieval questions: references/index.md#use-this-for.
Complete capsule chooser: references/index.md#load-the-matching-source-dump.
Detailed grouped map: references/index.md#capsule-map.
Source limitations and portability boundaries: references/index.md#boundaries.

Retrieval

Open the index, choose one capsule matching the active question, and load only that capsule. Revalidate its cited source and revision before relying on it. Do not bulk-load the inventory, treat historical claims as current truth, or apply this foundation as a procedure.

---name: roo-foundationdescription: Use when building an agent harness's safety layer AND context plane: pure approval classification with timeout auto-answer, budget-window spend caps, tool repetition breakers, model-driven persona routing, promise-gated late config, stack-driven request loops, shadow-git checkpoints, non-destructive condense/truncate history management, dual-log persistence with rewind reconciliation, execution-time tool gating, native tool-call stream parsing with fail-fast validation, fuzzy SEARCH/REPLACE diff application, .rooignore access control, mention-to-context pipelines, multi-instance task history stores, budgeted prompt-cache breakpoint placement, bounded ripgrep search transport, tree-sitter definition-outline extraction over a lazy WASM grammar loader, AND a whole-file-mined workspace→Qdrant code-index RAG pipeline (scanner/parser/watcher/orchestrator, 8-embedder batching kernel, pathSegments filter grammar, in-collection indexing markers, dimension-mismatch recreation).---# Roo-Code Foundation## Foundation contractThis is a cold, source-specific foundation, not an operational procedure. It ishistorical, revision-pinned evidence rather than timeless guidance. Currentproject source, tests, requirements, and runtime behavior outrank thisprojection and decide what ships.## Provenance and revision- Source record: `roo`; portable upstream identity, license, coverage caveats, and retrieval history are preserved in the index.- Recorded revision: `main@b867ec9145750d0ae1ff7f02d35406e9bf2a0b16`.- Full provenance, coverage caveats, boundaries, and preserved evidence: `references/index.md`.## Topic map- Representative topics: Safety & approvals; Personas & tools; Loop resilience; Context plane (non-destructive history); State & UI; State & UI (multi-instance history); Native tool-call streaming & protocol; Config plane.- Scope and retrieval questions: `references/index.md#use-this-for`.- Complete capsule chooser: `references/index.md#load-the-matching-source-dump`.- Detailed grouped map: `references/index.md#capsule-map`.- Source limitations and portability boundaries: `references/index.md#boundaries`.## RetrievalOpen the index, choose one capsule matching the active question, and load onlythat capsule. Revalidate its cited source and revision before relying on it. Donot bulk-load the inventory, treat historical claims as current truth, or applythis foundation as a procedure.

Frequently asked questions