같은 도구를 깔아도 결과가 갈린다 — 조직 운영과 부서 자동화 18문답
AI를 조직에 들일 때 반복되는 열여덟 문항에 결론부터 답한다. 무엇부터 바꾸고 생산성을 무엇으로 재는지, 강제와 채택 설계가 어떻게 갈리고 자동화를 어디서 멈추는지를 정리하고, 「도구를 깔면 생산성이 오른다」·「개인이 잘 쓰면 조직도 잘 쓴다」·「에이전트 개수가 규모를 말해 준다」는 세 직관을 교정한다.
태그
knowledge-management
18편
같은 이름이 편에 따라 다른 층위를 가리킨다 — 열 편 지도와 열네 주제 교차 참조
이 카테고리의 열 편을 세 번 갠다 — 목적별 읽는 순서 일곱 갈래, 다루는 범위로 다섯 묶음, 깊이 순서의 열네 주제로. 「하네스」·「오케스트레이터」·「사람 게이트」·「총계 30」처럼 편에 따라 가리키는 층위가 갈리는 이름 넷이 어디서 정의되는지 함께 놓고, 세 지도 어느 쪽에서도 빠지는 편이 없는지 자리를 세어 확인한다. 열네 주제 중 하나는 가장 깊은 자리가 비어 있고, 그 빈칸을 채우지 않고 그대로 둔다.
레포에 커밋할 수 없는 것만 남는다 — 하네스·위키·게이트 세 레이어와 Skill 카탈로그 열하나
단계마다 SaaS를 하나씩 사는 대신 하네스 한 벌로 흡수하는 레퍼런스 아키텍처를 옮긴다. 팀 절차를 Skill로 외부화하는 Layer 1, 비-프로덕션 지식을 레포 마크다운 위키에 두는 Layer 2, 사람 승인과 감사추적이 필요한 state만 남기는 Layer 3으로 나뉜다. Skill 카탈로그 열하나, 위키의 폴더 구조·뼈대 파일 넷, ingest·query·lint 세 연산, 그리고 어느 규모까지 위키이고 어디부터 RAG인가의 임계값까지 실물로 싣는다.
AI 전환 조직수정 2026-08-17
병목은 모델이 아니라 조직 컨텍스트다 — 팀 공유 인프라 넷과 성숙도 0 → 1 → N
에이전트가 프로덕션에서 실패하는 이유를 모델 품질이 아니라 조직 컨텍스트의 부재로 놓은 자료를 옮긴다. 팀이 함께 쓰는 인프라 넷(워크플로 자동화·회사 두뇌·팀 컨텍스트 공유 표준·프롬프트 라이브러리)을 하나씩 펼치고, 그것을 어떤 순서로 까는지를 ROI 우선순위 다섯과 기간별 네 단계 두 축으로 대 본다. 성숙도 0 → 1 → N의 졸업 조건, KPI 네 분류와 중단 기준, 미리 피할 실패요인 다섯까지 이어진다.
발행 순서와 읽는 순서는 다르다 — 30편 지도와 15주제 교차 참조
이 카테고리의 30편을 두 번 갠다 — 발행 구조 그대로인 8개 시리즈와 독립편 2로 한 번, 깊이 순서의 15개 주제로 다시 한 번. 목적별 읽는 순서 여덟 갈래를 함께 놓고, 두 지도 어느 쪽에서도 빠지는 편이 없는지 자리를 세어 확인한다.
7원칙의 자리는 그대로고 내용만 업종을 탄다 — CLAUDE.md 템플릿 3종 10축 비교
1인 SaaS·제조유통·서비스콘텐츠 세 업종의 조직 규칙 문서를 열 개 축으로 나란히 놓고, 업종이 바뀔 때 무엇이 바뀌고 무엇이 자리를 지키는지 센다. 원 자료가 같은 파일에 붙이는 200줄이 이 카테고리의 다른 글들이 쓰는 200줄과 같은 값을 다른 목적으로 재고 있다는 것도 짚는다. 뒤쪽은 프롬프트 쪽에서 아직 이 카테고리에 없던 것들 — 안티패턴 5가지와 Plan Mode를 강제 절차로 바꾸는 하드 게이트 한 줄이다.
차단만 하면 같은 시도가 반복된다 — Rules·Hooks·Skills 3계층과 차단 규칙 7종
에이전트를 통제하는 세 수단을 규범·강제·절차로 갈라 놓고, 비교표의 「강제력」 열이 셋 중 하나에서만 「있음」이 되는 구조를 본다. 훅 5종·차단 규칙 7종·운영 규약 6항목을 전부 펼치고, 훅 표가 요약한 사고 5가지를 차단 규칙 7종에 하나씩 배정해 어느 둘이 남는지 센다. 훅의 차단 사유가 어느 채널로 나가는지에 대해 원 자료의 표 안에서 두 행이 갈리고, 같은 카테고리의 다른 두 글도 서로 다르게 적어 두었다는 사실도 나란히 놓는다.
규칙 문서부터 쓰면 막힌다 — 합격선 5축과 60줄 원칙
에이전트를 만든 다음이 아니라 만들기 전에 정해야 하는 것 — 무엇을 자동화 대상으로 고를지 판단하는 두 도구와, 「끝났다」를 판정하는 5축 정량 루브릭, 그리고 조직 규칙 문서를 60줄로 유지하는 이유를 정리한다. 같은 문서의 분량을 이 카테고리의 다른 글이 200줄로 부른 것과의 관계도 함께 짚는다.
형식은 템플릿이 복제하지만 안전장치는 복제되지 않는다 — 정의서 스키마와 30종의 품질 편차
에이전트 정의서 한 개의 구조를 프론트매터 4필드와 본문 7섹션으로 분해하고, 같은 스키마로 쓰인 30종에서 관찰된 품질 편차를 대조표로 본다. 형식 항목은 30/30으로 균질한데 권한 축소·승인 게이트·면책은 5/30, 3/30, 1/30으로 떨어진다. 그리고 경계 섹션이 실재하지 않는 이름을 지목한 건수가 원 자료의 산문과 표에서 갈린다는 점도 짚는다.
200줄은 상한이 아니라 임계다 — CLAUDE.md의 4계층 Scope와 3덩어리 7단계
세션마다 자동으로 읽히는 규칙 파일을 Enterprise→Project→User→Local 4계층으로 쌓는 규칙과, 7단계를 3덩어리로 묶어 쓰는 작성 순서를 정리한다. 같은 200줄을 이 카테고리의 다른 글이 「상한」이라 부른 것과의 관계도 함께 짚는다.
지시는 문서가 하고 차단은 설정이 한다 — `.claude/` 여덟 구성물과 프롬프트 7패턴
규칙 파일 한 장 옆에 서는 여덟 개의 구성물을 역할·적용 범위·갱신 주기로 갈라 보고, 회사 단위로 확장하는 5단계 프레임워크와 지시 한 줄을 제대로 쓰는 프롬프트 7패턴까지 잇는다.
되돌릴 수 있어야 권한을 넓힌다 — CLAUDE.md 규약과 실패 모드 3분류
에이전트에게 줄 권한의 상한을 정하는 것은 신뢰가 아니라 복구 가능성이다. Git이 안전망이자 컨텍스트 공급원이 되는 구조, 검증 가능한 규약 파일이 갖춰야 할 다섯 요소, 그리고 환경 문제 20여 건이 수렴하는 세 가지 원인을 정리한다.
enforcement 없는 규칙은 위시리스트 — CLAUDE.md 3계층과 부서별 정책
규약 파일을 개인 메모에서 조직 헌법으로 올리는 3계층 구조를 배치 기준과 자동 머지 규칙까지 정리하고, 전사 정책의 실효성을 결정하는 단 하나의 키와 부서별로 정책이 갈리는 이유, 그리고 규칙 문서에서 반복되는 다섯 안티패턴을 짚는다.
에이전틱 코딩수정 2026-08-13
도입은 도구 선정에서 시작하지 않는다 — 순서·규약·계층 17문답
AI 에이전트를 팀에 들일 때 반복해서 돌아오는 질문 열일곱 개에 결론부터 답한다. 도입 순서와 첫 대상 선정, 규약 파일이 갖춰야 할 형태, 조직 규모별 계층, 그리고 규칙이 지켜지지 않을 때 무엇을 바꾸는가까지.
AI 에이전트수정 2026-08-08
하네스를 만드는 다섯 가지 — 메모리·스킬·에이전트·커맨드·훅
장기 실행을 관리하는 하네스가 실제로 어떤 부품으로 조립되는지 다섯 구성물로 나누고, 세션 시작 비용을 만드는 고정 지식 일곱 종과 컨텍스트 상한의 벤치마크 근거를 토큰 단위로 분해한다.
AI 에이전트수정 2026-08-08
Agent = Model + Harness — 모델이 좋아져도 제품이 안 좋아지는 이유
모델 상향 평준화와 제품 성능이 비례하지 않는 원인을 동작 방식의 고정성 네 가지로 진단하고, 오차 누적과 하네스 4계층, 실패를 규칙으로 승격시키는 복리 원리를 정리한다.
AI 에이전트수정 2026-08-08
Agent Harness — 컨텍스트를 파일로 밀어내고 비우는 구조
하네스가 Supervisor 패턴과 무엇이 다른지를 상태의 소재지로 가르고, 컨텍스트 38%가 0%로 떨어지는 실측과 그 구조가 RAG의 정의까지 바꾸는 과정을 정리한다.
RAG · 검색증강생성수정 2026-08-07
RAG 지식 지도 — 2년간 이 분야에서 무엇이 움직였나
RAG와 그 위에 얹힌 에이전트 기술을 네 개 층으로 나눠 지도를 그리고, 2024년 중반부터 2026년 중반까지 지배적 질문이 어떻게 옮겨 갔는지 정리한다.