### Install BMAD-METHOD

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/web-bundles/teams/team-all.txt

This command initiates the interactive installation process for BMAD-METHOD, guiding the user through setup and IDE selection.

```bash
npx bmad-method install
```

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

### Install BMAD-METHOD

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/web-bundles/teams/team-fullstack.txt

This command initiates the interactive installation process for BMAD-METHOD, guiding the user through setup and IDE selection.

```bash
npx bmad-method install
```

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

### Install BMAD-METHOD

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/web-bundles/teams/team-ide-minimal.txt

This command initiates the interactive installation process for BMAD-METHOD, guiding the user through setup and IDE selection.

```bash
npx bmad-method install
```

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

### Install BMAD-METHOD

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/web-bundles/teams/team-no-ui.txt

This command initiates the interactive installation process for BMAD-METHOD, guiding the user through setup and IDE selection.

```bash
npx bmad-method install
```

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

### Interactive Installation

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/web-bundles/agents/bmad-master.txt

Installs the BMAD-METHOD™ using npx. This is the recommended method for interactive setup, guiding users through installation steps and IDE selection.

```bash
npx bmad-method install
```

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

### Build Project Setup Example (Bash)

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/apps/api/node_modules/es-module-lexer/README.md

Example commands for setting up the build environment, including cloning repositories, installing dependencies, and running tests.

```bash
git clone https://github.com:guybedford/es-module-lexer
git clone https://github.com/emscripten-core/emsdk
cd emsdk
git checkout 1.40.1-fastcomp
./emsdk install 1.40.1-fastcomp
cd ..
wget https://github.com/WebAssembly/wasi-sdk/releases/download/wasi-sdk-12/wasi-sdk-12.0-linux.tar.gz
gunzip wasi-sdk-12.0-linux.tar.gz
tar -xf wasi-sdk-12.0-linux.tar
mv wasi-sdk-12.0-linux.tar wasi-sdk-12.0
cargo install chompbuild
cd es-module-lexer
chomp test
```

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

### Bash Script for Initial Project Setup

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/docs/architecture/index.md

A bash script outlining the initial setup steps for the project, including installing dependencies, configuring the environment, and potentially running initial migrations or builds.

```Bash
#!/bin/bash

echo "Setting up project environment..."

# Install dependencies
npm install

# Configure environment variables (example)
# cp .env.example .env
# nano .env

# Run initial database migrations (example)
# npx prisma migrate dev

echo "Project setup complete."
```

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

### Initial Project Setup and Configuration

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/docs/architecture/development-workflow.md

Clones the repository, installs project dependencies using npm, sets up environment variables by copying an example file and editing it with necessary API keys, and initializes the database schema using Supabase.

```bash
# Clone and install dependencies
git clone <repository-url>
cd HeadshotAI
npm install

# Set up environment variables
cp .env.example .env
# Edit .env with Supabase, Google AI Studio, RevenueCat keys

# Initialize database schema
npx supabase db reset
```

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

### Development Setup and Commands

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/docs/architecture.md

Details the prerequisites, initial setup steps including cloning the repository, installing dependencies, configuring environment variables, and initializing the database. It also lists essential development commands for running all services, mobile app, API, and tests.

```bash
# Install Node.js 18+, npm, iOS development tools
node --version  # 18+
npm --version  # 8+
xcode-select --install
```

```bash
# Clone and install dependencies
git clone <repository-url>
cd HeadshotAI
npm install

# Set up environment variables
cp .env.example .env
# Edit .env with Supabase, Google AI Studio, RevenueCat keys

# Initialize database schema
npx supabase db reset
```

```bash
# Start all services
npm run dev

# Start mobile app only
npm run dev:mobile

# Start API functions only  
npm run dev:api

# Run tests
npm run test
npm run test:mobile
npm run test:api
```

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

### Set Up Testing Framework (Jest + React Native Testing Library)

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/docs/stories/1.1A.serverless-project-setup.md

Installs and configures Jest and React Native Testing Library for unit and integration testing. This includes setting up the testing environment, file structure, conventions, and creating example component tests.

```bash
npm install --save-dev jest @testing-library/react-native @testing-library/jest-native
# Configure jest.config.js
# Example test in __tests__/App.test.js:
# import React from 'react';
# import { render } from '@testing-library/react-native';
# import App from '../App';
# test('renders correctly', () => {
#   render(<App />);
# });
```

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

### Initial Setup Instructions

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/web-bundles/expansion-packs/bmad-2d-unity-game-dev/teams/unity-2d-game-team.txt

Provides instructions for the initial setup of the level design document, emphasizing its role in guiding content creation and technical implementation. It also suggests reviewing related documents like the Game Design Document (GDD) and Game Architecture Document.

```markdown
sections:
  - id: initial-setup
    instruction: |
      This template creates comprehensive level design documentation that guides both content creation and technical implementation. This document should provide enough detail for developers to create level loading systems and for designers to create specific levels.

      If available, review: Game Design Document (GDD), Game Architecture Document. This document should align with the game mechanics and technical systems defined in those documents.
```

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

### Document Project Architecture and Workflow

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/docs/stories/1.1A.serverless-project-setup.md

Covers the creation of essential project documentation, including a README with setup instructions, development workflow standards, an architecture overview, deployment procedures, and a troubleshooting guide.

```markdown
# Project Setup

Follow these steps to set up the project locally:

1. Clone the repository.
2. Install dependencies: `npm install` or `yarn install`.
3. For iOS: `npx pod-install`.
4. Start the development server: `npm start` or `yarn start`.

## Development Workflow

- Use Git for version control.
- Follow feature branching strategy.
- Write tests for new components and features.

## Architecture Overview

- **Frontend**: React Native with TypeScript.
- **Backend**: Vercel Functions.
- **Database**: Supabase.
- **UI**: React Native Elements.

## Deployment

- Automated deployment via Vercel CI/CD.
- iOS builds for TestFlight managed via Fastlane.

## Troubleshooting

- Ensure Node.js and npm/yarn are up-to-date.
- Check environment variables.
- Consult Sentry for error details.
```

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

### Install bmad-method for Unity Game Dev

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/web-bundles/expansion-packs/bmad-2d-unity-game-dev/agents/game-architect.txt

This command initiates an interactive installation process for the bmad-method, guiding the user to select the 'bmad-2d-unity-game-dev' expansion pack for Unity game development.

```bash
npx bmad-method install
```

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

### BMAD Quick Start - Web UI Setup

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/web-bundles/teams/team-ide-minimal.txt

Instructions for setting up BMAD using a Web UI, suitable for users of platforms like ChatGPT, Claude, or Gemini. It involves navigating to a specific directory, copying a file, and creating a new AI instance with provided instructions.

```bash
Navigate to `dist/teams/`
Copy `team-fullstack.txt` content
Create new Gemini Gem or CustomGPT
Upload file with instructions: "Your critical operating instructions are attached, do not break character as directed"
Type `/help` to see available commands
```

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

### BMAD Quick Start - Web UI Setup

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/web-bundles/teams/team-fullstack.txt

Instructions for setting up BMAD using a Web UI, suitable for users of platforms like ChatGPT, Claude, or Gemini. It involves navigating to a specific directory, copying a file, and creating a new AI instance with provided instructions.

```bash
Navigate to `dist/teams/`
Copy `team-fullstack.txt` content
Create new Gemini Gem or CustomGPT
Upload file with instructions: "Your critical operating instructions are attached, do not break character as directed"
Type `/help` to see available commands
```

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

### BMAD Quick Start - Web UI Setup

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/web-bundles/teams/team-all.txt

Instructions for setting up BMAD using a Web UI, suitable for users of platforms like ChatGPT, Claude, or Gemini. It involves navigating to a specific directory, copying a file, and creating a new AI instance with provided instructions.

```bash
Navigate to `dist/teams/`
Copy `team-fullstack.txt` content
Create new Gemini Gem or CustomGPT
Upload file with instructions: "Your critical operating instructions are attached, do not break character as directed"
Type `/help` to see available commands
```

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

### Install and Configure ESLint

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/apps/api/node_modules/eslint/README.md

This command initializes ESLint and sets up a configuration file in your project directory. It guides you through the process of configuring ESLint based on your project's needs.

```shell
npm init @eslint/config
```

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

### BMAD Quick Start - Web UI Setup

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/web-bundles/teams/team-no-ui.txt

Instructions for setting up BMAD using a Web UI, suitable for users of platforms like ChatGPT, Claude, or Gemini. It involves navigating to a specific directory, copying a file, and creating a new AI instance with provided instructions.

```bash
Navigate to `dist/teams/`
Copy `team-fullstack.txt` content
Create new Gemini Gem or CustomGPT
Upload file with instructions: "Your critical operating instructions are attached, do not break character as directed"
Type `/help` to see available commands
```

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

### Initial Setup Instructions

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/web-bundles/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.txt

Provides instructions for the initial setup phase of infrastructure architecture documentation. It includes steps for replacing placeholders, gathering required documents, and cross-referencing with technical assumptions.

```markdown
sections:
  - id: initial-setup
    instruction: |
      Initial Setup

      1. Replace {{project_name}} with the actual project name throughout the document
      2. Gather and review required inputs:
         - Product Requirements Document (PRD) - Required for business needs and scale requirements
         - Main System Architecture - Required for infrastructure dependencies
         - Technical Preferences/Tech Stack Document - Required for technology choices
         - PRD Technical Assumptions - Required for cross-referencing repository and service architecture

      If any required documents are missing, ask user: "I need the following documents to create a comprehensive infrastructure architecture: [list missing]. Would you like to proceed with available information or provide the missing documents first?"

      3. <critical_rule>Cross-reference with PRD Technical Assumptions to ensure infrastructure decisions align with repository and service architecture decisions made in the system architecture.</critical_rule>

      Output file location: `docs/infrastructure-architecture.md`
```

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

### Install CocoaPods Dependencies

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/apps/mobile/HeadshotAI/iOS-Setup.md

Installs the necessary dependencies for the iOS project using CocoaPods. This command should be run from the 'ios' directory of the project.

```bash
cd ios
pod install
```

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

### JavaScript: Add Better Installation Methods

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/apps/api/node_modules/diff/release-notes.md

Introduces improved methods for installing the library, making it easier for users to get started. This was part of version 3.3.0.

```JavaScript
Added better installation methods - aced50b
```

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

### Install Dependencies and Run Tests

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/apps/api/node_modules/fill-range/README.md

To get started with the project, you need to install its dependencies and run the unit tests. This is typically done using npm commands.

```sh
$ npm install && npm test
```

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

### Run React Native iOS Project

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/apps/mobile/HeadshotAI/iOS-Setup.md

Commands to run the React Native project on an iOS simulator. It utilizes npm or npx to start the Metro bundler and build the application.

```bash
npm run ios
```

```bash
npx react-native run-ios
```

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

### Handle Starter Template or Existing Project

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/web-bundles/teams/team-all.txt

This section outlines the process for identifying and analyzing starter templates or existing codebases. It includes instructions for eliciting information from the user and documenting the decision.

```yaml
- id: starter-template
    title: Starter Template or Existing Project
    instruction: |
      Before proceeding further with architecture design, check if the project is based on a starter template or existing codebase:

      1. Review the PRD and brainstorming brief for any mentions of:
      - Starter templates (e.g., Create React App, Next.js, Vue CLI, Angular CLI, etc.)
      - Existing projects or codebases being used as a foundation
      - Boilerplate projects or scaffolding tools
      - Previous projects to be cloned or adapted

      2. If a starter template or existing project is mentioned:
      - Ask the user to provide access via one of these methods:
        - Link to the starter template documentation
        - Upload/attach the project files (for small projects)
        - Share a link to the project repository (GitHub, GitLab, etc.)
      - Analyze the starter/existing project to understand:
        - Pre-configured technology stack and versions
        - Project structure and organization patterns
        - Built-in scripts and tooling
        - Existing architectural patterns and conventions
        - Any limitations or constraints imposed by the starter
      - Use this analysis to inform and align your architecture decisions

      3. If no starter template is mentioned but this is a greenfield project:
      - Suggest appropriate starter templates based on the tech stack preferences
      - Explain the benefits (faster setup, best practices, community support)
      - Let the user decide whether to use one

      4. If the user confirms no starter template will be used:
      - Proceed with architecture design from scratch
      - Note that manual setup will be required for all tooling and configuration

      Document the decision here before proceeding with the architecture design. If none, just say N/A
    elicit: true
```

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

### KB Mode Entry and Welcome

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/web-bundles/expansion-packs/bmad-2d-unity-game-dev/teams/unity-2d-game-team.txt

This snippet describes the process of entering KB mode and providing a welcome message to the user. It outlines the initial steps for interacting with the knowledge base.

```Markdown
# KB Mode Interaction Task

## Purpose

Provide a user-friendly interface to the BMad knowledge base without overwhelming users with information upfront.

## Instructions

When entering KB mode (\*kb-mode), follow these steps:

### 1. Welcome and Guide

Announce entering KB mode with a brief, friendly introduction.
```

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

### Usage Example: Get nyc Default Exclude List

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/apps/api/node_modules/@istanbuljs/schema/README.md

Demonstrates how to import the 'nyc' defaults from the @istanbuljs/schema package and log the default exclude list to the console. This requires Node.js and the @istanbuljs/schema package to be installed.

```javascript
const {nyc} = require('@istanbuljs/schema').defaults;

console.log(`Default exclude list:\n\t* ${nyc.exclude.join('\n\t* ')}`);
```

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

### Install TypeScript (Nightly Build)

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/apps/api/node_modules/typescript/README.md

Installs the latest nightly build of TypeScript as a development dependency using npm.

```Bash
npm install -D typescript@next
```

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

### Handle Starter Template or Existing Project

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/web-bundles/teams/team-fullstack.txt

This section outlines the process for identifying and analyzing starter templates or existing codebases. It includes instructions for eliciting information from the user and documenting the decision.

```yaml
- id: starter-template
    title: Starter Template or Existing Project
    instruction: |
      Before proceeding further with architecture design, check if the project is based on a starter template or existing codebase:

      1. Review the PRD and brainstorming brief for any mentions of:
      - Starter templates (e.g., Create React App, Next.js, Vue CLI, Angular CLI, etc.)
      - Existing projects or codebases being used as a foundation
      - Boilerplate projects or scaffolding tools
      - Previous projects to be cloned or adapted

      2. If a starter template or existing project is mentioned:
      - Ask the user to provide access via one of these methods:
        - Link to the starter template documentation
        - Upload/attach the project files (for small projects)
        - Share a link to the project repository (GitHub, GitLab, etc.)
      - Analyze the starter/existing project to understand:
        - Pre-configured technology stack and versions
        - Project structure and organization patterns
        - Built-in scripts and tooling
        - Existing architectural patterns and conventions
        - Any limitations or constraints imposed by the starter
      - Use this analysis to inform and align your architecture decisions

      3. If no starter template is mentioned but this is a greenfield project:
      - Suggest appropriate starter templates based on the tech stack preferences
      - Explain the benefits (faster setup, best practices, community support)
      - Let the user decide whether to use one

      4. If the user confirms no starter template will be used:
      - Proceed with architecture design from scratch
      - Note that manual setup will be required for all tooling and configuration

      Document the decision here before proceeding with the architecture design. If none, just say N/A
    elicit: true
```

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

### Install TypeScript (Latest Stable)

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/apps/api/node_modules/typescript/README.md

Installs the latest stable version of TypeScript as a development dependency using npm.

```Bash
npm install -D typescript
```

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

### Development and Build Commands

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/web-bundles/expansion-packs/bmad-2d-unity-game-dev/teams/unity-2d-game-team.txt

Common npm commands for starting the development server, building for production, running database migrations, and seeding test data.

```bash
npm run dev         # Start development server
npm run build       # Production build
npm run migrate     # Run database migrations
npm run seed        # Seed test data
```

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

### Install parent-module

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/apps/api/node_modules/parent-module/readme.md

Installs the parent-module package using npm.

```bash
npm install parent-module
```

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

### BMAD Quick Start: Web UI

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/web-bundles/agents/bmad-master.txt

Instructions for starting with the BMAD framework using a web UI, typically for platforms like ChatGPT, Claude, or Gemini. It involves navigating to a specific directory, copying a team configuration file, and setting up a new AI instance with provided instructions.

```text
Navigate to `dist/teams/`
Copy `team-fullstack.txt` content
Create new Gemini Gem or CustomGPT
Upload file with instructions: "Your critical operating instructions are attached, do not break character as directed"
Type `/help` to see available commands
```

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

### Install locate-path

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/apps/api/node_modules/pkg-dir/node_modules/locate-path/readme.md

Installs the locate-path package using npm.

```bash
$ npm install locate-path
```

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

### Install locate-path

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/apps/api/node_modules/locate-path/readme.md

Installs the locate-path package using npm.

```bash
$ npm install locate-path
```

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

### BMAD Quick Start - IDE Integration

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/web-bundles/teams/team-fullstack.txt

This snippet indicates the availability of IDE integration for BMAD, targeting users of IDEs like Cursor, Claude Code, Windsurf, Trae, Cline, Roo Code, and Github Copilot. The actual command or setup steps are not provided in this context.

```bash

```

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

### Jest-Worker: Start Method

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/apps/api/node_modules/jest-worker/README.md

Shows how to use the `start()` method of Jest-Worker. This method initializes all worker threads and executes their setup functions. It returns a Promise that resolves once all workers are operational and have completed their setup, useful for eager worker initialization.

```javascript
worker.start()
  .then(() => console.log('All workers started and ready.'));
```

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

### Install string-length

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/apps/api/node_modules/string-length/readme.md

Installs the string-length package using npm. This is a prerequisite for using the package in your Node.js project.

```bash
$ npm install string-length
```

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

### Install ci-info with npm

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/apps/api/node_modules/ci-info/README.md

This command installs the ci-info package as a dependency for your Node.js project using npm.

```bash
npm install ci-info --save
```

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

### Tech Stack Table Examples

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/web-bundles/teams/team-all.txt

Provides examples for populating the technology stack table, including essential components like Language, Runtime, and Framework, along with their versions, purposes, and justifications.

```Markdown
| **Language** | TypeScript | 5.3.3 | Primary development language | Strong typing, excellent tooling, team expertise |

```

```Markdown
| **Runtime** | Node.js | 20.11.0 | JavaScript runtime | LTS version, stable performance, wide ecosystem |

```

```Markdown
| **Framework** | NestJS | 10.3.2 | Backend framework | Enterprise-ready, good DI, matches team patterns |

```

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

### BMAD Quick Start - IDE Integration

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/web-bundles/teams/team-all.txt

This snippet indicates the availability of IDE integration for BMAD, targeting users of IDEs like Cursor, Claude Code, Windsurf, Trae, Cline, Roo Code, and Github Copilot. The actual command or setup steps are not provided in this context.

```bash

```

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

### Usage Example

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/apps/api/node_modules/parent-module/readme.md

Demonstrates how to use the parent-module package to get the path of the immediate parent module in a Node.js application.

```javascript
// bar.js
const parentModule = require('parent-module');

module.exports = () => {
	console.log(parentModule());
	//=> '/Users/sindresorhus/dev/unicorn/foo.js'
};

```

```javascript
// foo.js
const bar = require('./bar');

bar();

```

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

### Install CocoaPods in GitHub Actions Workflow

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/apps/mobile/HeadshotAI/TROUBLESHOOTING.md

YAML configuration for a GitHub Actions workflow to install CocoaPods and run `pod install` within the iOS project directory. This is essential for CI/CD pipelines that build iOS applications.

```yaml
# .github/workflows/ios.yml
- name: Install CocoaPods
  run: |
    sudo gem install cocoapods
    cd ios && pod install
```

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

### Tech Stack Table Examples

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/web-bundles/teams/team-fullstack.txt

Provides examples for populating the technology stack table, including essential components like Language, Runtime, and Framework, along with their versions, purposes, and justifications.

```Markdown
| **Language** | TypeScript | 5.3.3 | Primary development language | Strong typing, excellent tooling, team expertise |

```

```Markdown
| **Runtime** | Node.js | 20.11.0 | JavaScript runtime | LTS version, stable performance, wide ecosystem |

```

```Markdown
| **Framework** | NestJS | 10.3.2 | Backend framework | Enterprise-ready, good DI, matches team patterns |

```

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

### Install jest-changed-files with npm

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/apps/api/node_modules/jest-changed-files/README.md

Installs the jest-changed-files package using npm. This is the primary method for adding the module to your project dependencies.

```sh
$ npm install --save jest-changed-files
```

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

### Handle Starter Template or Existing Project

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/web-bundles/teams/team-no-ui.txt

This section outlines the process for identifying and analyzing starter templates or existing codebases. It includes instructions for eliciting information from the user and documenting the decision.

```yaml
- id: starter-template
    title: Starter Template or Existing Project
    instruction: |
      Before proceeding further with architecture design, check if the project is based on a starter template or existing codebase:

      1. Review the PRD and brainstorming brief for any mentions of:
      - Starter templates (e.g., Create React App, Next.js, Vue CLI, Angular CLI, etc.)
      - Existing projects or codebases being used as a foundation
      - Boilerplate projects or scaffolding tools
      - Previous projects to be cloned or adapted

      2. If a starter template or existing project is mentioned:
      - Ask the user to provide access via one of these methods:
        - Link to the starter template documentation
        - Upload/attach the project files (for small projects)
        - Share a link to the project repository (GitHub, GitLab, etc.)
      - Analyze the starter/existing project to understand:
        - Pre-configured technology stack and versions
        - Project structure and organization patterns
        - Built-in scripts and tooling
        - Existing architectural patterns and conventions
        - Any limitations or constraints imposed by the starter
      - Use this analysis to inform and align your architecture decisions

      3. If no starter template is mentioned but this is a greenfield project:
      - Suggest appropriate starter templates based on the tech stack preferences
      - Explain the benefits (faster setup, best practices, community support)
      - Let the user decide whether to use one

      4. If the user confirms no starter template will be used:
      - Proceed with architecture design from scratch
      - Note that manual setup will be required for all tooling and configuration

      Document the decision here before proceeding with the architecture design. If none, just say N/A
    elicit: true
```

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

### Type Extract Example

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/apps/api/node_modules/@sinclair/typebox/readme.md

Illustrates extracting a specific type from a union of types. This example shows how to get the string type from a union of string and number.

```TypeScript
const T = Type.Extract(
  Type.Union([
    Type.String(),
    Type.Number(),
  ]),
  Type.String()
)
```

```JSON
{
  "type": "string"
}
```

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

### BMAD Quick Start - IDE Integration

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/web-bundles/teams/team-ide-minimal.txt

This snippet indicates the availability of IDE integration for BMAD, targeting users of IDEs like Cursor, Claude Code, Windsurf, Trae, Cline, Roo Code, and Github Copilot. The actual command or setup steps are not provided in this context.

```bash

```

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

### Handle Starter Template or Existing Project

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/web-bundles/agents/architect.txt

This section outlines the process for identifying and analyzing starter templates or existing codebases. It includes instructions for eliciting information from the user and documenting the decision.

```yaml
- id: starter-template
    title: Starter Template or Existing Project
    instruction: |
      Before proceeding further with architecture design, check if the project is based on a starter template or existing codebase:

      1. Review the PRD and brainstorming brief for any mentions of:
      - Starter templates (e.g., Create React App, Next.js, Vue CLI, Angular CLI, etc.)
      - Existing projects or codebases being used as a foundation
      - Boilerplate projects or scaffolding tools
      - Previous projects to be cloned or adapted

      2. If a starter template or existing project is mentioned:
      - Ask the user to provide access via one of these methods:
        - Link to the starter template documentation
        - Upload/attach the project files (for small projects)
        - Share a link to the project repository (GitHub, GitLab, etc.)
      - Analyze the starter/existing project to understand:
        - Pre-configured technology stack and versions
        - Project structure and organization patterns
        - Built-in scripts and tooling
        - Existing architectural patterns and conventions
        - Any limitations or constraints imposed by the starter
      - Use this analysis to inform and align your architecture decisions

      3. If no starter template is mentioned but this is a greenfield project:
      - Suggest appropriate starter templates based on the tech stack preferences
      - Explain the benefits (faster setup, best practices, community support)
      - Let the user decide whether to use one

      4. If the user confirms no starter template will be used:
      - Proceed with architecture design from scratch
      - Note that manual setup will be required for all tooling and configuration

      Document the decision here before proceeding with the architecture design. If none, just say N/A
    elicit: true
```

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

### Install p-try using npm

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/apps/api/node_modules/p-try/readme.md

Installs the p-try package using npm. This is the standard way to add the package to your Node.js project dependencies.

```bash
$ npm install p-try
```

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

### Install Expansion Pack using BMAD CLI

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/web-bundles/agents/analyst.txt

This snippet demonstrates how to install an expansion pack using the BMAD-METHOD™ command-line interface (CLI). It guides users through selecting the 'Install expansion pack' option after running the command.

```bash
npx bmad-method install
# Select "Install expansion pack" option
```

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

### Handle Starter Template or Existing Project

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/web-bundles/agents/bmad-master.txt

This section outlines the process for identifying and analyzing starter templates or existing codebases. It includes instructions for eliciting information from the user and documenting the decision.

```yaml
- id: starter-template
    title: Starter Template or Existing Project
    instruction: |
      Before proceeding further with architecture design, check if the project is based on a starter template or existing codebase:

      1. Review the PRD and brainstorming brief for any mentions of:
      - Starter templates (e.g., Create React App, Next.js, Vue CLI, Angular CLI, etc.)
      - Existing projects or codebases being used as a foundation
      - Boilerplate projects or scaffolding tools
      - Previous projects to be cloned or adapted

      2. If a starter template or existing project is mentioned:
      - Ask the user to provide access via one of these methods:
        - Link to the starter template documentation
        - Upload/attach the project files (for small projects)
        - Share a link to the project repository (GitHub, GitLab, etc.)
      - Analyze the starter/existing project to understand:
        - Pre-configured technology stack and versions
        - Project structure and organization patterns
        - Built-in scripts and tooling
        - Existing architectural patterns and conventions
        - Any limitations or constraints imposed by the starter
      - Use this analysis to inform and align your architecture decisions

      3. If no starter template is mentioned but this is a greenfield project:
      - Suggest appropriate starter templates based on the tech stack preferences
      - Explain the benefits (faster setup, best practices, community support)
      - Let the user decide whether to use one

      4. If the user confirms no starter template will be used:
      - Proceed with architecture design from scratch
      - Note that manual setup will be required for all tooling and configuration

      Document the decision here before proceeding with the architecture design. If none, just say N/A
    elicit: true
```

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

### Install Expansion Pack using BMAD CLI

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/web-bundles/agents/bmad-orchestrator.txt

This snippet demonstrates how to install an expansion pack using the BMAD-METHOD™ command-line interface (CLI). It guides users through selecting the 'Install expansion pack' option after running the command.

```bash
npx bmad-method install
# Select "Install expansion pack" option
```

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

### KB Mode Entry and Welcome

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/web-bundles/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt

Instructions for entering and initiating the Knowledge Base (KB) mode. It includes a welcome message and guidance for the user upon entry.

```Markdown
# KB Mode Interaction

## Purpose

Provide a user-friendly interface to the BMad knowledge base without overwhelming users with information upfront.

## Instructions

When entering KB mode (\*kb-mode), follow these steps:

### 1. Welcome and Guide

Announce entering KB mode with a brief, friendly introduction.
```

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

### Install Ajv Beta

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/apps/api/node_modules/eslint/node_modules/ajv/README.md

Installs the beta version of Ajv using npm. This command is used to get the latest pre-release version for testing.

```bash
npm install ajv@beta
```

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

### Tech Stack Table Examples

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/web-bundles/teams/team-no-ui.txt

Provides examples for populating the technology stack table, including essential components like Language, Runtime, and Framework, along with their versions, purposes, and justifications.

```Markdown
| **Language** | TypeScript | 5.3.3 | Primary development language | Strong typing, excellent tooling, team expertise |

```

```Markdown
| **Runtime** | Node.js | 20.11.0 | JavaScript runtime | LTS version, stable performance, wide ecosystem |

```

```Markdown
| **Framework** | NestJS | 10.3.2 | Backend framework | Enterprise-ready, good DI, matches team patterns |

```

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

### Install p-locate

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/apps/api/node_modules/p-locate/readme.md

This snippet shows how to install the p-locate package using npm, the Node Package Manager.

```bash
$ npm install p-locate
```

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

### Install @nodelib/fs.stat

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/apps/api/node_modules/@nodelib/fs.stat/README.md

Installs the @nodelib/fs.stat package using npm. This is the primary method for adding the library to your Node.js project.

```console
npm install @nodelib/fs.stat
```

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

### BMAD Quick Start - IDE Integration

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/web-bundles/teams/team-no-ui.txt

This snippet indicates the availability of IDE integration for BMAD, targeting users of IDEs like Cursor, Claude Code, Windsurf, Trae, Cline, Roo Code, and Github Copilot. The actual command or setup steps are not provided in this context.

```bash

```

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

### BMAD Quick Start: IDE Integration

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/web-bundles/agents/bmad-master.txt

Provides a command-line interface (CLI) example for initiating the BMAD framework within an Integrated Development Environment (IDE). This is suitable for users of IDEs that support AI integration.

```bash
# Example command for IDE integration (specific command may vary)
# bmad init --ide cursor
# bmad start --project my-project
```

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

### Install locate-path

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/apps/api/node_modules/@istanbuljs/load-nyc-config/node_modules/locate-path/readme.md

Installs the locate-path package using npm. This is the standard way to add the package to your project's dependencies.

```bash
$ npm install locate-path
```

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

### Ajv Setup for TypeBox

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/apps/api/node_modules/@sinclair/typebox/readme.md

Demonstrates the recommended setup for integrating TypeBox schemas with Ajv for validation, including installing necessary packages and configuring Ajv with formats.

```bash
$ npm install ajv ajv-formats --save
```

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

### Tech Stack Table Examples

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/web-bundles/agents/architect.txt

Provides examples for populating the technology stack table, including essential components like Language, Runtime, and Framework, along with their versions, purposes, and justifications.

```Markdown
| **Language** | TypeScript | 5.3.3 | Primary development language | Strong typing, excellent tooling, team expertise |

```

```Markdown
| **Runtime** | Node.js | 20.11.0 | JavaScript runtime | LTS version, stable performance, wide ecosystem |

```

```Markdown
| **Framework** | NestJS | 10.3.2 | Backend framework | Enterprise-ready, good DI, matches team patterns |

```

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

### Install and Use md-tree Parser

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/web-bundles/teams/team-fullstack.txt

Instructions for installing the markdown-tree-parser globally using npm and examples of using the `md-tree explode` command for sharding markdown documents.

```bash
npm install -g @kayvan/markdown-tree-parser
```

```bash
# For PRD
md-tree explode docs/prd.md docs/prd

# For Architecture
md-tree explode docs/architecture.md docs/architecture

# For any document
md-tree explode [source-document] [destination-folder]
```

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

### BMad KB Mode Interaction Example

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/web-bundles/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt

Illustrates an example interaction with BMad's Knowledge Base (KB) mode. It shows how a user can enter KB mode and inquire about specific topics like 'workflows', and how the assistant responds with relevant information and further exploration options.

```bash
User: *kb-mode

Assistant: I've entered KB mode and have access to the full BMad knowledge base. I can help you with detailed information about any aspect of BMad-Method.

What would you like to know more about?

1. **Setup & Installation** - Getting started with BMad
2. **Workflows** - Choosing the right workflow for your project
3. **Web vs IDE** - When to use each environment
4. **Agents** - Understanding specialized agents and their roles
5. **Documents** - PRDs, Architecture, Stories, and more
6. **Agile Process** - How BMad implements Agile methodologies
7. **Configuration** - Customizing BMad for your needs
8. **Best Practices** - Tips for effective BMad usage

Or ask me about anything else related to BMad-Method!

User: Tell me about workflows

Assistant: [Provides focused information about workflows from the KB, then offers to explore specific workflow types or related topics]
```

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

### Tech Stack Table Examples

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/web-bundles/agents/bmad-master.txt

Provides examples for populating the technology stack table, including essential components like Language, Runtime, and Framework, along with their versions, purposes, and justifications.

```Markdown
| **Language** | TypeScript | 5.3.3 | Primary development language | Strong typing, excellent tooling, team expertise |

```

```Markdown
| **Runtime** | Node.js | 20.11.0 | JavaScript runtime | LTS version, stable performance, wide ecosystem |

```

```Markdown
| **Framework** | NestJS | 10.3.2 | Backend framework | Enterprise-ready, good DI, matches team patterns |

```

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

### Install p-locate

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/apps/api/node_modules/pkg-dir/node_modules/p-locate/readme.md

Installs the p-locate package using npm. This is the first step to using the p-locate functionality in your project.

```bash
$ npm install p-locate
```

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

### BMAD Creative Writing Quick Start Commands

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/web-bundles/expansion-packs/bmad-creative-writing/agents/world-builder.txt

Provides a list of essential commands for interacting with the BMAD Creative Writing agent. These commands help users initiate various writing and analysis tasks.

```bash
*help - Show available agent commands
*create-outline - Start story structure
*create-profile - Develop character
*analyze-structure - Review plot mechanics
*workshop-dialog - Refine character voices
*yolo - Toggle fast-drafting mode
```

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

### Install path-key using npm

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/apps/api/node_modules/path-key/readme.md

This snippet shows how to install the path-key package using npm, which is the standard package manager for Node.js.

```bash
$ npm install path-key
```

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

### Unity Project Foundation & Core Systems Design

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/web-bundles/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.txt

Sets up the Unity project with best practices for folder structure, naming conventions, and core architecture. Includes input system configuration, scene management, development tools, and initial build pipeline setup.

```C#
- Unity project setup with proper folder structure and naming conventions
- Core architecture implementation ({{architecture_pattern}})
- Input System configuration with action maps for all platforms
- Basic scene management and state handling
- Development tools setup (debugging, profiling integration)
- Initial build pipeline and platform configuration
```

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

### Game Design Document Section: Initial Setup

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/web-bundles/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt

Instruction for the initial setup section of a GDD, emphasizing the creation of a comprehensive document for game development, focusing on gameplay systems, mechanics, and technical requirements.

```markdown
sections:
  - id: initial-setup
    instruction: |
      This template creates a comprehensive Game Design Document that will serve as the foundation for all game development work. The GDD should be detailed enough that developers can create user stories and epics from it. Focus on gameplay systems, mechanics, and technical requirements that can be broken down into implementable features.

      If available, review any provided documents or ask if any are optionally available: Project Brief, Market Research, Competitive Analysis
```

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

### Start Workflow

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/web-bundles/agents/bmad-orchestrator.txt

Initiates a specific workflow identified by its unique ID. Upon starting, the workflow transitions to its first agent, guiding the user through the initial steps.

```Bash
/workflow-start {workflow-id}
```

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

### node-pre-gyp Build from Source Example

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/apps/api/node_modules/@mapbox/node-pre-gyp/README.md

Provides an example of how to trigger a build from source for a specific module when installing dependencies, useful for custom builds or when pre-built binaries are unavailable.

```bash
npm install --build-from-source=myapp
```

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

### Install string-width using npm

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/apps/api/node_modules/string-width/readme.md

Installs the string-width package using the Node Package Manager (npm). This is the standard way to add the package as a dependency to your project.

```bash
$ npm install string-width
```

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

### Install bmad-method for Unity Game Development

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/web-bundles/expansion-packs/bmad-2d-unity-game-dev/teams/unity-2d-game-team.txt

Provides the command-line instruction to install the 'bmad-method' tool, which includes an expansion pack for 2D Unity game development. This is recommended for interactive installation.

```bash
npx bmad-method install
```

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

### Unity Project Setup & Core Architecture

Source: https://github.com/anthony-wu-1226/facemakeai/blob/main/web-bundles/expansion-packs/bmad-2d-unity-game-dev/teams/unity-2d-game-team.txt

Establishes the foundational elements of a Unity project, including folder structure, naming conventions, core architecture, input system configuration, scene management, and development tool setup. It also covers initial build pipeline and platform configuration.

```C#
// Unity project setup with proper folder structure and naming conventions
// Core architecture implementation (e.g., MVC, ECS)
// Input System configuration with action maps for all platforms
// Basic scene management and state handling
// Development tools setup (debugging, profiling integration)
// Initial build pipeline and platform configuration
```