https://github.com/kuberocketci/kuberocketai
Declarative agentic framework for AI-driven software development. Define, validate, and orchestrate AI agents as code—transparent, auditable, and CI/CD-ready. Run your SDLC as Code today
https://github.com/kuberocketci/kuberocketai
agentic-ai agentic-framework agents ai ai-as-code claude-code cursor kuberocketai kuberocketci sdlc-as-code software-development vscode windsurf
Last synced: 2 months ago
JSON representation
Declarative agentic framework for AI-driven software development. Define, validate, and orchestrate AI agents as code—transparent, auditable, and CI/CD-ready. Run your SDLC as Code today
- Host: GitHub
- URL: https://github.com/kuberocketci/kuberocketai
- Owner: KubeRocketCI
- License: apache-2.0
- Created: 2025-07-06T12:06:42.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-08-04T12:35:26.000Z (2 months ago)
- Last Synced: 2025-08-04T16:51:07.526Z (2 months ago)
- Topics: agentic-ai, agentic-framework, agents, ai, ai-as-code, claude-code, cursor, kuberocketai, kuberocketci, sdlc-as-code, software-development, vscode, windsurf
- Language: Go
- Homepage: https://docs.kuberocketci.io
- Size: 697 KB
- Stars: 18
- Watchers: 1
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# KubeRocketAI: AI-as-Code Framework That Simply Works On Any Platform
[](https://github.com/KubeRocketCI/kuberocketai/releases/latest)
[](https://github.com/KubeRocketCI/kuberocketai/actions/workflows/ci.yml)
[](https://sonarcloud.io/summary/new_code?id=kuberocketci_kuberocketai)
[](https://sonarcloud.io/summary/new_code?id=kuberocketci_kuberocketai)
[](https://goreportcard.com/report/github.com/KubeRocketCI/kuberocketai)
[](go.mod)
[](LICENSE)
[](.krci-ai)
AI-as-Code framework for structuring AI-assisted software development. Define AI agents as version-controlled Markdown files with YAML frontmatter.
## Problem
You've figured out how to make AI agents understand your project. You've crafted the perfect prompts, built context-aware agents, and your AI-generated code actually works. **Now what?**
The real challenge isn't creating smart agents—it's **scaling that success** across your team, projects, and workflow.
### What Happens When It Actually Works
- **"How do I share this with my team?"** - You've spent weeks perfecting an agent configuration, but there's no clean way to distribute it beyond copy-pasting prompts in Slack
- **"Which version was working?"** - Your agent setup evolved over time, but when something breaks, you can't roll back to the version that was working last week
- **"I need this in my IDE, not just ChatGPT"** - Your perfect brainstorming agent lives in a web interface, but you need it integrated into your actual development workflow
- **"Can we run this in CI?"** - Your agents work great for interactive development, but you need them for code review, documentation generation, and automated analysis
- **"How do we maintain this across 10 repositories?"** - Each project needs slight variations, but managing separate configurations becomes a nightmare
### The Scaling Problem
- **No Distribution System**: Agents remain isolated to individuals or require manual sharing through ad-hoc methods
- **Version Control Gap**: Agent configurations evolve without proper versioning, making it impossible to track what works and what doesn't
- **Platform Lock-in**: Agents tied to specific tools can't be moved, adapted, or integrated into different parts of your workflow
- **Maintenance Overhead**: As your agent library grows, keeping configurations synchronized across projects becomes unmanageable
- **Quality Assurance**: No systematic way to validate that agents work correctly before deploying them across teams or into production workflows
- **Context Fragmentation**: Web-based AI tools lose critical project context, forcing manual re-explanation of architecture, patterns, and organizational standards for each interaction
## Solution
KubeRocketAI brings the proven **"Infrastructure-as-Code" model to AI agent management**. Teams define agents in version-controlled Markdown files that integrate seamlessly with existing development workflows, enabling the same declarative approach developers expect from modern CI/CD pipelines.
### Video Overview
For a practical case study on product development with project-specific AI agent customization, see:
**[Feature Implementation with KubeRocketAI: From Product Requirements to Code in Production (YouTube)](https://www.youtube.com/watch?v=Prr__elEI9A&ab_channel=ThePlatformTeam)**
This video demonstrates how KubeRocketAI applies AI-as-Code principles to deliver local agent components tailored to project needs while maintaining organizational standards. It covers the full journey from product strategy and requirements updates to technical implementation and validation. You'll see how teams can systematically manage agent customization, update PRDs, define epics and stories, and implement solutions using the framework and CLI tools.
### Key Value Propositions
1. **Agent-as-Code Distribution**: Version-control and share your proven agent configurations just like you do with Infrastructure-as-Code
2. **Multi-Platform Injection**: Deploy the same agent definition to your IDE, CI pipeline, bundled for brainstorming, or wherever you need AI assistance
3. **Built-in Validation**: Validate agent configurations and dependencies before deployment, ensuring consistent behavior across environments
4. **Context-Preserving Bundling**: Package agents with full project context for web chat tools, maintaining architectural knowledge and organizational standards across platforms
5. **Scalable Team Workflows**: Maintain agent libraries across multiple projects and repositories without configuration hell
## Smart Context Bundling
**Two deployment modes for different contexts:**
### IDE Integration: Limited, Focused Context
Deploy agents directly into your development environment with project-specific context optimized for coding tasks.
### Web Chat: Full Context for Strategic Work
Bundle agents with complete project assets for brainstorming and requirements elicitation in high-context models (ChatGPT, Claude, Gemini Pro).
```bash
# IDE: Focused development context
krci-ai install --ide=cursor
# Web Chat: Complete project context for strategic sessions
krci-ai bundle --all --output brainstorm-context.md
```
## High Level Project Diagram
This diagram illustrates the AI-as-Code approach for AI agents, showing how KubeRocketAI enables declarative AI-as-Code management within existing developer workflows.
```mermaid
graph TD
subgraph "Local Developer Environment"
Developer["👨💻 Developer
Uses existing tools"]
CLI["🛠️ krci-ai CLI
📦 Embedded Framework Assets
🔧 AI-as-Code Management"]
IDE["🎨 AI-Powered IDE
Native Integration
(No plugins required)"]
LocalFramework["📁 ./krci-ai/
🔗 Declarative AI Agents
📋 Extracted + Local"]
TargetProject["💻 Target Project
🔀 Git Repository"]
end
subgraph "Internet/Cloud (Post-MVP)"
GoldenRepo["🏢 Golden Source
🔗 Git Repository
🤖 AI-as-Code
🔮 Future Enhancement"]
end
Developer --> CLI
Developer --> IDE
CLI -->|"📦 Extract embedded assets
Offline operation"| LocalFramework
IDE -.->|"📖 Reads declarative configs
Native filesystem access"| LocalFramework
LocalFramework --> TargetProject
GoldenRepo -.->|"🔮 Post-MVP: Remote updates
Community contributions"| CLI
TargetProject -.->|"🔄 Future: Contribute back
Local customizations"| GoldenRepo
style CLI fill:#e3f2fd,stroke:#1976d2,stroke-width:2px
style IDE fill:#fff3e0,stroke:#f57c00,stroke-width:2px
style GoldenRepo fill:#f0f0f0,stroke:#999999,stroke-width:1px,stroke-dasharray: 5 5
style LocalFramework fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px
```
## Installation
### macOS - Homebrew (Recommended)
```bash
# Add the KubeRocketCI tap
brew tap KubeRocketCI/homebrew-tap
# Install krci-ai
brew install krci-ai
```
### Linux - Direct Download
```bash
# Download and extract latest release
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 - Direct Download
1. Download the latest release: [krci-ai_Windows_x86_64.zip](https://github.com/KubeRocketCI/kuberocketai/releases/latest/download/krci-ai_Windows_x86_64.zip)
2. Extract the zip file
3. Add the `krci-ai.exe` to your PATH or move it to a directory in your PATH
### Build from Source
```bash
git clone https://github.com/KubeRocketCI/kuberocketai.git
cd kuberocketai
make build
```
### Update & Uninstall
```bash
# Update via Homebrew
brew update && brew upgrade krci-ai
# Uninstall via Homebrew
brew uninstall krci-ai
```
## Usage
### Quick Start
```bash
# Install framework with IDE integration
krci-ai install --ide=cursor
# Validate your agent configurations
krci-ai validate --all
# Create context-aware bundles for web chat tools
krci-ai bundle --all --output project-context.md
# List available agents
krci-ai list agents
# Install with all IDE integrations
krci-ai install --all
```
## Success Metrics
KubeRocketAI succeeds when you can scale your AI workflow like you scale your infrastructure:
- **Agent Reusability**: Deploy proven configurations across multiple projects without manual setup
- **Quality Assurance**: Validate agent configurations before deployment to catch issues early
- **Version Control Integration**: Track what works, roll back when things break, collaborate on improvements
- **Platform Flexibility**: Use the same agent definitions for IDE development, CI automation, and brainstorming sessions
Our goal: Turn your AI agent expertise into scalable, maintainable infrastructure.
## Inspiration & Related Work
KubeRocketAI builds upon the excellent work of several innovative frameworks that enhance AI-powered development workflows. We're particularly inspired by [Awesome Claude](https://github.com/hesreallyhim/awesome-claude-code), which curates powerful commands and workflows for Claude Code productivity. The [BMAD method](https://github.com/bmadcode/BMAD-METHOD) contributes robust agile AI-driven development practices with impressive context management through sharding and delegation. [Claude Flow](https://github.com/ruvnet/claude-flow) pioneered multi-agent orchestration with specialized development modes like Architect and Coder. [SuperClaude](https://github.com/NomenAK/SuperClaude) demonstrates advanced persona specialization and Git-based memory features.
## Target Users
### Teams That Have Figured Out AI, But Need to Scale It
**You'll love this if you:**
- Have created effective AI agents but struggle to share them across your team
- Want to version-control your agent configurations just like you do with your infrastructure
- Need validation and quality assurance for agents before deploying them across projects
- Need the same agents working in multiple contexts: IDE, CI/CD, brainstorming, code review
- Maintain multiple repositories and are tired of keeping agent configurations in sync
- Have proven AI workflows but no systematic way to scale them across projects
**Perfect for:**
- **Senior AI Engineers**: Have mastered individual agent creation, now need enterprise-scale management
- **DevOps-Minded Teams**: Want to apply Infrastructure-as-Code principles to AI agent management
- **Multi-Project Teams**: Need consistent AI capabilities across different repositories and contexts
- **AI-First Organizations**: Ready to systematize their AI workflows beyond individual experimentation
## Documentation
📚 **Complete documentation available at [/docs](/docs)**
- **[Quick Start Guide](/docs/quick-start.md)** - Get running in 3 minutes
- **[Core Concepts](/docs/concepts.md)** - Understand AI-as-Code principles
- **[Architecture Overview](/docs/architecture.md)** - System design and components
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines.
## License
Apache-2.0 License - see [LICENSE](LICENSE) for details.