hashgraph-online/awesome-codex-plugins / plugins/alpoxdev/hypercore/skills/hyper-plan
hyper-plan
Verified[Hyper] Use this skill when the user asks to plan a change before implementation - a feature, refactor, migration, fix, or multi-step build - and expects a decision-complete plan file that a worker can execute without another interview. It explores read-only, writes only a draft and a plan under `.hyper/`, reviews the plan for gaps, then continues into execution by default unless the user asked for a plan only. Do not use for PRD, spec, or wireframe packages; for immediate edits that need no plan; or for research reports.
| File | Kind | Size |
|---|---|---|
| SKILL.ko.md | markdown | 19.8 KB |
| SKILL.md | skill md | 17.8 KB |
| assets/evals/hyper-plan-cases.jsonl | other | 18.3 KB |
| assets/plan-template.ko.md | markdown | 2.1 KB |
| assets/plan-template.md | markdown | 2.0 KB |
| references/plan-format.ko.md | markdown | 10.8 KB |
| references/plan-format.md | markdown | 9.8 KB |
| rules/handoff.ko.md | markdown | 8.0 KB |
| rules/handoff.md | markdown | 7.3 KB |
| rules/plan-review.ko.md | markdown | 10.4 KB |
| rules/plan-review.md | markdown | 9.3 KB |
| rules/planning-workflow.ko.md | markdown | 16.1 KB |
| rules/planning-workflow.md | markdown | 14.0 KB |
| rules/stance-calibration.ko.md | markdown | 10.0 KB |
| rules/stance-calibration.md | markdown | 9.0 KB |
rules/stance-calibration.ko.md
View on GitHub# Stance Calibration
이 파일은 `planning-workflow.md`의 질문 단계에서, 모든 질문을 던지기 전과 답을 읽은 뒤에 씁니다. 질문 형식, 답변 분류, 위임 표현이 정하는 범위를 이 파일이 소유합니다. 두 필터, 턴당 질문 3개 상한, 소유자 결정 목록은 그 워크플로에 그대로 둡니다.
## 1. 질문 형식
| 형식 | 모양 | 이 형식으로 바꾸는 조건 | 이 형식을 떠나는 조건 |
|---|---|---|---|
| 일괄(Batch, 기본값) | 한 턴에 질문 1~3개, 각 질문의 권장안을 맨 앞에 두고 순서와 관계없이 답을 받음 | 턴이 시작될 때 | 아래 전환 조건이 성립할 때 |
| 하나씩(One by one) | 턴마다 질문 하나, 앞선 답을 읽은 뒤에만 다음 질문을 보냄 | 어떤 답이 뒤에 남을 질문이나 그 선택지를 바꿀 때 | 남은 질문이 마지막 답에 의존하지 않을 때 |
| 예시 먼저(Examples first) | 입력과 그 입력이 계획에서 만드는 동작을 짝지은 예시 2~3개를 선택지 이름보다 먼저 보여 줌 | 사용자가 추상적인 선택지를 판단하지 못하거나 예시를 요청할 때("예시로 보여줘") | 사용자가 예시를 보고 선호를 밝힐 때 |
- 일괄이 기본값입니다. 턴은 정해진 조건에서만 형식을 바꾸고, 어느 형식을 쓰는지 한 구절로 밝힙니다.
- 상한은 인터뷰가 아니라 턴에 붙습니다. 하나씩 형식은 같은 상한을 턴 여러 개에 걸쳐 쓰고, 어떤 형식도 한 턴에 질문을 3개 넘게 던지지 않습니다.
- 예시 먼저 형식의 턴도 선택지 2~4개와 맨 앞의 권장안으로 끝납니다. 선택지를 사용자가 설계하게 하거나 예시를 사용자가 대 주게 하지 않습니다.
- 형식은 지금 다루는 갈림길에만 적용됩니다. 전환 조건이 끝나면 일괄로 돌아가고, §4에서 선언된 선호가 두 전환보다 우선합니다.
## 2. 답변 상태
다음 턴 전에 모든 답변을 정확히 한 상태로 분류합니다. 이 상태가 갈림길을 닫을지, 좁힐지, 버릴지를 정합니다.
| 상태 | 신호 | 기록 | 다음 턴 |
|---|---|---|---|
| `resolved` | 선택지나 결정을 말하고, 그대로 진행할 만큼의 정보가 있음 | `## Decisions`에 결정 | 계속 진행하고 다시 묻지 않음 |
| `resolved_uninformed` | 근거를 확인하지 않은 채 권장안을 받아들이거나 갈림길을 넘김("추천대로", "그걸로", "다 괜찮아", 건너뛴 질문) | `## Decisions`의 결정과 `uninformed` 표시가 붙은 open-assumptions 행 | 계속 진행하고, 계획에서 그 결정을 uninformed로 표시 |
| `unresolved_progress` | 일부만 답하거나, 제약을 더하거나, 되묻는 질문으로 갈림길을 좁힘 | 새 정보와 좁혀진 질문 | 남은 부분을 묻고, 그 턴의 상한에 포함 |
| `unresolved_blocked` | 지금은 답할 수 없음. 사용자에게 없는 사실, 다른 사람의 결정, 외부 사건을 기다림 | 막는 요인, 그것을 풀 수 있는 사람이나 사건, 그동안 채택한 기본값 | 묻기를 멈추고 권장안을 채택하며 막는 요인을 계획의 위험으로 남김 |
- `resolved_uninformed` 답변을 기획자가 스스로 읽어 `resolved`로 올리지 않습니다. 아무도 확인하지 않은 권장안은 결정으로 기록하고, 드래프트의 open-assumptions 행과 계획의 `Decisions made for you:` 줄에 `uninformed`로 표시해, 실행자가 그 결정 뒤에 사실이 없다는 것을 알 수 있게 합니다.
- 짧은 맞장구("ㅇㅇ", "ok")는 열린 질문에 대한 답이면 권장안을 고른 `resolved_uninformed`입니다. 열린 질문이 없으면 아무것도 정하지 않으며 `## Decisions`에 들어가지 않습니다.
- `unresolved_blocked`도 계획은 냅니다. 권장안을 채택하고 가역성과 함께 가정을 기록하며, 막는 요인을 계획의 위험 줄에 넣습니다. 다음 턴에 같은 질문을 다시 꺼내지 않습니다.
- `resolved`나 `resolved_uninformed` 갈림길을 다시 묻는 것은 결함입니다. 드래프트에 이미 결정이 있고, 되묻기는 상한을 쓰면서 듣지 않았다는 인상을 줍니다.
## 3. 위임 범위
위임 표현은 발화 행위이지 백지수표가 아닙니다. 표현의 낱말을 읽고, 그 낱말에 맞는 가장 좁은 범위를 적용합니다.
| 범위 | 표현 | 정하는 것 |
|---|---|---|
| 질문 | "이건 그걸로", "이 질문은 네가 정해", "whatever you think for this one" | 지금 질문 하나만 |
| 주제 | "이 부분은 알아서 해", "로그인 쪽은 니가 정해", "이 주제는 알아서" | 그 턴이 다루는 주제의 열린 질문 전부, 그 바깥은 아무것도 아님 |
| 계획 | "전부 알아서", "다 알아서 해", "질문 그만, 전부 알아서", "stop asking, decide everything" | 나중 주제를 포함해 계획에 남은 모든 갈림길 |
- 범위 낱말이 없는 "알아서 해", "니가 정해", "질문 그만"은 주제 범위입니다. 저절로 계획 전체로 넓어지지 않고, 같은 답변에 계획 낱말("전부", "다", "everything", "계획 전체")이 있을 때만 넓어집니다.
- 범위 낱말이 없는 "질문 그만"은 지금 주제의 질문을 끝냅니다. 나머지 계획 전체에 대한 동의로 읽지 않습니다.
- 위임된 갈림길은 인용한 표현과 그것이 정한 범위를 함께 `## Decisions`에 적습니다. 예를 들면 `delegation: "이 부분은 알아서 해" -> topic: login rate limit`입니다. 그래야 나중 턴이 그 갈림길을 다시 묻지도, 범위를 넓히지도 않습니다.
- 계획 범위 위임 뒤에 기획자가 꺼내는 메시지는 두 종류뿐입니다. 답이 되돌릴 수 없는 손실을 부를 수 있는 갈림길(파괴적 변경, 롤백할 수 없는 마이그레이션, 새 지출, 외부 전송이나 게시, 데이터 유실), 또는 사용자만 할 수 있는 단계(자격 증명, 계정이나 권한 승인, 로그인, 결제)입니다. 메시지마다 둘 중 어느 것인지 밝힙니다.
- 그 밖의 모든 것은 기획자가 정하고 가역성과 함께 open-assumptions 원장에 적습니다. 그 시점에 이름, 구조, 라이브러리, 파일 배치, 응답 코드, 기본값, 테스트 전략은 기획자의 결정입니다.
- 위임은 계획상의 갈림길만 정합니다. 리뷰 요구를 낮추지도, 구조 자기 점검을 건너뛰지도, 구현을 허용하지도 않으며, 이 스킬은 여전히 드래프트와 계획만 씁니다.
## 4. 질문 형식 선호
사용자가 어떤 방식으로 질문받기를 원하는지는 드래프트에 기록되고 실행이 끝날 때까지 유지됩니다.
- 드래프트 frontmatter의 두 필드가 이 값을 담습니다. `question_form: batch | one_by_one | examples_first`와 `question_form_source: declared | observed`입니다.
- `declared`는 사용자가 질문 방식을 말하는 순간 설정합니다("한 번에 다 물어봐", "하나씩 물어봐", "예시로 보여줘", "ask them all at once"). §1의 모든 전환과 모든 `observed` 값보다 우선합니다.
- `observed`는 답변 두 개가 같은 방향을 가리킬 때만 설정합니다. 한 묶음을 통째로 넘긴 답 두 개는 `batch`를, 질문 하나만 답하고 나머지를 흘린 답은 `one_by_one`을, 예시를 요청한 답은 `examples_first`를 뒷받침합니다. 답변 하나는 선호가 아니라 자료점 하나입니다.
- 기록과 어긋나는 뒤의 답변은 기록을 바꾸고, 바뀐 내용을 새 출처와 함께 `## Questions asked`에 적습니다.
- 기록은 드래프트에 있으므로 컨텍스트 압축과 재개된 세션을 견딥니다. 런타임 메모리나 설정 파일, 실행 밖의 어디에도 저장하지 않습니다. 이 파일은 세션 사이로 선호를 넘기지 않습니다.
## 5. 예시
로그인 요청 제한에 대한 일괄 턴이 세 가지를 묻습니다. 제한값, 카운터 저장소, 응답 코드입니다.
```text
User: 이 부분은 알아서 해. 대신 감사 로그는 따로 남겨줘.
```
- 이 표현은 주제 범위이므로, 로그인 질문 세 개는 권장안을 받아들인 `resolved_uninformed`가 되고 `uninformed`로 표시됩니다. 감사 로그 문장은 `unresolved_progress`입니다. 갈림길을 다시 여는 것이 아니라 제약을 더합니다.
- 다음 주제인 알림 리팩터링은 그대로 묻습니다. 위임이 로그인 주제에서 끝났기 때문입니다.
- 뒤에 오는 "질문 그만, 전부 알아서"는 계획 범위입니다. 남은 갈림길을 정해 기록하고, 기획자는 되돌릴 수 없는 손실(운영 테이블 삭제)이나 사용자 단계(배포 자격 증명)에만 다시 옵니다.
## Sources
> 확인 2026-11-09.
| 주장 | 출처 |
|---|---|
| 일괄, 하나씩, 예시 먼저의 세 질문 형식, 네 가지 답변 상태, 발화 행위로 읽어 가장 좁은 범위를 적용하는 위임 표현, declared나 observed 출처로 기록하는 질문 형식 선호 | `dbc-hbin/omp-ulw`의 커밋 `74df40f`(2026-11-09). 소스 저장소에 라이선스가 없어 메커니즘을 이 패키지의 문장으로 다시 썼고 복사하지 않았습니다 |
| 이 파일이 확장하는 두 필터, 질문 3개 상한, 소유자 결정 목록, 권장안 우선 형태 | `rules/planning-workflow.md` §6 |
| 기록을 담는 드래프트 frontmatter 필드와 open-assumptions 원장 | `rules/planning-workflow.md` §7 |
| 계획 범위 위임 뒤에도 남는 두 조건, 되돌릴 수 없는 손실과 사용자만 할 수 있는 단계 | `rules/planning-workflow.md` §6의 소유자 결정 목록을 이 두 가지로 좁힌 것 |
| 선호를 메모리나 설정 파일이 아닌 지속 상태에 두는 원칙 | `instructions/context-engineering/references/context-management.md` |
### Evidence grade
`LOCAL` - 이 파일은 이 패키지의 질문 절차를 적습니다. 세 질문 형식, 네 답변 상태, 세 위임 범위는 원본 기획자의 아이디어에서 다시 쓴 이 패키지의 용어이고, 개수는 이 패키지가 고른 값이며 검증된 최적값이 아닙니다.Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 471k | Updated | Claude CodeCodex | Verified | Install |
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |