Repo: https://github.com/Kynlos/Akari-FlowIntelligent CI/CD Documentation & Analysis SystemWhy Akari Flow? "Documentation is the code." — Everyone says it, but nobody actually searches the code. In reality, documentation rots the moment it's written. Developers hate writing it, and teams struggle to maintain it. The cost? Slower onboarding, silent breaking changes, and critical knowledge locked in people's heads.
This system aims to eliminate documentation debt entirely.
Overview Akari Flow revolutionizes code documentation by automatically analyzing code changes with AST-based precision, creating diagrams, generating docs, detecting breaking changes, and notifying teams.
✨ Key Features - Automated Code Analysis – Breaking change detection, impact analysis, quality scores, security scanning.
- Intelligent Documentation & Visualization – Auto docs, architecture diagrams, static site generation.
- PR Enhancement & Agentic Bot – Smart PR comments and safe search/replace automation.
- Multi-Platform Notifications – Discord, Slack, Pushbullet integration.
Quick Start Prerequisites: - GitHub repository
- Groq API key (free tier available)
- Python 3.11+
5-Minute Setup: git clone https://github.com/Kynlos/Akari-Flow.git
cd Akari-Flow
# Copy workflows into your repo
cp -r .github <your-repo>/
# Add required secret
# GROQ_API_KEY = <your-groq-api-key>
Push a change and the magic starts.
CLI Tool (Local Usage) Install dependencies and run:
pip install requests markdown
python cicd-cli.py full-run
Generate docs or site with dedicated commands.
Configuration Language parsing rules and LLM model settings are fully configurable.
Usage Examples Agentic Bot – Comment on PRs to modify code safely.
Breaking Change Detection – Signature changes trigger alerts.
Documentation Portal The system builds a static site with navigation, dark mode, and diagrams.
Architecture The pipeline runs as GitHub Actions — parse code, generate docs & diagrams, build site, send notifications, then commit back.
Support If you find this project useful, consider sponsoring development.
About Intelligent CI/CD: Automated documentation, AST-based analysis, breaking change detection, and dynamic visualization powered by AI.
