docs: add AI-friendly repository navigation

This commit is contained in:
Xin Wang
2026-08-30 19:43:54 +08:00
parent b74e905870
commit e22b960b6c
7 changed files with 435 additions and 2 deletions
+19
View File
@@ -13,6 +13,25 @@ correct person-aligned vision should reduce false wearer entries while two
other people are conversing, without reducing responses addressed to the
wearer or degrading wearer yield decisions.
## Repository navigation
Start with [`PROJECT_CONTEXT.md`](PROJECT_CONTEXT.md) for the concise code map,
data contracts, current blocker and canonical pipelines. This README is the
long operational guide and experiment history.
| Location | Contents |
|---|---|
| [`AGENTS.md`](AGENTS.md) | Research and code constraints for AI collaborators |
| [`docs/`](docs/README.md) | Current paper plan, novelty audit and dataset runbooks |
| [`results/`](results/README.md) | Immutable measured-result records and interpretation rules |
| [`literature_notes/`](literature_notes/README.md) | Paper index and persistent summaries |
| [`reports/`](reports/README.md) | Generated dataset audits; not model results |
Root Python and shell files remain intentionally stable because remote L20
commands invoke them directly. They are categorized in `PROJECT_CONTEXT.md`;
moving them into `src/`, `scripts/` or `tests/` requires compatibility wrappers
and regression testing.
## Current paper question and experiment plan (2026-08-30)
The full staged plan is in