{"id":35893252,"url":"https://github.com/CloudAI-X/claude-workflow-v2","last_synced_at":"2026-01-15T19:00:46.932Z","repository":{"id":331322690,"uuid":"1126064944","full_name":"CloudAI-X/claude-workflow-v2","owner":"CloudAI-X","description":"Universal Claude Code workflow plugin with agents, skills, hooks, and commands","archived":false,"fork":false,"pushed_at":"2026-01-05T12:54:26.000Z","size":123,"stargazers_count":990,"open_issues_count":0,"forks_count":159,"subscribers_count":9,"default_branch":"main","last_synced_at":"2026-01-06T06:55:30.878Z","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/CloudAI-X.png","metadata":{"files":{"readme":"README.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":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-01-01T02:20:41.000Z","updated_at":"2026-01-06T05:51:52.000Z","dependencies_parsed_at":"2026-01-07T00:09:49.569Z","dependency_job_id":null,"html_url":"https://github.com/CloudAI-X/claude-workflow-v2","commit_stats":null,"previous_names":["cloudai-x/claude-workflow"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/CloudAI-X/claude-workflow-v2","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CloudAI-X%2Fclaude-workflow-v2","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CloudAI-X%2Fclaude-workflow-v2/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CloudAI-X%2Fclaude-workflow-v2/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CloudAI-X%2Fclaude-workflow-v2/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CloudAI-X","download_url":"https://codeload.github.com/CloudAI-X/claude-workflow-v2/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CloudAI-X%2Fclaude-workflow-v2/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28465783,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-15T18:56:24.589Z","status":"ssl_error","status_checked_at":"2026-01-15T18:56:23.992Z","response_time":62,"last_error":"SSL_read: (null) (tls_retry_write_records failure)","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-01-09T11:00:36.028Z","updated_at":"2026-01-15T19:00:46.915Z","avatar_url":"https://github.com/CloudAI-X.png","language":"Python","funding_links":[],"categories":["Configuration \u0026 Rules","Claude Plugins","📦 Skill Collections","Code \u0026 Developer Tools","Python","Comprehensive Frameworks"],"sub_categories":[],"readme":"# project-starter\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Claude Code](https://img.shields.io/badge/Claude%20Code-v1.0.33+-blue.svg)](https://code.claude.com)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/CloudAI-X/claude-workflow/pulls)\n\nA universal Claude Code workflow plugin with specialized agents, skills, hooks, and output styles for any software project.\n\n---\n\n## Quick Start\n\n### Option 1: CLI (Per-Session)\n\n```bash\n# Clone the plugin\ngit clone https://github.com/CloudAI-X/claude-workflow.git\n\n# Run Claude Code with the plugin\nclaude --plugin-dir ./claude-workflow\n```\n\n### Option 2: Agent SDK\n\n```typescript\nimport { query } from \"@anthropic-ai/claude-agent-sdk\";\n\nfor await (const message of query({\n  prompt: \"Hello\",\n  options: {\n    plugins: [{ type: \"local\", path: \"./claude-workflow\" }],\n  },\n})) {\n  // Plugin commands, agents, and skills are now available\n}\n```\n\n### Option 3: Install Permanently\n\n```bash\n# Install from marketplace (when available)\nclaude plugin install project-starter\n\n# Or install from local directory\nclaude plugin install ./claude-workflow\n```\n\n### Verify Installation\n\nAfter loading the plugin, verify it's working:\n\n```\n\u003e /plugin\n```\n\nTab to **Installed** - you should see `project-starter` listed.\nTab to **Errors** - should be empty (no errors).\n\nThese commands become available:\n\n```\n/project-starter:architect    # Architecture-first mode\n/project-starter:rapid        # Ship fast mode\n/project-starter:commit       # Auto-generate commit message\n/project-starter:verify-changes  # Multi-agent verification\n```\n\n---\n\n## What's Included\n\n| Component    | Count | Description                                                              |\n| ------------ | ----- | ------------------------------------------------------------------------ |\n| **Agents**   | 7     | Specialized subagents for code review, debugging, security, etc.         |\n| **Commands** | 17    | Slash commands for workflows and output styles                           |\n| **Skills**   | 6     | Knowledge domains Claude uses autonomously                               |\n| **Hooks**    | 9     | Automation scripts for formatting, security, verification, notifications |\n\n---\n\n## Usage Examples\n\n### Commands in Action\n\n**Auto-commit your changes:**\n\n```\n\u003e /project-starter:commit\n\nLooking at staged changes...\n✓ Created commit: feat(auth): add JWT refresh token endpoint\n```\n\n**Full git workflow:**\n\n```\n\u003e /project-starter:commit-push-pr\n\n✓ Committed: feat: add user dashboard\n✓ Pushed to origin/feature/dashboard\n✓ Created PR #42: https://github.com/you/repo/pull/42\n```\n\n**Verify before shipping:**\n\n```\n\u003e /project-starter:verify-changes\n\nSpawning verification agents...\n├─ build-validator: ✓ Build passes\n├─ test-runner: ✓ 42 tests pass\n├─ lint-checker: ⚠ 2 warnings (non-blocking)\n└─ security-scanner: ✓ No vulnerabilities\n\nReady to ship!\n```\n\n### Agents in Action\n\nAgents spawn automatically based on your request:\n\n**You say:** \"The login is broken, users get 401 errors\"\n\n```\n[debugger agent activated]\n→ Checking auth middleware... found issue\n→ Token validation uses wrong secret in production\n→ Fix: Update AUTH_SECRET in .env.production\n```\n\n**You say:** \"Review my changes\"\n\n```\n[code-reviewer agent activated]\n→ Analyzing 3 files changed...\n✓ Logic is correct\n⚠ Missing null check on line 42\n⚠ Consider adding rate limiting to this endpoint\n```\n\n**You say:** \"Add authentication to the API\"\n\n```\n[orchestrator agent activated]\n→ Breaking down into subtasks:\n  1. Design auth schema (spawning architect)\n  2. Implement JWT middleware\n  3. Add login/register endpoints\n  4. Write tests (spawning test-architect)\n  5. Update API docs (spawning docs-writer)\n```\n\n### Skills in Action\n\nSkills provide domain knowledge automatically:\n\n**You ask:** \"How should I structure the payment service?\"\n\n```\n[designing-architecture skill applied]\n→ Recommending hexagonal architecture\n→ Payment providers as adapters\n→ Core domain isolated from infrastructure\n```\n\n**You ask:** \"Make this endpoint faster\"\n\n```\n[optimizing-performance skill applied]\n→ Adding database indexes\n→ Implementing response caching\n→ Using pagination for large results\n```\n\n### Hooks in Action\n\nHooks run automatically on events:\n\n**Security block (pre-edit):**\n\n```\n⛔ BLOCKED: Potential secret detected\n   File: src/config.ts, Line 5\n   Pattern: API key (sk-...)\n\n   Remove the secret and use environment variables.\n```\n\n**Auto-format (post-edit):**\n\n```\n✓ Formatted with prettier: src/components/Button.tsx\n✓ Formatted with black: scripts/deploy.py\n```\n\n**Desktop notifications:**\n\n```\n🔔 \"Claude needs input\" - when waiting for your response\n🔔 \"Task complete\" - when finished\n```\n\n---\n\n## Commands Reference\n\nAll commands use the format `/project-starter:\u003ccommand\u003e`.\n\n### Output Styles\n\n| Command                      | Mode                                          |\n| ---------------------------- | --------------------------------------------- |\n| `/project-starter:architect` | System design mode - architecture before code |\n| `/project-starter:rapid`     | Fast development - ship quickly, iterate      |\n| `/project-starter:mentor`    | Teaching mode - explain the \"why\"             |\n| `/project-starter:review`    | Code review mode - strict quality             |\n\n### Git Workflow (Inner-Loop)\n\n| Command                              | Purpose                                   |\n| ------------------------------------ | ----------------------------------------- |\n| `/project-starter:commit`            | Auto-generate conventional commit message |\n| `/project-starter:commit-push-pr`    | Commit → Push → Create PR (full workflow) |\n| `/project-starter:quick-fix`         | Fast fix for lint/type errors             |\n| `/project-starter:add-tests`         | Generate tests for recent changes         |\n| `/project-starter:lint-fix`          | Auto-fix all linting issues               |\n| `/project-starter:sync-branch`       | Sync with main (rebase or merge)          |\n| `/project-starter:summarize-changes` | Generate standup/PR summaries             |\n\n### Verification\n\n| Command                            | Purpose                                 |\n| ---------------------------------- | --------------------------------------- |\n| `/project-starter:verify-changes`  | Multi-subagent adversarial verification |\n| `/project-starter:validate-build`  | Build process validation                |\n| `/project-starter:run-tests`       | Tiered test execution                   |\n| `/project-starter:lint-check`      | Code quality checks                     |\n| `/project-starter:security-scan`   | Security vulnerability detection        |\n| `/project-starter:code-simplifier` | Post-implementation cleanup             |\n\n---\n\n## Agents\n\nAgents are specialized subagents that Claude spawns automatically based on your task.\n\n| Agent              | Purpose                          | Auto-Triggers                               |\n| ------------------ | -------------------------------- | ------------------------------------------- |\n| `orchestrator`     | Coordinate multi-step tasks      | \"improve\", \"refactor\", multi-module changes |\n| `code-reviewer`    | Review code quality              | After code changes, before commits          |\n| `debugger`         | Systematic bug investigation     | Errors, test failures, crashes              |\n| `docs-writer`      | Technical documentation          | README, API docs, guides                    |\n| `security-auditor` | Security vulnerability detection | Auth, user input, sensitive data            |\n| `refactorer`       | Code structure improvements      | Technical debt, cleanup                     |\n| `test-architect`   | Design test strategies           | Adding/improving tests                      |\n\n---\n\n## Skills\n\nSkills are knowledge domains that Claude uses autonomously when relevant.\n\n| Skill                    | Domain                                      |\n| ------------------------ | ------------------------------------------- |\n| `analyzing-projects`     | Understand codebase structure and patterns  |\n| `designing-tests`        | Unit, integration, E2E test approaches      |\n| `designing-architecture` | Clean Architecture, Hexagonal, etc.         |\n| `optimizing-performance` | Speed up applications, identify bottlenecks |\n| `managing-git`           | Version control, conventional commits       |\n| `designing-apis`         | REST/GraphQL patterns and best practices    |\n\n---\n\n## Hooks\n\nHooks run automatically on specific events.\n\n| Hook                  | Trigger       | Action                                 |\n| --------------------- | ------------- | -------------------------------------- |\n| Security scan         | Edit/Write    | Blocks commits with potential secrets  |\n| File protection       | Edit/Write    | Blocks edits to lock files, .env, .git |\n| Auto-format           | Edit/Write    | Runs prettier/black/gofmt by file type |\n| Command logging       | Bash          | Logs to `.claude/command-history.log`  |\n| Environment check     | Session start | Validates Node.js, Python, Git         |\n| Prompt analysis       | User prompt   | Suggests appropriate agents            |\n| Auto-verify           | Task complete | Runs tests/lint, reports results       |\n| Input notification    | Input needed  | Desktop notification                   |\n| Complete notification | Task complete | Desktop notification                   |\n\n---\n\n## Examples\n\nFor detailed multi-agent orchestration examples, see the [examples/](./examples/) directory:\n\n| Example | Description |\n| ------- | ----------- |\n| [Comprehensive Code Review](./examples/orchestration/comprehensive-code-review/) | 6-agent sequential workflow for thorough code analysis |\n\nEach example includes:\n- **README.md** - Overview and quick start\n- **workflow.md** - Exact prompts to use\n- **verification.md** - How to verify it works\n- **sample-outputs/** - Example agent outputs\n\n---\n\n## Configuration\n\n### Add Permissions to Your Project\n\nCopy the permissions template to your project:\n\n```bash\nmkdir -p /path/to/your/project/.claude\ncp templates/settings.local.json.template /path/to/your/project/.claude/settings.local.json\n```\n\nThis pre-allows common safe commands so you don't get prompted every time.\n\n### Add Team Conventions\n\nCopy the CLAUDE.md template to your project root:\n\n```bash\ncp templates/CLAUDE.md.template /path/to/your/project/CLAUDE.md\n```\n\nThen customize with your:\n\n- Package manager commands\n- Test/build/lint commands\n- Code conventions\n- Architecture decisions\n\n### MCP Servers\n\nCopy the MCP template to enable integrations like Slack, GitHub, Sentry:\n\n```bash\ncp templates/mcp.json.template /path/to/your/project/.mcp.json\n```\n\nThen configure the environment variables for the servers you want to use.\n\n### GitHub Action (@.claude in PRs)\n\nEnable Claude to respond to PR comments by installing the GitHub Action:\n\n```bash\n# In your repository\nclaude /install-github-action\n```\n\nThis enables:\n\n- Tag `@claude` in PR comments to get code suggestions\n- Auto-update `CLAUDE.md` during code review\n- Claude responds to review feedback automatically\n\n**Example PR comment:**\n\n```\n@claude please add input validation to the email field\n```\n\n**Team workflow tip:** Use `@claude` to update your `CLAUDE.md` with learnings from code review:\n\n```\n@claude add a note to CLAUDE.md that we should always validate email format before API calls\n```\n\n---\n\n## Extending the Plugin\n\n### Add Custom Commands\n\nCreate `.md` files in `commands/`:\n\n```markdown\n---\nallowed-tools: Bash(git:*), Read, Write\ndescription: What this command does\nargument-hint: [optional arguments]\n---\n\n[Command instructions here]\n```\n\n### Add Custom Agents\n\nCreate `.md` files in `agents/`:\n\n```markdown\n---\nname: my-agent\ndescription: What it does. Use PROACTIVELY when [triggers].\ntools: Read, Write, Edit, Bash\nmodel: sonnet\n---\n\n[Agent instructions here]\n```\n\n### Add Custom Skills\n\nCreate subdirectories in `skills/` with a `SKILL.md` file:\n\n```markdown\n---\nname: my-skill\ndescription: Guides [domain]. Use when [triggers].\n---\n\n[Skill knowledge and patterns here]\n```\n\n---\n\n## Plugin Structure\n\n```\nclaude-workflow/\n├── .claude-plugin/\n│   ├── plugin.json           # Required: Plugin manifest\n│   └── marketplace.json      # Optional: Marketplace metadata\n├── agents/                   # 7 specialized agents\n│   ├── orchestrator.md\n│   ├── code-reviewer.md\n│   ├── debugger.md\n│   ├── docs-writer.md\n│   ├── security-auditor.md\n│   ├── refactorer.md\n│   └── test-architect.md\n├── commands/                 # 17 slash commands\n│   ├── architect.md          # Output styles\n│   ├── rapid.md\n│   ├── mentor.md\n│   ├── review.md\n│   ├── commit.md             # Git workflow\n│   ├── commit-push-pr.md\n│   ├── quick-fix.md\n│   ├── add-tests.md\n│   ├── lint-fix.md\n│   ├── sync-branch.md\n│   ├── summarize-changes.md\n│   ├── verify-changes.md     # Verification\n│   ├── validate-build.md\n│   ├── run-tests.md\n│   ├── lint-check.md\n│   ├── security-scan.md\n│   └── code-simplifier.md\n├── skills/                   # 6 knowledge domains\n│   ├── analyzing-projects/\n│   ├── designing-tests/\n│   ├── designing-architecture/\n│   ├── designing-apis/\n│   ├── managing-git/\n│   └── optimizing-performance/\n├── hooks/\n│   ├── hooks.json            # Hook configuration\n│   └── scripts/              # 9 automation scripts\n├── templates/                # User-copyable templates\n│   ├── CLAUDE.md.template\n│   ├── settings.json.template\n│   ├── settings.local.json.template\n│   └── mcp.json.template\n├── CLAUDE.md                 # Plugin development guidelines\n└── README.md\n```\n\n---\n\n## Requirements\n\n- **Claude Code** v1.0.33 or later\n- **Python 3** (for hook scripts)\n- **Node.js** (optional, for npm commands)\n- **Git** (for version control features)\n\n---\n\n## Contributing\n\nContributions welcome! See [CONTRIBUTING.md](./CONTRIBUTING.md).\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'feat: add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n---\n\n## Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=CloudAI-X/claude-workflow-v2\u0026type=date\u0026legend=top-left)](https://www.star-history.com/#CloudAI-X/claude-workflow-v2\u0026type=date\u0026legend=top-left)\n\n## Credits\n\n- Plugin created by [@cloudxdev](https://x.com/cloudxdev)\n- Workflow patterns inspired by [Boris Cherny](https://x.com/bcherny) (creator of Claude Code)\n\n## License\n\nMIT - see [LICENSE](./LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCloudAI-X%2Fclaude-workflow-v2","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FCloudAI-X%2Fclaude-workflow-v2","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCloudAI-X%2Fclaude-workflow-v2/lists"}