vibe-fabric

AI-Collaborative Development Coordination Framework

A CLI tool that helps you coordinate software development across multiple repositories using AI assistance. Create a planning hub where you manage requirements, create work scopes, and track implementation progress.

Features

• Planning Hub - Central coordination point for multi-repo projects
• AI-Powered PRD Management - Create and maintain living requirements documents
• Scope Management - Break requirements into actionable work packages
• Repository Sync - Track implementation progress across repositories
• Gap Analysis - Identify what's implemented vs. what's planned
• Claude Code Integration - Slash commands and multi-session AI runner

Quick Start

# Install globally
npm install -g vibe-fabric

# Create a planning hub
vibe init my-project
cd my-project

# Add a repository to coordinate
vibe repo add https://github.com/your-org/your-repo

# Create/manage PRD with AI assistance
vibe prd

# Create scopes from requirements
vibe scope

# Send scopes to dev repos
vibe send SCOPE-001

# Check project status
vibe status

Prerequisites

| Requirement | Purpose | |-------------|---------| | Node.js 18+ | Runtime for CLI | | Claude Code | AI-powered commands | | GitHub Token | Repository operations | | UV (optional) | Python runner for AI scripts |

Install UV (for AI commands)

curl -LsSf https://astral.sh/uv/install.sh | sh

Commands

Core Commands

| Command | Description | |---------|-------------| | vibe init [name] | Initialize a planning hub | | vibe repo add <url> | Add repository to hub | | vibe prd | AI-powered PRD management | | vibe scope | AI-powered scope management | | vibe send [scope-id] | Send scopes to repositories | | vibe sync | Sync progress from repositories | | vibe status | Show project status overview | | vibe coverage | PRD coverage analysis | | vibe gaps | Gap analysis (PRD vs implementation) | | vibe doctor | Health check and diagnostics | | vibe claude commands | Manage Claude Code slash commands |

Examples

# Initialize and set up
vibe init my-project
vibe repo add https://github.com/org/backend
vibe repo add https://github.com/org/frontend

# AI-assisted workflow
vibe prd                      # Create/update requirements
vibe scope                    # Generate work scopes
vibe send SCOPE-001           # Send to dev repo

# Monitor progress
vibe sync                     # Pull progress from repos
vibe status                   # Overview dashboard
vibe coverage                 # Detailed coverage report
vibe gaps                     # Find implementation gaps

Architecture

PLANNING HUB (your-project/)
├── docs/prd/           Product requirements
├── docs/scopes/        Work packages (drafts/completed)
├── docs/sync-cache/    Synced data from repositories
├── .claude/            AI commands and scripts
└── vibe-fabric.toml    Configuration
        │
        │  vibe send              vibe sync
        ▼                              ▲
┌─────────────────┐          ┌─────────────────┐
│   DEV REPO 1    │          │   DEV REPO 2    │
│   (backend)     │          │   (frontend)    │
├─────────────────┤          ├─────────────────┤
│ vibe/           │          │ vibe/           │
│ ├── incoming/   │          │ ├── incoming/   │
│ └── impl-plans/ │          │ └── impl-plans/ │
└─────────────────┘          └─────────────────┘

Documentation

• Installation Guide
• Quick Start Tutorial
• Core Concepts
• Command Reference

Development

# Clone the repository
git clone https://github.com/jneaimi/vibe-fabric.git
cd vibe-fabric

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# Run CLI locally
node dist/cli/index.js --help

Project Structure

vibe-fabric/
├── src/
│   ├── cli/           CLI commands (Clipanion)
│   ├── core/          Core business logic
│   └── types/         TypeScript types
├── tests/             Test suite (Vitest)
├── docs/
│   ├── prd/           Product requirements
│   ├── scopes/        Implementation scopes
│   └── wiki/          User documentation
└── .claude/           Claude Code integration

Contributing

See CONTRIBUTING.md for guidelines.

License

MIT

Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions