Skip to content

Zaious/antigravity-loader

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Antigravity Loader

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

English | 中文


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

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

中文

問題場景

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. 安裝

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.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors