Wiki
VibeFlow documentation — 25 pages across 4 categories.
Explanation
Agent Orchestration Policy
Defines the orchestration policy for the main AI agent — confidence thresholds, debate rules, anti-hallucination, and verification.
Architecture
High-level architecture of VibeFlow — AI-first Home, conversation runtime, owned async dispatch, and typed capability fabric.
Crystallize Update Proposal
How vf skills crystallize detects patterns matching an existing skill and prints a patch proposal instead of a draft.
Security Model
Security model — default safety posture, permission classes, protected paths, secrets handling, and audit log.
Skill Discovery and Evolution
How VibeFlow discovers external skills and evolves internal skills from real project execution — discovery order, changelog, and promotion lifecycle.
Skill Providers
Provider-based skill discovery layer — Context7, Vercel find-skills, npm packages, trust model, and resolution flow.
Skill Security Scan
Optional static security scan gate that runs before a local skill is promoted to verified via vf skills verify.
Skills System
The Anthropic-style skill system — standard format, metadata, categories, registry priority, and usage rules.
Tool Adapters
How tool adapters translate canonical context into engine-specific files for supported coding CLIs.
Web UI Design
Design specification for the web UI — AI-first Home surfaces, UX principles, approval flow, and real-time updates.
Work-Unit Orchestration
How VibeFlow decomposes tasks into scoped, file-backed work units with quality gates, lifecycle tracking, and sub-agent guardrails.
How-to
Deployment
How to deploy VibeFlow to git and npm — versioning, tarball verification, and publishing steps.
Hooks and Guardrails
How to configure and use hooks for safety guardrails — universal hook design, per-engine enforcement, false positive reduction, and automation.
Self-Hosted Runner
How to set up and manage a self-hosted GitHub Actions runner on macOS for VibeFlow CI.
Workflow
End-to-end workflow — intake questions, context normalization, conversation runtime, and output report for VibeFlow task coordination.
Reference
Bun and TypeScript Coding Conventions
Enforced source, protocol, runtime, testing, and portability conventions for VibeFlow contributors and coding agents.
Command Reference
Complete reference of all shipped `vf` CLI commands and their flags, including conversations, orchestration, skills, hooks, and verification.
Coordination Template
Copy-pasteable template for coordinating sub-agents via CoordinationBrief and CoordinationResult.
Coverage
Reference for VibeFlow CLI flags, coverage enforcement rules, anti-patterns suite, and bun:coverage quirks.
Documentation
VibeFlow documentation index, organized by the Diátaxis framework.
Engine CLI Compatibility
Which engine CLI versions the current code was verified against, and the invocation/output contract each integration assumes.
Generated Files
Reference of all files the orchestrator may generate in a target repository — root files, engine-specific files, hooks, and dispatch artifacts.
Master Spec
Master specification — one-sentence summary, design principles, engine support, skill system, hook system, and security posture.
npm CLI Design
Reference for the npm CLI design — startup flow, commands, package layout, dependency policy, and local server rules.