pilot v0.15.0

What's Changed

• docs: v0.14.0 문서 최신화 — 사실오류 정정 + issue 1급 반영 by @radiostart in #21
• docs: context 재학습 (#22 완료) + 신규 기능 how-to 2종 by @radiostart in #22
• fix(doctor): context drift 시간대 오판 + prompts stale 정정 by @radiostart in #23
• docs(issue): GUIDE 의 Open Questions 서술을 실제 계약으로 정정 by @radiostart in #24
• 감사 잔여 결함 정비 — REPORT 영속화·훅 정합·description 감량 (v0.15.0) by @radiostart in #25

Full Changelog: pilot-v0.14.0...pilot-v0.15.0

pilot v0.14.0

사내 원본 플러그인의 미포팅 기능 4건을 흡수하고, 내장 명령과 충돌하던 스킬 2종을 개명한 minor 릴리스입니다. v0.10.1 이후 병합된 7 PR (#13~#20) 을 한 번에 담습니다.

새 기능

issue 단건 사이클 + 폴더 slug 자동 명명

/pilot:issue 가 컨텍스트 로드·기록만 하던 경량 모드에서 사이클 지원으로 재정의됐습니다. 코드 수정이 필요한 운영 이슈는 project 와 동일한 @pilot-planner → @pilot-planner-critic → @pilot-generator → @pilot-evaluator 사이클을 이슈 단위로 사용합니다.

• work_mode 계약 — orchestrate-load 가 STATE.md 의 | issue | {이슈명} | 진행중 | 행을 인식해 issues/{이슈명}/issue.md 를 단건 명세로 로드합니다. 상태 파일 없이 동작하며(stateless), 도메인은 issue.md 의 도메인: 라인에서 읽습니다. 종전에는 이슈명을 프로젝트로 오인해 .agent-state.yml 누락 이라는 오도성 에러가 나가고 doctor 도 오진했습니다.
• 이슈 수정 모드 계약 — planner 는 원인 기입·영향 범위 후보·회귀 재현 테스트 스텝·결함 지점 1줄을, generator 는 조치 기입과 변경 범위 게이트를, evaluator 는 회귀영향 3분류 판정과 회귀 재현 테스트 직접 실행(test_run skip 금지)·## 조치 미기입 시 READY 금지를 수행합니다.
• 폴더명 slug 규약 — 식별자(폴더명: 영문 kebab [a-z0-9-] ≤40자)와 표시명(issue.md H1: 한글 원문 요약)을 분리합니다. 팀 용어는 임의 번역하지 않고 도메인 문서의 코드 표기를 우선 채택해 폴더명으로 소스를 grep 할 수 있게 합니다. 유사 이슈 검색은 폴더명 ls 와 H1 grep 을 병행합니다.
• 모드 경계 집행 — project 전용 스킬은 issue 행에서 issue_active_not_project 안내 후 종료합니다. 예외는 두 개: focus 는 issues/{이슈명}/.focus.md 로 분기하고, commit 은 이슈 수정 커밋이 필수 경로라 계속 동작합니다. 기존 이슈 파일은 훅이 Write·destructive 로부터 보호합니다(Edit·신규 파생 산출물·.focus.* 는 통과).

가이드: 운영 이슈 단건 처리

Open Questions fail-closed 게이트

feature 명세의 미해결 - [ ] 항목이 조용히 무시되던 경로를 차단합니다. plan 에 처리 마커(추정 구현 / 범위 제외)가 없으면 plan-validate 가 invalid 로 판정하고, evaluator REPORT 에 open_questions gate 가 추가돼 7 gates 가 됩니다. 특히 ### (d) 비즈니스 결정 영역 을 구현이 임의로 결정하면 Major 이슈로 반려합니다.

도메인 지식 환류 (knowledge-sync)

evaluator 가 사이클 종료 시 이번 변경이 도메인 문서에 남길 지식을 감지해 metrics.domain_impact 로 보고합니다. gate 는 아니며(READY 와 detected 는 정상 공존), evaluator 는 감지·보고까지만 하고 workspace/context/ 기록은 사용자 승인 후 메인 대화가 수행합니다.

변경

/pilot:init → /pilot:pilot-init, /pilot:review → /pilot:pilot-review

Claude Code 내장 /init·/review 와 bare 별칭이 충돌해 스킬이 호출되지 않던 문제를 개명으로 해소했습니다. 기존 이름은 더 이상 동작하지 않습니다 — 튜토리얼·how-to 문서의 명령도 함께 갱신됐습니다.

하니스 정합·규율 보강

• 진행 보드 선로딩을 TodoWrite / TaskCreate·TaskUpdate 겸용 select 로 변경 (하니스 세대 불일치 공회전 방지)
• 계획 단계 effort 상향 (planner·critic xhigh), generator 모델 승격
• plan 분량 가드 — 30,000자 / 최장 라인 1,500자 초과 시 WARN (비차단). 회차 이력 잔재를 정리해 최신 확정 상태만 남기도록 유도
• 훅 결함 수정 4건 — scope-guard 디렉터리 경계 오매칭, commit-format 명령 앵커링·HEREDOC 검증, protect-managed ./ 접두 정규화·projects 상위 차단, coding-rules 세션 1회 마커
• SessionStart 컨텍스트 훅 신설, 주석 규율 eval 추가, plan 인용 시 식별자 배제

저장소 안내

루트 CLAUDE.md 의 폐기된 gstack 설치 강제 절을 제거하고 저장소 구조·정본 문서·테스트 명령 안내로 대체했습니다.

검증

• python3 -m unittest discover -s pilot/tests/tools → 345 tests OK (v0.10.1 대비 +53)
• docs_build.py --check exit 0 (34 pages) · doctor.py --schema 6 PASS · 0 WARN · 0 ERROR
• 사내 식별자 sweep 0건 · issue 사이클은 #26 dogfooding 으로 create-feature → planner → critic → generator → evaluator 완주 검증

업그레이드

Claude Code 에서 /plugin 으로 업데이트하세요. 세션 시작 시 로드된 플러그인 경로는 고정이므로, 업데이트 후 세션을 재시작해야 새 버전이 적용됩니다.

/pilot:init·/pilot:review 를 쓰던 스크립트·메모가 있으면 /pilot:pilot-init·/pilot:pilot-review 로 바꿔야 합니다.

pilot v0.10.1

doctor 진단 도구의 오탐 2건을 수정하고, v0.10.0 정비 3부작의 마지막 dogfooding 게이트를 마감했습니다. 버그 수정만 포함한 patch 릴리스입니다.

버그 수정

doctor 파서 오탐 2건

• conventions 플레이스홀더 오탐 — config.md 의 값 셀에 적힌 예시 표기(예: \context/conventions.md`)를 실제 선언으로 오인해, 존재하지 않는 파일을 가리킨다며 WARN 을 발화하던 문제. 값 셀이 **코드 스팬 단독** 또는 **공백 없는 평문**일 때만 선언으로 인정하고, 그 외는 미선언 + INFO 로 강등합니다. 판정이 구조 기반이라 한국어 예:` 같은 문자열 규약에 의존하지 않습니다.
• features 카운트 오탐 — .plan.md·.plan.critic.md 같은 파생 산출물을 feature spec 으로 세어 features 24 → 30 (증가 6) 이라는 허위 drift WARN 을 내던 문제. is_feature_spec_file() 이 "stem 에 . 이 있으면 파생 산출물" 규칙을 단독 보유하는 SSOT 가 되어, 새 접미사가 늘어도 파서 수정이 필요 없습니다.

실측 결과 10 PASS · 4 WARN · 0 ERROR → 10 PASS · 1 WARN · 0 ERROR. 남은 WARN 1건은 plugin_version 업그레이드 정상 감지입니다.

정상 탐지는 보존됩니다 — 실제 선언 + 파일 부재 WARN, spec 실제 증가 drift WARN, analyzed=true + spec 0 WARN 3종을 손상본 주입으로 독립 재현해 확인했습니다. 오히려 정확해진 부분도 있습니다: 종전에는 파생 산출물만 있어도 count > 0 이라 analyzed=true + spec 0 WARN 이 침묵했습니다.

알려진 경계

feature spec 파일명의 stem 에 점을 쓰면(05-v1.0-release.md) 파생 산출물로 판정돼 미카운트됩니다. test_doctor_features_count.py::DottedSpecStemNotCounted 가 이 경계를 테스트로 고정합니다.

검증

• python3 pilot/tools/doctor.py workspace → 10 PASS · 1 WARN · 0 ERROR, features=24
• python3 -m unittest discover -s pilot/tests/tools → 292 tests OK (신규 8건)
• v0.10.0 의 정비 3부작(#18 prune · #19 rewrite · #20 slim)이 dogfooding 게이트 통과로 전부 마감

업그레이드

Claude Code 에서 /plugin 으로 업데이트하세요. 세션 시작 시 로드된 플러그인 경로는 고정이므로, 업데이트 후 세션을 재시작해야 새 버전이 적용됩니다.

pilot v0.10.0

에이전트 성능 향상으로 과잉이 된 지시문을 4축 전수 감사 후 3단계로 정비했습니다. 지시 문서 4,808 → 3,635줄, tools/ Python 7,138 → 4,997줄 (절감 2,141줄, 30.1%).

주요 변경

스킬·에이전트 재작성

• 슬래시 커맨드 스킬 17개 전부 100줄 이하로 원칙 중심 재작성 (learn만 109줄)
• 에이전트 5종은 기계 계약 보존을 우선해 재작성 — VERIFICATION REPORT 블록, TDD Detect literal, config 표 헤더 등 파서가 의존하는 문자열은 byte 단위로 불변
• 감사에서 추출한 불변 조건 195항(스킬 147 + 에이전트 48) 전수 보존 검증

도구 정리

• 스크립트 3종 삭제 — diagnose.py·memory-hint.py·init_detect.py (모델 판단으로 이관)
• verify-report-lint.py 파서를 auto_pilot.py로 흡수. 전이 로직은 differential 테스트 12/12 일치로 불변 확인
• integrity.py 2,160 → 995줄 (v0.1→v0.2 마이그레이션 시효 만료 삭제, md 표 lint 4종 이관, Onboarding Health 축소)
• doctor.py --schema CI(validate.yml) 신설

버그 수정

• orchestrate-load.py의 MANIFEST 파서 — anchor 없는 정규식이 문서 상단 blockquote를 먼저 매칭해, 모든 wrapper 세션에서 도메인 컨텍스트가 로드되지 않았습니다. anchored 정규식 + 펜스 코드블록 strip으로 수정

문서

• reference/index.md 도구 목록을 실재 8종으로 정정
• how-to/doctor-migration.md 전면 재작성 — 기본 모드는 검사 전용, --fix는 백업 없이 즉시 적용, .gitignore secret 주입은 --fix 없이도 실행됨을 명시 (기존 문서의 거짓 서술 3건 정정)
• tutorial/getting-started.md에서 무효화된 Troubleshooting 항목 삭제

업그레이드

minor 버전이므로 wrapper 계약이 바뀌었을 수 있습니다:

/plugin marketplace update radiostart-plugins
/plugin update pilot@radiostart-plugins
# 세션 재시작 후
/pilot:doctor
/pilot:analyze --regen-agents

정정 (2026-07-26): 최초 게시본은 pilot/tools/pilot-update.sh 를 안내했으나, 이 스크립트는
marketplaces/ 클론만 fast-forward 할 뿐 플러그인이 실제로 로드되는
~/.claude/plugins/cache/{marketplace}/pilot/{version}/ 은 갱신하지 못해 업그레이드가 되지
않았습니다. 스크립트는 폐기됐고 /plugin 이 유일한 지원 경로입니다.

알려진 사항

• skills/doctor/SKILL.md의 "검사는 비파괴 — 파일 수정 안 함" 서술이 실제 거동과 어긋납니다 (.gitignore secret 주입은 --fix 없이도 실행). 다음 릴리스에서 정정 예정
• doctor 실행 시 conventions_doc/conventions_evals WARN 2건은 config 표의 설명용 플레이스홀더를 파서가 실선언으로 오인하는 오탐입니다

pilot v0.9.0

What's Changed

• feat: 조건부 인터뷰 — Open Questions 소비 단계 (#17) + v0.9.0 릴리즈 by @radiostart in #7

Full Changelog: pilot-v0.8.0...pilot-v0.9.0

pilot v0.8.0

Full Changelog: pilot-v0.7.1...pilot-v0.8.0

pilot v0.7.1

Full Changelog: pilot-v0.7.0...pilot-v0.7.1

pilot v0.7.0

Full Changelog: pilot-v0.6.0...pilot-v0.7.0

pilot v0.6.0

Full Changelog: pilot-v0.5.0...pilot-v0.6.0

pilot v0.5.0

What's Changed

• feat(pilot): v0.5.0 — dp-skills 정합 + 의존성·하드닝 by @radiostart in #6

Full Changelog: pilot-v0.3.1...pilot-v0.5.0