WIGTN Plugin for Codex

Claude Code 플러그인을 그대로 Codex로 옮기면 플랫폼의 강점을 오히려 가릴 수 있었습니다. Codex는 저장소 탐색, 구현 판단, 기본 검증을 이미 자율적으로 수행하므로 고정된 에이전트 fan-out과 긴 절차를 항상 강제할 이유가 없었습니다. 반면 PRD의 필수 항목, 요구사항과 테스트 증거의 연결, source drift 이후 상태 무효화, commit·push·PR 권한처럼 틀리면 위험한 경계는 모델의 재량만으로 두기 어려웠습니다. 그래서 포팅이 아니라 Codex에 맞는 얇은 제품 개발 계약으로 다시 설계했습니다.

AI 개발 하네스는 많이 넣을수록 좋아 보이지만, 실제 평가에서는 일반 구현에 무거운 절차를 씌울수록 같은 결과에 더 많은 token과 시간이 들 수 있었습니다. 또 “검증됨”이라는 말이 실행 테스트 없이 만들어지거나, 사용자의 “확인해줘”를 commit·push 권한으로 확대 해석하는 문제가 있었습니다. 핵심은 모델을 더 통제하는 것이 아니라, 필요한 순간에만 결과 형태·상태 전이·증거·권한을 정확히 고정하는 일이었습니다.

• Heavy workflow 비용 — 일반 구현까지 긴 절차로 감싸면 token·latency 증가
• Evidence integrity — 실행 검사 없이 `verified`를 주장할 위험
• Authority ambiguity — 검토 요청을 commit·push·PR 권한으로 확대할 위험

일반 코딩은 Codex에 맡기고, 사용자의 의도가 PRD·화면정의·계획·검증·릴리스와 일치할 때만 가장 작은 스킬을 자연어로 선택하게 하면 자율성과 재현성을 함께 얻을 수 있다고 봤습니다. 요구사항에는 안정적인 ID를 붙이고, WorkGraph가 requirement → artifact → task → executable check → release gate 연결을 보존하며, source hash가 바뀌면 downstream 상태를 stale로 전파하도록 했습니다.

10개 스킬을 네 층으로 나눴습니다. 제품 계약은 product-spec·screen-spec·work-planner, 증거와 전달은 acceptance-verifier·verified-delivery·release-readiness, 프로젝트 네이티브 산출물은 design-direction·handdrawn-diagram·wigtn-presentation, 지식 축적은 knowledge-wiki가 담당합니다. 대부분 자연어로 자동 선택되지만 전체 구현·검증 루프인 `verified-delivery`는 qualified skill name을 명시해야 하며, Knowledge Wiki도 설치만으로는 켜지지 않습니다.

Evidence Contract validator가 거짓 `verified`, 누락 gap, 존재하지 않는 코드 근거, source drift, 권한 없는 외부 작업을 결정론적으로 차단합니다. WorkGraph의 mutation 명령은 `--apply`가 없으면 dry-run이고 동일 import·plan·drift 적용은 revision을 올리지 않습니다. release-readiness는 review·prepare·commit·push·PR 권한을 사용자 문장 그대로 분리합니다. v0.4.0의 Knowledge Wiki는 허용된 저장소에서만 동작하고, 결정론 검사와 독립 LLM 감사를 통과한 일반화 지식만 `per-user/`에 게시하며 `shared/` 자동 게시와 미push 커밋이 있는 상태의 push를 차단합니다.

• 일반 코딩은 기본 Codex가 처리
• PRD·WorkGraph·화면정의·인수검증은 의도에 맞는 최소 스킬만 선택
• `verified-delivery`와 Knowledge Wiki는 명시적 opt-in
• release-readiness가 commit·push·PR 권한을 각각 보존

Codex용 개인 마켓플레이스에서 설치 가능한 v0.4.0으로 공개했습니다. 10개 스킬과 trigger/evidence 정적 계약, 자연어 trigger 세트, 공식 manifest·skill validator, 저장소 테스트를 함께 제공합니다. 평가 결과 일반 구현의 성공률을 높인다는 과장된 주장은 제거하고, PRD 계약 충족·Evidence status 일관성·Git 권한 경계처럼 실제 근거가 확인된 범위만 제품 설명에 남겼습니다.