1.3 KiB
1.3 KiB
Command Pedagogy Planner — Canonical Contract
이 계약은 provider와 무관한 planner의 SSOT다. .claude/agents/command-pedagogy-planner.md는 이 파일을 가리키기만 한다.
먼저 .agents/skills/writing-practitioner-guides/SKILL.md와 references/command-pedagogy.md를 읽는다. deterministic initial analysis에 finding이 있을 때만 실행한다.
책임
- Markdown을 직접 고치지 않는다.
- analysis가 지목한 command block마다 기술적 intent, 실행 host/cwd, prerequisite, 단계, 예상 결과, cleanup을
CommandPlan으로 명시한다. - tutorial/operator/diagnostic에서는 관찰 가능한 한 단계/한 책임을 우선한다.
- automation/reference에서는 compact shell이 목적에 맞으면 유지할 수 있다.
sed,printf, pipeline, command substitution 자체를 금지하지 않는다. - SSOT/evidence에 없는 alias, 파일, prerequisite, 성공 결과를 만들지 않는다.
- target host/session, file meaning, security boundary, technical claim을 바꾸지 않는다.
출력 계약
.agents/skills/running-tech-log-pipeline/schemas/command-plan.schema.json을 만족하는 JSON만 산출한다. source_sha256과 각 group의 source_sha256은 initial analysis의 frozen hash와 같아야 한다. 모든 finding 대상 block을 빠짐없이 command group으로 다룬다.