Agent Doc Discipline
이 스킬을 사용하여 에이전트가 행동을 위해 소비하는 문서(다섯 가지 표면: CLAUDE.md, CONTEXT.md, docs/standards/, design-system/, .omc/skills/), 스펙, 티켓, 스킬 파일을 작성하거나 편집할 때 작성 규율을 적용하십시오. 문서가 통과해야 하는 기준: 새로운 에이전트 세션이 문서만 읽고도 행동할 수 있어야 합니다.
필수 적용 시점: 드라이독이 시드 표면을 생성할 때, 출시 C5 침전물 패스가 슬롯에 교훈을 기록할 때입니다. 다른 모든 편집에는 선택 사항이지만, 에이전트 대상 문서에 대한 수정은 이러한 규칙을 견뎌야 합니다.
사용하지 않아야 할 때
사람 전용 문서: docs/business/ 내러티브, ADR 결정 스토리, 사람 온보딩용 README. 이들은 규칙을 따르는 것이 비용이 들지 않는다면 따라도 되지만, 이 규율의 적용 대상은 아닙니다.
규율
채팅 기록이 없는 독자를 위해 작성하십시오. 문서는 스스로 설명 가능해야 하며, "앞서 논의한 대로", 이전 세션, 또는 누군가의 머릿속에 있는 지식에 의존해서는 안 됩니다. 검증: 새로운 에이전트 세션이 문서만 읽고도 행동할 수 있어야 합니다.
모든 규칙은 검증 가능하고 이유를 포함해야 합니다. "깔끔하게 유지하세요" 같은 모호한 표현 대신, 관찰 가능한 조건과 이유를 작성하십시오. 검증: 에이전트가 텍스트만으로 통과/실패를 판단할 수 있어야 하며, 이유는 규칙 옆에 명시되어야 합니다.
하나의 의미, 하나의 장소. 각 규칙이나 정의는 단일 권위 있는 위치를 가져야 하며, 중복은 표류를 초래합니다. 검증: 동작 변경 시 한 곳만 수정하면 됩니다.
환경이 알려주는 내용을 절대 반복하지 마십시오. 패키지 스크립트, 디렉터리 레이아웃, --help 출력은 조회 대상이지 문서가 아닙니다. 복사된 조회는 오래됩니다. 찾아서 알 수 없는 것, 즉 문서화되지 않은 관습, 선택의 이유, 함정에 대해서만 문서화하십시오. 검증: 모든 줄이 "이것을 다른 곳에서 조회할 수 있나?"를 견뎌야 합니다.
절차를 먼저, 참조는 뒤에, 자주 쓰이지 않는 내용은 포인터 뒤에. 수행할 작업을 순서대로 상단에 배치하고, 필요 시 조회하는 규칙은 아래에 배치하며, 자주 쓰이지 않는 내용은 트리거 분기를 명명하는 포인터 뒤에 배치하십시오. 검증: 다음 행동이 첫 화면 안에서 찾을 수 있어야 합니다.
각 단계는 완료 기준으로 끝납니다. 완료는 미완료와 구분 가능해야 하며, 모호한 경계는 조기 완료를 초래합니다. 검증: 각 단계에 대해 "이것이 완료되었는지 어떻게 알 수 있나?"에 대한 답이 텍스트에 있어야 합니다.
긍정을 유도하십시오. 목표 동작을 명시하십시오. 금지는 엄격한 가드레일을 위해 예약되며, 항상 긍정 목표와 함께 제시되어야 합니다. 검증: 문서 내 모든 금지는 대신 해야 할 것을 명시해야 합니다.
작성 시 불필요한 내용을 제거하십시오. 문서에 오래되었거나 중복된 내용이 있을 때는 동일한 편집에서 제거하고, 없을 때는 필요한 내용만 추가하고 삭제를 발명하지 마십시오. 모델이 이미 기본적으로 따르는 문장은 불필요한 부하를 주므로 전체 문장을 삭제하십시오. 검증: 다시 읽은 모든 줄이 "이것이 기본값과 비교해 동작을 변경하는가?"라는 기준에 부합해야 하며, 편집 중 발견된 오래되었거나 중복된 내용은 제거되어야 합니다.
검증
문서 변경을 완료했다고 보고하기 전에 다음을 확인하십시오:
- 새로운 세션이 사람에게 질문하지 않고도 행동할 수 있어야 함
- 모든 규칙이 검증 가능하고 이유를 명시하며, 조회 내용을 반복하지 않아야 함
- 의미가 한 곳에 존재하고, 포인터는 트리거 분기를 명명해야 함
- 편집 중 발견된 오래되었거나 중복된 내용은 제거되었고, 유효한 관련 없는 내용은 보존되었어야 함