🌟 Vibook

May 13, 2025 Β· View on GitHub

🌟 Vibook β€” The living knowledge base behind Vibe Coding

Version Support License

AI-friendly project documentation for
continuous maintenance through AI assistance (Roo Code)

English | δΈ­ζ–‡


πŸ“– Introduction

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

CapabilityImplementation
πŸ” Understand projectDirectory organization & relationship mapping
🎯 Locate informationMetadata tags & importance markers
πŸ’‘ Comprehend intentContextual marking system
πŸš€ Develop featuresModule implementation details
πŸ› οΈ Troubleshoot issuesClear documentation navigation paths

πŸš€ 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.

Documentation Generation Development with Vibook

πŸ—οΈ 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

CategoryContents
AI IndexSystem overview, navigation guides, documentation standards
ArchitectureSystem structure, tech stack details
ModulesFunctional documentation, implementation details
GuidesSetup instructions, troubleshooting procedures
ConfigurationMode settings, rules, MCP integration

Contribution & License

Issues and suggestions via GitHub Issues

MIT License