goal-forge – 거친 아이디어를 /goal 준비 계약서로 변환하는 Codex 스킬

4단계 파이프라인
4가지 모드
설치
자율 /goal 세션 권장 설정
누구에게 유용한가?
라이선스
관련 도구
참고 자료

Codex의 /goal 명령으로 장시간 자율 실행 세션을 시작하려면 에이전트가 따를 수 있는 명확한 스펙이 필요하다. 모호한 아이디어로 시작하면 에이전트가 중간에 방향을 잃거나 의도와 다른 결과를 낸다. goal-forge는 이 준비 과정을 자동화하는 Codex 스킬로, 인터뷰→스펙 작성→GOAL.md 컴파일→설정 검사의 4단계 파이프라인을 통해 거친 아이디어를 /goal 준비 완료 계약서로 변환한다.

4단계 파이프라인

거친 아이디어
    ↓ [Interview 모드]
    스코프·아키텍처·엣지케이스 결정 → SPEC.md 초안
    ↓ [Tighten 모드]
    SPEC.md 비판적 검토 → 모호성 해소
    ↓ [Compile 모드]
    GOAL.md (XML 블록 구조) 생성
    ↓ [Check config 모드]
    Codex 버전·프로젝트 신뢰·설정 검사
    → autonomous_goal_status: ready

4가지 모드

Interview: 스코프, 아키텍처, 엣지케이스, 검증 기준에 대한 개방형 인터뷰. done_when에 사용자가 승인한 측정 가능한 기준이 포함될 때까지 완료로 간주하지 않는다.

Tighten: SPEC.md를 비판적으로 읽어 모호한 부분을 두 가지 해석 + 권고안과 함께 제시한다.

Compile: XML 블록 구조로 GOAL.md를 생성한다. 스펙이 약하면 Interview/Tighten으로 되돌린다.

Check config: inspect_codex_config.py로 Codex 버전, 프로젝트 신뢰, 장시간 /goal 설정을 읽기 전용으로 보고한다.

설치

git clone https://github.com/michaelpersonal/goal-forge.git ~/.codex/skills/goal-forge

Codex에서 $goal-forge 또는 SKILL.md 프론트매터의 자연어 트리거로 호출한다.

자율 /goal 세션 권장 설정

# ~/.codex/config.toml
model = "gpt-5.5"
model_context_window = 1050000
model_auto_compact_token_limit = 997500
model_reasoning_effort = "high"
plan_mode_reasoning_effort = "xhigh"
approval_policy = "never"
sandbox_mode = "danger-full-access"

[features]
goals = true

approval_policy = "never"와 sandbox_mode = "danger-full-access"는 신뢰된 프로젝트 경로에서만 사용한다.

설정 준비 상태 확인:

python3 ~/.codex/skills/goal-forge/scripts/inspect_codex_config.py --project-path "$PWD"
# autonomous_goal_status: ready 출력 시 준비 완료

누구에게 유용한가?

Codex /goal로 장시간 자율 세션을 운영하는 개발자: 스펙이 불명확하면 에이전트가 방황한다. goal-forge는 스펙 품질을 보장한다.
아이디어를 구체적 요구사항으로 정리하고 싶은 팀: 인터뷰 과정에서 숨겨진 가정과 엣지케이스가 드러난다.

라이선스

MIT

참고 자료

michaelpersonal/goal-forge — GitHub 공식 저장소

Like?

AI Sparkup