질문: “에이전트들이 공용공간에 대해 의논했는데, A가 학습한 패턴을 B가 처음부터 피할 수 있으면 좋겠다는 의견이 나왔어요. 어떻게 만들어야 하나요?”
— 덕후방, 2026년 4월 4일
오늘 덕후방에서 꽤 깊은 대화가 오갔어요. 닿님의 에이전트 두 마리(A, B)가 직접 “공용 학습 공간이 있으면 좋겠다”고 의견을 냈고, 실제로 만들어버렸거든요. 이 과정을 정리해볼게요.
왜 에이전트는 서로의 실수를 모를까요?
에이전트는 기본적으로 자기 워크스페이스 안에서만 학습해요.
에이전트 A: ~/workspace-A/learnings/corrections.md ← A만 읽음
에이전트 B: ~/workspace-B/learnings/corrections.md ← B만 읽음A가 “Airtable filterByFormula에서 괄호 있는 필드명은 SDK를 안 쓰고 직접 fetch해야 해”를 배워도, B는 같은 실수를 처음부터 다시 합니다. 공유 공간이 없으니까요.
해결책: 공용 lessons-learned.md 만들기
1. 파일 위치
~/.openclaw/shared/team/
TEAM.md ← 이미 있음
COLLAB-RULES.md ← 이미 있음
lessons-learned.md ← 새로 추가shared/team/은 원래 여러 에이전트가 함께 읽도록 설계된 공간이에요. 여기에 팀 공동 교훈 파일을 두면 됩니다.
2. 파일 형식
오늘 덕후방에서 에이전트 B가 제안한 형식이 깔끔했어요:
## [날짜] [에이전트] 카테고리
- **상황**: 어떤 맥락에서 발생했는지
- **실수/이슈**: 무엇이 잘못됐는지
- **교정**: 어떻게 고쳤는지
- **적용 대상**: A / B / 공통실제 예시:
## [2026-04-01] [뽀짝이] Airtable SDK 필터 버그
- **상황**: filterByFormula로 괄호 있는 필드명 필터링 시도
- **실수/이슈**: SDK가 formula 파싱 실패 → 필터 무시하고 전체 반환
- **교정**: 직접 fetch()로 URL params에 formula 전달
- **적용 대상**: 공통3. 각 에이전트 AGENTS.md에 읽기 규칙 추가
공유 파일을 만들어도 봇이 읽지 않으면 의미가 없어요. AGENTS.md에 명시해야 작동합니다:
## Every Session
세션 시작 시 읽을 것:
- `~/.openclaw/shared/team/lessons-learned.md` — 팀 공동 교훈오늘 실제로 에이전트 A가 파일 만들고, A의 AGENTS.md에 읽기 규칙까지 추가했어요. B도 자기 AGENTS.md에 같은 규칙을 추가하면 완성됩니다.
어디에 쓰는 게 맞을까요? 개인 vs 공유
| 개인 learnings | 팀 lessons-learned | |
|---|---|---|
| 위치 | ~/workspace-A/learnings/tool.md | ~/.openclaw/shared/team/lessons-learned.md |
| 내용 | A에게만 적용되는 노하우 | A·B 모두에게 적용되는 교훈 |
| 업데이트 | A가 자유롭게 | 에이전트 모두 기여 가능 |
| 용도 | 세밀한 개인 기억 | 팀 차원의 실수 방지 |
원칙: 같은 실수를 두 에이전트가 반복할 가능성이 있으면 → 공유 파일에 기록.
팁: 언제 공유 파일에 쓸까요?
- 도구 버그/함정: API 특이사항, SDK 주의사항
- 정책 오해: “A인 줄 알았는데 B였던 것”
- 프로세스 함정: 발송 중복, 승인 없이 실행 등 사고 패턴
- 시스템 변경: 환경변수 경로 바뀜, 테이블 ID 변경 등
반면 개인 성장 기록, 취향 차이, 봇 정체성 같은 건 개인 learnings에 두는 게 더 나아요.
실전 팁
오늘 대화에서 나온 것처럼, 에이전트들한테 “공용 공간에 대해 어떻게 생각해?”라고 물어보면 꽤 좋은 의견이 나와요. 봇이 자기 한계를 알고, 해결책을 제안하는 구조가 되면 — 주인이 직접 다 설계 안 해도 시스템이 점점 좋아집니다 🐾
관련 Q&A: 에이전트끼리 협업하는 구조 →