\n\n# Vibe Doc\n\n**AI-powered documentation gap analyzer for modern codebases — scan your project, find the holes, generate professional docs from what you already built.**\n\n[](https://github.com/estevanhernandez-stack-ed/Vibe-Doc/tags)\n\n## What it does\n\nVibe coding produces real artifacts fast — working code, architecture decisions, test suites, deployment configs. But corporate documentation requirements don't care about your momentum. You need ADRs, runbooks, threat models, API specs, and deployment procedures. Writing them by hand is bureaucratic overhead. Ignoring them is a shipping risk.\n\nVibe Doc bridges the gap. It analyzes what you've actually built, finds the documentation holes, and generates the docs you need.\n\nIt generates seven core document types against the v1 standard:\n\n- **Architecture Decision Record (ADR)** — why a major architectural choice was made, its context, and trade-offs. Essential for onboarding and future decisions.\n- **Runbook** — step-by-step operational procedures: deployment, incident response, disaster recovery, scaling. Keeps your ops team sane at 3am.\n- **Threat Model** — security analysis of your system. What can go wrong? What are the attack surfaces? What's the risk profile?\n- **API Specification** — OpenAPI 3.0 or equivalent. Every endpoint, schema, auth method, error code. The contract between frontend and backend.\n- **Deployment Procedure** — how code gets from your laptop to production. Environments, prerequisites, rollback strategy, validation steps.\n- **Test Plan** — unit, integration, E2E coverage strategy. What gets tested, what's out of scope, how you validate quality gates.\n- **Data Model** — database schema, relationships, constraints, indexes. The shape of your state.\n\n## How it works\n\nVibe Doc operates in four stages:\n\n1. **Scan** — walk your codebase. Extract artifacts, identify patterns, build a project profile.\n2. **Classify** — a hybrid classifier (rules + LLM) determines your project type and architecture patterns.\n3. **Gap analysis** — cross-reference your artifacts against the 7-doc v1 standard. Generate a prioritized gap report.\n4. **Generate** — create missing docs from your existing code, configs, and conversations.\n\nThe dual-layer design means you get intelligent recommendations in conversations (skills) and deterministic, reproducible outputs from the CLI — CI/CD pipelines use the CLI (no conversational loop), interactive sessions use the skills (agent-interviewed, conversational fill). Both layers share the same classification engine and document templates, so you get consistent results whether you're in a conversation or running automated checks.\n\n### Three-tier priority system\n\nEvery gap gets a priority, so you can ship after Required, improve with Recommended, and polish with Optional:\n\n- **Required** — must exist before shipping. ADRs for major decisions, deployment procedures, API specs if you have an API surface. Typically 2-3 docs.\n- **Recommended** — professional standard. Runbooks, threat models, test plans. Makes your codebase maintainable. Typically 3-4 docs.\n- **Optional** — nice-to-have. Data models for internal use, architectural diagrams, backup procedures. Typically 1-2 docs.\n\n### Classification system\n\nProjects vary wildly, so Vibe Doc uses a hybrid classifier:\n\n- **Rules-based layer** — patterns that are obvious: Dockerfiles, package.json structure, framework detection, cloud config patterns. Fast, deterministic, no hallucination.\n- **LLM fallback** — when patterns are ambiguous or custom, ask Claude. Classifies your project type, architecture style, and risk profile based on artifacts and code structure.\n\nThe result is a project profile that guides both gap analysis and doc generation.\n\n### Skills and commands\n\nFour slash commands drive the conversational layer:\n\n- `/scan` — scan your project for documentation gaps and generate a report.\n- `/generate` — generate missing documentation based on scan results.\n- `/check` — validate documentation completeness for deployment readiness.\n- `/status` — display current Vibe Doc state and recent activity.\n\nThe CLI mirrors the same surface for terminal and CI use:\n\n```bash\nnpx @esthernandez/vibe-doc-cli scan # scan and generate a gap report\nnpx @esthernandez/vibe-doc-cli generate # generate missing docs\nnpx @esthernandez/vibe-doc-cli check # check deployment readiness\nnpx @esthernandez/vibe-doc-cli status # show status\nnpx @esthernandez/vibe-doc-cli templates # view available templates\n```\n\n## Validated on\n\nScanned the 626 hub.\n\n## Install\n\n**Stable (recommended) — as a Claude Code plugin via the marketplace:**\n\n```text\n/plugin marketplace add estevanhernandez-stack-ed/vibe-plugins\n/plugin install vibe-doc@vibe-plugins\n```\n\n**Canary — track this repo's `main`:**\n\n```text\n/plugin install vibe-doc@estevanhernandez-stack-ed/Vibe-Doc\n```\n\n**npm (CLI binary for terminal / CI):**\n\n```bash\nnpm install -g @esthernandez/vibe-doc-cli\nvibe-doc --version\n```\n\nThe npm install gets you the standalone `vibe-doc` binary for any shell — pair it with the marketplace install above if you also want the conversational slash commands.\n\n> **Note on `.plugin` upload:** Cowork's \"Upload plugin\" path is currently unstable for our bundles — we recommend the marketplace install above. We're tracking the issue.\n\n## Works independently or together\n\nVibe Doc runs standalone or alongside other 626 Labs plugins like [`@esthernandez/app-project-readiness`](https://www.npmjs.com/package/@esthernandez/app-project-readiness) — when both are installed, they share a **unified builder profile** at `~/.claude/profiles/builder.json` so you only onboard once across every 626 Labs plugin.\n\nVibe Doc respects the [Self-Evolving Plugin Framework](docs/self-evolving-plugins-framework.md) — it reads the shared profile to calibrate tone and depth, writes only to its own `plugins.vibe-doc` namespace, and never stomps other plugins' data. See the framework doc for the full thesis, 12-pattern catalog, and applied playbook.\n\n## Contributing\n\nFound a bug? Missing a document type? Want to improve the classifier? Open an issue or PR at [the Vibe Doc repository](https://github.com/estevanhernandez-stack-ed/Vibe-Doc).\n\n## Part of the Vibe ecosystem\n\nPart of the **[Vibe Plugins](https://github.com/estevanhernandez-stack-ed/vibe-plugins)** marketplace from [626 Labs](https://626labs.dev) — foundations and process pillars for AI-assisted creation.\n\n```text\n/plugin marketplace add estevanhernandez-stack-ed/vibe-plugins\n```\n\n## License\n\nMIT — *Imagine Something Else.*",
"bytes": 6923,
"sha": "0179cf1c593fcc461b19702ad40973b05242453725f4ac0ca5978d9beb4766f0",
"repo_slug": "estevanhernandez-stack-ed/vibe-doc",
"fonte": "repo",
"truncated": false,
"api": "https://agentalog.com/api/listings/plg_estevanhernandez_stack_ed_vibe_doc_vibe__1aa5b660/readme"
}
![\"vibe-doc](\"assets/brand/icon.svg\"){kind=icon}
![\"Vibe](\"https://626labs.dev/assets/brand/plugins/vibe-doc-banner-1500x500.png\")
\n