Repo Cleaner
좋은 프로젝트의 목적, 증거, 첫 번째 유용한 행동을 쉽게 찾을 수 있도록 만듭니다. 애플리케이션 동작은 유지하면서 저장소 표면을 개선합니다.
1. 브리핑 설정
- 저장소, 대상 독자, 원하는 결과, 언어, 감사(audit)와 구현(implementation)을 구분합니다. 이미 부여된 권한을 재사용합니다.
- 해당되는 지침, README, 연결된 가이드, 라이선스, 패키지/스킬 매니페스트, 예제, 애셋, 현재 GitHub 메타데이터를 읽습니다. 주장과 명령을 확인하기 위해 필요한 경우에만 소스를 검사합니다.
- 작업 트리를 검사하고 관련 없는 변경 사항, 기존 라이선스, 귀속(attribution)을 유지합니다. 가시성(visibility) 변경이 명시적으로 승인되지 않는 한 변경하지 않습니다.
- 빠진 사실이나 결과에 영향을 미치는 선택(대상 독자, 상충하는 브랜딩, 사용 불가능한 접근, 불확실한 설치, 의미 있는 리브랜딩)에 대해 집중된 질문을 합니다. 일상적인 레이아웃 선택은 프로젝트에서 해결합니다. 기다리는 동안 독립적으로 작업을 계속하며, 질문을 피하기 위해 사실을 지어내지 않습니다.
- 작업 브리핑이 도움이 되는 경우 assets/repo-brief.md를 사용하되, 모든 대상 저장소에 추가하지는 마십시오.
2. 독자 경로 감사
references/audit-and-validation.md를 읽습니다. 발견 → 첫 화면 → 증거 → 설치 → 첫 번째 성공 → 심화 도움말 순서로 추적합니다.
증거와 우선순위를 포함한 소수의 가장 영향력 있는 격차를 나열합니다. 사실적 문제와 취향 선택을 분리합니다. 제거할 잡동사니를 포함합니다. 누락된 정보와 도구에 대해 사용 불가능한 정보를 구분합니다. 감사 전용 작업의 경우, 파일이나 설정을 편집하지 않고 결과와 구체적인 권장 사항을 반환합니다.
3. 일관된 프레젠테이션 구축
references/readme-and-visuals.md를 읽습니다. 기본적으로 GitHub 네이티브 문서 스타일, 표준 플랫 배지, 일반 탐색 링크, 프로젝트별 증거를 사용합니다. 요청되지 않는 한 작성자의 개인 프로필 미학을 재사용하지 마십시오. 구조를 선택하거나 참조 저장소에서 학습할 때 references/readme-patterns.md를 읽습니다. 프로젝트에 적합한 방향을 선택한 후, 프로젝트를 이해하고 사용할 수 있게 만드는 가장 작은 완전한 애셋 및 문서 세트를 구현합니다.
- 구체적인 약속, 유용한 시각적 증거, 명확한 첫 번째 행동으로 시작합니다. 필수 정보는 실제 텍스트로 유지합니다.
- 유용할 때만 배너를 추가합니다. 장식적인 브랜딩보다는 구체적인 작업, 실제 출력, 유용한 데모를 선호합니다. 실제 출력에서 스크린샷을 캡처합니다. 개념, 픽스처, 재구성, 로컬 프리뷰를 정확하게 레이블링합니다.
- 작동하는 대상과 입증된 주장이 있는 절제된 배지 행을 추가합니다.
- README에 가장 짧은 검증된 설치 및 사용 예제를 유지합니다. 더 긴 플랫폼 가이드, 문제 해결, 예제는 중복하지 않고 링크합니다.
- 애플리케이션 소스를 이동하거나 런타임/빌드 동작을 변경하지 않고 공개 문서와 애셋을 구성합니다. 문서를 이동할 때 링크를 업데이트합니다.
- 문서 깊이를 프로젝트에 맞춥니다. 일반적인 마케팅 카피, 반복되는 태그라인, 강제된 기능 테이블, 채우기 섹션, 배지 벽, 장식적인 다이어그램, 빈 폴더 계층을 제거합니다. 프로젝트의 특정 목소리를 유지합니다.
스킬 저장소의 경우, 설치 가능한 폴더에 SKILL.md와 모든 참조된 리소스가 포함되어 있는지 확인합니다. 해당 패키지를 공개 마케팅 문서와 분리합니다. 호스트별 정확한 검색 경로, 호출 예제, 사전 요구 사항, 도구 요구 사항을 문서화합니다. 각 경로가 런타임 테스트되었는지, 호스트 문서에 대해 확인되었는지, 또는 수동으로만 사용 가능한지 명시합니다. 일반 스킬 폴더에서 플러그인, 마켓플레이스 목록 또는 범용 에이전트 지원을 추론하지 마십시오.
4. 진실된 메타데이터로 검색 가능성 개선
references/github-discovery.md를 읽습니다. 간결한 About 텍스트, 가능한 경우 유용한 실제 홈페이지, 증거 기반 토픽, 소셜 프리뷰 애셋을 제안합니다. 적용하기 전에 현재 GitHub 제한을 확인합니다.
적절한 도구를 사용하여 승인된 설정을 적용하고, 관련된 기존 값을 유지합니다. 도구에 작업이 없는 경우, 정확한 값과 설정 링크를 준비합니다. 적용됨(applied), 준비됨(prepared), **차단됨(blocked)**을 구분합니다. 커밋된 메타데이터 파일이나 소셜 이미지는 GitHub를 구성하지 않습니다. 승인 없이 가시성을 변경하거나, 다른 사람에게 연락하거나, 프로모션 목록을 제출하지 마십시오.
5. 검증 및 인계
감사 참조를 사용하여 독자 경로를 검증합니다: 링크 및 앵커, 이미지, 안전한 빠른 시작, 진실된 배지 및 호환성, 데스크톱/모바일, 라이트/다크, 최종 diff, 설정 읽기. 도구 또는 네트워크 한계를 명시적으로 보고합니다. 나중에 업데이트가 실용적이도록 소스 애셋을 저장합니다.
승인된 경우에만 커밋하거나 푸시하고, 대상 저장소의 워크플로를 따릅니다. 대상을 확인하고 최종 리비전을 확인합니다. 변경 사항, 검증, 적용되지 않은 설정, 남은 소수의 작업을 요약합니다. 트래픽, 별표, 순위 또는 테스트되지 않은 지원을 약속하지 마십시오.