llms.txt git:20261015.86234b5A

Immutable. This exact content never changes and is served at /api/v1/blob/62d6a3adc77ff839.

# 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; `uak tokens` measures the real token spend per task, model and subagent from local transcripts. 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 75-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): `uak tokens` (the real bill), 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` (stops on no progress or an edited test; `--parallel` per failing file)
- [Graph engineering](kit/.uak/docs/GRAPH.md): members, mandates, message paths, task DAG; `uak graph` (`--assign` suggests who takes what)
- [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)
- [MLB hackathon autopsy](docs/blackbox/mlb-2026-10.md): 10 days, 4 Windows laptops, 13 identities on Claude Code/Codex/Cursor; 15 findings mapped to v4.3 (merge by any agent after approval, approvals that survive merges of main, gate venv, retire, followup, output cap on Windows and Codex)
- [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