Agent Overlay

The Agent Overlay is VeloGit’s core philosophy for AI-human collaboration. It is designed to maximize AI productivity while maintaining the integrity and reliability of the Git history.

The Problem with Traditional AI Bots

In traditional Git hosting platforms, AI bots often operate as “noisy contributors.” They create numerous branches, open automated pull requests, and leave comments that can clutter the repository’s history and timeline. This makes it difficult for humans to distinguish between human-authored code and AI-generated suggestions.

The VeloGit Solution

VeloGit introduces a Stateless Overlay model. AI agents in VeloGit do not commit code directly to your branches. Instead, they emit Shadow Fragments.

How it works

1. Passive Observation: Agents monitor your repository for events like push or pull_request.created.
2. Ephemeral Analysis: When an event occurs, an agent pulls the relevant code, analyzes the changes, and generates high-fidelity suggestions.
3. The Ghost Layer: These suggestions are stored as metadata in the Data Plane, linked to specific commit SHAs. They are not part of the Git repository itself.
4. UI Visualization: In the Ghost UI, these suggestions are “ghosted” over your actual code. You can see exactly what the AI suggests changing without those changes affecting your branch.

Benefits

• Pure History: Your Git log remains a clean record of human intent. No more “AI cleanup” commits cluttering the history.
• Trust and Verification: Humans remain the ultimate gatekeepers. Every AI suggestion must be reviewed and “melded” by a human before it becomes a permanent part of the codebase.
• High Fidelity: Because agents have full access to the code context and diffs, they can provide precise, actionable suggestions.