AWKit — Antigravity Workflow Kit

Antigravity v12.5 · npm package v1.6.5 · Single Source of Truth · Symphony-first · Mindful execution

AWKit is a professional AI-agent orchestration framework. This repository is the single source of truth for workflows, skills, core rules (GEMINI.md), and installation tooling (no more scattered configs across multiple repos).

AWKit focuses on predictable execution: task management via Symphony, optional Trello sync and Telegram notifications, plus mindful checkpoints that help agents (and humans) stop at the right time and avoid over-optimizing.

Core Principles

AWKit (Antigravity v12+) enforces a small set of non-negotiable principles to keep AI work safe and effective:

1. Anti-sycophancy: push back when an approach has red flags; do not agree blindly.
2. Search before building (3-layer): check NeuralMemory/codebase first → then standard libraries/SDKs → only write new code as a last resort.
3. Completion status protocol: use one of DONE, DONE_WITH_CONCERNS, BLOCKED, NEEDS_CONTEXT.
4. Decision principles: Complete > Shortcuts, Evidence > Assumptions, Standard > Custom, Explicit > Implicit, Test > Trust, Small > Big.
5. 3-strike escalation: after 3 failed attempts at fixing the same issue, stop and report context for a decision.
6. Scope freeze for debugging: no unrelated edits, no refactors; focus on root cause.
7. "Boil-the-lake" checklist before DONE: error handling, edge cases, logging, cleanup, input validation, etc.
8. Safety guardrails: block dangerous commands by default; require double confirmation.
9. Mindful execution (v12.5+): iteration counter, scope guard, milestone rest.

Quick Start

Install (3 steps)

# 1) AWKit Core (CLI + workflows + skills)
npm install -g @leejungkiin/awkit
awkit install

# 2) Symphony (Task Management & Multi-Agent Orchestration)
npm install -g @leejungkiin/awkit-symphony

# 3) Optional: NeuralMemory (AI Memory Engine — requires Python >= 3.11)
pip install neural-memory
nmem init

# Verify
awkit doctor
symphony --version
nmem --version

Notes:

• awkit install installs only the core runtime profile for the active platform by default (keeps context lean).
• Enable domain-heavy packs later via awkit enable-pack <name>.
• Use awkit install --all only if you explicitly want to regenerate every supported platform.

CLI Commands

| Command | Description | |---------|-------------| | awkit install | Install AWKit core runtime to the active platform | | awkit install --all | Install AWKit core runtime for all supported platforms | | awkit update | Update to the latest version | | awkit init | Initialize a new project (creates .project-identity, CODEBASE.md, etc.) | | awkit sync | Full sync: harvest + install (one shot) | | awkit status | Compare repo vs installed runtime (diff view) | | awkit harvest | Pull from ~/.gemini/antigravity/ back into this repo | | awkit doctor | Health checks for installation | | awkit list-packs | List optional skill packs | | awkit enable-pack <name> | Enable a skill pack | | awkit disable-pack <name> | Disable a skill pack | | awkit gate ... | Execute gated automation (git/trello/telegram) | | awkit tg setup | Configure Telegram bot token, chat id, and topic | | awkit tg send <msg> | Send a Telegram message | | awkit version | Print version |

Typical Workflow

# 1) Check what's out of sync
awkit status

# 2a) You edited in ~/.gemini/antigravity/ → pull back to repo
awkit harvest

# 2b) You edited in repo → deploy to active runtime
awkit install

# 2c) Both directions (full round-trip)
awkit sync

# 3) Commit safely (gated)
awkit gate git auto "chore: sync AWKit snapshot"

Repository Layout

main-awf/ (Source of Truth)
├── bin/                        # CLI entry points
├── core/                       # Core rules/routing for agents
├── workflows/                  # Workflow library
├── skills/                     # Source skill library
├── skill-packs/                # Optional add-ons, installed on demand
├── schemas/                    # JSON schemas
├── templates/                  # Project templates
├── scripts/                    # Harvest, automation gate, tooling
└── package.json                # @leejungkiin/awkit

Harvest (Migration)

If you edited files directly in ~/.gemini/antigravity/ and want to sync them back to this repo:

# Preview (no changes)
node scripts/harvest.js --dry-run

# Execute harvest
node scripts/harvest.js

Runtime Model

main-awf/ (edit here)
    |
    |  awkit install
    v
~/.gemini/antigravity/ (runtime)
    |
    v
Gemini / Claude / Any AI reads from runtime

Lean Runtime

awkit install does not copy the entire source skill library into runtime by default.

• Default install = core work profile only (orchestration, planning, debugging, verification, review, coordination).
• Default target = active platform only, keeping platform-specific generated artifacts untouched unless explicitly requested.
• Domain-heavy packs (reverse engineering, marketing/ASO, media production, etc.) are excluded until you opt in.
• awkit status compares runtime against the core profile + enabled packs (optional packs do not create false drift).

Automation Gate

AWKit provides a gated automation layer that reads .project-identity and enforces automation.* before executing:

awkit gate git commit "chore: update"
awkit gate git push
awkit gate git auto "chore: update"

awkit gate trello complete "Task Name"
awkit gate trello comment "Progress note..."
awkit gate trello block "Reason"

awkit gate telegram send "Message"

Telegram Integration

Configure AWKit to send notifications (e.g., after pushes, tests, deploys):

# Setup bot token, chat id, and thread id (topic)
awkit tg setup

# Send a test message
awkit tg send "Hello from AWKit!"

# Send to a specific chat/topic
awkit tg send "Hello" --chat -100123456789 --topic 1234

GitNexus Code Intelligence

AWKit integrates GitNexus for code intelligence and knowledge graphs.

# 1) Build a knowledge graph for a project (first run or after major structure changes)
npx @duytransipher/gitnexus analyze

# 2) Setup MCP servers and editor integrations
npx @duytransipher/gitnexus setup

Skill Packs

awkit list-packs
awkit enable-pack neural-memory
awkit enable-pack mobile-ios
awkit enable-pack mobile-android
awkit enable-pack marketing
awkit enable-pack creator-studio

License

MIT