# Claude Code Instructions

This repository is an Onboarding Agent Kit. Claude Code should treat `AGENTS.md` as the primary operating contract and use this file only as a thin adapter.

## Required Startup

For a new Claude Code conversation:

1. Read `AGENTS.md`.
2. Read `HANDOFF.md`.
3. Read `MAINTAINERS.md`.
4. If the user asks for first-run package warmup, read `BOOTSTRAP.md` and follow it.
5. Read `kit.yaml` to understand journeys, module order, owners, and search configuration.
6. For learner guidance, read only the current module's `module.yaml` and `steps.yaml`.
7. For questions, detect Python first. If Python 3.10+ is available, run `python3 scripts/search_knowledge.py "<question>" --top-k 3`, then open only cited files. If Python is unavailable, ask before using `bootstrap.ps1` or `sh bootstrap.sh` to install uv; read `search/chunks.jsonl` and cited files manually only if the user declines installation or setup is blocked.

## Maintenance Rules

- Follow `MAINTAINERS.md` for all CRUD, source, state, index, and packaging work.
- Do not hand-edit `search/chunks.jsonl` or `search/index.json`.
- Do not store credentials, verification codes, tokens, identity numbers, bank cards, or raw signed Feishu asset URLs.
- After maintenance changes, run validation, indexing, bootstrap generation, and a representative search.
- If Python 3.10+ is unavailable, ask before using `bootstrap.ps1` or `sh bootstrap.sh` to install uv. Do not install uv silently.

## First Message Recommendation

```text
Please start this Onboarding Agent Kit in first-run package bootstrap mode by following BOOTSTRAP.md. After bootstrap, answer later questions in this same conversation by searching first and opening only cited files.
```
