Skip to content

refactor(plugin): reduce prompt over-harness for Opus 4.8 (v0.1.8)#23

Merged
Hyeongseob91 merged 1 commit into
mainfrom
refactor/prompt-over-harness
Jun 26, 2026
Merged

refactor(plugin): reduce prompt over-harness for Opus 4.8 (v0.1.8)#23
Hyeongseob91 merged 1 commit into
mainfrom
refactor/prompt-over-harness

Conversation

@HyeonsangKim

Copy link
Copy Markdown
Contributor

명령/에이전트 프롬프트의 표현적 과잉 하네스를 제거. 동작·로직 변경 없음.

  • effort: xhigh 8개 제거 (codegen→medium, review→high, formatter low 유지)
  • 가짜 수치 제거: duration/speedup/하드코딩 날짜/예시 점수 전역 삭제
  • ASCII 목업 축소: prd/implement/auto-commit 명령 -53% (로직 100% 보존)
  • 품질 게이트: 59점 강제캡 해킹 → "Security Critical = 점수 무관 차단"
  • PRD API 템플릿 4종을 commands/references/로 분리 (호출당 컨텍스트 절감)
  • 유령 참조 §5.8 → §5.5 교정
  • 버전 0.1.7 → 0.1.8 (라이브 매니페스트 동기화)

검증: 3개 리라이트 파일 줄단위 정독 + grep 교차확인
(로직 앵커/플래그/복구절차 보존, 가짜수치 0건).

Summary

Changes

Type

  • feat — new agent / command / skill / capability
  • fix — bug fix
  • docs — documentation only
  • refactor / chore

Checklist

  • 새 agent/command/skill을 plugin.json에 등록했다 (해당 시)
  • 카운트를 모두 동기화했다 — plugin.json, marketplace.json, README.{md,ko,cn} 배지/표, CLAUDE.md (해당 시)
  • python3 .github/scripts/validate_plugin.py 통과
  • 버전 변경 시 marketplace.jsonplugin.json ↔ README/CLAUDE.md 일치
  • 사용자 노출 콘텐츠는 한국어, 코드/커밋은 영어

Related issue

명령/에이전트 프롬프트의 표현적 과잉 하네스를 제거. 동작·로직 변경 없음.

- effort: xhigh 8개 제거 (codegen→medium, review→high, formatter low 유지)
- 가짜 수치 제거: duration/speedup/하드코딩 날짜/예시 점수 전역 삭제
- ASCII 목업 축소: prd/implement/auto-commit 명령 -53% (로직 100% 보존)
- 품질 게이트: 59점 강제캡 해킹 → "Security Critical = 점수 무관 차단"
- PRD API 템플릿 4종을 commands/references/로 분리 (호출당 컨텍스트 절감)
- 유령 참조 §5.8 → §5.5 교정
- 버전 0.1.7 → 0.1.8 (라이브 매니페스트 동기화)

검증: 3개 리라이트 파일 줄단위 정독 + grep 교차확인
(로직 앵커/플래그/복구절차 보존, 가짜수치 0건).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@Hyeongseob91 Hyeongseob91 self-requested a review June 26, 2026 03:16
@Hyeongseob91

Copy link
Copy Markdown
Contributor

✅ Review: APPROVE

"prompt over-harness 제거 = 로직 불변" 주장을 5축으로 교차검증했고, 전부 통과했습니다. (병렬 검증 에이전트 3종 + manifest/version 직접 확인)

결과 근거
① 버전/매니페스트 0.1.7→0.1.8 7곳 전부 일치, validate_plugin.py 통과 ("manifests, counts, and version agree")
② 소규모 agent ×7 effort 조정(xhigh→medium/high, formatter low 유지) + 가짜수치("4x 속도향상") 제거만, 로직 손실 0
③ auto-commit / 품질 게이트 임계값 80+/60-79/<60 · 3-agent 병렬 구조 보존. 보안 규칙 개선: min(score,59) 점수캡 해킹 → Security Critical = 점수 무관 FAIL 명시. CLAUDE.md까지 동기화되어 불일치 없음
④ implement.md (-1055) load-bearing 전부 보존 — Step 0.5 Linear 감지, --no-tracker graceful degradation, Step 6 1회 확인 게이트, 위상정렬 의존성, 이슈 단위 ↔ 팀 병렬 BUILD 분기, Architecture decision, Error Recovery §1-7. 가짜 metric("3~5x")은 정직한 표현으로 교체
⑤ prd.md 분리 (-684) + references/ 신규(+574) 추출 내용 verbatim(REST/WebSocket spot-check 일치), ghost ref §5.8→§5.5 교정, FE-gate·anchor(§5.4/§5.4.1/§5.5) 보존

인상

단순 줄 삭제가 아니라 품질 개선이 동반된 리팩토링입니다:

  1. 가짜 성능 수치 제거 → 정직성↑
  2. 보안 게이트의 점수캡 해킹 → 명시적 차단 규칙으로 명료화
  3. PRD API 템플릿 4종 분리 → 호출당 컨텍스트 절감

💬 Minor note (blocker 아님)

${CLAUDE_PLUGIN_ROOT}/commands/references/prd-api-templates.md 참조는 런타임 표준 변수라 정상 resolve됩니다. 다만 기존 스킬들은 번들 파일을 상대경로(references/state-checklist.md, styles/editorial.md)로 가리키는 컨벤션이라, 이 PR이 ${CLAUDE_PLUGIN_ROOT}를 처음 도입합니다. command는 CWD가 불확실해 절대변수 쪽이 오히려 견고하지만, 향후 일관성을 위해 README/CONTRIBUTING에 "command 번들 참조는 이 변수 사용" 한 줄 명문화를 권장합니다.

결론: 머지 가능. 👍

🤖 Generated with Claude Code

@Hyeongseob91 Hyeongseob91 merged commit 02b79a7 into main Jun 26, 2026
1 check passed
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.

2 participants