AGENTS.md 구조, 서브에이전트 생성, 지속적 메모리는 어떻게 관리하시나요? (OpenCode 입문)
How are you actually structuring AGENTS.md + subagent spawning + persistent memory? (new to OpenCode)
핵심 요약
OpenCode 사용자들이 AGENTS.md 설정, 메모리 관리, 워크플로우 최적화 노하우를 공유합니다.
- 워크플로우 가이드 — Harness Engineering Guide나 Matt Pocock의 레포를 참고하여 체계적인 작업 환경 구축함
- AGENTS.md 활용 — 코드베이스 규칙을 정의하고, 필요에 따라 todo.md를 생성하여 작업 흐름을 관리함
- 메모리 시스템 — 단순 파일 방식에서 벗어나 Letta나 커스텀 메모리 시스템을 도입하여 성능을 개선함
- 에이전트 최적화 — gem-team 같은 전문 도구를 사용하거나 기본 프롬프트를 수정하여 성능을 극대화함
OpenCode로 전환한 지 얼마 안 됐고(모델은 DeepSeek 사용 중), 그냥 대충 하는 대신 제대로 설정해 보려고 합니다. 문서는 읽어봤지만 실제로 다들 어떻게 하고 있는지 궁금하네요. 몇 가지 막히는 부분이 있습니다:
AGENTS.md
기본적인 빌드/테스트/린트 명령어 외에 실제로 무엇을 넣으시나요? 예상보다 훨씬 유용했던 섹션이 있나요?
패키지/폴더별로 AGENTS.md를 나누고 계신가요, 아니면 루트 파일 하나로 충분한가요?
서브에이전트 생성 / Task 도구
누군가 Build에게 순차적으로 처리하는 대신 독립적인 작업(여러 파일 검토, 여러 모듈 확인 등)을 위해 병렬 서브에이전트를 생성하라고 명시적으로 지시하는 걸 봤습니다. AGENTS.md에 이런 지침을 직접 작성하시나요, 아니면 모델이 대부분 알아서 처리하나요?
병렬 서브에이전트가 서로 방해하거나 같은 파일을 수정해서 생긴 끔찍한 경험담이 있나요?
지속적 메모리
지금은 그냥 .opencode/memory/ 폴더에 마크다운 파일 몇 개(decisions.md, active-context.md)를 두고, 에이전트에게 그걸 읽고 업데이트하라고 AGENTS.md에 지시하고 있습니다. 다들 이렇게 하시나요, 아니면 지금은 다들 플러그인/MCP 메모리 설정(Letta 스타일 메모리 블록, agentmemory, Engram 등)을 쓰시나요?
어느 시점에서 일반 파일 설정이 "충분하지 않다"고 느끼셨나요?
Build vs Plan
Build 전에 매번 Plan 모드를 사용하시나요, 아니면 큰 변경 사항이 있을 때만 하시나요? 다들 일상적으로 얼마나 규율을 지키는지, 아니면 그냥 Build로 바로 YOLO 하시는지 궁금합니다.
반쯤은 이미 다들 탄탄한 패턴을 가지고 있을 텐데, 괜히 엉뚱하게 다시 만들고 싶지 않아서 그렇습니다. 공유해 주실 만한 실제 설정, AGENTS.md 스니펫, 주의사항이 있다면 감사하겠습니다.
