Skip to content

Kyōjo (共助)

Kyōjo (共助 — "mutual aid") is a real-time humanitarian coordination platform for Japan's disaster response ecosystem.

Core trick

Dispatches ten Claude subagents in dependency-ordered waves that gather live data and produce citation-checked multilingual alerts for disaster response.

Tags

Description

Kyōjo (共助 — "mutual aid") is a real-time humanitarian coordination platform for Japan's disaster response ecosystem. When a major earthquake or typhoon strikes, the gap between what people need and what reaches them is not a technology problem — it is a coordination problem. Emergency operators juggle disconnected systems. Foreign residents fall off the edge of Japanese-only alerts. Volunteer capacity sits idle while open needs go unfilled. Kyōjo solves this with three interlocking capabilities: 1. Interactive Japan Map — A Canvas 2D Mercator map centred on Japan shows aid-network flows between 8 cities across 8 regions. When a disaster scenario is selected (Nankai Trough, 2024 Noto, Typhoon, 2011 Tōhoku, or custom What-if), arc paths react in real time: gold flows break into dim disrupted lines and coloured emergency routes appear at the epicentre. 2. Claude Opus 4.7 Orchestrator — Dispatches 10 specialised subagents in 3 dependency-ordered waves to produce a complete, citation-verified operations packet in under 15 minutes: seismic situation report, damage assessment, real-time shelter discovery via Google Places, population vulnerability overlay, resource matching, and multilingual public alerts (JA + EN + dynamic third language via TTS). 3. Living Knowledge Base — 22-document preparedness corpus (Cabinet Office whitepapers, JMA guides, prefectural hazard plans) with BM25 retrieval, an AI chat interface, and enforced source citations — available in 14 languages. Built for NGOs, volunteer centres, and government responders. Fully accessible (WCAG 2.2 AA, JIS X 8341-3, reduced motion, audio alerts). Zero invented facts: the Verifier agent blocks packet release if any claim cannot be traced to a source.
PascalBurume/kyojo★ 00 forksTypeScriptCreated Apr 26, 2026 · last push Apr 26, 2026

README excerpt

# Kyōjo — Design & Front-End Guide

> One-page entry point to Kyōjo's design process, UI/UX decisions, tech stack, and contributor rules. Everything in this folder is written for three audiences at once: **product managers**, **front-end engineers**, and **software designers**. Depth lives in the companion files; this README is the hub.

---

## 0. What is this document

You are reading `docs/README.md`. It explains:

1. **The design process** — how we got to the current UI decisions, and how to repeat the loop for new work.
2. **Key UI/UX and technology decisions** — the answers, with reasons you can defend to a stakeholder.
3. **Integration of reference repos** — how Kyōjo incorporates [Impeccable](https://github.com/pbakaus/impeccable) (design-system discipline) and [Claude Code](https://github.com/anthropics/claude-code) (agentic orchestration).
4. **Contributor guidelines** — what to do, what not to do, how to review.

Companions:

- [design-system.md](design-system.md) — tokens, typography, colour system, spacing scale, motion rules
- [wireframes.md](wireframes.md) — screens and flows with ASCII wireframes
- [accessibility.md](accessibility.md) — WCAG 2.1 AA checklist + JIS X 8341-3 considerations
- [tech-stack.md](tech-stack.md) — framework and library selection with rationale
- [user-research.md](user-research.md) — personas, journey maps, findings, pain points
- [trusted-sources.md](trusted-sources.md) — Live cross-reference snapshot (JMA + USGS + Google Places) and 

Team