Bootspring
HomeGet Started

Quick Start Guide

Build your first project with Bootspring in 5 minutes.

Step 1: Install Bootspring#

npx bootspring init

Step 2: Start Your AI Assistant#

Open your MCP-compatible AI assistant (Claude Code, Cursor, etc.) in your project directory.

Step 3: Invoke an Agent#

Ask your AI assistant to use a Bootspring agent:

Use the frontend-expert agent to help me build a React component for a user profile card.

The AI will automatically use the bootspring_agent tool to invoke the frontend expert.

Step 4: Generate Context#

Keep your AI informed about your project:

Generate a CLAUDE.md context file for this project.

This creates a comprehensive context file that helps your AI understand your codebase.

Step 5: Use Quality Gates#

Before committing code, run quality checks:

Run the pre-commit quality gate on my changes.

Example Workflow#

Here's a complete example building a feature with Bootspring:

1. Plan with an Agent#

Use the software-architect agent to help me plan a user authentication system.

Response includes:

  • Architecture recommendations
  • Technology suggestions
  • Security considerations
  • Implementation steps

2. Implement with Expert Guidance#

Use the backend-expert agent to implement JWT authentication in my Express app.

Response includes:

  • Production-ready code
  • Security best practices
  • Error handling
  • Testing recommendations

3. Add Database Layer#

Use the database-expert agent to design the user schema with Prisma.

Response includes:

  • Optimized schema design
  • Index recommendations
  • Migration strategy
  • Query examples

4. Build the Frontend#

Use the frontend-expert agent to create a login form with React and proper validation.

Response includes:

  • Accessible component code
  • Form validation
  • Error states
  • Loading states

5. Quality Check#

Run quality gates on all my new files.

Response includes:

  • Code quality analysis
  • Security scan results
  • Performance suggestions
  • Improvement recommendations

Using Skills#

Skills are reusable patterns. Use them like this:

Use the api-endpoint skill to create a POST /api/users endpoint.

Available skills:

  • api-endpoint - RESTful endpoint patterns
  • react-component - React component templates
  • prisma-crud - Database CRUD operations
  • auth-flow - Authentication patterns
  • test-suite - Testing patterns
  • error-handling - Error management
  • validation - Input validation

Using MCP Tools Directly#

You can also use Bootspring's MCP tools directly:

Use the bootspring_search tool to find all authentication-related patterns.
Use the bootspring_quality tool to run a security scan.

Tips for Best Results#

Be Specific#

Instead of: "Help me with the frontend" Try: "Use the frontend-expert agent to create an accessible dropdown menu with keyboard navigation"

Provide Context#

Instead of: "Fix this bug" Try: "Use the debugging-detective agent to analyze why the login form submits twice"

Chain Agents#

For complex tasks, use multiple agents:

  1. software-architect - Plan the approach
  2. backend-expert - Implement server logic
  3. frontend-expert - Build the UI
  4. testing-expert - Write tests
  5. security-expert - Security review

Keep Context Updated#

Regenerate your CLAUDE.md when:

  • Adding new dependencies
  • Changing project structure
  • Updating coding standards
Regenerate the CLAUDE.md context file to include my recent changes.

Next Steps#