<p align="center"> <strong>English</strong> | <a href="docs/i18n/README.zh-CN.md">简体中文</a> | <a href="docs/i18n/README.ja-JP.md">日本語</a> | <a href="docs/i18n/README.ko-KR.md">한국어</a> | <a href="docs/i18n/README.vi-VN.md">Tiếng Việt</a> | <a href="docs/i18n/README.pt-BR.md">Português</a> | <a href="docs/i18n/README.es.md">Español</a> | <a href="docs/i18n/README.de.md">Deutsch</a> | <a href="docs/i18n/README.fr.md">Français</a> | <a href="docs/i18n/README.hi.md">हिंदी</a> </p> <div align="center"> <a href="https://flowser.ai"> <img src="assets/flowser-logo.svg" alt="Flowser" width="120"> </a>

Built by world-class engineers, for vibecoders at<br> flowser.ai — AI Agents with computers for GTM

<br>

vibecode-pro-max-kit

<br> <p align="center"> <img src="https://media.tenor.com/q_5em_iLaxoAAAAC/tanjiro-i-water-style.gif" alt="Flow like water" width="480"> <br><br> <em>"Total Concentration — Spec Breathing, Tenth Form: the Vibe Flow never breaks."</em><br> <strong>— Tanjiro Kamado</strong> </p>

Drop this into any project. Your AI agent gets a complete plan-first dev process — 7 gated phases, self-healing check loops, and autopilot that runs start to finish without losing its place.

<table align="center"> <tr> <td width="50%" valign="top"><strong>📦 One-command install</strong><br>One <code>curl</code> line drops it into any project. It detects new vs. returning users and never overwrites your files.</td> <td width="50%" valign="top"><strong>🌐 Works everywhere</strong><br>Any tech stack, any language, and any AI coding agent — Claude Code, Codex, Cursor, Windsurf, Copilot, and more.</td> </tr> <tr> <td valign="top"><strong>🧭 RIPER-5 plan-first workflow</strong><br>7 gated phases (Research → Spec → Innovate → Plan → Validate → Execute → Update-Process) stop the agent from jumping straight to code.</td> <td valign="top"><strong>🚀 Autopilot mode (quick / fast / full)</strong><br>Start a hands-free run at any phase with a single phrase. Three lanes match the ceremony to the risk.</td> </tr> <tr> <td valign="top"><strong>🎯 <code>/goal</code> — the run-until-done token</strong><br>One copy-pasteable block keeps the agent running phase after phase without stopping — and resumes the run in a fresh session.</td> <td valign="top"><strong>🔁 PVL + EVL self-healing loops</strong><br>Plan-check-fix and test-check-fix loops find gaps, fix them, and re-check on their own — up to 10 cycles each.</td> </tr> <tr> <td valign="top"><strong>🔍 vc-autoresearch</strong><br>A reusable find-gaps → fix → repeat loop you can point at plans, tests, specs, docs, or evals.</td> <td valign="top"><strong>🧪 Feasibility probes</strong><br>Test-before-you-build verdicts (VIABLE / NOT-VIABLE) before the agent commits to any design approach.</td> </tr> <tr> <td valign="top"><strong>🎛️ Smart strategy picker</strong><br>Before each phase it weighs one agent vs. many vs. a coordinated team — with cost estimates — and picks the cheapest that fits.</td> <td valign="top"><strong>🧮 Smart model use</strong><br>The expensive model only writes code; the cheaper model does everything else. Lower cost, same quality.</td> </tr> <tr> <td valign="top"><strong>🤔 Intent clarification</strong><br>When a request is vague, the agent asks a few sharp questions up front instead of guessing and building the wrong thing.</td> <td valign="top"><strong>🛡️ 36 validators</strong><br>Mechanical correctness checks — not opinions — guard the kit's own structure and catch drift before it ships.</td> </tr> <tr> <td valign="top"><strong>🏗️ Phase programs</strong><br>Large projects are split into independent phases with quality gates between them, so big work doesn't fall apart.</td> <td valign="top"><strong>🔀 Programs that reshape themselves</strong><br>As it learns, the agent inserts new phases, reorders work, and skips blocked steps — the plan adapts on the fly.</td> </tr> <tr> <td valign="top"><strong>🧠 Never loses its place</strong><br>Progress notes are written to disk every phase, so a run survives a memory reset and picks up exactly where it left off.</td> <td valign="top"><strong>📚 Self-improving project memory</strong><br>It learns your codebase on setup and keeps its own shared notes current after every feature ships, so docs never go stale.</td> </tr> <tr> <td valign="top"><strong>⚡ Quick Fix + Fast Mode</strong><br>Light lanes for small changes skip the heavy ceremony, so a one-line fix stays a one-line fix.</td> <td valign="top"><strong>🧱 Layered, auto-discovered skills</strong><br>Skills are organized in clear layers and discovered automatically — the agent always finds the right tool for the step.</td> </tr> <tr> <td valign="top"><strong>🤖 15 agents · 33 skills · 10 hooks</strong><br>A full team of specialized agents, reusable skills, and safety hooks, all wired together out of the box.</td> <td valign="top"><strong>🔄 Full kit lifecycle</strong><br>Install, setup, update, and publish are all one command each — keeping every project on the latest kit safely.</td> </tr> <tr> <td valign="top"><strong>📝 SPEC — your plain-language sign-off</strong><br>Before any design, you state what to build in simple user stories — the cheapest place to catch a misunderstanding.</td> <td valign="top"><strong>🎯 Always checks your intent</strong><br>Every later phase measures back against your SPEC: is what we're building actually what you asked for?</td> </tr> </table> <p> <a href="https://github.com/withkynam/vibecode-pro-max-kit/stargazers"><img src="https://img.shields.io/github/stars/withkynam/vibecode-pro-max-kit" alt="Stars"></a> <a href="https://github.com/withkynam/vibecode-pro-max-kit/network/members"><img src="https://img.shields.io/github/forks/withkynam/vibecode-pro-max-kit" alt="Forks"></a> <a href="LICENSE"><img src="https://img.shields.io/github/license/withkynam/vibecode-pro-max-kit" alt="License"></a> <a href="https://github.com/withkynam/vibecode-pro-max-kit/graphs/contributors"><img src="https://img.shields.io/github/contributors/withkynam/vibecode-pro-max-kit" alt="Contributors"></a> <a href="https://github.com/withkynam/vibecode-pro-max-kit/actions/workflows/validate.yml"><img src="https://img.shields.io/github/actions/workflow/status/withkynam/vibecode-pro-max-kit/validate.yml" alt="CI"></a> <a href="CHANGELOG.md"><img src="https://img.shields.io/badge/version-3.2.5-2EA043" alt="Version"></a> <img src="https://img.shields.io/badge/agents-15-orange" alt="Agents"> <img src="https://img.shields.io/badge/skills-33-purple" alt="Skills"> <img src="https://img.shields.io/badge/hooks-10-blue" alt="Hooks"> <img src="https://img.shields.io/badge/tools-7_%E2%9C%93-38BDF8" alt="7 Tools"> </p> <p> <strong>The simplest, most flexible, team-friendly coding kit for</strong><br><br> <a href="https://github.com/anthropics/claude-code"><img src="https://img.shields.io/badge/Claude_Code-191919?style=for-the-badge&logo=anthropic&logoColor=white" alt="Claude Code"></a>&nbsp; <a href="https://github.com/openai/codex"><img src="https://img.shields.io/badge/Codex_CLI-412991?style=for-the-badge&logo=openai&logoColor=white" alt="Codex CLI"></a>&nbsp; <a href="https://cursor.com"><img src="https://img.shields.io/badge/Cursor-000?style=for-the-badge&logo=cursor&logoColor=white" alt="Cursor"></a>&nbsp; <a href="https://windsurf.com"><img src="https://img.shields.io/badge/Windsurf-09B6A2?style=for-the-badge&logo=codeium&logoColor=white" alt="Windsurf"></a><br> <a href="https://github.com/google-gemini/gemini-cli"><img src="https://img.shields.io/badge/Antigravity-8E75B2?style=for-the-badge&logo=googlegemini&logoColor=white" alt="Antigravity"></a>&nbsp; <a href="https://github.com/opencode-ai/opencode"><img src="https://img.shields.io/badge/OpenCode-333?style=for-the-badge" alt="OpenCode"></a>&nbsp; <a href="https://github.com/features/copilot"><img src="https://img.shields.io/badge/GitHub_Copilot-000?style=for-the-badge&logo=githubcopilot&logoColor=white" alt="GitHub Copilot"></a> </p> <p> <em>Works across any tech stack, any language, any project</em><br><br> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://skillicons.dev/icons?i=ts%2Cjs%2Creact%2Cnextjs%2Cvue%2Cnuxt%2Csvelte%2Cangular%2Cnodejs%2Cexpress%2Cbun%2Cpython%2Cdjango%2Cflask%2Cfastapi&theme=dark&perline=15" /> <source media="(prefers-color-scheme: light)" srcset="https://skillicons.dev/icons?i=ts%2Cjs%2Creact%2Cnextjs%2Cvue%2Cnuxt%2Csvelte%2Cangular%2Cnodejs%2Cexpress%2Cbun%2Cpython%2Cdjango%2Cflask%2Cfastapi&theme=light&perline=15" /> <img alt="Tech Stack Row 1" src="https://skillicons.dev/icons?i=ts,js,react,nextjs,vue,nuxt,svelte,angular,nodejs,express,bun,python,django,flask,fastapi&perline=15" /> </picture> <br> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://skillicons.dev/icons?i=ruby%2Crails%2Cgo%2Crust%2Cjava%2Cspring%2Ckotlin%2Cswift%2Cphp%2Claravel%2Ccs%2Cdotnet%2Celixir%2Cgraphql%2Cprisma&theme=dark&perline=15" /> <source media="(prefers-color-scheme: light)" srcset="https://skillicons.dev/icons?i=ruby%2Crails%2Cgo%2Crust%2Cjava%2Cspring%2Ckotlin%2Cswift%2Cphp%2Claravel%2Ccs%2Cdotnet%2Celixir%2Cgraphql%2Cprisma&theme=light&perline=15" /> <img alt="Tech Stack Row 2" src="https://skillicons.dev/icons?i=ruby,rails,go,rust,java,spring,kotlin,swift,php,laravel,cs,dotnet,elixir,graphql,prisma&perline=15" /> </picture> <br> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://skillicons.dev/icons?i=supabase%2Cfirebase%2Cpostgres%2Cmongodb%2Credis%2Cdocker%2Ckubernetes%2Caws%2Cgcp%2Cazure%2Cvercel%2Ccloudflare%2Ctailwind%2Celectron&theme=dark&perline=15" /> <source media="(prefers-color-scheme: light)" srcset="https://skillicons.dev/icons?i=supabase%2Cfirebase%2Cpostgres%2Cmongodb%2Credis%2Cdocker%2Ckubernetes%2Caws%2Cgcp%2Cazure%2Cvercel%2Ccloudflare%2Ctailwind%2Celectron&theme=light&perline=15" /> <img alt="Tech Stack Row 3" src="https://skillicons.dev/icons?i=supabase,firebase,postgres,mongodb,redis,docker,kubernetes,aws,gcp,azure,vercel,cloudflare,tailwind,electron&perline=15" /> </picture> <br> <p><em>Not just for show. When you run <code>vc-setup</code>, agents scan your codebase,<br> detect your stack, and build project-specific knowledge groups that every skill reads before it works.<br> Other harnesses lock agents to one language — <code>rust-review-agent</code>, <code>python-linter</code> — useless elsewhere.<br> This one adapts to any combination above and builds up knowledge as you ship.</em></p> </p> </div>

---

⚡ Get Started — One Command, 30 Seconds

Prerequisites: Node.js ≥ 22, git, bash (macOS / Linux / WSL / Git Bash; on Alpine: apk add bash).

Windows: the installer is a bash script — run it inside Git Bash (ships with Git for Windows) or WSL, not PowerShell or cmd.exe. Both work out of the box: the installer detects Windows shells and, when symlinks aren't permitted, automatically falls back to copying (install still completes). For true symlinks (so Codex auto-reflects vc-update changes), enable Developer Mode.

There is only one command, and it works for everyone. Run it inside your project folder. It detects whether you are a new or returning user, installs safely without overwriting your files, and then tells you the exact next thing to say.

curl -fsSL https://raw.githubusercontent.com/withkynam/vibecode-pro-max-kit/main/install.sh | bash

When it finishes, it prints one of two messages — read the bottom of the output and do exactly what it says:

<table> <tr> <td width="50%" valign="top"> <h3>🆕 Fresh project</h3> Installer detects no harness and prints: <br><br> <code>Next: Run: claude → Say: "Run vc-setup"</code> <br><br> <strong>→