{"id":37229214,"url":"https://github.com/cassmtnr/claude-code-starter","last_synced_at":"2026-04-02T00:14:47.251Z","repository":{"id":332004365,"uuid":"1132426813","full_name":"cassmtnr/claude-code-starter","owner":"cassmtnr","description":"Intelligent CLI that uses Claude to deeply analyze your project and generate tailored Claude Code configurations.","archived":false,"fork":false,"pushed_at":"2026-03-23T16:08:53.000Z","size":423,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-23T18:19:02.869Z","etag":null,"topics":["ai","claude","claude-ai","claude-code","claude-skills"],"latest_commit_sha":null,"homepage":"https://cassmtnr.github.io/claude-code-starter/","language":"TypeScript","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/cassmtnr.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"ROADMAP.md","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-01-11T23:45:10.000Z","updated_at":"2026-03-23T00:00:12.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/cassmtnr/claude-code-starter","commit_stats":null,"previous_names":["cassmtnr/claude-code-starter"],"tags_count":32,"template":false,"template_full_name":null,"purl":"pkg:github/cassmtnr/claude-code-starter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cassmtnr%2Fclaude-code-starter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cassmtnr%2Fclaude-code-starter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cassmtnr%2Fclaude-code-starter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cassmtnr%2Fclaude-code-starter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cassmtnr","download_url":"https://codeload.github.com/cassmtnr/claude-code-starter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cassmtnr%2Fclaude-code-starter/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31293320,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T21:15:39.731Z","status":"ssl_error","status_checked_at":"2026-04-01T21:15:34.046Z","response_time":53,"last_error":"SSL_read: 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":["ai","claude","claude-ai","claude-code","claude-skills"],"created_at":"2026-01-15T03:31:41.168Z","updated_at":"2026-04-02T00:14:47.202Z","avatar_url":"https://github.com/cassmtnr.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Claude Code Starter\n\n[![CI](https://github.com/cassmtnr/claude-code-starter/actions/workflows/pr-check.yml/badge.svg)](https://github.com/cassmtnr/claude-code-starter/actions/workflows/pr-check.yml)\n[![codecov](https://codecov.io/gh/cassmtnr/claude-code-starter/graph/badge.svg)](https://codecov.io/gh/cassmtnr/claude-code-starter)\n[![npm version](https://img.shields.io/npm/v/claude-code-starter.svg)](https://www.npmjs.com/package/claude-code-starter)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Node.js](https://img.shields.io/badge/Node.js-18%2B-green.svg)](https://nodejs.org/)\n[![Bun](https://img.shields.io/badge/Bun-compatible-f472b6.svg)](https://bun.sh/)\n\nIntelligent CLI that uses Claude to deeply analyze your project and generate tailored Claude Code configurations.\n\n## Quick Start\n\n```bash\ncd your-project\nnpx claude-code-starter\nclaude\n```\n\n**Requires [Claude CLI](https://claude.ai/download) to be installed.**\n\n## What It Does\n\n1. **Analyzes your repository** - Detects languages, frameworks, tools, and patterns\n2. **Launches Claude CLI** - Claude reads your actual source files and understands your architecture\n3. **Generates a professional CLAUDE.md** - Project-specific documentation with architecture, conventions, and patterns\n4. **Creates supporting configurations** - Skills, agents, rules, and commands tailored to your stack\n\n## How It Works\n\n```\nnpx claude-code-starter\n  |\n  ├── 1. Detect tech stack (languages, frameworks, tools)\n  ├── 2. Generate supporting files (skills, agents, rules, commands)\n  ├── 3. Launch Claude CLI for deep project analysis\n  │     └── Claude reads source files → understands architecture → writes CLAUDE.md\n  └── 4. Done! Run `claude` to start working\n```\n\nThe key difference from static scaffolding tools: Claude actually **reads your codebase** and generates documentation specific to your project's architecture, patterns, conventions, and domain knowledge.\n\n## Tech Stack Detection\n\nAutomatically detects and configures for:\n\n| Category       | Detected                                                            |\n| -------------- | ------------------------------------------------------------------- |\n| **Languages**  | TypeScript, JavaScript, Python, Go, Rust, Java, Ruby, Swift, Kotlin |\n| **Frameworks** | Next.js, React, Vue, Svelte, FastAPI, Django, NestJS, Express, etc. |\n| **Tools**      | npm, yarn, pnpm, bun, pip, cargo, go modules                        |\n| **Testing**    | Jest, Vitest, Pytest, Go test, Rust test                            |\n| **Linting**    | ESLint, Biome, Ruff, Pylint                                         |\n\n## Generated Configurations\n\nBased on your stack, creates:\n\n- **CLAUDE.md** - Comprehensive project documentation generated by Claude's deep analysis of your codebase\n- **Skills** - Framework-specific patterns (e.g., Next.js App Router, FastAPI endpoints)\n- **Agents** - Specialized assistants (code reviewer, test writer)\n- **Rules** - Language conventions (TypeScript strict mode, Python PEP 8)\n- **Commands** - Workflow shortcuts (`/task`, `/status`, `/done`, `/analyze`, `/code-review`)\n\n## Commands\n\n| Command           | Description                             |\n| ----------------- | --------------------------------------- |\n| `/task \u003cdesc\u003e`    | Start a new task                        |\n| `/status`         | Show current task                       |\n| `/done`           | Mark task complete                      |\n| `/analyze \u003carea\u003e` | Deep dive into code                     |\n| `/code-review`    | Review changes for quality and security |\n\n## CLI Options\n\n```bash\nnpx claude-code-starter           # Interactive mode\nnpx claude-code-starter -y        # Non-interactive (use defaults)\nnpx claude-code-starter -f        # Force overwrite existing files\nnpx claude-code-starter -V        # Verbose output\nnpx claude-code-starter --help    # Show help\n```\n\n## Example Output\n\n```\nClaude Code Starter v0.4.1\nIntelligent AI-Assisted Development Setup\n\nAnalyzing repository...\n\nTech Stack\n  Language: TypeScript\n  Framework: Next.js\n  Package Manager: bun\n  Testing: vitest\n\nExisting project with 42 source files\n\nGenerating supporting configuration...\n\nCreated:\n  + .claude/settings.json\n  + .claude/skills/pattern-discovery.md\n  + .claude/skills/nextjs-patterns.md\n  ...\n\nLaunching Claude for deep project analysis...\nClaude will read your codebase and generate a comprehensive CLAUDE.md\n\nClaude analysis complete!\n\nDone! (15 files)\n\nGenerated for your stack:\n  CLAUDE.md (deep analysis by Claude)\n  9 skills (pattern-discovery, iterative-development, security, nextjs-patterns, ...)\n  2 agents (code-reviewer, test-writer)\n  2 rules\n\nNext step: Run claude to start working!\n```\n\n## Project Structure\n\nAfter running, your project will have:\n\n```\n.claude/\n├── CLAUDE.md           # Project-specific docs (generated by Claude analysis)\n├── settings.json       # Permissions configuration\n├── agents/             # Specialized AI agents\n│   ├── code-reviewer.md\n│   └── test-writer.md\n├── commands/           # Slash commands\n│   ├── task.md\n│   ├── status.md\n│   ├── done.md\n│   ├── analyze.md\n│   └── code-review.md\n├── rules/              # Code style rules\n│   ├── typescript.md   # (or python.md, etc.)\n│   └── code-style.md\n├── skills/             # Methodology guides + patterns\n│   ├── pattern-discovery.md\n│   ├── systematic-debugging.md\n│   ├── testing-methodology.md\n│   ├── iterative-development.md\n│   ├── commit-hygiene.md\n│   ├── code-deduplication.md\n│   ├── simplicity-rules.md\n│   ├── security.md\n│   └── nextjs-patterns.md  # (framework-specific)\n└── state/\n    └── task.md         # Current task tracking\n```\n\n## Architecture\n\n```mermaid\nflowchart LR\n    A[CLI] --\u003e B[Analyzer]\n    B --\u003e C[Generator]\n    B --\u003e D[Claude CLI]\n\n    B --\u003e|reads| E[package.json]\n    B --\u003e|reads| F[config files]\n    B --\u003e|reads| G[lock files]\n\n    C --\u003e|creates| H[skills/]\n    C --\u003e|creates| I[agents/]\n    C --\u003e|creates| J[rules/]\n    C --\u003e|creates| K[commands/]\n\n    D --\u003e|reads| L[source files]\n    D --\u003e|creates| M[CLAUDE.md]\n```\n\n### Artifact Generation\n\n| Artifact Type     | Generation Method                                        |\n| ----------------- | -------------------------------------------------------- |\n| **CLAUDE.md**     | Claude CLI deep analysis of your actual source files     |\n| **settings.json** | Generated with safe default permissions                  |\n| **Skills**        | Core skills + framework-specific patterns (if detected)  |\n| **Agents**        | Code reviewer and test writer agents                     |\n| **Rules**         | Language-specific conventions + general code style       |\n| **Commands**      | Task workflow commands (/task, /status, /done, /analyze) |\n\n### Conflict Resolution\n\nWhen running on an existing project with `.claude/` configuration:\n\n| Scenario           | Behavior            |\n| ------------------ | ------------------- |\n| **New file**       | Created             |\n| **Existing file**  | Skipped (preserved) |\n| **With `-f` flag** | Overwritten         |\n| **state/task.md**  | Always preserved    |\n\n### Framework-Specific Patterns\n\nWhen a framework is detected, additional skills are generated:\n\n| Framework       | Generated Skill                                      |\n| --------------- | ---------------------------------------------------- |\n| Next.js         | `nextjs-patterns.md` - App Router, Server Components |\n| React           | `react-components.md` - Hooks, component patterns    |\n| FastAPI         | `fastapi-patterns.md` - Async endpoints, Pydantic    |\n| NestJS          | `nestjs-patterns.md` - Modules, decorators, DI       |\n| SwiftUI         | `swiftui-patterns.md` - Declarative UI patterns      |\n| UIKit           | `uikit-patterns.md` - View controller patterns       |\n| Vapor           | `vapor-patterns.md` - Server-side Swift              |\n| Jetpack Compose | `compose-patterns.md` - Compose UI patterns          |\n| Android Views   | `android-views-patterns.md` - XML views              |\n\n## Requirements\n\n- **Node.js 18+** (for running via npx)\n- **[Claude CLI](https://claude.ai/download)** (for deep project analysis)\n\n## License\n\nMIT License. See [LICENSE](LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcassmtnr%2Fclaude-code-starter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcassmtnr%2Fclaude-code-starter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcassmtnr%2Fclaude-code-starter/lists"}