Spec Pack Installer

spec-pack은 .codex 또는 .claude에 spec-pack authoring surface를 설치하는 작은 CLI다.

내부 authoring source는 spec-pack/ 아래에 있고, 배포 기준은 RELEASE-PLAN.md에 정리했다. 현재 실제 shipping boundary는 SHIPPING-SURFACE.md에 정리했다. host-aware install 방향은 HOST-AWARE-INSTALL-SURFACE.md에 정리했다. pack 상태는 PACK-REGISTRY.md에 정리했다.

설치 방법은 INSTALL.md에 따로 정리했다.

Codex Surface

이 repo는 Codex App + CLI 기준으로 아래 project-local surface를 갖는다.

• root AGENTS.md
• Codex supplement .codex/AGENTS.md
• project config .codex/config.toml
• Codex sample roles:
  • .codex/agents/explorer.toml
  • .codex/agents/reviewer.toml
  • .codex/agents/docs-researcher.toml

Notes

• --scope local은 현재 프로젝트의 .codex 또는 .claude 아래에 설치한다
• --scope global은 ~/.codex 또는 ~/.claude 아래에 설치한다
• --pack 기본값은 prebuild다
• 대부분 사용자는 --pack을 신경 쓰지 않아도 된다
• 기본 prefix는 pack별 기본값을 따른다
• prebuild는 spec-*, planning은 planning-*를 사용한다
• prebuild는 현재 custom --prefix를 지원하지 않는다
• 현재 default shipped pack은 unified prebuild surface이며, 설치 루트 이름은 spec-pack이다
• compatibility alias로 planning-pack command를 함께 제공한다
• shipped pack에는 loop log, scenario matrix, internal fixture가 포함되지 않는다
• planning은 호환용 minimal path로 남아 있다
• design, architecture는 개별 installer surface는 없고 prebuild에 포함된다