## 대상 저장소 - git-ranker-workflow ## 문제 / 배경 - Harness workflow가 SDD와 소크라테스 질문 흐름을 문서로는 설명하고 있었지만, runtime 차원에서는 placeholder 제거 수준만 검증해서 실제 승인 강제력이 약했습니다. - git hook 파일은 있었지만 `core.hooksPath=.githooks` 활성화가 자동 보장되지 않아 로컬 자동 검증이 빠질 수 있었습니다. - AGENTS.md와 runbook/runtime 문서에도 현재 헌법보다 과거 구조 설명이나 약한 승인 문구가 남아 있었습니다. ## 왜 지금 필요한가요? - 추가 요구사항이 계속 들어오는 기존 프로젝트에서 Harness가 일관되게 `질문 -> 승인 -> phase -> 구현 -> 검증 -> review` 흐름을 강제해야 automation 신뢰도를 유지할 수 있습니다. ## 완료 조건 / 기대 결과 - [ ] `approve`가 `spec.md`의 section 존재뿐 아니라 `Q/A/Decision` 형식의 소크라테스 로그를 검증하고 `task.json.intake`를 잠근다. - [ ] `plan`이 현재 `spec.md`와 locked intake가 어긋나면 차단된다. - [ ] `status`가 spec readiness를 JSON으로 노출한다. - [ ] `init`가 `.githooks` 활성화를 보장하고 `doctor`가 hooksPath를 점검한다. - [ ] AGENTS.md, docs, skills, tests가 같은 계약으로 정렬된다. ## 이번 이슈에서 다루는 것 - structured intake 도입 - approval/plan/status runtime 검증 강화 - hooksPath 자동 설정 및 doctor 보강 - AGENTS/docs/skills 정리 - 관련 CLI 테스트 추가 ## 이번 이슈에서 다루지 않는 것 - 대상 앱 저장소의 도메인 코드 변경 - 새로운 top-level workflow 디렉터리 체계 도입 - 별도 execute.py 추가 ## 영향 / 의존성 - 새 라이브러리: 없음 - 선행조건: 없음 - 운영 영향: Harness 로컬 검증과 spec 승인 절차가 더 엄격해집니다. ## 리스크 / 확인이 필요한 점 - 기존 수동 운영 습관과 달리 `approve` 재실행이 필요해지는 지점이 생길 수 있습니다. - 문서와 runtime 검증이 다시 어긋나지 않도록 테스트와 doctor를 함께 유지해야 합니다.
대상 저장소
문제 / 배경
core.hooksPath=.githooks활성화가 자동 보장되지 않아 로컬 자동 검증이 빠질 수 있었습니다.왜 지금 필요한가요?
질문 -> 승인 -> phase -> 구현 -> 검증 -> review흐름을 강제해야 automation 신뢰도를 유지할 수 있습니다.완료 조건 / 기대 결과
approve가spec.md의 section 존재뿐 아니라Q/A/Decision형식의 소크라테스 로그를 검증하고task.json.intake를 잠근다.plan이 현재spec.md와 locked intake가 어긋나면 차단된다.status가 spec readiness를 JSON으로 노출한다.init가.githooks활성화를 보장하고doctor가 hooksPath를 점검한다.이번 이슈에서 다루는 것
이번 이슈에서 다루지 않는 것
영향 / 의존성
리스크 / 확인이 필요한 점
approve재실행이 필요해지는 지점이 생길 수 있습니다.