---
description: UPIIXIA Agentic Kit — multi-agent coordination (AGENTS.md + mode)
alwaysApply: true
---
Read and apply `AGENTS.md` once per session, then `.uak/modes/<mode>.md` (the mode is in `.uak/PROJECT.md`).
- Start: `bash .uak/bin/uak next`. Take a task: `bash .uak/bin/wt new ID --agent NAME`, then work ONLY inside that worktree.
- `.cursor/hooks.json` guards shell commands, caps subagents (tiers: Composer 2.5 swarms, your model leads, Opus advises) and flushes the black box. Heartbeats are manual: every ~10 min and after each criterion run `bash .uak/bin/uak heartbeat ID` and `bash .uak/bin/uak inbox`. Reply with `uak msg`.
- Big outputs: a `preToolUse` hook wraps tests, builds, linters and read-only git/search commands; an output over 12k chars reaches you as head + tail + the path of the full log. Read the log by ranges (`sed -n`, `grep -n`); rerun with `UAK_RAW=1` only if you need everything. Small outputs are unchanged.
- Do not poll: `= unchanged` from `uak status`/`next`/`inbox` means nothing new; `LOOP:` means stop retrying.
- Plan usage: Cursor has no 5-hour signal. Copy your dashboard once: `bash .uak/bin/uak pace set USED --resets +Nd --window 30d`, then follow `uak pace`.
- If a guard is not active (hooks off): before any destructive or publishing command run `bash .uak/bin/guard check "<command>"`. Exit 2 means do not run it.
- Phase scripts live in `.claude/commands/uak-*.md`. Read the one for your phase (start, loop, ship, review, handoff).