Project Starter

Interactive CLI script to scaffold a new project with an AI coding agent, agency agents, and MCP configuration.

Usage

chmod +x init-project.sh
./init-project.sh

Follow the on-screen menus to configure your setup:

1. AI coding agent — Select which agent to use
2. Installation — Choose whether to install the agent if not already present
3. Agency agents — Optionally install predefined agency agents
4. Config file — Generate a config file for the selected agent with chosen MCPs
5. MCP selection — Choose which MCP servers to add (Astro, Nuxt, Nuxt UI, Supabase, Neon)
6. Framework init — Optionally initialize selected frameworks (Astro, Nuxt, Nuxt UI) in the current directory

Navigate menus with arrow keys. In multi-select menus, press space to toggle items and enter to confirm.

Requirements

• bash
• curl
• git
• jq

The script will check for missing tools and prompt you to install them before proceeding.

What It Does

• Installs the selected AI coding agent via the official installer
• Clones and sets up agency-agents
• Generates a config file (e.g. opencode.json) with MCP server configurations (Astro, Nuxt, Nuxt UI, Supabase, Neon)
• Initializes web frameworks in the current directory:
  • Astro — npm create astro@latest (scaffolded into a temp dir, then moved)
  • Nuxt — npm create nuxt@latest
  • Nuxt UI — Installs Nuxt (if not already), adds @nuxt/ui and tailwindcss, configures nuxt.config.ts, and creates app/assets/css/main.css
• Displays manual setup instructions for backend services:
  • Supabase — Visit supabase.com to create a project
  • Neon — Visit neon.tech to create a project

Project Definition Wizard

The WIZARD.md file guides an AI coding agent through defining your project by asking targeted questions and generating a setup/ directory with living documentation files.

How to Use

Point your AI agent to WIZARD.md — it will walk you through questions about your project and create the setup/ folder automatically.

Generated Files

File	Covers
project-overview.md	Name, description, platforms, audience, core features
architecture.md	Pattern, frameworks, state management, deployment, integrations
security.md	Authentication, rate limiting, encryption, compliance, secrets
api.md	API style, endpoints, versioning, request/response patterns
data-model.md	Database, entities, relationships, caching
pages.md	Routes, navigation, auth-gated pages, layouts, localization
design-system.md	UI library, colors, typography, accessibility, brand guidelines
quality-ops.md	Testing, CI/CD, monitoring, environments

These files are maintained throughout the project lifecycle — the agent updates them whenever architecture, scope, or decisions change.

License

MIT