Handbooks
The citable canon every Bankai-consuming repository is built and reviewed against, per stack and per baseline.
Bankai-Handbooks is the single canonical source of the numbered, citable rules. A consumer never authors canon; it carries a generated, pinned mirror rendered from a tag of the handbooks repository, with a drift check. Reviewers cite rules by id and never invent them.
Read from the repositories at commit: hatsu 3c582c18a4 (v0.159.0) · nen d7a720ddcd (v0.29.0) · handbooks 39b8e06d3c (v0.13) · 2026-11-04
Families and rule prefixes
| Family | Where | Prefix |
|---|---|---|
| Governance constitution | CONSTITUTION.md | CON-{n} |
| UZF cross-platform architecture | handbooks/uzf-core.md | UZF-{n} |
| Security baseline | handbooks/security-baseline.md | SEC-{n} |
| UX baseline | handbooks/ux-baseline.md | UX-{n} |
| Release policy | handbooks/release-policy.md | REL-{n} |
| Quality baseline | handbooks/quality-baseline.md | QA-{n} |
| Spec authoring | handbooks/spec/authoring.md | SP-{n} |
| SwiftUI + TCA stack | handbooks/stacks/swiftui-tca-uzf-v2/ | SW-{n} |
| Jetpack Compose stack | handbooks/stacks/compose-uzf-v2/ | KT-{n} |
| React + Redux Toolkit stack | handbooks/stacks/react-uzf-v1/ | RC-{n} |
| Bankai machinery (self-review) | handbooks/stacks/bankai-machinery/ | BC-{n} |
| Port rulings (stack to stack) | handbooks/ports/ | PT-{n} (one global counter) |
| Shared agent conventions | CONVENTIONS.md | — (no rule ids; the output shape every agent follows) |
The UX baseline, as an example
The rules the UI reviewer cites, by id:
UX-1— Sufficient contrast and a visible focus stateUX-2— Operable by keyboard/switch with accessible namesUX-3— Touch targets ≥ 44×44 and adequately spacedUX-4— Every async or state-changing action gives immediate feedbackUX-5— Style through semantic design tokens, never raw literalsUX-6— Deliberately designed components and vector icons — no raw defaults, no emoji iconsUX-7— Responsive layout, no horizontal scroll, stable during loadUX-8— Legible type scale and rhythmUX-9— Purposeful motion, 150–300ms, honoring reduced-motionUX-10— Persistent visible labels and inline, field-adjacent errorsUX-11— Predictable navigationUX-12— Readable, non-color-only data visualizationUX-13— Adapt the platform idiom, mirror the product