Skip to content

refactor: GSL 스킬 체계 저장소 전용 개편 - #673

Merged
Whale0928 merged 9 commits into
mainfrom
chore/gsl-overhaul
Jul 25, 2026
Merged

refactor: GSL 스킬 체계 저장소 전용 개편#673
Whale0928 merged 9 commits into
mainfrom
chore/gsl-overhaul

Conversation

@Whale0928

Copy link
Copy Markdown
Collaborator

GSL(Guided Software Lifecycle) 스킬 체계를 이 저장소 전용으로 전면 개편한다. 운영 코드 변경은 없다.

변경 사항

  • 스킬 9종 → 7종: next-flow·scan-conventions 삭제, plan/conventions.md 은퇴(stale 이동)
  • 미사용 references 삭제: python/go/cli/library/worker-daemon, Polyglot Mode, Superpowers 연동 블록
  • Execution Mode 계약 도입: define 승인 게이트에서 step-by-step(기본) 또는 delegated(+scope)를 선언하고 plan 문서에 기록
  • /define·/plan·/implement 전면 재작성, 나머지 4스킬 정리
  • HARD STOP 보일러플레이트(15줄×9회)를 지침의 "GSL Execution Mode" 단일 섹션으로 통합
  • 스킬 미러 용량 276KB → 132KB (47.8%)

설계 철학

WHAT/HOW 분리. /define은 무엇을·왜만 다룬다. WHAT은 사람의 의도를 끌어내야 해서 재생성이 비싸고 HOW는 에이전트가 다시 짜면 되므로 싸다 — 사람의 협의 비용을 WHAT에 집중하면, 이후 실패는 HOW의 실패로 격리되어 회복 가능해진다.

Task/Slice 이원화 (정육 모델). Task는 문제의 자연 관절(의존성·모듈 경계·리뷰 단위)을 따라 자르는 부위 분해로, 올바른 답이 적고 틀리면 비싸므로 승인 대상이다. Slice는 그 부위를 어떻게 썰지의 실행 선택으로, 정답이 여럿이므로 에이전트 전권이다. /plan의 순서는 분해 → 의존성 정렬 → 크기 검증이며, 크기는 절단 기준이 아니라 검산이다.

define 승인 = 계약 서명. WHAT 승인과 함께 위임 수준을 확정한다. delegated 선언 시 plan → implement → test → verify full → 마감 → push → PR을 자율 진행하되, stop-conditions 3종(가정 붕괴 → 재개봉 프로토콜 / verify 3회 실패 / scope 밖 행동)에서는 모드와 무관하게 무조건 정지한다. 문서에 기록된 것만이 유효한 계약이다.

검증 — 서브에이전트 시나리오 검증

재작성된 스킬 텍스트가 의도한 행동을 유도하는지, 대화 맥락 없이 스킬 텍스트만 받은 서브에이전트 4종(define/plan/implement 단독 + E2E 교차)이 정상·함정 시나리오를 롤플레이로 검증했다.

검증 결과
define 단독 치명 0건 — 가정 확인·모드 선언 게이트가 "건너뛰고 빨리" 압박에도 우회 불가
plan 단독 치명 3건 검출 → 수정 → 재검증 전부 해소 (재개봉 프로토콜 인라인 정의, 사용자 수평 요청 특칙, 전역 즉시 중단 규칙)
implement 단독 치명 0건, 경미 5건 반영 (step 정지 / delegated 연속 / 가정 붕괴 정지 / plan 부재 거부 모두 텍스트만으로 도출)
E2E 교차 문서 간 상충 치명 3건 검출 → 수정 → 재검증 해소 ("계속" 해석 상충, delegated의 test 스킵 경로, verify 격리 규칙 충돌). 재검증이 수정 잔여물 치명 1건을 추가 검출, 반영
  • 총계: 치명 7건 검출·전부 해소, 경미 19건 중 17건 반영
  • 기계 검증: 스킬 7종 / references 6종 / Superpowers·Polyglot·HARD STOP 잔존 0건 / 미러 diff -rq 일치 / 지침 정규화 diff 일치 / Skills 표 7행 정합
  • 운영 코드(Java/Kotlin) 변경이 없어 Gradle 빌드·테스트는 실행하지 않았다

제외 범위

  • deploy_batch.yml 등 CI 워크플로는 변경하지 않았다
  • plan/stale/ 기존 문서들은 손대지 않았다

Whale0928 and others added 9 commits July 25, 2026 19:06
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@Whale0928
Whale0928 merged commit 3a8666b into main Jul 25, 2026
8 checks passed
@Whale0928
Whale0928 deleted the chore/gsl-overhaul branch July 25, 2026 10:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant