workspace-indexlisted
Install: claude install-skill YevheniiaQA/qa-agent-toolkit
# Workspace Index
Artefacts nobody can find are artefacts that do not exist. This skill makes the
workspace self-explanatory to someone opening it for the first time, and keeps it
that way.
The layout itself is defined in `docs/LAYOUT.md` in the skills repository. This
skill enforces and explains it; it does not invent its own.
## The root README
The first thing anyone sees. It answers three questions in order: what is this,
where does everything live, and where do I start.
```markdown
# Platform — QA workspace
Testing for the Platform product: requirements analysis, manual and automated
tests, results and reports. Generated and maintained by the QA agent pipeline.
## Where things live
| Folder | What is in it |
|---|---|
| [`01-docs/`](01-docs/) | **Everything about the product and the process.** How the system works, the test plan, environments and accounts, the working agreement |
| [`02-analysis/`](02-analysis/) | **Per ticket — understanding before testing.** Requirements, scenarios, open questions for the analyst |
| [`03-tests/`](03-tests/) | **Everything executable, organised by feature.** Manual cases, API and UI automation, contract, performance and security tests |
| [`04-results/`](04-results/) | **Per ticket — what happened.** Execution packs, results, defects, evidence, reports |
| [`05-metrics/`](05-metrics/) | **Trends across releases.** `events.jsonl`, append-only, written by `qa-event`; read with `qa-metrics` |
Folders are numbered in the order work