# Systemization Backlog

## Existing Reusable Assets

- `skills/onboarding-buddy/SKILL.md`: reusable skill entrypoint.
- `scripts/ingest_lark_sources.py`: repeatable source ingestion.
- `scripts/validate_kit.py`: structural and privacy validation.
- `scripts/index_knowledge.py`: full-text index rebuild.
- `scripts/search_knowledge.py`: local retrieval.
- `scripts/module_crud.py`: module create/list/show/disable.
- `scripts/install_skill.py`: local skill installation.
- `scripts/bootstrap_session.py`: first-run package bootstrap and session map generation.
- `bootstrap.ps1` and `bootstrap.sh`: optional cross-platform uv bootstrap wrappers for machines without Python 3.10+.
- `.python-version`: pins the uv-managed Python target for this kit.
- `MAINTAINERS.md`: maintainer CRUD and read-scope protocol.
- `BOOTSTRAP.md`: first-message prompt for a new agent session receiving the zip.
- `AGENT_COMPATIBILITY.md`: compatibility matrix and shared adapter policy.
- Thin adapter files: `CLAUDE.md`, `GEMINI.md`, `.github/copilot-instructions.md`, `.cursor/rules/onboarding-kit.mdc`, `.clinerules`.
- `sources/README.md`: source corpus protocol.
- `.ai/context/05-eval-checklists.md`: Definition of Done and task checklists.

## Templates To Add Later

- Module authoring template with examples for `module.yaml`, `steps.yaml`, `knowledge.md`, and `faq.yaml`.
- Source manifest item template for manual non-Lark sources.
- Learner state example JSON.
- Maintainer release note template.
- Handoff and first-run bootstrap template for future zip-based agent kits.
- Agent adapter template for adding future tools without duplicating business rules.
- Decision record template for changing architecture, privacy posture, or delivery surface.

## Workflows To Consider Productizing

- Source ingestion report that summarizes new/changed/failed assets after every run.
- Bitable/Base ingestion for `实习生PPL`.
- Sheet ingestion for `实习生清单`.
- Optional audio/video transcription pipeline for downloaded videos.
- Stronger semantic search or embedding layer if keyword search becomes insufficient.
- Packaging script that validates, indexes, cleans caches, zips, and tests the zip in one command.
- Optional bootstrap quality check that confirms `.ai/context/session-bootstrap.md` is current after packaging.

## Evals To Add Later

- Query-answer regression set for Day 1, channel registration, PPL, offer/onboarding, and offboarding questions.
- Source citation evaluator: every source-backed answer must cite a manifest-backed text file.
- Privacy evaluator: no raw signed Feishu URLs, phone numbers, IDs, card numbers, or credential assignments.
- Progressive disclosure evaluator: learner step replies must not dump unrelated modules.

## Rule Of Three

The third time a maintainer repeats a manual action, turn it into one of:

- stable rule in `AGENTS.md` or `MAINTAINERS.md`;
- deeper context in `.ai/context/`;
- source or module template;
- deterministic script;
- skill workflow;
- eval/checklist.
