(https://github.githubassets.com) (https://avatars.githubusercontent.com) (https://github-cloud.s3.amazonaws.com) (https://user-images.githubusercontent.com/) (https://github.githubassets.com) (https://avatars.githubusercontent.com) (https://github.githubassets.com/assets/react-e27d1b3e03961e68.js) (https://github.githubassets.com/assets/react-compiler-runtime-4610bd6d3de9c049.js) (https://github.githubassets.com/assets/scheduler-58b860b049ca307c.js) (https://github.githubassets.com/assets/react-dom-e5fd46a22d5c4058.js) (https://github.githubassets.com/assets/react-dom-client-1b4a3ee065998cea.js) (https://github.githubassets.com/assets/react-is-e0b593954b4706d8.js) (https://github.githubassets.com/assets/react-jsx-runtime-4915cb0f5b3aff04.js) (https://github.githubassets.com/assets/react-reconciler-8e99e505c4429605.js) (../../github.githubassets.com/assets/light-99f877e9ddfc0e51.css) (../../github.githubassets.com/assets/light_high_contrast-48fdd0811afbab3c.css) (../../github.githubassets.com/assets/dark-79ad2ace604703b3.css) (../../github.githubassets.com/assets/dark_high_contrast-24484a076f02295f.css) (../../github.githubassets.com/assets/primer-primitives-ed9ca172356fd545.css) (../../github.githubassets.com/assets/primer-1d2c7f7b52a6068b.css) (../../github.githubassets.com/assets/global-54ba76e934a49d7c.css) (../../github.githubassets.com/assets/github-456bd5deb85c7ecd.css) (../../github.githubassets.com/assets/repository-11ee8a031c040c1a.css) (../../github.githubassets.com/assets/code-2d56bdb0166c0238.css) (https://github.githubassets.com/assets/wp-runtime-c9ed59f6efebd8f2.js) (https://github.githubassets.com/assets/app-foundation-74e9766bd696d26a.js) (https://github.githubassets.com/assets/app-runtime-b9da6ff36bc8f45c.js) (https://github.githubassets.com/assets/fetch-utilities-9a5c31efd5313aa8.js) (https://github.githubassets.com/assets/ser-cd1b421ad0ad7ed5.js) (../../github.githubassets.com/assets/app-runtime.8821470bf7db9d3e.module.css) (https://github.githubassets.com/assets/catalyst-86a8f5de995615f8.js) (https://github.githubassets.com/assets/selector-observer-e88088f989b27670.js) (https://github.githubassets.com/assets/relative-time-element-7cdf4e0db98b997c.js) (https://github.githubassets.com/assets/by-6b3c07383371bf58.js) (https://github.githubassets.com/assets/ja9-36f036c13c2e3a4c.js) (https://github.githubassets.com/assets/kw-866fd9513ae95106.js) (https://github.githubassets.com/assets/r1-b075aab3204f32f9.js) (https://github.githubassets.com/assets/jz5-7c5d1669717041f8.js) (https://github.githubassets.com/assets/hj-5126390ff433704d.js) (https://github.githubassets.com/assets/j05-dce4d588268f0f7e.js) (https://github.githubassets.com/assets/runtime-helpers-f3f5d71440009c48.js) (https://github.githubassets.com/assets/aria-live-76b18916d0c8ec4d.js) (https://github.githubassets.com/assets/hotkey-5109c77d7ac61078.js) (https://github.githubassets.com/assets/react-core-d27b938e851ccb49.js) (https://github.githubassets.com/assets/04-b4570e9cc17d8b62.js) (https://github.githubassets.com/assets/ur-024971cb63acad59.js) (https://github.githubassets.com/assets/4t-364e19c63d726e9a.js) (https://github.githubassets.com/assets/6ny-c969fbae697a356f.js) (https://github.githubassets.com/assets/yhq-3a209035a30b1a09.js) (https://github.githubassets.com/assets/z1v-da5b33b877bfa358.js) (https://github.githubassets.com/assets/wo-df202594a5bf5f61.js) (https://github.githubassets.com/assets/9y-ebc4195ed57c6001.js) (https://github.githubassets.com/assets/j0-41a4cf04cbd99503.js) (https://github.githubassets.com/assets/0p-81491ed0d9d666e2.js) (../../github.githubassets.com/assets/react-core.5c6ee197c091b384.module.css) (https://github.githubassets.com/assets/n9c-16e227ac48072d2b.js) (https://github.githubassets.com/assets/ic-991f04433f366e7b.js) (https://github.githubassets.com/assets/primer-react-3ca70c6e707ba409.js) (https://github.githubassets.com/assets/ncx-9a860680a5f230b9.js) (https://github.githubassets.com/assets/j6-363f0ebf4f62f310.js) (https://github.githubassets.com/assets/t7l-bf6f21d7e7a43c35.js) (https://github.githubassets.com/assets/4u-27f74cfc703e1977.js) (https://github.githubassets.com/assets/ws-f1530f278b2b86e5.js) (https://github.githubassets.com/assets/0n-ecadb2ffe6b01ba2.js) (https://github.githubassets.com/assets/s07-3fae157786a7acb1.js) (https://github.githubassets.com/assets/n4u-6317ce1c31aed1db.js) (https://github.githubassets.com/assets/j8s-d90ce3a169b741ed.js) (https://github.githubassets.com/assets/la-d2cd96f070e6b52a.js) (https://github.githubassets.com/assets/q61-80cd2b936a4f27b6.js) (https://github.githubassets.com/assets/7l-fa7490fba21d1122.js) (https://github.githubassets.com/assets/w4q-134941577ca76346.js) (https://github.githubassets.com/assets/ojg-6604ac9ae112ae6a.js) (https://github.githubassets.com/assets/gzu-a1c918f049c6302d.js) (https://github.githubassets.com/assets/bi0-a78ba744687848c2.js) (https://github.githubassets.com/assets/on-864de56673dc70dd.js) (https://github.githubassets.com/assets/b1-04bc5715b6dd3e67.js) (https://github.githubassets.com/assets/0l5-2c7e8df6e59adc66.js) (https://github.githubassets.com/assets/c2z-c92998400310b94b.js) (https://github.githubassets.com/assets/f9-038758dcbfe08dab.js) (https://github.githubassets.com/assets/0k-b7df0a74912a42bf.js) (https://github.githubassets.com/assets/sp-352b18edf58f7022.js) (https://github.githubassets.com/assets/og-72a377e4a14147a1.js) (https://github.githubassets.com/assets/b9-4fd36ab02c30bf52.js) (https://github.githubassets.com/assets/ec-cbba6ef3015afe55.js) (https://github.githubassets.com/assets/du-3326f9d530cbf97a.js) (https://github.githubassets.com/assets/20x-4a56da9133271e97.js) (https://github.githubassets.com/assets/ql0-e077eae00b3c661b.js) (https://github.githubassets.com/assets/dsj-cb1e4ddbce4f007b.js) (https://github.githubassets.com/assets/wp-9f5235d335ab624b.js) (https://github.githubassets.com/assets/gc4-2487b0aac2401bb1.js) (https://github.githubassets.com/assets/uw-1408814835e50727.js) (https://github.githubassets.com/assets/7cw-169ae7bb5f04a269.js) (https://github.githubassets.com/assets/z0-dbe181bb9b6102e2.js) (https://github.githubassets.com/assets/hrn-7aa21aeb0277bcce.js) (https://github.githubassets.com/assets/w4-93b0f8e500e9a8c0.js) (https://github.githubassets.com/assets/jxi-4a01b1e0ce757fd4.js) (https://github.githubassets.com/assets/72-6ed830f2c6609d65.js) (https://github.githubassets.com/assets/xc-065e7847e4da513d.js) (https://github.githubassets.com/assets/t-35c01fdd178d6ece.js) (../../github.githubassets.com/assets/primer-react-css.e8e079ce0aabb0eb.module.css) (../../github.githubassets.com/assets/ql0.a8799830227aa47a.module.css) (../../github.githubassets.com/assets/z0.24e81889b1a36b13.module.css) (../../github.githubassets.com/assets/xc.877a51df9233c9c4.module.css) (../../github.githubassets.com/assets/t.10913a8697586d8c.module.css) (../../github.githubassets.com/assets/code-view.13f140d201e695c6.module.css) (https://github.githubassets.com/assets/8p0n-73376bed45f677a1.js) (../../github.githubassets.com/assets/primer-react-css.e8e079ce0aabb0eb.module.css) (../../github.githubassets.com/assets/notifications-subscriptions-menu.462fe14c4b01eb6b.module.css) GitHub - Moeeryani/Vibe-Coding-Production-Kit: Production-grade vibe coding framework with specs, architecture, AI agents, testing, security, code review, CI/CD, and battle-tested workflows — from idea to production. · GitHub (repo_source) (https://github.githubassets.com/) (https://github.com/opensearch.xml) (GitHub) (https://github.com/fluidicon.png) (GitHub) (https://github.githubassets.com/assets/pinned-octocat-093da3e6fa40.svg) (https://github.githubassets.com/favicons/favicon.png) (../../github.githubassets.com/favicons/favicon.svg) (../manifest.json) (Vibe-Coding-Production-Kit.html#start-of-content) Skip to content (https://github.githubassets.com/assets/l7j-2ddd8b435dadae28.js) (https://github.githubassets.com/assets/keyboard-shortcuts-dialog-3d43e7df0d6c66f6.js) (../../github.githubassets.com/assets/primer-react-css.e8e079ce0aabb0eb.module.css) (../../github.githubassets.com/assets/keyboard-shortcuts-dialog.8daa61a431259a33.module.css) (https://github.githubassets.com/assets/pw-4f91498888595802.js) (https://github.githubassets.com/assets/app-install-banner-partial-d6d5b5ae93c729ca.js) (../../github.githubassets.com/assets/primer-react-css.e8e079ce0aabb0eb.module.css) (../../github.githubassets.com/assets/app-install-banner-partial.f198729a878dc4f6.module.css) (https://github.githubassets.com/assets/2l-6cedbc3128429fc7.js) (https://github.githubassets.com/assets/i2-3e1ea9a828b29b0d.js) (https://github.githubassets.com/assets/fz5-23f28c0f388769c9.js) (https://github.githubassets.com/assets/lht-dedd9949bed91081.js) (https://github.githubassets.com/assets/p1-76a75a6081059b19.js) (https://github.githubassets.com/assets/3d-82c347d20a13fb90.js) (https://github.githubassets.com/assets/tua-18c20c09a9dc80b9.js) (https://github.githubassets.com/assets/t1-43ffb03359742e26.js) (https://github.githubassets.com/assets/marketing-header-3f3244c847fa6d23.js) (../../github.githubassets.com/assets/primer-react-css.e8e079ce0aabb0eb.module.css) (../../github.githubassets.com/assets/primer-react-brand-css.6a01c236ff527e7e.module.css) (../../github.githubassets.com/assets/t1.5c2ccf9cfbcf9488.module.css) Navigation Menu (https://github.com/) (https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2FMoeeryani%2FVibe-Coding-Production-Kit) Sign in Appearance settings Platform AI CODE CREATION (https://github.com/features/copilot) GitHub Copilot Write better code with AI (https://github.com/features/ai/github-app) GitHub Copilot app Direct agents from issue to merge (https://github.com/mcp) MCP Registry Integrate external tools DEVELOPER WORKFLOWS (https://github.com/features/actions) Actions Automate any workflow (https://github.com/features/codespaces) Codespaces Instant dev environments (https://github.com/features/issues) Issues Plan and track work (https://github.com/features/code-review) Code Review Manage code changes (https://github.com/features/code-quality) Code Quality Enforce quality at merge APPLICATION SECURITY (https://github.com/security/advanced-security) GitHub Advanced Security Find and fix vulnerabilities (https://github.com/security/advanced-security/code-security) Code security Secure your code as you build (https://github.com/security/advanced-security/secret-protection) Secret protection Stop leaks before they start EXPLORE (https://github.com/why-github) Why GitHub (https://docs.github.com) Documentation (https://github.blog) Blog (https://github.blog/changelog) Changelog (https://github.com/marketplace) Marketplace (https://github.com/features) View all features Solutions BY COMPANY SIZE (https://github.com/enterprise) Enterprises (https://github.com/team) Small and medium teams (https://github.com/enterprise/startups) Startups (https://github.com/solutions/industry/nonprofits) Nonprofits BY USE CASE (https://github.com/solutions/use-case/app-modernization) App Modernization (https://github.com/solutions/use-case/devsecops) DevSecOps (https://github.com/solutions/use-case/devops) DevOps (https://github.com/solutions/use-case/ci-cd) CI/CD (https://github.com/solutions/use-case) View all use cases BY INDUSTRY (https://github.com/solutions/industry/healthcare) Healthcare (https://github.com/solutions/industry/financial-services) Financial services (https://github.com/solutions/industry/manufacturing) Manufacturing (https://github.com/solutions/industry/government) Government (https://github.com/solutions/industry) View all industries (https://github.com/solutions) View all solutions Resources EXPLORE BY TOPIC (https://github.com/resources/articles?topic=ai) AI (https://github.com/resources/articles?topic=software-development) Software Development (https://github.com/resources/articles?topic=devops) DevOps (https://github.com/resources/articles?topic=security) Security (https://github.com/resources/articles) View all topics EXPLORE BY TYPE (https://github.com/customer-stories) Customer stories (https://github.com/resources/events) Events & webinars (https://github.com/resources/whitepapers) Ebooks & reports (https://github.com/solutions/executive-insights) Business insights (https://skills.github.com) GitHub Skills SUPPORT & SERVICES (https://docs.github.com) Documentation (https://support.github.com) Customer support (https://github.com/orgs/community/discussions) Community forum (https://github.com/trust-center) Trust center (https://github.com/partners) Partners (https://github.com/resources) View all resources Open Source COMMUNITY (https://github.com/open-source/sponsors) GitHub Sponsors Fund open source developers PROGRAMS (https://securitylab.github.com) Security Lab (https://maintainers.github.com) Maintainer Community (https://stars.github.com) GitHub Stars (https://archiveprogram.github.com) Archive Program REPOSITORIES (https://github.com/topics) Topics (https://github.com/trending) Trending (https://github.com/collections) Collections Enterprise ENTERPRISE SOLUTIONS (https://github.com/enterprise) Enterprise platform AI-powered developer platform AVAILABLE ADD-ONS (https://github.com/security/advanced-security) GitHub Advanced Security Enterprise-grade security features (https://github.com/features/copilot/copilot-business) Copilot for Business Enterprise-grade AI features (https://github.com/enterprise/premium-support) Premium Support Enterprise-grade 24/7 support (https://github.com/pricing) Pricing Search / (https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2FMoeeryani%2FVibe-Coding-Production-Kit) Sign in (https://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E&source=header-repo&source_repo=Moeeryani%2FVibe-Coding-Production-Kit) Sign up Appearance settings You signed in with another tab or window. (Vibe-Coding-Production-Kit.html) Reload to refresh your session. You signed out in another tab or window. (Vibe-Coding-Production-Kit.html) Reload to refresh your session. You switched accounts on another tab or window. (Vibe-Coding-Production-Kit.html) Reload to refresh your session. Dismiss alert (https://github.com/Moeeryani) Moeeryani / (Vibe-Coding-Production-Kit.html) Vibe-Coding-Production-Kit Public (https://github.com/login?return_to=%2FMoeeryani%2FVibe-Coding-Production-Kit) Notifications You must be signed in to change notification settings (https://github.com/login?return_to=%2FMoeeryani%2FVibe-Coding-Production-Kit) Fork (0) 0 (https://github.com/login?return_to=%2FMoeeryani%2FVibe-Coding-Production-Kit) Star (26) 26 (Vibe-Coding-Production-Kit.html) Code (Not available) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/issues) Issues (3) 3 (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/pulls) Pull requests (1) 1 (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/actions) Actions (Not available) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/projects) Projects (Not available) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/security) Security and quality (0) 0 (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/pulse) Insights (Not available) Additional navigation options (Vibe-Coding-Production-Kit.html) Code (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/issues) Issues (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/pulls) Pull requests (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/actions) Actions (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/projects) Projects (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/security) Security and quality (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/pulse) Insights (Vibe-Coding-Production-Kit.html) main (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/branches) Branches (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/tags) Tags (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/branches) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/tags) (Go to file) () Go to file Code Open more actions menu Latest commit History (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/commits/main/) 80 Commits (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/commits/main/) 80 Commits Folders and files Name Name (Last commit message) Last commit message (Last commit date) Last commit date (.github) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/tree/main/.github) .github (.github) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/tree/main/.github) .github (bin) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/tree/main/bin) bin (bin) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/tree/main/bin) bin (docs) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/tree/main/docs) docs (docs) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/tree/main/docs) docs (examples) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/tree/main/examples) examples (examples) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/tree/main/examples) examples (lib) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/tree/main/lib) lib (lib) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/tree/main/lib) lib (prompts) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/tree/main/prompts) prompts (prompts) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/tree/main/prompts) prompts (scripts) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/tree/main/scripts) scripts (scripts) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/tree/main/scripts) scripts (test) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/tree/main/test) test (test) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/tree/main/test) test (.gitattributes) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/blob/main/.gitattributes) .gitattributes (.gitattributes) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/blob/main/.gitattributes) .gitattributes (.gitignore) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/blob/main/.gitignore) .gitignore (.gitignore) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/blob/main/.gitignore) .gitignore (AGENTS.md) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/blob/main/AGENTS.md) AGENTS.md (AGENTS.md) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/blob/main/AGENTS.md) AGENTS.md (CHANGELOG.md) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/blob/main/CHANGELOG.md) CHANGELOG.md (CHANGELOG.md) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/blob/main/CHANGELOG.md) CHANGELOG.md (CODE_OF_CONDUCT.md) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/blob/main/CODE_OF_CONDUCT.md) CODE_OF_CONDUCT.md (CODE_OF_CONDUCT.md) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/blob/main/CODE_OF_CONDUCT.md) CODE_OF_CONDUCT.md (CONTRIBUTING.md) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/blob/main/CONTRIBUTING.md) CONTRIBUTING.md (CONTRIBUTING.md) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/blob/main/CONTRIBUTING.md) CONTRIBUTING.md (LICENSE) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/blob/main/LICENSE) LICENSE (LICENSE) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/blob/main/LICENSE) LICENSE (Makefile) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/blob/main/Makefile) Makefile (Makefile) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/blob/main/Makefile) Makefile (README.ar.md) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/blob/main/README.ar.md) README.ar.md (README.ar.md) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/blob/main/README.ar.md) README.ar.md (README.md) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/blob/main/README.md) README.md (README.md) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/blob/main/README.md) README.md (SECURITY.md) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/blob/main/SECURITY.md) SECURITY.md (SECURITY.md) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/blob/main/SECURITY.md) SECURITY.md (package-lock.json) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/blob/main/package-lock.json) package-lock.json (package-lock.json) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/blob/main/package-lock.json) package-lock.json (package.json) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/blob/main/package.json) package.json (package.json) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/blob/main/package.json) package.json View all files Repository files navigation (Vibe-Coding-Production-Kit.html#) README (Vibe-Coding-Production-Kit.html#) Code of conduct (Vibe-Coding-Production-Kit.html#) Contributing (Vibe-Coding-Production-Kit.html#) MIT license (Vibe-Coding-Production-Kit.html#) Security Moreitems Vibe Coding Production Kit (Vibe-Coding-Production-Kit.html#vibe-coding-production-kit) Build with AI like an engineering team — not like a chat session. (https://www.npmjs.com/package/vibe-coding-production) (npm version) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/blob/main/LICENSE) (License: MIT) (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/stargazers) (GitHub stars) Vibe Coding Production Kit (VCP) is a production-minded operating system and zero-runtime-dependency CLI for AI-assisted software development. It turns vague “vibe coding” into a repeatable engineering lifecycle built around specifications, architecture, bounded tasks, repository-native agent rules, readiness gates, security, verification evidence, independent review, safe updates, and recovery. It is model-agnostic and works with tools such as Codex, Claude Code, Cursor, GitHub Copilot, and other coding agents. Arabic documentation: (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/blob/main/README.ar.md) README.ar.md Start in 60 seconds (Vibe-Coding-Production-Kit.html#start-in-60-seconds) Run the published npm package directly — no global install required: npx vibe-coding-production init . --agent all --stack auto --yes Or target another repository: npx vibe-coding-production init ./my-app --agent claude --stack auto --yes Preview without writing: npx vibe-coding-production init . --agent all --stack auto --dry-run The executable is also available as vcp when installed or invoked through npm package tooling. If you intentionally want to run the repository version instead of the published npm package: npx --yes github:Moeeryani/Vibe-Coding-Production-Kit init . --agent all --stack auto --yes The CLI requires Node.js 22+ , has no runtime dependencies , and auto-detects JavaScript/Node.js, TypeScript, Python, and Go only when repository evidence supports that decision. New here? Follow the end-to-end (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/blob/main/docs/QUICKSTART.md) 10-minute Quickstart . Use VCP through your coding agent (Vibe-Coding-Production-Kit.html#use-vcp-through-your-coding-agent) VCP is intended to be driven primarily by the coding agent rather than by a developer manually filling every template or memorizing every command. After initialization, you can tell Claude Code, Codex, Cursor, or another compatible agent: Set up VCP for this repository. Inspect the existing code, package scripts, tests, architecture, and documentation. Draft the VCP source-of-truth files from repository evidence. Distinguish discovered facts from proposed decisions, and ask me only for decisions that require human product or engineering intent. Run VCP Doctor when done. For feature work, state the intent normally: Use VCP and add verified email change. Draft the task, run the readiness gates, ask me only for unresolved product decisions, plan before coding, verify the result, and perform an independent review. The desired split is simple: AI does the inspection, drafting, bookkeeping, and VCP command execution. Human makes product/engineering decisions and approves important trade-offs. VCP preserves the decisions, gates implementation, and records verification evidence. Why this is different (Vibe-Coding-Production-Kit.html#why-this-is-different) Most vibe-coding workflows optimize for getting the first demo working. VCP optimizes for the 100th feature, the second developer, production incidents, security reviews, migrations, refactors, upgrades, and years of maintenance. Casual vibe coding Vibe Coding Production Kit Prompt is the source of truth Repository docs are the source of truth Large “build this app” requests Small bounded task contracts Agent starts coding immediately Readiness + plan-before-code gates “Tests should pass” Executed verification evidence Same agent builds and judges Independent review workflow Copy templates once Versioned lifecycle state + safe updates Overwrite/reinstall to upgrade Baselines, merge, migrations, rollback Hope production is okay Security, observability, release/recovery thinking The daily workflow (Vibe-Coding-Production-Kit.html#the-daily-workflow) What the developer should experience: state intent ↓ answer only unresolved human decisions ↓ review / approve plan ↓ review final result + evidence What the coding agent executes behind that experience: init / inspect ↓ task ↓ ready --stage plan ↓ context --mode plan ↓ plan ↓ ready --stage implement ↓ context --mode implement ↓ implement ↓ verify ↓ independent review ↓ doctor ↓ release / observe When a newer VCP version is available: update --check ↓ update --dry-run ↓ resolve conflicts if any ↓ update ↓ doctor Safe lifecycle updates — v0.9 (Vibe-Coding-Production-Kit.html#safe-lifecycle-updates--v09) vcp init now creates .vcp/manifest.json and persistent baseline snapshots. Once a repository is initialized, VCP refuses to replace that lifecycle state with init --force ; upgrades go through the update engine. Check version state: vcp update . --check vcp update . --check --json Preview the full migration plan without writing project files: vcp update . --dry-run Apply after reviewing the plan: vcp update . Recover the newest safe recovery point: vcp rollback . Detach or re-track one VCP-managed file without deleting local content: vcp manage ignore AGENTS.md vcp manage track AGENTS.md The update engine uses: persistent baseline hashes and snapshots; managed , generated , and preserve ownership policies; bounded three-way merge for independent edits; explicit CONFLICT instead of guessing on overlaps; versioned migration declarations for renames/removals; lifecycle locking before planning and mutation; path traversal and symlink protections; transaction state, backups, post-apply verification, and automatic rollback; conservative rollback semantics instead of pretending partial historical backups are complete snapshots. See (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/blob/main/docs/UPDATES.md) docs/UPDATES.md for the full contract and (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/blob/main/docs/CLI.md) docs/CLI.md for commands/options. Audit an existing project (Vibe-Coding-Production-Kit.html#audit-an-existing-project) The read-only doctor checks whether the engineering system is actually configured—not merely copied: npx vibe-coding-production doctor . It reports concrete PASS / WARN / FAIL findings for agent instructions, unresolved verification commands, source-of-truth documents, untouched templates, CI, plan/review workflow, manifest compatibility, baseline integrity, and interrupted update transactions. Use --json for automation or --strict to make warnings non-zero. See (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/blob/main/docs/DOCTOR.md) docs/DOCTOR.md . Create a bounded task before coding (Vibe-Coding-Production-Kit.html#create-a-bounded-task-before-coding) npx vibe-coding-production task accept-invite --title " Accept invitation" The generator creates docs/tasks/accept-invite.md with source-of-truth links, acceptance criteria, scope boundaries, security/privacy questions, failure modes, observability, tests, rollout/recovery, implementation planning, review checks, and the verification commands actually configured in AGENTS.md . The coding agent should draft and update this task from repository evidence instead of asking the developer to fill every field manually. See (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/blob/main/docs/TASK-PACKS.md) docs/TASK-PACKS.md . Gate readiness before planning and implementation (Vibe-Coding-Production-Kit.html#gate-readiness-before-planning-and-implementation) vcp ready accept-invite --stage plan vcp ready accept-invite --stage implement The planning gate requires a real outcome, resolvable Source of Truth, concrete acceptance criteria, explicit scope, and an unambiguous task structure. The implementation gate additionally requires resolved architecture/data/integration boundaries, domain invariants, security/privacy, failure modes, observability, testing, rollout/recovery, a concrete implementation plan, and an executable verification plan. Referenced Source of Truth files that still contain known starter-template signals are reported as warnings so the agent can draft project-specific decisions instead of treating an empty template as evidence. See (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/blob/main/docs/TASK-READINESS.md) docs/TASK-READINESS.md . Build the right context for each AI phase (Vibe-Coding-Production-Kit.html#build-the-right-context-for-each-ai-phase) vcp context accept-invite --mode plan Use --mode implement , review , security , or release as the task progresses. Add only affected implementation files with repeatable --include flags. Context packs reject repository escapes and enforce a size budget by default. See (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/blob/main/docs/CONTEXT-PACKS.md) docs/CONTEXT-PACKS.md . Turn “I ran the tests” into evidence (Vibe-Coding-Production-Kit.html#turn-i-ran-the-tests-into-evidence) Preview exactly what would execute: vcp verify accept-invite Execution requires explicit consent and an implementation-ready task: vcp verify accept-invite --run \ --output .vcp/evidence/accept-invite.json Commands run sequentially and stop after the first failure. Evidence records command, status, exit code, signal, timeout state, and duration, while raw stdout/stderr is deliberately not persisted by default. See (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/blob/main/docs/VERIFICATION-EVIDENCE.md) docs/VERIFICATION-EVIDENCE.md . Worked reference project (Vibe-Coding-Production-Kit.html#worked-reference-project) Start with (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/blob/main/examples/reference-saas-invite) examples/reference-saas-invite/ to see the workflow as concrete engineering artifacts instead of blank templates. It models a security-sensitive multi-tenant invitation vertical slice with completed product/domain/architecture/data artifacts, ADR, threat model, test strategy, bounded task, layered code, and negative-path tests for authorization, tenant boundaries, token hashing, expiry, replay, and email binding. cd examples/reference-saas-invite npm test npm run check The example explicitly documents what remains unproven for real production infrastructure instead of calling a demo “production-ready.” Core principle (Vibe-Coding-Production-Kit.html#core-principle) Do not ask AI to build your project. Build a system that makes it difficult for AI to build your project incorrectly. The human owns intent, trade-offs, architecture, risk acceptance, and final decisions. AI helps inspect, draft, research, plan, implement, test, review, document, and automate — inside explicit constraints. The lifecycle (Vibe-Coding-Production-Kit.html#the-lifecycle) Idea -> Product brief -> PRD + acceptance criteria -> User flows -> Domain model -> Architecture + ADRs -> Data model -> Threat model -> Test strategy -> Epics / stories / bounded tasks -> Readiness gate -> Plan before code -> Bounded implementation -> Verification evidence -> Independent review -> CI gates -> Release + observability -> Safe VCP lifecycle updates -> Learn and update the source of truth What you get (Vibe-Coding-Production-Kit.html#what-you-get) AGENTS.md — repository-wide rules and an AI-first VCP operating protocol for coding agents. Product templates — product brief, PRD, user flows, acceptance criteria. Architecture templates — domain model, system design, data model, ADRs. Security template — threat modeling before implementation. Test strategy — unit/integration/contract/E2E decision framework. Delivery system — Definition of Ready, Definition of Done, task/release checklists. vcp task — bounded repository-native task contracts. vcp ready — separate plan/implementation readiness gates. vcp context — bounded phase-specific AI context packs. vcp verify — explicit execution and verification evidence. vcp doctor — repository/system health audit without a misleading magic score. vcp update — lifecycle-aware safe updates with merge/migrations/recovery. Agent prompts — discovery, planning, implementation, review, security, refactoring, release review. GitHub hygiene — issue templates, PR template, contributing guide, security policy, validation workflow. English README plus an Arabic guide. Establish the source of truth (Vibe-Coding-Production-Kit.html#establish-the-source-of-truth) These are the main project documents VCP manages: docs/product/PRODUCT-BRIEF.md docs/product/PRD.md docs/product/USER-FLOWS.md docs/architecture/DOMAIN.md docs/architecture/ARCHITECTURE.md docs/architecture/DATA-MODEL.md docs/security/THREAT-MODEL.md docs/testing/TEST-STRATEGY.md Do not treat this as a manual form-filling checklist. Have the coding agent inspect repository evidence and draft these files. The developer should approve or correct decisions that require human intent. AGENTS.md should likewise be populated from proven repository commands where possible; unresolved commands stay explicit instead of being guessed. Agent execution loop (Vibe-Coding-Production-Kit.html#agent-execution-loop) flowchart LR A[Developer states intent] --> B[Agent inspects Source of Truth] B --> C[Agent drafts/updates bounded task] C --> D[Readiness: plan] D --> E[Build plan context] E --> F[Plan without editing] F --> G{Human decision needed?} G -- Yes --> H[Ask focused decision] H --> F G -- No --> I[Readiness: implement] I --> J[Implement bounded scope] J --> K[Verification evidence] K --> L[Independent review] L --> M{Quality gates pass?} M -- No --> J M -- Yes --> N[Merge / release / observe] Loading Repository map (Vibe-Coding-Production-Kit.html#repository-map) . ├── AGENTS.md ├── README.md ├── README.ar.md ├── CONTRIBUTING.md ├── SECURITY.md ├── bin/ ├── lib/ ├── docs/ │ ├── 00-START-HERE.md │ ├── QUICKSTART.md │ ├── CLI.md │ ├── UPDATES.md │ ├── product/ │ ├── architecture/ │ ├── security/ │ ├── testing/ │ └── delivery/ ├── prompts/ ├── examples/ ├── scripts/ └── .github/ Non-negotiables (Vibe-Coding-Production-Kit.html#non-negotiables) Specs before implementation. Architecture decisions are recorded, not buried in chat history. No large unbounded agent tasks. External input is validated at trust boundaries. Authorization is server-side and resource-specific. Schema changes use reviewed migrations and rollback thinking. Tests are added with behavior, not postponed to the end. The builder is not the only reviewer. CI is the mechanical source of truth when CI is available. Production must be observable and recoverable. Lifecycle upgrades are planned and reversible; templates are not blindly recopied. Do not make the developer write information the agent can reliably discover or draft. Suggested task size (Vibe-Coding-Production-Kit.html#suggested-task-size) A good agent task normally has: one primary outcome; a narrow set of affected modules; explicit acceptance criteria; known tests; no unrelated refactor; a diff small enough for a human to understand. If a task requires a long explanation of “and while you're there…”, split it. Tool-specific notes (Vibe-Coding-Production-Kit.html#tool-specific-notes) The kit intentionally avoids locking you into one AI vendor. Keep universal rules in AGENTS.md , and add tool-specific instruction files only when they provide real value. Do not duplicate conflicting rules across multiple agent configuration files. Prefer one source of truth and thin adapters. Roadmap (Vibe-Coding-Production-Kit.html#roadmap) CLI bootstrap with evidence-based JavaScript/TypeScript/Python/Go profiles Context-aware task pack generator Two-stage task readiness gate Phase-specific bounded context packs Safe verification evidence workflow Read-only doctor audit Worked reference vertical slice Versioned lifecycle state and safe vcp update Three-way merge, migrations, locking, backup, rollback, and manage ignore/track Mobile stack profiles Monorepo-aware stack/CI profiles Security profiles for common application classes Git-aware review/release automation Prompt evaluation suite for coding agents Architecture fitness-function examples Extensible community profile/plugin system See (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/blob/main/CONTRIBUTING.md) CONTRIBUTING.md if you want to help. License (Vibe-Coding-Production-Kit.html#license) MIT — use it in personal, commercial, and open-source projects. About Production-grade vibe coding framework with specs, architecture, AI agents, testing, security, code review, CI/CD, and battle-tested workflows — from idea to production. Topics (https://github.com/topics/agentic-coding) agentic-coding (https://github.com/topics/ai-coding) ai-coding (https://github.com/topics/claude-code) claude-code (https://github.com/topics/codex) codex (https://github.com/topics/coding-agents) coding-agents (https://github.com/topics/cursor) cursor (https://github.com/topics/developer-tools) developer-tools (https://github.com/topics/github-copilot) github-copilot (https://github.com/topics/production-ready) production-ready (https://github.com/topics/prompt-engineering) prompt-engineering (https://github.com/topics/software-architecture) software-architecture (https://github.com/topics/software-engineering) software-engineering (https://github.com/topics/spec-driven-development) spec-driven-development (https://github.com/topics/vibe-coding) vibe-coding Resources (Vibe-Coding-Production-Kit.html#readme-ov-file) Readme (Vibe-Coding-Production-Kit.html#MIT-1-ov-file) MIT license Code of conduct (Vibe-Coding-Production-Kit.html#coc-ov-file) Code of conduct Contributing (Vibe-Coding-Production-Kit.html#contributing-ov-file) Contributing Security policy (Vibe-Coding-Production-Kit.html#security-ov-file) Security policy (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/activity) Activity Stars 26 stars Watchers 0 watching Forks (https://github.com/Moeeryani/Vibe-Coding-Production-Kit/forks) 0 forks (https://github.com/contact/report-content?content_url=https%3A%2F%2Fgithub.com%2FMoeeryani%2FVibe-Coding-Production-Kit&report=Moeeryani+%28user%29) Report repository Releases Packages Contributors Languages Footer (https://github.com) © 2026 GitHub, Inc. Footer navigation (https://docs.github.com/site-policy/github-terms/github-terms-of-service) Terms (https://docs.github.com/site-policy/privacy-policies/github-privacy-statement) Privacy (https://github.com/security) Security (https://www.githubstatus.com/) Status (https://github.community/) Community (https://docs.github.com/) Docs (https://support.github.com?tags=dotcom-footer) Contact Manage cookies Do not share my personal information You can’t perform that action at this time.