| ํญ๋ชฉ | ๋ด์ฉ |
|---|---|
| Invoke | /challenge:simplify |
| Category | spec-clarity |
| Complexity | moderate |
/challenge:simplify โ ๊ธฐํ์ ๊ตฐ์ด ๋นผ๊ธฐ#
ํ๋ง๋๋ก#
ํ์ ๋ ๊ธฐํ์(Seed spec)๊ฐ ๋๋ฌด ๋ณต์กํ์ง ์์์ง ์ ๊ฒํ๊ณ , ๋์ด๋ผ ๋ถ๋ถ์ ์ ์ํด ์ฃผ๋ ๋ช ๋ น์ ๋๋ค. ์ด์ฌ ๊ฐ๊ธฐ ์ ์ ์ง์ ํผ์ณ ๋๊ณ "์ด๊ฑด ์ ์จ, ์ ๊ฑด ํฉ์น์, ์ด๊ฑด ๋์ค์"๋ผ๊ณ ์ ๋ฆฌํ๋ ๊ฒ๊ณผ ๊ฐ์์.
๋๊ฐยท์ธ์ ์ฐ๋์#
- ๊ธฐํ์๋ฅผ ๋ง๋ค์๋๋ฐ ํญ๋ชฉ์ด ๋๋ฌด ๋ง์ ๋ถ๋ด์ค๋ฌ์ธ ๋
- v1(์ฒซ ์ถ์)์ ๊ผญ ํ์ํ ๊ฒ๋ง ๋จ๊ธฐ๊ณ ๊ตฐ๋๋๊ธฐ๋ฅผ ๊ฑธ๋ฌ๋ด๊ณ ์ถ์ ๋
- ๋ฌด์์ ๋นผ๊ณ ๋ฌด์์ ๋์ค์ผ๋ก ๋ฏธ๋ฃฐ์ง(v2) ๊ฐ๊ด์ ์ธ ๊ธฐ์ค์ด ํ์ํ ๋
๋ฌด์์ ํด์ฃผ๋์#
๊ธฐํ์์ ๋ณต์ก๋๋ฅผ ์ซ์๋ก ์ธก์ ํ๊ณ , ์ค์ผ ๋ฐฉ๋ฒ์ ์ ๋ฆฌํ ๋ฆฌํฌํธ๋ฅผ ๋ณด์ฌ์ค๋๋ค.
- ๋ณต์ก๋ ์ ์ โ ํญ๋ชฉ ๊ฐ์๋ฅผ ๋ฐํ์ผ๋ก ๊ณ์ฐํ ์ ์์ ํ์ (์ ์ / ์ฃผ์ / ๊ณผ๋)
- ๋จ์ํ ์ ์ ๋ชฉ๋ก โ ๋นผ๋ ๋๋ ํญ๋ชฉ, ํฉ์น ์ ์๋ ํญ๋ชฉ, ๋์ค(v2)์ผ๋ก ๋ฏธ๋ฃฐ ํญ๋ชฉ์ "์ vs ํ"๋ก ๋น๊ต
- ๊ฒฐ์ ๊ธฐ๋ก โ ๊ฐ ์ ์์ ๋ํด ์๋ฝยท๊ฑฐ์ ยท๋ณด๋ฅํ ๋ด์ฉ ๊ธฐ๋ก
์๋ฝํ ์ ์์ ๊ธฐํ์(Seed spec) ํ์ผ์ ๊ทธ๋๋ก ๋ฐ์๋๊ณ , ๋ฆฌํฌํธ๋ ํ๋ฉด์ ์ถ๋ ฅ๋ฉ๋๋ค.
์ด๋ป๊ฒ ์ฐ๋์#
/spec:simplify # ๊ฐ์ฅ ์ต๊ทผ ๊ธฐํ์๋ฅผ ๋์์ผ๋ก
/spec:simplify --file {๊ฒฝ๋ก} # ํน์ ํ์ผ์ ์ง์ ํด์
ํน์ ํ์ผ์ ์ฝ ์ง์ด ์ ๊ฒํ๋ ค๋ฉด --file ๋ค์ ํ์ผ ๊ฒฝ๋ก๋ฅผ ์ ์ต๋๋ค. ์๋ฌด๊ฒ๋ ์ ์ ์ผ๋ฉด ๊ฐ์ฅ ์ต๊ทผ ๊ธฐํ์(docs/seed-spec-*.md)๋ฅผ ์๋์ผ๋ก ์ฐพ์ต๋๋ค.
์์์ ๋ฌด์จ ์ผ์ด ๋ฒ์ด์ง๋์#
๊ธฐํ์๋ฅผ ์ฝ์ด์ ๊ตฐ์ด์ ์ง๋จํ๊ณ , ํจ๊ป ๊ฒฐ์ ํ ๋ด์ฉ์ ๋ค์ ๊ธฐํ์์ ๋ฐ์ํฉ๋๋ค.
- ๊ธฐํ์ ์ฝ๊ธฐ โ ๋์ ํ์ผ์ ๋ถ๋ฌ์ ํญ๋ชฉ๋ณ๋ก ๋ถํดํฉ๋๋ค.
- ๋ณต์ก๋ ์ธก์ โ ์ํฐํฐยท๊ด๊ณยท์ ์ฝยทํ์ ํญ๋ชฉยท๊ฒ์ฆ ์ ๋ ๊ฐ์ ์ ๊ฐ์๋ฅผ ์ธ์ด ๋ณต์ก๋ ์ ์๋ฅผ ๊ณ์ฐํฉ๋๋ค.
- ํ์ โ ์ ์์ ๋ฐ๋ผ ์ ์ (0
15) / ์ฃผ์(1630) / ๊ณผ๋(31+)๋ก ๋ถ๋ฅํฉ๋๋ค. - ๋จ์ํ ์ ์ โ ๋บ ๊ฒ, ํฉ์น ๊ฒ, ๋์ค์ผ๋ก ๋ฏธ๋ฃฐ ๊ฒ์ "์ vs ํ"๋ก ์ ๋ฆฌํด ์ ์ํฉ๋๋ค.
- ๊ฒฐ์ ๋ฐ๊ธฐ โ ์ ์๋ง๋ค ์๋ฝยท๊ฑฐ์ ยท๋ณด๋ฅ๋ฅผ ์ ํํฉ๋๋ค.
- ๋ฆฌํฌํธ ์ ๋ฆฌ โ ์ธก์ ๊ฒฐ๊ณผ + ์ ์ ๋ชฉ๋ก + ๊ฒฐ์ ๊ธฐ๋ก์ ํ๋์ ์ ๋ฆฌํฉ๋๋ค.
โ๏ธ ์์ธ ์ต์ ยท์คํ ๋ช ์ธ (๊ฐ๋ฐ์ / AI ์์ด์ ํธ์ฉ)
Usage#
/spec:simplify # Target the latest Seed spec
/spec:simplify --file {path} # Target a specific fileParameters#
| Parameter | Description | Default |
|---|---|---|
--file | Target Seed spec file | Latest docs/seed-spec-*.md |
Execution Flow#
1. Load Seed Spec#
- Read target file
- Parse each section
2. Complexity Measurement#
Calculate quantitative metrics:
- Entity count, relationship count, constraint count, Must item count, unverified assumption count
- Complexity score calculation:
(entities x 1) + (relationships x 1.5) + (constraints x 0.5) + (must x 1) + (unverified assumptions x 2)
3. Verdict#
| Score | Verdict |
|---|---|
| 0~15 | Appropriate |
| 16~30 | Caution โ Simplification review needed |
| 31+ | Excessive โ Simplification required |
4. Generate Simplification Proposals#
Before/after comparison for each proposal:
- Removal candidates: Items not contributing to core value
- Merge candidates: Similar entities/constraints
- v2 deferral candidates: Items not essential for v1
5. Collect User Decisions#
For each proposal:
- Accept: Reflect in Seed spec
- Reject: Record reason
- Defer: Review later
6. Generate Report#
- Complexity measurement results + proposal list + decision records
Output#
Report content printed to console; accepted proposals reflected in the Seed spec.
Related Commands#
/spec:challengeโ Contrarian review (can run in parallel)/spec:evaluateโ 3-stage integrated evaluation (results used in Stage 2c)/spec:seedโ Create Seed spec
References#
agents/simplifier.mdโ Detailed agent definition