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.