ai-workflow-harness v1.2.0

ai-workflow-harness v1.2.0 (2026-06-14)

이번 릴리즈는 하네스를 실제 프로젝트에 적용하고, Claude Code·Codex·Cursor 같은 여러 AI 도구와 함께 오래 운영할 때 더 안정적으로 굴러가도록 다듬은 릴리즈입니다.

신규 프로젝트 부트스트랩, source-gitflow 기반 협업, 릴리즈 전 점검 흐름을 중심으로 정리했습니다.

🚀 주요 변경 사항 (Key Changes)

• 신규 프로젝트 온보딩 흐름 보강: /session-start, docs/BOOTSTRAP.md, 온보딩 가이드의 역할을 정렬해 빈 저장소에서 실제 개발 컨텍스트로 넘어가는 과정을 더 안정적으로 만들었습니다.
• source-gitflow 협업 흐름 보강: 다인 기여자 환경을 시뮬레이션해 후속 기여자의 저장소 clone, Git hook 설치와 동작, feature branch 개발 경로를 검증하고 보완했습니다.
• 릴리즈 전 점검 절차 정리: develop → main 병합 전에 상태 파일, Work archive, scaffold 생성 결과, 온보딩 흐름, hook 동작, 문서 정합성을 함께 확인하는 release-prep 절차를 마련했습니다.
• 릴리즈 gate와 검증 결과 연결: Public Clean Baseline Gate에 Validation spine과 Surface sweep evidence를 추가해, 릴리즈 직전 deterministic 검증과 수동 점검 결과를 PR에 남기도록 했습니다.

✨ 신규 기능 및 추가 사항 (Features)

• 하네스 자체 점검 스크립트: 구문 오류, scaffold 생성 결과, DR 링크, 기본 템플릿 drift, command-skill 매칭을 자동으로 확인하는 스크립트를 추가했습니다.
• 온보딩 및 hook 통합 테스트: generic/source-gitflow scaffold, optional pack, 기존 프로젝트 overlay 환경을 실제로 생성해 핵심 파일과 branch protection 동작을 확인합니다.
• release-prep 브랜치 절차 표준화: 릴리즈 전 version/tag 관계, STATUS/PLAN release target, archive 상태, release note 초안을 확인하도록 문서화했습니다.
• Adopter 후속 작업 정리: kyungseo/ai-deck-compiler 실제 upgrade walkthrough와 첫 concrete product planning-pack exercise를 다음 적용 후보로 정리했습니다.

🔧 개선 사항 (Improvements)

• W1 Validation: 하네스 변경 후 깨질 수 있는 부분을 더 빨리 발견할 수 있도록 검증 명령과 테스트 기준을 정리했습니다.
• W2 Adopter Transition: 신규 적용, 기존 프로젝트 upgrade, 두 번째 contributor onboarding, product planning pack 기준을 정리하고 source repo와 adopter/project 자산의 경계를 더 명확히 했습니다.
• W3 Workflow IA Diet: workflow 문서와 command family를 가볍게 정리했습니다. core 문서에는 주요 entry point를 남기고, 상세 검증과 운영 절차는 maintainer 문서와 workflow별 문서로 나누었습니다.
• W4 Enforcement & Lifecycle: branch isolation, protected workflow surface, archive 누적 정책, runner/CI 연동 판단을 정리해 develop/main에서 중요한 workflow 파일을 실수로 직접 수정할 위험을 줄였습니다.
• 일상 점검 흐름 개선: /repo-health가 검증 runner 결과를 직접 재구현하지 않고 호출·해석하도록 정리해, 자동 검증과 사람이 읽는 health report의 역할을 더 분명히 했습니다.
• W5 Future / Optional: Spring Boot MSA option-pack, project-state template, CLI naming 같은 확장 후보를 실제 수요 확인 후 진행할 항목으로 분리했습니다.

🐛 버그 수정 (Bug Fixes)

• default template이 canonical 파일과 조용히 어긋날 수 있던 문제를 감지하도록 보강했습니다.
• source-gitflow scaffold와 Cursor workflow template에서 생길 수 있던 drift 문제를 수정했습니다.
• archive된 Work 파일 중 일부가 Archived가 아니라 Done 상태로 남아 있던 lifecycle 오류를 바로잡았습니다.
• release PR body와 GitHub Release note 초안이 같은 템플릿을 따르도록 release note 작성 기준을 연결했습니다.

⚠️ 마이그레이션 가이드 (Migration Notes)

• 새로 생성되는 scaffold는 1.2.0 기준의 manifest/version을 기록합니다.
• 기존 프로젝트 대상의 자동 마이그레이션 도구는 아직 제공되지 않습니다. upgrade가 필요하면 maintainer migration note와 upgrade walkthrough 기준을 따라 local 변경사항과 하네스 변경사항을 수동으로 분리해 확인해야 합니다.
• source-gitflow를 사용하는 프로젝트는 hook 설치, branch protection, release flow가 현재 프로젝트 운영 방식과 맞는지 확인하는 것을 권장합니다.

✅ 검증 (Validation)

이번 release-prep branch에서 아래 검증을 통과했습니다.

bash scripts/tests/run-harness-checks.sh --all
bash scripts/tests/check-onboarding-flows.sh
bash -n scripts/create-harness.sh
bash scripts/create-harness.sh --dry-run --profile generic release-dry-run-generic temp/harness-tests/release-dry-run-generic
bash scripts/create-harness.sh --dry-run --workflow source-gitflow release-dry-run-source-gitflow temp/harness-tests/release-dry-run-source-gitflow
git diff --check