antigravity-loader

KO | EN

gitlite — search

#python #ai #llm #machine-learning #rust #java #awesome #cli #kubernetes #vue #awesome-list #security #ios #open-source

antigravity-loader

(★ 11)

No description available.

antigravity-loader Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Antigravity Loader

A Claude Code skill that turns a `.agent/` directory into a living expert system.

[English](#english) | [中文](#中文)

---

<a name="english"></a>
## English

### The Problem

Using **Claude Code plugin** in **Antigravity IDE**?

Antigravity has a native `.agent/` directory structure for workflows, rules, and experts.
But Claude Code doesn't understand it — it only knows Skills.

You don't want to migrate. You like Antigravity's workflow system.

**Antigravity Loader** is the bridge.

---

### What is this?

Antigravity Loader teaches **Claude Code** how to read Antigravity's `.agent/` structure:
- Load **Experts** (persona-driven agents defined in Markdown)
- Execute **Workflows** (step-by-step SOPs, acting as Game Master)
- Enforce **Rules** (constitutional constraints applied as system instructions)
- Query **Knowledge** (reference libraries, specs, and domain docs)

All from Markdown files in your `.agent/` directory.

---

### Who is this for?

**Primary**: Antigravity IDE users who installed Claude Code plugin
**Secondary**: Anyone using Claude Code who wants `.agent/` directory management

If you're a "dual-blade" user (Antigravity + Claude), this tool saves you from migration hell.

---

### Quick Start

**1. Install**

```bash
cp -r antigravity-loader ~/.claude/skills/antigravity-loader
```

**2. Configure Paths**

Edit `~/.claude/skills/antigravity-loader/config.md`:
- Single project? Set `GLOBAL_CORE = NONE`
- Multiple projects sharing resources? Set `GLOBAL_CORE = /path/to/shared/.agent`
- Want a global constitution (rules that apply to all projects)? Set `GLOBAL_CONSTITUTION = /path/to/global-rules.md`

**3. Structure Your Project**

```
your-project/
└── .agent/
    ├── skills/          ← Expert definitions
    │   └── my-expert/
    │       └── SKILL.md
    ├── workflows/       ← Step-by-step SOPs
    │   └── my-workflow.md
    ├── rules/           ← Constitutional constraints
    └── knowledge/       ← Reference docs
```

**4. Use**

```
You: "load my-expert"
     → Claude reads skills/my-expert/SKILL.md and adopts that persona.

You: "/my-workflow" or "run my-workflow"
     → Claude reads workflows/my-workflow.md and guides you through it as Game Master.

You: "what are the rules?"
     → Claude reads rules/ and applies them as session constraints.
```

### Architecture

**Dual-Layer (Optional)**

| Layer | Location | Purpose |
|-------|----------|---------|
| Project | `{project}/.agent/` | Project-specific resources |
| Global | Your configured path | Shared defaults across projects |

When a resource exists in both layers, **Project wins**.

**4 Protocols**

| Protocol | Trigger | Action |
|----------|---------|--------|
| Summon Expert | `@name` / "load X" | Reads SKILL.md, adopts persona |
| Execute Workflow | `/workflow` / "run X" | Acts as Game Master, guides steps |
| Rule Enforcement | "rules" / starting complex task | Injects rules as constraints |
| Knowledge Access | "specs" / "TRAP" | Loads knowledge docs into context |

### Expert Folder Structure

```
skills/my-expert/
├── SKILL.md            ← Required. Identity + capabilities.
├── persona.md          ← Optional. Personality, backstory.
├── preferences.md      ← Optional. Session preferences.
├── evolutions/         ← Optional. Upgrade modules (DLCs).
└── sovereign/          ← Optional. Private memory (diary, etc.)
    └── diary.md
```

---

### Changelog

**v1.0.0** (2026-02-06)
- Initial public release
- Protocol 3: Added Global Constitution support for cross-project rules
- Config: Added `GLOBAL_CONSTITUTION` optional path
- Dual-layer architecture (Project + Global)
- 4 core protocols: Expert, Workflow, Rules, Knowledge

---

<a name="中文"></a>
## 中文

### 問題場景

在 **Antigravity IDE** 裡用 **Claude Code plugin**？

Antigravity 有原生的 `.agent/` 目錄結構（workflows、rules、experts）。
但 Claude Code 不認識它 — 它只懂 Skills。

你不想搬家。你喜歡 Antigravity 的 workflow 系統。

**Antigravity Loader** 就是這座橋。

---

### 這是什麼？

Antigravity Loader 教 **Claude Code** 如何讀取 Antigravity 的 `.agent/` 結構：
- **Experts**（人格化的 Agent）
- **Workflows**（標準作業流程，Claude 當 Game Master）
- **Rules**（憲法級約束，套為系統指令）
- **Knowledge**（參考文件庫、規格、領域知識）

全部從你的 `.agent/` 目錄讀取。

---

### 這是給誰用的？

**主要用戶**：Antigravity IDE 用戶，但裝了 Claude Code plugin
**次要用戶**：任何想要 `.agent/` 目錄管理能力的 Claude Code 用戶

如果你是「二刀流」用戶（Antigravity + Claude），這工具讓你不用搬家。

---

### 快速上手

**1. 安裝**

```bash
cp -r antigravity-loader ~/.claude/skills/antigravity-loader
```

**2. 配置路徑**

編輯 `~/.claude/skills/antigravity-loader/config.md`：
- 只有一個 project？設 `GLOBAL_CORE = NONE`
- 多個 project 想共用資源？設 `GLOBAL_CORE = /path/to/shared/.agent`
- 想要全域憲法（套用到所有 project 的規則）？設 `GLOBAL_CONSTITUTION = /path/to/global-rules.md`

**3. 建立你的 `.agent/`**

```
your-project/
└── .agent/
    ├── skills/          ← 專家定義
    │   └── my-expert/
    │       └── SKILL.md
    ├── workflows/       ← 標準作業流程
    │   └── my-workflow.md
    ├── rules/           ← 憲法級約束
    └── knowledge/       ← 參考文件
```

**4. 開始用**

```
你: "load my-expert"
    → Claude 讀 skills/my-expert/SKILL.md，進入該角色。

你: "/my-workflow" 或 "run my-workflow"
    → Claude 讀 workflows/my-workflow.md，當 Game Master 帶你走流程。

你: "what are the rules?"
    → Claude 讀 rules/ 裡的文件，套為本次 session 的約束。
```

### 架構說明

**雙層架構（可選）**

| 層 | 位置 | 用途 |
|----|------|------|
| Project | `{project}/.agent/` | 當前 project 專用 |
| Global | 你設定的共享路徑 | 跨 project 共用的預設 |

同名 resource 兩層都有時，**Project 版本生效**。

**4 個 Protocol**

| Protocol | 觸發 | 做什麼 |
|----------|------|--------|
| Summon Expert | `@name` / "load X" | 讀 SKILL.md，進入角色 |
| Execute Workflow | `/workflow` / "run X" | 當 Game Master，帶你走步驟 |
| Rule Enforcement | "rules" / 開始複雜任務 | 把 rules/ 裡的內容當為約束 |
| Knowledge Access | "specs" / "TRAP" | 讀 knowledge/ 並持續在 context 裡 |

### 專家目錄結構

```
skills/my-expert/
├── SKILL.md            ← 必須。角色定義 + 能力。
├── persona.md          ← 可選。人格、背景。
├── preferences.md      ← 可選。偏好設定。
├── evolutions/         ← 可選。升級模組（DLC）。
└── sovereign/          ← 可選。私密記憶（日記等）。
    └── diary.md
```

---

### 更新日誌

**v1.0.0** (2026-02-06)
- 首次公開發布
- Protocol 3: 新增 Global Constitution 支援（跨專案規則）
- Config: 新增 `GLOBAL_CONSTITUTION` 可選路徑
- 雙層架構（Project + Global）
- 4 個核心協議：Expert、Workflow、Rules、Knowledge

---

## 建議

- **Lightweight models** (Haiku, Flash) may struggle with meta-instructions like "act as Game Master". Use thinking-class models (Sonnet+, Gemini Pro+).
- When workflows involve multiple experts, list the "Council" in the workflow file. The Loader will summon them first.
- `WORKFLOW_INDEX.md` is optional but highly recommended when you have 10+ workflows.

---

**中文建議**：
- **輕量模型**（Haiku、Flash）可能在「當 Game Master」這種 meta-instruction 上執行不穩定。建議用 thinking-class 模型（Sonnet 以上，或 Gemini Pro 以上）。
- Workflow 裡如果要多個 Expert 互動，記得在文件裡列明 Council 成員。Loader 會替你先 summon。
- `WORKFLOW_INDEX.md` 不必，但強烈推薦。當 workflow 數量超過 10+，有一張索引會省你不少腦力。

---

## License

MIT

---

*Designed by Yui — System Architect, ChronicleCore Expert System*

**For dual-blade users** (Antigravity IDE + Claude Code plugin).
Also works in VS Code and Cursor.

antigravity-loader

antigravity-loader Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

antigravity-loader

antigravity-loader Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README