blog 내용 점검 및 수정

날짜
영향도보통

Decisions

D1: Tier 분류 SSoT = agents/commands/*.md

  • Context: meet-the-agents.mdx와 orchestration-structure.mdx가 Palette의 Tier와 Tier 3 명칭("Support" vs "Enhancement")에서 불일치. 블로그 포스트 간 상충을 해소하기 위해 기준점이 필요했음.
  • Choice: agents/commands/{name}.md 첫 줄의 [Tier N — Label] 선언을 SSoT로 채택. 블로그·문서·기획 자료는 이 값을 따른다.
  • Alternatives: orchestration-structure.mdx를 정본으로 채택(블로그 위주) / MEMORY.md에 별도 선언(메모리는 스냅샷이라 부적합) — 모두 기각.
  • Code Paths: agents/commands/palette.md, agents/commands/*.md, blog/content/adr/meet-the-agents.mdx, blog/content/adr/orchestration-structure.mdx

D2: 블로그 시리즈 재편 — ADR 번호 기반 → 주제 기반 6편

  • Context: 기존 adr-001~005.mdx는 ADR 번호 나열형이라 독자 관점에서 서사 흐름이 약했음. Sprint 67에 이미 재편 중이었으나 상호 참조/Tier 정합성이 검증되지 않은 상태로 워킹트리에 방치.
  • Choice: 6편 주제 기반 시리즈로 확정하고 Sprint 68에서 정합성까지 마무리 후 커밋.
    1. agent-orchestration-solo-dev (intro)
    2. system-architecture-overview
    3. orchestration-structure
    4. cicd-ai-guardrails
    5. meet-the-agents
    6. sprint-journey (회고)
  • Alternatives: ADR 번호 체계 유지 — 독자 내비게이션 불편으로 기각.
  • Code Paths: blog/content/adr/*.mdx

Patterns

P1: 문서 Tier/명칭 일관성 검증은 agents/commands/ grep 기준

  • Where: agents/commands/*.md의 \[Tier \d 선언
  • When to Reuse: 블로그·README·ADR 등 에이전트 체계를 기술하는 문서를 작성/수정할 때는 먼저 agents/commands/*.md를 grep하여 SSoT를 확인하고, 문서 간 상충이 발생하면 SSoT를 기준으로 수정한다.

P2: 블로그 시리즈 링크 텍스트는 각 포스트 frontmatter title과 일치

  • Where: blog/content/adr/*.mdx의 "이전 글/다음 글" 링크
  • When to Reuse: 링크 텍스트가 실제 포스트 제목과 크게 다르면 독자가 다음 글 내용을 오해한다(예: system-architecture-overview.mdx가 "Saga Orchestrator 구조 설계"로 다음 글을 예고했으나 실제 다음 글은 에이전트 오케스트레이션). 시리즈 포스트를 추가/수정할 때마다 frontmatter title과 링크 텍스트 정합성을 grep으로 확인한다.

Metrics

  • Commits: 2건 (cb86dec, 37ccf38)
  • Files changed: 16개 (+2446/-571)
  • 블로그 포스트 재편: 5편 삭제 + 6편 신규 + 3편 내용 보정
  • Sprint ADR 아카이브 보강: Sprint 63~67