거버넌스 — MD 운영 체계¶

2026-05-17 v1 박제. ADCARRY 4-Agent OpenClaw 운영 표준.

한눈에 보기¶

ADCARRY는 OpenClaw 위에서 4개 AI 에이전트(부서)를 운영합니다. 각 에이전트는 독립된 워크스페이스를 가지며, 매 세션마다 AGENTS.md라는 운영 룰 파일을 자동으로 로드합니다.

이 페이지는 AGENTS.md를 어떻게 작성·관리하는지 정리합니다.

1. 4-Agent 구조¶

agentId	부서	담당
`main`	HQ 본부	헌법 거버넌스, 부서 조율, 장캐리 DM, 메타 작업
`content-marketing`	콘텐츠마케팅	플레이스 유입·월보장·배포·견적
`global-selling`	글로벌셀링	아마존·인플루언서·해외리뷰·인증
`finance-ops`	재무정산	정산·세금계산서·외주입금·쿠팡리워드

각 에이전트는:

독립 워크스페이스: ~/.openclaw/workspace[-<부서>]/
독립 세션 스토어 + 인증
독립 페르소나(SOUL.md는 공유, IDENTITY.md·USER.md·MEMORY.md는 부서별)

2. 5-Partial + Local 구조¶

AGENTS.md는 자동 생성 산출물입니다. 직접 편집 금지. 편집은 공통 partial 5개 또는 부서별 local에서.

~/.openclaw/shared/                          ← 공통 정본 (장캐리 승인 필요)
├── AGENTS.partial.header.md       (자동 치환 변수)
├── AGENTS.partial.principles.md   (한국어, 추론·도가·비판·시크릿)
├── AGENTS.partial.workflow.md     (영문, 절차·분기표·재시도 — LLM 안정성)
├── AGENTS.partial.routing.md      (한국어, 에이전트·통신·권한)
└── AGENTS.partial.safety.md       (한국어, 불변 룰, Don't+Do 쌍)

~/.openclaw/workspace[-<부서>]/
├── AGENTS.local.md                 ← 부서 자율 편집
└── AGENTS.md                       ← 자동 생성 (편집 ❌)

빌드 흐름¶

partial 5개 + local 1개
        ↓ ~/.openclaw/scripts/build-agents-md.sh
workspace*/AGENTS.md (덮어씀)

3. 언어 정책 (A2 하이브리드)¶

파일	언어	근거
`workflow.md`	영문	LLM 명령 준수 안정성, 토큰 효율
`principles.md` / `routing.md` / `safety.md` / `header.md`	한국어	chars 효율, 사람 가독성
`AGENTS.local.md` (4개)	한국어	회사 맥락 중심
고유명사 (장캐리·세금계산서·팝빌·옵타텀)	한국어	의미 보존
이 사이트 (`adcarry-docs/`)	한국어	사람용 시각화 산출물

왜 이렇게?¶

chars 한도: OpenClaw bootstrapMaxChars 12,000자 hard limit
영문은 chars +60~90% (한국어가 chars 단위로 효율적)
그러나 토큰 효율·LLM 안정성은 영문 우위 (Anthropic 이슈 #26401)
타협: 가장 중요한 룰 엔진(workflow.md)만 영문, 나머지는 한국어

4. 권한 레이어¶

레이어	위치	권한
L1: Shared 정본	`shared/AGENTS.partial.*.md`, `shared/SOUL.md`	main만 수정 가능. 장캐리 승인 필수.
L2: 부서 local	`workspace*/AGENTS.local.md`	부서 자율 (변경 시 `#하네스-설계` 자동 보고)
자동 생성	`workspace*/AGENTS.md`	직접 편집 ❌ (빌드 산출물)

헌법 변경 워크플로¶

변경 제안 발생
    ↓
#하네스-설계에서 장캐리 ↔ AI 캐리 논의
    ↓
합의 → partial 또는 standard 수정
    ↓
~/.openclaw/scripts/build-agents-md.sh 실행
    ↓
4개 워크스페이스 AGENTS.md 자동 갱신
    ↓
다음 세션부터 자동 적용

5. 분기 룰 (정보를 어디에 둘 것인가)¶

정보	위치
매 세션 자동 로드 필요한 운영 룰	`AGENTS.md` (partial + local 빌드)
장기 전략·인사·원칙 (DM 자동 로드)	`MEMORY.md` (≤ 2KB)
정규화된 지식 (회사·고객·개념·합성)	`wiki/` (`wiki_search` 도구)
일자 작업 로그	`memory/logs/YYYY-MM.md`
채널별 SOP·맥락	`memory/channels/<id>.md`
프로젝트 진행 중	`memory/projects/<name>.md`
시크릿·API 키	`~/.openclaw/credentials/` (워크스페이스 밖)

6. 크기 예산¶

Partial	권장 chars	현재 (2026-05-17)
header	500~700	442
principles	1,200~1,600	1,391
workflow	2,000~2,500 (영문)	4,927
routing	900~1,200	923
safety	1,000~1,300	1,112
Partial 합	—	8,795
빌드 후 AGENTS.md	≤ 9,000 (DIET 경고) / < 12,000 (한도)	10,141~10,643 (85~89%)

⚠️ DIET 경고 영역 (>75%). 운영 사례 기반으로 다이어트 룰 적용 예정.

다이어트 룰¶

새 룰 추가 시 → 기존 룰 삭제·축약·reference 이동 중 하나 강제
1회성 문제는 memory/logs/에 기록. AGENTS 승격 금지.
신규 룰 승격은 반복성 + 안정성 + 공통성 3조건 충족 시에만.

7. 악마의 대변인 (아첨·확증편향 차단)¶

큰 결정 시 답변 포맷을 강제합니다:

동의 의견 + 근거
반대·리스크 의견 (의무)
최종 추천 + 이유

큰 결정 트리거 (셋 중 하나만 걸려도)¶

영향 축: 비가역, 6+개월 영향, 회사 자산·정책 변경, 돈·신뢰·법·평판
사람 축: 다수가 같은 방향, 자신감 있는 동의 요청, 권위·직급 결정
이상 신호: "그냥 감", 근거보다 결론 크기, 공론을 대체하는 단어

부서별 구체 사례는 각 AGENTS.local.md 참조.

8. 1년 운영 위험 & 점검¶

가장 큰 위험: 룰 부패 + 예외 누적¶

6개월 후 AGENTS.md가 "실행 커널"이 아닌 "읽히지 않는 규정집"으로 변할 위험.

월간 점검 지표¶

AGENTS.md / MEMORY.md 크기 추이
라우팅 실패 횟수
승인 누락
finance escalate 누락
장캐리 정정 횟수 (가장 중요)

분기 점검¶

stale rule 제거
local 채널 매핑 최신화
신규 부서 온보딩 리허설

9. 관련 문서¶

표준 v1: memory/governance/agents-md-standard-v1.md
재정비 계획: memory/governance/md-renovation-plan.md
인벤토리: memory/governance/s1-inventory-2026-05-17.md
빌드 스킬: workspace/skills/agents-md-build/SKILL.md
빌드 스크립트: ~/.openclaw/scripts/build-agents-md.sh

10. 변경 이력¶

날짜	변경
2026-05-17	v1 박제. 5-partial + local 2-layer 확정. A2 하이브리드 언어 정책.
2026-05-17	S2-4 첫 빌드 완료. 4개 AGENTS.md 자동 생성.
2026-05-17	S2-5 TEAM.md → archive. 깨진 symlink 정리.
2026-05-17	S2-6 사람용 docs 시각화 (이 페이지).