KubeRocketAI
>/quickstart>/architecture>/use-cases>/faq>/roadmap>/tutorials
Starred...
Quick Start Guide

Get Running in
3 Minutes

From zero to AI agent management with KubeRocketAI. No plugins, no complex setup—just pure developer productivity.
3min

3 Minutes

From install to first agent

7

7 Agents

Complete SDLC team ready

✓

Validation

Built-in configuration checks

Git

Version Control

Agent definitions in Git

Install KubeRocketAI

macOS (Recommended)

brew tap KubeRocketCI/homebrew-tap && brew install krci-ai

Linux/Windows

curl -L "https://github.com/KubeRocketCI/kuberocketai/releases/latest/download/krci-ai_Linux_x86_64.tar.gz" | tar -xz chmod +x krci-ai && sudo mv krci-ai /usr/local/bin/
Windows users: Download from releases page

Start in 3 Minutes

1
Install Framework20 seconds

Get KubeRocketAI CLI with IDE integration
terminal
$ krci-ai install --ide=claude
Output:
🔄 Installing KubeRocketAI framework components...
ℹ️ IDE integration: claude
ℹ️ Creating .krci-ai directory structure...
ℹ️ Setting up Claude Code integration...
✅ Claude Code integration installed successfully!
✅ Framework installation completed successfully!
ℹ️ Framework components installed to: .krci-ai
ℹ️
Next steps:
ℹ️   • Run 'krci-ai list agents' to see available agents
ℹ️   • Run 'krci-ai validate' to verify installation
ℹ️   • Claude Code commands installed to: .claude/commands/krci-ai/

2
Meet Your Team10 seconds

Discover available AI agents and their roles
terminal
$ krci-ai list agents
Output:
✅ Found 7 agent(s):

Name         | Role               | Description
------------ | ------------------ | -----------------------------------
architect    | Software Architect | Software architect specializing in system design and architecture guidance
ba           | Business Analyst   | Business analyst specializing in requirements gathering...
dev          | Software Developer | Software Developer for implementation and code assistance
pm           | Product Manager    | Product manager specializing in product strategy, requirements...
po           | Product Owner      | Product owner specializing in user story creation and agile...
qa           | QA Engineer        | Quality assurance engineer specializing in testing strategy, test...

ℹ️ Use 'krci-ai list agents -v' for dependency table showing tasks, templates, and data

3
Start Your First Project2 minutes

Use the developer agent in Claude Code
terminal
$ claude .
Output:
╭───────────────────────────────────────────────────────────────────────╮
│ ✻ Welcome to Claude Code!                                             │
│                                                                       │
│   /help for help, /status for your current setup                      │
│                                                                       │
│   cwd: /Users/username/krci-ai-spa                                    │
╰───────────────────────────────────────────────────────────────────────╯

> /krci-ai:dev

Hello! I'm Alex Developer, your Software Developer 💻

I'm here to help build beautiful, performant, and accessible user interfaces
for the KubeRocketAI showcase website.

Available Commands:
- help - Show available commands
- chat - Development consultation and assistance
- add-component - Create new component
- optimize-code - Code optimization
- exit - Exit Developer persona

What would you like to work on today?

4
Validate Everything Works10 seconds

Ensure your setup is working correctly
terminal
$ krci-ai validate
Output:
🔍 Validating framework integrity...

✅ FRAMEWORK VALID

📊 Overview: 7 agents, 24 tasks, 14 templates, 11 data files
🔗 All internal links resolved (33 references checked)

💡 FRAMEWORK INSIGHTS:
   • architect → 4 tasks → 3 templates
   • ba → 4 tasks → 4 templates
   • dev → 3 tasks → 1 templates
   • pm → 4 tasks → 2 templates
   • po → 5 tasks → 2 templates
   • qa → 4 tasks → 4 templates
   • Most used template: story.md (used by 3 tasks)
⚡ Validation completed in 0.0s

Exit code: 0 (framework functional)

5
Create Web Chat Bundle30 seconds

Bundle agents for ChatGPT/Claude Web
terminal
$ krci-ai bundle --all --output project-context.md
Output:
🔄 Validating framework integrity...
✅ Framework validation passed
🔄 Discovering agents and dependencies...
ℹ️ Generating bundle: /tmp/test/.krci-ai/bundle/project-context.md
✅ Bundle generated successfully!
ℹ️ Bundle file: /tmp/test/.krci-ai/bundle/project-context.md
ℹ️ Bundle size: 293329 bytes
ℹ️
Usage instructions:
ℹ️ • Copy the entire bundle content to your web chat tool (ChatGPT, Claude Web, Gemini Pro)
ℹ️ • The bundle includes all agents, tasks, templates, and project-specific data
ℹ️ • Each section is clearly separated with collision-resistant delimiters

🎯 You're Ready!

Your agents are ready to be customized with project context using reusable SDLC framework rules.

Core Concepts

Understand framework fundamentals and principles

Learn More

Architecture

See how components work together seamlessly

View Architecture

Contributing

Customize and extend the framework rules

Contribute

Frequently Asked Questions

KubeRocketAI installation is designed to be completed in under 3 minutes:

1. Install CLI (30 seconds): Download and install the krci-ai CLI tool

2. Install Framework (20 seconds): Run krci-ai install to set up local agents

3. IDE Integration (automatic): Your AI-powered IDE automatically detects the framework

bash
# macOS installation
brew tap KubeRocketCI/homebrew-tap
brew install krci-ai

# Install framework with IDE integration
krci-ai install --ide=claude
# Done! Your IDE now has access to SDLC agents

For detailed installation steps and troubleshooting, see our Quick Start Guide.

KubeRocketAI works with any AI-powered IDE through automated configuration generation:

Officially Supported:

  • •Cursor - Generates .cursor/rules/*.mdc files for native integration
  • •Claude - Creates .claude/commands/*.md files for web-based IDE
  • •VS Code - Configures GitHub Copilot Chat integration via .vscode/
  • •Windsurf - Generates .windsurf/rules/*.md files for Cascade interface

    • Installation Examples:

    bash
    krci-ai install --ide=cursor   # Cursor IDE integration
krci-ai install --ide=claude   # Claude IDE integration
krci-ai install --ide=vscode   # GitHub Copilot integration
krci-ai install --ide=windsurf # Windsurf IDE integration
krci-ai install --ide=all      # All IDE integrations

    Universal Compatibility:

    The framework uses declarative AI-as-Code files that any AI IDE can read from the filesystem. No plugins or extensions required.

    See our complete IDE compatibility overview in the Supported IDEs section.

    Yes! KubeRocketAI enhances your existing AI workflow rather than replacing it:

    Compatibility with:

  • •GitHub Copilot Chat integration (via VS Code)
  • •Web chat tools (ChatGPT, Claude, Gemini) via bundle export
  • •Existing prompt libraries and custom workflows
  • •IDE-based AI assistants (Cursor, Claude Code, Windsurf)

    • How it works together:

  • •KubeRocketAI provides structured agent personas for SDLC tasks
  • •Your existing tools handle general coding assistance
  • •The framework maintains project context in version-controlled files
  • •Export bundles to web chat tools: krci-ai bundle --all --output project-context.md

    • Example Workflow:

    1. Use /pm agent in Claude Code for project planning

    2. Switch to GitHub Copilot for code completion

    3. Export framework context for web chat: krci-ai bundle --agent qa

    4. All context is maintained in your .krci-ai/ project files

    Learn how to set up integration with your existing tools in our Quick Start Guide.

    Even if your IDE isn't explicitly supported, KubeRocketAI provides several fallback options:

    Fallback Options:

    1. Bundle Export: Generate complete framework bundles for any AI tool

    bash
    krci-ai bundle --all --output my-framework.md
   krci-ai bundle --agent pm,architect --output targeted.md

    2. Direct File Access: Reference agent files from .krci-ai/ directory

  • • - Agents: .krci-ai/agents/*.yaml
  • • - Tasks: .krci-ai/tasks/*.md
  • • - Templates: .krci-ai/templates/*.md

    • 3. Manual Import: Copy generated bundles into your AI tool's prompt library

    Community Contributions:

  • •Request IDE Support: Submit feature requests for new IDE integrations
  • •Open Source: Submit compatibility reports for your IDE
  • •Documentation: Help us document setup for additional tools
  • •Testing: Join our community testing program

    • Universal Principles:

    The framework uses standard text files and markdown - any AI tool that can read files can use KubeRocketAI agents. The bundle system works with ChatGPT, Claude Web, Gemini Pro, and any other AI platform.

    Check our Quick Start Guide for alternative setup methods and supported IDE sections for community contributions.

    View All FAQ