yaml-config-patch-{{AGENT_NAME_LOWER}}

YAML Config Patch — {{AGENT_NAME}} Dual-Config Pattern

{{AGENT_NAME}}는 config.yaml을 두 곳에 중복으로 유지한다. compression이나 auxiliary 같은 task-specific routing 변경 시 두 파일 모두 손대야 하고, 각 파일 내에서도 nested section 구조를 정확히 이해하고 patch해야 한다.

이 skill은 2026-06-03 cost optimization (H3 — M3 → M2.5 routing) 작업 중 두 차례 patch 실수로 얻은 운영 노하우를 정리한다.

---

1. Dual-Config Pattern (CRITICAL)

{{AGENT_NAME}}는 두 개의 config.yaml을 운영한다:

File	Used by	What it has
~/.{{AGENT_NAME_LOWER}}/config.yaml	gateway, CLI, cron scheduler, run_kanban_worker	auxiliary.compression (provider/model) 만
~/.{{AGENT_NAME_LOWER}}/P5-ego/config/config.yaml	P5-ego layer (identity snapshot)	compression: (summary_*) + auxiliary.compression: (provider/model) 둘 다

P5-ego 파일의 compression 섹션이 두 군데:

• root-level compression: (line 43-50 근처) — summary_provider, summary_model, summary_base_url
• auxiliary.compression: (line 72-77 근처) — provider, model, base_url, api_key, timeout

이 둘은 다른 dict. P5-ego의 의도는 P5 layer가 자기 config를 가진 것. path-integrity-report-2026-05-17에서는 "do not auto-fix yet" 결정.

변경 시 두 파일 + P5-ego는 두 section 모두 손봐야 할 수 있다. auxiliary.compression만 보면 P5-ego의 root-level compression이 stale로 남는다.

---

2. mcp_patch YAML Gotcha

mcp_patch로 YAML을 patch할 때 partial old_string이 sibling section을 복제하는 사고를 내기 쉽다.

발생 패턴 (실제 사고 사례, 2026-06-03)

원본:

compression:        ← root-level
  enabled: true
  threshold: 0.9
  summary_model: ''
  summary_provider: minimax

잘못된 patch — old_string이 summary_model: '' 부분만 잡고 new_string이 compression:으로 다시 시작:

compression:        ← root-level (line 43)
  enabled: true
compression:        ← DUPLICATE (line 45) — 잘못된 새 키
  enabled: true     ← DUPLICATE (line 46)
  threshold: 0.9
  ...

YAML이 broken. 두 개의 compression:이 같은 level에 있어서 parser가 후자만 인식하거나 error.

Prevention Rule

1. Always read the file first — 정확한 indentation, sibling section 위치, 부모 key까지 확인 후 patch
2. Match enough context — old_string에 부모 key + 첫 child 12줄 + target key 12줄 포함. target만 매치하면 부모가 ambiguous
3. Verify after every patch — 즉시 python3 -c "import yaml; yaml.safe_load(open(p))"
   • 출력으로 scope 확인
4. If duplication appears, read file → 정확한 라인 파악 → 다시 patch (이미 있는 compression: 줄을 기준으로 작업)