Bootspring
HomeGet Started

bootspring_generate

Regenerate the CLAUDE.md context file with current project state.

Overview#

The bootspring_generate tool regenerates your project's CLAUDE.md file, updating it with the latest project information, configurations, and learnings. This ensures your AI assistant always has accurate context about your project.

Parameters#

ParameterTypeRequiredDescription
fullbooleanNoFull regeneration including .mcp.json and todo.md

Usage Examples#

Basic Generation#

Use the bootspring_generate tool with no parameters

Response:

Generated CLAUDE.md at /path/to/project/CLAUDE.md

Full Generation#

Use the bootspring_generate tool with: - full: true

Response:

Generated CLAUDE.md at /path/to/project/CLAUDE.md Generated .mcp.json at /path/to/project/.mcp.json Generated todo.md at /path/to/project/todo.md

What Gets Generated#

CLAUDE.md Contents#

The generated file includes:

1# My Project - AI Context 2 3**Generated by**: Bootspring v1.x.x 4**Last Updated**: YYYY-MM-DD 5**Status**: [initialized|developing|production] 6**Health**: [good|fair|needs-attention] 7 8--- 9 10## Project Overview 11 12[Auto-detected project description] 13 14--- 15 16## Tech Stack 17 18| Component | Technology | 19|-----------|------------| 20| Framework | [detected] | 21| Language | [detected] | 22| Database | [detected] | 23| Hosting | [detected] | 24 25--- 26 27## Enabled Plugins 28 29### Database 30- **Provider**: [prisma|drizzle|etc] 31- **Features**: [list] 32 33### Testing 34- **Provider**: [vitest|jest|etc] 35- **Features**: [list] 36 37--- 38 39## Bootspring Commands 40 41[Available commands and usage] 42 43--- 44 45## Current State 46 47- **Phase**: [phase] 48- **Health**: [health] 49- **Open Todos**: [count] 50- **Issues**: [list] 51 52--- 53 54## Git Repository 55 56- **Branch**: [current branch] 57- **Remote**: [configured|not configured] 58 59--- 60 61## Recent Learnings 62 63[From git memory] 64 65--- 66 67## Project Structure 68 69- **Structure Type**: [flat|monorepo] 70- **Has TypeScript**: [yes|no] 71- **Has Package.json**: [yes|no] 72 73--- 74 75## Development Guidelines 76 77[Code style, best practices, git commits]

Configuration#

Configure generation in bootspring.config.js:

1module.exports = { 2 paths: { 3 context: 'CLAUDE.md' // Output path 4 }, 5 context: { 6 includePatterns: true, 7 includeStack: true, 8 includeConventions: true, 9 customSections: [ 10 { 11 title: 'Team Guidelines', 12 content: 'Our specific guidelines...' 13 } 14 ] 15 } 16};

When to Regenerate#

Automatically Trigger#

Consider regenerating when:

  • Adding new dependencies
  • Changing project structure
  • Updating configurations
  • After major feature additions
  • Changing coding standards

Manual Trigger#

Use the tool directly when you want to ensure context is fresh:

Regenerate my CLAUDE.md file

CLI Integration#

You can also regenerate via CLI:

1# Basic generation 2bootspring generate 3 4# Full generation 5bootspring generate --full 6 7# Specify output path 8bootspring generate --output docs/AI-CONTEXT.md

Generated File Location#

By default, CLAUDE.md is created in your project root:

my-project/ ├── CLAUDE.md # Generated context file ├── package.json ├── src/ └── ...

Customization#

Custom Sections#

Add project-specific sections:

1// bootspring.config.js 2module.exports = { 3 context: { 4 customSections: [ 5 { 6 title: 'API Conventions', 7 content: ` 8 - All endpoints return JSON 9 - Use camelCase for field names 10 - Include pagination for lists 11 ` 12 }, 13 { 14 title: 'Component Guidelines', 15 content: ` 16 - Use functional components 17 - Prefer composition over props 18 - Include TypeScript types 19 ` 20 } 21 ] 22 } 23};

Exclude Patterns#

Control what gets detected:

1module.exports = { 2 context: { 3 exclude: [ 4 '**/node_modules/**', 5 '**/dist/**', 6 '**/*.test.ts' 7 ] 8 } 9};

Error Handling#

No Config Found#

If no configuration exists:

Warning: No bootspring.config.js found, using defaults Generated CLAUDE.md at /path/to/project/CLAUDE.md

Permission Error#

If the file cannot be written:

{ "error": "Cannot write to CLAUDE.md", "details": "Permission denied" }

Best Practices#

Version Control#

Commit CLAUDE.md to version control so the entire team benefits from consistent AI context.

Regular Updates#

Regenerate periodically, especially after significant changes.

Review Generated Content#

Verify the generated content is accurate and add custom sections for project-specific context.

Keep It Current#

An outdated context file can lead to incorrect AI suggestions.

Related Tools#