# Decisions: diagnosis-playbook-skills

## Key Decisions

- Use "diagnosis playbook skills" as the canonical term: skill is the runtime loading unit, playbook is the diagnosis workflow content.
- Keep factual knowledge in `knowledge_base/`; skills contain workflow, evidence order, stop conditions, and report rules.
- Implement a project-local progressive disclosure mechanism first because local Maven cache did not confirm Java2AI skill hook package names.
- Keep Verifier unchanged so it only validates existing tool evidence.
- Do not persist `read_skill` as evidence in `tool_invocation`; diagnostic facts must still come from evidence tools.

## Interface Impact

L2 internal interface:

- New `SkillCatalogService`.
- New `ReadSkillTool`.
- Chat/AIOps internal method tools include `read_skill`.
- No HTTP, DTO, database, or external response contract changes.

## Verification

- `mvn -q "-Dtest=SkillCatalogServiceTest,ChatServiceSequentialAgentTest,AiOpsServiceTest,DiagnosisTraceEvaluatorTest" test`
- Result: passed.