# besync-labs/antigravity-ai-kit architecture

> Architecture diagram of the GitHub repository besync-labs/antigravity-ai-kit, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/besync-labs/antigravity-ai-kit
- Repository: https://github.com/besync-labs/antigravity-ai-kit

## Overview

Antigravity AI Kit equips an AI-enabled IDE with slash commands, workflows, specialist agents, skills, and runtime governance. A user can initialize a project with `ag-kit init` or scaffold one, then use commands such as `/plan` and `/implement`; workflows draw on agents and skills while runtime modules enforce transitions, task governance, and session state. The README documents additional marketplace, security, reputation, and self-healing capabilities. Sampled sources confirm several runtime calls; unsampled subsystem wiring is shown only where documented.

Main entry points: [`bin/ag-kit.js`](https://github.com/besync-labs/antigravity-ai-kit/blob/main/bin/ag-kit.js) (Kit CLI), [`.agent/workflows`](https://github.com/besync-labs/antigravity-ai-kit/tree/main/.agent/workflows) (Workflows), [`lib/loading-engine.js`](https://github.com/besync-labs/antigravity-ai-kit/blob/main/lib/loading-engine.js) (Intelligent Loading), [`lib/engineering-manager.js`](https://github.com/besync-labs/antigravity-ai-kit/blob/main/lib/engineering-manager.js) (Sprint Planning)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Project Entry"]
  node_scaffold["Project Scaffolder<br/>[index.js]"]
  node_cli["Kit CLI<br/>[ag-kit.js]"]
  node_agent_config["Agent Configuration<br/>[.agent]"]
end

subgraph group_orchestration["Workflow Orchestration"]
  node_commands["Slash Commands<br/>[commands]"]
  node_workflows["Workflows<br/>[workflows]"]
  node_loading["Intelligent Loading<br/>[loading-engine.js]"]
end

subgraph group_resources["Agent Resources"]
  node_agents["Specialist Agents<br/>[agents]"]
  node_skills["Domain Skills<br/>[skills]"]
end

subgraph group_runtime["Governance Runtime"]
  node_workflow_engine["Workflow Enforcement<br/>[workflow-engine.js]"]
  node_workflow_state["Workflow State"]
  node_sessions["Session Management<br/>[session-manager.js]"]
  node_session_state["Session State<br/>[session-state.json]"]
  node_task_governance["Task Governance<br/>[task-governance.js]"]
  node_engineering["Sprint Planning"]
  node_task_model["Task Model<br/>[task-model.js]"]
  node_reputation["Agent Reputation"]
end

subgraph group_extensions["Extensions &amp; Safety"]
  node_plugins["Plugin Lifecycle<br/>[plugin-system.js]"]
  node_marketplace["Plugin Marketplace<br/>[marketplace.js]"]
  node_security["Security Scanning"]
  node_healing["Self-healing<br/>[self-healing.js]"]
end

node_user(("Developer"))
node_ide(("AI-enabled IDE"))

node_user -->|"creates project"| node_scaffold
node_user -->|"initializes kit"| node_cli
node_scaffold -->|"runs init"| node_cli
node_cli -->|"installs configuration"| node_agent_config
node_user -->|"uses"| node_ide
node_ide -->|"invokes"| node_commands
node_commands -->|"starts workflow"| node_workflows
node_workflows -->|"requests transitions"| node_workflow_engine
node_workflow_engine -->|"reads and writes"| node_workflow_state
node_workflows -->|"resolves context"| node_loading
node_loading -->|"selects agents"| node_agents
node_loading -->|"selects skills"| node_skills
node_ide -->|"manages session"| node_sessions
node_sessions -->|"reads and writes"| node_session_state
node_ide -->|"governs tasks"| node_task_governance
node_task_governance -->|"delegates task operations"| node_task_model
node_ide -->|"requests sprint planning"| node_engineering
node_engineering -->|"reads and prioritizes"| node_task_model
node_engineering -->|"scores assignments"| node_reputation
node_cli -->|"manages plugins"| node_plugins
node_cli -->|"runs market commands"| node_marketplace
node_marketplace -->|"installs plugins"| node_plugins
node_cli -->|"runs security scan"| node_security
node_cli -->|"runs healing commands"| node_healing

click node_scaffold "https://github.com/besync-labs/antigravity-ai-kit/blob/main/create-antigravity-app/index.js"
click node_cli "https://github.com/besync-labs/antigravity-ai-kit/blob/main/bin/ag-kit.js"
click node_agent_config "https://github.com/besync-labs/antigravity-ai-kit/tree/main/.agent"
click node_commands "https://github.com/besync-labs/antigravity-ai-kit/tree/main/.agent/commands"
click node_workflows "https://github.com/besync-labs/antigravity-ai-kit/tree/main/.agent/workflows"
click node_loading "https://github.com/besync-labs/antigravity-ai-kit/blob/main/lib/loading-engine.js"
click node_agents "https://github.com/besync-labs/antigravity-ai-kit/tree/main/.agent/agents"
click node_skills "https://github.com/besync-labs/antigravity-ai-kit/tree/main/.agent/skills"
click node_workflow_engine "https://github.com/besync-labs/antigravity-ai-kit/blob/main/lib/workflow-engine.js"
click node_workflow_state "https://github.com/besync-labs/antigravity-ai-kit/blob/main/.agent/engine/workflow-state.json"
click node_sessions "https://github.com/besync-labs/antigravity-ai-kit/blob/main/lib/session-manager.js"
click node_session_state "https://github.com/besync-labs/antigravity-ai-kit/blob/main/.agent/session-state.json"
click node_task_governance "https://github.com/besync-labs/antigravity-ai-kit/blob/main/lib/task-governance.js"
click node_engineering "https://github.com/besync-labs/antigravity-ai-kit/blob/main/lib/engineering-manager.js"
click node_task_model "https://github.com/besync-labs/antigravity-ai-kit/blob/main/lib/task-model.js"
click node_reputation "https://github.com/besync-labs/antigravity-ai-kit/blob/main/lib/agent-reputation.js"
click node_plugins "https://github.com/besync-labs/antigravity-ai-kit/blob/main/lib/plugin-system.js"
click node_marketplace "https://github.com/besync-labs/antigravity-ai-kit/blob/main/lib/marketplace.js"
click node_security "https://github.com/besync-labs/antigravity-ai-kit/blob/main/lib/security-scanner.js"
click node_healing "https://github.com/besync-labs/antigravity-ai-kit/blob/main/lib/self-healing.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_scaffold,node_cli,node_agent_config toneBlue
class node_commands,node_workflows,node_loading toneAmber
class node_agents,node_skills toneMint
class node_workflow_engine,node_workflow_state,node_sessions,node_session_state,node_task_governance,node_engineering,node_task_model,node_reputation toneRose
class node_plugins,node_marketplace,node_security,node_healing,node_user,node_ide toneIndigo
```

## Components

### Project Entry

- [Project Scaffolder](https://github.com/besync-labs/antigravity-ai-kit/blob/main/create-antigravity-app/index.js): `create-antigravity-app/index.js`
- [Kit CLI](https://github.com/besync-labs/antigravity-ai-kit/blob/main/bin/ag-kit.js): `bin/ag-kit.js`
- [Agent Configuration](https://github.com/besync-labs/antigravity-ai-kit/tree/main/.agent): `.agent`

### Workflow Orchestration

- [Slash Commands](https://github.com/besync-labs/antigravity-ai-kit/tree/main/.agent/commands): `.agent/commands`
- [Workflows](https://github.com/besync-labs/antigravity-ai-kit/tree/main/.agent/workflows): `.agent/workflows`
- [Intelligent Loading](https://github.com/besync-labs/antigravity-ai-kit/blob/main/lib/loading-engine.js): `lib/loading-engine.js`

### Agent Resources

- [Specialist Agents](https://github.com/besync-labs/antigravity-ai-kit/tree/main/.agent/agents): `.agent/agents`
- [Domain Skills](https://github.com/besync-labs/antigravity-ai-kit/tree/main/.agent/skills): `.agent/skills`

### Governance Runtime

- [Workflow Enforcement](https://github.com/besync-labs/antigravity-ai-kit/blob/main/lib/workflow-engine.js): `lib/workflow-engine.js`
- [Workflow State](https://github.com/besync-labs/antigravity-ai-kit/blob/main/.agent/engine/workflow-state.json): `.agent/engine/workflow-state.json`
- [Session Management](https://github.com/besync-labs/antigravity-ai-kit/blob/main/lib/session-manager.js): `lib/session-manager.js`
- [Session State](https://github.com/besync-labs/antigravity-ai-kit/blob/main/.agent/session-state.json): `.agent/session-state.json`
- [Task Governance](https://github.com/besync-labs/antigravity-ai-kit/blob/main/lib/task-governance.js): `lib/task-governance.js`
- [Sprint Planning](https://github.com/besync-labs/antigravity-ai-kit/blob/main/lib/engineering-manager.js): `lib/engineering-manager.js`
- [Task Model](https://github.com/besync-labs/antigravity-ai-kit/blob/main/lib/task-model.js): `lib/task-model.js`
- [Agent Reputation](https://github.com/besync-labs/antigravity-ai-kit/blob/main/lib/agent-reputation.js): `lib/agent-reputation.js`

### Extensions & Safety

- [Plugin Lifecycle](https://github.com/besync-labs/antigravity-ai-kit/blob/main/lib/plugin-system.js): `lib/plugin-system.js`
- [Plugin Marketplace](https://github.com/besync-labs/antigravity-ai-kit/blob/main/lib/marketplace.js): `lib/marketplace.js`
- [Security Scanning](https://github.com/besync-labs/antigravity-ai-kit/blob/main/lib/security-scanner.js): `lib/security-scanner.js`
- [Self-healing](https://github.com/besync-labs/antigravity-ai-kit/blob/main/lib/self-healing.js): `lib/self-healing.js`

### Other components

- **Developer**
- **AI-enabled IDE**

## Connections

- Developer → Project Scaffolder: creates project
- Developer → Kit CLI: initializes kit
- Project Scaffolder → Kit CLI: runs init
- Kit CLI → Agent Configuration: installs configuration
- Developer → AI-enabled IDE: uses
- AI-enabled IDE → Slash Commands: invokes
- Slash Commands → Workflows: starts workflow
- Workflows → Workflow Enforcement: requests transitions
- Workflow Enforcement → Workflow State: reads and writes
- Workflows → Intelligent Loading: resolves context
- Intelligent Loading → Specialist Agents: selects agents
- Intelligent Loading → Domain Skills: selects skills
- AI-enabled IDE → Session Management: manages session
- Session Management → Session State: reads and writes
- AI-enabled IDE → Task Governance: governs tasks
- Task Governance → Task Model: delegates task operations
- AI-enabled IDE → Sprint Planning: requests sprint planning
- Sprint Planning → Task Model: reads and prioritizes
- Sprint Planning → Agent Reputation: scores assignments
- Kit CLI → Plugin Lifecycle: manages plugins
- Kit CLI → Plugin Marketplace: runs market commands
- Plugin Marketplace → Plugin Lifecycle: installs plugins
- Kit CLI → Security Scanning: runs security scan
- Kit CLI → Self-healing: runs healing commands