### CI/CD Integration for AI Dev Standards Setup

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/docs/INSTALLATION-AND-UPDATES.md

A GitHub Actions workflow example demonstrating how to set up AI Dev Standards in a CI/CD pipeline. It includes cloning the repository, running the setup script, performing a health check, and checking for updates.

```yaml
# .github/workflows/setup.yml
- name: Setup ai-dev-standards
  run: |
    git clone https://github.com/your-org/ai-dev-standards.git ~/ai-dev-standards
    bash ~/ai-dev-standards/setup-project.sh
    ai-dev doctor

- name: Check for updates
  run: ai-dev check-updates --silent
```

--------------------------------

### New Project Setup with AI Dev Standards Bootstrap

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/docs/BOOTSTRAP.md

This example demonstrates how to set up a brand new project using AI Dev Standards. It includes creating a project directory, initializing npm, and then bootstrapping the AI Dev Standards CLI.

```bash
# Create new project
mkdir my-app
cd my-app
npm init -y

# Bootstrap (installs & syncs everything)
npx @ai-dev-standards/bootstrap

# Start coding with all best practices!
```

--------------------------------

### Post-Cloning Project Setup

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/docs/INSTALLATION-AND-UPDATES.md

Steps to perform after cloning a project that uses AI Dev Standards, including checking the installation and running the setup script if necessary.

```bash
# Check installation
ai-dev doctor

# Install if missing
bash ~/ai-dev-standards/setup-project.sh
```

--------------------------------

### Example: Supabase Setup Configuration

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/docs/CLI-REFERENCE.md

Demonstrates the configuration generated after running `ai-dev setup supabase`, including installed packages, created files for client/server logic, and updated environment variables.

```text
🎯 Supabase Setup

? Supabase Project URL: https://xyz.supabase.co
? Supabase Anon Key: eyJhbGc...
? Enable auth helpers? Yes
? Enable real-time subscriptions? Yes

✅ Supabase configured!

📦 Installed:
  • @supabase/supabase-js
  • @supabase/auth-helpers-nextjs

📝 Created:
  • lib/supabase/client.ts
  • lib/supabase/server.ts
  • lib/supabase/middleware.ts

🔧 Updated:
  • .env.local (added credentials)
  • .env.example (added template)

📚 Next steps:
  1. Run: npm install
  2. Use in your code: import { supabase } from '@/lib/supabase/client'
```

--------------------------------

### Initialize Example App Project

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/skills/technical-writer/SKILL.md

Sets up a new project for the todo application using the 'create-example-app' command. It includes installing dependencies and starting the development server.

```bash
npx create-example-app my-todo-app
cd my-todo-app
npm install
npm run dev
```

--------------------------------

### Supabase Quick Start: Install, Initialize, Authenticate, Query, Subscribe

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/skills/supabase-developer/README.md

This snippet demonstrates the basic steps to get started with Supabase using their JavaScript client library. It covers installation, client initialization with environment variables, user sign-up, querying data from a 'posts' table, and setting up a real-time subscription for changes on the 'posts' table.

```typescript
// 1. Install
npm install @supabase/supabase-js

// 2. Initialize client
import { createClient } from '@supabase/supabase-js'

const supabase = createClient(
  process.env.NEXT_PUBLIC_SUPABASE_URL!,
  process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!
)

// 3. Authenticate
const { data, error } = await supabase.auth.signUp({
  email: 'user@example.com',
  password: 'password',
})

// 4. Query data
const { data: posts } = await supabase
  .from('posts')
  .select('*')
  .eq('published', true)

// 5. Real-time subscription
supabase
  .channel('posts-channel')
  .on('postgres_changes', {
    event: '*', // Listen to all events (INSERT, UPDATE, DELETE)
    schema: 'public',
    table: 'posts'
  }, (payload) => {
    console.log('Change:', payload)
  })
  .subscribe()

```

--------------------------------

### AI Dev Standards Bootstrap Example Output

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/docs/BOOTSTRAP.md

This is an example of the output you can expect when running the AI Dev Standards bootstrap command. It shows the steps taken, detected versions, and actions performed during the setup process.

```bash
$ npx @ai-dev-standards/bootstrap

🚀 AI Dev Standards Bootstrap

✅ Node.js v20.10.0 detected

✅ ai-dev CLI already installed

📋 Project not initialized. Setting up auto-sync...

  Created: .ai-dev.json
  Created: .git/hooks/post-merge
  Added to .gitignore: .ai-dev.json
  Added to .gitignore: .ai-dev-cache/

🔄 Running initial sync...

📦 Available Updates:

  • skill: api-designer
    Design REST/GraphQL APIs
  • skill: frontend-builder
    Build React/Next.js UIs
  • mcp: supabase-manager
    Manage Supabase projects
  • config: .cursorrules
    Latest best practices

🔧 Applying updates...

✅ Sync complete!

📊 Summary:

  • 2 skills added
  • 1 MCPs configured
  • 1 config files updated

✅ Auto-sync enabled!

📚 What happens now:

  • Auto-sync runs after every git pull
  • Skills, MCPs, and configs stay up-to-date
  • Run manually: ai-dev sync
  • Update specific: ai-dev update skills

✨ Your project is now auto-synced with ai-dev-standards!
```

--------------------------------

### Install Playwright E2E Testing

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/templates/testing/playwright-e2e-setup.md

Installs Playwright and sets up the initial project structure, including configuration files and example tests. Alternatively, it shows how to install Playwright and browsers manually.

```bash
npm init playwright@latest
```

```bash
npm install --save-dev @playwright/test
npx playwright install
```

--------------------------------

### Initiate Supabase Setup via CLI

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/docs/QUICK-START.md

This bash command starts an interactive setup process for Supabase integration with the ai-dev standards. It typically handles package installation, client code creation, and .env file updates.

```bash
ai-dev setup supabase
```

--------------------------------

### Existing Project Setup with AI Dev Standards Bootstrap

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/docs/BOOTSTRAP.md

This example shows how to integrate AI Dev Standards into an existing project. The bootstrap command adds auto-sync capabilities and updates configurations without disrupting existing code.

```bash
# Navigate to existing project
cd my-existing-app

# Bootstrap (adds auto-sync, doesn't break existing code)
npx @ai-dev-standards/bootstrap

# Done! Your project now auto-syncs
```

--------------------------------

### Document AI Dev Standards Setup

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/INTEGRATION-USAGE.md

Creates a documentation file (`AI-DEV-STANDARDS-SETUP.md`) to record the setup details of the AI Dev Standards. It includes placeholders for date, version, configuration, and installed resources.

```bash
cat > AI-DEV-STANDARDS-SETUP.md << 'EOF'
# AI-Dev-Standards Setup

**Date:** [Date]
**Version:** [Version from .ai-dev.json]

## Configuration
- Template: [minimal/saas/ai-rag/existing]
- Auto-sync: [enabled/disabled]
- Brain-MCP: [enabled/disabled]

## Resources Installed
- Skills: 64
- MCPs: 50
- Components: 72
- Integrations: 28
- Tools: 24
- Total: 238 core resources

## Team Guidelines
[Add your team's specific guidelines here]
EOF
```

--------------------------------

### Manual Auto-Sync Setup

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/docs/AUTO-SYNC-GUIDE.md

Manually sets up the auto-sync system by cloning the repository, installing the CLI, initializing sync in the project, and optionally setting up a post-merge git hook.

```bash
# 1. Clone ai-dev-standards
git clone <repo-url> ~/ai-dev-standards

# 2. Install CLI
cd ~/ai-dev-standards/CLI
npm install && npm link

# 3. Navigate to your project
cd /your/project

# 4. Initialize
ai-dev sync

# 5. Set up git hook (optional)
cat > .git/hooks/post-merge << 'EOF' 
#!/bin/bash
ai-dev sync --auto
EOF
chmod +x .git/hooks/post-merge
```

--------------------------------

### Example: Stripe Setup Configuration

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/docs/CLI-REFERENCE.md

Shows the output and configuration details after running `ai-dev setup stripe`, including installed packages, created files for client/checkout/webhooks, and updated environment variables and API routes.

```text
🎯 Stripe Setup

? Stripe Secret Key: sk_test_...
? Stripe Publishable Key: pk_test_...
? Stripe Webhook Secret: whsec_...
? Enable Stripe Checkout? Yes
? Enable Customer Portal? Yes

✅ Stripe configured!

📦 Installed:
  • stripe

📝 Created:
  • lib/stripe/client.ts
  • lib/stripe/checkout.ts
  • lib/stripe/webhooks.ts
  • app/api/webhooks/stripe/route.ts

🔧 Updated:
  • .env.local
  • next.config.js (added webhook route)

📚 Next steps:
  1. Run: npm install
  2. Test webhook: stripe listen --forward-to localhost:3000/api/webhooks/stripe
```

--------------------------------

### Install ai-dev CLI

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/docs/CLI-QUICKSTART.md

Install the ai-dev CLI globally using npm or use npx for immediate execution without installation. This is the first step to using the CLI's features.

```bash
npm install -g @ai-dev-standards/cli
```

```bash
npx @ai-dev-standards/cli --help
```

--------------------------------

### Clone and Initialize ai-dev-standards Project

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/docs/INSTALLATION-AND-UPDATES.md

This snippet shows the initial steps to clone the ai-dev-standards repository and then use its setup script to initialize a new project. It assumes you are in your home directory for cloning and then navigate to your project directory to run the setup script.

```bash
# Clone ai-dev-standards
cd ~
git clone https://github.com/your-org/ai-dev-standards.git

# Initialize a project
cd /path/to/your/project
bash ~/ai-dev-standards/setup-project.sh
```

--------------------------------

### Install Example CLI

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/skills/technical-writer/SKILL.md

Command to install the example CLI tool globally using npm. Includes verification step.

```bash
npm install -g @example/cli
```

```bash
example --version
```

--------------------------------

### Run Project Setup Script (Bash)

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/docs/TROUBLESHOOTING.md

Executes the setup script for a new or existing project. This script installs the CLI if necessary, sets up the project, runs automatic analysis, and provides recommendations. It requires navigating to the project directory first.

```bash
cd /your/new/project
bash ~/ai-dev-standards/setup-project.sh
```

--------------------------------

### Install and Build Streaming Setup MCP Server (Bash)

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/mcp-servers/streaming-setup-mcp/README.md

Installs dependencies and builds the Streaming Setup MCP Server using npm. This command navigates to the project directory, installs packages, and then compiles the project.

```bash
cd mcp-servers/streaming-setup-mcp
npm install && npm run build
```

--------------------------------

### Real-World Workflow: Build SaaS Dashboard with ai-dev CLI

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/docs/CLI-QUICKSTART.md

A step-by-step example of building a SaaS dashboard application. It covers project initialization, adding components, setting up integrations, checking health, and running the application.

```bash
# 1. Create project
ai-dev init saas-starter dashboard-app \
  --auth supabase \
  --payments stripe

# 2. Add components
cd dashboard-app
ai-dev add component DashboardCard --with-tests
ai-dev add component ChartWidget --with-tests
ai-dev add component UserTable --with-tests

# 3. Setup integrations
ai-dev setup posthog  # Analytics

# 4. Check health
ai-dev doctor

# 5. Run
npm run dev
```

--------------------------------

### Run Analysis Only

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/docs/TROUBLESHOOTING.md

Executes only the project analysis script without performing any setup or installation actions. This is useful for getting recommendations on an already configured project.

```bash
# Don't install anything, just analyze
bash ~/ai-dev-standards/scripts/analyze-project.sh .
```

--------------------------------

### Manual Installation of Context Tracking

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/docs/FILE-TRACKING-GUIDE.md

This section provides a step-by-step guide for manually installing context tracking if automatic installation is not feasible. It includes copying hooks, installing dependencies, making scripts executable, updating settings, creating directories, and initializing the active session.

```bash
# 1. Copy hooks
cp -r ai-dev-standards/.claude/hooks/ .claude/

# 2. Install dependencies
cd .claude/hooks && npm install

# 3. Make scripts executable
chmod +x .claude/hooks/*.sh

# 4. Update .claude/settings.json
# Add PostToolUse and UserPromptSubmit hooks

# 5. Create context directory
mkdir -p .claude/context/{files,sessions}

# 6. Initialize active session
echo '{"sessionId":"session-'$(date +%s%3N)'","startTime":"'$(date -u +%Y-%m-%dT%H:%M:%S.%3NZ)'","lastActivity":"'$(date -u +%Y-%m-%dT%H:%M:%S.%3NZ)'","modifiedFiles":[],"activeSkills":[],"agentsUsed":[],"promptCount":0,"fileChangeCount":0}' > .claude/context/active-session.json
```

--------------------------------

### Docker Integration for AI Dev Standards

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/docs/INSTALLATION-AND-UPDATES.md

A Dockerfile example showing how to install and set up AI Dev Standards within a Docker image. It includes cloning the repository, copying project files, running the setup script, and performing a health check.

```dockerfile
# Dockerfile
FROM node:18

# Install ai-dev-standards
RUN git clone https://github.com/your-org/ai-dev-standards.git /opt/ai-dev-standards

# Setup in project
WORKDIR /app
COPY . .
RUN bash /opt/ai-dev-standards/setup-project.sh

# Health check
RUN ai-dev doctor --fix-all
```

--------------------------------

### Docker Integration with Bootstrap

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/docs/BOOTSTRAP.md

Provides a Dockerfile example that includes running the AI Dev Standards bootstrap during the image build process. This ensures that the project is set up with the necessary standards from the start.

```dockerfile
FROM node:18

WORKDIR /app

# Bootstrap during image build
RUN npx @ai-dev-standards/bootstrap --yes

COPY . .

RUN npm install
CMD ["npm", "start"]
```

--------------------------------

### Review Personalized Project Guide

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/INTEGRATION-USAGE.md

This command displays the content of the START-HERE.md file, which is a personalized guide generated after integrating ai-dev-standards. It contains project health scores, recommended skills, priority tasks, and next steps.

```bash
cat START-HERE.md
```

--------------------------------

### Upgrade from Old ai-dev-standards Installation

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/docs/INSTALLATION-AND-UPDATES.md

This sequence of commands guides users through upgrading an older ai-dev-standards installation that may not have version tracking. It involves re-running the setup script, verifying the upgrade with `ai-dev doctor`, and checking the version.

```bash
# 1. Re-run setup
bash ~/ai-dev-standards/setup-project.sh

# 2. Verify upgrade
ai-dev doctor

# 3. Check version
jq -r '.version' .ai-dev.json
```

--------------------------------

### Example: Adding a New Skill

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/meta/RESOURCE-TAXONOMY.md

Demonstrates the step-by-step process for adding a new skill resource. This includes creating the necessary directories and files, registering the skill in the appropriate JSON file, and running the validation script to confirm consistency.

```bash
# 1. Create skill directory and files
mkdir skills/my-new-skill
touch skills/my-new-skill/skill.md
touch skills/my-new-skill/README.md

# 2. Add entry to meta/skill-registry.json
# Edit the file to add your skill entry

# 3. Run validation
node scripts/validate-all.cjs

# 4. If validation passes, the count is automatically correct
```

--------------------------------

### Force Re-install Project Setup

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/docs/TROUBLESHOOTING.md

Removes existing configuration files (.ai-dev.json and .claude/) and then re-runs the project setup script. This is useful for starting fresh or resolving setup issues.

```bash
# Remove config
rm .ai-dev.json
rm -rf .claude/

# Run setup again
bash ~/ai-dev-standards/setup-project.sh
```

--------------------------------

### Clone GitHub Repo and Run Setup (Bash)

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/docs/TROUBLESHOOTING.md

Sets up a new GitHub project by cloning the repository and then running the ai-dev-standards setup script. This process includes cloning, navigating into the project, and executing the setup script to perform analysis and provide recommendations.

```bash
# 1. Clone your repo
git clone git@github.com:yourusername/your-repo.git
cd your-repo

# 2. Run setup
bash ~/ai-dev-standards/setup-project.sh

# 3. Review the automatic analysis
```

--------------------------------

### Setup Existing Project (First Time)

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/docs/TROUBLESHOOTING.md

Runs the project setup script on an existing project directory. The script will auto-detect the project stage and provide customized recommendations.

```bash
cd ~/my-existing-app
bash ~/ai-dev-standards/setup-project.sh
```

--------------------------------

### Troubleshooting: Install CLI Command Not Found

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/docs/CLI-QUICKSTART.md

If the `ai-dev` command is not found, ensure it is installed globally or use `npx` to execute it. This addresses common PATH issues.

```bash
# Install globally
npm install -g @ai-dev-standards/cli

# Or use NPX
npx @ai-dev-standards/cli add component Button
```

--------------------------------

### Quick Start: Repository Usage Steps

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/meta/HOW-TO-USE.md

A concise, 30-second guide for AI assistants to quickly orient themselves within the ai-dev-standards repository at the start of each work session. It emphasizes reviewing key markdown files for context and guidance.

```text
1. Read: meta/PROJECT-CONTEXT.md
2. Read: meta/HOW-TO-USE.md (this file)
3. Review: meta/DECISION-FRAMEWORK.md (if making technology choices)
4. Search: meta/skill-registry.json (for relevant skills)
5. Proceed with task using loaded context
```

--------------------------------

### Re-install Project Hooks

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/docs/INSTALLATION-AND-UPDATES.md

Commands to re-install project hooks by running a setup script or manually installing npm dependencies and setting execute permissions for shell scripts in the hooks directory.

```bash
# Re-install hooks
bash ~/ai-dev-standards/setup-project.sh

# Or manually
cd .claude/hooks
npm install
chmod +x *.sh
```

--------------------------------

### Bootstrap System Installation Methods

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/docs/SYSTEM-OVERVIEW.md

Provides instructions for installing the AI Dev Standards bootstrap system using different methods. The recommended method is NPX, but installation via Curl or direct Node.js execution is also supported.

```bash
# Option 1: NPX (recommended)
npx @ai-dev-standards/bootstrap

# Option 2: Curl
curl -fsSL https://ai-dev-standards.com/bootstrap.sh | bash

# Option 3: Direct Node.js
node /path/to/CLI/bootstrap.js
```

--------------------------------

### Install Prisma and Initialize Database

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/skills/technical-writer/SKILL.md

Installs the necessary Prisma client and CLI tools, then initializes a new Prisma project. This sets up the foundation for database migrations and schema definition.

```bash
npm install @prisma/client
npm install -D prisma
npx prisma init
```

--------------------------------

### Markdown Structure for User Guide Documentation

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/skills/technical-writer/README.md

This markdown structure provides a template for creating user guides. It emphasizes setting expectations, outlining prerequisites, detailing setup and configuration steps with visual aids, and offering troubleshooting advice.

```markdown
# Getting Started

## What You'll Learn

(Set expectations)

## Prerequisites

(What they need)

## Step 1: Setup

(First step with screenshot)

## Step 2: Configure

(Second step)

## Next Steps

(Where to go next)

## Troubleshooting

(Common issues)

```

--------------------------------

### Troubleshooting: Permission Errors with npm Install

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/docs/CLI-QUICKSTART.md

Resolve permission errors during global npm installation on macOS/Linux by using `sudo`. Alternatively, using `npx` avoids the need for elevated privileges.

```bash
# On macOS/Linux
sudo npm install -g @ai-dev-standards/cli

# Or use NPX (no sudo needed)
npx @ai-dev-standards/cli add component Button
```

--------------------------------

### Example: Build MVP

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/status-reports/BRAIN-ORCHESTRATOR-SOLUTION.md

Shows the workflow for building a Minimum Viable Product (MVP) for a task management application. It details the skill selection, dependency retrieval, and methodology application.

```text
User: "Help me build an MVP for task management"

Claude (with brain_select_skills):
1. brain_select_skills("build MVP for task management")
   → mvp-builder, product-strategist, frontend-builder

2. brain_relationships("mvp-builder")
   → feature-prioritizer-mcp, user-insight-analyzer-mcp

3. Read skills/mvp-builder/SKILL.md

4. Apply MVP methodology:
   - Identify riskiest assumption
   - Choose MVP pattern (Concierge, Wizard of Oz, etc.)
   - Prioritize features (P0/P1/P2)
   - Build only P0 features

5. Use feature-prioritizer-mcp for ranking

6. Validate with user-insight-analyzer-mcp
```

--------------------------------

### Troubleshooting Node.js Version Requirement

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/docs/BOOTSTRAP.md

This section addresses the 'Node.js version 18+ required' error. It provides instructions on how to install the latest Node.js LTS version, using Homebrew on macOS as an example.

```bash
# Install latest Node.js LTS
# macOS (Homebrew)
brew install node
```

--------------------------------

### First-Time Project Setup with ai-dev-standards

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/UPDATE-GUIDE.md

This process sets up ai-dev-standards for the first time. It involves cloning the repository, running the setup script to detect project type, install CLI, sync resources, configure MCPs, and analyze the project. Finally, it instructs on building the brain-mcp server.

```bash
cd ~
git clone https://github.com/daffy0208/ai-dev-standards.git

cd /path/to/your/project
bash ~/ai-dev-standards/setup-project.sh

cd ~/ai-dev-standards/mcp-servers/brain-mcp
npm install
npm run build
```

--------------------------------

### Markdown Structure for Tutorial Documentation

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/skills/technical-writer/README.md

This markdown structure is designed for creating tutorials. It focuses on clearly defining the end goal, listing necessary prerequisites, and guiding the learner through step-by-step instructions with code examples and explanations.

```markdown
# Build X with Y

## What You'll Build

(Show final result)

## Prerequisites

(Required knowledge)

## Step 1: Setup

(Code + explanation)

## Step 2: Feature A

(Code + what it does)

## What You Learned

(Recap)

## Next Steps

(Advanced topics)

```

--------------------------------

### Install AI Dev Standards CLI via Curl

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/docs/BOOTSTRAP.md

This method uses Curl to download and execute the bootstrap script from a URL. It is suitable for Unix-like systems (Linux, macOS) and performs a one-command setup.

```bash
curl -fsSL https://ai-dev-standards.com/bootstrap.sh | bash
```

--------------------------------

### Deploy App with Example CLI

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/skills/technical-writer/SKILL.md

Commands to navigate to an application directory and deploy it using the example CLI.

```bash
cd my-app
```

```bash
example deploy
```

--------------------------------

### Initialize SaaS Project (Bash)

Source: https://context7.com/daffy0208/ai-dev-standards/llms.txt

Creates a full-stack SaaS application starter project. This command integrates essential services like authentication (Supabase), payments (Stripe), email (Resend), and analytics (Posthog). It sets up a comprehensive project structure including a landing page, admin dashboard, user settings, and API endpoints.

```bash
ai-dev init saas-starter my-app \
  --auth supabase \
  --payments stripe \
  --email resend \
  --analytics posthog

# Creates complete project with:
# - Authentication (Supabase)
# - Payments (Stripe)
# - Email (Resend)
# - Analytics (Posthog)
# - Landing page, Admin dashboard, User settings, API endpoints
```

--------------------------------

### Migrate from AI Dev Standards v2.x to v3.x

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/docs/INSTALLATION-AND-UPDATES.md

A step-by-step guide to migrating a project from AI Dev Standards version 2.x to 3.x. It covers updating the core standards, re-installing the CLI, updating projects, and verifying the setup.

```bash
# 1. Update ai-dev-standards
cd ~/ai-dev-standards
git pull origin main

# 2. Re-install CLI
cd CLI
npm install
npm link

# 3. Update projects
cd /path/to/project
bash ~/ai-dev-standards/setup-project.sh

# 4. Verify
ai-dev doctor
```

--------------------------------

### Initialize New Project

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/docs/TROUBLESHOOTING.md

Sets up a brand new project by creating a directory, initializing git, and running the project setup script. This is the first step for new AI development projects.

```bash
mkdir my-new-app
cd my-new-app
git init
bash ~/ai-dev-standards/setup-project.sh
```

--------------------------------

### Setup Integrations with ai-dev CLI

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/docs/CLI-QUICKSTART.md

Configure essential third-party integrations for your project, such as Supabase for authentication, Stripe for payments, and Pinecone for RAG.

```bash
# Supabase with auth
ai-dev setup supabase --with-auth

# Stripe
ai-dev setup stripe

# Pinecone with RAG
ai-dev setup pinecone --with-rag
```

--------------------------------

### Bootstrap Auto-Sync Setup

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/docs/AUTO-SYNC-GUIDE.md

Installs and configures the auto-sync system using the ai-dev-standards bootstrap command. This is the recommended method for setting up automatic synchronization with git hooks.

```bash
npx @ai-dev-standards/bootstrap
```

--------------------------------

### Bash Bootstrap Script (CLI/bootstrap.sh)

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/docs/SYSTEM-OVERVIEW.md

A bash script used for bootstrapping the AI Dev Standards environment. This script automates the setup process, making it easier to get started with the project.

```bash
#!/bin/bash

# Bootstrap script for AI Dev Standards

echo "Welcome to the AI Dev Standards Bootstrap!"

# Check for Node.js and npm
if ! command -v node &> /dev/null || ! command -v npm &> /dev/null;
    then
        echo "Error: Node.js and npm are required. Please install them first."
        exit 1
fi

# Install global CLI tool
echo "Installing @ai-dev-standards/cli globally..."
npm install -g @ai-dev-standards/cli

# Verify installation
if command -v ai-dev &> /dev/null;
    then
        echo "@ai-dev-standards/cli installed successfully!"
        ai-dev --version
    else
        echo "Error: Failed to install @ai-dev-standards/cli."
        exit 1
fi

echo "Bootstrap process completed."

```

--------------------------------

### Initiate OpenAI Setup via CLI

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/docs/QUICK-START.md

This bash command launches an interactive setup process for OpenAI integration. It performs tasks such as installing required npm packages, creating client code, and configuring .env files.

```bash
ai-dev setup openai
```

--------------------------------

### Bash Script for Manual Skill Auto-Activation Installation

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/docs/SKILL-AUTO-ACTIVATION.md

This bash script provides instructions for manually installing the skill auto-activation system into a project. It covers copying necessary hook files, skill rules, and settings, installing dependencies, and making the hook executable. This is useful if the automatic setup script is not used.

```bash
# 1. Copy hooks
cp -r ~/ai-dev-standards/.claude/hooks your-project/.claude/

# 2. Copy skill-rules.json
cp ~/ai-dev-standards/.claude/skills/skill-rules.json your-project/.claude/skills/

# 3. Copy settings.json (or merge with existing)
cp ~/ai-dev-standards/.claude/settings.json your-project/.claude/

# 4. Install hook dependencies
cd your-project/.claude/hooks
npm install

# 5. Make hook executable
chmod +x your-project/.claude/hooks/skill-activation-prompt.sh

```

--------------------------------

### Team Onboarding: Initializing Git Submodule

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/docs/INTEGRATION-GUIDE.md

This markdown snippet provides instructions for new team members to set up the project, specifically focusing on cloning the repository and initializing the git submodule containing the AI development standards.

```markdown
# Using AI Development Standards

## Setup (One-time)

1. Clone repo:
   ```bash
   git clone <project-url>
   cd project
   git submodule update --init --recursive
   ```

2. Install Cursor/Claude Code

3. Open project - Claude automatically loads standards

## Daily Usage

When working with Claude:

"Use the [skill-name] skill to..."

- mvp-builder: Feature prioritization
- frontend-builder: React components
- api-designer: New endpoints
- rag-implementer: AI search features

Claude will follow our team's standards automatically.

```

--------------------------------

### Setup Codex CLI Script

Source: https://github.com/daffy0208/ai-dev-standards/blob/main/docs/PROJECT-SETUP-QUICKSTART.md

This command executes the setup script for the codex CLI, which may auto-generate necessary files like .codex/codex.md. Alternatively, users can manually create this file using a provided template. This step is crucial for enabling the codex CLI's functionality.

```bash
cd /path/to/ai-dev-standards
./setup-codex-cli.sh
```