tjboudreaux/ready-agent-1

에이전트 준비도 수정

안전한 변경만 적용하여 저장소의 준비도를 높입니다. 엔진은 설정 스캐폴드를 계획하고 작성하며, 사용자는 git을 처리하고 모든 산문(prose)을 작성합니다. 세 가지 버킷, 세 가지 다른 안전 수준.

단계

1. 보고서가 존재하는지 확인합니다. .agents/readiness/latest.json 파일이 없으면 먼저 ra1-report 스킬을 실행하세요.

2. 무엇이 변경될지 확인하기 위해 드라이런을 수행합니다:

   python3 "$(dirname "$0")/scripts/readiness/cli.py" fix --project <repo-path>
   

   세 가지 버킷이 출력됩니다: 자동 적용(안전한 설정 스캐폴드), 제안(검토용 초안), GitHub 설정(수동).

3. 먼저 로컬 브랜치를 생성합니다 (기본 브랜치에서는 작업하지 마세요):

   git -C <repo-path> checkout -b readiness/fixes
   

4. 안전한 스캐폴드를 적용합니다 (멱등성 보장; 작업 트리가 더티(dirty)하면 거부하며, 비어 있지 않은 파일을 절대 덮어쓰지 않음):

   python3 "$(dirname "$0")/scripts/readiness/cli.py" fix --project <repo-path> --apply
   

5. "제안" 항목을 직접 작성하세요 — README 섹션, 맞춤형 AGENTS.md, 런북, 첫 번째 테스트. 사용자가 검토할 초안으로 작성해야 하며, 코드베이스에 대한 사실을 지어내지 마세요. templates/AGENTS.md는 시작 템플릿입니다 — 저장소가 실제로 하는 일을 토대로 채워 넣으세요.

6. 차이점을 보여주고 로컬에서 커밋합니다. 변경 사항을 요약한 후 다음을 실행:

   git -C <repo-path> add -A && git -C <repo-path> commit -m "chore: raise agent readiness"
   

   커밋 메시지 끝에 필수 Co-Authored-By 트레일러를 추가하세요.

7. ra1-report를 다시 실행하여 레벨 변화를 확인합니다.

계약 (위반 금지)

• 명시적인 사용자 확인 없이는 절대 푸시하거나 PR을 열지 마십시오. 먼저 로컬에서 빌드하고 커밋하세요.
• 설정 스캐폴드만 자동 적용합니다. README/AGENTS.md/테스트/런북은 사용자가 검토하는 제안된 초안입니다 — 산문을 자동으로 작성하면 "허구를 문서화"할 위험이 있습니다.
• GitHub 설정 변경(브랜치 보호, 시크릿 스캐닝, 레이블)을 코드 커밋과 묶지 마세요. 사용자가 실행하고 확인할 gh 명령어 체크리스트로 제공하세요.
• 더티 작업 트리를 존중하세요: 묻지 않고 커밋되지 않은 작업 위에 --force를 사용하지 마십시오.