docs: import qa workflow knowledge from grilling session

README.md

@@ -1,2 +1,25 @@
 # qa_improve
 
+QA workflow improvement project for the Yara724 insurance claim management platform.
+
+## Knowledge Documents
+
+- [Domain Glossary](docs/glossary.md) — Case, Blame, Claim, Policy, roles
+- [State Machines](docs/state-machines.md) — Case, Blame, and Claim status lifecycle
+- [Workflow Steps](docs/workflow-steps.md) — Sequential Blame and Claim steps
+- [QA Profile](docs/qa-profile.md) — Engineer background, role, responsibilities
+- [Current Workflows](docs/current-workflows.md) — Daily workflow, Jira creation, bug investigation
+- [Pain Points](docs/pain-points.md) — Bottlenecks, time breakdown, challenges
+- [Improvement Goals](docs/improvement-goals.md) — Priorities, opportunities, open questions
+
+## Source Files
+
+- `raw/001-raw.txt` — Original working document
+- `raw/002-session-with-gpt.txt` — GPT session assessment
+- `CONTEXT.md` — Polished context from grilling session
+
+## Repos (reference)
+
+- `repos/api/` — Backend API
+- `repos/ui-user/` — User Frontend
+- `repos/ui-expert/` — Expert Frontend