# Context snapshot: depth-context-audit

Created: 20260701T093807Z

## Activation prompt

Audit onboarding kit against six-layer depth context and progressive disclosure standards

## Desired outcome

Check whether the onboarding kit follows the six-layer vertical context model and progressive disclosure standard, then repair durable context gaps without bloating `AGENTS.md`.

## Known facts and evidence

- User explicitly invoked `depth-context-architect`.
- Existing kit already had `AGENTS.md`, `MAINTAINERS.md`, `kit.yaml`, `skills/onboarding-buddy/SKILL.md`, modules, sources, scripts, and search index.
- Initial `audit_depth_context.py` score was 1.5/10 because `.ai/context/` artifacts were missing.
- Added `.ai/context/README.md` plus `01-intent.md` through `06-systemization.md`.
- Added this snapshot to preserve the Surface layer.
- Updated `AGENTS.md`, `MAINTAINERS.md`, `scripts/index_knowledge.py`, and `scripts/validate_kit.py` so `.ai/context/` participates in rules, validation, and search.
- Rebuilt index to 302 chunks after indexing context files.

## Constraints and non-goals

- Do not overwrite existing operational rules.
- Keep `AGENTS.md` compact; deeper context belongs in `.ai/context/`.
- Do not store secrets, raw signed Feishu asset URLs, credentials, identity numbers, or bank card data.
- Do not turn this into a web/chrome/desktop product in this task.

## Unknowns and open questions

- Whether future maintainers want Base/Sheet-specific ingestion for `实习生PPL` and `实习生清单`.
- Whether video transcription should be added for the downloaded onboarding video.
- Whether keyword search is sufficient or an embedding index should be added later.

## Likely workspace touchpoints

- `AGENTS.md`
- `MAINTAINERS.md`
- `.ai/context/*`
- `scripts/index_knowledge.py`
- `scripts/validate_kit.py`
- `search/chunks.jsonl`
- `search/index.json`

## Initial Definition of Done

- Deliverable matches the activation prompt.
- Relevant context files were read or intentionally skipped with reason.
- Risks and next smallest action are reported.
- State ledger is updated if work becomes meaningful.
- `audit_depth_context.py` score improves from the initial baseline.
- `validate_kit.py` passes.
- `index_knowledge.py` completes.
- Search can find depth-context/progressive-disclosure rules.

## Handoff notes

- This snapshot is the Surface artifact for the depth-context audit. For current state and decisions, read `.ai/context/04-state-ledger.md`.
