하나의 원본으로 여러 AI 도구용 지시문을 만드는 구조를 고치고 늘리기

## 고치기 전에 그 동작을 맡은 부분 찾기 저장소를 느슨한 파일 모음이 아니라 소유 책임이 정해진 계층의 집합으로 취급하세요. 편집하기 전에 요청된 동작을 어느 계층이 담당하는지 확인하세요. - 소스 지침은 재사용 가능한 사용자 대상 작업을 정의합니다. - 공유 참조 문서는 여러 영역에 적용되는 계약과 스키마를 정의합니다. - 보조 스크립트는 반복 가능한 처리를 구현합니다. - 어댑터는 정본 지침을 플랫폼별 패키지로 변환합니다. - 생성된 배포물에는 다시 빌드할 수 있는 결과물이 포함됩니다. - 훅은 저장소와 결과물의 규칙을 적용합니다. - 아키텍처 및 운영 설명서는 각 계층의 상호작용 방식을 설명합니다. - 종속성 및 설치 파일은 지원되는 실행 환경을 정의합니다. 정본 소스 계층을 권위 있는 기준으로 사용하세요. 생성된 배포물은 빌드가 작동한다는 증거이지 독립적인 정본이 아닙니다. 직접 편집하지 말고 문서화된 빌드 워크플로를 통해 다시 생성하세요. 요청된 동작을 제어하는 가장 작은 권위 있는 파일을 추적한 다음, 그 파일에 의존하며 동기화해야 하는 모든 문서, 스키마, 테스트, 생성 산출물을 확인하세요. ## 원본은 하나로 두고 AI 도구별 버전은 변환 프로그램으로 만들기 재사용 가능한 지침은 플랫폼에 종속되지 않는 하나의 소스 형식으로 유지하세요. 각 지원 환경에 필요한 패키징과 구문 변환은 어댑터가 수행하도록 하세요. 어댑터는 다음을 수행할 수 있습니다. - 의미 변경 없이 호환되는 소스를 복사합니다. - 작업마다 하나의 네이티브 스킬 패키지를 생성합니다. - 진입점이 여러 개인 공유 엔진을 구성합니다. - 프롬프트와 보조 스킬이 포함된 플랫폼 패키지를 빌드합니다. - 소스 메타데이터에서 디스패처와 라우팅 테이블을 생성합니다. 어댑터는 원래의 동작과 제약을 반드시 보존해야 합니다. 대상 환경이 다른 도구를 사용할 때는 플랫폼별 도구 이름을 중립적인 작업 표현으로 변환하세요. 두 번째 수기 카탈로그를 관리하지 말고 정본 설명에서 라우팅 메타데이터를 생성하세요. 작업을 추가할 때는 해당 정본 소스를 한 번만 편집하세요. 그 작업이 해당 플랫폼에서 작동할 수 없는 경우에만 명시적인 플랫폼 제외를 사용하세요. 영향을 받는 모든 어댑터를 다시 빌드하고 결과물에 의미 변화가 없는지 검토하세요. ## 저장하는 메모마다 출처와 확실한 정도 표시하기 지식 산출물을 기록하는 모든 작업은 저장소의 정본 쓰기 계약을 따라야 합니다. 산출물을 당장의 사람 가독성만이 아니라 향후의 안정적인 검색과 추론에 맞게 설계하세요. 각 산출물에는 다음 항목이 반드시 포함되어야 합니다. - 미래의 AI 독자에게 목적을 설명하는 짧은 서문. - 산출물 유형, 날짜, 태그, 명시적인 `AI-first` 플래그와 같은 구조화된 메타데이터. - 언급된 사람, 프로젝트, 아이디어, 결정에 대한 안정적인 내부 링크. - 오래될 수 있는 주장에 대한 최신성 표시. - 외부 주장 옆에 원문 그대로 보존된 출처 URL. - 명시된 사실, 강한 근거, 중간 수준의 근거, 추측을 구분하는 신뢰도 레이블. 산출물을 더 깔끔하게 보이게 하려고 메타데이터, 링크, 출처 정보, 신뢰도 신호를 제거하지 마세요. 작업에서 새로운 산출물 유형을 도입한다면 그 유형을 생성하기 전에 공유 스키마를 확장하세요. ## 자동 점검으로 확인할 수 있는 작성 규칙 쓰기 포매터와 훅이 일관되게 검증할 수 있는 규칙을 사용하세요. - Markdown 제목은 문장형 대소문자로 작성합니다. - 지침 소스에 장식용 이모지를 넣지 않습니다. - 비 ASCII 기호가 고유한 의미를 지닌 경우가 아니라면 조판용 대체 기호 대신 ASCII 문장 부호를 사용합니다. - 태그 값은 소문자로 쓰고, 모호한 메타데이터 문자열은 따옴표로 묶습니다. - 설정된 언어 버전, 포매터, 줄 길이 제한, 종속성 관리자를 따릅니다. - 커밋 제목은 명령형으로 작성하고 저장소의 기여자 표시 정책을 적용합니다. 기계적인 스타일에 대해서는 정본 포매터와 검증 훅을 최종 기준으로 취급하세요. 이를 우회하거나 훅이 거부하는 서식을 수동으로 유지하지 마세요. 규칙은 자동으로 강제할 수 있을 만큼 범위를 좁게 유지하세요. 규칙을 기계적으로 확인할 수 없다면, 확인에 필요한 검토 근거를 문서화하세요. ## 새 작업을 더할 때 설명서와 목록도 함께 고치기 새 작업을 추가할 때는 다음 순서를 사용하세요. 1. 라우팅 메타데이터와 완전한 운영 지침을 갖춘 정본 지침 소스를 만듭니다. 2. 실행 가능한 로직이 필요할 때만 지정된 스크립트 영역에 보조 기능을 추가합니다. 3. 산출물을 생성하거나 수정할 수 있는 모든 경로에서 공유 쓰기 계약을 참조합니다. 4. 새로운 산출물 유형을 도입하기 전에 공유 메타데이터 스키마를 확장합니다. 5. 운영 설명서, 기능 목록, 아키텍처 참고 사항, 공개 명령 카탈로그를 업데이트합니다. 6. 아직 릴리스되지 않은 변경 기록 섹션에 변경 사항을 기록합니다. 7. 어댑터 빌드를 실행하고 영향을 받는 모든 플랫폼의 결과물을 검사합니다. 생성된 플랫폼 트리에 작업을 중복해서 만들지 마세요. 동기화된 변경은 소스, 적용되는 참조 규칙, 테스트, 문서를 함께 업데이트하므로 이후의 재빌드로 내용이 사라지거나 서로 모순되지 않습니다. ## 지시문의 동작과 버전을 만드는 과정을 따로 테스트하기 소스 동작과 생성 파이프라인을 별도로 테스트하세요. 사용 중인 지식 저장소 대신 격리된 테스트 작업 공간이나 연결된 로컬 작업 사본을 사용하세요. 동작을 검증할 때는 다음을 수행하세요. - 대표적인 테스트 데이터로 변경된 작업을 실행합니다. - 생성된 산출물을 검사합니다. - 필수 메타데이터, 링크, 출처 정보, 신뢰도 레이블, 그 밖의 쓰기 계약 필드를 검증합니다. - 알 수 없는 사실이 명시적으로 알 수 없는 상태로 유지되는지 확인합니다. 파이프라인을 검증할 때는 다음을 수행하세요. - 설정된 패키지 실행기를 통해 저장소의 스모크 테스트 모음을 실행합니다. - 어댑터 결과물 위치와 생성된 라우팅을 검증합니다. - 보조 스크립트 인터페이스와 기계 판독 가능한 결과물을 시험합니다. - 의도적으로 결과물 배치를 변경한다면 같은 변경 안에서 해당 어설션을 업데이트합니다. 가장 범위가 좁은 관련 테스트를 먼저 실행한 다음, 영향을 받는 스모크 테스트 모음을 실행하세요. 수동 동작 점검은 자동 테스트를 보완하지만 대체하지는 않습니다. ## 점검을 통과한 뒤 허락받은 사람만 새 버전 내기 지속적 통합 검사가 모두 통과하고 기계 처리용 쓰기 계약이 계속 충족될 때만 릴리스하세요. 다음과 같은 통제된 릴리스 순서를 사용하세요. 1. 아직 릴리스되지 않은 변경 기록 항목을 날짜가 표시된 버전 제목 아래로 이동합니다. 2. 기본 패키지 파일과 복제된 모든 매니페스트 또는 인용 정보 파일의 버전을 업데이트합니다. 3. 모든 버전 선언을 비교하는 불일치 검사를 실행합니다. 4. 생성된 배포물을 다시 빌드하고 영향을 받는 테스트를 실행합니다. 5. 태그 지정이나 푸시 전에 릴리스 담당 역할과 브랜치 정책을 확인합니다. 6. 승인된 변경 기록 항목을 바탕으로 릴리스 노트를 게시합니다. 공유 기본 브랜치를 보호하세요. 기여자는 지정된 검토 경로를 사용해야 합니다. 유지관리자는 저장소 정책이 해당 권한을 명시적으로 부여하고 동일한 검증 관문을 모두 통과한 경우에만 직접 게시할 수 있습니다. ## 빠진 사실을 지어내지 않고 자동으로 만든 파일을 손으로 고치지 않기 겉모습을 이유로 시스템의 검색 계약을 절대 약화하지 마세요. 필수 서문이나 메타데이터를 제거하지 말고, 기계 처리용 산출물을 더 인간적으로 들리게 하려는 이유만으로 다시 쓰지 말며, 소스 규칙에서 금지한 장식 요소를 추가하지 마세요. 비율, 날짜, 소유권, 관계 또는 그 밖의 누락된 사실을 지어내지 마세요. 알 수 없는 값은 `TBD` 또는 저장소에서 정한 동등한 명시적 미확인 표시로 나타내세요. 생성기가 관리하는 생성 결과물은 절대 편집하지 마세요. 훅을 우회하거나, 승인되지 않은 브랜치로 게시하거나, 소스 검사만으로 성공을 주장하지 마세요. 완료를 보고하기 전에 다음을 수행하세요. - 의도한 전체 차이에 관련 없는 변경이 없는지 검토합니다. - 정본 소스와 생성 결과물이 일치하는지 확인합니다. - 관련 포매터, 훅, 테스트, 어댑터 빌드를 실행합니다. - 동기화 대상인 스키마, 설명서, 카탈로그, 변경 기록 항목을 검증합니다. - 수동 검증 내용과 실행할 수 없었던 검사를 기록합니다. - 최종 게시 작업이 승인된 역할과 일치했는지 확인합니다. 변경된 동작, 검증 근거, 남은 제한 사항, 아직 필요한 결정을 보고하세요.