LogoSkills

challenge:simplify

Simplifier Complexity Reduction โ€” Identify unnecessary complexity and propose simplifications

ํ•ญ๋ชฉ๋‚ด์šฉ
Invoke/challenge:simplify
Categoryspec-clarity
Complexitymoderate

/challenge:simplify โ€” ๊ธฐํš์„œ ๊ตฐ์‚ด ๋นผ๊ธฐ#

ํ•œ๋งˆ๋””๋กœ#

ํ™•์ •๋œ ๊ธฐํš์„œ(Seed spec)๊ฐ€ ๋„ˆ๋ฌด ๋ณต์žกํ•˜์ง€ ์•Š์€์ง€ ์ ๊ฒ€ํ•˜๊ณ , ๋œ์–ด๋‚ผ ๋ถ€๋ถ„์„ ์ œ์•ˆํ•ด ์ฃผ๋Š” ๋ช…๋ น์ž…๋‹ˆ๋‹ค. ์ด์‚ฌ ๊ฐ€๊ธฐ ์ „์— ์ง์„ ํŽผ์ณ ๋†“๊ณ  "์ด๊ฑด ์•ˆ ์จ, ์ €๊ฑด ํ•ฉ์น˜์ž, ์ด๊ฑด ๋‚˜์ค‘์—"๋ผ๊ณ  ์ •๋ฆฌํ•˜๋Š” ๊ฒƒ๊ณผ ๊ฐ™์•„์š”.

๋ˆ„๊ฐ€ยท์–ธ์ œ ์“ฐ๋‚˜์š”#

  • ๊ธฐํš์„œ๋ฅผ ๋งŒ๋“ค์—ˆ๋Š”๋ฐ ํ•ญ๋ชฉ์ด ๋„ˆ๋ฌด ๋งŽ์•„ ๋ถ€๋‹ด์Šค๋Ÿฌ์šธ ๋•Œ
  • v1(์ฒซ ์ถœ์‹œ)์— ๊ผญ ํ•„์š”ํ•œ ๊ฒƒ๋งŒ ๋‚จ๊ธฐ๊ณ  ๊ตฐ๋”๋”๊ธฐ๋ฅผ ๊ฑธ๋Ÿฌ๋‚ด๊ณ  ์‹ถ์„ ๋•Œ
  • ๋ฌด์—‡์„ ๋นผ๊ณ  ๋ฌด์—‡์„ ๋‚˜์ค‘์œผ๋กœ ๋ฏธ๋ฃฐ์ง€(v2) ๊ฐ๊ด€์ ์ธ ๊ธฐ์ค€์ด ํ•„์š”ํ•  ๋•Œ

๋ฌด์—‡์„ ํ•ด์ฃผ๋‚˜์š”#

๊ธฐํš์„œ์˜ ๋ณต์žก๋„๋ฅผ ์ˆซ์ž๋กœ ์ธก์ •ํ•˜๊ณ , ์ค„์ผ ๋ฐฉ๋ฒ•์„ ์ •๋ฆฌํ•œ ๋ฆฌํฌํŠธ๋ฅผ ๋ณด์—ฌ์ค๋‹ˆ๋‹ค.

  • ๋ณต์žก๋„ ์ ์ˆ˜ โ€” ํ•ญ๋ชฉ ๊ฐœ์ˆ˜๋ฅผ ๋ฐ”ํƒ•์œผ๋กœ ๊ณ„์‚ฐํ•œ ์ ์ˆ˜์™€ ํŒ์ •(์ ์ • / ์ฃผ์˜ / ๊ณผ๋„)
  • ๋‹จ์ˆœํ™” ์ œ์•ˆ ๋ชฉ๋ก โ€” ๋นผ๋„ ๋˜๋Š” ํ•ญ๋ชฉ, ํ•ฉ์น  ์ˆ˜ ์žˆ๋Š” ํ•ญ๋ชฉ, ๋‚˜์ค‘(v2)์œผ๋กœ ๋ฏธ๋ฃฐ ํ•ญ๋ชฉ์„ "์ „ vs ํ›„"๋กœ ๋น„๊ต
  • ๊ฒฐ์ • ๊ธฐ๋ก โ€” ๊ฐ ์ œ์•ˆ์— ๋Œ€ํ•ด ์ˆ˜๋ฝยท๊ฑฐ์ ˆยท๋ณด๋ฅ˜ํ•œ ๋‚ด์šฉ ๊ธฐ๋ก

์ˆ˜๋ฝํ•œ ์ œ์•ˆ์€ ๊ธฐํš์„œ(Seed spec) ํŒŒ์ผ์— ๊ทธ๋Œ€๋กœ ๋ฐ˜์˜๋˜๊ณ , ๋ฆฌํฌํŠธ๋Š” ํ™”๋ฉด์— ์ถœ๋ ฅ๋ฉ๋‹ˆ๋‹ค.

์–ด๋–ป๊ฒŒ ์“ฐ๋‚˜์š”#

/spec:simplify                       # ๊ฐ€์žฅ ์ตœ๊ทผ ๊ธฐํš์„œ๋ฅผ ๋Œ€์ƒ์œผ๋กœ
/spec:simplify --file {๊ฒฝ๋กœ}          # ํŠน์ • ํŒŒ์ผ์„ ์ง€์ •ํ•ด์„œ

ํŠน์ • ํŒŒ์ผ์„ ์ฝ• ์ง‘์–ด ์ ๊ฒ€ํ•˜๋ ค๋ฉด --file ๋’ค์— ํŒŒ์ผ ๊ฒฝ๋กœ๋ฅผ ์ ์Šต๋‹ˆ๋‹ค. ์•„๋ฌด๊ฒƒ๋„ ์•ˆ ์ ์œผ๋ฉด ๊ฐ€์žฅ ์ตœ๊ทผ ๊ธฐํš์„œ(docs/seed-spec-*.md)๋ฅผ ์ž๋™์œผ๋กœ ์ฐพ์Šต๋‹ˆ๋‹ค.

์•ˆ์—์„œ ๋ฌด์Šจ ์ผ์ด ๋ฒŒ์–ด์ง€๋‚˜์š”#

๊ธฐํš์„œ๋ฅผ ์ฝ์–ด์„œ ๊ตฐ์‚ด์„ ์ง„๋‹จํ•˜๊ณ , ํ•จ๊ป˜ ๊ฒฐ์ •ํ•œ ๋‚ด์šฉ์„ ๋‹ค์‹œ ๊ธฐํš์„œ์— ๋ฐ˜์˜ํ•ฉ๋‹ˆ๋‹ค.

  1. ๊ธฐํš์„œ ์ฝ๊ธฐ โ€” ๋Œ€์ƒ ํŒŒ์ผ์„ ๋ถˆ๋Ÿฌ์™€ ํ•ญ๋ชฉ๋ณ„๋กœ ๋ถ„ํ•ดํ•ฉ๋‹ˆ๋‹ค.
  2. ๋ณต์žก๋„ ์ธก์ • โ€” ์—”ํ„ฐํ‹ฐยท๊ด€๊ณ„ยท์ œ์•ฝยทํ•„์ˆ˜ ํ•ญ๋ชฉยท๊ฒ€์ฆ ์•ˆ ๋œ ๊ฐ€์ •์˜ ๊ฐœ์ˆ˜๋ฅผ ์„ธ์–ด ๋ณต์žก๋„ ์ ์ˆ˜๋ฅผ ๊ณ„์‚ฐํ•ฉ๋‹ˆ๋‹ค.
  3. ํŒ์ • โ€” ์ ์ˆ˜์— ๋”ฐ๋ผ ์ ์ •(015) / ์ฃผ์˜(1630) / ๊ณผ๋„(31+)๋กœ ๋ถ„๋ฅ˜ํ•ฉ๋‹ˆ๋‹ค.
  4. ๋‹จ์ˆœํ™” ์ œ์•ˆ โ€” ๋บ„ ๊ฒƒ, ํ•ฉ์น  ๊ฒƒ, ๋‚˜์ค‘์œผ๋กœ ๋ฏธ๋ฃฐ ๊ฒƒ์„ "์ „ vs ํ›„"๋กœ ์ •๋ฆฌํ•ด ์ œ์•ˆํ•ฉ๋‹ˆ๋‹ค.
  5. ๊ฒฐ์ • ๋ฐ›๊ธฐ โ€” ์ œ์•ˆ๋งˆ๋‹ค ์ˆ˜๋ฝยท๊ฑฐ์ ˆยท๋ณด๋ฅ˜๋ฅผ ์„ ํƒํ•ฉ๋‹ˆ๋‹ค.
  6. ๋ฆฌํฌํŠธ ์ •๋ฆฌ โ€” ์ธก์ • ๊ฒฐ๊ณผ + ์ œ์•ˆ ๋ชฉ๋ก + ๊ฒฐ์ • ๊ธฐ๋ก์„ ํ•œ๋ˆˆ์— ์ •๋ฆฌํ•ฉ๋‹ˆ๋‹ค.

โš™๏ธ ์ƒ์„ธ ์˜ต์…˜ยท์‹คํ–‰ ๋ช…์„ธ (๊ฐœ๋ฐœ์ž / AI ์—์ด์ „ํŠธ์šฉ)

Usage#

/spec:simplify                       # Target the latest Seed spec
/spec:simplify --file {path}         # Target a specific file

Parameters#

ParameterDescriptionDefault
--fileTarget Seed spec fileLatest 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#

ScoreVerdict
0~15Appropriate
16~30Caution โ€” 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.

  • /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