DanzzaN

에이전트 문서 작성

스킬·프롬프트·진입 지침을 작성하거나 줄일 때 참고할 판단과 원천을 연결한다. 일반 노트의 제목·도입·소제목·연결은 VAULT_RULES > 작성과 연결을 따르며, 이 Map의 행동 지침 기준은 절차와 운영 안내에 적용한다. 일반 Markdown으로 조회할 수 있는 내용을 스킬로 등록할 필요는 원격 Vault 정본과 쓰기 운영 결정 - Codex 대화 > Vault 직접 읽기로 스킬 역할 대체에서 판단한다.

작성할 때 결정할 것

  • 프로젝트 README를 작성·보강할 때는 프로젝트 README는 오래 유지될 설명과 원천 문서의 입구로 구성한다를 읽고 목적·구조·원천 연결을 프로젝트의 독자와 이용 방식에 맞춰 구성한다.
  • 문서가 바꿔야 할 판단이나 동작을 먼저 정한다. 현재 요청의 범위·권한과 과거 사례에서 파생한 관례를 구분하고, 이미 환경이나 상위 지침이 제공하는 내용은 해당 원천을 연결한다.
  • 진입 지침에는 언제 무엇을 읽을지 둔다. 선택한 작업에 필요한 내용은 그 자리에서 읽을 수 있게 하고, 특정 작업에서만 필요한 상세는 연결된 문서에 둔다. 이동한 내용의 호출자가 실제 경로에 도달하는지도 확인한다.
  • 절차가 필요한 작업은 관찰 가능한 결과로 완료를 구분한다. 조사량·단계 수·전수 확인 자체를 모든 작업의 목표로 고정하지 않고, 잘못된 완료 판정의 실제 비용에 맞춘다.
  • 짧고 구체적인 행동 문장을 사용한다. 행동을 안내하는 부분에는 아래 작성 기준을 적용한다.
  • 특정 단어, 긍정문, 문서 분리만으로 행동 안정성이 보장된다고 가정하지 않는다. 반복 누락이 관찰되면 원천 부재·탐색 실패·지침 충돌·실행 실패 중 원인을 확인해 해당 부분을 고친다.

이는 두 로컬 writing-for-agents 스킬을 검토해 선택한 작성 기준이며 모델 행동의 실험적 보장이나 사용자의 영구적 성향을 뜻하지 않는다.

행동 지침의 표현과 적용 범위

  • 원하는 행동을 긍정형으로 적는다. 기존 금지문을 수정할 때는 그 상황에서 수행할 행동을 함께 정한다.
  • 적용 조건에 따라 행동이 달라지면 조건과 행동을 연결한다. 완료 판단이 필요하면 확인할 결과를 명시한다.
  • 결과는 답변·판단·시스템 상태·산출물 중 작업 목적에 맞게 정한다. 기록물은 보존이 필요한 작업에서 만든다.
  • 스킬·프롬프트·진입 지침과 Vault의 절차·운영 계약에서 행동을 안내하는 부분에 적용한다. 개념·근거·경험·성찰은 각 설명 목적에 맞게 구성한다.
  • 권한·안전 경계는 의미를 명확히 보존하고, 허용되는 행동을 함께 안내한다.
  • 작성 후에는 같은 상황에서 수행할 행동을 문장으로 식별할 수 있는지 대조한다. 실행 효과는 실제 사용에서 관찰한 결과로 판단한다.

2026-09-06 현재 Codex 대화에서 사용자는 자격증 조사 지침을 긍정형으로 바꾸고, 이 작성 기준을 스킬·프롬프트와 Vault 작성에도 적용할 지점을 검토한 뒤 반영하도록 요청했다. 이 절은 그 요청과 채택한 적용 범위를 기록한다.

디자인 판단을 설명할 때

적용 조건·선택·이유를 함께 남긴다. 예를 들어 반복해서 여는 메뉴에서 장식적 전환을 줄였다면, 어떤 사용 빈도에서 어떤 지연을 줄이려는 선택인지 설명한다. 픽셀 수치나 효과 이름만 저장하면 다음 화면에서 적용할 조건을 복원하기 어렵다.

디자인 엔지니어링과 모션 판단 - Emil Kowalski의 Agents with Taste는 좋다고 느낀 이유를 언어로 설명해 판단 기준으로 전달하는 사례다. 이 근거를 현재 작성 기준의 디자인 적용으로 연결하며, 특정 규칙 파일이 모델의 취향이나 실행 품질을 보장한다고 해석하지 않는다. UI 작업에서의 원문 방문과 개인 선호 갱신은 UI 디자인을 따른다.

내용의 위치

개인 지식과 판단 이유는 개인 원격 Vault, 프로젝트 절차와 기록은 해당 프로젝트의 로컬 Vault, 팀 계약은 팀 저장소의 공식 문서가 소유한다. 현재 값·명령·설정은 실제 파일을 조회한다. 문서화할 내용은 그 원천을 찾는 조건, 환경에 드러나지 않는 이유와 필요한 예외다. 잔여 Claude 메모리는 이미 증류를 거친 기록이며 재승격 대기열로 취급하지 않는다.

스킬은 명시 호출의 편의·플랫폼 고유 실행 기능·문서 접근을 보완한 뒤에도 남는 반복 누락에 실제로 필요할 때 남긴다. 원천을 다른 파일명으로 통째로 복사하는 것은 감축이 아니다.

플랫폼별 작성·등록

작성 시점의 지원 형식과 호출 정책을 아래 원천에서 확인한다. 한 플랫폼의 frontmatter나 허용 설정을 다른 플랫폼에 그대로 적용하지 않는다.

위 공식 문서는 2026-09-06 조회했다. 이름·설명과 전체 본문은 필요한 시점에 다르게 로드되므로 전체 파일 크기를 매 턴 절감량으로 계산하지 않는다.

검토 원천

  • 2026-09-06 확인한 Codex 로컬 스킬과 호출 방식 참고.
  • Claude 원본은 비활성 보관 위치 C:/Users/aica_/.claude/disabled-skills/writing-for-agents/SKILL.md에 보존한다.
  • 원본의 출처·라이선스는 UPSTREAM·LICENSE에 보존한다. 이 문서는 원본 전체의 번역·복제 대신 현재 작업의 선택 기준을 다시 쓴 것이다.
  • 외장뇌 운영

그래프 뷰

백링크