Skip to main content

A CLI tool to scaffold Vibe Coding projects

Project description

๐ŸŽธ create-vibe-app

Scaffold AI-friendly project structures for Vibe Coding โ€“ a methodology that helps AI agents work more effectively on your codebase.

โœจ What is Vibe Coding?

Vibe Coding is a development approach where:

  • AI agents handle implementation based on clear structures
  • Knowledge compounds through wiki and experience recording
  • Complexity-based routing ensures the right workflow for each task

๐Ÿ“ฆ Installation

pip install create-vibe-app

๐Ÿš€ Usage

create-vibe-app my-project
cd my-project
code .

Then in your AI assistant:

"Read MAIN.md, then help me build [your idea]"

๐Ÿ“ Generated Structure

my-project/
โ”œโ”€โ”€ MAIN.md           # Project entry point
โ”œโ”€โ”€ agent/            # AI agent definitions
โ”‚   โ”œโ”€โ”€ phase-router.md
โ”‚   โ”œโ”€โ”€ requirement-manager.md
โ”‚   โ”œโ”€โ”€ design-manager.md
โ”‚   โ”œโ”€โ”€ implementation-executor.md
โ”‚   โ””โ”€โ”€ experience-depositor.md
โ”œโ”€โ”€ skill/            # Reusable workflow skills (10)
โ”œโ”€โ”€ wiki/             # Project knowledge base
โ”œโ”€โ”€ requirement/      # Task tracking
โ”œโ”€โ”€ mcp/              # External tool configs
โ”œโ”€โ”€ code/             # Your source code
โ””โ”€โ”€ reference/        # Reference implementations

๐Ÿ”„ Workflow

User Task โ†’ Analyze Intent โ†’ Detect Complexity โ†’ Route โ†’ Update Knowledge
                                โ†“
                    Simple: Direct execution
                    Medium: Requirement โ†’ Design โ†’ Implement
                    Complex: Full flow + User confirmation

๐Ÿค Contributing

Issues and PRs welcome!

๐Ÿ“„ License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

create_vibe_app-0.1.0.tar.gz (19.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

create_vibe_app-0.1.0-py3-none-any.whl (26.9 kB view details)

Uploaded Python 3

File details

Details for the file create_vibe_app-0.1.0.tar.gz.

File metadata

  • Download URL: create_vibe_app-0.1.0.tar.gz
  • Upload date:
  • Size: 19.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.2

File hashes

Hashes for create_vibe_app-0.1.0.tar.gz
Algorithm Hash digest
SHA256 05d546ecd9b956a353ecc53e4456b2750b8eda6759859afe4b3206a462da3559
MD5 ba01cd71ecb1d7704388db4e24ebb3bc
BLAKE2b-256 4b01de713f6553971512345a02c060907376c9dd62be9ad02660dbe78000ed89

See more details on using hashes here.

File details

Details for the file create_vibe_app-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for create_vibe_app-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 701ba85037ff911ad3452ba491dc954f9951bc92d7ff886f455fc7c0c31a2e68
MD5 2ea7c23969703959757532277c82011d
BLAKE2b-256 3a0de2a6299835a371bf67fcf54c7a943d640b1ccedaebaeb65a2790d751c90d

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page