https://github.com/unoplat/unoplat-code-confluence
Always keep your codebases ready for Agents. Improve any coding workflow by atleast 2x by maintaing a live, pluggable context layer per repo that creates and maintains Agents.md
https://github.com/unoplat/unoplat-code-confluence
code code-parsing code-understanding context dependency-track gen-ai llm python
Last synced: 1 day ago
JSON representation
Always keep your codebases ready for Agents. Improve any coding workflow by atleast 2x by maintaing a live, pluggable context layer per repo that creates and maintains Agents.md
- Host: GitHub
- URL: https://github.com/unoplat/unoplat-code-confluence
- Owner: unoplat
- License: other
- Created: 2024-04-03T16:48:17.000Z (almost 2 years ago)
- Default Branch: dev
- Last Pushed: 2025-12-25T10:53:10.000Z (28 days ago)
- Last Synced: 2025-12-25T18:54:59.814Z (27 days ago)
- Topics: code, code-parsing, code-understanding, context, dependency-track, gen-ai, llm, python
- Language: Python
- Homepage: https://docs.unoplat.io/
- Size: 71.5 MB
- Stars: 72
- Watchers: 2
- Forks: 7
- Open Issues: 109
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
- Agents: AGENTS.md
Awesome Lists containing this project
README
Unoplat-CodeConfluence
The Universal Code Context Engine
Always keep your agents ready with all the context required per repository.
Explore the docs »
Quick Start
·
Report Bug
·
Request Feature
Table of Contents
- Demo
- The Problem
- The Solution
- Core Principles
- Getting Started
- Project Status
- Maintainers
- Product Feedback
- License
## 🎥 Demo: Agents.md-first Context
Like this? Star the repo ⭐
·
Watch on YouTube
**What's in the demo:** automatic `AGENTS.md` generation per repo and an org index that gives any coding agent a precise source of truth.
## ⚠️ The Problem
AI coding agents excel at **greenfield projects** (new codebases built from scratch) but struggle with **brownfield codebases** (mature, production systems with existing code).
**Why?** They burn most of their context window on exploration—searching files, tracing flows, connecting dots—leaving little capacity for actual implementation. By the time they're ready to code, they've hit the "dumb zone" where performance degrades sharply. And since they lack long-term memory, this cycle repeats with every conversation.
**Multi-repo complexity** makes it worse. When code is split across connected repositories, the agent exhausts its context just mapping dependencies between codebases—often before writing a single line.
**Internal dependencies** present another failure mode. The agent has no onboarding to proprietary systems, so it hallucinates usage patterns. Worse, when internal documentation has drifted from actual implementation, the agent trusts those "lies" and produces code that doesn't work.
The end result: **slop code** requiring heavy rework.
## 🎯 The Solution
Unoplat Code Confluence is the **context engine** for application development, organizing precise, up-to-date knowledge of your data models, entry points, endpoints, and more—so coding agents can deliver and maintain features **2–3x faster** with higher quality.
### AGENTS.md-first Context
Auto-generates machine-readable `AGENTS.md` files per repo to give coding agents a **precise source of truth**:
- **Project Configuration** — Key config files and their responsibilities
- **Development Workflow** — Dev/build/test commands, infra, and third-party dependencies
- **Business Logic** — Core application logic, domain entities, and database entities
- **Entry Points & Interfaces** — Main entry points, API endpoints, and external interfaces
- **External Dependencies** — Roles and responsibilities of external libraries
## 🌟 Core Principles
### 1. **Precision First**
- **[Extensible Language Support](https://github.com/unoplat/unoplat-code-confluence/tree/main/unoplat-code-confluence-ingestion/code-confluence-flow-bridge/src/code_confluence_flow_bridge/parser/queries)**: Modular Tree-sitter based grammar extraction delivers consistent, accurate code context across all programming languages
- **[Extensible Framework-Aware Parsing](https://docs.unoplat.io/contribution/custom-framework-schema)**: Specialized grammar engines recognize framework and library-specific patterns based on project dependencies
### 2. **Context Engineering**
- All important metadata about application—dependencies, inbound/outbound interfaces, domain models, and data store models—are identified and their relationships preserved
### 3. **Enterprise-Grade Scalability, Reliability and Auditability**
- Scalable, auditable and reliable processing powered by workflow orchestrator
### 4. **Performance Optimization**
- Optimized algorithms across all aspects of discovery, detection, ingestion and AI-based insights
## 🚀 Getting Started
Ready to enhance your development workflow?
Check out our [Quick Start Guide](https://docs.unoplat.io/docs/quickstart/how-to-run).
## 📊 Project Status
ALPHA
We're actively developing Unoplat Code Confluence. Currently supports Python and TypeScript codebases.
For detailed roadmap, language support status, and planned features, see our **[Product Roadmap](https://docs.unoplat.io/docs/introduction/roadmap)**.
## Maintainers
Jay Ghiya
Contact: jayghiya@unoplat.io
Book a call with me - Cal Link
## 💬 Product Feedback & Alpha Disclaimer
Unoplat Code Confluence is in alpha. We’re building for our own daily use first, prioritizing stability and bug fixes. We’re collecting feedback now and will act on it once the core is solid. Early adopters welcome. Expect rapid changes and rough edges.
- **Discord**: Join our [community channel](https://discord.com/channels/1131597983058755675/1169968780953260106)
- **GitHub Issues**: [Create an issue](https://github.com/unoplat/unoplat-code-confluence/issues) for bug reports or feature requests
- **GitHub Discussions**: [Start a discussion](https://github.com/unoplat/unoplat-code-confluence/discussions) for broader conversations
Your feedback is invaluable as we work toward production readiness and helps us prioritize our roadmap to better serve the developer community.
## License
Unoplat-CodeConfluence is licensed under the [GNU Affero General Public License v3.0 (AGPL-3.0) + COMMONS CLAUSE](LICENSE).