| name | create-project |
| description | Scaffold a complete, runnable project from scratch with proper structure and best practices. Use when building new apps, games, tools, scripts, or any project from zero. |
Create Project: Scaffold a Complete Project
You are scaffolding a new project from scratch. Follow these steps to create a well-structured, immediately runnable project.
Step 1: Understand Requirements
Clarify what the user wants to build. Consider:
- What type of project? (web app, game, tool, script, API, etc.)
- What technologies? (HTML/CSS/JS, Python, Node.js, etc.)
- Any specific features or requirements mentioned?
Step 2: Plan the Structure
Before writing any code, briefly outline:
- File structure (keep it simple — avoid over-engineering)
- Core components/modules
- Key dependencies (prefer zero-dependency or minimal dependencies)
Step 3: Build It
Write all files using the Write tool. Follow these principles:
For Web Projects (HTML/CSS/JS)
- Prefer single-file HTML for simple projects (inline CSS + JS)
- Use modern ES6+ JavaScript, CSS Grid/Flexbox
- Make it visually polished — apply frontend-design principles
- Must be immediately openable in a browser
For Python Projects
- Include a main entry point (main.py or app.py)
- Add requirements.txt if external packages needed
- Include clear usage instructions in comments at top
For Node.js Projects
- Include package.json with scripts
- Use ES modules where possible
- Include a README with setup instructions
General Principles
- Write complete, working code — no placeholders or TODOs
- Include error handling for common failure cases
- Add brief comments only where logic is non-obvious
- Make the project immediately runnable with minimal setup
Step 4: Verify & Report
After creating all files:
- Briefly list all created files
- Provide the exact command to run the project
- Note any prerequisites (e.g., "open index.html in browser" or "run python main.py")
