# Cline Rules

This workspace is an Onboarding Agent Kit. Use this file as a thin adapter and follow the shared contracts.

## Required Context

- `AGENTS.md`: primary operating contract.
- `HANDOFF.md`: architecture, current state, known gaps, and handoff notes.
- `MAINTAINERS.md`: CRUD, source, state, index, and packaging rules.
- `BOOTSTRAP.md`: first-run package warmup for a new agent session.
- `kit.yaml`: journeys, module order, owners, and search configuration.

## Workflow

- First-run warmup: follow `BOOTSTRAP.md`.
- Learner guidance: show one step at a time; do not dump the full journey by default.
- 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: follow `MAINTAINERS.md` and run required verification commands after changes.
- If Python 3.10+ is unavailable, ask before using `bootstrap.ps1` or `sh bootstrap.sh` to install uv. Do not install uv silently.

## Guardrails

- Do not hand-edit generated search files.
- Do not delete modules by default; disable them.
- Do not store credentials, tokens, identity numbers, bank cards, or raw signed Feishu asset URLs.
