[codex] split spec charter and grill skills

[sungjunlee]

Summary

Split the old backlog-charter surface into a clearer spec-series flow:

• spec-charter owns CHARTER.md create/amend/reassess
• spec-grill owns spec/capabilities.md capability-contract authoring
• existing-repo onboarding now points from spec-charter create to spec-grill
• active docs, sibling skill references, and dogfood capabilities were updated to the new command surface

Closes #157.
Closes #158.
Closes #159.

Validation

• node --test skills/spec-grill/scripts/extract-signals.test.js skills/spec-charter/scripts/check-size.test.js skills/backlog-triage/scripts/triage-stale.test.js skills/backlog-triage/scripts/triage-apply.test.js skills/backlog-triage/scripts/triage-relate.test.js skills/backlog-triage/scripts/triage-collect.test.js skills/backlog-triage/scripts/triage-report.test.js skills/dev-backlog/scripts/component-lint.test.js skills/dev-backlog/scripts/lib.test.js skills/dev-backlog/scripts/sync-pull.test.js skills/dev-backlog/scripts/progress-sync.test.js skills/dev-backlog/scripts/progress-sync.cli.test.js skills/dev-backlog/scripts/objectives-check.test.js skills/dev-backlog/scripts/capabilities-doctor.test.js skills/dev-backlog/scripts/sprint-init.test.js

Summary by CodeRabbit

릴리스 노트

• 문서 업데이트

  • 프로젝트 구조 문서가 갱신되어 스킬 디렉터리 레이아웃을 명확히 했습니다.
  • 차터 및 그릴 기능에 대한 상세한 참조 문서가 추가되었습니다.

• 리팩토링

  • 기존 백로그 차터 중심 운영 방식이 스펙 차터와 스펙 그릴로 분리되어 역할이 재정의되었습니다.
  • 관련 스킬 간 통합 계약과 참조 링크가 새로운 구조에 맞게 업데이트되었습니다.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: ef5ad907-c722-4588-94cf-82262a3aa1b7

📥 Commits

Reviewing files that changed from the base of the PR and between 30727e7 and 77cfe0f.

📒 Files selected for processing (26)

• AGENTS.md
• CHANGELOG.md
• CHARTER.md
• CLAUDE.md
• README.md
• docs/spec-system-design.md
• skills/backlog-charter/SKILL.md
• skills/backlog-triage/SKILL.md
• skills/dev-backlog/SKILL.md
• skills/dev-backlog/references/integration-contract.md
• skills/spec-charter/SKILL.md
• skills/spec-charter/references/alignment.md
• skills/spec-charter/references/amendment.md
• skills/spec-charter/references/create.md
• skills/spec-charter/references/objectives.md
• skills/spec-charter/references/reassess.md
• skills/spec-charter/scripts/check-size.js
• skills/spec-charter/scripts/check-size.test.js
• skills/spec-charter/templates/charter.md
• skills/spec-grill/SKILL.md
• skills/spec-grill/references/capabilities.md
• skills/spec-grill/references/spec-system-research.md
• skills/spec-grill/scripts/extract-signals.js
• skills/spec-grill/scripts/extract-signals.test.js
• skills/spec-grill/templates/capabilities.md
• spec/capabilities.md

---

Walkthrough

이 PR은 backlog-charter 단일 스킬을 spec-charter(CHARTER.md 관리)와 spec-grill(spec/capabilities.md 저작)의 두 독립 스킬로 분리합니다. 새로운 스킬 문서, 템플릿, 헬퍼 스크립트를 추가하고 기존 참조들을 일관되게 갱신합니다.

Changes

Spec Series 스킬 구조 재정의

계층 / 파일(s)	요약
spec-charter 스킬 정의 및 참조 문서 skills/spec-charter/SKILL.md, skills/spec-charter/references/*	spec-charter 스킬 문서를 새로 정의하여 create/amend/reassess 모드, helper 스크립트 규칙, CHARTER.md의 3-tier 규율, 모드별 완료 계약을 명시합니다. 참고 자료로 alignment, amendment, create, objectives, reassess를 포함합니다.
spec-grill 스킬 정의, 템플릿 및 헬퍼 skills/spec-grill/SKILL.md, skills/spec-grill/references/capabilities.md, skills/spec-grill/scripts/extract-signals.js, skills/spec-grill/templates/capabilities.md	spec-grill 스킬을 새로 정의하여 spec/capabilities.md의 능력 저작, 신호 추출, 3-axis predicate test, per-capability 인터뷰 흐름, 능력 병합/분할 기준을 명시합니다. extract-signals 헬퍼는 스킬 이름 참고를 갱신합니다.
backlog-charter 스킬 제거 skills/backlog-charter/SKILL.md	기존 backlog-charter 스킬 문서를 완전히 삭제하여 spec-charter/spec-grill 구조로 전환합니다.
관련 스킬 참조 업데이트 skills/backlog-triage/SKILL.md, skills/dev-backlog/SKILL.md, skills/dev-backlog/references/integration-contract.md	backlog-triage와 dev-backlog 스킬의 related-skills 목록, alignment.md 경로, 컴포넌트 예시를 spec-charter/spec-grill로 갱신합니다.
spec/capabilities.md 능력 섹션 분리 spec/capabilities.md	charter-management 능력을 spec-charter(CHARTER.md 관리)와 spec-grill(capabilities.md 저작)로 분리하고, 각 능력의 Goal/In-scope/Out-of-scope, Behaviors, Constraints, Decisions를 정의합니다.
프로젝트 구조 문서 갱신 AGENTS.md, CLAUDE.md, README.md	skills/ 디렉터리 트리 및 구조를 spec-charter/spec-grill 중심으로 재정의하고, "Optional spec-series setup" 섹션을 README에 추가합니다.

아키텍처 및 메타 문서 갱신

계층 / 파일(s)	요약
CHARTER.md 및 변경로그 결정 기록 CHANGELOG.md, CHARTER.md	CHANGELOG에 분리 변경 항목을 추가하고, CHARTER.md의 companion skills 목록을 spec-charter/spec-grill로 갱신하며, Decisions 표에 2026-05-29 결정을 기록합니다.
Spec 시스템 설계 문서의 Mutation discipline 갱신 docs/spec-system-design.md (Mutation discipline 표, Reassess source-of-truth map)	CHARTER.md와 spec/capabilities.md의 Mutation discipline 표를 backlog-charter 기반에서 spec-charter amend/spec-grill 기반으로 치환하고, 각 소유 책임, 게이트 규칙, 아티팩트 경로를 명확히 합니다.
Spec 시스템 설계 문서의 커맨드 표면 갱신 docs/spec-system-design.md (Command surface, Stale-spec lifecycle, Migration path, Historical dogfood)	호출 가능한 커맨드 표면을 spec-charter/spec-grill로 명확히 정의하고, 예약된 이름(spec-reassess, spec-learn)과의 경계를 명시합니다. Stale-spec 진단, reassess 라우팅, dogfood 결과도 갱신합니다.
Spec 시스템 설계 문서의 메타정보 및 목표 docs/spec-system-design.md (Related link, Goal statement)	문서의 Related 링크를 spec-charter로 변경하고, 목표 문장에 "Bias to clarity(명확성 우선)" 항목을 추가합니다.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

• sungjunlee/dev-backlog#110: 이 PR과 함께 spec/capabilities.md의 능력 블록을 정의하는데, 주 PR이 그 구조를 charter-management에서 spec-charter/spec-grill로 재편성합니다.
• sungjunlee/dev-backlog#100: 두 PR 모두 docs/spec-system-design.md를 수정하며, #100은 초기 layered 설계를 소개했고 주 PR은 backlog-charter 용어를 spec-charter/spec-grill로 갱신합니다.
• sungjunlee/dev-backlog#156: 주 PR이 skills/backlog-charter/SKILL.md를 완전히 삭제하므로, #156의 메타데이터 수정은 본 PR의 구조 변경으로 인해 영향을 받습니다.

Poem

🐰 차터는 계획, 그릴은 실전,
분리된 스킬이 명확한 길을 제시하니,
백로그 회귀는 뒤로하고,
스펙 시리즈의 새 시대가 열렸네! ✨

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch codex/spec-series

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}