@rch4com/agent-setup 1.0.0

package/lib/design-md/scan.mjs

@@ -0,0 +1,291 @@
+// design.md 디렉터리 스캔 — 프로바이더 등록 없이 **디렉터리 구조만으로** 항목을 찾는다.
+// 번들 캐시(lib/design-md/cache/<소스>/…)에 폴더를 넣거나, 외부 경로를
+// AGENT_INSTALLER_DESIGN_MD_DIRS 환경변수/`--design-dir`로 지정하면 그대로 목록에 오른다.
+// 사내에서 오프라인으로 정의한 DESIGN.md를 코드 수정 없이 포함하기 위한 경로다.
+import { existsSync, statSync, readdirSync, readFileSync, openSync, readSync, closeSync } from 'node:fs'
+import { join, dirname, basename, resolve, delimiter } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { StringDecoder } from 'node:string_decoder'
+import { isSafeSegment } from './catalog.mjs'
+import { PROVIDERS } from './providers/index.mjs'
+
+const HERE = dirname(fileURLToPath(import.meta.url))
+export const BUNDLE_DIR = join(HERE, 'cache')
+
+const DESIGN_FILE = 'DESIGN.md'
+const DESIGN_FILE_RE = /^design\.md$/i
+const MAX_DEPTH = 5 // <소스>/<카테고리…>/<이름>/DESIGN.md — 과도한 순회 방지
+const META_BYTES = 4096 // 메타데이터는 앞부분만 읽는다(전체 로드 회피)
+// getdesign.md 형식은 디자인 토큰 전체가 frontmatter라 수 KB에 이른다.
+// 닫는 구분자가 첫 창을 넘어가면 이만큼까지 늘려 다시 읽는다.
+const META_BYTES_MAX = 65536
+const MAX_DESCRIPTION = 200
+const SKIP_DIRS = new Set(['node_modules', '.git', '.svn'])
+
+const FM_OPEN = /^---[ \t]*\r?\n/
+const FM_CLOSE = /\r?\n---[ \t]*(\r?\n|$)/
+
+export const BUNDLE_CATEGORY = '기타' // 번들 캐시에서 카테고리를 못 얻었을 때
+export const LOCAL_CATEGORY = '사내' // 외부(사내) 경로에서 카테고리를 못 얻었을 때
+
+// 설치 경로 `design-md/<소스>/<이름>/`에 쓰이므로 경로에 위험한 문자만 걷어낸다.
+// 한글 등 유니코드 이름은 그대로 살린다 — 사내 디렉터리명이 대개 그렇다.
+export function sanitizeId(text) {
+  const cleaned = String(text)
+    .replace(/[\\/:*?"<>|\x00-\x1f]+/g, '-') // 경로 구분자·Windows 금지 문자·제어문자
+    .replace(/\s+/g, '-')
+    .replace(/^[-.]+|[-.]+$/g, '') // 선행·후행 점은 Windows에서 문제가 된다
+    .replace(/-{2,}/g, '-')
+  return cleaned && cleaned !== '.' && cleaned !== '..' ? cleaned : 'local'
+}
+
+// `--design-dir` / 환경변수 항목: `<경로>` 또는 `<소스id>=<경로>`.
+// id에는 경로 구분자가 올 수 없으므로 `D:\a=b` 같은 경로를 id로 오인하지 않는다.
+export function parseDirSpec(spec) {
+  const text = String(spec).trim()
+  const m = /^([^=\\/]+)=(.+)$/.exec(text)
+  const dir = resolve(m ? m[2].trim() : text)
+  return { id: m ? m[1].trim() : basename(dir), dir }
+}
+
+// 환경변수의 경로 목록. 구분자는 OS 기본(Windows `;`, POSIX `:`).
+export function extraDirsFromEnv(env = process.env) {
+  const raw = env.AGENT_INSTALLER_DESIGN_MD_DIRS
+  if (!raw) return []
+  return raw.split(delimiter).map((s) => s.trim()).filter(Boolean)
+}
+
+// 앞부분만 읽는다. 경계에서 멀티바이트 문자가 잘려도 대체 문자가 남지 않도록
+// StringDecoder로 불완전 시퀀스를 버린다.
+function readHead(file, bytes = META_BYTES) {
+  const fd = openSync(file, 'r')
+  try {
+    const buf = Buffer.alloc(bytes)
+    const n = readSync(fd, buf, 0, bytes, 0)
+    return new StringDecoder('utf8').write(buf.subarray(0, n))
+  } finally {
+    closeSync(fd)
+  }
+}
+
+// frontmatter가 첫 창 안에서 닫히지 않으면 한 번 더 크게 읽는다.
+function readMetaText(file) {
+  const head = readHead(file)
+  if (!FM_OPEN.test(head) || FM_CLOSE.test(head)) return head
+  return readHead(file, META_BYTES_MAX)
+}
+
+// DESIGN.md 본문에서 라벨·설명·카테고리를 뽑는다.
+// frontmatter(있으면)가 우선, 없으면 첫 제목 → 라벨, 첫 문단 → 설명.
+export function parseDesignMeta(text) {
+  const meta = {}
+  let body = String(text ?? '')
+
+  const open = FM_OPEN.exec(body)
+  if (open) {
+    const rest = body.slice(open[0].length)
+    const close = FM_CLOSE.exec(rest)
+    // 닫는 구분자를 못 찾으면(읽기 창보다 긴 frontmatter) 본문 후보를 비워
+    // `version: alpha` 같은 frontmatter 줄이 설명으로 새어 나가지 않게 한다.
+    const block = close ? rest.slice(0, close.index) : rest
+    body = close ? rest.slice(close.index + close[0].length) : ''
+
+    const fm = {}
+    for (const line of block.split(/\r?\n/)) {
+      // 최상위 키만 본다 — 들여쓴 줄은 디자인 토큰 같은 중첩 값이다.
+      const kv = /^([A-Za-z_][\w-]*)[ \t]*:[ \t]*(.*)$/.exec(line)
+      if (!kv) continue
+      const key = kv[1].toLowerCase()
+      const value = kv[2].trim().replace(/^["']|["']$/g, '').trim()
+      if (value) fm[key] ??= value
+    }
+    meta.label ??= fm.title || fm.label || fm.name || undefined
+    meta.category ??= fm.category
+    meta.description ??= (fm.description || fm.summary)?.slice(0, MAX_DESCRIPTION)
+    for (const key of Object.keys(meta)) if (meta[key] === undefined) delete meta[key]
+  }
+
+  let sawHeading = false
+  let fence = null // 코드블록 안에서는 어떤 줄도 설명으로 쓰지 않는다
+  for (const raw of body.split(/\r?\n/)) {
+    const line = raw.trim()
+    if (!line) continue
+    const fenceMark = /^(```+|~~~+)/.exec(line)
+    if (fenceMark) {
+      if (fence && line.startsWith(fence)) fence = null
+      else if (!fence) fence = fenceMark[1]
+      continue
+    }
+    if (fence) continue
+    const heading = /^#{1,3}\s+(.+)$/.exec(line)
+    if (heading) {
+      if (!sawHeading) {
+        meta.label ??= heading[1].trim()
+        sawHeading = true
+      }
+      continue
+    }
+    // 주석·표·구분선·목록·인용은 설명으로 쓰지 않는다.
+    if (/^(<!--|<|\||-{3,}|={3,}|[-*+]\s|\d+\.\s|>)/.test(line)) continue
+    meta.description ??= line.slice(0, MAX_DESCRIPTION)
+    if (meta.label && meta.description) break
+  }
+  return meta
+}
+
+// 디렉터리 1회 읽기로 하위 폴더와 design 파일을 함께 얻는다.
+// 읽을 수 없는 디렉터리(권한·경합)는 목록을 통째로 실패시키지 않고 건너뛴다.
+// 심볼릭 링크는 따라가지 않는다(순환 방지) — isDirectory()가 링크에는 false다.
+// 파일명은 대소문자를 가리지 않는다: 사내 문서는 `design.md`로 쓰는 경우가 많고,
+// 대소문자를 구분하는 파일시스템(Linux·macOS)에서 통째로 누락되면 안 된다.
+function readDir(dir) {
+  try {
+    if (!existsSync(dir) || !statSync(dir).isDirectory()) return { dirs: [], designFile: null }
+    const dirents = readdirSync(dir, { withFileTypes: true })
+    const designs = dirents
+      .filter((d) => d.isFile() && DESIGN_FILE_RE.test(d.name))
+      .map((d) => d.name)
+      .sort() // 여러 표기가 공존하면 결정적으로 고른다
+    return {
+      dirs: dirents
+        .filter((d) => d.isDirectory() && !d.name.startsWith('.') && !SKIP_DIRS.has(d.name))
+        .map((d) => d.name)
+        .sort(),
+      designFile: designs.includes(DESIGN_FILE) ? DESIGN_FILE : (designs[0] ?? null),
+    }
+  } catch {
+    return { dirs: [], designFile: null }
+  }
+}
+
+function subdirs(dir) {
+  return readDir(dir).dirs
+}
+
+// 디렉터리 트리에서 DESIGN.md를 찾아 엔트리로 만든다.
+// `<루트>/<카테고리…>/<이름>/DESIGN.md` — DESIGN.md가 있는 폴더가 곧 항목(리프)이다.
+// 루트 바로 아래 DESIGN.md가 있으면 루트 폴더명이 항목 이름이 된다.
+export function scanDesignDir(dir, { defaultCategory = LOCAL_CATEGORY, maxDepth = MAX_DEPTH, log } = {}) {
+  const root = resolve(dir)
+  const entries = []
+  const seen = new Set()
+
+  // 설치 경로가 `design-md/<소스>/<이름>/`이라 소스 안에서 이름이 유일해야 한다.
+  // 카테고리가 다른 동명 항목(웹/버튼, 모바일/버튼)은 카테고리를 접두사로 붙여 살린다.
+  const uniqueName = (name, segs) => {
+    if (!seen.has(name)) return name
+    const prefixed = sanitizeId([...segs.slice(0, -1), name].join('-'))
+    let candidate = prefixed
+    for (let n = 2; seen.has(candidate); n++) candidate = `${prefixed}-${n}`
+    if (log) log(`  design.md 이름이 겹쳐 '${candidate}'로 구분합니다: ${segs.join('/')}`)
+    return candidate
+  }
+
+  const visit = (current, segs, depth) => {
+    const { dirs, designFile } = readDir(current)
+    if (designFile) {
+      const file = join(current, designFile)
+      const found = segs.length > 0 ? segs[segs.length - 1] : basename(root)
+      if (found && isSafeSegment(found)) {
+        const name = uniqueName(found, segs)
+        seen.add(name)
+        let meta = {}
+        try {
+          meta = parseDesignMeta(readMetaText(file))
+        } catch {
+          // 읽기 실패는 메타데이터 없이 진행 — 목록에서 빠지지 않게 한다.
+        }
+        entries.push({
+          name,
+          label: meta.label || found,
+          category: meta.category || segs.slice(0, -1).join(' / ') || defaultCategory,
+          description: meta.description || '',
+          file,
+        })
+      }
+      return // 항목 폴더 안쪽은 더 내려가지 않는다
+    }
+    if (depth >= maxDepth) return
+    for (const sub of dirs) visit(join(current, sub), [...segs, sub], depth + 1)
+  }
+
+  visit(root, [], 0)
+  return entries.sort((a, b) => a.name.localeCompare(b.name))
+}
+
+// 스캔한 디렉터리를 프로바이더 인터페이스로 감싼다.
+// 네트워크 원본이 없으므로 로컬 파일이 곧 최신본이고, 웹 미리보기 URL은 없다.
+export function makeDirProvider({ id, label, dir, entries }) {
+  const files = new Map(entries.map((e) => [e.name, e.file]))
+  return {
+    id,
+    label,
+    dir,
+    local: true,
+    files: [DESIGN_FILE],
+
+    fileUrl(name) {
+      return files.get(name) ?? null
+    },
+
+    webUrl() {
+      return null // 로컬 정의는 getdesign.md 페이지가 없다
+    },
+
+    bundledText(name) {
+      const file = files.get(name)
+      if (!file || !existsSync(file)) return null
+      return readFileSync(file, 'utf8')
+    },
+
+    // fresh 업데이트도 같은 로컬 파일을 읽는다 — 디렉터리가 곧 원본이다.
+    async fetchFile(fetchImpl, name) {
+      return this.bundledText(name)
+    },
+
+    async fetchCatalog() {
+      return entries.map(({ file, ...rest }) => rest)
+    },
+  }
+}
+
+// 번들 캐시 하위 디렉터리 + 지정한 외부 경로를 소스 목록으로 만든다.
+// 반환: [{ id, dir, label, bundled, entries, provider }]
+export function discoverSources({ bundleDir = BUNDLE_DIR, extraDirs = [], reservedIds, log } = {}) {
+  const sources = []
+  const usedIds = new Set()
+  // 등록된 프로바이더 id는 번들 캐시 전용이다. 외부 경로가 그 id를 차지하면
+  // 로컬 파일 대신 네트워크로 나가버리므로 접미사로 비켜 간다.
+  const reserved = new Set(reservedIds ?? PROVIDERS.map((p) => p.id))
+
+  const add = ({ id, dir, bundled, defaultCategory }) => {
+    const entries = scanDesignDir(dir, { defaultCategory, log })
+    if (entries.length === 0) {
+      if (!bundled && log) log(`  design.md 소스에 DESIGN.md가 없습니다: ${dir}`)
+      return
+    }
+    const base = sanitizeId(id)
+    const taken = (candidate) => usedIds.has(candidate) || (!bundled && reserved.has(candidate))
+    let uid = base
+    for (let n = 2; taken(uid); n++) uid = `${base}-${n}`
+    if (uid !== base && log) log(`  design.md 소스 id가 겹쳐 '${uid}'로 사용합니다: ${dir}`)
+    usedIds.add(uid)
+    const label = bundled ? uid : `${uid} (로컬)`
+    sources.push({ id: uid, dir, label, bundled, entries, provider: makeDirProvider({ id: uid, label, dir, entries }) })
+  }
+
+  for (const name of subdirs(bundleDir)) {
+    // 캐시에 직접 넣은 사내 소스는 등록 프로바이더가 없다 — 기본 카테고리를 달리 준다.
+    const defaultCategory = reserved.has(sanitizeId(name)) ? BUNDLE_CATEGORY : LOCAL_CATEGORY
+    add({ id: name, dir: join(bundleDir, name), bundled: true, defaultCategory })
+  }
+  for (const spec of extraDirs) {
+    const { id, dir } = parseDirSpec(spec)
+    if (!existsSync(dir)) {
+      if (log) log(`  design.md 경로를 찾을 수 없습니다: ${dir}`)
+      continue
+    }
+    add({ id, dir, bundled: false, defaultCategory: LOCAL_CATEGORY })
+  }
+  return sources
+}

package/lib/engine.mjs

@@ -0,0 +1,44 @@
+import { makeExec } from './catalog.mjs'
+
+export async function scan(root, items) {
+  const states = []
+  for (const item of items) {
+    try {
+      const r = await item.detect({ root })
+      states.push({ item, status: r.status, detail: r.detail })
+    } catch (err) {
+      states.push({ item, status: 'absent', detail: `감지 실패: ${err.message}` })
+    }
+  }
+  return states
+}
+
+export function planChanges(states, selectedIds) {
+  const changes = []
+  for (const { item, status } of states) {
+    const selected = selectedIds.has(item.id)
+    if (selected && status === 'absent') changes.push({ item, action: 'install' })
+    else if (selected && status === 'partial') changes.push({ item, action: 'complete' })
+    else if (!selected && status !== 'absent') changes.push({ item, action: 'uninstall' })
+  }
+  return changes
+}
+
+export async function apply(root, changes, { dryRun = false, log = console.log } = {}) {
+  const exec = makeExec(dryRun, log)
+  const results = []
+  for (const { item, action } of changes) {
+    // log까지 넘긴다 — 파일을 직접 쓰는 항목(MCP·design.md)은 exec를 거치지
+    // 않아 dry-run에서 아무것도 보고하지 못했다. 결과줄은 ✔ 설치라고 찍히는데
+    // 무엇이 바뀔지는 알 수 없는 상태였다.
+    const ctx = { root, dryRun, exec, log }
+    try {
+      const fn = action === 'uninstall' ? item.uninstall : item.install
+      const r = await fn.call(item, ctx)
+      results.push({ item, action, ok: true, message: r?.message })
+    } catch (err) {
+      results.push({ item, action, ok: false, message: err.message })
+    }
+  }
+  return results
+}

package/lib/gitignore.mjs

@@ -0,0 +1,18 @@
+import { readFileSync, writeFileSync, existsSync } from 'node:fs'
+import { repoPathStrict } from './context.mjs'
+
+export function ensureGitignoreEntries(root, entries) {
+  // 함수의 목적 자체가 쓰기이므로 맨 앞에서 한 번 엄격 검사한다 —
+  // bootstrap의 ensureIgnore와 같은 규칙. 어휘적 검사만으로는 .gitignore가
+  // 저장소 밖을 가리키는 링크일 때를 막지 못한다.
+  const file = repoPathStrict(root, '.gitignore')
+  const text = existsSync(file) ? readFileSync(file, 'utf8') : ''
+  const lines = new Set(text.split(/\r?\n/))
+  const missing = entries.filter((e) => !lines.has(e))
+  if (missing.length === 0) return
+  // 파일의 우세 줄바꿈을 따른다 — CRLF 파일에 덧붙인 줄만 LF로 섞이지 않게.
+  // apply.mjs의 ensureJsonKeys가 JSON에 대해 지키는 규칙과 같다.
+  const eol = text.includes('\r\n') ? '\r\n' : '\n'
+  const sep = text.length === 0 || text.endsWith('\n') ? '' : eol
+  writeFileSync(file, text + sep + missing.join(eol) + eol)
+}

package/lib/items/.omc/state/sessions/a859aff7-59d9-4ff6-afc6-8cafe4471dc4/pre-tool-advisory-throttle.json

@@ -0,0 +1,14 @@
+{
+  "version": 1,
+  "entries": {
+    "79a93d4a2f8f50b95f852280616242fee1855dc99a3c75211917f55e72e95fae": {
+      "last_emitted_at_ms": 1785327065269,
+      "message": "Use parallel execution for independent tasks. Use run_in_background for long operations (npm install, builds, tests)."
+    },
+    "466399dafa2d20f60587180bad0a07358eb7f2bce724df0ff682f038ad33f5ad": {
+      "last_emitted_at_ms": 1785327034117,
+      "message": "Read multiple files in parallel when possible for faster analysis."
+    }
+  },
+  "updated_at": "2026-07-29T12:11:05.269Z"
+}

package/lib/items/mcp.codebase-memory.mjs

@@ -0,0 +1,6 @@
+import { defineMcp } from '../catalog.mjs'
+export default defineMcp({
+  id: 'mcp.codebase-memory', label: 'Codebase Memory MCP',
+  server: { kind: 'stdio', command: 'codebase-memory-mcp', args: [] },
+  note: 'PATH에 codebase-memory-mcp 바이너리 필요. 설치: https://github.com/DeusData/codebase-memory-mcp (install.sh / install.ps1)',
+})

package/lib/items/mcp.notion.mjs

@@ -0,0 +1,6 @@
+import { defineMcp } from '../catalog.mjs'
+export default defineMcp({
+  id: 'mcp.notion', label: 'Notion MCP',
+  server: { kind: 'http', url: 'https://mcp.notion.com/mcp' },
+  note: '인증: 각 CLI 첫 사용 시 OAuth',
+})

package/lib/items/mcp.supabase.mjs

@@ -0,0 +1,6 @@
+import { defineMcp } from '../catalog.mjs'
+export default defineMcp({
+  id: 'mcp.supabase', label: 'Supabase MCP',
+  server: { kind: 'http', url: 'https://mcp.supabase.com/mcp' },
+  note: '인증: OAuth 동적 등록. 프로젝트 고정이 필요하면 URL에 ?project_ref=<id> 추가',
+})

package/lib/items/mcp.vercel.mjs

@@ -0,0 +1,6 @@
+import { defineMcp } from '../catalog.mjs'
+export default defineMcp({
+  id: 'mcp.vercel', label: 'Vercel MCP',
+  server: { kind: 'http', url: 'https://mcp.vercel.com' },
+  note: '인증: 첫 사용 시 OAuth (승인된 클라이언트만 연결 가능)',
+})

package/lib/items/plugin.bkit.mjs

@@ -0,0 +1,7 @@
+import { definePlugin } from '../catalog.mjs'
+export default definePlugin({
+  id: 'plugin.bkit', label: 'bkit',
+  installId: 'bkit@bkit-marketplace',
+  detectIds: ['bkit@bkit-marketplace'],
+  marketplace: { name: 'bkit-marketplace', repo: 'popup-studio-ai/bkit-claude-code' },
+})

package/lib/items/plugin.mattpocock-skills.mjs

@@ -0,0 +1,8 @@
+import { definePlugin } from '../catalog.mjs'
+export default definePlugin({
+  id: 'plugin.mattpocock-skills', label: 'Matt Pocock skills',
+  installId: 'mattpocock-skills@mattpocock',
+  detectIds: ['mattpocock-skills@mattpocock'],
+  marketplace: { name: 'mattpocock', repo: 'mattpocock/skills' },
+  note: '엔지니어링·생산성 스킬 22종 (tdd, code-review, research 등)',
+})

package/lib/items/plugin.superpowers.mjs

@@ -0,0 +1,7 @@
+import { definePlugin } from '../catalog.mjs'
+export default definePlugin({
+  id: 'plugin.superpowers', label: 'superpowers',
+  installId: 'superpowers@claude-plugins-official',
+  detectIds: ['superpowers@claude-plugins-official', 'superpowers@superpowers-marketplace'],
+  note: '공식 마켓플레이스 플러그인',
+})

package/lib/items/skill.gsd.mjs

@@ -0,0 +1,24 @@
+import { existsSync, readdirSync } from 'node:fs'
+import { join } from 'node:path'
+import { defineSkill } from '../catalog.mjs'
+
+function hasGsdFiles(dir) {
+  return existsSync(dir) && readdirSync(dir).some((f) => f.startsWith('gsd-'))
+}
+
+export default defineSkill({
+  id: 'skill.gsd', label: 'GSD (Get Shit Done)', scope: 'project',
+  note: 'npx @opengsd/gsd-core 프로젝트 로컬 설치',
+  async detect({ root }) {
+    const found = hasGsdFiles(join(root, '.claude', 'commands')) || hasGsdFiles(join(root, '.claude', 'skills'))
+    return { status: found ? 'installed' : 'absent' }
+  },
+  async install({ root, exec }) {
+    const r = exec('npx', ['-y', '@opengsd/gsd-core@latest', '--claude', '--local'], { cwd: root })
+    if (!r.ok) throw new Error(`GSD 설치 실패: ${r.output}`)
+  },
+  async uninstall({ root, exec }) {
+    const r = exec('npx', ['-y', '@opengsd/gsd-core@latest', '--uninstall'], { cwd: root })
+    if (!r.ok) throw new Error(`GSD 제거 실패: ${r.output}`)
+  },
+})

package/lib/items/skill.gstack.mjs

@@ -0,0 +1,39 @@
+import { existsSync, rmSync } from 'node:fs'
+import { join } from 'node:path'
+import { defineSkill } from '../catalog.mjs'
+import { repoPath, repoPathStrict } from '../context.mjs'
+import { ensureGitignoreEntries } from '../gitignore.mjs'
+
+const REL_DIR = '.claude/skills/gstack'
+
+export default defineSkill({
+  id: 'skill.gstack', label: 'gstack', scope: 'project',
+  note: '저장소 로컬 clone + setup (bash 필요, Windows는 Git Bash). 런타임 상태(~/.gstack)는 전역에 생길 수 있음.',
+  async detect({ root }) {
+    return { status: existsSync(repoPath(root, REL_DIR)) ? 'installed' : 'absent' }
+  },
+  async install({ root, dryRun, exec }) {
+    // clone·삭제가 일어나는 경로다. 어휘적 검사만으로는 .claude/skills가
+    // 저장소 밖을 가리키는 링크일 때를 막지 못한다(부트스트랩이 만드는
+    // .agents/skills Junction은 저장소 안이라 그대로 통과한다).
+    const dir = repoPathStrict(root, REL_DIR)
+    if (!existsSync(dir)) {
+      const clone = exec('git', ['clone', '--single-branch', '--depth', '1', 'https://github.com/garrytan/gstack.git', dir])
+      if (!clone.ok) throw new Error(`gstack clone 실패: ${clone.output}`)
+      const setup = exec('bash', ['./setup'], { cwd: dir })
+      if (!setup.ok) {
+        // setup 실패 잔존물이 detect를 installed로 오판시키지 않도록 정리한다.
+        rmSync(dir, { recursive: true, force: true })
+        throw new Error(`gstack setup 실패: ${setup.output}`)
+      }
+    }
+    // 부트스트랩 저장소에서는 .claude/skills가 .agents/skills Junction이므로 두 경로 모두 무시 처리
+    if (!dryRun) ensureGitignoreEntries(root, ['.claude/skills/gstack', '.agents/skills/gstack'])
+  },
+  async uninstall({ root, dryRun, exec }) {
+    const dir = repoPathStrict(root, REL_DIR)
+    if (!existsSync(dir)) return
+    exec('bash', [join(dir, 'bin', 'gstack-uninstall'), '--force'], { cwd: dir }) // 실패해도 디렉터리 삭제로 폴백
+    if (!dryRun && existsSync(dir)) rmSync(dir, { recursive: true, force: true })
+  },
+})

package/lib/jsonfile.mjs

@@ -0,0 +1,40 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs'
+import { dirname } from 'node:path'
+import { parse, modify, applyEdits } from 'jsonc-parser'
+
+const FORMAT = { formattingOptions: { insertSpaces: true, tabSize: 2 } }
+
+function readText(file) {
+  return existsSync(file) ? readFileSync(file, 'utf8') : ''
+}
+
+export function readJson(file) {
+  const text = readText(file)
+  if (!text.trim()) return undefined
+  return parse(text)
+}
+
+export function setKey(file, path, value) {
+  let text = readText(file)
+  if (!text.trim()) text = '{}\n'
+  const edits = modify(text, path, value, FORMAT)
+  mkdirSync(dirname(file), { recursive: true })
+  writeFileSync(file, applyEdits(text, edits))
+}
+
+export function removeKey(file, path) {
+  const text = readText(file)
+  if (!text.trim()) return
+  if (getIn(parse(text), path) === undefined) return
+  const edits = modify(text, path, undefined, FORMAT)
+  writeFileSync(file, applyEdits(text, edits))
+}
+
+export function getIn(data, path) {
+  let cur = data
+  for (const key of path) {
+    if (cur == null || typeof cur !== 'object') return undefined
+    cur = cur[key]
+  }
+  return cur
+}

package/lib/tomlfile.mjs

@@ -0,0 +1,60 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs'
+import { dirname } from 'node:path'
+import { parse } from 'smol-toml'
+
+function readText(file) {
+  return existsSync(file) ? readFileSync(file, 'utf8') : ''
+}
+
+function escapeRegExp(text) {
+  return text.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+}
+
+export function hasSection(file, name) {
+  const text = readText(file)
+  if (!text.trim()) return false
+  try {
+    const data = parse(text)
+    return data.mcp_servers != null && Object.hasOwn(data.mcp_servers, name)
+  } catch {
+    return false
+  }
+}
+
+export function appendSection(file, name, lines) {
+  let text = readText(file)
+  if (text.length > 0 && !text.endsWith('\n')) text += '\n'
+  const separator = text.length > 0 ? '\n' : ''
+  text += `${separator}[mcp_servers.${name}]\n${lines.join('\n')}\n`
+  mkdirSync(dirname(file), { recursive: true })
+  writeFileSync(file, text)
+}
+
+export function removeSection(file, name) {
+  const text = readText(file)
+  if (!text) return
+  const lines = text.split('\n')
+  const headerRe = new RegExp(`^\\s*\\[mcp_servers\\.${escapeRegExp(name)}(\\.|\\])`)
+  const anyHeaderRe = /^\s*\[/
+  const out = []
+  let skipping = false
+  let removedAt = -1
+  for (const line of lines) {
+    if (skipping && anyHeaderRe.test(line) && !headerRe.test(line)) skipping = false
+    if (headerRe.test(line)) {
+      skipping = true
+      if (removedAt === -1) removedAt = out.length
+    }
+    if (!skipping) out.push(line)
+  }
+  // 제거 지점의 경계에서만 빈 줄 하나를 정리해, 다른 위치의 빈 줄들은 그대로 보존한다.
+  if (
+    removedAt > 0 &&
+    removedAt < out.length &&
+    out[removedAt - 1].trim() === '' &&
+    (out[removedAt] ?? '').trim() === ''
+  ) {
+    out.splice(removedAt - 1, 1)
+  }
+  writeFileSync(file, out.join('\n'))
+}