| name | hyper-waterfall |
| description | Use when the user wants to apply or run the Hyper-Waterfall workflow from Claude Code. Read the repository canonical files and route the task through the existing Hyper-Waterfall gates instead of redefining the workflow. |
Hyper-Waterfall Claude Entrypoint
์ด plugin Skill์ Hyper-Waterfall ์ ์ฐจ์ ์ ์ง์ค ์์ฒ์ด ์๋๋ค. Claude Code์์ Hyper-Waterfall ์ง์
์ ์ ์ฐพ๊ธฐ ์ฝ๊ฒ ํ๋ ์์ wrapper๋ค.
์ฐ์ ์ฝ์ ํ์ผ
๋์ ์ ์ฅ์์์ ๋ค์ ํ์ผ์ ์์๋๋ก ํ์ธํ๋ค.
AGENTS.md
CLAUDE.md
docs/agent-entrypoint.md
templates/manifest.json
.claude/skills
mydocs/skills
ํ์ผ์ด ์๊ฑฐ๋ ๊ฒฝ๋ก๊ฐ ๋ค๋ฅด๋ฉด ์ถ์ธก์ผ๋ก ์ ์ฐจ๋ฅผ ๋ง๋ค์ง ๋ง๊ณ ์์
์ง์์์๊ฒ ํ์ธํ๋ค.
์ ๊ท ์ ์ฉ ์์ฒญ
์ฌ์ฉ์๊ฐ Hyper-Waterfall์ ์ ์ ์ฅ์์ ์ ์ฉํด ๋ฌ๋ผ๊ณ ์์ฒญํ๋ฉด docs/agent-entrypoint.md์ ์ ๊ท ์ ์ฉ ํ๋จ ๊ฒฐ๊ณผ ํ์์ ๋ฐ๋ฅธ๋ค.
ํ์ผ์ ๋ณ๊ฒฝํ๊ธฐ ์ ์ ์ต์ํ ๋ค์์ ๋ณด๊ณ ํ๋ค.
- ๋์ ์ ์ฅ์ ๋ฃจํธ์ ๊ธฐ์ค ๋ธ๋์น
- ์ ์ฉํ Hyper-Waterfall release ๋๋ tag
templates/manifest.json ๊ธฐ์ค ์ ์ฉ ํ๋ณด
- ๊ธฐ์กด ํ์ผ ์ถฉ๋ ๊ฐ๋ฅ์ฑ
- placeholder ์นํ ๋์
- ์์
์ง์์ ์น์ธ ์์ฒญ
์น์ธ ์ ์๋ ๋์ ์ ์ฅ์ ํ์ผ์ ์ ์ฉํ๊ฑฐ๋ ๋ฎ์ด์ฐ์ง ์๋๋ค.
๊ธฐ์กด ์ ์ฉ ์ ์ฅ์ ์
๋ฐ์ดํธ ์์ฒญ
๊ธฐ์กด ์ ์ฉ ์ ์ฅ์๋ฅผ ์ version์ผ๋ก ์ฌ๋ฆฌ๋ ์์ฒญ์ด๋ฉด docs/agent-entrypoint.md์ ๊ธฐ์กด ์
๋ฐ์ดํธ ํ๋จ ๊ฒฐ๊ณผ ํ์์ ๋ฐ๋ฅธ๋ค.
ํ์ธํ ๊ธฐ์ค์ ๋ค์์ด๋ค.
- ๋์ ์ ์ฅ์์
.hyper-waterfall/version.json
- ๋ชฉํ GitHub Release ๋๋ tag
- ๋ชฉํ release์
templates/manifest.json
docs/migrations/
- ์ฌ์ฉ์ ์์ ๊ฐ๋ฅ ํ์ผ๊ณผ conflict ํ๋ณด
ํ๋จ ๊ฒฐ๊ณผ๊ฐ ์น์ธ๋๋ฉด ์ผ๋ฐ task ํ๋ฆ์ผ๋ก ์ ํํ๋ค. ์ด์, ๋ธ๋์น, ์ํ๊ณํ์, ๊ตฌํ๊ณํ์, Stage ๋ณด๊ณ ์, ์ต์ข
๋ณด๊ณ ์, PR์ ์๋ตํ์ง ์๋๋ค.
์ด๋ฏธ ์ ์ฉ๋ ์ ์ฅ์์ task ์์ฒญ
์ด๋ฏธ Hyper-Waterfall์ด ์ ์ฉ๋ ์ ์ฅ์์์ ์ด์ ์์
์ ์์ฒญ๋ฐ์ผ๋ฉด .claude/skills ๋๋ mydocs/skills์ canonical Skill์ ์ฌ์ฉํ๋ค.
๋ํ ํ๋ฆ:
- task ์์:
task-start
- ๋จ๊ณ ์ข
๋ฃ:
task-stage-report
- ์ต์ข
๋ณด๊ณ ์ PR:
task-final-report
- PR merge ํ ์ ๋ฆฌ:
pr-merge-cleanup
๊ฐ ๋จ๊ณ ์ ํ์ ์์
์ง์์์ ๋ช
์ ์น์ธ์ด ์์ ๋๋ง ์งํํ๋ค.
CLI fallback
npm CLI๊ฐ ์ฌ์ฉ ๊ฐ๋ฅํ ํ๊ฒฝ์ด๋ฉด dry-run ๋๋ ๋์๋ง ๊ฒฝ๋ก๋ฅผ ํ์ธํ ์ ์๋ค.
npx hyper-waterfall@0.2.0 --help
CLI ์ถ๋ ฅ์ ํ๋จ ๋ณด์กฐ๋ค. CLI๊ฐ ์คํจํด๋ ์น์ธ ์ ํ์ผ ์ ์ฉ์ ์งํํ์ง ์๊ณ , AGENTS.md, CLAUDE.md, manual, Skill ์ ์ฐจ๋ก fallbackํ๋ค.
๊ธ์ง
- Hyper-Waterfall ์ ์ฐจ๋ฅผ ์ด plugin ์์์ ์๋ก ์์ฝํด canonical ๊ท์น์ฒ๋ผ ์ทจ๊ธํ์ง ์๋๋ค.
templates/manifest.json, migration guide, core Skill ๋ณธ๋ฌธ์ plugin ์ ์ฉ ์ง์ค ์์ฒ์ผ๋ก ๋ณต์ ํ์ง ์๋๋ค.
- ์์
์ง์์ ์น์ธ, ์ด์ ์ถ์ , Stage ๋ณด๊ณ , PR ํ๋ฆ์ ์ฐํํ์ง ์๋๋ค.
- public publish, issue close, PR merge ๊ฐ์ ์ธ๋ถ ์ํ ๋ณ๊ฒฝ์ ๋ณ๋ ์น์ธ ์์ด ์คํํ์ง ์๋๋ค.
- hook์ด๋ permission ์ค์ ์ ์น์ธ ์๋ํ ์ฅ์น๋ก ์ฌ์ฉํ์ง ์๋๋ค.