git:20261011.0131dc4 to git:20261015.8bf5089

# UPIIXIA Agentic Kit (uak)

> Multi-agent coordination for AI coding agents (Claude Code, Codex, Cursor, Gemini CLI). Several humans and agents work in parallel on one repo with no server: claims, leases, live summaries, typed messages, bounded verify-fix loops (loop engineering), a task DAG (graph engineering), reviewer rotation and a gated merge queue, all stored on a Git branch. Two modes: sprint (hackathons, fast AI prototypes) and marathon (secure, scalable products). Bash 3.2 + Git only. MIT.

Install into a repo: `git clone --depth 1 https://github.com/JoahanMorales/upiixia-agentic-kit ~/.uak-kit && bash ~/.uak-kit/install.sh --mode sprint .`

Try it with no setup (30 s, no keys): `git clone --depth 1 https://github.com/JoahanMorales/upiixia-agentic-kit && bash upiixia-agentic-kit/kit/.uak/bin/uak demo`

Claude Code plugin: `/plugin marketplace add JoahanMorales/upiixia-agentic-kit`, then `/plugin install uak@upiixia-agentic-kit`, then `/uak:setup`.

## Core

- [README](README.md): what it is, quick start, modes, results

- [AGENTS.md (kit core)](kit/AGENTS.md): the 60-line rules every agent follows

- [Sprint mode](kit/.uak/modes/sprint.md): hackathon clock, design lock, freeze, submission

- [Marathon mode](kit/.uak/modes/marathon.md): spec-driven flow, security, scalability, CI

## Reference

- [CLI](kit/.uak/docs/CLI.md): every uak command

- [Protocol](kit/.uak/docs/PROTOCOL.md): claims branch, leases, reviews, merges

- [Subagent orchestration](kit/.uak/docs/ORCHESTRATION.md): fast/balanced/strong tiers for Claude Code (Haiku/Sonnet/Opus 5.5), Codex (GPT-6 Luna/6.1 Sol/6 Astra; GPT-5.6 Luna/Terra/Sol), Cursor (Composer 2.5) and Gemini CLI; strong model only at 3 checkpoints; parallel and strong budgets enforced by hooks

- [Costs and pacing](kit/.uak/docs/COSTS.md): API prices, Claude Pro/Max, Codex Plus/Pro, Cursor Pro/Ultra limits; `uak pace` spends the 5-hour and weekly windows at the right speed (surge, conserve, critical)

- [Black box](kit/.uak/docs/BLACKBOX.md): `uak bb`, an anonymous flight recorder of kit failures, on by default, harvested across public repos to improve the kit

- [Loop engineering](kit/.uak/docs/LOOPS.md): trigger, verifier, budget, stop, escalation; `uak loop`

- [Graph engineering](kit/.uak/docs/GRAPH.md): members, mandates, message paths, task DAG; `uak graph`

- [Security](kit/.uak/docs/SECURITY.md): guards, the secret scanner, the mawk trap, a 22-item launch checklist

- [Why each rule exists](kit/.uak/docs/WHY.md): incident-backed rules

## Evidence

- [Example AI hackathon backlog](examples/ai-hackathon/TASKS.md): 10 tasks, 7 in wave 1

- [Hack-Nation 2026 retro](docs/RETRO-hacknation-2026.md): 5 agents, 4 humans, 76 PRs, with data

- [First black box harvest](docs/blackbox/upiixsol-2026-10.md): 16 kit issues from a 3-day marathon project, each mapped to a v4.1 fix

- [Reap buildathon autopsy](docs/blackbox/reap-2026-10.md): a 4 h event, 11 agents on Codex/Cursor/Claude Code, 13 findings each mapped to a v4.2 fix (scope gate, scaled freeze, `uak allow`, context hygiene)

- [Hackathon in one page](docs/HACKATHON.md): minute-0 commands, `uak clock`, freeze exceptions, fixes per error

- [Inspirations](docs/INSPIRATIONS.md): AGENTS.md, Spec Kit, BMAD, Kiro, Task Master, superpowers