| name | hyper-waterfall |
| description | Hyper-Waterfall workflow entrypoint for Codex. Use when starting or continuing issue-based Hyper-Waterfall tasks, checking lifecycle init/update paths, or finding canonical manuals and skills. |
Hyper-Waterfall Codex Entrypoint
This plugin is not a canonical source.
์ฐ์ ์์
- ํ์ฌ ์ ์ฅ์์
AGENTS.md๋ฅผ ๋จผ์ ์ฝ๋๋ค.
- ์ ํ task ์ ์ฐจ๋ ํ์ฌ ์ ์ฅ์์
mydocs/skills/{skill-name}/SKILL.md๋ฅผ ์ฝ๊ณ ๋ฐ๋ฅธ๋ค.
- ์ ๊ท ์ ์ฉ ๋๋ ๊ธฐ์กด ์
๋ฐ์ดํธ ํ๋จ์
docs/agent-entrypoint.md, templates/manifest.json, docs/migrations/, npm CLI dry-run์ ๊ธฐ์ค์ผ๋ก ํ๋ค.
- canonical ํ์ผ์ ์ฐพ์ง ๋ชปํ๋ฉด ํ์ผ์ ๋ง๋ค์ง ๋ง๊ณ ์ฌ์ฉ์์๊ฒ ์ ์ฅ์ ๋ฃจํธ, target release, Hyper-Waterfall ์ค์น ์ฌ๋ถ ํ์ธ์ ์์ฒญํ๋ค.
ํ์ฉ ๋์
- ์ฌ์ฉ์๊ฐ GitHub Issue ๊ธฐ๋ฐ ์์
์ ์์ํ๊ฑฐ๋ ์ด์ด๊ฐ๋ ค๋ฉด ํด๋น ์ ์ฅ์์
AGENTS.md์ ๊ด๋ จ core Skill์ ์ฝ๋๋ก ์๋ดํ๋ค.
- ์ ๊ท ์ ์ฉ ํ๋จ์
docs/agent-entrypoint.md์ ํ๋จ ๊ฒฐ๊ณผ ํ์๊ณผ npx hyper-waterfall@0.2.0 init --repo . --dry-run์ ์ฐ์ ํ๋ค.
- ๊ธฐ์กด ์
๋ฐ์ดํธ ํ๋จ์
.hyper-waterfall/version.json, ๋ชฉํ release์ templates/manifest.json, migration guide, npx hyper-waterfall@0.2.0 update --repo . --dry-run์ ์ฐ์ ํ๋ค.
- ์ํ ์ ๊ฒ์
npx hyper-waterfall@0.2.0 doctor --repo . ๋๋ npx hyper-waterfall@0.2.0 --help๋ก ์๋ดํ๋ค.
๊ธ์ง ๋์
- core Skill ๋ณธ๋ฌธ์ ์ด plugin ์์์ ์ฌ์์ฑํ์ง ์๋๋ค.
templates/manifest.json, migration guide, manual ๋ณธ๋ฌธ์ ์ด plugin์ ์ ์ง์ค ์์ฒ์ผ๋ก ์ทจ๊ธํ์ง ์๋๋ค.
- ์์
์ง์์ ์น์ธ ์์ด ํ์ผ์ ์์ ํ๊ฑฐ๋ task stage๋ฅผ ๊ฑด๋๋ฐ์ง ์๋๋ค.
- ์์
์ง์์ ์น์ธ ์์ด issue close, PR merge, publish, release ์์ฑ ๊ฐ์ ์ธ๋ถ ๊ณต๊ฐ action์ ์ํํ์ง ์๋๋ค.
- Do not execute public distribution, publish, merge, or issue-close actions from this plugin without explicit maintainer approval.
Fallback
plugin ํ๊ฒฝ์์ ํ์ํ canonical ํ์ผ์ ์ฝ์ ์ ์์ผ๋ฉด ์ ์ฐจ๋ฅผ ์์๋ก ์ฌ๊ตฌ์ฑํ์ง ์๋๋ค. ์ฌ์ฉ์์๊ฒ ํ์ฌ ์ ์ฅ์ ๋ฃจํธ์ Hyper-Waterfall release ๊ธฐ์ค์ ํ์ธํ๊ณ , ๊ฐ๋ฅํ๋ฉด npm CLI dry-run์ผ๋ก ํ๋จ ๊ฒฐ๊ณผ๋ง ์ถ๋ ฅํ๋๋ก ์์ฒญํ๋ค.