가이드 · specification handoff

Agent가 만든 기술 명세 전달하기

spec은 assumptions를 검증하고 어느 revision이 승인됐는지 알 수 있어야 implementation contract가 됩니다.

업데이트 2026년 8월 3일실전 가이드

decision-ready 구성

  1. problem·users·non-goals
  2. current evidence
  3. proposed behavior·public contracts
  4. data·permissions·failure semantics
  5. migration·rollback·risks·open questions
  6. requested authority

facts와 proposals 분리

current system, proposed change, roadmap idea를 같은 확신으로 쓰지 않습니다.

candidate review

local validation 뒤 --review로 게시하고 변경 요청은 source로 돌아가 재제출합니다.

ow a2ui draft check ./spec
ow a2ui draft build ./spec
ow a2ui digest ./spec/document.mdw
ow publish ./spec/document.mdw --review --no-open --timeout 900

구현을 approved revision에 연결

task와 release evidence는 fixed version을 참조하고 material scope change는 다시 review합니다.

FAQ

자주 묻는 질문

구현은 canonical과 version 중 무엇을 참조하나요?

contract에는 approved version, 최신 공식 상태 조회에는 canonical을 씁니다.

Agent가 스스로 승인할 수 있나요?

OpenWiki review는 명시적인 사람 결정을 전제로 합니다.

실제 워크플로 사용

에이전트가 만든 작품을 발표하세요.

리포트, 문서, 계획마다 독자를 위한 페이지를 만들고 코멘트, 검토 결정, 공식 개정을 에이전트에게 돌려보내세요.