Skip to content
Back to search

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

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/unoplat--unoplat-code-confluence/badge.svg)](/listings/unoplat--unoplat-code-confluence)

HTML

<a href="/listings/unoplat--unoplat-code-confluence"><img src="/api/listings/unoplat--unoplat-code-confluence/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 226 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <a name="top"></a>
  2. <!-- PROJECT LOGO -->
  3. <br />
  4. <div align="center">
  5. <!-- If you have a logo, uncomment and use this
  6. <a href="https://github.com/unoplat/unoplat-code-confluence">
  7. <img src="images/logo.png" alt="Logo" width="80" height="80">
  8. </a>
  9. -->
  10. <h1 align="center"><a href="https://www.unoplat.io">Unoplat-CodeConfluence</a></h1>
  11. <h3 align="center">The Universal Code Context Engine</h3>
  12. <p align="center">
  13. Always keep your agents ready with all the context required per repository.
  14. <br />
  15. <a href="https://docs.unoplat.io"><strong>Explore the docs »</strong></a>
  16. <br />
  17. <br />
  18. <a href="https://docs.unoplat.io/docs/quickstart/how-to-run">Quick Start</a>
  19. ·
  20. <a href="https://github.com/unoplat/unoplat-code-confluence/issues">Report Bug</a>
  21. ·
  22. <a href="https://github.com/unoplat/unoplat-code-confluence/issues">Request Feature</a>
  23. </p>
  24. <!-- PROJECT SHIELDS -->
  25. <p align="center">
  26. <img src="https://img.shields.io/badge/Status-ALPHA-orange" alt="Status" />
  27. <img src="https://img.shields.io/badge/License-AGPL%203.0-blue" alt="License" />
  28. <a href="https://github.com/unoplat/unoplat-code-confluence/stargazers">
  29. <img src="https://img.shields.io/github/stars/unoplat/unoplat-code-confluence?style=social" alt="Star on GitHub" />
  30. </a>
  31. <a href="https://www.youtube.com/watch?v=l6gFjoj4QJE">
  32. <img src="https://img.shields.io/badge/Watch%20demo-YouTube?logo=youtube" alt="Watch the demo" />
  33. </a>
  34. </p>
  35. <!-- SOCIAL SHIELDS -->
  36. <p align="center">
  37. <a href="https://discord.gg/qe2nbQMnWB">
  38. <img src="https://img.shields.io/badge/Discord-Join_Us-7289DA?style=flat&logo=discord&logoColor=white" alt="Discord" />
  39. </a>
  40. <a href="https://x.com/unoplatio">
  41. <img src="https://img.shields.io/badge/Twitter-Follow_Us-1DA1F2?style=flat&logo=twitter&logoColor=white" alt="Twitter" />
  42. </a>
  43. <a href="https://www.linkedin.com/company/unoplat/">
  44. <img src="https://img.shields.io/badge/LinkedIn-Connect-0077B5?style=flat&logo=linkedin&logoColor=white" alt="LinkedIn" />
  45. </a>
  46. </p>
  47. </div>
  48. <!-- TABLE OF CONTENTS -->
  49. <details>
  50. <summary>Table of Contents</summary>
  51. <ol>
  52. <li><a href="#demo-agentsmd-first-context">Demo</a></li>
  53. <li><a href="#%EF%B8%8F-the-problem">The Problem</a></li>
  54. <li><a href="#-the-solution">The Solution</a></li>
  55. <li><a href="#-core-principles">Core Principles</a></li>
  56. <li><a href="#-getting-started">Getting Started</a></li>
  57. <li><a href="#-agent-skill">Agent Skill</a></li>
  58. <li><a href="#-project-status">Project Status</a></li>
  59. <li><a href="#maintainers">Maintainers</a></li>
  60. <li><a href="#-product-feedback--alpha-disclaimer">Product Feedback</a></li>
  61. <li><a href="#license">License</a></li>
  62. </ol>
  63. </details>
  64. <!-- DEMO SECTION -->
  65. <a id="demo-agentsmd-first-context"></a>
  66. ## 🎥 Demo: Agents.md-first Context
  67. <p align="center">
  68. <a href="https://www.youtube.com/watch?v=l6gFjoj4QJE" target="_blank">
  69. <img src="https://img.youtube.com/vi/l6gFjoj4QJE/maxresdefault.jpg" alt="Agents.md demo video" width="900">
  70. </a>
  71. <br />
  72. <a href="https://github.com/unoplat/unoplat-code-confluence/stargazers"><b>Like this? Star the repo</b> ⭐</a>
  73. ·
  74. <a href="https://www.youtube.com/watch?v=l6gFjoj4QJE">Watch on YouTube</a>
  75. ·
  76. <a href="https://github.com/JayGhiya/full-stack-fastapi-template/pull/1">Sample PR</a>
  77. </p>
  78. **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. See a [sample PR](https://github.com/JayGhiya/onyx/pull/1) created by the tool.
  79. <!-- THE PROBLEM SECTION -->
  80. ## ⚠️ The Problem
  81. <p align="center">
  82. <img src="images/problem-statement.png" alt="Greenfield vs Brownfield Project comparison showing AI agent challenges" width="800">
  83. </p>
  84. AI coding agents excel at **greenfield projects** (new codebases built from scratch) but struggle with **brownfield codebases** (mature, production systems with existing code).
  85. **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.
  86. **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.
  87. **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.
  88. The end result: **slop code** requiring heavy rework.
  89. <p align="right">(<a href="#top">back to top</a>)</p>
  90. <!-- SOLUTION SECTION -->
  91. ## 🎯 The Solution
  92. 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.
  93. ### AGENTS.md-first Context
  94. Auto-generates machine-readable `AGENTS.md` files per repo to give coding agents a **precise source of truth**:
  95. - **Engineering Workflow** — Canonical install/build/dev/test/lint/type_check commands plus key config files and their responsibilities
  96. - **Business Logic** — Core application logic, domain entities, and database entities
  97. - **Entry Points & Interfaces** — Main entry points, API endpoints, and external interfaces
  98. - **External Dependencies** — Roles and responsibilities of external libraries
  99. <p align="right">(<a href="#top">back to top</a>)</p>
  100. <!-- CORE PRINCIPLES SECTION -->
  101. ## 🌟 Core Principles
  102. ### 1. **Precision First**
  103. - **[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
  104. - **[Extensible Framework-Aware Parsing](https://docs.unoplat.io/docs/contribution/custom-framework-schema)**: Specialized grammar engines recognize framework and library-specific patterns based on project dependencies
  105. ### 2. **Context Engineering**
  106. - All important metadata about application—dependencies, inbound/outbound interfaces, domain models, and data store models—are identified and their relationships preserved
  107. ### 3. **Enterprise-Grade Scalability, Reliability and Auditability**
  108. - Scalable, auditable and reliable processing powered by workflow orchestrator
  109. <p align="right">(<a href="#top">back to top</a>)</p>
  110. <!-- GETTING STARTED SECTION -->
  111. ## 🚀 Getting Started
  112. Ready to enhance your development workflow?
  113. Check out our [Quick Start Guide](https://docs.unoplat.io/docs/quickstart/how-to-run).
  114. <p align="right">(<a href="#top">back to top</a>)</p>
  115. ## 🧠 Agent Skill
  116. This repository includes a portable agent skill for the Unoplat Code Confluence CLI at [`skills/unoplat-code-confluence-cli/SKILL.md`](skills/unoplat-code-confluence-cli/SKILL.md).
  117. Install it with the skills CLI:
  118. ```bash
  119. npx skills add https://github.com/unoplat/unoplat-code-confluence --skill unoplat-code-confluence-cli
  120. ```
  121. The skill teaches compatible coding agents how to use `ucc` from `PATH`, help users install it with `uv tool install "git+https://github.com/unoplat/unoplat-code-confluence.git#subdirectory=unoplat-code-confluence-cli"` when needed, ingest repositories, and run the single-command `ucc agent-md <repository_git_url>` flow.
  122. <p align="right">(<a href="#top">back to top</a>)</p>
  123. ## 📊 Project Status
  124. <div align="center">
  125. ![Status](https://img.shields.io/badge/Status-ALPHA→BETA-orange?style=for-the-badge)
  126. ![Progress](https://img.shields.io/badge/Beta_Progress-Shipping_Fast_🚀-blue?style=for-the-badge)
  127. ```
  128. ALPHA ████████████████░░░░ BETA
  129. ```
  130. <h3>🚀 Sprinting Toward Beta</h3>
  131. <p>
  132. Unoplat Code Confluence currently supports <b>Python</b> and <b>TypeScript</b> codebases.<br/>
  133. We're heads-down closing the remaining blockers to reach <b>Beta</b>.
  134. </p>
  135. <p>
  136. 👉 <a href="https://github.com/unoplat/unoplat-code-confluence/issues?q=is%3Aissue%20state%3Aopen%20label%3Aurgent"><b>Track our Beta blockers →</b></a><br/>
  137. <sub>Every open <code>urgent</code> issue is actively being worked on. We're shipping fixes daily.</sub>
  138. </p>
  139. </div>
  140. For detailed roadmap, language support status, and planned features, see our **[Product Roadmap](https://docs.unoplat.io/docs/introduction/roadmap)**.
  141. <p align="right">(<a href="#top">back to top</a>)</p>
  142. <p align="right">(<a href="#top">back to top</a>)</p>
  143. <!-- MAINTAINERS SECTION -->
  144. ## Maintainers
  145. <table>
  146. <tr>
  147. <td>
  148. <a href="https://github.com/JayGhiya">
  149. <strong>Jay Ghiya</strong>
  150. <br>
  151. Contact: jayghiya@unoplat.io
  152. </a>
  153. </td>
  154. </tr>
  155. </table>
  156. <p>Book a call with me - <a href="https://cal.com/jay-ghiya/15min">Cal Link</a></p>
  157. <p align="right">(<a href="#top">back to top</a>)</p>
  158. <!-- PRODUCT FEEDBACK SECTION -->
  159. ## 💬 Product Feedback & Alpha Disclaimer
  160. 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.
  161. - **Discord**: Join our [community channel](https://discord.gg/qe2nbQMnWB)
  162. - **GitHub Issues**: [Create an issue](https://github.com/unoplat/unoplat-code-confluence/issues) for bug reports or feature requests
  163. - **GitHub Discussions**: [Start a discussion](https://github.com/unoplat/unoplat-code-confluence/discussions) for broader conversations
  164. Your feedback is invaluable as we work toward production readiness and helps us prioritize our roadmap to better serve the developer community.
  165. <p align="right">(<a href="#top">back to top</a>)</p>
  166. <!-- LICENSE SECTION -->
  167. ## License
  168. Unoplat-CodeConfluence is licensed under the [GNU Affero General Public License v3.0 (AGPL-3.0) + COMMONS CLAUSE](LICENSE).
  169. <p align="right">(<a href="#top">back to top</a>)</p>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.