JSPM

create-agentic-project

1.0.2
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 4
  • Score
    100M100P100Q37646F
  • License MIT

A comprehensive boilerplate for starting new projects with AI agent collaboration

Package Exports

  • create-agentic-project

Readme

Create Agentic Project

A comprehensive project generator for creating new projects with AI agent collaboration framework. This tool provides everything needed to go from idea to production MVP with structured agent collaboration.

🚀 Quick Start

Create a New Project

# Using npx (recommended)
npx create-agentic-project my-awesome-project

# Or install globally
npm install -g create-agentic-project
create-agentic-project my-awesome-project

Interactive Mode

npx create-agentic-project
# Follow the interactive prompts to configure your project

Command Line Options

npx create-agentic-project my-project \
  --template standard \
  --skip-install \
  --skip-git \
  --dry-run

📋 Available Templates

Standard (Default)

Full-stack application with:

  • Frontend: Next.js 15.5+ with TypeScript
  • Backend: Node.js with Express 5.1+
  • Database: PostgreSQL with Prisma 6.14+
  • Infrastructure: Terraform + Vercel/AWS
  • Complete agent collaboration framework

API Only

Backend-focused template with:

  • API Server: Node.js with TypeScript
  • Database: PostgreSQL with Prisma
  • Infrastructure: Cloud-ready deployment
  • Developer and DevOps agent guides

Frontend Only

Frontend-focused template with:

  • Web App: Next.js 15.5+ with TypeScript
  • UI Components: Tailwind CSS 4.1+
  • Testing: Vitest 3.2+ + Playwright
  • Product Manager and QA agent guides

🤖 AI Agent Collaboration

Once your project is created, start with this prompt:

You are a delivery manager on a new project [PROJECT_NAME], please drive it end to end

Agent Workflow

  1. 🎯 Delivery Manager: Project orchestration and task assignment
  2. 📋 Product Manager: Requirements gathering and PRD creation
  3. 🏗️ Software Architect: System design and technical decisions
  4. 💻 Developer: Feature implementation and code delivery
  5. 🔍 QA Engineer: Testing and quality assurance
  6. ⚙️ DevOps Engineer: Infrastructure and deployment

📁 Generated Project Structure

your-project/
├── docs/                          # Complete documentation system
│   ├── README.md                  # Documentation hub
│   ├── DM-ONBOARDING-PROMPT.md   # Delivery manager guide
│   ├── PROJECT-STATUS.md          # Real-time project status
│   ├── agents/                    # Agent-specific guides
│   ├── planning/                  # Project management
│   └── architecture/              # System design
├── packages/                      # Monorepo packages
│   ├── api/                      # Backend API
│   ├── web/                      # Frontend application
│   └── shared/                   # Shared libraries
├── infrastructure/               # Infrastructure as Code
├── scripts/                     # Automation scripts
└── BOILERPLATE-GUIDE.md         # Complete usage guide

🛠️ Features

📊 Project Management

  • Work Breakdown Structure: 8-milestone delivery framework
  • Task Templates: Standardized task creation and tracking
  • Quality Gates: Built-in review and approval processes
  • Progress Tracking: Real-time status and milestone management

🏗️ Technical Foundation

  • Monorepo Structure: Organized code with pnpm workspaces
  • TypeScript: Full type safety across frontend and backend
  • Testing Strategy: Complete testing pyramid implementation
  • Infrastructure as Code: Terraform templates and deployment scripts

📚 Documentation System

  • Living Documentation: Always current, cross-referenced docs
  • Agent Guides: Role-specific instructions and workflows
  • Architecture Documentation: System design and technical decisions
  • Process Documentation: Proven workflows and best practices

🔄 Quality Assurance

  • Testing Pyramid: Unit (70%) → Integration (20%) → E2E (10%)
  • Code Review Process: Structured review and approval workflow
  • Continuous Integration: Automated testing and deployment
  • Quality Metrics: Comprehensive quality tracking and reporting

📖 Command Line Interface

Options

  • --template <name>: Choose template (standard, api-only, frontend-only)
  • --skip-install: Skip dependency installation
  • --skip-git: Skip git repository initialization
  • --dry-run: Preview what would be created without creating it
  • --yes: Skip interactive prompts and use defaults

Examples

# Create with specific template
npx create-agentic-project my-api --template api-only

# Preview without creating
npx create-agentic-project my-project --dry-run

# Skip installation and git setup
npx create-agentic-project my-project --skip-install --skip-git

# Non-interactive mode
npx create-agentic-project my-project --yes

🎯 Success Factors

1. Clear Agent Roles

Each agent has well-defined responsibilities and standardized prompts for consistent collaboration.

2. Structured Process

Proven workflows and quality gates ensure consistent delivery and quality.

3. Living Documentation

Documentation that stays current and provides clear guidance for all decisions.

4. Quality Focus

Built-in quality processes prevent defects and ensure high-quality delivery.

5. Automation

Scripts and templates reduce manual work and ensure consistency.

🔧 Development

Setup

git clone https://github.com/augment-code/create-agentic-project.git
cd create-agentic-project
pnpm install

Build

pnpm build

Test

# Run tests
pnpm test

# Test CLI locally
pnpm test:cli

# Test with dry run
node dist/cli.js test-project --dry-run

Local Development

# Link for local testing
npm link

# Test locally
create-agentic-project test-project

📦 Publishing

Prerequisites

  • NPM account (sign up at npmjs.com)
  • Access to publish packages

Publishing Steps

1. Prepare for Publishing

# Ensure everything is built and tested
pnpm build
pnpm test

# Verify package contents
npm pack --dry-run

2. Login to NPM

# Login to your NPM account
npm login
# Enter username, password, email, and 2FA code if enabled

3. Check Package Name Availability

# Verify the package name is available
npm view create-agentic-project
# If it returns an error, the name is available

4. Publish

# Publish the package
npm publish

# For first-time publishing, you may need:
npm publish --access public

5. Verify Publication

# Check it's published successfully
npm view create-agentic-project

# Test the published package
npx create-agentic-project@latest test-project --dry-run

Alternative Publishing Options

If Package Name is Taken

# Option 1: Use scoped package
# Update package.json name to: "@your-username/create-agentic-project"
npm publish --access public

# Option 2: Use different name
# Update package.json name to: "create-agentic-app" or similar
npm publish

Version Updates

# Update version
npm version patch  # or minor, major

# Build and publish
pnpm build
npm publish

Publishing Checklist

  • All tests passing (pnpm test)
  • Build successful (pnpm build)
  • Package name available or scoped
  • Logged into NPM (npm login)
  • Verified package contents (npm pack --dry-run)
  • Published successfully (npm publish)
  • Tested published package (npx create-agentic-project@latest)

Post-Publishing

Once published, users can create projects with:

npx create-agentic-project my-project

📄 License

MIT License - see LICENSE file for details.

Ready to build your next project with AI agent collaboration? Start with npx create-agentic-project and let the agents guide you to success!