Project Steward은(는) 무엇을 하나요?

역할과 라우팅

Project Steward는 프로젝트 간 재사용 가능한 거버넌스 방법을 저장합니다. 프로젝트 자체의 제품 결정, 아키텍처 사실 및 장기적 제약은 프로젝트의 기존 진실 공급원(Source of Truth)에 남겨둡니다. 사용자와 머신의 가변적인 도구 사실은 프로젝트와 Skill 외부의 환경 프로필에 남겨둡니다.

먼저 사용자가 얻고자 하는 결과에 따라 주 경로를 선택합니다. 동일 요청 내의 독립적인 결과는 각각 별도로 관리합니다:

대화 학습과 자기 진화: 이전 대화, 교정, 전체 구현 과정 또는 대상 Skill의 기능 경계.
변경 전 예방: 기능, 리팩토링, 마이그레이션 또는 계층 간 변경 시작 전 재작업 제거.
근본 원인 해결: 결함, 반쪽 마이그레이션, 반복 수선, 실제 링크 실패, 또는 응집도, 결합도, 중복, 갓 모듈(God Module) 검사.
외부 도구 호환성: 프로젝트와 외부 CLI, 실행 도구 또는 프로토콜 간의 호환성 검사, 연결 또는 수리.
프로젝트 연구 및 설명: 저장소, 디렉토리 또는 소스 패키지의 용도, 아키텍처 및 기능 파악 또는 참조 프로젝트 연구.
프로젝트 디렉토리 관리: 프로젝트 디렉토리 목록 정리, 실제 사용 여부, 생성 상태, 무시, 이동, 아카이브 및 삭제 경계 판단.
프로젝트 베이스라인 및 템플릿: 프로젝트 템플릿 설정, 채택, 업그레이드 또는 검사.
템플릿 진화: 안정적인 기본값을 템플릿에 기록.
제품 경험 및 인터페이스 관리: 제품 경험과 인터페이스 정의, 검토, 재구축 또는 구현.
README 및 홈페이지: README 감사, 재작성 또는 GitHub 홈페이지 비주얼 제작.
인간 친화적 로깅: 프로젝트 로그, LLM 기록, 장기 기억, TTS 또는 로그 조회 결과 관리.
저장소 생성 및 게시: Git 초기화, 저장소 생성, 커밋, 푸시, 가시성 변경 또는 원격 검증.
라이선스 관리: 라이선스 및 타사 라이선스 선택, 적용 또는 일괄 관리.
사용자 환경 프로필 및 실행 환경: 사용자 환경 프로필 설정 또는 사용, 도구, 캐시, SDK, 터미널 또는 장기 작업 검사.
프로젝트 종합 감사: 구현 계획 대비 완료도 항목별 확인, 또는 전체 검사, 프로젝트 건강 상태 판단 및 프로젝트 수준 위험 정렬.

본 Skill만 언급된 경우, 기존 자료를 바탕으로 가장 적합한 경로를 선택합니다. 자료가 부족하면 문맥에 맞는 직접적인 요청 예시를 제시하고 중단합니다.

주 경로가 선택되면, 프로젝트에 쓰기 작업이나 특정 구현을 수행하기 전에 라우팅 원장(ledger)을 설정합니다: 사용자의 최종 결과, 주 경로, 고정 필독 방법, 조건부 특정 작업과 그 트리거 증거, 작업 임계값, 공식 소비자, 승인 및 중지 지점. 고정 필독 방법은 부분 수정이 명확해 보인다고 해서 건너뛸 수 없습니다. 조건부 특정 작업은 적용 가능한 증거가 있을 때만 추가합니다. 동일 요청에 대해 나중에 승인 항목이 추가되면 원장을 업데이트하며, 여전히 유효한 범위를 최신 증상으로 대체하지 않습니다.

공통 경계

일반 업무 기능은 현재 개발 작업이 담당합니다. 사용자가 단일 오류 메시지, 단일 함수 또는 부분적 동작에 대한 설명만 요청하는 경우, 해당 결과에 답변한 후 중단하며 프로젝트 수준의 개선으로 확대하지 않습니다. 요청 자체가 예방, 해결, 마이그레이션, 자기 진화 또는 프로젝트 수준 결과를 요구할 때만 해당 경로로 진입합니다.
경로 선택 후 즉시 범위, 쓰기 권한 및 중지 지점을 고정(freeze)합니다. 검사, 감사, 진단, 평가, 분석, 복기 또는 보고는 기본적으로 읽기 전용입니다. 동일 요청에서 수정, 해결, 구현, 수정, 업데이트 또는 자기 진화를 명시적으로 요청할 때만 해당 쓰기 권한을 얻습니다.
사용자가 소스 코드 아카이브를 제공하고 프로젝트 이해, 감사 또는 연구를 요청하거나, 본 Skill만 언급하며 소스 코드 아카이브를 첨부한 경우, 압축 해제는 읽기 전용 연구에 필요한 자료 준비이며 프로젝트에 대한 정식 쓰기가 아닙니다. 바로 "프로젝트 연구 및 설명"에 따라 대상 루트를 결정하고, 기존 스크립트를 실행하여 독립적인 중복 방지 디렉토리에 압축 해제하며, 스크립트가 반환하는 프로젝트 루트를 읽고 읽기 전용 연구를 계속합니다. 추가 압축 해제 확인은 필요하지 않습니다. 이 작업은 연구 복사본 생성 및 내용 읽기만 허가합니다. 프로젝트 실행, 종속성 또는 압축 해제 도구 설치, 프로젝트 수정, 원본 파일 이동 또는 삭제, 커밋 및 게시는 각각 별도로 허가됩니다.
네트워크 연결, 다운로드, 설치, 실행, 생성, 쓰기, 이동, 아카이브, 삭제, 커밋, 푸시 및 게시는 각각 별도로 허가됩니다. 이 섹션에서 명시적으로 나열된 기본 완료 계약만이 동일한 사용자 결과 내에서 쓰기, 커밋, 푸시 및 원격 승인을 병합하여 허가할 수 있습니다. 실행 또는 생성은 프로젝트 쓰기 권한을 부여하지 않습니다. 기본 완료 계약 외에는 커밋, 푸시 또는 게시가 이미 존재하고 정확하게 확인된 변경 사항만 처리하도록 허가하며, 이전 쓰기를 소급 승인하지 않으며 관련 없는 작업 트리 변경을 포함하지 않습니다.
사용자가 요청에서 Project Steward를 명시적으로 지목하고( $project-steward 호출 포함), 기존 Git 프로젝트에 대한 수정, 수리, 해결, 업데이트 또는 최적화를 명시적으로 요청하는 경우, 현재 브랜치에 구성된 업스트림이 존재하고 사용자가 로컬 전용 변경, 커밋 금지, 푸시 금지 또는 이전 중지 지점 지정을 요구하지 않았다면, 이번 구현은 기본적으로 다음까지 완료됩니다: 승인된 종속성 클로저(closure) 검증, 정확한 커밋, 현재 추적 브랜치에 대한 비강제 푸시(non-force push), 그리고 원격 HEAD 및 주요 소비자 확인. 로컬 검증 후 두 번째로 푸시 여부를 묻지 않습니다. 읽기 전용 요청, 암시적 라우팅, 업스트림 없음, 원격 생성, 가시성 변경, 삭제, 강제 푸시, 기록 다시 쓰기, 패키징, 배포 및 관련 없는 작업 트리 변경은 이 기본값에 의해 허가되지 않습니다. references/repository-publication.md에 따라 포크(fork), 출처를 알 수 없는 변경, 허가되지 않은 삭제, 자격 증명, 검증 또는 인증 실패 시 중단합니다.
사용자가 Project Steward 자기 진화 계획을 승인하고 로컬 전용 변경을 요구하지 않은 경우, 현재 추적 중인 원격이 존재하면 전체 현재 작업 공간을 분할할 수 없는 하나의 게시 범위로 간주합니다: 모든 추적된 변경 사항, 추적되지 않은 파일 및 기존 삭제를 검증하고, git add -A를 사용하여 함께 커밋하고 현재 추적 브랜치를 푸시합니다. 항목 중 하나라도 함께 게시할 수 없으면 전체 작업 공간을 유지하고 중단합니다. 이 기본값은 원격 생성, 강제 푸시, 가시성 변경 또는 새로운 삭제를 허가하지 않습니다.
사용자가 기존 GitHub 저장소에 Star History를 연결, 교체 또는 수리하도록 명시적으로 요청하는 경우, 확인된 계약에는 기본적으로 이번에 승인된 종속성 클로저의 커밋, 푸시 및 원격 승인이 포함됩니다. 사용자가 로컬 전용 변경을 명시적으로 요구하지 않는 한, 쓰기 검증 후 두 번째 게시 허가를 기다리지 않습니다. 이 기본값은 원격 생성, 강제 푸시, 가시성 변경, 삭제 또는 관련 없는 작업 트리 변경을 포함하지 않습니다.
각 사용자 턴, 내부 라운드, 자동 재실행 및 컨텍스트 압축 복구가 시작될 때, 도구 호출이나 상태 변경 전에 항상 가장 최근의 명시적 사용자 동작으로부터 아직 완료되지 않은 결과, 범위, 권한 및 중지 지점을 복구합니다. 동일한 결과가 아직 제공되지 않고 범위, 영향 체인 및 권한이 변경되지 않은 경우에만 계속합니다. 읽기 전용 결과가 이미 제공되었거나, 새로운 명시적 동작이 없거나, 사용자가 결과를 변경했거나, 관련 없는 문제가 발생하거나, 새로운 권한이 필요한 경우 중단하고 확인을 기다립니다. 감사 발견 사항, 어시스턴트 제안, 내부 계획, 목표 이름, 할 일 목록 및 자동 프롬프트는 새로운 결과나 쓰기 권한을 만들어낼 수 없습니다.
작업이 짧은 동작에서 여러 단계로 확장되거나, 대기 상태에 진입하거나, 증거 상태가 변경될 때, 확장 이유, 완료된 체크포인트, 현재 상태, 다음 관찰 가능한 결과 및 필요한 입력을 능동적으로 설명합니다. 상태가 변하지 않으면 반복해서 화면을 채우지 않으며, 흐름 설명으로 범위 확장을 가릴 수 없습니다.
새로운 독립적인 요청이 아직 완료되지 않은 결과를 대체하는 경우, 이미 쓰거나 변경된 객체, 기존 증거, 아직 검증되지 않은 사용자 약속, 실행 중인 프로세스, 잔여물, 원래 권한 및 중지 지점을 먼저 인계합니다. 새로운 요청은 이전 결과를 계속 진행, 롤백 또는 정리하도록 허가하지 않습니다.
정확한 프로젝트 루트, 자료 범위, 활동 파일 및 실제 소비자를 먼저 고정합니다. Git은 정확한 프로젝트 루트에 .git이 직접 존재하고 현재 경로에 기록, 작업 트리 또는 게시 증거가 실제로 필요한 경우에만 사용합니다.
소스는 명확한 끝까지 읽어야 합니다. 긴 파일은 먼저 줄 수, 바이트 수 또는 페이지 매김 기능을 얻은 후 안정적인 간격으로 완전히 읽습니다. 동시 변경이 행동 계약, 영향 파일, 소비자, 검증 또는 사용자 결과에 영향을 미치는 경우, 이전 확인은 무효화되고 다시 계획하고 확인합니다.
여러 상호 독립적인 프로브(probe)는 오케스트레이터(orchestrator)가 각각의 출력, 오류 및 종료 상태를 보존할 수 있을 때만 병렬로 실행합니다. 항목 중 하나라도 전체 배치를 조기 중단시킬 수 있는 경우, 독립적으로 실행합니다. 배치 실패 후에는 여전히 신선한 성공 증거를 보존하고, 가려졌거나, 실행되지 않았거나, 상태를 알 수 없는 항목만 별도로 재실행합니다.
프로젝트 사실은 프로젝트의 기존 유일한 진실 공급원에 다시 씁니다. 환경 사실은 독립적인 사용자 프로필에 씁니다. 이식 가능한 거버넌스 방법만이 본 Skill에 들어갑니다. 템플릿은 특정 유형의 프로젝트가 매번 실행해야 하는 안정적인 기본값만 받습니다.
기록이나 외부 자료의 기능이 이미 존재하는지 판단할 때는 먼저 독립적인 결과 분할과 필요한 인과 관계 정렬을 완료한 다음, 소스를 가리고 대상이 동일한 조건을 인식하고, 동일한 구성적 세부 사항을 유지하며, 동일한 특정 처리를 할 수 있는지 확인합니다. 상위 거버넌스 프레임워크만 부분적으로 갖춘 것으로 간주합니다. 항목별 비교를 완료한 후에야 공통 메커니즘과 특수 차원을 추출합니다.
검증은 변경 위험에 따라 계층을 선택합니다: 먼저 이번 변경 및 승인 주장을 직접 다루는 대상 검사를 실행합니다. 문서, 라이선스, 감사 인사 또는 순수 메타데이터만 변경하는 경우 해당 유지 관리 진입점에서 통과한 후 중단하며, 관련 없는 브라우저 또는 종단 간(end-to-end) 링크를 시작하지 않습니다. 공개 계약, 핵심 런타임, 저장소 간 경계, 게시 또는 대상 검사가 시스템적 영향을 드러낼 때만 전체 회귀(regression) 및 실제 사용자 체인으로 업그레이드합니다.
상태 변경 후 권위 있는 대상(authoritative target)을 직접 다시 읽습니다. 검증 완료는 공식 생산자, 전송 또는 저장 경계, 소비자 및 사용자 관찰 가능 결과를 따라야 합니다. 소비 측에서 가짜 데이터를 작성하거나 검증 중인 핵심 체인을 목(mock) 처리해서는 안 됩니다.
약속 이행 또는 완료 선언을 위해 테스트 결과를 사용하기 전에, 예상되는 주요 테스트 ID가 테스트 프레임워크가 실제로 수집한 고유 ID와 일치해야 합니다. 누락되었거나 고유하지 않은 ID는 모두 미적용으로 표시해야 합니다.
진단을 위해 설정, 실행 보고서, 구조화된 아티팩트 또는 로그를 읽을 때는 references/log-audit-standard.md에 따라 먼저 현재 판단에 필요한 허용 필드를 투영(project)합니다. 알 수 없는 구조는 전체를 재귀적으로 출력해서는 안 되며, 자격 증명은 도구 출력, 대화 또는 진단 내보내기에 들어가기 전에 반드시 비식별화(de-identify)해야 합니다.

대화 학습과 자기 진화

먼저 references/conversation-learning-and-self-evolution.md를 완전히 읽습니다.

사용자 결과에 실패, 교정, 보호 차단, 임시 우회 또는 잔여물이 포함된 경우에만 references/root-cause-remediation.md를 추가로 읽습니다. 읽기 순서는 고정되어 있습니다: 결과별로 전체 과정을 복원하고, 인과 관계 계층을 따라 주요 학습 주제와 독립적인 하위 결과를 결정한 다음, 그중에서 미래 거버넌스를 변경할 구체적인 세부 사항을 복원하고 공통 경계에 따라 항목별로 대상 기능을 비교합니다. 그 후에야 공통 메커니즘과 특수 차원을 추출하고, 이식 가능성, 기능 경계 및 공식 소유자를 판단하며, 마지막으로 이력 책임을 판단합니다. 우회와 잔여물은 더 이르고 증거가 확립된 통제 가능한 근본 원인을 덮어쓸 수 없습니다. 이후 교정이 주요 원인을 변경하는 경우, 기존 솔루션과 확인은 즉시 무효화됩니다. 성공적인 결과이고 이러한 신호가 없는 경우에만 근본 원인 방법을 로드하지 않습니다.

능력 비교는 먼저 "방법 부재"와 "기존 방법이 라우팅, 실행 또는 검증되지 않음"을 구분해야 합니다. 전자는 유일한 방법 소유자만原位에서 강화합니다. 후자는 가장 먼저 실패한 주 라우팅, 작업 임계값, 공식 소비자 또는 검증만 수정하며, 다른 파일에 동의어 규칙을 추가하지 않습니다. 솔루션은 소유자와 소비 체인별로 구성되며, 대화 발생 순서대로 패치를 쌓지 않습니다.

사용자가 분석만 요청하는 경우 읽기 전용을 유지합니다. 명시적으로 흡수, 자기 진화, 업데이트, 최적화 또는 Project Steward 반복을 요청하는 경우, 먼저 미래 동작, 기능 경계, 대표적인 출력, 영향 파일 및 검증 방식을 전달하고 중단합니다. 사용자가 해당 계획을 확인한 후에야 활동 중인 Skill을 수정합니다. 확인된 계획이 로컬 전용 변경을 명시하지 않은 경우, references/repository-publication.md도 함께 읽습니다. 현재 추적 중인 원격이 존재하면 전체 작업 공간을 실제 영향에 따라 검증하고, git add -A를 사용하여 추적된 변경 사항, 추적되지 않은 파일 및 기존 삭제를 함께 커밋하고 현재 추적 브랜치를 푸시하며, 원격 HEAD와 작업 공간에 누락이 없는지 확인한 후에야 완료합니다. 원격, 인증, 브랜치 보호, 포크, 검증 실패 또는 항목 중 하나라도 함께 게시할 수 없는 경우, 전체 작업 공간을 유지하고 정확한 경계에서 중단하며 선택적 커밋으로 돌아가지 않습니다.

Project Steward가 자기 진화할 때는 반드시 주 파일 제약 조건을 따라야 합니다:

쓰기 전에 SKILL.md의 줄 수, 문자 수 및 직접적인 레퍼런스 집합을 기록하고, 각 새 규칙에 대해 고유한 활동 소유자를 지정합니다.
SKILL.md는 라우팅, 트리거 조건, 읽기 순서, 권한, 출력 및 중지 지점만 소유합니다. 전체 방법, 표, 체크리스트 및 예외는 해당 레퍼런스가 유일하게 소유하며, 주 파일은 직접 링크만 유지합니다.
쓰기 후 SKILL.md는 220줄 또는 14,000자를 초과할 수 없으며, 모든 활동 기능에 직접 도달할 수 있어야 합니다. 새 경로로 인해 예산이 초과되는 경우, 동일한 변경에서 이전 세부 사항을 마이그레이션하거나 병합해야 합니다.
예산 내에서 기존 기능, 공식 소비자 및 검증을 유지할 수 없는 경우 쓰기를 중단하고 다시 계획하며, 완료되었다고 선언할 수 없습니다.

변경 전 예방

먼저 references/change-prevention.md를 읽습니다. 이 파일이 대상 동작, 유일한 진실 공급원, 영향 그래프, 최종 인터페이스, 이전 경로 종료 및 실제 사용자 체인 승인을 담당합니다. 문제에 따라 다음을 추가로 읽습니다:

references/durable-operation-governance.md: 지속적 작업, 큐 또는 스케줄러의 경계 배치와 백로그 드레인(drain), 복구, 재시작, 배치 생성물, 또는 상주 상태 저장 서비스에서 발견 가능한 세션과 공유 리소스의 동시성 접근, 해제 및 종료.
references/task-progress-governance.md: 작업 상태, 진행률 또는 자동 재실행.
references/staged-result-governance.md: 높은 비용의 결과를 단계별로 제시, 확인, 연속 자동 실행 또는 상위 변경에 따라 무효화해야 하는 경우.
references/derived-artifact-governance.md: 동일한 결과가 여러 사양, 계획, 작업 또는 연구 산출물로 표현되고 진화 관계를 결정해야 하거나, 파생 산출물, 의미론적 캐시, 작업 단위 분할, 리소스 풀 활용 또는 반복되는 Agent 오케스트레이션과 관련된 경우.
references/ci-execution-governance.md: 프로젝트 수준 CI의 검증 계획, 실행 환경 캐시, 테스트 리소스 계층화, 시간 소모적 샤딩(sharding), 조기 실패 및 정밀 재실행.
references/runtime-generation-governance.md: 런타임 중 구성이 공유 서비스, 공급자, 스토리지 루트 또는 구성 그래프를 재구성하는 경우.
references/hard-to-reproduce-diagnostics.md: 재현하기 어렵거나, 시퀀스, 동시성, 배압(backpressure) 또는 비용이 많이 드는 전체 체인.
references/structured-data-boundary.md: 외부, 영구적, 모델, 네트워크 또는 프로세스 JSON이 여러 위치에서 구문 분석, 용량, 원자적 샤딩, 재생 커서 또는 계약 모호성을 갖는 경우.
references/model-mediated-operation-governance.md: 모델이 작업 판단, 상태 표현, 런타임 이벤트 또는 구조화된 응답에 참여하여 메시지 출처, 역할, 라우팅, 라인 요청 및 프레젠테이션 책임을 확인해야 하는 경우.
references/source-fork-and-ecosystem-adoption.md: 외부 소스 코드를 일회성 시작점으로 삼아 독립적인 제품을 구축하거나, 확장 생태계를 선택적으로 흡수하는 경우. 실제로 코드를 복사하는 경우 references/license-governance.md도 함께 읽습니다.
references/product-experience-governance.md: 제품 경험 또는 인터페이스. 디자인 또는 상호 작용 방법이 필요한 경우 references/ux-design.md를 추가로 읽습니다.

사용자가 구현을 명시적으로 승인한 경우에만 프로젝트를 수정합니다. 계획만 요청한 경우, 영향 그래프, 대상 경계, 마이그레이션 순서 및 승인 계약에서 중단합니다.

근본 원인 해결

먼저 references/root-cause-remediation.md를 읽습니다. 진단은 증거, 영향 범위 및 최종 수정 방법에서 중단합니다. 구현 시에만 모든 생산자, 경계 및 소비자를 한 번에 마이그레이션하고 이전 아키텍처를 종료합니다. 문제에 따라 다음을 추가로 읽습니다:

이 작업이 이전의 종합 감사를 인계받거나, 사용자가 해당 감사의 모든 문제를 수정하도록 명시적으로 요청하는 경우, 원래 감사 인계 원장이 완료 계약으로 계속 사용됩니다. 쓰기 전에 먼저 references/change-prevention.md를 읽고, 마지막 관련 수정 후에 references/project-audit.md로 돌아가 원래 적용 범위와 현재 수락된 계약을 기반으로 적용 범위 및 발견 원장을 다시 생성합니다. 단일 결함이 이전의 관련 없는 감사만 있다고 해서 이 체인으로 확장되지는 않습니다.

references/durable-operation-governance.md: 지속적 작업, 큐 또는 스케줄러의 경계 배치와 백로그 드레인, 복구, 또는 상주 상태 저장 서비스의 세션 접근과 해제 경쟁.
references/task-progress-governance.md: 작업 진행률 또는 지속적 상태.
references/staged-result-governance.md: 재작업이 단계별 확인 부족, 확인 대상 표류 또는 변경 사항의 잘못된 확산으로 인해 발생하는 경우.
references/derived-artifact-governance.md: 재작업이 여러 산출물 간 관계 불명확, 재생성 시 이유 손실, 전체 재계산, 잘못된 캐시 무효화, 위험한 분할, 리소스 오판 또는 오케스트레이션 왕복으로 인해 발생하는 경우.
references/ci-execution-governance.md: 프로젝트 수준 CI의 반복적인 느린 테스트, 환경 준비 낭비, 샤드 불균형, 교차 플랫폼 사전 검사 지연 또는 실패 후 차별 없는 재실행.
references/runtime-generation-governance.md: 런타임 작업이 서비스 세대, 핫 구성 트랜잭션 또는 물리적 루트 전환을 가로지르는 경우.
references/hard-to-reproduce-diagnostics.md: 재현하기 어렵거나 관찰 가능성이 낮은 문제.
references/structured-data-boundary.md: 구조화된 JSON의 인코딩, 리소스 예산, 논리적 메시지 용량, 원자적 샤딩, 재생 커서, 숫자, 스키마 또는 오류 의미론 포크.
references/model-mediated-operation-governance.md: 모델 응답, 작업 상태 또는 결과 표시가 실제 런타임과 일치하지 않거나, 모델에 실제로 전송된 요청을 찾아야 하는 경우.
references/interaction-motion.md: 시각적 계층, 변환 또는 애니메이션 소유권. 실제 실행 화면 승인이 필요한 경우 references/implementation-review.md를 추가로 읽습니다.
references/user-environment-governance.md: 도구, 경로 별칭, 실행 환경 또는 장기 작업.
references/change-prevention.md의 "계획 범위와 실제 변경 사실 분리" 계약: 이벤트, 버전, 기록 또는 캐시가 계획된 영향 범위를 실제 변경 사실로 잘못 간주하는 경우.
references/change-prevention.md의 활동 투영 업데이트 계약: 로컬 상태, 하트비트 또는 원격 측정 업데이트가 선언되지 않은 필드를 덮어쓰거나 비우거나, 소비자가 전체 스냅샷과 부분 패치를 구분할 수 없는 경우.
references/change-prevention.md의 프로젝트 실행 구성 경계: 소스, README, 스크립트, 테스트 또는 구성이 로컬 머신과 배포 사실을 하드코딩하는 경우. 사용자 머신 사실을 포함하는 경우 references/user-environment-governance.md도 함께 읽습니다.
references/architecture-cohesion-governance.md: 응집도, 결합도, 의미론적 중복 또는 갓 모듈.

외부 도구 호환성

references/external-tool-compatibility.md를 읽습니다. 호환성 관계가 프로젝트 루트 간의 공개 계약, 파생 스냅샷 또는 복합 전달 패키지를 포함하는 경우, references/change-prevention.md의 공개 계약, 계약 채택 클로저 및 교차 루트 전달 경계도 함께 읽습니다. 호환성 검사는 읽기 전용을 유지하며, 명확한 어댑터별로 계층별로 실행 가능한 산출물, 기능 계약, 호출 및 격리, 임시 입력, 업스트림 와이어 프로토콜, 구조화된 결과, 호스트 독립적 핵심 확인 및 사용자 체인을 보고합니다. 승인된 프로젝트 루트는 수리 또는 연결이 명시적으로 승인된 경우에만 수정합니다.

프로젝트 연구 및 설명

먼저 references/project-research.md를 읽습니다. 현재 질문에 답하는 데 필요한 프로젝트 표면만 읽습니다. 사용자가 전체 연구 또는 기능 채택을 명시적으로 요청하는 경우에만 적용 범위를 확장하고, 동시에 references/source-fork-and-ecosystem-adoption.md를 읽어 원래 업스트림을 추적하고 직접 재사용과 방법 학습을 구분합니다. 코드 또는 리소스를 직접 재사용할 것이라고 확인되면 references/license-governance.md도 읽어 타사 리소스와 감사 인사를 대상 프로젝트 README에 기록합니다. 효과, 실패 샘플 및 신뢰도 측정이 필요한 경우 references/project-effectiveness-review.md를 읽습니다. 검토 가능한 보고서를 저장해야 하는 경우 references/project-research-report.md를 읽습니다. 소스 코드 아카이브는 먼저 scripts/extract_project_archive.ps1과 -DestinationRoot <대상 루트> 옵션을 사용하여 독립 디렉토리에 압축 해제합니다. 대상 루트가 별도로 지정되지 않은 경우 E:\Work\BaiduSyncdisk\Code\Example을 사용합니다. 스크립트가 프로젝트 루트를 반환한 후 즉시 references/archive-safety-screening.md를 읽고 scripts/inspect_extracted_project_safety.py를 실행합니다. 이 방법이 중대한 위험 요소를 확인한 경우에만 사용자 출력에 포함하고, 그렇지 않으면 조용히 원래 연구를 계속합니다.

프로젝트 디렉토리 관리

references/repository-directory-governance.md를 읽습니다. 먼저 scripts/inspect_project_tree.py를 사용하여 읽기 전용 물리적 및 Git 증거를 얻은 다음, 각 후보 디렉토리의 공식 생산자, 경로 진실 공급원, 소비자 및 수명 주기를 확인합니다. 검사, 설명 및 계획은 증거 원장에서 중단합니다. 정리, 이동 또는 아카이브가 명시적으로 승인된 경우에만 정확한 경로를 변경하며, 삭제는 별도 승인을 계속 따릅니다. 이동이 활동 소스, 모델, 데이터, 자료, 빌드 또는 실행 진입점에 영향을 미치는 경우 references/change-prevention.md도 함께 읽습니다. 이미 이전 경로, 이중 읽기, 동기 복사본 또는 반쪽 마이그레이션이 존재하는 경우 references/root-cause-remediation.md도 읽어 소비자를 한 번에 마이그레이션하고 이전 진입점을 종료합니다.

프로젝트 베이스라인 및 템플릿

references/project-template-system.md를 읽습니다. 읽기 전용 요청은 inspect, plan 또는 verify에서 중단합니다. adopt, upgrade 또는 프로젝트 구성 쓰기는 명시적 승인이 필요하며 공식 소비자를 검증합니다.

템플릿 진화

references/template-evolution.md를 읽습니다. 먼저 후보가 여전히 현장 판단이 필요한 방법이 아닌 안정적인 기본값임을 증명한 다음, 템플릿 버전, 레지스트리, 해시, 문서 및 소비자 테스트를 동기화합니다.

제품 경험 및 인터페이스 관리

먼저 references/product-experience-governance.md를 읽은 다음, 다음 고정 진입점 및 조건부 특정 작업을 수행합니다:

인터페이스 진단, 평가, 최적화 또는 재구축 시 고정적으로 읽음: references/ux-design.md, references/interface-experience-quality.md, references/interface-problem-patterns.md, references/implementation-review.md. 수정 전에 먼저 모든 관련 창, 페이지, 패널, 오버레이, 주요 상태 및 사용자 여정을 고정합니다. 스크린샷에서 가장 눈에 띄는 로컬 문제를 전체 검토 범위로 간주할 수 없습니다.
처음부터 디자인하거나 시각적 방향 변경: references/design-method.md, references/visual-direction.md, references/surface-registers.md
레이아웃, 디자인 시스템, 상호 작용 및 애니메이션: references/layout-responsive.md, references/design-system-alignment.md, references/interface-guidelines.md, references/interaction-motion.md
참조 인터페이스 충실한 재구축: references/reference-interface-reconstruction.md
데스크톱, Tauri/Vue 또는 로컬 파일 작업 공간으로 확인된 경우, 해당 references/desktop-app-governance.md, references/tauri-vue-governance.md, references/local-file-workspace-governance.md를 읽습니다. 프로젝트 형태가 이미 확립된 경우, 현재 피드백이 색상, 간격 또는 문구만 언급했다고 해서 플랫폼 셸을 생략할 수 없습니다.
작업 상태 또는 진행률: references/task-progress-governance.md

기존 포지셔닝 또는 디자인 시스템에 의존하는 경우, 각 작업당 최대 한 번 scripts/context.mjs를 실행합니다. 참조 인터페이스를 충실히 재구축할 때는 assets/reference-reconstruction/component-spec.md가 컴포넌트 사양을 담당합니다.

저장소 생성 및 게시

references/repository-publication.md를 읽습니다. 초기화, 커밋, 원격 생성, 푸시, 가시성, 검사 및 배포를 구분합니다. 각 단계는 이미 승인된 중지 지점까지만 실행하며, 상태 변경 전후에 정확한 저장소 ID, 인덱스, 브랜치, 원격 및 동시 변경 사항을 확인합니다.

README 및 홈페이지

먼저 references/readme-delivery.md를 읽고, 하나의 전달 원장을 사용하여 Git 경계, README, 본문, 비주얼, 다국어, 라이선스, Star History, GitHub Topics, 저장소 메타데이터, 검증 및 중지 지점을 확인합니다. 읽기 전용 요청은 동일한 원장에서 중단하며, 최적화, 재작성 또는 전체 처리가 명시적으로 요청된 경우에만 구현합니다. 그런 다음 references/content-architecture.md를 읽습니다. 전체 최적화 또는 로고, 히어로(hero)와 관련된 경우 references/visual-direction.md를 읽고, 먼저 코드 우선의 공식 ID 소스 조사를 완료한 다음 필요에 따라 references/project-native-hero.md와 references/github-readme-canvas.md를 읽습니다. 다국어, 개인 진입점 또는 저장소 상태 영역이 필요한 경우 assets/readme-profile/profile.json을 읽고, scripts/readme_header.py는 실제 파일, 저장소 ID, 라이선스 및 명확하게 파싱된 프로젝트 탐색을 사용합니다. 기존 공개 GitHub 저장소의 전체 README 최적화는 Star History와 Topics를 모두 기본 전달 항목으로 포함합니다: Star History는 references/github-star-history.md와 references/repository-publication.md를 읽고, Topics는 scripts/github_topics.py를 통해 쓰고 다시 읽습니다. 사용자가 명시적으로 제외하거나 대상이 객관적으로 적용되지 않는 경우를 제외하고, 실제 소비자 중 하나라도 누락된 성공적인 결과는 전체 전달을 완료할 수 없습니다. 필요에 따라 선택:

references/svg-production.md, references/hybrid-svg-production.md: SVG 및 혼합 비주얼
references/motion-production.md: 애니메이션
references/platform-guidelines.md: 플랫폼 경계
references/github-star-history.md: 자체 호스팅 Star History의 특수 진단 또는 연결. 실패 원인 또는 현재 상태만 묻는 경우 읽기 전용 유지, 구현 시 정확하게 커밋하고 호출 저장소 변경 사항을 푸시하고, 수동으로 워크플로우를 실행한 다음 API, 생성기, 출력 브랜치, raw SVG 및 README 소비 측의 실제 링크를 따라 승인합니다.

README는 각 내부 거버넌스 규칙의 두 번째 활동 진실 공급원이 아닙니다. 자기 진화는 공개 ID, 독자 경로, 주요 진입점 또는 유지 관리 탐색을 변경할 때만 README를 업데이트합니다. 완료 후 scripts/audit_readme.py를 실행하고 실제 렌더링 표면에서 확인합니다.

라이선스 관리

먼저 references/license-governance.md를 읽습니다. 사용자가 구체적인 계획을 확인한 후에 references/license-rollout.md를 읽고 구현합니다. 읽기 전용 요청은 내용 경계, 타사 종속성 및 계획 비교에서 중단합니다.

인간 친화적 로깅

references/log-audit-standard.md를 읽습니다. 하나의 실제 작업을 따라 생성, 컨텍스트, 저장, 읽기 및 최종 조회 결과를 확인합니다. 예쁜 예제 하나로 전체 이벤트 체인을 대체하지 않습니다.

사용자 환경 프로필 및 실행 환경

references/user-environment-governance.md를 읽습니다. 프로필 스키마는 assets/user-environment/profile.schema.json이 담당하고, 결정적 작업은 scripts/user_environment_profile.py가 담당합니다. inspect, plan, verify 및 resolve는 각각 해당 읽기 전용 또는 소비 경계를 유지합니다. apply --write는 명시적인 프로필 쓰기 권한이 필요하며, 설치, 다운로드 또는 시스템 설정 수정을 자동으로 승인하지 않습니다.

프로젝트 종합 감사

references/project-audit.md를 읽습니다. 사용자가 구현 계획 완료도를 묻는 경우, 먼저 원래 계획에서 항목별 적합성 원장을 설정합니다. 수리가 승인된 후에는 원래 계획과 현재 수락된 계약을 기반으로全新的 재검사를 다시 생성해야 하며, 이전 완료 표시를 그대로 사용하거나 기존 테스트에서 계획 범위를 역추론해서는 안 됩니다. 전체 검사는 먼저 프로젝트 형태에 따라 모든 적용 가능한 차원의 적용 범위 원장을 설정한 다음, 이러한 차원에서 요구하는 특정 작업을 로드합니다. 이미 발견된 문제만으로 검토 범위를 채워서는 안 됩니다. 읽기 전용 감사는 자동으로 거버넌스를 수행하지 않습니다. 사용자 효과 평가가 필요한 경우 references/project-effectiveness-review.md를 추가하고, 작업 경험 확인이 필요한 경우 references/task-experience-audit.md를 추가합니다.

플랫폼 템플릿 리소스

해당 프로젝트 유형을 처리할 때 필요에 따라 읽습니다:

references/desktop-app-governance.md: 데스크톱 애플리케이션
references/tauri-vue-governance.md: Tauri v2 + Vue
references/local-file-workspace-governance.md: 로컬 파일 작업 공간

이러한 리소스는 활동 방법이며, 프로젝트가 이미 템플릿을 채택했음을 의미하지는 않습니다. 명시적으로 채택되고 공식 소비자가 읽은 .project-steward/project.json만이 프로젝트 템플릿 상태를 구성합니다.

출력 및 완료

출력은 먼저 결론을 제시한 다음, 범위, 증거, 알려지지 않은 항목 및 다음 동작을 설명합니다. 분석은 이미 구현된 것처럼 작성해서는 안 됩니다. 구조 검사는 실제 사용자 체인이 확립된 것처럼 작성해서는 안 됩니다. 현재 작업 동작 확인은 독립적인 콜드 스타트가 이미 입증된 것처럼 작성해서는 안 됩니다.

영향 그래프가 있는 경우, 최소한 생산자, 전송 또는 저장 경계, 소비자, 최종 사용자 결과, 유일한 진실 공급원, 이전 경로 종료 조건 및 승인 진입점을 포함해야 합니다. 여러 이력 결과와 관련된 경우, 각각의 주요 원인, 성공 메커니즘, 능력 격차, 공식 소유자 및 검증 수준을 보고합니다.

활성 라우팅, 해당 방법, 공식 소비자, 결정적 테스트 및 이번 라운드에서 승인된 실제 사용자 체인이 모두 일치한 경우에만 완료를 보고합니다.

Project Steward

Project Steward란 무엇인가요?

즐겨 사용하는 AI에게 물어보기

문서