{"_id":"@acomarcho/vibecode","_rev":"8-ef364928a07241d1aa18e2ecaa039d6f","name":"@acomarcho/vibecode","dist-tags":{"latest":"1.0.7"},"versions":{"1.0.0":{"name":"@acomarcho/vibecode","version":"1.0.0","author":{"name":"acomarcho"},"license":"ISC","_id":"@acomarcho/vibecode@1.0.0","maintainers":[{"name":"acomarcho","email":"acoxstpd@gmail.com"}],"bin":{"vibecode":"bin/cli.js"},"dist":{"shasum":"80623fc76b57c75bae2967551ff0c97711b5e652","tarball":"https://registry.npmjs.org/@acomarcho/vibecode/-/vibecode-1.0.0.tgz","fileCount":5,"integrity":"sha512-8CaVfz3RBJ2XSDRY6HE/gl820zDDS5IkFfzG+NTQu3w85RS72xWBoVfgoNfTp/qYG6n9u1EwG4XBpkdOsDsJ1Q==","signatures":[{"sig":"MEUCIQC2VZUQgMORYsovbPdrEvC9I+oYKFszSctcbInyJjFvhQIgDnr1nMz8hQiCeCFzkP6Jk4tHh0GQ+jSZfInGGTujGpU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":19445},"_npmUser":{"name":"acomarcho","email":"acoxstpd@gmail.com"},"_npmVersion":"10.9.3","description":"","directories":{},"_nodeVersion":"22.20.0","dependencies":{"prompts":"^2.4.2"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/vibecode_1.0.0_1760144085354_0.1208084780318388","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@acomarcho/vibecode","version":"1.0.1","author":{"name":"acomarcho"},"license":"ISC","_id":"@acomarcho/vibecode@1.0.1","maintainers":[{"name":"acomarcho","email":"acoxstpd@gmail.com"}],"bin":{"vibecode":"bin/cli.js"},"dist":{"shasum":"5d989f9dd0831c5943df36497a9711368a5d60e0","tarball":"https://registry.npmjs.org/@acomarcho/vibecode/-/vibecode-1.0.1.tgz","fileCount":6,"integrity":"sha512-MtFR+urHSinC90FCzhtiBMXQgTPyRwtgjEx7nllCP++V0cYLKGCHskWqLWucJ1SqpwUzzhm1iBVuaOuumzhxJA==","signatures":[{"sig":"MEQCIDM00HqawYMgapvu065YEdlKJUEzPl03XfFuH6fSRxs+AiBHGbKOXLCpyJ3h49w4NjR44l1ST3Vnq1+HnKK+ufjT9A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":20004},"gitHead":"1f73abc459fd4a1f28ee256e93c4e4a51ca28aad","_npmUser":{"name":"acomarcho","email":"acoxstpd@gmail.com"},"_npmVersion":"10.9.3","description":"`npx @acomarcho/vibecode`","directories":{},"_nodeVersion":"22.20.0","dependencies":{"prompts":"^2.4.2"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/vibecode_1.0.1_1760144893235_0.6096878456986938","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@acomarcho/vibecode","version":"1.0.2","author":{"name":"acomarcho"},"license":"ISC","_id":"@acomarcho/vibecode@1.0.2","maintainers":[{"name":"acomarcho","email":"acoxstpd@gmail.com"}],"bin":{"vibecode":"bin/cli.js"},"dist":{"shasum":"6c441cfd7bb4cf7a5785424d859bcd7467831e37","tarball":"https://registry.npmjs.org/@acomarcho/vibecode/-/vibecode-1.0.2.tgz","fileCount":6,"integrity":"sha512-N2Hcdzu0Rxv4O4zvQJtudr/GKyn5jMLjTxob8+DrjVi3f8U2oGcLTC8SAJfqP4wkQLOxp0J4HhpAeGLqb+qQfw==","signatures":[{"sig":"MEUCIQC59MMOBk7voktoV+YPM7ePDdeGu/t+kvTIDeibQwo3NAIgT9hJSDVJAdPTttqyksLhIe+qnlQjAyH0nSRFj4uqJrw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":19300},"gitHead":"4ece13cdd9c435be17c0391087dbdd826b560125","_npmUser":{"name":"acomarcho","email":"acoxstpd@gmail.com"},"_npmVersion":"10.9.3","description":"`npx @acomarcho/vibecode`","directories":{},"_nodeVersion":"22.20.0","dependencies":{"prompts":"^2.4.2"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/vibecode_1.0.2_1760146185713_0.5216129721708933","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@acomarcho/vibecode","version":"1.0.3","author":{"name":"acomarcho"},"license":"ISC","_id":"@acomarcho/vibecode@1.0.3","maintainers":[{"name":"acomarcho","email":"acoxstpd@gmail.com"}],"bin":{"vibecode":"bin/cli.js"},"dist":{"shasum":"26441a208c02655067f1f190cbd696ac5588fe76","tarball":"https://registry.npmjs.org/@acomarcho/vibecode/-/vibecode-1.0.3.tgz","fileCount":6,"integrity":"sha512-Nte1K+zWOIHdl3UBKe+OkTzcEA3BOG08SWGSkvGQx3xrXHxE50h4K7nEiuhTXkkm12MRlaEq2Q+e/JeVr0r1Vw==","signatures":[{"sig":"MEQCIFL9cL8nHvxIc0V33Rv6sMCm068XJDGhgwEY/a3F2MNjAiBsurO9U9/kxk1alm7a2zKTw5SljwLd+9MMbBYfVpLA6A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":20555},"gitHead":"db64e31e51f645fb1f1af6803164f51640b2a47a","_npmUser":{"name":"acomarcho","email":"acoxstpd@gmail.com"},"_npmVersion":"10.9.3","description":"`npx @acomarcho/vibecode`","directories":{},"_nodeVersion":"22.20.0","dependencies":{"prompts":"^2.4.2"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/vibecode_1.0.3_1760147652563_0.5524219341078622","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"@acomarcho/vibecode","version":"1.0.4","author":{"name":"acomarcho"},"license":"ISC","_id":"@acomarcho/vibecode@1.0.4","maintainers":[{"name":"acomarcho","email":"acoxstpd@gmail.com"}],"bin":{"vibecode":"bin/cli.js"},"dist":{"shasum":"e29a19f96ab6949bab7ee5c85e103af033208253","tarball":"https://registry.npmjs.org/@acomarcho/vibecode/-/vibecode-1.0.4.tgz","fileCount":6,"integrity":"sha512-TUxdoOkYoHVd4Op9L494q/YywRGyuy2t7O/h37MebcLgtn0omDszeE5KCNdbMxzG52ARQ9mqtOYn2/Kn6IL0dw==","signatures":[{"sig":"MEQCIHu9VwgCS3yLygJf38CiIUPob5P1ccU433FssPL8mDjKAiALItC4JnNULo+jMg7Lq4zDOMvpcNLzJbQ6IFz6MnyJAw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":25078},"gitHead":"f0e895ff32ad2200b3c1947f8165492d180b75a2","_npmUser":{"name":"acomarcho","email":"acoxstpd@gmail.com"},"_npmVersion":"10.9.3","description":"A collection of structured prompts for AI-powered development workflows. Use these prompts with coding agents like Cursor, Claude Code, or opencode to systematically build features from idea to implementation.","directories":{},"_nodeVersion":"22.20.0","dependencies":{"prompts":"^2.4.2"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/vibecode_1.0.4_1760181917162_0.47393336967558586","host":"s3://npm-registry-packages-npm-production"}},"1.0.5":{"name":"@acomarcho/vibecode","version":"1.0.5","author":{"name":"acomarcho"},"license":"ISC","_id":"@acomarcho/vibecode@1.0.5","maintainers":[{"name":"acomarcho","email":"acoxstpd@gmail.com"}],"bin":{"vibecode":"bin/cli.js"},"dist":{"shasum":"159f6a4b4a246609e4801fad11cff81377933d71","tarball":"https://registry.npmjs.org/@acomarcho/vibecode/-/vibecode-1.0.5.tgz","fileCount":8,"integrity":"sha512-HNFP3Nb21T/qaNl+AR4gGd9qZTKjOvM8WwYikXS7ofMFjUyxbA2psM9SlnPwkS/y5tSGVMgC+x4CNugK+QDvVA==","signatures":[{"sig":"MEQCIF83EEYOqNWsxtVwKAHhQt2FuQbTrywND5ggao3jug6MAiANbb9EGAs0bxWFHwmYiHqGzROLhDesVTXyUeRCzPGE1A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":46107},"gitHead":"884ec4f7545be0089f6a0a600a362c5d03b4415c","_npmUser":{"name":"acomarcho","email":"acoxstpd@gmail.com"},"_npmVersion":"10.9.3","description":"A collection of structured prompts for AI-powered development workflows. Use these prompts with coding agents like Cursor, Claude Code, or opencode to systematically build features from idea to implementation.","directories":{},"_nodeVersion":"22.20.0","dependencies":{"prompts":"^2.4.2"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/vibecode_1.0.5_1760681453099_0.056977648062241926","host":"s3://npm-registry-packages-npm-production"}},"1.0.6":{"name":"@acomarcho/vibecode","version":"1.0.6","author":{"name":"acomarcho"},"license":"ISC","_id":"@acomarcho/vibecode@1.0.6","maintainers":[{"name":"acomarcho","email":"acoxstpd@gmail.com"}],"bin":{"vibecode":"bin/cli.js"},"dist":{"shasum":"25ef69db50b6641e6bfc6d96e3c49e634f24b764","tarball":"https://registry.npmjs.org/@acomarcho/vibecode/-/vibecode-1.0.6.tgz","fileCount":8,"integrity":"sha512-sWVJspEvDa/E5fhlJX5RJUQZlZxMbtT2pR5CLbbaOs1DQZhrF5OyYqiTqADS33RwUI7F2w3vPCZ8Iz0BXnMi9Q==","signatures":[{"sig":"MEYCIQCnb20oH24cG76+FBPs6n6U0p6IRC60Srru5x8IKl3PBgIhAOYDI/hhnqTCQU72MWpzgiqp0Bf9pBoCMAMavfcjv70y","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":47098},"gitHead":"5e8c27943d70ab019a52fd5cf04ce0cea63967c5","_npmUser":{"name":"acomarcho","email":"acoxstpd@gmail.com"},"_npmVersion":"10.9.3","description":"A collection of structured prompts for AI-powered development workflows. Use these prompts with coding agents like Cursor, Claude Code, or opencode to systematically build features from idea to implementation.","directories":{},"_nodeVersion":"22.20.0","dependencies":{"prompts":"^2.4.2"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/vibecode_1.0.6_1761108189952_0.4884830943863063","host":"s3://npm-registry-packages-npm-production"}},"1.0.7":{"name":"@acomarcho/vibecode","version":"1.0.7","description":"A collection of structured prompts for AI-powered development workflows. Use these prompts with coding agents like Cursor, Claude Code, or opencode to systematically build features from idea to implementation.","license":"ISC","author":{"name":"acomarcho"},"bin":{"vibecode":"bin/cli.js"},"dependencies":{"prompts":"^2.4.2"},"_id":"@acomarcho/vibecode@1.0.7","_integrity":"sha512-3xzssVTvwiMZPz6Wq12PwVYPfvMVc93X0Kut4BnmBhIYFVZzjHZCgQFWkKz0JXRB/exh/Qjt1f7TYw2qSNRsqg==","_resolved":"/private/var/folders/fr/tm7chnmd6cd6wwz9dck6_tfw0000gn/T/734c8fd124c83fb0bb724e5f3a8c3ede/acomarcho-vibecode-1.0.7.tgz","_from":"file:acomarcho-vibecode-1.0.7.tgz","_nodeVersion":"22.20.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-3xzssVTvwiMZPz6Wq12PwVYPfvMVc93X0Kut4BnmBhIYFVZzjHZCgQFWkKz0JXRB/exh/Qjt1f7TYw2qSNRsqg==","shasum":"b903a19f4ba321399de7604e29e2da14a200f2b3","tarball":"https://registry.npmjs.org/@acomarcho/vibecode/-/vibecode-1.0.7.tgz","fileCount":9,"unpackedSize":58045,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIExQkDWYJROufcDY6thID8C6bjJKXjJfv5gCbFOBlZNyAiEAy86RoFZ/GtByu+liJOXGGLfShZC+JaYN7B9UeZWtMhE="}]},"_npmUser":{"name":"acomarcho","email":"acoxstpd@gmail.com"},"directories":{},"maintainers":[{"name":"acomarcho","email":"acoxstpd@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/vibecode_1.0.7_1764164253616_0.9395664789698481"},"_hasShrinkwrap":false}},"time":{"created":"2025-10-11T00:54:45.263Z","modified":"2025-11-26T13:37:34.038Z","1.0.0":"2025-10-11T00:54:45.547Z","1.0.1":"2025-10-11T01:08:13.491Z","1.0.2":"2025-10-11T01:29:45.888Z","1.0.3":"2025-10-11T01:54:12.745Z","1.0.4":"2025-10-11T11:25:17.370Z","1.0.5":"2025-10-17T06:10:53.291Z","1.0.6":"2025-10-22T04:43:10.129Z","1.0.7":"2025-11-26T13:37:33.834Z"},"author":{"name":"acomarcho"},"license":"ISC","description":"A collection of structured prompts for AI-powered development workflows. Use these prompts with coding agents like Cursor, Claude Code, or opencode to systematically build features from idea to implementation.","maintainers":[{"name":"acomarcho","email":"acoxstpd@gmail.com"}],"readme":"# Vibecoding Prompts\n\nA collection of structured prompts for AI-powered development workflows. Use these prompts with coding agents like Cursor, Claude Code, or opencode to systematically build features from idea to implementation.\n\n\n## 🏃‍♂️ Getting Started\n\nTo add the prompts to your repository, run:\n\n`npx @acomarcho/vibecode`\n\n## 🚀 Quick Start\n\n1. **Create a PRD** - Define your feature requirements\n2. **Break down tasks** - Convert PRD into actionable tasks\n3. **Execute tasks** - Implement each task systematically\n\n---\n\n## 1. PRD Creator\n\n**Purpose**: Create a comprehensive Product Requirements Document by exploring your codebase and defining feature specifications.\n\n### How to Use\n\nCopy and paste this prompt into your coding agent:\n\n```\nUse @prompts/prd-creator.md to create a PRD. What I want is to:\n1. <describe your primary requirement>\n2. <describe your secondary requirement>\n3. <describe any additional requirements>\n```\n\n### Workflow\n\n1. **Initial PRD Creation**: The agent will explore your codebase and create an initial PRD with open questions\n2. **Answer Open Questions**: Review the generated PRD and answer all open questions\n3. **Iterate**: Continue refining until you're satisfied with the PRD\n4. **Final PRD**: The agent will create a final PRD file in `@tasks/<date>-<feature-name>.md`\n\n---\n\n## 2. Task Breakdown\n\n**Purpose**: Convert a completed PRD into specific, actionable implementation tasks.\n\n### How to Use\n\nReset your context, then copy and paste this prompt:\n\n```\nUse @prompts/task-breakdown.md to implement @tasks/<prd-name>.md.\n```\n\n### Workflow\n\n1. **Reset Context**: Start fresh to avoid confusion\n2. **Task Generation**: The agent will read the PRD and break it down into specific tasks\n3. **Review Tasks**: Check that all requirements are covered and tasks are properly scoped\n4. **Iterate**: Refine the task breakdown until you're satisfied\n\n---\n\n## 3. Task Executor\n\n**Purpose**: Implement specific tasks from the task breakdown, one at a time.\n\n### How to Use\n\n**IMPORTANT**: Reset context FOR EACH TASK EXECUTION.\n\n```\nUse @prompts/task-executor.md to implement ONLY task x up to task y from @tasks/<prd-name>.md.\n```\n\n### Workflow\n\n1. **Reset Context**: Always start fresh for each task execution\n2. **Specify Task Range**: Clearly define which tasks to implement (e.g., \"task 1 up to task 3\")\n3. **Implementation**: The agent will implement the specified tasks only\n4. **Verify**: Check that the implementation matches the task requirements\n5. **Repeat**: Move to the next task range with a fresh context\n\n---\n\n## 4. Chain-of-Thought Planners\n\n**Purpose**: Systematic planning tools that help you think through problems before implementation. Use these for general planning tasks, debugging, or when you need to explore multiple solution approaches.\n\n### 4.1 Complete CoT Planner\n\n**Best for**: Complex features, architectural decisions, or situations with multiple valid approaches.\n\n#### How to Use\n\n```\nUse @prompts/complete-cot-planner.md to plan <describe what you want to accomplish>\n```\n\n#### What It Does\n\nGuides the agent through an 8-step comprehensive planning process:\n1. **Analyze Current State** - Deep dive into existing implementation\n2. **Define Target State** - Clarify goals and success criteria\n3. **Identify the Gap** - Determine what's missing or needs change\n4. **Surface Constraints** - Technical, business, and quality limitations\n5. **Explore Approaches** - Generate 2-3 alternative strategies\n6. **Evaluate Trade-offs** - Compare approaches across key criteria\n7. **Select Strategy** - Choose best approach with explicit reasoning\n8. **Outline Action Plan** - Define implementation phases\n\n#### When to Use\n\n- Starting a new feature or significant change\n- Multiple possible implementation approaches exist\n- Working with unfamiliar or complex systems\n- Need to justify technical decisions to others\n- Changes affect multiple components or systems\n\n---\n\n### 4.2 Quick CoT Planner\n\n**Best for**: Small features, bug fixes, refactoring, or straightforward changes.\n\n#### How to Use\n\n```\nUse @prompts/quick-cot-planner.md to plan <describe what you want to accomplish>\n```\n\n#### What It Does\n\nStreamlined 3-step planning process:\n1. **Gather Context** - Read relevant files and understand current state (mandatory)\n2. **Define Changes** - Identify what needs to change and the straightforward approach\n3. **Action Steps** - Outline implementation sequence with verification\n\n#### When to Use\n\n- Small feature additions with clear requirements\n- Bug fixes with identifiable root causes\n- Refactoring with an obvious approach\n- Updates to existing functionality (not new architectures)\n- Changes affecting 1-3 files or a single module\n\n#### When to Escalate\n\nSwitch to complete-cot-planner if you discover:\n- Multiple valid approaches with unclear trade-offs\n- Changes affecting 4+ files or multiple modules\n- Significant architectural decisions required\n- High risk of breaking existing functionality\n\n---\n\n## 📁 File Structure\n\n```\nvibecode/\n├── prompts/\n│   ├── prd-creator.md           # Creates PRDs from requirements\n│   ├── task-breakdown.md        # Breaks PRDs into tasks\n│   ├── task-executor.md         # Implements specific tasks\n│   ├── complete-cot-planner.md  # Comprehensive 8-step planning\n│   └── quick-cot-planner.md     # Streamlined 3-step planning\n├── tasks/                       # Generated PRDs and task breakdowns\n└── README.md                   # This file\n```\n\n---\n\n## 💡 Best Practices\n\n- **Always reset context** when moving between different prompt types\n- **Be specific** in your requirements for better PRD quality\n- **Review thoroughly** at each stage before proceeding\n- **Iterate** until you're satisfied with each output\n- **Follow the exact prompt format** for best results\n- **Use CoT planners** when you need to think through approaches before committing to implementation\n- **Start with quick-cot-planner** for simple tasks, escalate to complete-cot-planner if complexity emerges\n\n---\n\n## 🔄 Workflow Examples\n\n### Main Workflow: PRD → Tasks → Implementation\n\n1. **Define Feature**: `Use @prompts/prd-creator.md to create a PRD. What I want is to: 1. Add user authentication, 2. Create login/signup forms, 3. Add session management`\n\n2. **Break Down Tasks**: `Use @prompts/task-breakdown.md to implement @tasks/2025-10-11-user-authentication.md.`\n\n3. **Execute Tasks**:\n   - `Use @prompts/task-executor.md to implement ONLY task 1 up to task 2 from @tasks/2025-10-11-user-authentication.md.`\n   - `Use @prompts/task-executor.md to implement ONLY task 3 up to task 4 from @tasks/2025-10-11-user-authentication.md.`\n\nRepeat until all tasks are complete!\n\n### Planning Workflow: Think Before Acting\n\n**For complex problems:**\n```\nUse @prompts/complete-cot-planner.md to plan implementing a caching layer with Redis that integrates with our existing API endpoints\n```\n\n**For quick fixes:**\n```\nUse @prompts/quick-cot-planner.md to plan fixing the email validation bug in the signup form\n```\n\n**Combined workflow:**\n1. Use quick-cot-planner to explore a bug fix\n2. If complexity emerges, switch to complete-cot-planner\n3. Once plan is solid, create a PRD if needed or implement directly\n\n---\n","readmeFilename":"README.md"}