What Is AkiDevRule?

AkiDevRule is a rule corpus (a repository of behavior constraints) plus a shared skill set, built and maintained publicly on GitHub by Lac Viet Anh. Its goal is specific: one install command turns a completely fresh machine into a full working baseline for Claude Code, Antigravity/Gemini, Codex CLI, Kiro CLI, and Grok CLI — instead of hand-copying separate system prompts, rules, and skills per tool that inevitably drift apart over time.

This is not a browser-based web app or mini-app like most other tools in the AkiNet ecosystem. AkiDevRule is a pure dev-tooling utility that runs entirely inside a terminal, built for people who use Claude Code and other AI CLIs — no GUI, no account required, no data collection.

Why AkiDevRule Exists

Working across several different AI CLI tools at once, behavior rules (never leave junk commits, never edit outside the requested scope, comment style, error handling...) tend to get duplicated across tools — a separate CLAUDE.md, a separate GEMINI.md, edit one and forget the other. AkiDevRule solves exactly this Single Source of Truth problem: every rule is written once in one Git repo, and the installer generates the right shape for each target CLI.

What Does AkiDevRule Actually Install?

  • Rule corpus (payload/*.md): RULE-*.md files (behavior constraints: agent behavior, coding, pattern, docs, content, SEO, release, DB design, biz...) and METHOD-*.md files (analytical frameworks: deep-think, flow-audit, ux-psych, proportionality...). For Claude Code, the core group (RULE-agent-behavior.md, RULE-coding.md, RULE-pattern-core.md, index.md) is hard-loaded via @-import inside ~/.claude/CLAUDE.md, applying every session with no model decision to invoke a skill required.
  • 10 shared skills following the open SKILL.md standard: akirule (signal-based rule router), akiflow (lead-coordinated agent council), akiship (runs the full release ritual), akigitcommit, akithink, akihelp, akilint, akihtmlreport, aki-article-writer, akidevsync-notes. Because SKILL.md is an open standard, this skill set also syncs to Codex CLI, Kiro CLI, and Grok CLI, not just Claude Code.
  • 5 pre-built agent definitions (Claude Code only, since an agent-definition format currently has one consuming CLI): aki-hands (read-only), aki-judge, aki-conduct, aki-challenger, aki-maker (the only agent permitted to write files).

Where Does It Install On Your Machine?

The installer is one cross-platform Python program (install.py, no rsync/find/awk dependency), invoked via install.sh (Unix) or install.ps1 (Windows). It syncs the rule corpus into ~/.aki/akidevrule, deploys skills into ~/.claude/skills/ and each CLI's own skill directory, copies the 5 agents into ~/.claude/agents/ file by file (never deleting your own agents), and updates ~/.claude/CLAUDE.md/settings.json. Every sync touches only the exact files/folders AkiDevRule manages — never a blanket directory wipe.

Is AkiDevRule an Auto-Updater?

No. The Git repo is the single source of truth; you edit rules there and manually re-run the installer. An already-installed machine only gets a notification (never an automatic download or install) when the public repo has something newer, checked at most once per 24 hours, fail-silent if the check fails.

Quick Install

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

See the step-by-step install for macOS, Linux, and Windows in Installing AkiDevRule for Claude Code, or go deeper into the loading mechanism in How AkiDevRule's Rule Corpus and Skills Actually Load. Full source, README, and CHANGELOG at github.com/lacvietanh/akidevrule.