# Evaluation Checklists

## Universal Definition Of Done

A task is done when:

- The deliverable matches the user's stated intent.
- The relevant authority files were respected.
- The smallest sufficient context was loaded.
- Validation and indexing were run when modules, sources, rules, or context changed.
- Search was verified with representative queries when answerability changed.
- Risks, partial sources, and open questions are recorded.
- `.ai/context/04-state-ledger.md` is updated after meaningful work.

## Learner Guidance Checklist

- Current journey and current module are known.
- Only one step is presented.
- Response includes module, step title, goal, actions, completion standard, and escalation path.
- No advancement happens without explicit completion or required evidence.
- State is updated before the next step is shown.
- Questions are answered without silently changing the current step.

## Question Answering Checklist

- Ran `python3 scripts/search_knowledge.py "<question>"` with `--module` when a current module exists.
- Opened only necessary cited files.
- Checked `sources/source-manifest.yaml` for source-backed answers.
- Cited module/source path and heading.
- Marked unsupported answers as unresolved and routed to owner.
- Did not use memory when local indexed content could answer.

## Module Maintenance Checklist

- Read `MAINTAINERS.md`.
- Used `scripts/module_crud.py` for create/list/show/disable when possible.
- Updated only the affected module files.
- Bumped `version` and `last_reviewed` for substantive changes.
- Ran `python3 scripts/validate_kit.py`.
- Ran `python3 scripts/index_knowledge.py`.
- Verified with a representative search query.

## Source Maintenance Checklist

- Read `sources/README.md`.
- Added originals under `assets/` when applicable.
- Added searchable text under `sources/`.
- Updated or regenerated `sources/source-manifest.yaml`.
- Redacted credentials, tokens, identity numbers, bank cards, and raw signed Feishu URLs.
- Ran ingestion for primary Feishu changes.
- Ran validation, indexing, and search verification.

## Packaging Checklist

- No `__pycache__` directories.
- `python3 scripts/validate_kit.py` passes.
- `python3 scripts/index_knowledge.py` completes.
- Representative search queries work.
- Zip contains `AGENTS.md`, `MAINTAINERS.md`, `.ai/context/`, `kit.yaml`, skill, scripts, source manifest, and search index.
- `zip -T onboarding-kit-v0.1.0.zip` passes.

## Depth Context Checklist

- Surface: current task or snapshot exists for meaningful work.
- Context: stable rules are in `AGENTS.md`, `MAINTAINERS.md`, and `.ai/context/02-rules.md`.
- Workspace: file map and commands are in `.ai/context/03-workspace-map.md`.
- State: current status, blockers, decisions, and next action are in `.ai/context/04-state-ledger.md`.
- Intent: project purpose and success signals are in `.ai/context/01-intent.md`.
- System: reusable scripts, skill, checklists, and backlog are represented in `.ai/context/06-systemization.md`.
