# AI Context Index

This folder makes the onboarding kit readable to Codex and other AI agents through the six-layer vertical context model.

中文术语：六层纵深上下文、纵深上下文、渐进式披露、查询范围、读什么范围、读什么文档。

## Reading Order

Read only what the task needs:

1. `01-intent.md`: true goal, target users, success signals, non-goals.
2. `02-rules.md`: stable rules and progressive disclosure standards.
3. `03-workspace-map.md`: files, folders, commands, data sources, external systems.
4. `04-state-ledger.md`: current progress, decisions, blockers, verification, next actions.
5. `05-eval-checklists.md`: Definition of Done and acceptance checks.
6. `06-systemization.md`: reusable assets and future systemization backlog.

## Six-Layer Mapping

- Surface / 表层：current user request plus `.ai/context/snapshots/` for meaningful tasks.
- Context / 稳定上下文：`AGENTS.md`, `MAINTAINERS.md`, `skills/onboarding-buddy/SKILL.md`, `02-rules.md`.
- Workspace / 工作区材料：`kit.yaml`, `modules/`, `sources/`, `assets/`, `scripts/`, `03-workspace-map.md`.
- State / 当前状态：learner state files plus `.ai/context/04-state-ledger.md`.
- Intent / 真实意图：`01-intent.md`.
- System / 可复用系统：scripts, skill, checklists, templates/backlog in `06-systemization.md`.

## Maintenance Rule

- Before meaningful work, read the smallest relevant context layer.
- After meaningful work, update `04-state-ledger.md`.
- When a repeated pattern appears for the third time, update `06-systemization.md` or create a reusable asset.
- Keep `AGENTS.md` compact; put longer maps, decisions, lessons, and rubrics here.
