Summary

This repository documents the "Vibe Coding" practice using Claude Code to build an AI comic drama generation platform from scratch. It targets developers and researchers interested in AI-assisted software development, showcasing a full lifecycle from tech selection and AI-driven coding to UI optimization and iterative feature development, aiming to accelerate development through natural language interaction.

How It Works

The project implements Andrej Karpathy's "Vibe Coding" concept, emphasizing natural language-driven, iterative development where AI generates code based on descriptive prompts. It leverages Claude Code with various "Skills" (plugins) to automate tasks. The workflow involves AI-driven tech selection, code generation via subagents, automated Git commits, and iterative refinement using screenshots and natural language feedback for bug fixes and UI/UX redesigns. SPEC (OpenAPI Specification) is used for machine-understandable interface definitions.

Quick Start & Requirements

This project demonstrates a development process rather than a single runnable application. The core requirement is access to Claude Code and its plugin system. Key skills used, installable via Claude Code's official plugin market or npx skills add commands, include:

• superpowers: AI programming agent framework.
• frontend-design: React + Tailwind UI generation.
• planning-with-files: Persistent Markdown planning.
• skill-creator: Claude Code skill development.
• ui-ux-pro-max: Advanced AI UI/UX design.
• Other skills like notebooklm, best-minds, find-skills, and built-in simplify are also utilized. Setup involves installing these specific skills within the Claude Code environment.

Highlighted Details

• AI-Driven Full-Stack Development: Demonstrates AI generating a Next.js/SQLite platform from a natural language prompt, including tech selection, project initialization, feature implementation, and Git commits.
• Iterative Refinement Loop: Utilizes screenshots and natural language feedback to guide AI in fixing bugs and optimizing UI/UX, significantly reducing manual effort.
• Specialized AI Skills: Integrates numerous specialized skills for tasks like advanced UI/UX design (ui-ux-pro-max), TDD (superpowers), and persistent planning (planning-with-files).
• Rapid Prototyping: Initial version of the AI comic drama platform developed in approximately 45 minutes.

Maintenance & Community

This repository serves as a record of the author's AI programming process. Specific details regarding the maintenance, contribution model, or community channels for this particular documentation repository are not provided in the README. The linked project twwch/AIComicBuilder would have its own maintenance status.

Licensing & Compatibility

The README does not specify a license for the twwch/vibe-coding repository itself. The underlying tools and skills may have their own licenses, and compatibility for commercial use or closed-source linking would depend on those individual components.

Limitations & Caveats

The "Vibe Coding" approach is heavily reliant on the capabilities and stability of the AI model (Claude Code) and its associated skills. Success depends on effective natural language prompting and the AI's ability to interpret context, including visual feedback from screenshots. The process described is experimental and may require significant human oversight and iteration, especially for complex or novel requirements. The specific skills used might have their own limitations or dependencies.