jtgsystems/Custom-Modes-Roo-Code

This system is a configuration management tool for Roo Code that standardizes and automates the creation of custom AI agent personas. It provides a structured framework for defining specialized roles, such as Accessibility Experts or CLI Developers, through YAML-based mode definitions. The system includes automated scripts to validate, merge, and inject specialized content into these configurations, along with utilities to convert and deploy these modes for both CLI and VS Code environments.

Introduces a Python script (\convert\_modes.py\) and documentation that allow users to convert CLI-format custom modes into VS Code-compatible YAML and XML rule files. The tool supports listing, searching, and converting modes with smart merge capabilities (updating existing, adding new, preserving others), and includes commands to copy the generated configurations to local or remote VS Code settings directories.

vs-code · high confidence

Added a suite of Python scripts to automate the lifecycle of Roo Code custom modes. \compile\_modes.py\ reads individual YAML definitions from \custom\_modes.d/\, validates them against a strict schema (checking slugs, required fields, and permissions), and merges them into consolidated \.roomodes\ and \custom\_modes.yaml\ files. \generate\_roomodes.py\ provides flexible generation with support for batching, slug filtering, and size limits. \fix\_modes.py\ automatically improves mode quality by expanding short role definitions and resolving placeholder instructions. Additionally, \inject\_debugging\_playbook.py\, \inject\_engineering\_protocols.py\, \inject\_gap\_skills.py\, and \inject\_github\_superpowers.py\ programmatically inject specialized content—such as SOTA 2026 debugging protocols, engineering rules, and external skill sets—into specific persona configurations.

scripts · high confidence

The repository now supports a system of custom AI agent modes, defined in the new \.roomodes\ file (and its variants), which provides specialized personas such as Accessibility Expert, AI Engineer, and CLI Developer with detailed instructions and tooling guidelines. To support this structure, \.gitattributes\ has been added to enforce LF line endings across all text-based configuration and code files, and a comprehensive \.gitignore\ has been introduced to exclude Python build artifacts, IDE settings, and local environment files.

(repo-wide) · high confidence

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

• CAI 67 → 66 (-1.0)
• Rubric changed (rubric-2026.08.19 → rubric-2026.09.15) — scores are not directly comparable.

• Code Health 80 → 88 (+8.0)
• Architecture 100 → 100 (+0.0)
• Maturity 63 → 63 (+0.2)
• Readiness 60 → 55 (-4.6)
• Security 88 → 88 (+0.0)

• Coverage not included — suite not readable by the collector
• Dependency hygiene not measured — no supported dependency manifest was read
• Duplicated block (10 lines × 2) (scripts/inject_gap_skills.py)
• Duplicated block (16 lines × 2) (scripts/compile_modes.py)
• Duplicated block (17 lines × 2) (scripts/compile_modes.py)
• Duplicated block (21 lines × 2) (scripts/fix_modes.py)
• Duplicated block (7 lines × 2) (scripts/batch_roomodes.py)
• Duplicated block (8 lines × 2) (scripts/compile_modes.py)
• Duplicated block (9 lines × 2) (scripts/compile_modes.py)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• Hotspot: scripts/fix_modes.py (scripts/fix_modes.py)
• No exposed public API
• Small-team knowledge concentration
• Test reliability not included
• The 'Per-mode configs' guide is a single-file README that only explains the backup and regeneration workflow, with no link to where to edit individual YAML files or how to regenerate from the combined file. (custom_modes.d/README.md)

• Documentation: no architecture or design documentation (README.md)
• Duplicated block (11–12 lines × 2) (scripts/compile_modes.py)
• Duplicated block (13 lines × 2) (scripts/compile_modes.py)
• Duplicated block (16 lines × 2) (scripts/inject_gap_skills.py)
• Duplicated block (17–20 lines × 3) (scripts/compile_modes.py)
• Duplicated block (18 lines × 2) (scripts/compile_modes.py)
• Duplicated block (20 lines × 3) (scripts/fix_modes.py)
• Duplicated block (32–35 lines × 2) (scripts/compile_modes.py)
• Duplicated block (37–39 lines × 2) (scripts/compile_modes.py)
• Duplicated block (6–7 lines × 3) (scripts/compile_modes.py)
• Duplicated block (8 lines × 2) (scripts/batch_roomodes.py)
• Duplicated block (8 lines × 2) (scripts/inject_gap_skills.py)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)

• 2 commits — 2 feature/other, 0 fixes

• (root) — 1 commit
• .github/FUNDING.yml — 1 commit

• change: Add JTG Systems attribution banner, website link, and tip/sponsorship info
• change: Add sponsorship & tip configuration (JTG Systems)

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

jtgsystems/Custom-Modes-Roo-Code was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.