bootspring generate | Bootspring Docs

Regenerate the CLAUDE.md context file.

Synopsis#

bootspring generate [options]

Description#

The generate command regenerates your project's CLAUDE.md file with the latest project information. This ensures your AI assistant always has accurate context.

Options#

Option	Description
`--full`	Full generation including .mcp.json and todo.md
`--output <path>`	Custom output path for CLAUDE.md
`--verbose`	Show detailed generation output
`--force`	Overwrite without confirmation

Usage Examples#

Basic Generation#

bootspring generate

Output:

Analyzing project...
✓ Detected Next.js 14 (App Router)
✓ Detected TypeScript 5.3
✓ Detected Prisma with PostgreSQL
✓ Found 45 components
✓ Found 12 API routes

Generated CLAUDE.md (12.4 KB)

Full Generation#

bootspring generate --full

Regenerates all Bootspring files:

CLAUDE.md
.mcp.json
todo.md (if doesn't exist)

Custom Output#

bootspring generate --output docs/AI-CONTEXT.md

Verbose Output#

bootspring generate --verbose

Shows detailed information about what's being detected and included.

What Gets Analyzed#

Project Files#

Source	Information Extracted
`package.json`	Dependencies, scripts, version
`tsconfig.json`	TypeScript configuration
`next.config.*`	Next.js settings
`prisma/schema.prisma`	Database schema
`src/` or `app/`	Project structure
`.env.example`	Required environment variables

Git Repository#

Source	Information Extracted
`.git/`	Branch, remote status
Commit history	Recent learnings, patterns
Contributors	Team size

Bootspring State#

Source	Information Extracted
`bootspring.config.js`	Custom settings
`todo.md`	Open tasks
`.bootspring/`	Workflow state

Generated Content#

The CLAUDE.md file includes:

# Project Name - AI Context

**Generated**: 2024-03-20
**Bootspring**: v1.x.x

## Project Overview
[Auto-detected description]

## Tech Stack
| Category | Technology |
|----------|------------|
| Framework | Next.js 14 |
| Language | TypeScript |
| ...

## Project Structure
[Directory tree]

## Conventions
[Detected code patterns]

## Commands
[Available npm scripts]

## Current State
- Phase: [development phase]
- Open Todos: [count]
- Health: [status]

## Recent Learnings
[From git history]

## Custom Sections
[From config]

Customization#

Add Custom Sections#

In bootspring.config.js:

module.exports = {
  context: {
    customSections: [
      {
        title: 'Team Conventions',
        content: `
          - Use conventional commits
          - PR reviews required
          - Deploy only on weekdays
        `,
      },
    ],
  },
};

Exclude Files#

module.exports = {
  context: {
    exclude: [
      '**/node_modules/**',
      '**/dist/**',
      '**/*.test.ts',
      '**/fixtures/**',
    ],
  },
};

Include Extra Sources#

module.exports = {
  context: {
    include: [
      'docs/ARCHITECTURE.md',
      'docs/API.md',
      '.github/CONTRIBUTING.md',
    ],
  },
};

When to Regenerate#

Automatically Recommended#

After adding new dependencies
When project structure changes
After major feature additions
When onboarding new team members

Manual Triggers#

# After npm install
npm install some-package && bootspring generate

# After significant changes
git pull && bootspring generate

# Before AI-assisted work sessions
bootspring generate && claude

CI Integration#

Add to your CI pipeline:

# .github/workflows/context.yml
name: Update Context

on:
  push:
    branches: [main]
    paths:
      - 'package.json'
      - 'prisma/schema.prisma'
      - 'src/**'

jobs:
  update:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
      - run: npm ci
      - run: npx bootspring generate
      - uses: stefanzweifel/git-auto-commit-action@v5
        with:
          commit_message: 'chore: update AI context'
          file_pattern: 'CLAUDE.md'

Troubleshooting#

Detection Issues#

# Show what's being detected
bootspring generate --verbose

Override Detection#

// bootspring.config.js
module.exports = {
  stack: {
    frontend: ['react', 'nextjs'],  // Override auto-detection
    database: ['postgresql', 'prisma'],
  },
};

Large Projects#

For large projects, limit scope:

module.exports = {
  context: {
    maxSize: 50000,  // Limit to 50KB
    exclude: ['**/vendor/**', '**/generated/**'],
  },
};

bootspring init - Initial setup
bootspring status - Check project status
bootspring context - MCP tool equivalent