AGENTS.md

1<!-- UNOPLAT_CODE_CONFLUENCE_CONTEXT:BEGIN -->
2<CRITICAL_INSTRUCTION>
3 
4> Generated from branch `dev` at commit `5ecdba39d57f50c5188a8e32b9dd4f52d01611fe` (2026-07-18). Content may become stale as new commits land.
5 
6</CRITICAL_INSTRUCTION>
7 
8## Engineering Workflow
9### Install
10- `uv sync --locked --group dev` — `pyproject.toml` / `uv.lock`
11 
12### Build
13- `uv build` — `pyproject.toml`
14 
15### Dev
16- `uv run ucc` — `pyproject.toml` (project script entry point)
17 
18### Test
19- Not detected
20 
21### Lint
22- `uv run --group dev ruff check src/` — `Taskfile.yml`
23 
24### Type Check
25- `uv run --group dev pyrefly check src/` — `Taskfile.yml`
26 
27## Dependency Guide
28See [`dependencies_overview.md`](./dependencies_overview.md) for the full dependency catalog and usage notes.
29 
30## Business Domain
31### Description
32 
33Unoplat Code Confluence CLI manages a local Docker Compose deployment for repository-aware AI code assistance, including Flow Bridge, a query engine, and a frontend. It registers and refreshes Git repositories, verifies repository and model-provider credentials, tracks GitHub release manifests and installed state, and initiates AGENTS.md-generation workflows that raise pull requests.
34 
35### References
36 
37See [`business_domain_references.md`](./business_domain_references.md) for the supporting source references used to derive this domain summary.
38 
39## App Interfaces
40See [`app_interfaces.md`](./app_interfaces.md) for the canonical interface and endpoint reference.
41 
42## Architecture
43See [`architecture.md`](./architecture.md) for the canonical system architecture diagram.
44 
45<!-- UNOPLAT_CODE_CONFLUENCE_CONTEXT:END -->
46