Skip to content

[Task] Harness runtime과 SDD 승인 흐름 강제력 보강 #93

@alexization

Description

@alexization

대상 저장소

  • git-ranker-workflow

문제 / 배경

  • Harness workflow가 SDD와 소크라테스 질문 흐름을 문서로는 설명하고 있었지만, runtime 차원에서는 placeholder 제거 수준만 검증해서 실제 승인 강제력이 약했습니다.
  • git hook 파일은 있었지만 core.hooksPath=.githooks 활성화가 자동 보장되지 않아 로컬 자동 검증이 빠질 수 있었습니다.
  • AGENTS.md와 runbook/runtime 문서에도 현재 헌법보다 과거 구조 설명이나 약한 승인 문구가 남아 있었습니다.

왜 지금 필요한가요?

  • 추가 요구사항이 계속 들어오는 기존 프로젝트에서 Harness가 일관되게 질문 -> 승인 -> phase -> 구현 -> 검증 -> review 흐름을 강제해야 automation 신뢰도를 유지할 수 있습니다.

완료 조건 / 기대 결과

  • approvespec.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를 함께 유지해야 합니다.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions