{"id":51157396,"url":"https://github.com/taipm/setup-c2","last_synced_at":"2026-06-26T11:30:28.222Z","repository":{"id":350718255,"uuid":"1207983248","full_name":"taipm/setup-c2","owner":"taipm","description":"Zero-config Claude Code setup for any project","archived":false,"fork":false,"pushed_at":"2026-04-11T18:34:26.000Z","size":81,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-11T19:24:53.350Z","etag":null,"topics":["ai-agents","ai-tools","anthropic","claude","claude-code","cli","developer-tools","mcp"],"latest_commit_sha":null,"homepage":"https://git.microai.club/taipm/setup-c2","language":"JavaScript","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/taipm.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-11T16:59:05.000Z","updated_at":"2026-04-11T18:34:31.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/taipm/setup-c2","commit_stats":null,"previous_names":["taipm/setup-c2"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/taipm/setup-c2","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taipm%2Fsetup-c2","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taipm%2Fsetup-c2/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taipm%2Fsetup-c2/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taipm%2Fsetup-c2/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/taipm","download_url":"https://codeload.github.com/taipm/setup-c2/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taipm%2Fsetup-c2/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34815669,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-26T02:00:06.560Z","response_time":106,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["ai-agents","ai-tools","anthropic","claude","claude-code","cli","developer-tools","mcp"],"created_at":"2026-06-26T11:30:27.370Z","updated_at":"2026-06-26T11:30:28.220Z","avatar_url":"https://github.com/taipm.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003ch1 align=\"center\"\u003esetup-c2\u003c/h1\u003e\n  \u003cp align=\"center\"\u003e\n    \u003cstrong\u003eZero-config Claude Code setup for any project\u003c/strong\u003e\n  \u003c/p\u003e\n  \u003cp align=\"center\"\u003e\n    \u003ca href=\"#quick-start\"\u003eQuick Start\u003c/a\u003e •\n    \u003ca href=\"#features\"\u003eFeatures\u003c/a\u003e •\n    \u003ca href=\"#examples\"\u003eExamples\u003c/a\u003e •\n    \u003ca href=\"#plugins\"\u003ePlugins\u003c/a\u003e •\n    \u003ca href=\"https://git.microai.club/taipm/setup-c2\"\u003eGitea Mirror\u003c/a\u003e\n  \u003c/p\u003e\n  \u003cp align=\"center\"\u003e\n    \u003ca href=\"https://github.com/taipm/setup-c2/stargazers\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/taipm/setup-c2?style=social\" alt=\"Stars\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/taipm/setup-c2/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://www.npmjs.com/package/setup-c2\"\u003e\u003cimg src=\"https://img.shields.io/npm/v/setup-c2.svg\" alt=\"npm\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/taipm\"\u003e\u003cimg src=\"https://img.shields.io/badge/author-Tai%20Phan%20Minh-orange\" alt=\"Author\"\u003e\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/p\u003e\n\n---\n\n**setup-c2** scaffolds a complete [Claude Code](https://docs.anthropic.com/en/docs/claude-code) configuration in seconds — CLAUDE.md, skills, commands, hooks, and agents. Works for new projects and existing codebases.\n\n\u003e Built by [**Tai Phan Minh**](https://github.com/taipm) — AI Engineer, MCP server developer, and Claude Code power user.\n\n## Quick Start\n\n```bash\n# Run directly (no install needed)\nnpx setup-c2 init\n\n# Or install globally\nnpm install -g setup-c2\nsetup-c2 init\n```\n\nThat's it. Your project is now Claude Code-ready.\n\n## Features\n\nSet up **6 components** of Claude Code in one command:\n\n| Component | What it does |\n|-----------|-------------|\n| `CLAUDE.md` | Project instructions — tells Claude how to work in your codebase |\n| `.claude/` | Configuration directory with permissions and settings |\n| **Skills** | Extend Claude with domain-specific knowledge and workflows |\n| **Commands** | Slash commands (`/deploy`, `/test`) for common workflows |\n| **Hooks** | Event handlers — run code on PreToolUse, PostToolUse, Stop |\n| **Agents** | Specialized subagents for autonomous tasks |\n\n### Why setup-c2?\n\n- **Zero config** — smart defaults based on your project's language and structure\n- **Framework detection** — auto-detects 8 languages (JS/TS, Python, Go, Rust, Java, Ruby, Elixir) and generates language-specific templates\n- **Non-destructive** — never overwrites existing files, safe for existing projects\n- **Interactive or scripted** — works in CI/CD pipelines with `--yes` flag\n- **Practical skills** — scaffolds real skills (project-discovery, understand-questions, deep-questions), not just examples\n- **Plugin system** — bundled plugins installable via CLI or wizard\n- **Opinionated templates** — battle-tested patterns from real production use\n\n## Examples\n\n### New project\n\n```bash\nmkdir my-app \u0026\u0026 cd my-app \u0026\u0026 git init\nnpx setup-c2 init\n```\n\nOutput:\n```\n📄 CLAUDE.md\n  ✔ CLAUDE.md (language-specific: JavaScript)\n📁 .claude/\n  ✔ .claude/settings.local.json\n🎯 Skills\n  ✔ .claude/skills/project-discovery/SKILL.md\n  ✔ .claude/skills/understand-questions/SKILL.md\n  ✔ .claude/skills/deep-questions/SKILL.md\n  ✔ .claude/skills/example/SKILL.md\n⚡ Commands\n  ✔ .claude/commands/example.md\n🪝 Hooks\n  ✔ .claude/hooks/README.md\n🤖 Agents\n  ✔ .claude/agents/example-agent.md\n\n✅ Done! Claude Code configuration created.\n```\n\n### Existing project (selective setup)\n\n```bash\ncd my-existing-project\nnpx setup-c2 init --targets skills,hooks,agents\n```\n\n### Non-interactive (CI/CD)\n\n```bash\nnpx setup-c2 init --yes --targets claude-md,skills,hooks\nnpx setup-c2 init --yes --plugins microai,dev-team\n```\n\n### Plugin management\n\n```bash\n# List bundled plugins\nsetup-c2 plugin list\n\n# Install a bundled plugin\nsetup-c2 plugin install microai\nsetup-c2 plugin install dev-team\n```\n\n## Installation\n\n### CLI Tool (for any project)\n\n```bash\n# Run directly — no install needed\nnpx setup-c2 init\n\n# Or install globally\nnpm install -g setup-c2\nsetup-c2 init\n```\n\n### Plugin (for Claude Code users)\n\n```bash\n# Install microai plugin (includes what-next + health-check skills)\nclaude plugin install /path/to/setup-c2/plugins/microai\n```\n\n\u003e **Note**: Plugin microai has independent versioning from CLI. CLI: v0.1.0, Plugin: v0.1.1-alpha.\n\n## Plugins\n\nsetup-c2 ships with **3 bundled plugins**:\n\n### microai — Project Evolution Toolkit (4 skills)\n\n| Skill | Usage | Role |\n|-------|-------|------|\n| **what-next** | `/what-next [step]` | Plan \u0026 execute: assess → ideas → scope → milestones → issues → PRs |\n| **health-check** | `/health-check [dim]` | Verify 6 dimensions: consistency, completeness, quality, artifacts, alignment, risks |\n| **optimize-claude-md** | `/optimize-claude-md` | Intelligent CLAUDE.md condensing within 200-line limit |\n| **follow-up** | `/follow-up \u003cowner/repo\u003e` | Deep-analyze \u0026 track GitHub projects |\n\nInstall: `claude plugin install /path/to/setup-c2/plugins/microai`\n\n### dev-team — Autonomous Development Team\n\n\u003e *\"Implement this feature\"* → full pipeline from design to PR\n\n5 specialized agents collaborate automatically: **architect → developer → reviewer → tester → devops**.\n\n- Supports Rust, Go, Python with language-specific concurrency best practices\n- Deep Gitea/GitHub integration: issues, labels, milestones, PRs, releases\n- Auto-retry when reviewer rejects (max 3 rounds)\n- Integrates with what-next: auto-picks roadmap issues\n\nInstall: `claude plugin install /path/to/setup-c2/plugins/dev-team`\n\nUsage: `/dev-team [task | #issue-id | --from-roadmap]`\n\n### discovery-team — Codebase Analysis Team\n\n\u003e *\"Discover this project\"* → deep architecture report\n\n3 specialized agents (architect, strategist, auditor) collaborate to analyze codebases:\n\n| Skill | Usage | Output |\n|-------|-------|--------|\n| **project-discovery** | `/project-discovery` | `discovery.md` — architecture, dependency graph, per-module breakdown |\n| **understand-questions** | `/understand-questions` | `understand-questions.md` — onboarding Q\u0026A for new devs |\n| **deep-questions** | `/deep-questions` | `deep-questions.md` — production readiness audit |\n\nInstall: `claude plugin install /path/to/setup-c2/plugins/discovery-team`\n\n## File Structure\n\n```\nyour-project/\n├── CLAUDE.md                          # Project instructions (language-specific)\n└── .claude/\n    ├── settings.local.json            # Permission config\n    ├── skills/\n    │   ├── project-discovery/SKILL.md # Deep dive architecture report\n    │   ├── understand-questions/SKILL.md # Onboarding Q\u0026A for new devs\n    │   ├── deep-questions/SKILL.md    # Production readiness audit\n    │   └── example/SKILL.md           # Skill template reference\n    ├── commands/\n    │   └── example.md                 # Command template\n    ├── hooks/\n    │   └── README.md                  # Hook guide\n    └── agents/\n        └── example-agent.md           # Agent template\n```\n\n### Scaffolded Skills\n\n| Skill | What it does |\n|-------|-------------|\n| **project-discovery** | Deep dive codebase: architecture, dependency graph, per-module breakdown → `discovery.md` |\n| **understand-questions** | Onboarding Q\u0026A (8 STEPs) for new devs with sub-agent fan-out → `understand-questions.md` |\n| **deep-questions** | Production readiness audit: failure modes, security, performance → `deep-questions.md` |\n| **example** | Template reference for creating your own skills |\n\n### Framework Detection\n\n`setup-c2 init` auto-detects your project language and generates appropriate templates:\n\n| Marker file | Detected language | CLAUDE.md template |\n|-------------|-------------------|-------------------|\n| `Cargo.toml` | Rust | `cargo build/test/clippy` |\n| `go.mod` | Go | `go build/test/vet` |\n| `pyproject.toml` | Python | `pytest/ruff/venv` |\n| `package.json` | JavaScript | `npm install/test/build` |\n| `pom.xml` | Java | Generic |\n| `Gemfile` | Ruby | Generic |\n\nPriority: Rust/Go \u003e Python \u003e JavaScript (specific languages detected first).\n\n## Best Practices\n\n### CLAUDE.md\n- Mô tả project overview, build/test commands, và cấu trúc thư mục\n- Thêm conventions cụ thể: naming, error handling, testing patterns\n- Giữ ngắn gọn — Claude đọc file này mỗi lần bắt đầu conversation\n\n### Skills\n- Mỗi skill tập trung vào một domain cụ thể\n- Viết `description` rõ ràng để Claude biết khi nào nên kích hoạt\n- Dùng progressive disclosure: tóm tắt trước, chi tiết sau\n\n### Commands\n- Đặt tên trực quan: `/deploy`, `/test`, `/review`\n- Giới hạn `allowed-tools` để tránh side effects không mong muốn\n- Dùng arguments cho flexibility: `/deploy staging`\n\n### Hooks\n- `PreToolUse` để validate/log trước khi tool chạy\n- `PostToolUse` để auto-format hoặc lint sau khi edit\n- `Stop` để auto-save state khi Claude kết thúc response\n- Giữ hooks nhanh (\u003c 5s) để không block workflow\n\n### Agents\n- Mỗi agent chuyên biệt một nhiệm vụ (code review, testing, docs)\n- Chỉ cấp tools agent thực sự cần\n- Dùng `model: haiku` cho tasks đơn giản để tiết kiệm tokens\n\n## Programmatic Usage\n\n`setup-c2` can be imported as a library:\n\n```js\nimport { init, getDefaults } from 'setup-c2';\nimport { detectProject } from 'setup-c2/src/detector.js';\nimport { listBundledPlugins } from 'setup-c2/src/plugins.js';\n\n// Get default answers based on current directory\nconst defaults = getDefaults({ targets: 'claude-md,skills' });\n\n// Auto-detect project language\nconst detected = detectProject(process.cwd());\n// → { language: 'rust', marker: 'Cargo.toml' } or null\n\n// List bundled plugins\nconst plugins = listBundledPlugins();\n// → [{ name: 'microai', version: '0.1.1-alpha', description: '...', path: '...' }, ...]\n\n// Run init programmatically\nawait init({ yes: true, targets: 'claude-md,skills' });\n```\n\n## Requirements\n\n- Node.js \u003e= 18\n\n## Author\n\n**Tai Phan Minh** ([@taipm](https://github.com/taipm))\n\nAI Engineer specializing in autonomous agents, MCP server development, and Claude Code tooling.\n\n- GitHub: [github.com/taipm](https://github.com/taipm)\n- Gitea: [git.microai.club/taipm](https://git.microai.club/taipm)\n\n## Contributing\n\nIssues and PRs welcome! Please open an issue first to discuss what you'd like to change.\n\n## License\n\n[MIT](LICENSE) © Tai Phan Minh\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftaipm%2Fsetup-c2","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftaipm%2Fsetup-c2","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftaipm%2Fsetup-c2/lists"}