{"id":46274463,"url":"https://github.com/letsur-dev/spec-mix","last_synced_at":"2026-04-02T19:23:28.924Z","repository":{"id":324676067,"uuid":"1098060013","full_name":"letsur-dev/spec-mix","owner":"letsur-dev","description":null,"archived":false,"fork":false,"pushed_at":"2026-03-31T03:04:09.000Z","size":5456,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-31T05:32:50.857Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/letsur-dev.png","metadata":{"files":{"readme":"README.ko.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":"SUPPORT.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-11-17T07:52:23.000Z","updated_at":"2026-03-31T03:03:49.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/letsur-dev/spec-mix","commit_stats":null,"previous_names":["letsur-dev/spec-mix"],"tags_count":31,"template":false,"template_full_name":null,"purl":"pkg:github/letsur-dev/spec-mix","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/letsur-dev%2Fspec-mix","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/letsur-dev%2Fspec-mix/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/letsur-dev%2Fspec-mix/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/letsur-dev%2Fspec-mix/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/letsur-dev","download_url":"https://codeload.github.com/letsur-dev/spec-mix/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/letsur-dev%2Fspec-mix/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31314375,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T12:59:32.332Z","status":"ssl_error","status_checked_at":"2026-04-02T12:54:48.875Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-03-04T04:03:23.586Z","updated_at":"2026-04-02T19:23:28.910Z","avatar_url":"https://github.com/letsur-dev.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n    \u003cimg src=\"./media/logo.png\" alt=\"Spec Mix Logo\" width=\"120\"/\u003e\n    \u003ch1\u003eSpec Mix\u003c/h1\u003e\n    \u003ch3\u003e\u003cem\u003e사양 주도 개발로 고품질 소프트웨어를 더 빠르게 구축하세요.\u003c/em\u003e\u003c/h3\u003e\n\u003c/div\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003cstrong\u003e다국어 지원, 미션 시스템, 웹 대시보드를 갖춘 AI 기반 개발을 위한 향상된 도구 키트\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://github.com/dan1901/spec-mix/actions/workflows/release.yml\"\u003e\u003cimg src=\"https://github.com/dan1901/spec-mix/actions/workflows/release.yml/badge.svg\" alt=\"Release\"/\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/dan1901/spec-mix/stargazers\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/dan1901/spec-mix?style=social\" alt=\"GitHub stars\"/\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/dan1901/spec-mix/blob/main/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-MIT-blue.svg\" alt=\"License\"/\u003e\u003c/a\u003e\n    \u003ca href=\"https://dan1901.github.io/spec-mix/\"\u003e\u003cimg src=\"https://img.shields.io/badge/docs-GitHub_Pages-blue\" alt=\"Documentation\"/\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003e *원래 [github/spec-kit](https://github.com/github/spec-kit)에서 포크됨*\n\n**Language / 언어**: [English](README.md) | **한국어**\n\n---\n\n## 목차\n\n- [🤔 Spec-Driven Development란?](#-spec-driven-development란)\n\n- [⚡ 시작하기](#-시작하기)\n\n- [🤖 지원되는 AI 에이전트](#-지원되는-ai-에이전트)\n\n- [🌍 다국어 지원](#-다국어-지원)\n\n- [🔧 Spec Mix CLI 참조](#-spec-mix-cli-참조)\n\n- [📚 핵심 철학](#-핵심-철학)\n\n- [🌟 개발 단계](#-개발-단계)\n\n- [🎯 실험적 목표](#-실험적-목표)\n\n- [🔧 전제 조건](#-전제-조건)\n\n- [📖 더 알아보기](#-더-알아보기)\n\n- [📋 상세 프로세스](#-상세-프로세스)\n\n- [🔍 문제 해결](#-문제-해결)\n\n- [👥 메인테이너](#-메인테이너)\n\n- [💬 지원](#-지원)\n\n- [🙏 감사의 말](#-감사의-말)\n\n- [📄 라이선스](#-라이선스)\n\n## 🤔 Spec-Driven Development란?\n\nSpec-Driven Development는 전통적인 소프트웨어 개발의 **판도를 바꿉니다**. 수십 년 동안 코드가 왕이었고, 명세는 단지 \"실제 작업\"인 코딩을 시작하면 버려지는 비계에 불과했습니다. Spec-Driven Development는 이를 바꿉니다: **명세가 실행 가능해지고**, 단순히 안내하는 것이 아니라 직접 작동하는 구현을 생성합니다.\n\n## ⚡ 시작하기\n\n### 1. Spec Mix CLI 설치\n\n선호하는 설치 방법을 선택하세요:\n\n#### 옵션 1: 영구 설치 (권장)\n\n한 번 설치하고 어디서나 사용:\n\n```bash\nuv tool install spec-mix --from git+https://github.com/letsur-dev/spec-mix.git\n\n```\n\n그런 다음 도구를 직접 사용:\n\n```bash\nspec-mix init \u003cPROJECT_NAME\u003e\nspec-mix check\n\n```\n\nspec-mix를 업그레이드하려면:\n\n```bash\nuv tool install spec-mix --force --from git+https://github.com/letsur-dev/spec-mix.git\n\n```\n\n#### 옵션 2: 일회성 사용\n\n설치 없이 직접 실행:\n\n```bash\nuvx --from git+https://github.com/letsur-dev/spec-mix.git spec-mix init \u003cPROJECT_NAME\u003e\n\n```\n\n**영구 설치의 장점:**\n\n- 도구가 설치되어 PATH에서 사용 가능\n\n- 쉘 별칭 생성 불필요\n\n- `uv tool list`, `uv tool upgrade`, `uv tool uninstall`로 더 나은 도구 관리\n\n- 더 깔끔한 쉘 구성\n\n### 2. 프로젝트 원칙 수립\n\n프로젝트 디렉토리에서 AI 어시스턴트를 실행하세요. `/spec-mix.*` 명령어를 어시스턴트에서 사용할 수 있습니다.\n\n**`/spec-mix.constitution`** 명령을 사용하여 모든 후속 개발을 안내할 프로젝트의 지배 원칙과 개발 가이드라인을 만드세요.\n\n```bash\n/spec-mix.constitution 코드 품질, 테스팅 표준, 사용자 경험 일관성, 성능 요구사항에 중점을 둔 원칙 생성\n\n```\n\n### 3. 명세 생성\n\n**`/spec-mix.specify`** 명령을 사용하여 구축하려는 것을 설명하세요. 기술 스택이 아닌 **무엇을**과 **왜**에 집중하세요.\n\n```bash\n/spec-mix.specify 사진을 별도의 포토 앨범으로 정리할 수 있는 애플리케이션을 만들어주세요. 앨범은 날짜별로 그룹화되며 메인 페이지에서 드래그 앤 드롭으로 재정렬할 수 있습니다. 앨범은 다른 중첩 앨범 안에 있지 않습니다. 각 앨범 내에서 사진은 타일 형태의 인터페이스로 미리보기됩니다.\n\n```\n\n### 4. 기술 구현 계획 생성\n\n**`/spec-mix.plan`** 명령을 사용하여 기술 스택과 아키텍처 선택을 제공하세요.\n\n```bash\n/spec-mix.plan 애플리케이션은 최소한의 라이브러리로 Vite를 사용합니다. 가능한 한 바닐라 HTML, CSS, JavaScript를 사용하세요. 이미지는 어디에도 업로드되지 않으며 메타데이터는 로컬 SQLite 데이터베이스에 저장됩니다.\n\n```\n\n### 5. 작업으로 분해\n\n**`/spec-mix.tasks`**를 사용하여 구현 계획에서 실행 가능한 작업 목록을 생성하세요.\n\n```bash\n/spec-mix.tasks\n\n```\n\n### 6. 구현 실행\n\n**`/spec-mix.implement`**를 사용하여 모든 작업을 실행하고 계획에 따라 기능을 구축하세요.\n\n```bash\n/spec-mix.implement\n\n```\n\n자세한 단계별 지침은 [종합 가이드](./spec-driven.md)를 참조하세요.\n\n## 🤖 지원되는 AI 에이전트\n\n| 에이전트                                                     | 지원 | 비고                                             |\n|-----------------------------------------------------------|---------|---------------------------------------------------|\n| [Claude Code](https://www.anthropic.com/claude-code)      | ✅ |                                                   |\n| [GitHub Copilot](https://code.visualstudio.com/)          | ✅ |                                                   |\n| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | ✅ |                                                   |\n| [Cursor](https://cursor.sh/)                              | ✅ |                                                   |\n| [Qwen Code](https://github.com/QwenLM/qwen-code)          | ✅ |                                                   |\n| [opencode](https://opencode.ai/)                          | ✅ |                                                   |\n| [Windsurf](https://windsurf.com/)                         | ✅ |                                                   |\n| [Kilo Code](https://github.com/Kilo-Org/kilocode)         | ✅ |                                                   |\n| [Auggie CLI](https://docs.augmentcode.com/cli/overview)   | ✅ |                                                   |\n| [CodeBuddy CLI](https://www.codebuddy.ai/cli)             | ✅ |                                                   |\n| [Roo Code](https://roocode.com/)                          | ✅ |                                                   |\n| [Codex CLI](https://github.com/openai/codex)              | ✅ |                                                   |\n| [Amazon Q Developer CLI](https://aws.amazon.com/developer/learning/q-developer-cli/) | ⚠️ | Amazon Q Developer CLI는 슬래시 명령에 대한 사용자 정의 인수를 [지원하지 않습니다](https://github.com/aws/amazon-q-developer-cli/issues/3064). |\n| [Amp](https://ampcode.com/) | ✅ | |\n| [Google Antigravity](https://antigravity.google.com/) | ✅ | |\n\n## MCP 서버 지원 (실험적 기능)\n\nSpec Mix는 **Model Context Protocol (MCP)**을 지원합니다. 이를 통해 Claude Desktop, Codex, Amazon Q와 같은 AI 에이전트가 프로젝트와 프로그래밍 방식으로 상호작용할 수 있습니다.\n\n### 설정 방법\n\nMCP 클라이언트(AI 에이전트)의 설정 파일에 다음 내용을 추가하세요:\n\n```json\n{\n  \"mcpServers\": {\n    \"spec-mix\": {\n      \"command\": \"spec-mix\",\n      \"args\": [\"mcp\"]\n    }\n  }\n}\n```\n\n설정이 완료되면 AI 에이전트가 `read_plan`, `update_plan`, `create_task`, `list_tasks` 등의 도구를 사용할 수 있게 됩니다.\n\n## 🌍 다국어 지원\n\nSpec Kit은 명령어, 템플릿 및 CLI 인터페이스에 대한 다국어를 지원하여 전 세계 개발자가 접근할 수 있습니다.\n\n### 지원되는 언어\n\n| 언어 | 코드 | 상태 | 커버리지 |\n|----------|------|--------|----------|\n| English  | `en` | ✅ 기본값 | 100% (CLI + 명령 + 템플릿) |\n| 한국어   | `ko` | ✅ 사용 가능 | 100% (CLI + 명령 + 템플릿) |\n\n### 선호하는 언어로 Spec Kit 사용\n\nSpec Kit은 시스템 언어를 자동으로 감지합니다. 특정 언어를 사용하려면:\n\n#### 빠른 시작\n\n```bash\n# 환경 변수로 언어 설정 (영구적)\nexport SPECIFY_LANG=ko\n\n# 또는 세션별로 사용\nSPECIFY_LANG=ko spec-mix init my-project\n\n```\n\n#### 언어 관리 명령\n\n```bash\n# 사용 가능한 언어 목록\nspec-mix lang list\n\n# 현재 언어 표시\nspec-mix lang current\n\n# 기본 언어 설정\nspec-mix lang set ko\n\n```\n\n#### 미션 관리 명령\n\n```bash\n# 사용 가능한 미션 목록\nspec-mix mission list\n\n# 현재 미션 정보 표시\nspec-mix mission current\n\n# 미션 전환\nspec-mix mission switch research\n\n# 미션 세부정보 보기\nspec-mix mission info software-dev\n\n```\n\n#### 대시보드 명령\n\n```bash\n# 대시보드 시작 (브라우저에서 열림)\nspec-mix dashboard\n\n# 특정 포트에서 시작\nspec-mix dashboard start --port 9000\n\n# 대시보드 상태 확인\nspec-mix dashboard status\n\n# 대시보드 중지\nspec-mix dashboard stop\n\n```\n\n### 번역되는 내용\n\n선호하는 언어로 Spec Kit을 사용할 때 다음이 번역됩니다:\n\n- **CLI 메시지**: 모든 프롬프트, 오류, 성공 메시지 및 도움말 텍스트\n\n- **명령 지침**: 모든 `/spec-mix.*` 슬래시 명령 워크플로우\n\n  - `/spec-mix.specify`, `/spec-mix.plan`, `/spec-mix.tasks` 등\n\n- **템플릿**: 명세, 구현 계획 및 작업 분해 템플릿\n\n- **문서**: 생성된 파일 내의 인라인 주석 및 가이드\n\n### 예제: 한국어 워크플로우\n\n```bash\n# 한국어 설정\nexport SPECIFY_LANG=ko\n\n# 프로젝트 초기화 (모든 프롬프트가 한국어로)\nspec-mix init my-project --ai claude\n\n# 한국어로 슬래시 명령 사용\n/spec-mix.constitution  # 프로젝트 원칙 수립\n/spec-mix.specify       # 기능 사양 생성\n/spec-mix.plan          # 구현 계획 생성\n/spec-mix.tasks         # 작업 분석 생성\n/spec-mix.implement     # 구현 실행\n\n```\n\n### 번역 기여\n\n귀하의 언어에 대한 지원을 추가하고 싶으신가요? 커뮤니티 번역을 환영합니다! 다음에 대한 [국제화 가이드](docs/i18n.md)를 참조하세요:\n\n- 새 언어 설정\n\n- 번역 가이드라인 및 모범 사례\n\n- 번역 테스트\n\n- 기여 제출\n\n자세한 문서는 **[docs/i18n.md](docs/i18n.md)**를 참조하세요.\n\n## 🔧 Spec Mix CLI 참조\n\n`specify` 명령은 다음 옵션을 지원합니다:\n\n### 명령\n\n| 명령     | 설명                                                    |\n|-------------|----------------------------------------------------------------|\n| `init`      | 최신 템플릿에서 새 Spec Mix 프로젝트 초기화      |\n| `check`     | 설치된 도구 확인 (`git`, `claude`, `gemini`, `code`/`code-insiders`, `cursor-agent`, `windsurf`, `qwen`, `opencode`, `codex`) |\n| `lang`      | 언어 팩 관리 (`list`, `current`, `set`, `install`)    |\n| `mission`   | 미션 관리 (`list`, `current`, `switch`, `info`)    |\n| `dashboard` | 웹 대시보드 관리 (`start`, `stop`, `status`)    |\n\n### `spec-mix init` 인수 및 옵션\n\n| 인수/옵션              | 유형     | 설명                                                                  |\n|------------------------|----------|------------------------------------------------------------------------------|\n| `\u003cproject-name\u003e`       | 인수 | 새 프로젝트 디렉토리 이름 (`--here` 사용 시 선택 사항, 현재 디렉토리의 경우 `.` 사용) |\n| `--ai`                 | 옵션   | 사용할 AI 어시스턴트: `claude`, `gemini`, `copilot`, `cursor-agent`, `qwen`, `opencode`, `codex`, `windsurf`, `kilocode`, `auggie`, `roo`, `codebuddy`, `amp`, 또는 `q` |\n| `--script`             | 옵션   | 사용할 스크립트 변형: `sh` (bash/zsh) 또는 `ps` (PowerShell)                 |\n| `--lang`               | 옵션   | 사용할 언어: `en`, `ko` (기본값: `en`)                                 |\n| `--mission`            | 옵션   | 사용할 미션: `software-dev`, `research` (기본값: `software-dev`)        |\n| `--ignore-agent-tools` | 플래그     | Claude Code와 같은 AI 에이전트 도구 확인 건너뛰기                             |\n| `--no-git`             | 플래그     | git 저장소 초기화 건너뛰기                                          |\n| `--here`               | 플래그     | 새 디렉토리를 만드는 대신 현재 디렉토리에서 프로젝트 초기화   |\n| `--force`              | 플래그     | 현재 디렉토리에서 초기화할 때 강제 병합/덮어쓰기 (확인 건너뛰기) |\n| `--skip-tls`           | 플래그     | SSL/TLS 확인 건너뛰기 (권장하지 않음)                                 |\n| `--debug`              | 플래그     | 문제 해결을 위한 자세한 디버그 출력 활성화                            |\n| `--github-token`       | 옵션   | API 요청을 위한 GitHub 토큰 (또는 GH_TOKEN/GITHUB_TOKEN 환경 변수 설정)  |\n\n### 예제\n\n```bash\n# 기본 프로젝트 초기화\nspec-mix init my-project\n\n# 특정 AI 어시스턴트로 초기화\nspec-mix init my-project --ai claude\n\n# Cursor 지원으로 초기화\nspec-mix init my-project --ai cursor-agent\n\n# Windsurf 지원으로 초기화\nspec-mix init my-project --ai windsurf\n\n# Amp 지원으로 초기화\nspec-mix init my-project --ai amp\n\n# 한국어로 초기화\nspec-mix init my-project --ai claude --lang ko\n\n# 연구 미션으로 초기화\nspec-mix init my-project --ai claude --mission research\n\n# 언어와 미션 모두 지정하여 초기화\nspec-mix init my-project --ai claude --lang ko --mission research\n\n# 대화형 선택 (지정하지 않으면 언어와 미션을 묻습니다)\nspec-mix init my-project --ai claude\n\n# PowerShell 스크립트로 초기화 (Windows/크로스 플랫폼)\nspec-mix init my-project --ai copilot --script ps\n\n# 현재 디렉토리에서 초기화\nspec-mix init . --ai copilot\n# 또는 --here 플래그 사용\nspec-mix init --here --ai copilot\n\n# 확인 없이 현재 (비어 있지 않은) 디렉토리로 강제 병합\nspec-mix init . --force --ai copilot\n# 또는\nspec-mix init --here --force --ai copilot\n\n# git 초기화 건너뛰기\nspec-mix init my-project --ai gemini --no-git\n\n# 문제 해결을 위한 디버그 출력 활성화\nspec-mix init my-project --ai claude --debug\n\n# API 요청을 위한 GitHub 토큰 사용 (기업 환경에 유용)\nspec-mix init my-project --ai claude --github-token ghp_your_token_here\n\n# 시스템 요구사항 확인\nspec-mix check\n\n```\n\n### 사용 가능한 슬래시 명령\n\n`spec-mix init`을 실행한 후 AI 코딩 에이전트는 구조화된 개발을 위해 다음 슬래시 명령에 액세스할 수 있습니다:\n\n#### 핵심 명령\n\nSpec-Driven Development 워크플로우를 위한 필수 명령:\n\n| 명령                  | 설명                                                           |\n|--------------------------|-----------------------------------------------------------------------|\n| `/spec-mix.constitution`  | 프로젝트 지배 원칙 및 개발 가이드라인 생성 또는 업데이트 |\n| `/spec-mix.specify`       | 구축하려는 것 정의 (요구사항 및 사용자 스토리)        |\n| `/spec-mix.plan`          | 선택한 기술 스택으로 기술 구현 계획 생성     |\n| `/spec-mix.tasks`         | 구현을 위한 실행 가능한 작업 목록 생성                     |\n| `/spec-mix.implement`     | 계획에 따라 기능을 구축하기 위해 모든 작업 실행         |\n\n#### 워크플로우 관리 명령\n\n워크트리 및 작업 레인으로 기능 개발을 관리하는 명령:\n\n| 명령              | 설명                                                           |\n|----------------------|-----------------------------------------------------------------------|\n| `/spec-mix.dashboard` | 웹 대시보드를 실행하여 기능, 칸반 보드 및 산출물 시각화 |\n| `/spec-mix.review`    | `for_review` 레인의 완료된 작업을 검토하고 승인된 작업을 `done`으로 이동     |\n| `/spec-mix.accept`    | 병합 전에 포괄적인 검사로 기능 준비 확인     |\n| `/spec-mix.merge`     | 정리 옵션으로 기능 브랜치를 main으로 병합 (여러 전략 지원) |\n| `/spec-mix.fix`       | 최소한의 문서로 경량 버그 수정 생성 (관련 Work Package 자동 연결) |\n\n#### 선택적 명령\n\n향상된 품질 및 검증을 위한 추가 명령:\n\n| 명령              | 설명                                                           |\n|----------------------|-----------------------------------------------------------------------|\n| `/spec-mix.clarify`   | 불충분하게 지정된 영역 명확화 (`/spec-mix.plan` 전에 권장; 이전 `/quizme`) |\n| `/spec-mix.analyze`   | 교차 산출물 일관성 및 커버리지 분석 (`/spec-mix.tasks` 후, `/spec-mix.implement` 전에 실행) |\n| `/spec-mix.checklist` | 요구사항 완전성, 명확성 및 일관성을 검증하는 사용자 정의 품질 체크리스트 생성 (\"영어를 위한 단위 테스트\"와 같음) |\n| `/spec-mix.sync`      | 에이전트 핸드오프를 위해 모든 프로젝트 산출물을 읽어 컨텍스트 동기화 (에이전트 전환 시 사용) |\n\n### 사용 가능한 에이전트 (Claude Code 전용)\n\n에이전트는 복잡한 다단계 작업을 자율적으로 수행할 수 있는 어시스턴트입니다. Claude Code로 Spec Mix를 설치하면 다음 에이전트를 사용할 수 있습니다:\n\n| 에이전트 | 설명 | 사용법 |\n|----------|------|--------|\n| `sdd-spec-writer` | 사용자 요구사항을 SDD 최적화 기획서로 변환 | `@agent-sdd-spec-writer \u003c요구사항\u003e` |\n\n#### SDD Spec Writer 에이전트\n\n`sdd-spec-writer` 에이전트는 대략적인 아이디어나 요구사항에서 구조화된 기획서를 만드는 것을 도와줍니다.\n\n**사용 예시:**\n\n```text\n@agent-sdd-spec-writer 이메일과 소셜 로그인이 있는 사용자 인증 시스템을 만들고 싶어\n```\n\n**수행 작업:**\n\n1. 요구사항 분석\n2. 명확화 질문 (플랫폼, 기술 스택, 기능)\n3. 빠른 시작을 위한 기본 가정 제공\n4. 포괄적인 기획서 생성\n5. SDD 워크플로우 다음 단계 안내\n\n**기본값으로 빠른 시작:**\n\n```text\n@agent-sdd-spec-writer 계산기를 만들고 싶어\n\u003e (에이전트가 명확화 질문)\n\u003e 기본으로 진행해줘\n\u003e (에이전트가 전체 기획서 생성)\n```\n\n생성된 기획서는 `/spec-mix.specify` 워크플로우에 바로 사용할 수 있도록 최적화되어 있습니다.\n\n### 환경 변수\n\n| 변수         | 설명                                                                                    |\n|------------------|------------------------------------------------------------------------------------------------|\n| `SPECIFY_FEATURE` | Git 저장소가 아닌 경우 기능 감지 재정의. 기능 디렉토리 이름(예: `001-photo-albums`)으로 설정하여 Git 브랜치를 사용하지 않을 때 특정 기능에서 작업합니다.\u003cbr/\u003e**`/spec-mix.plan` 또는 후속 명령을 사용하기 전에 작업 중인 에이전트의 컨텍스트에서 설정해야 합니다.** |\n\n## 📚 핵심 철학\n\nSpec-Driven Development는 다음을 강조하는 구조화된 프로세스입니다:\n\n- 명세가 \"*어떻게*\" 전에 \"*무엇을*\"을 정의하는 **의도 기반 개발**\n\n- 가드레일 및 조직 원칙을 사용한 **풍부한 명세 생성**\n\n- 프롬프트에서 원샷 코드 생성이 아닌 **다단계 개선**\n\n- 명세 해석을 위한 고급 AI 모델 기능에 대한 **높은 의존도**\n\n## 🌟 개발 단계\n\n| 단계 | 초점 | 주요 활동 |\n|-------|-------|----------------|\n| **0-to-1 개발** (\"Greenfield\") | 처음부터 생성 | \u003cul\u003e\u003cli\u003e높은 수준의 요구사항으로 시작\u003c/li\u003e\u003cli\u003e명세 생성\u003c/li\u003e\u003cli\u003e구현 단계 계획\u003c/li\u003e\u003cli\u003e프로덕션 준비 애플리케이션 구축\u003c/li\u003e\u003c/ul\u003e |\n| **창의적 탐색** | 병렬 구현 | \u003cul\u003e\u003cli\u003e다양한 솔루션 탐색\u003c/li\u003e\u003cli\u003e여러 기술 스택 및 아키텍처 지원\u003c/li\u003e\u003cli\u003eUX 패턴 실험\u003c/li\u003e\u003c/ul\u003e |\n| **반복적 개선** (\"Brownfield\") | Brownfield 현대화 | \u003cul\u003e\u003cli\u003e기능을 반복적으로 추가\u003c/li\u003e\u003cli\u003e레거시 시스템 현대화\u003c/li\u003e\u003cli\u003e프로세스 적응\u003c/li\u003e\u003c/ul\u003e |\n\n## 🎯 실험적 목표\n\n우리의 연구 및 실험은 다음에 초점을 맞춥니다:\n\n### 기술 독립성\n\n- 다양한 기술 스택을 사용하여 애플리케이션 생성\n\n- Spec-Driven Development가 특정 기술, 프로그래밍 언어 또는 프레임워크에 국한되지 않는 프로세스라는 가설 검증\n\n### 엔터프라이즈 제약\n\n- 미션 크리티컬 애플리케이션 개발 시연\n\n- 조직 제약 통합 (클라우드 제공업체, 기술 스택, 엔지니어링 관행)\n\n- 엔터프라이즈 디자인 시스템 및 규정 준수 요구사항 지원\n\n### 사용자 중심 개발\n\n- 다양한 사용자 집단 및 선호도를 위한 애플리케이션 구축\n\n- 다양한 개발 접근 방식 지원 (vibe-coding에서 AI 네이티브 개발까지)\n\n### 창의적 및 반복적 프로세스\n\n- 병렬 구현 탐색 개념 검증\n\n- 강력한 반복적 기능 개발 워크플로우 제공\n\n- 업그레이드 및 현대화 작업을 처리하도록 프로세스 확장\n\n## 🔧 전제 조건\n\n- **Linux/macOS/Windows**\n\n- [지원되는](#지원되는-ai-에이전트) AI 코딩 에이전트\n\n- 패키지 관리를 위한 [uv](https://docs.astral.sh/uv/)\n\n- [Python 3.11+](https://www.python.org/downloads/)\n\n- [Git](https://git-scm.com/downloads)\n\n에이전트에 문제가 발생하면 통합을 개선할 수 있도록 이슈를 열어주세요.\n\n## 📖 더 알아보기\n\n- **[완전한 Spec-Driven Development 방법론](./spec-driven.md)** - 전체 프로세스에 대한 심층 분석\n\n- **[상세 워크스루](#상세-프로세스)** - 단계별 구현 가이드\n\n---\n\n## 📋 상세 프로세스\n\n\u003cdetails\u003e\n\u003csummary\u003e단계별 워크스루를 확장하려면 클릭하세요\u003c/summary\u003e\n\nSpec Mix CLI를 사용하여 프로젝트를 부트스트랩할 수 있으며, 이는 환경에 필요한 아티팩트를 가져옵니다. 실행:\n\n```bash\nspec-mix init \u003cproject_name\u003e\n\n```\n\n또는 현재 디렉토리에서 초기화:\n\n```bash\nspec-mix init .\n# 또는 --here 플래그 사용\nspec-mix init --here\n# 디렉토리에 이미 파일이 있을 때 확인 건너뛰기\nspec-mix init . --force\n# 또는\nspec-mix init --here --force\n\n```\n\n사용 중인 AI 에이전트를 선택하라는 메시지가 표시됩니다. 터미널에서 직접 미리 지정할 수도 있습니다:\n\n```bash\nspec-mix init \u003cproject_name\u003e --ai claude\nspec-mix init \u003cproject_name\u003e --ai gemini\nspec-mix init \u003cproject_name\u003e --ai copilot\n\n# 또는 현재 디렉토리에서:\nspec-mix init . --ai claude\nspec-mix init . --ai codex\n\n# 또는 --here 플래그 사용\nspec-mix init --here --ai claude\nspec-mix init --here --ai codex\n\n# 비어 있지 않은 현재 디렉토리로 강제 병합\nspec-mix init . --force --ai claude\n\n# 또는\nspec-mix init --here --force --ai claude\n\n```\n\nCLI는 Claude Code, Gemini CLI, Cursor CLI, Qwen CLI, opencode, Codex CLI 또는 Amazon Q Developer CLI가 설치되어 있는지 확인합니다. 설치되어 있지 않거나 올바른 도구를 확인하지 않고 템플릿을 가져오려는 경우 명령에 `--ignore-agent-tools`를 사용하세요:\n\n```bash\nspec-mix init \u003cproject_name\u003e --ai claude --ignore-agent-tools\n\n```\n\n### **1단계:** 프로젝트 원칙 수립\n\n프로젝트 폴더로 이동하여 AI 에이전트를 실행하세요. 예제에서는 `claude`를 사용합니다.\n`/spec-mix.constitution`, `/spec-mix.specify`, `/spec-mix.plan`, `/spec-mix.tasks` 및 `/spec-mix.implement` 명령을 사용할 수 있다면 올바르게 구성된 것입니다.\n\n첫 번째 단계는 `/spec-mix.constitution` 명령을 사용하여 프로젝트의 지배 원칙을 수립하는 것입니다. 이는 모든 후속 개발 단계에서 일관된 의사 결정을 보장하는 데 도움이 됩니다:\n\n```text\n/spec-mix.constitution 코드 품질, 테스팅 표준, 사용자 경험 일관성 및 성능 요구사항에 중점을 둔 원칙을 만드세요. 이러한 원칙이 기술 결정 및 구현 선택을 어떻게 안내해야 하는지에 대한 거버넌스를 포함하세요.\n\n```\n\n이 단계는 AI 에이전트가 명세, 계획 및 구현 단계에서 참조할 프로젝트의 기본 가이드라인으로 `.spec-mix/memory/constitution.md` 파일을 생성하거나 업데이트합니다.\n\n### **2단계:** 프로젝트 명세 생성\n\n프로젝트 원칙이 수립되면 이제 기능 명세를 생성할 수 있습니다. `/spec-mix.specify` 명령을 사용한 다음 개발하려는 프로젝트에 대한 구체적인 요구사항을 제공하세요.\n\n\u003e[!IMPORTANT]\n\u003e무엇을 구축하려고 하는지와 그 이유에 대해 가능한 한 명시적으로 설명하세요. **이 시점에서는 기술 스택에 집중하지 마세요**.\n\n예제 프롬프트:\n\n```text\nTaskify, 팀 생산성 플랫폼을 개발하세요. 사용자가 프로젝트를 만들고, 팀원을 추가하고, 작업을 할당하고,\n칸반 스타일로 보드 간에 작업을 댓글 달고 이동할 수 있어야 합니다. 이 기능의 초기 단계에서 \"Create Taskify\"라고\n부르겠습니다. 여러 사용자가 있지만 사용자는 미리 선언되어 미리 정의됩니다. 두 가지 범주로 5명의 사용자를 원합니다.\n한 명의 제품 관리자와 네 명의 엔지니어입니다. 세 개의 다른 샘플 프로젝트를 만들겠습니다. \"To Do\", \"In Progress\",\n\"In Review\" 및 \"Done\"과 같은 각 작업 상태에 대한 표준 칸반 열이 있을 것입니다. 이것은 기본 기능이 설정되어\n있는지 확인하기 위한 첫 번째 테스트이므로 이 애플리케이션에는 로그인이 없습니다. 작업 카드에 대한 UI의 각 작업에\n대해 칸반 작업 보드의 다른 열 간에 작업의 현재 상태를 변경할 수 있어야 합니다. 특정 카드에 대해 무제한 댓글을 남길\n수 있어야 합니다. 해당 작업 카드에서 유효한 사용자 중 한 명을 할당할 수 있어야 합니다. Taskify를 처음 실행하면\n선택할 다섯 명의 사용자 목록이 제공됩니다. 비밀번호가 필요하지 않습니다. 사용자를 클릭하면 프로젝트 목록을 표시하는\n메인 뷰로 이동합니다. 프로젝트를 클릭하면 해당 프로젝트의 칸반 보드가 열립니다. 열이 표시됩니다. 다른 열 사이에서\n카드를 드래그 앤 드롭할 수 있습니다. 현재 로그인한 사용자인 자신에게 할당된 카드는 다른 모든 카드와 다른 색상으로\n표시되므로 자신의 카드를 빠르게 볼 수 있습니다. 자신이 작성한 댓글은 편집할 수 있지만 다른 사람이 작성한 댓글은\n편집할 수 없습니다. 자신이 작성한 댓글은 삭제할 수 있지만 다른 사람이 작성한 댓글은 삭제할 수 없습니다.\n\n```\n\n이 프롬프트를 입력한 후 Claude Code가 계획 및 명세 초안 프로세스를 시작하는 것을 볼 수 있습니다. Claude Code는 또한 저장소를 설정하기 위해 일부 내장 스크립트를 트리거합니다.\n\n이 단계가 완료되면 새 브랜치(예: `001-create-taskify`)와 `specs/001-create-taskify` 디렉토리에 새 명세가 생성됩니다.\n\n생성된 명세에는 템플릿에 정의된 대로 사용자 스토리 및 기능 요구사항 세트가 포함되어야 합니다.\n\n이 단계에서 프로젝트 폴더 내용은 다음과 유사해야 합니다:\n\n```text\n└── .specify\n    ├── memory\n    │  └── constitution.md\n    ├── scripts\n    │  ├── check-prerequisites.sh\n    │  ├── common.sh\n    │  ├── create-new-feature.sh\n    │  ├── setup-plan.sh\n    │  └── update-claude-md.sh\n    ├── specs\n    │  └── 001-create-taskify\n    │      └── spec.md\n    └── templates\n        ├── plan-template.md\n        ├── spec-template.md\n        └── tasks-template.md\n\n```\n\n### **3단계:** 기능 명세 명확화 (계획 전 필수)\n\n기준 명세가 생성되면 첫 번째 시도에서 제대로 캡처되지 않은 요구사항을 명확하게 할 수 있습니다.\n\n기술 계획을 만들기 **전에** 구조화된 명확화 워크플로우를 실행하여 다운스트림 재작업을 줄여야 합니다.\n\n선호하는 순서:\n\n1. `/spec-mix.clarify` 사용 (구조화됨) – 명확화 섹션에 답변을 기록하는 순차적, 커버리지 기반 질문.\n2. 여전히 모호하게 느껴지는 경우 임시 자유 형식 개선으로 선택적으로 후속 조치.\n\n의도적으로 명확화를 건너뛰려는 경우(예: 스파이크 또는 탐색적 프로토타입), 에이전트가 누락된 명확화에서 차단되지 않도록 명시적으로 명시하세요.\n\n예제 자유 형식 개선 프롬프트 (`/spec-mix.clarify` 후에도 여전히 필요한 경우):\n\n```text\n생성하는 각 샘플 프로젝트 또는 프로젝트에 대해 각각에 대해 5개에서 15개 사이의 가변 작업 수가 있어야 하며\n완료의 다양한 상태로 무작위로 분산되어야 합니다. 각 완료 단계에 최소한 하나의 작업이 있는지 확인하세요.\n\n```\n\n또한 Claude Code에게 **검토 및 수락 체크리스트**를 검증하고 요구사항을 충족하는 검증된/통과된 항목을 체크하고 그렇지 않은 항목은 체크하지 않은 상태로 두도록 요청해야 합니다. 다음 프롬프트를 사용할 수 있습니다:\n\n```text\n검토 및 수락 체크리스트를 읽고 기능 명세가 기준을 충족하면 체크리스트의 각 항목을 체크하세요. 그렇지 않으면 비워 두세요.\n\n```\n\nClaude Code와의 상호 작용을 명세에 대한 질문을 명확하게 하고 묻는 기회로 사용하는 것이 중요합니다 - **첫 번째 시도를 최종으로 취급하지 마세요**.\n\n### **4단계:** 계획 생성\n\n이제 기술 스택 및 기타 기술 요구사항에 대해 구체적으로 설명할 수 있습니다. 다음과 같은 프롬프트와 함께 프로젝트 템플릿에 내장된 `/spec-mix.plan` 명령을 사용할 수 있습니다:\n\n```text\n.NET Aspire를 사용하여 생성하고 데이터베이스로 Postgres를 사용합니다. 프론트엔드는 드래그 앤 드롭 작업 보드,\n실시간 업데이트가 있는 Blazor 서버를 사용해야 합니다. 프로젝트 API, 작업 API 및 알림 API로 생성된 REST API가\n있어야 합니다.\n\n```\n\n이 단계의 출력에는 여러 구현 세부정보 문서가 포함되며 디렉토리 트리는 다음과 유사합니다:\n\n```text\n.\n├── CLAUDE.md\n├── memory\n│  └── constitution.md\n├── scripts\n│  ├── check-prerequisites.sh\n│  ├── common.sh\n│  ├── create-new-feature.sh\n│  ├── setup-plan.sh\n│  └── update-claude-md.sh\n├── specs\n│  └── 001-create-taskify\n│      ├── contracts\n│      │  ├── api-spec.json\n│      │  └── signalr-spec.md\n│      ├── data-model.md\n│      ├── plan.md\n│      ├── quickstart.md\n│      ├── research.md\n│      └── spec.md\n└── templates\n    ├── CLAUDE-template.md\n    ├── plan-template.md\n    ├── spec-template.md\n    └── tasks-template.md\n\n```\n\n`research.md` 문서를 확인하여 지침에 따라 올바른 기술 스택이 사용되는지 확인하세요. 구성 요소가 눈에 띄는 경우 Claude Code에 이를 개선하도록 요청하거나 사용하려는 플랫폼/프레임워크의 로컬 설치 버전(예: .NET)을 확인하도록 할 수도 있습니다.\n\n또한 빠르게 변화하는 것(예: .NET Aspire, JS 프레임워크)인 경우 선택한 기술 스택에 대한 세부정보를 조사하도록 Claude Code에 요청할 수 있습니다:\n\n```text\n구현 계획 및 구현 세부정보를 살펴보고 .NET Aspire가 빠르게 변화하는 라이브러리이므로 추가 연구가 도움이 될 수\n있는 영역을 찾고 싶습니다. 추가 연구가 필요하다고 식별한 영역에 대해 이 Taskify 애플리케이션에서 사용할 특정 버전에\n대한 추가 세부정보로 연구 문서를 업데이트하고 웹에서 연구를 사용하여 세부정보를 명확하게 하기 위해 병렬 연구 작업을\n생성하기를 원합니다.\n\n```\n\n이 프로세스 중에 Claude Code가 잘못된 것을 조사하는 데 막히는 것을 발견할 수 있습니다 - 다음과 같은 프롬프트로 올바른 방향으로 유도할 수 있습니다:\n\n```text\n이것을 일련의 단계로 나누어야 한다고 생각합니다. 먼저 구현 중에 수행해야 하는 작업 목록을 식별하되 확실하지 않거나\n추가 연구가 도움이 될 것입니다. 해당 작업 목록을 작성하세요. 그런 다음 이러한 각 작업에 대해 별도의 연구 작업을 생성하여\n최종 결과가 매우 구체적인 모든 작업을 병렬로 조사하는 것입니다. 내가 본 것은 .NET Aspire를 일반적으로 조사하는 것처럼\n보였고 이 경우에 많은 도움이 되지 않을 것 같습니다. 그것은 너무 타겟이 없는 연구입니다. 연구는 특정 타겟 질문을 해결하는\n데 도움이 되어야 합니다.\n\n```\n\n\u003e[!NOTE]\n\u003eClaude Code는 지나치게 열심히 요청하지 않은 구성 요소를 추가할 수 있습니다. 변경의 근거와 출처를 명확히 하도록 요청하세요.\n\n### **5단계:** Claude Code가 계획을 검증하도록 하기\n\n계획이 준비되면 Claude Code가 누락된 부분이 없는지 확인하도록 해야 합니다. 다음과 같은 프롬프트를 사용할 수 있습니다:\n\n```text\n이제 구현 계획 및 구현 세부정보 파일을 감사하기를 원합니다. 수행해야 하는 일련의 작업이 있는지 여부를 결정하는\n데 중점을 두고 읽어보세요. 여기에 충분한 것이 있는지 모르기 때문입니다. 예를 들어 핵심 구현을 볼 때 각 단계를\n안내할 때 정보를 찾을 수 있는 구현 세부정보의 적절한 위치를 핵심 구현 또는 개선에서 참조하는 것이 유용할 것입니다.\n\n```\n\n이는 구현 계획을 개선하는 데 도움이 되며 Claude Code가 계획 주기에서 놓친 잠재적인 맹점을 피하는 데 도움이 됩니다. 초기 개선 패스가 완료되면 구현을 시작하기 전에 Claude Code에 체크리스트를 다시 한 번 확인하도록 요청하세요.\n\n또한 [GitHub CLI](https://docs.github.com/en/github-cli/github-cli)가 설치되어 있는 경우 Claude Code에 현재 브랜치에서 `main`으로 자세한 설명과 함께 풀 리퀘스트를 만들어 노력이 제대로 추적되도록 요청할 수도 있습니다.\n\n\u003e[!NOTE]\n\u003e에이전트가 구현하기 전에 Claude Code에 세부정보를 교차 확인하여 과도하게 엔지니어링된 부분이 있는지 확인하는 것도 가치가 있습니다(기억하세요 - 과도하게 열심일 수 있습니다). 과도하게 엔지니어링된 구성 요소 또는 결정이 존재하는 경우 Claude Code에 이를 해결하도록 요청할 수 있습니다. Claude Code가 계획을 수립할 때 반드시 준수해야 하는 기본 부분으로 [constitution](base/memory/constitution.md)을 따르는지 확인하세요.\n\n### **6단계:** /spec-mix.tasks로 작업 분해 생성\n\n구현 계획이 검증되면 이제 올바른 순서로 실행할 수 있는 특정 실행 가능한 작업으로 계획을 세분화할 수 있습니다. `/spec-mix.tasks` 명령을 사용하여 구현 계획에서 자동으로 상세한 작업 분해를 생성하세요:\n\n```text\n/spec-mix.tasks\n\n```\n\n이 단계는 기능 명세 디렉토리에 다음을 포함하는 `tasks.md` 파일을 생성합니다:\n\n- **사용자 스토리별로 구성된 작업 분해** - 각 사용자 스토리는 자체 작업 세트가 있는 별도의 구현 단계가 됩니다\n\n- **종속성 관리** - 작업은 구성 요소 간 종속성을 존중하도록 순서가 지정됩니다(예: 서비스 전의 모델, 엔드포인트 전의 서비스)\n\n- **병렬 실행 마커** - 병렬로 실행할 수 있는 작업은 개발 워크플로우를 최적화하기 위해 `[P]`로 표시됩니다\n\n- **파일 경로 사양** - 각 작업에는 구현이 발생해야 하는 정확한 파일 경로가 포함됩니다\n\n- **테스트 주도 개발 구조** - 테스트가 요청되면 테스트 작업이 포함되고 구현 전에 작성되도록 순서가 지정됩니다\n\n- **체크포인트 검증** - 각 사용자 스토리 단계에는 독립적인 기능을 검증하기 위한 체크포인트가 포함됩니다\n\n생성된 tasks.md는 `/spec-mix.implement` 명령에 대한 명확한 로드맵을 제공하여 코드 품질을 유지하고 사용자 스토리의 점진적 전달을 허용하는 체계적인 구현을 보장합니다.\n\n### **7단계:** 구현\n\n준비가 되면 `/spec-mix.implement` 명령을 사용하여 구현 계획을 실행하세요:\n\n```text\n/spec-mix.implement\n\n```\n\n`/spec-mix.implement` 명령은:\n\n- 모든 전제 조건이 준비되어 있는지 검증합니다(constitution, spec, plan 및 tasks)\n\n- `tasks.md`에서 작업 분해를 구문 분석합니다\n\n- 종속성 및 병렬 실행 마커를 존중하면서 올바른 순서로 작업을 실행합니다\n\n- 작업 계획에 정의된 TDD 접근 방식을 따릅니다\n\n- 진행 상황 업데이트를 제공하고 오류를 적절하게 처리합니다\n\n\u003e[!IMPORTANT]\n\u003eAI 에이전트는 로컬 CLI 명령(예: `dotnet`, `npm` 등)을 실행합니다 - 필요한 도구가 컴퓨터에 설치되어 있는지 확인하세요.\n\n구현이 완료되면 애플리케이션을 테스트하고 CLI 로그에 표시되지 않을 수 있는 런타임 오류(예: 브라우저 콘솔 오류)를 해결하세요. 해결을 위해 이러한 오류를 AI 에이전트에 복사하여 붙여넣을 수 있습니다.\n\n\u003c/details\u003e\n\n---\n\n## 🔍 문제 해결\n\n### 마크다운 린팅\n\n이 프로젝트는 일관된 문서 형식을 보장하기 위해 마크다운 린팅을 사용합니다. 커밋하기 전에 마크다운 파일을 확인하려면:\n\n**설정 (한 번만):**\n\n```bash\n# 의존성 설치\nnpm install\n\n# pre-commit 훅 활성화\n./setup-hooks.sh\n```\n\n**수동 린트 확인:**\n\n```bash\n# 모든 마크다운 파일 확인\n./lint.sh\n\n# 린트 문제 자동 수정\n./lint.sh --fix\n\n# 또는 npm 스크립트 사용\nnpm run lint\nnpm run lint:fix\n```\n\n**Pre-commit 훅:**\n`./setup-hooks.sh`로 설정하면 각 커밋 전에 마크다운 파일이 자동으로 확인됩니다. 일시적으로 비활성화하려면:\n\n```bash\n# 훅 비활성화\ngit config --unset core.hooksPath\n\n# 훅 재활성화\n./setup-hooks.sh\n```\n\n### Linux에서 Git Credential Manager\n\nLinux에서 Git 인증에 문제가 있는 경우 Git Credential Manager를 설치할 수 있습니다:\n\n```bash\n#!/usr/bin/env bash\nset -e\necho \"Git Credential Manager v2.6.1 다운로드 중...\"\nwget https://github.com/git-ecosystem/git-credential-manager/releases/download/v2.6.1/gcm-linux_amd64.2.6.1.deb\necho \"Git Credential Manager 설치 중...\"\nsudo dpkg -i gcm-linux_amd64.2.6.1.deb\necho \"Git이 GCM을 사용하도록 구성 중...\"\ngit config --global credential.helper manager\necho \"정리 중...\"\nrm gcm-linux_amd64.2.6.1.deb\n\n```\n\n## 👥 메인테이너\n\n- Gabriel Ki ([@dan1901](https://github.com/dan1901))\n\n## 💬 지원\n\n지원이 필요하시면 이 저장소에서 이슈를 열어주세요:\n\n- [버그 신고](https://github.com/dan1901/spec-mix/issues/new?labels=bug)\n- [기능 요청](https://github.com/dan1901/spec-mix/issues/new?labels=enhancement)\n- [질문하기](https://github.com/dan1901/spec-mix/issues/new?labels=question)\n\n버그 보고서, 기능 요청 및 Spec-Driven Development 사용에 대한 질문을 환영합니다.\n\n## 🙏 감사의 말\n\n- Spec-Driven Development의 기반을 만들어 준 원본 [github/spec-kit](https://github.com/github/spec-kit) 팀에게 특별히 감사드립니다\n- 지속적인 피드백과 기여를 해주신 오픈 소스 커뮤니티\n- 번역과 기능 개선을 도와주신 모든 기여자\n\n## 📄 라이선스\n\n이 프로젝트는 MIT 오픈소스 라이선스 조건에 따라 라이선스가 부여됩니다. 전체 조건은 [LICENSE](./LICENSE) 파일을 참조하세요.\n\n---\n\u003c!-- 이 README는 GitHub Actions에 의해 README.ko.template.md에서 자동 생성됩니다 --\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fletsur-dev%2Fspec-mix","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fletsur-dev%2Fspec-mix","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fletsur-dev%2Fspec-mix/lists"}