---
description: Onboarding Agent Kit operating rules
alwaysApply: true
---

# Onboarding Agent Kit Rules

This workspace is a portable Onboarding Agent Kit. Cursor should use this rule as a thin adapter and defer to the shared kit contracts.

## Read Order

1. Read `AGENTS.md`.
2. Read `HANDOFF.md` for architecture and current state.
3. Read `MAINTAINERS.md` for maintenance rules.
4. For first-run package warmup, read and follow `BOOTSTRAP.md`.
5. Read `kit.yaml` for journeys, module order, owners, and search paths.

## Query Scope

- Do not read the whole corpus by default.
- For questions, detect Python first. If Python 3.10+ is available, run `python3 scripts/search_knowledge.py "<question>" --top-k 3`; if not, 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.
- Open only cited files needed to answer.
- Check `sources/source-manifest.yaml` before citing source corpus files.

## Maintenance

- Create modules with `python3 scripts/module_crud.py create`.
- Disable modules with `python3 scripts/module_crud.py disable`.
- Do not hand-edit `search/chunks.jsonl` or `search/index.json`.
- 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.

## Safety

Do not store passwords, verification codes, tokens, identity numbers, bank cards, raw signed Feishu asset URLs, or full credential documents.
