From AI chaos to clean code

Andrii Poluosmak — Fri, 17 Oct 2025 11:36:40 +0000

Hey Developers!

I've been working on something that makes building with Claude Code way easier, and I wanted to share it with you.

THE PROBLEM

I love using Claude Code for development, but I found myself repeating the same setup tasks over and over:

Creating new projects from scratch
Setting up the same boilerplate
Configuring TypeScript, Vue, and other tools manually
Configuring AI rules

It was getting tedious, and I thought: "There has to be a better way."

THE SOLUTION: Vibe Code Kit Plugin

I built Vibe Code Kit - a plugin for Claude Code that gives you production-ready starter kits with just one command.

GETTING ACCESS

First, get access to the private GitHub repository at:
https://vibecodekit.dev/

Once you have access, installation is super simple:

/plugin marketplace add croffasia/vibecodekit-core

HOW TO START A NEW PROJECT

Run the command:

/vck:init:starter:vue-spa

Start building! Just tell Claude what you want:

"Add a user authentication page"
"Create a dashboard with charts"
"Build a blog post editor"

Or use planning mode for complex features:

/plan Feature: "Add payment integration with Stripe"

That's it! Claude will build your project while you focus on the business logic.

WHAT YOU GET OUT OF THE BOX

Production-ready configuration (ESLint, Stylelint, TYpescript, Prettier, Husky Git hooks)
Vue3 with modular architecture
Docker container ready to deploy
Multi-agent workflows for planning and execution
Built-in AI rules for your entire tech stack
Zero setup time - just start coding

THE SECRET SAUCE: AI RULES

Here's what makes Vibe Code Kit different: it comes with pre-configured AI rules for your entire tech stack. These rules teach Claude:

What it SHOULD do (best practices, patterns, conventions)
What it SHOULD NOT do (anti-patterns, common mistakes)
How to write maintainable, high-quality code

The result? You get clean, production-ready code that's actually maintainable, not just "it works on my machine" code.

MULTI-AGENT WORKFLOWS

Vibe Code Kit includes multi-agent workflows that break down complex tasks:

Planning agent: Breaks down your feature into steps
Execution agent: Implements the plan
Review agent: Ensures quality

It's like having a senior dev pair-programming with you.

From idea to deployed app in minutes, not hours.

WHAT'S NEXT?

I'm planning to add more starter kits:

React + TypeScript
Node.js API templates
Full-stack setups
And more based on what people need

WHY I'M SHARING THIS

I believe the best tools come from solving your own problems.

Want to try it? Get access at https://vibecodekit.dev/ and let me know what you think!

Stop AI from Writing Random Code That Doesn't Fit Your Codebase 🤖

Andrii Poluosmak — Tue, 19 Aug 2025 19:35:17 +0000

Honest question: Do you also give AI minimal info and expect magic? 🪄

I've been coding for 20+ years, and here's what I've learned about AI-generated code: it works great... until it doesn't.

Sure, AI can pump out working features in minutes. The tests pass, stakeholders are happy, you ship to production. Everyone's celebrating the "10x developer" moment.

Then three months later, you need to modify that feature. Or fix a bug. Or add a new requirement.

That's when the real pain starts.

Nobody on your team understands how the AI code actually works. The logic is scattered across files with no clear pattern. There are mysterious functions that seem important but have zero documentation. The architecture doesn't match anything else in your codebase.

What seemed like a productivity win becomes technical debt that haunts your team for months.

The worst part? This is happening everywhere. Teams are shipping AI code fast, then drowning in maintenance hell later. But everyone's so focused on "ship faster with AI" that nobody talks about what happens next.

There has to be a better way to work with AI - one that doesn't create unmaintainable code bombs.

AI Code = Technical Debt?

The root cause? We're treating AI like a search engine instead of a team member.

Think about it: when you onboard a new developer, you don't just say "add authentication" and walk away. You give them:

Your existing patterns to follow
Architecture documentation
Reference implementations to study
Testing standards and practices
Code review guidelines

But with AI? We type "add user authentication" and somehow expect it to magically understand our 5-year-old codebase with its custom patterns, legacy decisions, and undocumented quirks.

No wonder the resulting code becomes unmaintainable! AI writes in a vacuum, without understanding how its code fits into your larger system.

The solution isn't to avoid AI - it's to give AI the same context you'd give a senior developer.

Enter the PRP Method

After refactoring one too many AI-generated messes, I built something that changes the game completely.

Instead of vague prompts, I created a system that gives Claude Code CLI everything it needs to write code that actually fits your project.

Here's how it works:

Phase 1: Smart Analysis 🧠

When you describe a task, the system doesn't just jump to coding:

Analyzes your request for missing context
Asks clarifying questions if needed
Studies your codebase to understand patterns
Researches external docs when your codebase doesn't have examples

Phase 2: Context Assembly 📋

The system builds a comprehensive spec that includes:

Your exact naming conventions
Reference implementations to mirror
Integration points with existing code
Your testing patterns and requirements
Validation commands specific to your project

Phase 3: Claude Code Magic ✨

With the complete context, Claude Code CLI now knows:

How you structure components
What libraries you prefer
Your error handling patterns
Your file organization
Your commit message style

📊 Real Results That Actually Matter

Here's what changed when I started using this approach:

Before PRP:

⏰ 15 minutes from idea to implementation
😤 Another 1-2 hours refactoring and bug fixing
🔄 Constant context switching between AI and manual fixes
🐛 Code reviews always caught style issues

After PRP with Claude Code:

⚡ 15 minutes from idea to implementation
✅ Code matches patterns immediately
🎯 One-pass development with built-in validation
🚀 Code reviews focus on logic, not style

The difference is dramatic. One developer put it perfectly:

"3 prompts and 15 minutes, ready for feedback on something I would have agonized over for 2 hours."

🔧 The Technical Magic Behind It

The PRP Generator uses a three-agent approach with Claude Opus:

Surface Discovery Agent → Validates task completeness and identifies missing business logic

Codebase Research Agent → Deep pattern discovery and internal architecture analysis

External Research Agent → Comprehensive external documentation and best practices research

This runs on Claude Opus for intelligent planning, then hands detailed specifications to Claude Code CLI for flawless implementation.

Getting Started (It's Easier Than You Think)

I open-sourced the PRP Generator because this approach could change how we all work with AI.

# Clone the repository
git clone https://github.com/croffasia/claude-code-prp-generator
cd claude-code-prp-generator

# Copy commands to your Claude Code setup
cp -r claude/commands ~/.claude/commands/

# Copy agents to your Claude Code setup
cp -r claude/agents ~/.claude/agents/

# Copy templates to your project  
cp -r PRPs/ ./PRPs/

# Generate a PRP
/generate-prp Add user authentication with OAuth2

# Execute with Claude Code
/execute-prp @PRPs/my-feature.md

⭐ Don't forget to star the repo if this helps you! It really motivates me to keep improving the tool.

The tool works with any programming language by automatically discovering your project's patterns.

🎯 Why This Actually Matters

This isn't just about faster coding. It's about solving the context gap between human intent and AI execution.

Teams that figure out how to give Claude Code proper context will have a massive advantage:

🚀 Ship faster without sacrificing quality
🎨 Maintain consistent architecture
👥 Onboard AI like a proper team member
🔧 Avoid technical debt from random AI code

🔮 The Future is Context-Rich AI

I believe we're at an inflection point. Claude Code CLI and similar tools are incredibly powerful, but most of us are using them wrong.

The PRP method is my contribution to that future - where AI doesn't just generate code, but generates code that belongs.

Try It Yourself 🚀

Want to stop refactoring AI code? Check out the PRP Generator on GitHub and let me know what you think!

Follow me for more insights on AI-assisted development and systematic approaches to coding with Claude Code CLI 👋

What's your biggest AI coding frustration? Drop it in the comments - I read every single one! 💬

DEV Community: Andrii Poluosmak