aapp-protocol

Aapp Kit — AI skill for Claude Code

AI community

Zero-drift autonomous pair-programming architecture for Antigravity, Claude Code, Cursor & AI agents.

How to install Aapp Kit

This entry records only its repository, not the path inside it, so there is no exact command to give. Open aapp-protocol/aapp-kit and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Aapp Kit does

Zero-drift autonomous pair-programming architecture for Antigravity, Claude Code, Cursor & AI agents. Decouples planning, agent rules, and git enforcement using isolated Git worktrees on orphan branches with dual-layer blast radius protection.

Alternatives in AI

Ccstatusline — by sirmalloc - A highly customizable status line formatter for Claude Code CLI that displays model info, git b 5.5k ★
Agent Rules Books — AGENTS.md rules / skills for AI coding agents: Codex, Cursor & Claude Code 2.6k ★
PRD: Agent Builder — Create Your Own Sub-Agent — Your ecosystem, your rules 1.9k ★

README

🤖 Asymmetric Agent Planning Protocol (AAPP)

**Zero-Drift Autonomous Pair-Programming Architecture for Antigravity, Claude Code, Cursor, Copilot & AI Coding Agents.** Completely decouples planning, agent rules, and git enforcement from your application source code using isolated Git worktrees mounted on orphan branches.

📚 **Deep Dive**: For the full architecture, Git plumbing, and operational guide, see [MANUAL.md](MANUAL.md).

📑 Table of Contents

1. Why AAPP? The Problem of Agent Drift
2. The Core Architecture
3. Dual-Layer Blast Radius Enforcement
4. Quick Start & Distribution Modes
- Option 1: Drop-In Project Setup (Self-Consuming)
- Option 2: Global Installation
5. Existing Project Conflicts & Hook Interoperability
- Conflict Handling & Silent-Skipping Warnings
- Existing Hook Managers (Husky, Lefthook, Native Hooks)
6. Remote Sync & Multi-Machine Workflow
7. Daily Agent Workflow & Slash Commands
8. Testing & Verification Suites
9. Blueprint Example & Technical Manual
10. License

1. Why AAPP? The Problem of Agent Drift

Working with AI coding assistants through unconstrained flat chat creates **agent drift**:

Scope Creep: The agent modifies unrelated files, rewrites existing helpers, or refactors working logic without permission.
Context Hallucination: AI instructions, scratchpads, and planning state pollute your main code commits a