From a324a6bc6bc295ebe0707e80deaa67c45b58b83e Mon Sep 17 00:00:00 2001 From: Sergiy Kulanov Date: Wed, 22 Oct 2025 11:34:59 +0300 Subject: [PATCH] chore: Update changelog Signed-off-by: Sergiy Kulanov --- CHANGELOG.md | 42 ++++++++++++++- CLAUDE.md | 150 --------------------------------------------------- 2 files changed, 41 insertions(+), 151 deletions(-) delete mode 100644 CLAUDE.md diff --git a/CHANGELOG.md b/CHANGELOG.md index 7cc292b..9f8f7d8 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -15,6 +15,42 @@ brew install krci-ai ### [Unreleased] +#### Features + +* [44a4da3](https://github.com/KubeRocketCI/kuberocketai/commit/44a4da3e9ed260584f7bcaf2166eb3c111277bed) Add unbundle command to extract files from bundle ([#127](https://github.com/KubeRocketCI/kuberocketai/issues/127)) + + + +### [v0.44.0] - 2025-10-17 + +#### Features + +* [44f8dda](https://github.com/KubeRocketCI/kuberocketai/commit/44f8dda68e9455dcddbc2f514027a9bbb37b91c6) Add sync-ide functionality for IDE integration + + + +### [v0.43.0] - 2025-10-10 + +#### Features + +* [5e93b74](https://github.com/KubeRocketCI/kuberocketai/commit/5e93b7428837c85ccad4a835a5a580be89c1ee84) Use installed agents for bundle generation + + + +### [v0.42.0] - 2025-10-09 + +#### Bug Fixes + +* [a691b4a](https://github.com/KubeRocketCI/kuberocketai/commit/a691b4a56fd2f4bda98973b0ecfd4cd1d2980183) Commands fail on Windows due to incorrect paths + + + +### [v0.41.2] - 2025-10-05 + +#### Chores + +* [6c4b7a1](https://github.com/KubeRocketCI/kuberocketai/commit/6c4b7a129da5534e6998cc58f66751a70adf8a9a) Update devops agent task that manages GitLab CI/CD Component + ### [v0.41.1] - 2025-10-04 @@ -1003,7 +1039,11 @@ Content Guidelines sections restructured * [4adcbf3](https://github.com/KubeRocketCI/kuberocketai/commit/4adcbf3c5fc91698f810e47cca29b55930d14710) initial project setup with CLI foundation and CI/CD -[Unreleased]: https://github.com/KubeRocketCI/kuberocketai/compare/v0.41.1...HEAD +[Unreleased]: https://github.com/KubeRocketCI/kuberocketai/compare/v0.44.0...HEAD +[v0.44.0]: https://github.com/KubeRocketCI/kuberocketai/compare/v0.43.0...v0.44.0 +[v0.43.0]: https://github.com/KubeRocketCI/kuberocketai/compare/v0.42.0...v0.43.0 +[v0.42.0]: https://github.com/KubeRocketCI/kuberocketai/compare/v0.41.2...v0.42.0 +[v0.41.2]: https://github.com/KubeRocketCI/kuberocketai/compare/v0.41.1...v0.41.2 [v0.41.1]: https://github.com/KubeRocketCI/kuberocketai/compare/v0.41.0...v0.41.1 [v0.41.0]: https://github.com/KubeRocketCI/kuberocketai/compare/v0.40.0...v0.41.0 [v0.40.0]: https://github.com/KubeRocketCI/kuberocketai/compare/v0.39.0...v0.40.0 diff --git a/CLAUDE.md b/CLAUDE.md deleted file mode 100644 index 9e26a6f..0000000 --- a/CLAUDE.md +++ /dev/null @@ -1,150 +0,0 @@ -# CLAUDE.md - -This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. - -## Project Overview - -KubeRocketAI is an "AI-as-Code" framework providing a centralized golden library of AI agents for software development workflows. Built as a Go CLI application (`krci-ai`) that embeds framework assets and supports multi-IDE integration. - -**Repository**: [KubeRocketCI/kuberocketai](https://github.com/KubeRocketCI/kuberocketai) - -## Development Commands - -### Build and Testing - -```bash -make build # Build CLI binary -make test # Run unit tests with coverage -make lint # Run linting (golangci-lint) -make fmt # Format code -make ci # Run full CI pipeline locally -make build-all # Cross-platform builds -make tools # Install development tools -``` - -### CLI Usage - -```bash -krci-ai install --ide=cursor # Install framework with IDE integration -krci-ai list agents # List available agents -krci-ai validate # Validate framework components -krci-ai validate -v # Verbose validation with detailed insights -krci-ai validate -q # Quiet mode - minimal output -``` - -## Framework Installation - -### First-Time Setup - -```bash -# Build the CLI -make build - -# Install framework locally -./dist/krci-ai install --ide=cursor # For Cursor IDE -./dist/krci-ai install --ide=claude # For Claude Code -./dist/krci-ai install --all # All IDE integrations - -# Verify installation -./dist/krci-ai validate -``` - -### Directory Structure Created - -- `.krci-ai/agents/` - 6 role-based agent definitions -- `.krci-ai/tasks/` - Common workflow templates -- `.krci-ai/templates/` - Output formatting templates -- `.krci-ai/data/` - Reference data and standards -- `.cursor/rules/` - IDE-specific integration files (if --ide used) - -## Architecture - -### Core Structure - -- **`/cmd/krci-ai/`** - Main CLI entry point with embedded assets -- **`/internal/`** - Core application logic (assets, CLI, engine, validation) -- **`/cmd/krci-ai/assets/framework/core/`** - Embedded framework components - -### Key Architectural Patterns - -**Embedded Assets Pattern**: Framework components (agents, tasks, templates) are embedded in the binary using Go's `embed.FS` for offline-first operation. - -**Role-Based Agent System**: Six SDLC roles defined as YAML configurations: - -- `agents/dev.yaml` - Developer implementation assistance -- `agents/architect.yaml` - Technical architecture decisions -- `agents/ba.yaml` - Requirements analysis -- `agents/pm.yaml` - Product strategy -- `agents/po.yaml` - Backlog management -- `agents/qa.yaml` - Testing and quality assurance - -**Multi-IDE Integration**: Complete polymorphic IDE integration system: - -- Cursor IDE: `.cursor/rules/*.mdc` files -- Claude Code: `.claude/commands/*.md` files -- VS Code: `.github/chatmodes/*.chatmode.md` files -- Windsurf IDE: Support included -- Universal: `--ide=all` installs all integrations - -**Template-Driven Output**: Consistent formatting across roles using embedded templates in `templates/` directory. - -### Processing Engine - -The YAML processing engine (`internal/engine/processor/`) handles: - -- Variable substitution in agent definitions -- Template rendering for consistent outputs -- Schema validation using JSON schemas in `schemas/` - -### Enhanced Validation System - -The comprehensive validation system (`internal/validation/`) provides: - -**Critical Issue Detection**: - -- Broken internal links with regex pattern matching -- Missing task files referenced in agent YAML -- Architecture violations (template/data separation) -- Invalid YAML/JSON format validation - -**Warning & Dependency Analysis**: - -- Orphaned file detection via reverse dependency lookup -- Circular dependency detection using DFS algorithm -- Framework component usage statistics - -**Performance & UX**: - -- Sub-second validation (typically <0.02s for full framework) -- Intelligent caching for large frameworks -- Color-coded, actionable error messages -- Framework insights with component relationships -- Verbose/quiet modes for different use cases - -**Validation Components**: - -- `analyzer.go` - Core validation engine with 8 issue types -- `dependency.go` - Advanced dependency analysis algorithms -- `insights.go` - Framework statistics and relationship mapping -- `output.go` - User-friendly reporting with severity classification -- `cache.go` - Performance optimization with intelligent caching - -## Development Guidelines - -- **Go 1.24.4** with minimal dependencies (cobra, yaml, jsonschema) -- **Conventional Commits** required (feat, fix, docs, chore, etc.) -- **golangci-lint** with strict rules - must pass before commits -- **Comprehensive testing** - unit tests with coverage requirements -- **Semantic versioning** with automated releases via goreleaser - -## Key Files - -- `cmd/krci-ai/main.go` - Application entry point with asset embedding -- `cmd/krci-ai/cmd/install.go` - Complete install command implementation -- `cmd/krci-ai/cmd/validate.go` - Enhanced validation command with comprehensive analysis -- `internal/assets/installer.go` - Asset installation and extraction logic -- `internal/assets/discovery.go` - Agent discovery and YAML parsing -- `internal/validation/` - Complete validation package with 8 issue types -- `internal/cli/output.go` - Colorized CLI output utilities -- `Makefile` - Development workflow automation -- `.goreleaser.yml` - Multi-platform release configuration