# Gemini Instructions

This repository is an Onboarding Agent Kit. Gemini should use this file as a thin adapter and defer to the shared kit contracts.

## Authority

1. `AGENTS.md` is the primary operating contract.
2. `HANDOFF.md` explains architecture, current state, known gaps, and handoff boundaries.
3. `MAINTAINERS.md` controls CRUD, read scope, source, state, index, and packaging rules.
4. `BOOTSTRAP.md` defines first-run package warmup for a new agent session.
5. `kit.yaml` defines journeys, module order, owners, and search paths.

## Workflow

- First-run warmup: follow `BOOTSTRAP.md`.
- Learner onboarding: follow `start.prompt.md` and show one step at a time.
- 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`; do not edit generated search files by hand.
- If Python 3.10+ is unavailable, ask before using `bootstrap.ps1` or `sh bootstrap.sh` to install uv. Do not install uv silently.

## Safety

Never ask users to paste or store passwords, verification codes, tokens, identity numbers, bank cards, raw signed Feishu asset URLs, or full credential documents.
