Briefing — 정리된 답변

Briefing은 질문 한 번에 관련된 모든 자료를 모아서 정리해드리는 답변입니다. 검색 결과 목록이 아닙니다. 회사가 그 주제에 대해 지금 어떻게 알고 있는지를 한 묶음으로 정리해드립니다.

어떻게 생긴 답인가요

예를 들어 "결제 시스템의 rate limit 정책 알려주세요"라고 물으면, briefing은 다음 항목을 모아서 답해드립니다.

현재 정책 — 회사가 지금 어떻게 운영하고 있는지
최근 변경 사항 — 지난 며칠/주간 동안 무엇이 바뀌었는지
충돌 — 같은 주제에 대해 다른 기록이 있는 경우 모두 표시
담당자 — 누가 이 영역을 관리하고 있는지
빈 곳 — 충분한 자료가 없어서 추가 확인이 필요한 부분

검색 결과로 문서 5개를 던져주는 게 아니라, 회사의 현재 입장을 한 페이지로 정리해드리는 답입니다.

누가 쓰나요

1. 사람 중요한 결정을 내리기 전에 "지금 우리가 어떻게 하고 있지?"를 빠르게 확인할 때 씁니다.

2. AI 에이전트 Claude나 Cursor 같은 AI 도구가 작업 전에 "이 회사는 이 주제에 대해 어떻게 알고 있나?"를 확인할 때 자동으로 호출합니다. AI가 회사 맥락을 모르고 일반적인 답을 하는 일을 막아줍니다.

두 가지 모드

상황에 맞게 두 가지 방식으로 답을 만들어드립니다.

모드	언제 쓰나요	속도 / 비용
Quick	일상적인 작업, 빠른 컨텍스트 확인	즉시, 무료
Deep	중요한 결정, 글쓰기, 대외 응답	1~2초, 약간의 비용

Deep 모드는 더 많은 자료를 살펴보고 관련된 다른 atom들과의 연결까지 확인합니다.

답변 형식

응답은 두 가지 형식 중 선택하실 수 있습니다.

구조화 — 항목별로 정리된 데이터. 자동화나 다른 도구와 연결할 때 좋습니다.
서술형 — 사람이 읽기 좋게 한 단락으로 정리된 글. AI 에이전트의 컨텍스트로 바로 쓰기 좋습니다.

사용 팁

구체적으로 물으시면 답이 정확해집니다.
- 덜 좋은 예: "auth"
- 좋은 예: "auth-service의 rate limit 정책"
중요한 작업 전에는 deep 모드를 쓰세요. 글 쓰기, 결정, 대외 응답처럼 정확성이 중요한 일에는 깊은 검색이 더 안전합니다.
충돌이 있으면 사람이 한 번 더 확인하세요. briefing이 충돌을 보여주지만, 어떤 게 맞는지 판단은 사람이 하시는 게 안전합니다.

개발자용 참고 (API)

briefing은 API 또는 MCP 도구로 호출하실 수 있습니다.

GET /api/memory/briefing?q=<topic>&depth=<quick|deep>&format=<structured|narrative>

또는 MCP로:

get_briefing { query, depth?, format? }

특정 sphere(팀/프로젝트 공간)로 범위를 좁히실 때:

GET /api/memory/briefing?q=sports%20warehouse%20bugs&depth=deep&sphere_slug=sports-warehouse

파라미터

q / query — 자연어 질문
depth — quick (기본, 즉시) 또는 deep (1~2초, 더 정확)
format — structured (기본, JSON) 또는 narrative (서술형 글)

구조화 응답 예시

{
  "topic": "rate limiting policy",
  "current_beliefs": [
    { "entity": "api-gateway", "relationship": "has_limit", "value": "100 req/s", "confidence": 0.91 }
  ],
  "recent_changes": [
    { "entity": "auth-service", "from": "50 req/s", "to": "200 req/s", "at": "2026-04-10T…" }
  ],
  "contradictions": [
    { "entity": "payments", "relationship": "has_limit", "values": ["20 req/s", "60 req/s"], "status": "open" }
  ],
  "authority": [
    { "person": "alice@…", "topics_owned": ["api-gateway"] }
  ],
  "gaps": [
    { "entity": "webhooks", "reason": "no atoms in last 90 days" }
  ]
}