Skip to content

feat: 하네스 control plane을 구조화된 SDD 런타임으로 고도화#94

Merged
alexization merged 5 commits into
developfrom
feat/93-harness-runtime-hardening
Apr 16, 2026
Merged

feat: 하네스 control plane을 구조화된 SDD 런타임으로 고도화#94
alexization merged 5 commits into
developfrom
feat/93-harness-runtime-hardening

Conversation

@alexization

@alexization alexization commented Apr 16, 2026

Copy link
Copy Markdown
Owner

Summary

  • Harness control plane을 문서 중심 설명에서 runtime-enforced workflow로 옮기면서 approve -> plan -> run -> verify -> review 흐름의 강제력을 높였습니다.
  • spec.md의 소크라테스 질문 로그를 Q/A/Decision 형식으로 검증하고, 승인 시 task.json.intake에 구조화된 intake를 잠그도록 바꿨습니다.
  • .githooks, workflow runtime, doctor, docs, skills, tests를 함께 정리해 로컬 자동 검증과 문서 계약이 같은 규칙을 가리키도록 맞췄고, git-ranker 서브모듈 포인터도 fc85948b까지 올렸습니다.

Linked Issue

How

  • scripts/workflow_runtime/를 추가해 CLI, state machine, validation, guard, doctor 로직을 분리하고 workflow.py를 안정적인 entrypoint로 고정했습니다.
  • approve, plan, status에 structured intake, spec readiness, spec/intake sync 검증을 추가했습니다.
  • initcore.hooksPath=.githooks를 맞추고, doctor가 hooksPath와 핵심 문서 marker를 검사하도록 강화했습니다.
  • AGENTS.md, docs/*, workflow-local skills, GitHub template, ignore rule을 새 contract에 맞게 재작성하고 불필요한 legacy 문서/skill/spec tree를 제거했습니다.
  • .githooks/pre-push를 보정해 active task가 없을 때는 dangerous command check만 수행하고 일반 브랜치 push를 막지 않도록 했습니다.
  • git-ranker gitlink를 backend origin/developfc85948b로 갱신해 최신 backend baseline을 함께 가리키도록 맞췄습니다.

Validation Summary

  • python3 scripts/workflow.py init
  • python3 scripts/workflow.py doctor
  • python3 scripts/workflow.py status --check
  • python3 -m unittest discover -s tests -v
  • .githooks/pre-push origin feat/93-harness-runtime-hardening
  • git diff --cached --check
  • git diff --cached --submodule=log -- git-ranker

Reviewer Focus

  • structured intake와 Q/A/Decision 검증이 사용자가 원하는 SDD/Socratic 승인 흐름을 충분히 강제하는지 봐 주세요.
  • AGENTS.md, docs/runtime.md, docs/runbook.md, skill 문서가 같은 workflow 계약을 일관되게 설명하는지 봐 주세요.
  • .githooks/pre-push, init, doctor 조합이 로컬 자동 검증 경로를 실제로 보장하는지 봐 주세요.
  • git-ranker 서브모듈 포인터가 의도한 backend 커밋 fc85948b를 정확히 가리키는지 봐 주세요.

Impact / Risks

  • 새 라이브러리, 외부 서비스, 스키마, 설정, 환경 변수, 마이그레이션: 없음
  • 사용자나 운영에 영향이 있으면 적어 주세요: Harness spec 승인과 local hook enforcement가 더 엄격해지고, workflow repo가 최신 backend baseline을 함께 가리킵니다.
  • 배포, 롤백, 커뮤니케이션 시 주의점이 있으면 적어 주세요: 기존 docs/specs, docs/operations, docs/architecture, legacy skill 경로를 참조하던 개인 메모나 외부 문서는 업데이트가 필요하고, submodule checkout 사용자도 git submodule update --init --recursive가 필요할 수 있습니다.
  • 남아 있는 리스크와 후속 작업: doctor의 문서 marker 기반 검증은 최소 정합성 검증이므로, 향후 runtime contract가 더 복잡해지면 더 구체적인 문서/skill drift 테스트가 필요할 수 있습니다.

- spec 승인 시 structured intake와 소크라테스 Q/A/Decision 검증 추가
- init, doctor, hook runtime으로 자동 검증 경로와 guard 강제력 보강
- AGENTS, docs, skills, tests를 새 workflow 계약에 맞춰 정리
- .githooks/pre-push를 실행 가능 상태로 수정
- git push 시 local hook이 실제로 동작하도록 정리
- pre-push wrapper에서 pre_command를 항상 먼저 검사
- active task가 없으면 verification guard를 생략하고 종료
- git-ranker 포인터를 fc85948b까지 반영
- backend unit test baseline과 서비스 계층 테스트 도입 커밋을 연결

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 6d23d05dad

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread workflows/system/hooks.json Outdated
Comment thread scripts/workflow_runtime/engine.py
- git push -f와 short force flag를 dangerous command guard에서 차단
- task_id 경로 검증을 추가해 task 디렉터리 path traversal을 방지
- 관련 CLI 회귀 테스트를 추가
@alexization alexization merged commit 50b41b4 into develop Apr 16, 2026
1 check passed
@alexization alexization deleted the feat/93-harness-runtime-hardening branch April 16, 2026 01:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant