What is Roo Code Vibook

Roo-code-vibook is an AI-friendly project documentation system designed to create a living knowledge base for Vibe Coding in Roo Code, enabling efficient maintenance of coding projects through AI assistance.

Use cases

Use cases include maintaining legacy codebases, enhancing documentation for new features, assisting developers in troubleshooting issues, and providing AI-driven insights for project management.

How to use

To use roo-code-vibook, install Roo Code with the required AI models, switch to architect mode, select your preferred language prompt, and configure the documentation system by answering setup questions.

Key features

Key features include understanding project structure, locating information through metadata tags, comprehending intent with a contextual marking system, developing features with detailed module documentation, and troubleshooting with clear navigation paths.

Where to use

Roo-code-vibook can be used in software development, particularly in projects that require continuous maintenance and support through AI coding assistants.

📖 Introduction

Vibook creates an “AI-understandable” knowledge network that helps AI coding assistants (Roo Code) efficiently maintain existing projects.

🚀 Quick Start

1. Prepare: Install Roo Code with Claude 3.7 Sonnet or Gemini 2.5 Pro
2. Start:
   • For small to medium projects: Switch to architect mode in Roo Code
   • For large projects: Switch to orchestrator mode in Roo Code
3. Input: Choose English or Chinese prompt
4. Configure: Answer questions to set up documentation system
5. Adjust (if needed): Run prompt again to reconfigure

Note: Automatic documentation generation will create all necessary files and configurations based on your responses.

👀 Showcase

Here are practical applications of Vibook, demonstrating its capabilities for automatic documentation generation and development assistance.

Revas Project Example

Revas is a high-performance UI library that uses React + CSS on the Canvas 2D API. It hasn’t been updated for four years and still uses outdated dependencies: rollup 1.x, react-script, typescript v4, and only supports React 17.

The videos below demonstrate how to use Vibook to automatically generate a documentation knowledge base for this legacy repository and perform dependency upgrades and modernization through vibe coding.

🏗️ System Architecture

graph TD
    classDef project stroke:#333,stroke-width:1px
    classDef docSystem stroke:#333,stroke-width:1px
    classDef aiAssist stroke:#333,stroke-width:1px
    classDef component stroke:#333,stroke-width:1px

    A((Project)):::project --> B{Doc System}:::docSystem

    subgraph Documentation Subsystem
        B --> C1[AI Index]:::component
        B --> C2[Architecture]:::component
        B --> C3[Module Docs]:::component
        B --> C4[Dev Guides]:::component
    end

    D[[AI Assistant]]:::aiAssist --> B

🔄 Mode Collaboration System

flowchart LR
    classDef user stroke:#333,stroke-width:1px
    classDef arch stroke:#333,stroke-width:2px,shape:hexagon
    classDef code stroke:#333,stroke-width:2px,shape:rect
    classDef test stroke:#333,stroke-width:2px,shape:diamond
    classDef summ stroke:#333,stroke-width:2px,shape:cylinder

    User((User)):::user -->|Requirements| Arch[Architect]:::arch
    Arch -->|Design| Code[Code]:::code
    Code -->|Complete| Test{Test}:::test
    Test -->|Issues| Code
    Test -->|Pass| Summary[(Summary)]:::summ
    Summary -->|Update| DocSystem[Docs]

Mode Switching

Roo automatically suggests switching at appropriate times. If needed, manually direct:

"Please switch to Code mode to implement this feature"
"Now switch to Test mode to test our implementation"
"Please use Summary mode to document this work"

Avoid UI mode switching as it may lose context. Include brief explanations when switching.

📋 Generated Documentation