원칙 3 · Machine-Readable

Agent-Specific Logging — JSON line

인간 가독 텍스트가 아니라, agent가 파싱할 수 있는 구조화 로그 — Pillar II × Pillar IV synergy
"Implementing machine-readable logs specifically designed for agent consumption and self-correction."
agent 소비와 자기 수정을 위해 특별히 설계된 — 기계 판독 가능 로그.
사람 중심
텍스트 로그
인간이 한 줄씩 눈으로 읽기 좋은 형식 — agent가 파싱하기는 어렵다.
// ❌ 인간용 텍스트 로그
console.log(
  "Payment processed: "
  + userId
  + " amount "
  + amount
);
  • 정규식·문자열 파싱 필요
  • 필드 추가 시 포맷 깨짐
  • LogQL 같은 쿼리 어려움
Agent 최적화
JSON line 구조화 로그
필드가 명시적 — agent가 parsing → query → self-correction까지 한 줄로 이어진다.
logger.payment({
  ts: Date.now(),
  event: "payment_processed",
  user_id: userId,
  amount_minor: amount,
  currency: currency,
  status: "success"
});
  • LogQL/jq로 즉시 쿼리 가능
  • 필드 추가가 비파괴적
  • Pillar II 검증과 직결
JSON line 로그가 있어야 — agent가 LogQL로 쿼리해서 자기 작업 결과를 검증할 수 있다