Skip to content

[Improvement] Make release and platform guides runnable #15

@Hanjo92

Description

@Hanjo92

Summary / 요약

릴리즈 체크리스트와 플랫폼 가이드를 버전 중립적이고 실행 가능한 체크리스트로 보강합니다.

Current Problem / 현재 문제

docs/release-checklist.md/path/to/quick_validate.py 같은 placeholder 명령과 v0.2.0 focus 항목을 포함합니다. 플랫폼 문서는 개념과 프롬프트는 제공하지만, 각 플랫폼에서 실제로 설정이 끝났는지 확인하는 done criteria가 약합니다.

Why It Matters / 왜 중요한가

릴리즈/이식 문서가 실행 가능하지 않으면 새 환경에서 스킬이 발견되는지, .env가 접근되는지, long-running command와 markdown/JSON 출력을 제대로 다루는지 확인하기 어렵습니다.

Proposed Change / 제안 변경

  • release checklist에서 placeholder command를 실제 저장소 내 검증 명령으로 교체하거나, 필요한 helper를 저장소에 포함합니다.
  • 버전 특정 항목은 release notes/history 섹션으로 분리합니다.
  • fresh checkout, skill registration, changelog/tag, post-release verification 단계를 추가합니다.
  • Codex, Claude Code, Google Antigravity 플랫폼별 setup checklist와 완료 기준을 추가합니다.

Acceptance Criteria / 완료 기준

  • release checklist가 fresh checkout에서 그대로 따라 실행 가능한 명령만 포함한다.
  • 버전 특정 체크가 일반 릴리즈 절차와 분리된다.
  • 플랫폼별 가이드에 setup checks와 done criteria가 추가된다.
  • skill registration, .env access, long-running commands, markdown/JSON handling 검증이 포함된다.

References / 참고 자료

  • docs/release-checklist.md
  • Platform/README.md
  • Platform/Codex.md, Platform/Claude-Code.md, Platform/Google-Antigravity.md
  • 분석일: 2026-04-24

Metadata

Metadata

Assignees

No one assigned

    Labels

    area:docsDocumentation and guidesarea:releaseRelease checklist and platform packagingdocumentationImprovements or additions to documentationenhancementNew feature or requestpriority:p2Normal priority cleanup

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions