@rch4com/agent-setup 1.0.0

package/lib/bootstrap/apply.mjs

@@ -0,0 +1,269 @@
+// 매니페스트 선언을 실제 파일시스템 변경으로 옮기는 실행기.
+// 추가 전용 — 여기에는 삭제 경로가 없다.
+import { lstatSync, mkdirSync, writeFileSync, readFileSync, appendFileSync } from 'node:fs'
+import { dirname } from 'node:path'
+import { repoPath, repoPathStrict } from '../context.mjs'
+import { ensureGitignoreEntries } from '../gitignore.mjs'
+
+// existsSync는 깨진 심볼릭 링크에 false를 반환한다. 그대로 쓰면 사용자가 만든
+// 링크를 덮어쓰게 되므로 lstat으로 "항목이 있는가"를 본다.
+export function pathExists(target) {
+  try {
+    lstatSync(target)
+    return true
+  } catch {
+    return false
+  }
+}
+
+// 두 OS가 같은 파일을 만들도록 항상 LF + 끝 개행 1개로 정규화한다.
+// writeText(새 파일)와 ensureBlocks의 덧붙이기(기존 파일) 양쪽에서 쓴다 —
+// 덧붙이기도 이 정규화를 거치지 않으면 CRLF가 LF 파일에 새어 들어간다.
+function normalizeBody(text) {
+  return text.replace(/\r\n/g, '\n').trim() + '\n'
+}
+
+function writeText(file, text) {
+  const body = normalizeBody(text)
+  mkdirSync(dirname(file), { recursive: true })
+  writeFileSync(file, body, { encoding: 'utf8' })
+}
+
+export function ensureDirs(root, dirs, { dryRun = false, log }) {
+  return dirs.map((rel) => {
+    // 존재 확인은 어휘적 경로로 한다 — 만들지 않을 것이면 지켜야 할 쓰기도 없다.
+    if (pathExists(repoPath(root, rel))) return { ok: true, action: 'skip', path: rel }
+    // 실제로 만드는 경로만 엄격 검사한다(링크를 통한 저장소 이탈 차단).
+    // 검사가 던지면 하지 않은 동작을 보고하지 않도록 로그보다 먼저 수행한다.
+    const target = repoPathStrict(root, rel)
+    log(`디렉터리 생성: ${rel}`)
+    if (!dryRun) mkdirSync(target, { recursive: true })
+    return { ok: true, action: 'create', path: rel }
+  })
+}
+
+export function ensureFiles(root, files, { dryRun = false, log }) {
+  return files.map(({ path: rel, template }) => {
+    // 깨진 링크도 lstat으로는 존재한다 — 내용을 보지 않고 그대로 보존한다.
+    if (pathExists(repoPath(root, rel))) {
+      log(`기존 파일 유지: ${rel}`)
+      return { ok: true, action: 'keep', path: rel }
+    }
+    // 검사가 던지면 하지 않은 동작을 보고하지 않도록 로그보다 먼저 수행한다.
+    const target = repoPathStrict(root, rel)
+    log(`파일 생성: ${rel}`)
+    if (!dryRun) writeText(target, template)
+    return { ok: true, action: 'create', path: rel }
+  })
+}
+
+const BEGIN_MARKER = '<!-- agent-kit:begin -->'
+
+export function ensureBlocks(root, blocks, { dryRun = false, log }) {
+  return blocks.map(({ path: rel, block }) => {
+    // 존재 확인은 어휘적 경로로 한다 — 만들지 않을 것이면 지켜야 할 쓰기도 없다.
+    if (!pathExists(repoPath(root, rel))) {
+      // 실제로 만드는 경로만 엄격 검사한다(링크를 통한 저장소 이탈 차단).
+      // 검사가 던지면 하지 않은 동작을 보고하지 않도록 로그보다 먼저 수행한다.
+      const target = repoPathStrict(root, rel)
+      log(`파일 생성: ${rel}`)
+      if (!dryRun) writeText(target, block)
+      return { ok: true, action: 'create', path: rel }
+    }
+
+    const target = repoPath(root, rel)
+    let text
+    try {
+      text = readFileSync(target, 'utf8')
+    } catch (err) {
+      log(`경고: ${rel}을 읽을 수 없어 건너뜁니다 (${err.code ?? err.message})`)
+      return { ok: true, action: 'warn', path: rel, message: '읽기 실패' }
+    }
+
+    if (text.includes(BEGIN_MARKER)) {
+      log(`관리 블록 확인: ${rel}`)
+      return { ok: true, action: 'skip', path: rel }
+    }
+
+    // 생성 분기와 같은 형태로: 검사는 dry-run 여부와 무관하게 항상 하고,
+    // 실제 쓰기만 !dryRun으로 막는다. dry-run 안에 검사를 가두면 저장소 밖으로
+    // 이탈하는 기존 파일에 대해 오류 없이 append 예정이라고 보고하게 된다.
+    // 검사가 던지면 하지 않은 동작을 보고하지 않도록 로그보다 먼저 수행한다.
+    const strictTarget = repoPathStrict(root, rel)
+    log(`관리 블록 추가: ${rel}`)
+    if (!dryRun) {
+      // 기존 마지막 줄을 닫고 빈 줄 하나를 띄운 뒤 블록을 붙인다.
+      const separator = text.endsWith('\n') ? '\n' : '\n\n'
+      appendFileSync(strictTarget, separator + normalizeBody(block), { encoding: 'utf8' })
+    }
+    return { ok: true, action: 'append', path: rel }
+  })
+}
+
+// 원본 setup-agents.ps1의 Add-GitignoreEntries·setup-agents.sh의
+// ensure_gitignore_entries가 항목을 추가할 때 앞에 넣는 안내 주석.
+// 헤더가 이미 있으면 다시 넣지 않는다 — 원본과 글자 단위로 같아야 한다.
+const IGNORE_HEADER = '# agent-kit: local skill adapters (do not commit duplicated skills)'
+
+// 부정 항목(`!path`)의 부모 디렉터리 전체를 제외하는 패턴이 이미 있으면
+// git 규칙상 그 부정 항목은 조용히 무효가 된다(F-3) — 부모가 제외되면
+// git이 그 안을 들여다보지 않아 자식을 되살릴 수 없다. `.vscode/*`처럼
+// 내용물만 제외하는 형태는 무해하다. 손으로 쓴 `.gitignore`·Node/Python
+// 템플릿에서 흔한 두 형태(`.vscode`, `.vscode/`)만 검사한다 — gitignore
+// 전체 문법을 구현하지 않고 실제로 부딪히는 모양만 잡는다. 위치는 무관하다:
+// git은 부정 항목의 순서와 무관하게 부모 제외를 우선한다.
+function warnBlockedNegations(lines, entries, log) {
+  const warnings = []
+  for (const entry of entries) {
+    if (!entry.startsWith('!')) continue
+    const negated = entry.slice(1)
+    const parent = negated.split('/').slice(0, -1).join('/')
+    if (parent && (lines.has(parent) || lines.has(`${parent}/`))) {
+      const message = `.gitignore의 "${parent}"가 디렉터리 전체를 제외해 "${entry}" 부정 항목이 무효화됩니다`
+      log(`경고: ${message}. "${parent}/*" 형태로 바꾸면 다시 포함됩니다.`)
+      warnings.push({ ok: true, action: 'warn', path: entry, message })
+    }
+  }
+  return warnings
+}
+
+export function ensureIgnore(root, entries, { dryRun = false, log }) {
+  // ensureDirs/ensureFiles/ensureBlocks와 달리 경로가 '.gitignore' 하나로 고정돼
+  // 있고, 함수 자체의 목적이 "항목을 보장한다"는 쓰기 의도이므로 존재 확인과
+  // 쓰기 판단을 나누지 않고 맨 앞에서 한 번만 엄격 검사한다. ensureGitignoreEntries
+  // (lib/gitignore.mjs)도 같은 검사를 하지만, 그쪽을 부르지 않는 dry-run 경로에서도
+  // 이탈을 거부해야 하므로 여기서 먼저 확인한다.
+  const target = repoPathStrict(root, '.gitignore')
+  const text = pathExists(target) ? readFileSync(target, 'utf8') : ''
+  const lines = new Set(text.split(/\r?\n/))
+  const missing = entries.filter((e) => !lines.has(e))
+  // 이미 있는 항목이든 새로 추가하는 항목이든, 기존 .gitignore가 부모
+  // 디렉터리를 통째로 제외하고 있으면 매 실행마다 경고한다 — 사용자가
+  // 직접 고치기 전까지는 계속 알려야 "조용한 실패"가 아니게 된다.
+  const warnings = warnBlockedNegations(lines, entries, log)
+
+  if (missing.length === 0) {
+    log(`.gitignore 항목 확인: ${entries.join(', ')}`)
+    return [...entries.map((e) => ({ ok: true, action: 'skip', path: e })), ...warnings]
+  }
+
+  log(`.gitignore 항목 추가: ${missing.join(', ')}`)
+  if (!dryRun) {
+    // 헤더가 아직 없을 때만 항목들보다 먼저 넣는다. ensureGitignoreEntries는
+    // 넘긴 항목 중 파일에 없는 줄만 추가하므로, 헤더도 그 목록의 맨 앞에
+    // 끼워 넣으면 "없을 때만 추가, 있으면 그대로"가 자연히 성립한다.
+    const toAdd = lines.has(IGNORE_HEADER) ? missing : [IGNORE_HEADER, ...missing]
+    ensureGitignoreEntries(root, toAdd)
+  }
+  return [...missing.map((e) => ({ ok: true, action: 'append', path: e })), ...warnings]
+}
+
+// 줄 주석(//)과 블록 주석(/* */)을 건너뛰며 유의미한 문자를 하나씩 넘겨준다.
+// findRootBrace(루트 '{' 탐색)와 isEmptyObjectBody(빈 객체 판정, F-1)가 같은
+// 스캐너를 공유한다 — 판정 기준이 둘로 갈리면 한쪽만 고치는 회귀가 생기기 쉽다.
+// 한계: 문자열 리터럴을 모른다. `"https://x"` 안의 `//`도 줄 주석으로 본다.
+// 현재 두 소비자는 루트 '{' 이전과 그 바로 뒤 한 글자만 보므로 문자열 안까지
+// 들어가지 않아 영향이 없다. 다른 위치에서 재사용하려면 문자열 인식을 먼저 더해야 한다.
+function* scanSignificant(text) {
+  let inBlock = false
+  let offset = 0
+
+  for (const line of text.split('\n')) {
+    let i = 0
+    while (i < line.length) {
+      if (inBlock) {
+        const end = line.indexOf('*/', i)
+        if (end === -1) { i = line.length; break }
+        inBlock = false
+        i = end + 2
+        continue
+      }
+      if (line[i] === '/' && line[i + 1] === '/') break
+      if (line[i] === '/' && line[i + 1] === '*') { inBlock = true; i += 2; continue }
+      yield { char: line[i], offset: offset + i }
+      i++
+    }
+    offset += line.length + 1 // split이 제거한 개행 1자
+  }
+}
+
+// JSONC인 .vscode/settings.json은 파일 첫머리에 주석이 오는 일이 흔하고,
+// 그 주석 안의 중괄호에 속으면 주석 한가운데에 키를 끼워 넣게 된다.
+function findRootBrace(text) {
+  for (const { char, offset } of scanSignificant(text)) {
+    if (char === '{') return offset
+  }
+  return -1
+}
+
+// rest(루트 '{' 다음 텍스트)에서 공백을 건너뛴 첫 유의미 문자가 '}'인지 본다.
+// trimStart만으로는 `{ // 안내\n}` 처럼 첫 항목이 주석인 빈 객체를 항목 있는
+// 객체로 오판해 후행 콤마를 남긴다(F-1) — 주석도 whitespace와 함께 건너뛰어야
+// 진짜 "다음 항목이 있는가"를 알 수 있다.
+function isEmptyObjectBody(rest) {
+  for (const { char } of scanSignificant(rest)) {
+    if (/\s/.test(char)) continue
+    return char === '}'
+  }
+  return true // 닫는 중괄호를 못 찾은 경우(도달 불가에 가깝다) — 방어적으로 empty 취급
+}
+
+// 기존 JSON 파일을 보존한 채 최상위 키 하나를 보장한다.
+// 부트스트랩은 외부 의존성을 쓸 수 없어(jsonc-parser는 설치기 경로 전용)
+// 파싱·재직렬화 대신 텍스트 삽입으로 처리한다. 재직렬화하지 않으므로
+// 사용자의 주석·들여쓰기·줄바꿈이 그대로 남는다.
+export function ensureJsonKeys(root, entries, { dryRun = false, log }) {
+  return entries.map(({ path: rel, key, value }) => {
+    const pair = `${JSON.stringify(key)}: ${JSON.stringify(value)}`
+
+    // 존재 확인은 어휘적 경로로 한다 — 만들지 않을 것이면 지켜야 할 쓰기도 없다.
+    if (!pathExists(repoPath(root, rel))) {
+      // 검사가 던지면 하지 않은 동작을 보고하지 않도록 로그보다 먼저 수행한다.
+      const target = repoPathStrict(root, rel)
+      log(`파일 생성: ${rel}`)
+      if (!dryRun) writeText(target, `{\n  ${pair}\n}`)
+      return { ok: true, action: 'create', path: rel }
+    }
+
+    let text
+    try {
+      text = readFileSync(repoPath(root, rel), 'utf8')
+    } catch (err) {
+      log(`경고: ${rel}을 읽을 수 없어 건너뜁니다 (${err.code ?? err.message})`)
+      return { ok: true, action: 'warn', path: rel, message: '읽기 실패' }
+    }
+
+    // 주석 안에 있어도 건드리지 않는다 — 사용자가 언급한 키를 스크립트가
+    // 되살리지 않는 편이 "기존 설정을 덮어쓰지 않는다"는 원칙에 맞는다.
+    // 문자열 포함 검사라 키 이름이 어떤 값 안에 들어 있어도 건너뛴다. 보수적인
+    // 쪽으로 틀리는 것(넣지 않음)이라 파일을 망가뜨리지는 않는다. 정확히 하려면
+    // 최상위 키만 보는 파서가 필요한데, 부트스트랩은 의존성을 쓸 수 없다.
+    if (text.includes(JSON.stringify(key))) {
+      log(`설정 키 확인: ${rel} — ${key}`)
+      return { ok: true, action: 'skip', path: rel }
+    }
+
+    const brace = findRootBrace(text)
+    if (brace === -1) {
+      log(`경고: ${rel}에서 루트 객체를 찾지 못해 건너뜁니다`)
+      return { ok: true, action: 'warn', path: rel, message: '루트 객체 없음' }
+    }
+
+    const strictTarget = repoPathStrict(root, rel)
+    log(`설정 키 추가: ${rel} — ${key}`)
+    if (!dryRun) {
+      const rest = text.slice(brace + 1)
+      // 빈 객체면 콤마 없이, 뒤에 항목이 있으면 콤마를 붙여 유효한 JSON을 유지한다.
+      const empty = isEmptyObjectBody(rest)
+      // 파일의 우세 줄바꿈을 따른다 — CRLF 파일에 삽입한 줄만 LF로 섞이는 것을 막는다.
+      const eol = text.includes('\r\n') ? '\r\n' : '\n'
+      // 중괄호 사이가 공백뿐이면 그 공백을 우리 줄로 대체한다. 그대로 두면
+      // `{\n}` 같은 파일에 빈 줄이 하나 남는다. 주석이 들어 있는 빈 객체는
+      // 건드리지 않는다 — 주석의 들여쓰기를 지켜야 한다.
+      const body = empty && /^\s*\}/.test(rest) ? rest.replace(/^\s*/, '') : rest
+      const inserted = `${eol}  ${pair}${empty ? eol : ','}`
+      writeFileSync(strictTarget, text.slice(0, brace + 1) + inserted + body, { encoding: 'utf8' })
+    }
+    return { ok: true, action: 'insert', path: rel }
+  })
+}

package/lib/bootstrap/flow.mjs

@@ -0,0 +1,54 @@
+// 부트스트랩 진입점 — 순서와 보고만 담당한다.
+// 무엇을 만들지는 manifest.mjs가, 어떻게 만들지는 apply.mjs·adapter.mjs가 안다.
+import { MANIFEST } from './manifest.mjs'
+import { ensureBlocks, ensureDirs, ensureFiles, ensureIgnore, ensureJsonKeys } from './apply.mjs'
+import { configureAdapter } from './adapter.mjs'
+
+const SKILL_MODES = ['auto', 'link', 'copy']
+
+export function runBootstrap(root, opts = {}) {
+  const { dryRun = false, skillMode = 'auto', log = console.log, manifest = MANIFEST } = opts
+
+  if (!SKILL_MODES.includes(skillMode)) {
+    throw new Error(`--skill-mode는 ${SKILL_MODES.join(', ')} 중 하나여야 합니다: ${skillMode}`)
+  }
+
+  const say = (message) => log(`[agent-setup] ${message}`)
+  const ctx = { dryRun, log: say }
+
+  say(`저장소 루트: ${root}`)
+  say('글로벌 설정 경로는 읽거나 수정하지 않습니다.')
+
+  const results = [
+    ...ensureDirs(root, manifest.dirs, ctx),
+    ...ensureFiles(root, manifest.files, ctx),
+    ...ensureJsonKeys(root, manifest.settings ?? [], ctx),
+    ...ensureBlocks(root, manifest.blocks, ctx),
+  ]
+
+  // 어댑터는 항목별로 실패를 격리한다 — 하나가 실패해도 나머지를 계속한다.
+  for (const entry of manifest.adapters) {
+    try {
+      results.push(configureAdapter(root, entry, { ...ctx, skillMode }))
+    } catch (err) {
+      results.push({ ok: false, action: 'link', path: entry.path, message: err.message })
+    }
+  }
+
+  results.push(...ensureIgnore(root, manifest.ignore, ctx))
+
+  const failed = results.filter((r) => !r.ok)
+  log('')
+  if (failed.length > 0) {
+    say(`실패 ${failed.length}건:`)
+    for (const f of failed) say(`  ✖ ${f.path} — ${f.message}`)
+  }
+  say('완료되었습니다.')
+  say('공통 지침: AGENTS.md')
+  say('공통 스킬: .agents/skills/')
+  say(`적용 도구: ${manifest.tools.join(', ')}`)
+  say('도구별 설정은 모두 현재 저장소 안에만 생성되었습니다.')
+  say('기존 설정 파일은 덮어쓰지 않았습니다.')
+
+  return { results, failed }
+}

package/lib/bootstrap/manifest.mjs

@@ -0,0 +1,74 @@
+import {
+  AGENTS_TEMPLATE, CLAUDE_BLOCK, GEMINI_BLOCK, SKILL_README, EXAMPLE_SKILL,
+  AGENT_KIT_README, CLAUDE_SETTINGS, CODEX_CONFIG, GEMINI_SETTINGS, GROK_CONFIG,
+  OPENCODE_CONFIG, KILO_CONFIG, KIRO_MCP_CONFIG, KIMI_MCP_CONFIG,
+  COPILOT_MCP_CONFIG, COPILOT_SETTINGS, VSCODE_MCP_CONFIG,
+} from './templates.mjs'
+
+// 저장소 부트스트랩이 만들 대상 선언.
+// 도구 추가 = dirs 한 줄 + files 한 줄. 실행 로직은 apply.mjs·adapter.mjs에 있다.
+export const MANIFEST = {
+  // 완료 리포트에 그대로 나열되는 도구 이름. 순서가 출력 순서다.
+  tools: [
+    'Claude Code', 'Codex', 'Gemini CLI', 'OpenCode', 'Kilo Code',
+    'Kiro', 'Kimi Code', 'Grok Build', 'Antigravity',
+    'GitHub Copilot CLI', 'VS Code Copilot',
+  ],
+
+  dirs: [
+    '.agents/skills', '.agent-kit', '.claude', '.codex',
+    '.gemini', '.grok', '.kiro/settings', '.kimi-code',
+    '.github/copilot', '.vscode',
+  ],
+
+  // 없을 때만 생성한다. 이미 있으면 내용을 보지 않고 보존한다.
+  files: [
+    { path: 'AGENTS.md', template: AGENTS_TEMPLATE },
+    { path: '.agents/skills/README.md', template: SKILL_README },
+    { path: '.agents/skills/repository-check/SKILL.md', template: EXAMPLE_SKILL },
+    { path: '.agent-kit/README.md', template: AGENT_KIT_README },
+    { path: '.claude/settings.json', template: CLAUDE_SETTINGS },
+    { path: '.codex/config.toml', template: CODEX_CONFIG },
+    { path: '.gemini/settings.json', template: GEMINI_SETTINGS },
+    { path: '.grok/config.toml', template: GROK_CONFIG },
+    { path: 'opencode.jsonc', template: OPENCODE_CONFIG },
+    { path: 'kilo.jsonc', template: KILO_CONFIG },
+    { path: '.kiro/settings/mcp.json', template: KIRO_MCP_CONFIG },
+    { path: '.kimi-code/mcp.json', template: KIMI_MCP_CONFIG },
+    { path: '.github/mcp.json', template: COPILOT_MCP_CONFIG },
+    { path: '.github/copilot/settings.json', template: COPILOT_SETTINGS },
+    { path: '.vscode/mcp.json', template: VSCODE_MCP_CONFIG },
+  ],
+
+  // 마커가 없을 때만 덧붙인다. 파일이 없으면 블록만으로 생성한다.
+  blocks: [
+    { path: 'CLAUDE.md', block: CLAUDE_BLOCK },
+    { path: 'GEMINI.md', block: GEMINI_BLOCK },
+  ],
+
+  // 기존 파일을 보존한 채 최상위 키만 보장한다. 키가 이미 있으면 손대지 않는다.
+  // VS Code Copilot은 이 키가 있어야 루트 AGENTS.md를 읽는다.
+  settings: [
+    { path: '.vscode/settings.json', key: 'chat.useAgentsMdFile', value: true },
+  ],
+
+  // .agents/skills 를 가리키는 도구별 어댑터
+  // 두 Copilot은 .agents/skills를 네이티브로 탐색하므로 여기에 없다.
+  adapters: [
+    { tool: 'Claude Code', path: '.claude/skills' },
+    { tool: 'Kiro', path: '.kiro/skills' },
+    { tool: 'Grok Build', path: '.grok/skills' },
+  ],
+
+  // .vscode/ 아래 두 부정 항목은 널리 쓰이는 VisualStudio.gitignore가
+  // `.vscode/*`를 무시하기 때문에 필요하다. 부정 항목이 없으면 팀 공유가
+  // 깨진다 — 특히 settings.json은 VS Code가 AGENTS.md를 읽게 하는
+  // chat.useAgentsMdFile이 사는 곳이라, 커밋되지 않으면 키를 넣어도
+  // 그 설정이 팀에 전파되지 않는다. `.vscode/*`가 없는 저장소에서는
+  // 무해한 no-op이다.
+  ignore: [
+    '.claude/skills', '.kiro/skills', '.grok/skills', '.kimi-code/local.toml',
+    '.github/copilot/settings.local.json',
+    '!.vscode/mcp.json', '!.vscode/settings.json',
+  ],
+}

package/lib/bootstrap/templates.mjs

@@ -0,0 +1,148 @@
+// setup-agents.ps1의 here-string 내용을 옮긴 단일 출처.
+// 여기만 고치면 모든 OS가 같은 파일을 만든다.
+
+export const AGENTS_TEMPLATE = `# Repository Instructions
+
+## Scope
+
+These instructions apply only to this repository.
+
+## Required workflow
+
+1. Inspect the relevant existing implementation before editing.
+2. Make the smallest change that satisfies the requirement.
+3. Add or update tests for behavior changes.
+4. Run focused verification first, then the full repository checks.
+5. Report anything that could not be verified.
+
+## Repository commands
+
+Document the actual commands used by this repository:
+
+- Install:
+- Build:
+- Test:
+- Lint:
+- Full verification:
+
+## Rules
+
+- Do not modify files outside this repository.
+- Do not add production dependencies without explicit approval.
+- Do not edit generated files directly.
+- Never commit credentials, access tokens, or connection strings.`
+
+export const CLAUDE_BLOCK = `<!-- agent-kit:begin -->
+@AGENTS.md
+<!-- agent-kit:end -->`
+
+export const GEMINI_BLOCK = `<!-- agent-kit:begin -->
+@./AGENTS.md
+<!-- agent-kit:end -->`
+
+export const SKILL_README = `# Shared repository skills
+
+Create each shared skill in:
+
+\`.agents/skills/<skill-name>/SKILL.md\`
+
+Use portable Agent Skills frontmatter:
+
+\`\`\`yaml
+---
+name: example-skill
+description: Explain when this skill should be used.
+---
+\`\`\`
+
+Claude Code, Kiro, and Grok Build receive these skills through project-local
+adapters at \`.claude/skills\`, \`.kiro/skills\`, and \`.grok/skills\`. Codex,
+Gemini CLI, OpenCode, Kilo Code, Kimi Code, Antigravity, GitHub Copilot CLI,
+and VS Code Copilot discover \`.agents/skills\` directly.`
+
+export const EXAMPLE_SKILL = `---
+name: repository-check
+description: Verify repository changes by reviewing the diff and running the documented build, test, and lint commands. Use before reporting implementation work as complete.
+---
+
+# Repository check
+
+1. Read \`AGENTS.md\`.
+2. Review the complete working-tree diff.
+3. Run the smallest relevant checks first.
+4. Run the repository's documented full verification command.
+5. Report failures, skipped checks, and remaining risks.`
+
+export const AGENT_KIT_README = `# Repository-local agent setup
+
+This directory documents files generated or used by the bootstrap scripts.
+
+The installer bootstrap:
+
+- finds the current Git repository root;
+- refuses to write outside that repository;
+- creates only project-scoped configuration;
+- never writes to user-home or system-wide agent configuration;
+- preserves existing configuration files;
+- adds a small managed import block to \`CLAUDE.md\` and \`GEMINI.md\`;
+- exposes \`.agents/skills\` to Claude Code, Kiro, and Grok Build through
+  local adapters;
+- adds \`chat.useAgentsMdFile\` to \`.vscode/settings.json\` only when the key
+  is absent, so VS Code Copilot reads the shared \`AGENTS.md\`;
+- relies on the native support of Kilo Code, Kimi Code, Antigravity, GitHub
+  Copilot CLI, and VS Code Copilot for \`AGENTS.md\` and \`.agents/skills\`.`
+
+export const CLAUDE_SETTINGS = `{}`
+
+export const CODEX_CONFIG = `# Repository-local Codex configuration.
+# Personal or machine-wide defaults belong outside this repository.
+project_doc_max_bytes = 65536`
+
+export const GEMINI_SETTINGS = `{
+  "skills": {
+    "enabled": true
+  },
+  "security": {
+    "folderTrust": {
+      "enabled": true
+    },
+    "disableAlwaysAllow": true,
+    "enablePermanentToolApproval": false
+  }
+}`
+
+export const GROK_CONFIG = `# Repository-local Grok Build configuration.
+# Project scope supports mcp_servers, plugins, and permission rules only.
+# Personal or machine-wide defaults belong in ~/.grok/config.toml.
+# Grok Build reads the root AGENTS.md natively.`
+
+export const OPENCODE_CONFIG = `{
+  "$schema": "https://opencode.ai/config.json"
+}`
+
+export const KILO_CONFIG = `{
+  // Project-local Kilo Code configuration.
+  // Kilo Code automatically loads ./AGENTS.md and ./.agents/skills/.
+}`
+
+export const KIRO_MCP_CONFIG = `{
+  "mcpServers": {}
+}`
+
+export const KIMI_MCP_CONFIG = `{
+  "mcpServers": {}
+}`
+
+export const COPILOT_MCP_CONFIG = `{
+  "mcpServers": {}
+}`
+
+// 모델·추론 강도·컨텍스트 티어를 저장소 단위로 고정하는 공유 설정 자리.
+// 구체적인 값은 팀이 정한다. 개인 오버라이드는 settings.local.json이며
+// .gitignore 대상이다.
+export const COPILOT_SETTINGS = `{}`
+
+// VS Code는 최상위 키가 servers다 (Copilot CLI의 mcpServers와 다르다).
+export const VSCODE_MCP_CONFIG = `{
+  "servers": {}
+}`