Published: Updated:
AkiDevRule — Claude Code + Antigravity agent baseline

AkiDevRule

Open Source

One install command turns a fresh Claude Code or Antigravity environment into Aki’s full working baseline.

github.com/lacvietanh/akidevrule  ·  master branch · Claude Code + Antigravity

Formerly named AkiClaudeDoc — renamed 27/07/2026.

AkiDevRule (formerly AkiClaudeDoc) is an open-source agent baseline package (MIT License, public since 22/05/2026), shared by Claude Code and Antigravity/Gemini. A single install command turns a fresh agent environment into Aki’s full working baseline: a shared rule corpus that loads itself at the right moment, plus a small set of six sharp, single-purpose skills. The corpus follows a strict naming convention (RULE-* for constraints, METHOD-* for frameworks) and is routed by the akirule skill in three tiers. The GitHub repository is the single source of truth. It is not an auto-updater, daemon, package manager or control plane.

Install — one command (master branch)

curl -fsSL https://raw.githubusercontent.com/lacvietanh/akidevrule/master/install.sh | bash

The script is intentionally simple — inspect it before running.

  • One curl command (master branch), or bash install.sh from a local checkout
  • Shared by Claude Code and Antigravity/Gemini — generated from one agent-neutral rule source
  • A self-routing rule corpus: 12 RULE-* files (constraints) + 3 METHOD-* (frameworks) + index.md
  • Three-tier akirule router, deliberately high sensitivity — err toward loading over wrong behavior
  • Six skills, each sharp at one job: akirule, akiflow, akithink, akihtmlreport, akihelp, akigitcommit
  • Notify-only update mechanism — never downloads, never auto-installs, no daemon
  • Open source (MIT License) since 22/05/2026 — the GitHub repo is the source of truth
  • Renamed from AkiClaudeDoc → akidevrule on 27/07/2026, scope widened to Antigravity

Core Ideas

One-command install, full baseline

A single curl command turns a fresh Claude Code or Antigravity environment into Aki’s full working baseline. You can also run bash install.sh from a local checkout. The script is intentionally simple so you can inspect it before running.

One source, two agents

The rule corpus is generated from a single agent-neutral source, shared by both Claude Code and Antigravity/Gemini — not two separate rule sets that can drift apart. The rename from AkiClaudeDoc to akidevrule (27/07/2026) marks exactly this scope widening.

A rule corpus that routes itself by naming

A strict naming convention: RULE-*.md are constraints (what the agent must or must not do — behavior, coding, docs, content, stack, UI, SEO, release, DB design, business); METHOD-*.md are analytical frameworks, heavy, loaded only when the task genuinely needs them; index.md holds the manifest, precedence order and project-binding policy.

Three-tier akirule router

akirule routes with deliberately high sensitivity (err toward loading): Tier 1 core loads every conversation (index.md, RULE-agent-behavior, RULE-coding) via @path embed syntax; Tier 2 contextual is read on signal match; Tier 3 is the analytical METHODs. No harness magic — Tiers 2–3 are just trigger instructions telling the agent to Read the file from ~/.aki/claudedoc/ when signals match.

akiflow — a sized multi-agent delivery pipeline

The newest skill: a strict sizing gate classifies a request into Tier 0 (direct, the default), Tier 1 (an Architect plan plus an adversarial Reviewer), or Tier 2 (adds business/UX counsel) — spawning only the specialists that tier needs, handing work between stages through docs/ files rather than chat context.

Six skills, each sharp at one job

akirule (automatic rule router), akiflow (a sized multi-agent delivery pipeline), akithink (a 5-phase deep-thinking session ending in a docs/ decision record), akihtmlreport (distills a dense in-conversation analysis into one self-contained REPORT.html), akihelp (a live intro to the installed Aki system, rendered at runtime so it never goes stale), akigitcommit (turns a messy working tree into a few clean Conventional Commits, stages by path, never git add -A or auto-pushes).

One brain, two thinking modes

METHOD-deep-think.md is a single analytical brain (goal excavation, first principles, mandatory critique, conditional techbiz lens) consumed two ways: Passive — akirule auto-loads it inline when a normal task hits a signal ("should we…", "is it worth…"), applied briefly, at most one clarifying question; Active — run /akithink to drive the same METHOD through a full 5-phase protocol at maximum depth.

Update notifications — notify-only

A SessionStart hook compares the installed CHANGELOG.md against the public repo copy (at most once per 24h, fail-silent, non-blocking). When the remote is newer it only prints what’s new and the manual update command (git pull && bash install.sh). It never downloads or installs anything on its own.

The akirule router — three tiers

Tier 1 — Core

Loads every conversation via @path embed: index.md, RULE-agent-behavior.md, RULE-coding.md.

Tier 2 — Contextual

Read on signal match: design-core, docs, content-write, stack-akiNuxtCf, stack-tauri, ui-pattern, seo, release, db-design, biz.

Tier 3 — Methods

Analytical frameworks, loaded only when genuinely needed: METHOD-flow-audit, METHOD-deep-think, METHOD-ux-psych.

Six skills, each sharp at one job

akirule

automatic

A smart rule router, running on every conversation; hidden from the / menu.

akiflow

/akiflow

A sized multi-agent delivery pipeline — Tier 0 direct, Tier 1 Architect + Reviewer, Tier 2 adds business/UX counsel.

akithink

/akithink

A 5-phase deep-thinking session ending in a docs/ decision record.

akihtmlreport

/akihtmlreport

Distills a dense in-conversation analysis into one self-contained REPORT.html.

akihelp

/akihelp

A live intro to the installed Aki system, rendered at runtime so it never goes stale.

akigitcommit

/akigitcommit

Turns a messy tree into a few clean Conventional Commits; stages by path, never git add -A, never auto-pushes.

Author

Lạc Việt Anh  —  founder of the Aki ecosystem. AkiDevRule distills how he works with AI agents (Claude Code, Antigravity) across the ecosystem into a shared baseline, released as open source under the MIT License so the community can reference and reuse it.

AkiDevRule belongs to the ecosystem’s dev-tooling layer, tied to AkiDEV (dev.akitao.com) — which hosts the docs page and the install wrapper. See related projects: AkiDEV and Aki Dev Sync.

Frequently Asked Questions

What is AkiDevRule?
AkiDevRule (formerly named AkiClaudeDoc) is an open-source agent baseline shared by Claude Code and Antigravity/Gemini. With one install command it turns a fresh agent environment into Aki’s full working baseline: a shared rule corpus that loads itself at the right moment, plus a set of six sharp, single-purpose skills.
How do I install AkiDevRule?
Run: curl -fsSL https://raw.githubusercontent.com/lacvietanh/akidevrule/master/install.sh | bash (note the branch is master, not main). You can also run bash install.sh from a local checkout. The script is intentionally simple — inspect it before running.
Why was it renamed from AkiClaudeDoc?
On 27/07/2026 the repo renamed AkiClaudeDoc → akidevrule to match its widened scope: no longer Claude Code-only, it is now generated from one agent-neutral rule source shared by Claude Code and Antigravity/Gemini. The old GitHub URL auto-redirects to the new name.
What does AkiDevRule install, and where?
payload/* is synced into ~/.aki/claudedoc/ (excluding ref-ECC/): index.md, twelve RULE-* files and three METHOD-* files. Skills under claude/skills/* are copied into ~/.claude/skills/. The installer also replaces ~/.claude/CLAUDE.md with the packaged guidance (backup first), creates ~/.claude/CLAUDE.local.md only if missing (never overwritten afterward — the place for per-machine rules), updates ~/.claude/settings.json, and installs the aki-update-check.py hook.
How does akirule decide which rules load, and when?
Three tiers with deliberately high sensitivity (a few wasted tokens beats wrong behavior). Tier 1 core loads on every conversation: index.md, RULE-agent-behavior.md, RULE-coding.md. Tier 2 contextual is read on signal match: design-core, docs, content-write, stack-akiNuxtCf, stack-tauri, ui-pattern, seo, release, db-design, biz. Tier 3 is the analytical METHODs (flow-audit, deep-think, ux-psych), loaded only when the task is genuinely analytical.
Does it auto-update my machine?
No. It is notify-only, never auto-installing. A SessionStart hook compares the installed CHANGELOG against the public copy (at most once per 24h, fail-silent, non-blocking); when there’s a newer version it only prints the changes and the manual update command (git pull && bash install.sh). The Git repo is the source of truth — not an auto-updater, daemon, or package manager.
How do I uninstall AkiDevRule?
Delete: rm -rf ~/.aki/claudedoc; rm -rf ~/.claude/skills/{akirule,akiflow,akithink,akihtmlreport,akihelp,akigitcommit}; rm -f ~/.claude/hooks/aki-update-check.py. Then remove the AkiDevRule block from ~/.claude/CLAUDE.md and its entries (permission, skillOverrides, SessionStart hook) from ~/.claude/settings.json if desired.

One command. The same baseline. The Git repo is the source of truth.

View on GitHub