Skip to content

ai-workflow-v1.0.7 — 스캐폴드 정합성, 병렬 작업 제어, README 현행화

Choose a tag to compare

View all tags
@kyungseo kyungseo released this 28 May 12:55
· 267 commits to main since this release
ai-workflow-v1.0.7
ca1435c
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

ai-workflow-v1.0.7 — 스캐폴드 정합성, 병렬 작업 제어, README 현행화

이번 릴리즈는 실제 scaffold 사용자 흐름에서 발견된 정합성 문제를 보완하고, 병렬 작업 운영 규칙과 public-facing 설명을 다듬은 패치 릴리즈입니다.

기존 repository는 영향 없음. 이미 scaffold된 프로젝트에는 별도 작업이 필요하지 않습니다.
새로 scaffold하는 경우에만 이번 보완이 적용됩니다.

주요 변경

  • 병렬 branch / agent 작업 시 발생할 수 있는 충돌 해소 모델을 문서화했습니다.
  • core workflow 문서가 다시 비대해지지 않도록 slice & pointer 작성 원칙을 추가했습니다.
  • scaffold 생성물의 STATUS.md, foundational DR 참조, health 점검 기준을 실제 사용 흐름에 맞게 보정했습니다.
  • README의 협업 구조 다이어그램과 설명 문구를 현행 워크플로우에 맞게 정리했습니다.

스캐폴드 정합성 보완

  • create-harness.sh가 생성물에 필요한 foundational DR을 함께 복사하도록 수정했습니다.
    • DR-007-language-policy.md
    • DR-008-docs-filename-standard.md
    • DR-013-work-file-spec.md
  • HARNESS-PARALLEL-WORK-CONTROLS.md가 scaffold output에 포함되도록 보완했습니다.
  • 생성되는 STATUS.md의 Active Work 표를 실제 운영 형식과 맞췄습니다.
    • ID | Title | Work File
  • 생성되는 STATUS.md에 Work Context Rule을 추가해 첫 세션에서 읽어야 할 섹션을 명확히 했습니다.
  • Current State 표 헤더를 Field | Value로 정리했습니다.

병렬 작업 제어

  • docs/HARNESS-PARALLEL-WORK-CONTROLS.md를 추가했습니다.
  • 다음 충돌 유형에 대한 manual-first 해소 기준을 문서화했습니다.
    • Work ID 충돌
    • STATUS / Work index merge conflict
    • DR 번호 충돌
    • command / skill mirror drift
    • scaffold drift window
  • Work ID, branch naming, DR 번호 확인 흐름을 병렬 작업 환경에 맞게 보강했습니다.

Slice & Pointer 원칙

  • 긴 조건부 runbook이나 checklist는 core 문서에 직접 쌓지 않고 별도 slice 문서로 분리하도록 기준을 추가했습니다.
  • HARNESS-PROTOCOL.md는 상세 절차를 모두 담는 문서가 아니라 routing hub 역할을 유지하도록 정리했습니다.
  • 관련 원칙을 BEHAVIOR-PRINCIPLES, AGENT-WORKFLOW, tool rule surface에 반영했습니다.

Health / Validation

  • /health command와 Codex skill의 Active Work 점검 문구를 최신 STATUS 형식에 맞게 수정했습니다.
  • Active Work 점검 기준을 제거된 Priority / Status 컬럼이 아니라 Active Work pointer / Work file frontmatter 정합성 중심으로 조정했습니다.

문서 현행화

  • HARNESS-STRUCTURE.md에 conditional policy slice, branch/release surface, scaffold flow, source/product repo boundary를 반영했습니다.
  • HARNESS-MAINTAINER-GUIDE.md에 최신 Work 파일 규칙과 slice & pointer 작성 원칙을 보강했습니다.
  • README의 다이어그램과 설명을 현재 협업 구조에 맞게 다듬었습니다.

참고

이번 릴리즈는 여전히 manual-first 운영 모델을 유지합니다. 이미 scaffold된 repository를 자동 upgrade하는 기능은 포함하지 않으며, adoption / upgrade model은 별도 작업으로 검토할 예정입니다.

Assets 2
Loading