TwoMore Documentation Index

Auto-generated by scripts/generate-docs-index.mjs (run yarn docs:generate). The complete, grouped index of every Markdown doc under docs/ — 233 files. Do not hand-edit; edit the source docs and regenerate.

Cockpit & work area

What's active, blocked, and how to proceed — plus the status legend.

• Current Documentation State — Generated
• Current Project State — Generated
• Doc Status Conventions — Active
• External Blockers Register — Active
• Full status — Active
• How the Cockpit Works — Active
• index — Active

Wireframes

The app’s wireframes — one config-driven surface per section, plus screens and the rating model.

• ELO Tier System — Cross-Rating Mapping Specification — Active
• Rating System v2 — Specification — Active
• Screen Blueprint — TwoMore (투마) — Reference
• Surface System Unification — Clubs + Sessions (info-models, projections, canonical bindings) — Active
• Wireframes — Active

Roadmap & launch

The R1→R4 plan, the current slice, launch gates, evidence, and the operating workflow.

• Agent prompt templates — Curated prompt scaffolds for common agent tasks on TwoMore. Each template:
• Change Routing Workflow — Active
• Claude Agent Ingestion Brief — Active
• Engineering Soundness Masterfile — Active
• Maestro E2E — Active
• Multi-Agent Operating Model (Claude Code + Codex) — Active
• Performance budgets — Reference
• Pre-launch Checklist — Active
• Production Readiness Review — Active
• QA automation — the ladder — Active · Drafted: 2026-09-04 (owner ask: automate as much QA as possible; device remains the last rung)
• R1 Activation Source Pack — Active
• R2-0 Admin Workflow Teardown — Active
• Release Evidence Ledger — Active
• Release Versioning And OTA Workflow — Active
• Slice-Completion Loop — Active
• Template: Add a new feature screen — Reference
• Template: Add a new mutation hook — Reference
• Template: Add a new query hook — Reference
• Template: Execute A Roadmap Slice — Reference
• Template: Performance investigation — Reference
• Template: Refactor shared code — Reference
• TwoMore Roadmap — Active
• TwoMore Roadmap Implementation Plan — Active
• Venue maintenance recovery — Active
• Venue ownership workflow — Active

Product

What we're building and why — the feature map, product spec, and market/opportunity research.

• Color system audit (research-based) — Accepted · Ruled 2026-09-10 · Date: 2026-09-06 · Purpose: owner-requested check that the Classic Grass palette is res…
• Decision log — autonomous ownership pass (2026-09-17) — Active · Date: 2026-09-17 · Owner brief: "Can you perform as much of the work as possible?" — the owner, fatigued, as…
• Decision log — detail pages flat language — Reference · Scope: every owner ruling that produced the flat detail-page language (docs/twomoredesignsystem/wireframe…
• Detail pages — club-detail canon vs flat primitives (spacing audit) — Accepted · Applied: 2026-09-05 · Owner ruling: "think of the spacing and alignment in the club detail page as the can…
• Detail pages — flat language (audit · spec · migration plan) — 2026-09-05 — Draft · Note (2026-09-06): the row grammar below (HairlineList, bottom-hairline rows) was superseded by the Divider l…
• Detail pages — flat language build spec (spacing · alignment · shared components · models · interactions) — 2026-09-05 — Draft · companion to detail-pages-flat-language-2026-09-05.md (audit + grammar + decisions) and the board /wireframes…
• Detail pages — seam & structure audit (pre-implementation) — Accepted · Date: 2026-09-06 · Purpose: page-by-page audit of the flat detail pages against the seam ladder, two rails…
• Flat spacing audit — 2026-09-08 — Active · Trigger: owner, 2026-09-08 — "many of the flat pages we've implemented don't seem to have proper spacing and…
• Match Formats — Flexible Multi-Set Scoring (Phase C) — Active — Waves 1-3b SHIPPED (foundations, engine wiring, seed/read-path groundwork, format picker + per-set entry UI)…
• Match Rotation Engine Specification — Active
• Middle-dot joins, meta/sub text styling, graphical asset placement — Accepted · Date: 2026-09-06 · Purpose: inventory behind three owner directives (no middle-dot joins; meta and sub tex…
• Progression System — Design Specification — Draft
• Rhythm, flow, spacing and alignment audit — every screen, every primitive — Active · Date: 2026-09-06 · Owner ask: "from the very top component to the bottom component, the visual rhythm and do…
• Signal System — Unified Alerts, Banners, Badges, Notifications — Reference — Locked spec, ready to implement (all open questions resolved, see §14)
• Sports Club Administration Opportunity Audit — Active
• Tennis Playability Index (TMI) v2 — Specification — Reference — Current
• Terminology Guide — TwoMore (투마) — Reference
• Trust & Reputation System — Specification — Draft v2
• TwoMore App Functionality Map — Active
• TwoMore Market And Revenue Research — Active
• TwoMore Platform Architecture — Features, Trust, Subscriptions — Reference — Final Draft
• TwoMore Product Spec Sheet — Active
• TwoMore Revenue Model — Complete Specification — Reference — Final Draft
• Usability audit — familiar and streamlined for low digital literacy — Accepted · Date: 2026-09-16 · Owner brief: "provide a familiar and streamlined user experience, visually and behavior…
• Venue finder engineering audit — 2026-09-04 — Draft · engineering audit of the venue finder, low-risk fixes applied in the same commit
• Venue surfaces UX audit — 2026-09-04 — Draft · proposals only — nothing here is built; companion to the mechanical fix pass of the same date
• Visual design audit vs industry practice — Accepted · Date: 2026-09-06 · Purpose: owner-requested inspection of the shared primitives and the flat detail pages …
• Voice & Tone Guide (Korean UX Writing) — Active

Docs & reference

How we build — conventions, architecture, guides, best-practices, and audits.

• 0001 — Agentic project foundation: 9-layer infrastructure — Accepted
• 0002 — Hexagonal architecture for shared business logic — Accepted
• 0003 — Tamagui as the sole styling solution — Accepted
• 0004 — Supabase as the managed backend — Accepted
• 0005 — Network orchestration protocols (A–K) — Accepted
• 0006 — ESLint ratchet: waiver discipline for new rules — Accepted
• Accessibility (A11y) Standards + Test Plan — Reference
• Account and offline queue integration — Active
• Adversarial audit — color, typography, elevation & tone — Active · Owner ask: "are there any components or styles or behaviors that are not in sync or harmony?" — color/typogr…
• Adversarial audit — hardcoded strings & keys (2026-09-09) — Active · Owner ask: "No more hardcoded strings or keys." Read-only adversarial audit; the fixes it drove shipped 2026…
• Adversarial audit — stale code & shareable-logic duplication (2026-09-09) — Active · Owner ask: "remove duplicate codes and turn them into shared codes. No more stale functions." Read-only adve…
• Agentic Project Foundation — Reference — P0 → P7 substrate shipped (with caveats — see phase table). Active for ratchet shrink + remaining DOC-pla…
• Android Emulator Setup & Running the App — Reference
• Architecture Conventions — Active
• Architecture Decision Records (ADRs) — This directory holds the canonical record of major architectural decisions made on TwoMore.
• Authentication — Native SDK Implementation — Active
• Backend pipeline handoff — Active
• Best Practices Reference — Comprehensive best-practices guides for TwoMore, covering all aspects of React Native (Expo SDK 55) app development. …
• Builds & Deployment — Reference
• Club Surface Conventions — Active
• Component Conventions — Active
• Consolidation plan — configuration and code, 2026-09-13 — Accepted · Executed: 2026-09-13 (rebuild-log entry "Configuration and code consolidation"; the gates it introduced ar…
• Conventions › Match Generation — Reference — Spine established 2026-07-14 (owner-directed). Only the recording axis is active; every other axis is mod…
• Conventions › Session Fees & Dual-Rail Payments — Active
• Copy and adversarial audit — 2026-09-12 → 2026-09-17 delta — Accepted · Date: 2026-09-17 · Scope: commits 56fc2132..HEAD
• Credentials & Environment Variables — Reference — Current
• Data & Hooks Conventions — Active
• Dead & Stale Register — Active
• Debugging Workflow — Reference — Current
• Dev-scenario audit — do the seeds show what the app can show? — 2026-09-08 — Active · Owner ask: "the dev scenarios may not reflect what the app is capable of fetching and showing — take another…
• Device checklists — the only checks that need a phone — Active · Last reviewed: 2026-09-17 · Owner: the phone in hand; everything else in the QA ladder is machine-run (qa-au…
• Duplication audit — components, pages, in-page information (2026-09-08) — Active · Owner ask: "audit across components and pages to remove duplicate components; streamline and compact the use…
• Expo Push Notifications — Reference
• External APIs & Services — Index — Reference
• Flat layout — implementation plan (track F) — Active · Owner ruling (2026-09-07): one grammar keyed on content shape; every detail page, list/settings shell and cl…
• Foundational Schema Audit — Tennis Standards & Future-Proofing — Reference — Planning artifact, NOT a migration batch. 8 of 8 domains have verified, adversarially-reviewed research.
• Foundational-Schema Decisions — Reference — Decided positions + library selections + ordered implementation plan. This is the ACTIONABLE resolution o…
• Global Schema Overhaul — Target State (pre-launch clean break) — Active
• Globalization Model Review — Global vs Region-Specific — Active
• God-file refactor — plan and ledger — Active · Started: 2026-09-04 (owner: "properly take care of all the god files, abide by the architecture patterns app…
• Hardcoded-value audit — config-driven-flow gaps — Active · Owner ask: "No hardcoded values when configurations-driven flow can work." Read-only adversarial audit. C1 (…
• Information-Flow Audit — Right Information, Right Timing — Active
• International Data-Model Foundation — Reference
• International Rating-System Audit — JP / US / EU (adversarial) — Active · Last reviewed: 2026-08-11
• Korean Market Conventions — Active
• Manual payment authority audit — Active
• Matchmaking Pipelines — Status Tracker — Active — living tracker, update in place as fixes ship
• Motion, Interaction & State-Behavior Disharmony Audit — Active · Owner ask: "are there any components or styles or behaviors that are not in sync or harmony?" — motion/inter…
• Naver Local Search API (via Naver API Hub) — Reference
• Naver Maps Deep Links — Reference
• Networking Conventions — Active
• Networking, Caching & Data Layer Best Practices — Reference
• Notification Conventions — Active
• Owner credential run-sheet — the accounts only you can open — Active · Last reviewed: 2026-09-17 · Audience: the owner, one sitting per section, browser and phone in hand. Everyth…
• Perf and data-integrity audit — 2026-09-12 → 2026-09-17 delta — Accepted · Date: 2026-09-17 · Scope: commits 56fc2132..HEAD
• PortOne v2 payments — setup guide — Reference
• Pretendard fonts — TwoMore — The official TwoMore repo expects four OTF weights at:
• Primitive drift audit — visual and behavioural — Accepted · Date: 2026-09-17 · Owner brief: "Run adversarial, research-based audit of all the visual components and pr…
• Rating Interop Model — full interoperability with governing-body rating systems — Active · Last reviewed: 2026-08-11
• Rating System Hardening Audit — full-target red team (KR + international) — Active · Last reviewed: 2026-08-12
• Rating Systems of the World — a primer on how they're built and what they believe — Active · Last reviewed: 2026-08-11
• React Native (Expo SDK 55) Best Practices: UI/UX, Accessibility, Navigation — Reference
• React Native Performance & Memory Management Best Practices — Reference
• Region Cutover Plan — TEXT vocabulary → administrative_divisions FKs — Active
• Research Methodology — Multi-Dimensional Grounding — Reference
• Review Checklist — semantic guidance reviewers must apply — Reference
• Scale + Connection Limits — Supabase Postgres + Edge Functions — Reference
• Screen Blueprints — Clubs — Active
• Screen Blueprints — Home — Active
• Screen Blueprints — Legal — Active
• Screen Blueprints — Matches — Active
• Screen Blueprints — Messaging — Active
• Screen Blueprints — Profile — Active
• Screen Blueprints — Records — Active
• Screen Blueprints — Sessions — Active
• Screen Blueprints — Settings — Active
• Screen Blueprints — Venues — Active
• Security & Authentication Best Practices — Reference
• Session Surface Conventions — Active
• SessionCard v2 — Implementation Decision Packet — Accepted
• Shared Client Architecture — Active
• Spacing / rhythm / layout disharmony audit — 2026-09-10 — Active · Owner ask: "are there any components or styles or behaviors that are not in sync or harmony?" — spacing/rhyt…
• Staged OTA Rollout Procedure — Active
• State Management, Architecture & i18n Best Practices — Reference
• Status & Recruitment Conventions — Active
• Supabase — Reference
• Tamagui & Styling Conventions — Active
• Testing, Error Handling, Monitoring & Build/Deploy Best Practices — Reference
• Trust Tier Conventions — Active
• TwoMore Design System — This design system packages the classic grass-court green, Toss-minimal visual language of TwoMore v2 — its tokens an…
• UX-audit residual queue — owner decisions — Active
• Venue closure and release handoff — Active
• Venue data — evidence and owner verification (canon) — Active · Ratified: 2026-09-03 (owner: "Naver is the more commonly used map provider. So Naver it is.")
• Venue data closeout — September 5, 2026 — Active
• Venue Metadata Ingest — runbook & status — Reference
• Venue ownership pipeline implementation audit — Active
• Venue pipeline implementation and audit — Active
• Venue pipeline integration review — 2026-09-07 — Active · Branch: integrate/venue-pipeline-20260907 (main 427024f7 + codex/venue-pipeline-20260906 at 2394990f, 13 com…
• Venue Trust Pipeline — Implementation Plan — Archived
• Wireframe + Spec Buildout — every screen, grounded in code — Accepted
• Wireframes System — Active
• Wizard Conventions — Active
• Working-Model Retro — honest collaboration feedback — Active

Archive & history

Retired and superseded docs, session logs, and the milestone archive — history only.

• Alert-Model Wiring Contract (2026-07-11, owner-approved) — Archived
• Audit Remediation — Problem Spaces & Solution Architecture (2026-07-11) — Archived
• Autonomous Sweep Log - 2026-04-24 — Archived
• Autonomous Wave-2 Run Ledger (2026-07-12, owner asleep) — Archived
• B1 — Clubs Domain: Adversarial BACKEND Audit — Archived
• B2 — Sessions/RSVP: Adversarial BACKEND Audit — Archived
• B3 — Payments (Backend) Adversarial Audit — Archived
• B4 — Matches + Rating (Backend) Adversarial Audit — Archived
• B5 — Attendance/Trust + Dues (Backend) Adversarial Audit — Archived
• B6 — Venues + Weather: Adversarial Backend Audit — Archived
• B7 — Platform Plumbing (Backend) Adversarial Audit — Archived
• B8 — Auth/Identity (Backend): Adversarial BACKEND Audit — Archived
• Backend Wiring Plans — 2026-07 Adversarial Audit Synthesis — Archived
• CLAUDE.md Milestone Archive — Archived
• Club Growth Completion Slices — Archived
• Counsel Prep Brief — TwoMore v2 Privacy Policy + Terms of Service — Archived
• Device Setup — EAS Build + OTA Updates — Superseded
• Drift Prevention — Mechanical Enforcement Strategy — Archived
• Elo Rating System Specification — Superseded
• Full-corpus venue audit 2026-09-03 — thin rows both judges could not classify — Open · these venues stay at their rule-based label; enrichment or a human check would settle them.
• Home State Model — Specification — Archived
• i18n audit — TwoMore — Archived
• Implementation Plan — 2026-07-11 Whole-App Audit Remediation — Superseded
• Implementation Roadmap — 2026-07 Audit Remediation — Archived
• Matchmaking Pipeline & Registry — Implementation Spec — Archived
• Naver identity adjudication — September 5, 2026 — Evidence captured; unresolved pairs remain on hold
• Networking Foundation — Phased Implementation Plan — Archived
• Onboarding Redesign Specification — Archived
• Overnight session summary — 2026-04-18 — Archived
• Profile / Engagement / Offline / Clubs / Pickup / Settings / Aliveness — TwoMore production roadmap — Archived
• PS1 — Access Control & DB Hardening — Archived
• PS1 Profiles PII Split — Implementation Spec (research-grounded, 2026-07-12) — Archived
• PS10 — Records & Analytics UX — Archived
• PS11 — Platform Guardrails — Archived
• PS12 — Engineering Streamline (final phase) — Archived
• PS2 — Payments & Settlement Integrity — Archived
• PS3 — Session & RSVP Lifecycle — Archived
• PS4 — Match & Rating Integrity — Archived
• PS5 — Dues & Attendance — Archived
• PS6 — Clubs & Membership Lifecycle — Archived
• PS7 — Identity, Account & Consent — Archived
• PS8 — Notification & Signal Surfacing — Archived
• PS9 — Venues & Discovery — Archived
• Rebuild Log — Archived
• Screen Blueprint — archive of the pre-2026-09-11 single-file document — Archived
• Stack Decisions — 2026-04-17 — Archived
• Tamagui Patterns — TwoMore v2 — Superseded
• TwoMore Rating System — Complete Summary — Superseded
• U1 — Home + Notification Center — Adversarial Audit — Archived
• U2 — Clubs: Adversarial UI/UX Audit — Archived
• U3 — Sessions: Adversarial UI/UX Audit — Archived
• U4 — Matches (경기): Adversarial UI/UX Audit — Archived
• U5 — 기록/Records: Adversarial UI/UX Audit — Archived
• U6 — Discovery: Adversarial UI/UX Audit — Archived
• U7 — Auth/Profile/Settings + DM: Adversarial UI/UX Audit — Archived
• U8 — Dues (회비): Adversarial UI/UX Audit — Archived
• UI Primitive Drift Audit — 2026-07-19 — Archived
• UI/UX Design Specs — 2026-07 Adversarial Audit Synthesis — Archived
• v1 Learnings — Archived
• Venue audit 2026-09-03 — owner review list — Open · review candidates from the blind stratified audit (see rebuild-log, 2026-09-03 audit entry).
• Venue evidence and owner certification — 2026-09-06 — Active
• Venue identity review — repeated names and nearby pins — Fresh shared-Naver review and bounded repairs prepared; production unchanged and unresolved candidates remain open
• Venue metadata and remaining identity closeout — September 5, 2026 — Review
• Venue validity review — Naver-priority closeout — Source prepared; later identity review narrows merges and extends repairs through 00598; hosted changes undeployed
• Whole-App Semantic-Block Adversarial Audit — Orchestration Plan (2026-07-11) — Archived