docs/README.md

# CarePath Documentation

Start every task with `AGENTS.md`. This index directs agents to the smallest
relevant context rather than every document in the repository.

## Current Product and Work

- `product/` — accepted contracts for CarePath, Ghi chép bệnh án AI, and Phiên
  dịch khám bệnh trực tiếp.
- `ux-redesign-carepath.md` — current Vietnamese-first UX implementation
  backlog; required before UX or product-flow implementation.
- `onboarding-ux-fix-tasks.md` — current visual onboarding execution backlog.
- `../UI-FIX-PLAN.md` — current public-site issue plan.
- `deploy.md` — Hugging Face Space deployment instructions.

## Harness: Read for Daily Work

- `HARNESS.md` — source hierarchy, task loop, and done definition.
- `FEATURE_INTAKE.md` — lane selection and CarePath hard gates.
- `ARCHITECTURE.md` — module and delivery boundaries.
- `CONTEXT_RULES.md` — minimum context by lane.
- `TEST_MATRIX.md` — behavior-to-proof baseline.
- `TRACE_SPEC.md` — durable completion evidence.
- `stories/`, `decisions/`, and `templates/` — selected work, settled
  tradeoffs, and new-work starters.

## Harness: Read Only When Triggered

- `TOOL_REGISTRY.md` — registering or using optional external tools.
- `HARNESS_AUDIT.md`, `HARNESS_COMPONENTS.md`, and `HARNESS_MATURITY.md` —
  audit, observability, maturity, or benchmark work.
- `HARNESS_BACKLOG.md` and `IMPROVEMENT_PROTOCOL.md` — repeated Harness
  friction or process improvements.
- `GLOSSARY.md` — extending shared Harness terminology.

## Evidence and History

- `qa-evidence/` — versioned visual QA proof and its retention index.
- `history/` — preserved MVP, demo-site, unification, and review documents.
  These are context only; do not reopen completed tickets as current work.