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

``bash


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 |

$3

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

Commands

$3

| Command | Description |
|---------|-------------|
| vibe init [name] | Initialize a planning hub |
| vibe repo add | 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 |

$3

`bash


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

`bash


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