baskduf/FableCodex

FableCodex 는 무엇인가요?

FableCodex 는 Codex(코드 생성 모델)가 수행하는 모든 작업에 엄격하고 증거 기반의 워크플로우를 추가하는 Codex 플러그인 입니다. 모델이 파일을 무제한으로 편집하게 두는 대신, 이 플러그인은 Codex 가 다음을 수행하도록 합니다:

분류: 행동하기 전에 요청을 분류합니다.
검사: 현재 워크스페이스와 참조된 소스를 확인합니다.
사용: 기억에 의존하지 않고 적절한 Codex 내장 도구(예: 파일 편집, 테스트 러너)를 사용합니다.
추적: 다단계 목표 레지스트리(ledger)를 기록하고 각 체크포인트에서 증거를 기록합니다.
수집: 리뷰 발견사항을 수집하고 명시적으로 해결될 때까지 열어둡니다.
검증: 테스트, 린터, 타입 체크, 스크린샷, 명령어 출력 등을 통해 결과를 검증합니다.
보고: 무엇이 변경되었는지, 무엇이 검증되었는지, 그리고 남아 있는 위험은 무엇인지 보고합니다.

이 플러그인은 기반 모델, 그 가중치, 또는 안전 시스템을 수정하지 않습니다. 오직 절차적 안내와 로컬 회계 기록만 추가합니다.

누구에게 적합한가요?

적합한 경우	적합하지 않은 경우
다단계 구현, 리팩터링, 마이그레이션	1줄 수정이나 소규모 편집
재현이 어려운 오류 디버깅	단순한 브레인스토밍 또는 아이디어 생성
CI 실패, 릴리스 작업, 보안 민감한 변경	추가 오버헤드가 이익을 초과하는 작업
발견사항이 완료를 차단해야 하는 리뷰	빠른 "보기만 하고 끝내기" 답변
이미 Codex 모델에 접근 가능한 팀이고 더 엄격한 프로세스를 원하는 경우	Codex 통합이 없는 사용자

사용자가 워크플로우를 어떻게 제어하나요?

제어는 프롬프트 내에서만 이루어집니다. @codex-fable5 태그를 사용하여 Codex 에 전송합니다. 예시:

엄격 모드 – 완전한 레지스트리, 발견 게이트, 검증 후 완료:

@codex-fable5 Run this strictly.
Use a goal ledger, record any review findings, and do not finish until tests and findings gate pass.

분석 전용 – 파일 편집 없이 발견사항 보고만:

@codex-fable5 Analyze only.
Do not edit files. Give findings with file and line references.

제한된 구현 – 편집은 하지만 커밋/푸시/브랜치 삭제는 금지:

@codex-fable5 Implement the fix.
Do not commit, push, or delete branches.
Run unit tests and report any residual risk.

디버깅 – 재현, 가설, 반증 증거 수집 후 수정:

@codex-fable5 Debug this failure.
Reproduce it first, keep multiple hypotheses, gather disconfirming evidence, then fix and verify.

핵심 개념

목표 레지스트리 (Goal Ledger)

.codex-fable5/goals.json 에 로컬에 저장됩니다.
codex-fable5 goals create … 로 간단한 설명과 하위 목표 목록을 지정하여 생성합니다.
각 하위 목표는 codex-fable5 goals checkpoint … 로 완료/실패로 표시되며, 증거(예: 파일 X 읽기, 테스트 업데이트)를 제공하고, 선택적으로 검증 명령어와 출력을 포함합니다.

발견 게이트 (Findings Gate)

codex-fable5 findings add … 로 .codex-fable5/findings.json 에 리뷰 발견사항을 기록합니다.
codex-fable5 findings resolve … 로 해결될 때까지 발견사항은 열린 상태 로 유지되며, 검증 증거도 필요합니다.
codex-fable5 findings gate 는 고중요도 또는 차단된 발견사항이 남아 있으면 최종 완료를 중단합니다.

빠른 시작 (README 에서)

# 최신 안정 버전 설치
codex plugin marketplace add baskduf/FableCodex --ref v0.5.1
codex plugin add codex-fable5@fablecodex

# Codex 재시작 후 프롬프트에서 스킬 호출
@codex-fable5 Use this skill to implement the change.
Create a goal ledger if the work has multiple steps.
Track findings before final completion.
Run the project tests before saying it is done.

레지스트리 생략 버전:

@codex-fable5 Review this quickly.
Do not create a goal ledger. Check the key evidence and report only actionable findings.

명령어 참조 (요약)

명령어	기능
`codex-fable5 status`	현재 목표와 발견사항 표시
`codex-fable5 goals create …`	새로운 다단계 레지스트리 시작
`codex-fable5 goals next`	다음 보류 중인 목표 표시
`codex-fable5 goals checkpoint …`	증거와 함께 목표 완료/실패 표시
`codex-fable5 findings add …`	리뷰 발견사항 기록
`codex-fable5 findings resolve …`	검증 증거와 함께 발견사항 닫기
`codex-fable5 findings gate`	열린/차단된 발견사항이 남아 있으면 실패
`codex-fable5 update`	플러그인 최신 안정 태그 가져오기

추가 기능

커버리지 계산 – 원본 CLAUDE-FABLE-5.md 소스가 있으면, 헬퍼 스크립트로 각 섹션 헤딩에 대응하는 결정(구현됨, 적응됨, 지원되지 않음, N/A)이 있는지 검증 가능.
옵션 프로바이더 브리지 – Anthropic 또는 OpenAI 호환 게이트웨이(예: LiteLLM)를 통한 요청 라우팅 설명 제공. 플러그인 자체는 모델 인증 정보를 포함하지 않음.
로컬 상태 – 모든 레지스트리와 이벤트 로그는 .codex-fable5/ 아래에 있으며, 일시적 으로 설계됨. 명시적으로 영구 전사본을 원하지 않는 한 커밋하지 않음.

라이선스 및 커뮤니티

AGPL-3.0-or-later 라이선스.
antigravity-awesome-skills 및 awesome-agent-skills 등의 커뮤니티 스킬 목록에서 인정됨.
기여 환영. README 에 기여자 배지 표시됨.

TL;DR

FableCodex 는 Codex 코드 생성 모델을 위한 프로세스 중심의 래퍼 입니다. 목표 레지스트리, 증거 체크포인트, 발견 게이트, 자동 검증을 포함한 체크리스트 스타일 워크플로우를 모델이 따르게 함으로써, 대규모 및 안전에 민감한 코드 변경에서 단계 누락을 방지하면서 Codex 생태계 내에서 완전히 운영됩니다.