Rooles

VS Code Extension, Git Submodules, LLM Integration
View Source

Centralised LLM Ruleset Link to heading

Overview Link to heading

Rooles is an open-source project designed to enhance developer productivity by providing a standardised framework for AI-assisted coding using the Roo Code VS Code extension. The project offers a systematic approach to integrating Large Language Models (LLMs) into software development workflows.

“Rooles offers a lightweight, open-source alternative to embedded agentic IDEs that can be customised to meet specific team requirements.”

Technology Stack Link to heading

  • VS Code Extension - Built as an extension for Microsoft Visual Studio Code
  • Large Language Models - Integrates with various LLM providers
  • Git Submodules - Uses submodules for project integration
  • Markdown Documentation - Human and machine-readable documentation format

Key Features Link to heading

  • Extensible Prompts System - Standardised prompts and guidelines for development teams
  • Customisable AI Rules - Flexible AI interaction modes tailored to team needs
  • Enterprise Integration - Compliance with information security protocols
  • Local LLM Support - Enables connections to local LLM providers
  • Consistent Tooling - Maintains standards across development teams
  • Modular Documentation - Structured project documentation templates

Problem Solved Link to heading

The project addresses limitations in existing AI coding tools by providing:

  • Local LLM provider connections for security-conscious organisations
  • Customisable frameworks that adapt to specific team requirements
  • Consistent AI interaction patterns across development projects
  • Enterprise-friendly integration without vendor lock-in

Installation Link to heading

# Add Rooles as a submodule to your project
cd <your-project>
git submodule add https://github.com/dbryar/rooles.git .roo

# Create required directory structure
mkdir -p ./docs ./tasks ./tasks/context ./tasks/requests ./tasks/tickets

Usage Link to heading

Once installed, Rooles provides:

  1. Structured Documentation: Templates for project documentation that work with both human readers and AI systems
  2. Task Management: Organised approach to tracking development tasks and requests
  3. AI Guidelines: Consistent prompts and interaction patterns for LLM-assisted development
  4. Project Context: Maintained context files that help AI understand project structure and requirements

Documentation Philosophy Link to heading

Documentation in Rooles is designed to be readable by both humans and machines, using Markdown to ensure clarity and accessibility across different tools and platforms.

Development Approach Link to heading

Rooles implements a modular approach to:

  • Task and request tracking
  • Project documentation management
  • AI interaction standardisation
  • Team workflow consistency

Lessons Learned Link to heading

This project emerged from the need to bridge the gap between powerful AI coding assistants and the practical requirements of professional development teams, particularly around security, customisation, and consistency.

Future Improvements Link to heading

  • Enhanced VS Code integration features
  • Additional LLM provider support
  • Template library expansion
  • Improved team collaboration features

Contributing Link to heading

The project actively encourages community contributions. Guidelines are available in the project’s CONTRIBUTING.md file, and the codebase is structured to support easy extension and customisation.