Skip to content

hashgraph-online/awesome-codex-plugins / plugins/alpoxdev/hypercore/skills/hyper-debate

hyper-debate

Verified

Use this skill when the user explicitly asks for adversarial multi-perspective planning before a decision-complete plan, with words such as '여러 관점으로 따져보고 계획', '찬반으로 붙여서 계획', 'adversarial planning', 'devil's advocate plan', 'red team this plan', or 'debate it then plan'. Five fixed perspectives argue through three rounds and the surviving findings become the plan. It writes per-run receipts under `.hyper/debate/`, asks for one approval of the insight bundle, then writes the plan under `.hyper/plans/`. Do not use it for an ordinary 'plan this feature' request, a review of finished code, a research report, a PRD, or an immediate edit.

FileKindSize
SKILL.ko.mdmarkdown18.9 KB
SKILL.mdskill md17.9 KB
assets/evals/hyper-debate-cases.jsonlother8.3 KB
references/plan-shape.ko.mdmarkdown9.6 KB
references/plan-shape.mdmarkdown9.3 KB
references/receipts.ko.mdmarkdown7.6 KB
references/receipts.mdmarkdown7.4 KB
rules/approval-and-plan.ko.mdmarkdown5.9 KB
rules/approval-and-plan.mdmarkdown5.8 KB
rules/perspectives.ko.mdmarkdown5.8 KB
rules/perspectives.mdmarkdown5.4 KB
rules/rounds.ko.mdmarkdown8.1 KB
rules/rounds.mdmarkdown7.8 KB

rules/approval-and-plan.ko.md

View on GitHub
# 승인과 계획

3라운드가 검증된 뒤와 계획을 쓰기 직전에 이 파일을 읽는다. 인사이트 묶음, 단일 승인 지점, 계획 작성 인계를 맡는다.

## 1. 증류

무엇을 쓰기 전에 모든 3라운드 응답을 판정한다.

유지:

- 아무도 이의를 제기하지 않은 발견. 인용은 그대로다.
- 책임자가 인용을 다시 읽고 확인한 `DEFEND`.
- 인용이 실제로 뒷받침하는 좁힌 주장을 가진 `REFINE`.

버리기:

- `CONCEDE`
- 책임자가 자체 근거로 해소하기 전까지, 답하지 않은 공격의 대상 발견
- 인용이 주장보다 약한 방어 또는 다듬기 주장

버린 주장은 묶음에 다시 나타나지 않는다. 그 조각이 여전히 참이면 자기 인용과 자기 검증을 갖춘 별도 발견으로 들어간다.

## 2. 인사이트 묶음

`.hyper/debate/<slug>/insight-bundle.md`는 기획자 입력이고 계획이 아니다. 정확히 다음 여섯 섹션을 이 순서로 갖는다.

```markdown
# <slug> - Insight Bundle
## Original request
## Hard constraints
## Decisions
## Risks and mitigations
## Open questions
## Adversarial provenance
```

| 섹션 | 내용 |
|---|---|
| Original request | 사용자 요청 원문과 인용한 적대적 선택 문구 |
| Hard constraints | 살아남은 불변 조건, 원래 발견 id, 살아남은 이유 |
| Decisions | 토론이 확정한 결정. 제안, 그에 대한 공격, 방어 또는 다듬기, id를 붙인 추론 경로 |
| Risks and mitigations | 살아남은 위험과 근거·발견 id에 묶인 완화책 |
| Open questions | 근거가 해소하지 못한 이견과 열린 이유 |
| Adversarial provenance | 관점별 생존 수, 버린 수, 인정 수 |

묶음은 결정과 제약을 적는다. 웨이브, 할 일 번호, 파일별 쓰기 범위, 인수 명령은 넣지 않는다. 순서는 계획 몫이다.

열린 질문은 조용한 가정이 아니라 게이트다. 작업 형태를 바꾸는 질문이면 계획이 그 질문에 의존하는 할 일에 게이트를 명시한다.

## 3. 단일 승인 지점

실행 하나에 승인 요청은 정확히 한 번이고, 묶음이 존재한 뒤에 한다.

한국어 산문으로 다음을 제시한다.

- 살아남은 결정. 한 줄씩.
- 위험과 완화책.
- 사용자 판단이 필요한 열린 질문.
- 계획이 다룰 범위와 다루지 않을 범위.

그다음 계획 작성 여부를 묻는다. 요청과 시각을 원장에 적는다.

승인은 명시적이다. 침묵, 무시된 질문, 시간 초과한 질문, 빈 응답, 질문 수단을 쓸 수 없다는 사실, 도구 스스로 계속하라는 제안은 승인이 아니다. 승인이 없으면 묶음을 디스크에 둔 채 `awaiting-approval`에서 멈추고 `.hyper/plans/` 아래에는 아무것도 쓰지 않는다.

사용자가 계획을 금지하면("계획은 아직 쓰지 마", "묶음만") 종료 상태는 `declined`이고 묶음이 산출물이다.

사용자가 승인하면 결정을 그대로 기록하고 §4로 넘어간다.

승인은 계획 파일만 승인한다. 구현, 커밋, 푸시, 배포, 파괴적 명령을 승인하지 않는다.

## 4. 계획 작성

계획은 `.hyper/plans/<slug>.md`에 있고, 이 패키지 나머지가 실행하는 계획 형식을 쓴다. 그 문법은 `references/plan-shape.md`에 다시 적혀 있다. 제목 순서, `IS-`/`GAP-` 행, 아홉 중첩 할 일 필드, `F1`~`F4` 웨이브, 성공 기준 표, 인계 필드를 그대로 복사한다.

계획은 이 스킬이 이 문맥에서 묶음으로부터 쓴다. 별도 기획 단계로 넘기지 않고 그 단계를 이름으로 부르지도 않는다. 완성된 파일이 실행 단계가 소비하는 산출물이다.

계획 규칙:

- 묶음의 모든 하드 제약이 `Must have` 줄이 되고, 작업을 함의하면 그것을 만족하는 할 일이 된다.
- 모든 완화책이 그것을 어길 수 있는 할 일에 나타난다.
- 모든 열린 질문이 의존 할 일을 게이트한다. 할 일은 쓰되 인수에 게이트를 적거나, `Unmet:`과 함께 막힘으로 닫는다.
- `Must NOT have` 섹션은 토론이 거절한 추가를 담아 실행자가 조용히 되살리지 못하게 한다.
- `TL;DR`의 `Decisions made for you`는 살아남은 결정과 가역성을 담는다.
- 토론 출처는 `TL;DR` 위험 줄과 인계에 적고 할 일로 바꾸지 않는다.

계획은 한 번 쓰고 이후 그 자리에서 고친다. 제목 순서와 표현은 바뀌지 않는다.

## 5. 종료 상태

| Terminal | Meaning |
|---|---|
| `planned` | 승인이 명시적이고 `.hyper/plans/<slug>.md`가 있으며 다시 읽어 확인했다 |
| `reduced-planned` | `planned`와 같지만 토론이 순차로 돌았고 보고에 그 사실이 있다 |
| `awaiting-approval` | 묶음은 있고 명시적 승인이 아직 없다 |
| `declined` | 사용자가 계획을 금지했고 묶음이 산출물이다 |
| `blocked` | 레인이 두 번 실패했거나, 영수증을 검증할 수 없거나, 필수 capability가 없다 |

실행은 정확히 하나의 종료 상태로 끝나고 원장에 기록하며 보고가 그 이름을 밝힌다.

## Sources

> Checked 2026-11-10.

| Claim | Source |
|---|---|
| 인사이트 묶음 섹션과 승인 뒤 계획 작성 | `dbc-hbin/omp-ulw@74df40f hyperplan/SKILL.md` (메커니즘 참조, 재작성) |
| 계획 제목, `IS-`/`GAP-`, 아홉 할 일 필드, `F1`~`F4`, 성공 기준, 인계 필드 | 이 패키지의 계획 문법, `references/plan-shape.md`에 재수록 |
| 승인은 계획 파일만 승인하고 구현·커밋·배포를 승인하지 않는다 | 이 패키지의 설계, 2026-11-10 (issue #26) |
| 열린 질문이 의존 할 일을 게이트한다 | 이 패키지의 설계, 2026-11-10 (issue #26) |

### Evidence grade

`LOCAL` - 묶음과 승인 절차는 라이선스가 없는 저장소에서 메커니즘만 재작성했고 텍스트를 복사하지 않았다. 게이트 규칙과 종료 상태는 이 패키지의 설계다.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall