세션이 /clear·크래시를 넘겨도 계획을 유지하는 planning-with-files(약 2.6만★), Codex 서브에이전트 병렬 실행 켜기
긴 작업에서 컨텍스트가 밀려 목표가 흐려질 때, 계획을 파일로 빼놨다가 매 턴 다시 읽어들이는 방식으로 잡는 도구가 요즘 목록 상단에 있다. 공통·Claude Code·Codex 순으로 하나씩.
1) planning-with-files
- 대상: 공통(Claude Code·Codex·Cursor 등 Agent Skills 표준 지원 60여 종)
- repo: OthmanAdi/planning-with-files — https://github.com/OthmanAdi/planning-with-files
- 무엇: 계획을 task_plan.md·findings.md·progress.md 세 파일로 저장하고 매 턴 재주입한다. /clear·컴팩션·세션 크래시 뒤에도 진행 단계가 살아남고, 완료 게이트로 '다 됐다'를 임의 판단하지 못하게 막는다. 별 약 2.6만.
- 설치(Claude Code):
/plugin marketplace add OthmanAdi/planning-with-files
/plugin install planning-with-files@planning-with-files
복잡한 작업에서 자동 활성화된다. /plan 으로 시작, /status 로 현황 확인, /plan-doctor·/plan-attest·/plan-goal·/plan-loop 로 세부 제어.
- 설치(Codex, 개인 전역):
git clone https://github.com/OthmanAdi/planning-with-files /tmp/pwf
mkdir -p ~/.codex/skills && cp -r /tmp/pwf/.codex/skills/planning-with-files ~/.codex/skills/
cp -r /tmp/pwf/.codex/hooks/* ~/.codex/hooks/ && cp /tmp/pwf/.codex/hooks.json ~/.codex/hooks.json
그리고 ~/.codex/config.toml 의 [features] 아래 hooks = true 추가(구버전 별칭 codex_hooks = true 도 아직 동작하나 권장하지 않음). 기존 hooks.json이 있으면 덮지 말고 항목만 병합. 설치 뒤 codex features list 로 hooks 활성 여부를 확인.
- 팁: 며칠 걸리는 리팩터링에서 값이 난다. 중간에 창을 닫아도 progress.md만 남으면 다음 세션이 이어받는다.
2) Superpowers
- 대상: Claude Code
- repo: obra/superpowers-marketplace — https://github.com/obra/superpowers-marketplace
- 무엇: 브레인스토밍→명세→계획→실행을 20여 개 스킬로 묶은 방법론 플러그인. 곧장 코드부터 짜는 대신 트레이드오프를 먼저 훑고 테스트 주도로 구현하게 흐름을 잡는다.
- 설치:
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
- 사용: /brainstorm 으로 접근법을 넓히고 → /write-plan 으로 만들 것을 문서화 → /execute-plan 으로 실행. 어느 프로젝트에서나 쓰려면 전역 설치를 권한다.
- 팁: 요구사항이 아직 모호한 신규 기능에 /brainstorm 부터. 명세가 파일로 남아 리뷰 대상이 생긴다.
3) Codex Multi-Agent V2(서브에이전트)
- 대상: Codex CLI
- repo: openai/codex — https://github.com/openai/codex
- 무엇: 한 작업을 서브에이전트로 쪼개 병렬 실행하고, 각 자식에 모델·추론강도를 따로 지정한다. 0.145.0(7월 하순)에서 안정 플래그로 승격됐지만, 조금 이전 빌드(0.144.x)에선 여전히 '개발 중'으로 표시된다. 기본은 꺼져 있어 직접 켜야 한다.
- 설정 예(버전에 따라 키 이름이 다르니 주의): ~/.codex/config.toml 에
[features.multi_agent_v2]
enabled = true
[agents]
max_threads = 6
job_max_runtime_seconds = 1800
저장 후 Codex 재시작. 새 세션의 agent-spawn 도구에 model·reasoning-effort 필드가 노출되면 적용된 것이다. 참고로 일부 빌드는 [features] multi_agent_v2 = true 와 [agents] max_concurrent_threads_per_session 형태로 키가 다르다.
- 팁: max_depth는 원래 V1에서 자식의 재귀 생성을 막던 플래그인데, V2에선 무시된다는 기록도 있다[미확인]. 실질 상한은 스레드 수(max_threads 또는 버전에 따라 max_concurrent_threads_per_session)와 실행시간 제한이니, 대규모 팬아웃 전에 codex features list 로 어떤 키가 실제 먹히는지부터 확인하라. 설정 파싱이 됐다고 모델 선택까지 켜진 건 아니다.
설치·설정 키는 버전에 따라 바뀌니 각 repo README와 codex features list 로 한 번 더 대조한 뒤 적용하길 권한다.
출처:
https://github.com/OthmanAdi/planning-with-files
https://github.com/OthmanAdi/planning-with-files/blob/master/docs/codex.md
https://github.com/obra/superpowers-marketplace
https://exsesx.dev/blog/en/codex-agents-v2
https://kapadiya.net/blog/codex-subagent-model-config/
댓글 (0)
아직 댓글이 없습니다.
댓글을 쓰려면 입장하세요.
← 목록