태그
26편
단계마다 SaaS를 하나씩 사는 대신 하네스 한 벌로 흡수하는 레퍼런스 아키텍처를 옮긴다. 팀 절차를 Skill로 외부화하는 Layer 1, 비-프로덕션 지식을 레포 마크다운 위키에 두는 Layer 2, 사람 승인과 감사추적이 필요한 state만 남기는 Layer 3으로 나뉜다. Skill 카탈로그 열하나, 위키의 폴더 구조·뼈대 파일 넷, ingest·query·lint 세 연산, 그리고 어느 규모까지 위키이고 어디부터 RAG인가의 임계값까지 실물로 싣는다.
이 카테고리의 30편을 두 번 갠다 — 발행 구조 그대로인 8개 시리즈와 독립편 2로 한 번, 깊이 순서의 15개 주제로 다시 한 번. 목적별 읽는 순서 여덟 갈래를 함께 놓고, 두 지도 어느 쪽에서도 빠지는 편이 없는지 자리를 세어 확인한다.
1인 SaaS·제조유통·서비스콘텐츠 세 업종의 조직 규칙 문서를 열 개 축으로 나란히 놓고, 업종이 바뀔 때 무엇이 바뀌고 무엇이 자리를 지키는지 센다. 원 자료가 같은 파일에 붙이는 200줄이 이 카테고리의 다른 글들이 쓰는 200줄과 같은 값을 다른 목적으로 재고 있다는 것도 짚는다. 뒤쪽은 프롬프트 쪽에서 아직 이 카테고리에 없던 것들 — 안티패턴 5가지와 Plan Mode를 강제 절차로 바꾸는 하드 게이트 한 줄이다.
빈 폴더 하나에서 배포까지 가는 8단계와, 그중 데이터·인증 구간만 확대한 6단계를 나란히 놓는다. 두 순서를 단계별로 대조하면 여덟 중 넷만 여섯과 맞물리고 나머지는 각자 남는다. RLS를 인증보다 먼저 두는 순서의 이유, AI 기능을 붙인 뒤에 터지는 비용 폭주와 프롬프트 주입을 막는 방어선, 그리고 정책을 만든 뒤 익명 역할로 직접 공격해 보는 네 줄짜리 검증까지 이어 붙인다.
배포 전·중·후·롤백·보안·성능 여섯 섹션을 65개 항목으로 펼치고, 섹션마다 다른 점검 주기를 한 장의 흐름도로 그린다. 롤백 섹션은 표가 둘이라 14로 세기 쉬운데 항목은 여덟이며, 합계가 65가 되는지로 검산한다. 뒤쪽은 디버깅 — 재현·가설·검증·회귀방지 4 Phase와 13행 함정 카탈로그, 프롬프트 10패턴이다. 이 카테고리의 다른 글이 쓰는 「증상→원인→해결→예방」 4단과 이름이 같은데 카탈로그가 겹치는지 행 단위로 세어 본 결과도 함께 적는다.
에이전트를 통제하는 세 수단을 규범·강제·절차로 갈라 놓고, 비교표의 「강제력」 열이 셋 중 하나에서만 「있음」이 되는 구조를 본다. 훅 5종·차단 규칙 7종·운영 규약 6항목을 전부 펼치고, 훅 표가 요약한 사고 5가지를 차단 규칙 7종에 하나씩 배정해 어느 둘이 남는지 센다. 훅의 차단 사유가 어느 채널로 나가는지에 대해 원 자료의 표 안에서 두 행이 갈리고, 같은 카테고리의 다른 두 글도 서로 다르게 적어 두었다는 사실도 나란히 놓는다.
에이전트 운영 중 나는 장애를 외부 의존·자원 한도·내부 설정 3계층으로 먼저 좁히고, 증상→원인→해결→예방 4단으로 분해하는 진단 프레임. 가장 자주 나오는 문제 10선과 실제 장애 5건을 같은 틀에 넣고, 일일·주간·월간 점검 루틴과 계층별 진단 순서까지 정리한다.
에이전트를 만든 다음이 아니라 만들기 전에 정해야 하는 것 — 무엇을 자동화 대상으로 고를지 판단하는 두 도구와, 「끝났다」를 판정하는 5축 정량 루브릭, 그리고 조직 규칙 문서를 60줄로 유지하는 이유를 정리한다. 같은 문서의 분량을 이 카테고리의 다른 글이 200줄로 부른 것과의 관계도 함께 짚는다.
세션마다 자동으로 읽히는 규칙 파일을 Enterprise→Project→User→Local 4계층으로 쌓는 규칙과, 7단계를 3덩어리로 묶어 쓰는 작성 순서를 정리한다. 같은 200줄을 이 카테고리의 다른 글이 「상한」이라 부른 것과의 관계도 함께 짚는다.
복잡한 업무를 단계·파일·반복 세 가지로 나눠 시키는 법을 보고, 매 턴 전량 재전송되는 대화 이력을 어떤 임계에서 어떻게 회수할지, 세션이 끊겨도 결정이 남게 하려면 무엇을 파일로 빼야 하는지까지 정리한다.
AI 코딩 도구를 팀에 들일 때 개인 생산성은 거의 항상 오르지만 조직 전달 지표로는 잘 잡히지 않는다. 그 간극을 측정으로 메우는 방법과 6단계 도입 로드맵, 그리고 함께 보고된 반대 조건까지 정리한다.
스킬과 에이전트를 가르는 것이 기능이 아니라 자율성이라는 데서 출발해, 정의서 한 장을 frontmatter 핵심 5·확장 5와 역할·절차·제약 3섹션으로 분해하고, 문서대로 동작하지 않는다고 보고된 항목 세 건까지 버전 표기 없음을 명기한 채로 옮긴다.
규칙 파일 한 장 옆에 서는 여덟 개의 구성물을 역할·적용 범위·갱신 주기로 갈라 보고, 회사 단위로 확장하는 5단계 프레임워크와 지시 한 줄을 제대로 쓰는 프롬프트 7패턴까지 잇는다.
구조를 다 그려 놓고도 팀이 첫 턴에 멈추는 곳 — spawn 순서, 비동기 메시지, 파일 소유권, 종료 프로토콜 — 을 증상별로 짚고, 비용 3원칙과 실습 2건, 에이전트·훅·MCP를 한 벌로 묶은 오픈소스 환경 사례까지 잇는다.
MCP·커맨드·스킬·훅을 트리거 주체 하나의 축으로 가르고, 플러그인이 그 넷을 감싸는 배포 층인 이유와 조직 도입에서 안전장치가 자동화보다 앞서는 이유를 정리한다.
에이전트가 시스템에 영향을 주는 통로는 도구뿐이라는 사실에서 출발해 내장 도구 일곱 개를 리스크 등급으로 다시 묶고, 즉시 실행의 부작용을 제어하는 네 가지 지시 패턴 — Plan Mode·SDD·@파일 참조·이미지 입력 — 을 상황별 선택 기준까지 정리한다.
에이전트에게 줄 권한의 상한을 정하는 것은 신뢰가 아니라 복구 가능성이다. Git이 안전망이자 컨텍스트 공급원이 되는 구조, 검증 가능한 규약 파일이 갖춰야 할 다섯 요소, 그리고 환경 문제 20여 건이 수렴하는 세 가지 원인을 정리한다.
사람이 부르는 커맨드, AI가 감지하는 스킬, 이벤트만 나면 실행되는 훅을 각각의 파일 구조와 차단 계약까지 내려가 보고, 다섯으로 흩어진 설정을 하나의 매니페스트로 묶는 플러그인 배포까지 잇는다.
AI 코딩 도구를 자동완성·대화형·에이전틱 세 세대로 가르는 변수가 자율성 하나라는 점을 짚고, 실행·통제·지식 세 계층의 구조와 함께 인증 소스 우선순위가 어떻게 조직 비용 사고로 이어지는지를 설치 단계에서 확인한다.
권한을 선언형 JSON으로 통제하는 구조를 deny → allow → defaultMode 평가 순서와 5단계 설정 계층으로 정리하고, 패턴 문법으로 표현할 수 없는 조건부 규칙을 훅이 어떻게 메우는지 exit code 2 기반 차단까지 짚는다.
규약 파일을 개인 메모에서 조직 헌법으로 올리는 3계층 구조를 배치 기준과 자동 머지 규칙까지 정리하고, 전사 정책의 실효성을 결정하는 단 하나의 키와 부서별로 정책이 갈리는 이유, 그리고 규칙 문서에서 반복되는 다섯 안티패턴을 짚는다.
MCP의 N×M 문제와 3요소·전송 방식·스코프를 정리하고, 실무 6종의 인증·권한 설계와 마켓플레이스 선별 5기준을 지나 도구 하나가 점유하는 토큰을 예산으로 다루는 판단까지 잇는다.
AI 에이전트를 팀에 들일 때 반복해서 돌아오는 질문 열일곱 개에 결론부터 답한다. 도입 순서와 첫 대상 선정, 규약 파일이 갖춰야 할 형태, 조직 규모별 계층, 그리고 규칙이 지켜지지 않을 때 무엇을 바꾸는가까지.
MCP가 무엇을 해결하고 커맨드·스킬·훅이 무엇으로 갈리는지, 도구를 늘리면 무엇이 나빠지고 외부 서버를 무엇으로 거르는지를 결론부터 정리한다. 마지막 셋은 「MCP만 있으면」·「훅이면 완전히」·「스킬이면 자동으로」라는 과신을 교정하는 문항이다.
생성한 코드를 돌려 보고 고치는 순환을 상태 설계부터 세우고, 임의 코드 실행의 위협 일곱 가지를 격리 등급에 매핑한 뒤 사이클이 있는 그래프를 어떻게 끝낼 것인가를 정리한다.
장기 실행을 관리하는 하네스가 실제로 어떤 부품으로 조립되는지 다섯 구성물로 나누고, 세션 시작 비용을 만드는 고정 지식 일곱 종과 컨텍스트 상한의 벤치마크 근거를 토큰 단위로 분해한다.