{"id":37230356,"url":"https://github.com/kks0488/vibe-claude","last_synced_at":"2026-01-23T18:01:57.870Z","repository":{"id":331575634,"uuid":"1131493286","full_name":"kks0488/vibe-claude","owner":"kks0488","description":"🚀 Don't think. Just vibe. Self-evolving multi-agent system for Claude Code.","archived":false,"fork":false,"pushed_at":"2026-01-16T21:10:16.000Z","size":2710,"stargazers_count":13,"open_issues_count":1,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-18T11:15:35.126Z","etag":null,"topics":["ai-agents","anthropic","automation","claude","claude-ai","claude-code","cli","developer-tools","llm","multi-agent","prompt-engineering","vibe-coding","vibecoding"],"latest_commit_sha":null,"homepage":"http://aionda.blog","language":"Shell","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/kks0488.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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-01-10T05:43:56.000Z","updated_at":"2026-01-17T08:27:39.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/kks0488/vibe-claude","commit_stats":null,"previous_names":["kks0488/vibe-claude"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/kks0488/vibe-claude","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kks0488%2Fvibe-claude","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kks0488%2Fvibe-claude/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kks0488%2Fvibe-claude/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kks0488%2Fvibe-claude/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kks0488","download_url":"https://codeload.github.com/kks0488/vibe-claude/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kks0488%2Fvibe-claude/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28697424,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-23T17:25:48.045Z","status":"ssl_error","status_checked_at":"2026-01-23T17:25:47.153Z","response_time":59,"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-agents","anthropic","automation","claude","claude-ai","claude-code","cli","developer-tools","llm","multi-agent","prompt-engineering","vibe-coding","vibecoding"],"created_at":"2026-01-15T03:37:59.509Z","updated_at":"2026-01-23T18:01:57.835Z","avatar_url":"https://github.com/kks0488.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Vibe-Claude\n\n\u003e **Don't think. Just vibe. Claude does the rest.**\n\nA **self-evolving** multi-agent orchestration system for Claude Code.\nThe more you use it, the smarter it gets.\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-Code-blueviolet)](https://claude.ai)\n\n---\n\n## Key Feature: Self-Evolution\n\n**Vibe-Claude evolves itself.** When it encounters a task it can't handle well:\n\n```\nCapability gap detected\n        ↓\nCreate new agent prompt or skill\n        ↓\nSave to ~/.claude/agents/ or ~/.claude/skills/\n        ↓\nReference and use in future tasks\n```\n\n| Situation | What Happens |\n|-----------|--------------|\n| Repeated task pattern | Creates reusable prompt template |\n| Specialized knowledge needed | Creates expert agent prompt |\n| Better method discovered | Updates existing prompts |\n| External tool needed | Creates integration skill |\n\n### How Evolution Works\n\nNew agents are saved as prompt files. Claude reads and applies them when relevant:\n\n```\nUser: \"Test my API endpoints\"\n        ↓\nClaude checks ~/.claude/agents/\n        ↓\nFinds v-api-tester.md\n        ↓\nReads the prompt and becomes that specialist\n```\n\n**The system learns your project's patterns over time.**\n\n---\n\n## Who Is This For?\n\n- \"I don't know code\" → **You don't need to**\n- \"Just make it work\" → **It will**\n- \"I hate complexity\" → **One command**\n- \"Money isn't the issue\" → **We use Opus liberally**\n\n---\n\n## Quick Start\n\n```bash\n# Install\ngit clone https://github.com/kks0488/vibe-claude.git ~/.claude-vibe\ncp -r ~/.claude-vibe/* ~/.claude/\n\n# Use\n/vibe make me a login page\n```\n\nThat's it. Claude will:\n- Analyze what's needed\n- Plan the approach\n- Build it\n- Test it\n- Fix any issues\n- Repeat until perfect\n\n---\n\n## Usage Examples\n\n```\n/vibe create a blog with comments\n/vibe fix this authentication bug\n/vibe add dark mode to my app\n/vibe make this look professional\n/vibe refactor the entire API layer\n```\n\nJust describe what you want. In any language. However you want.\n\n---\n\n## Philosophy\n\n\u003e **\"Vibe coding: where you describe, AI delivers.\"**\n\n| Traditional Development | Vibe-Claude |\n|------------------------|-------------|\n| 1. Write requirements | 1. \"Make this\" |\n| 2. Design architecture | 2. Done |\n| 3. Write code | |\n| 4. Write tests | |\n| 5. Debug | |\n| 6. Repeat... | |\n\n### Why Does This Work?\n\n**We throw money at it.**\n\nVibe-Claude uses Opus 4.5 without hesitation:\n- Analysis? Opus\n- Planning? Opus\n- Review? Opus\n- Anything complex? Opus\n\nExpensive, but effective.\n\n---\n\n## Architecture\n\n```\n┌─────────────────────────────────────────────┐\n│              VIBE-CLAUDE                     │\n├─────────────────────────────────────────────┤\n│                                              │\n│  /vibe \"your request\"                        │\n│         ↓                                    │\n│  ┌─────────────────────────────────────┐    │\n│  │         V-CONDUCTOR                  │    │\n│  │    (Auto-routes to right agent)      │    │\n│  └─────────────────────────────────────┘    │\n│         ↓                                    │\n│  ┌─────────────────────────────────────┐    │\n│  │           AGENTS                     │    │\n│  │                                      │    │\n│  │  ┌──────────┐ ┌──────────┐          │    │\n│  │  │v-analyst │ │v-planner │ ← Opus   │    │\n│  │  │v-critic  │ │v-advisor │          │    │\n│  │  │v-conductor│            │          │    │\n│  │  └──────────┘ └──────────┘          │    │\n│  │                                      │    │\n│  │  ┌──────────┐ ┌──────────┐          │    │\n│  │  │v-worker  │ │v-designer│ ← Sonnet │    │\n│  │  │v-researcher│ │v-vision │          │    │\n│  │  └──────────┘ └──────────┘          │    │\n│  │                                      │    │\n│  │  ┌──────────┐ ┌──────────┐          │    │\n│  │  │v-finder  │ │v-writer  │ ← Haiku  │    │\n│  │  └──────────┘ └──────────┘          │    │\n│  └─────────────────────────────────────┘    │\n│         ↓                                    │\n│  ┌─────────────────────────────────────┐    │\n│  │           SKILLS                     │    │\n│  │  v-turbo  v-git  v-style  v-evolve  │    │\n│  └─────────────────────────────────────┘    │\n│         ↓                                    │\n│      RESULT                                  │\n│         ↓                                    │\n│  Not perfect? → Retry automatically          │\n│         ↓                                    │\n│      DONE                                    │\n└─────────────────────────────────────────────┘\n```\n\n---\n\n## Agents\n\n### Opus Tier (Heavy Lifting)\n\n| Agent | Purpose |\n|-------|---------|\n| `v-analyst` | Deep debugging, root cause analysis |\n| `v-planner` | Strategic planning, architecture design |\n| `v-critic` | Ruthless code review, quality gates |\n| `v-advisor` | Risk analysis, hidden requirements |\n| `v-conductor` | Orchestration, agent routing |\n\n### Sonnet Tier (Execution)\n\n| Agent | Purpose |\n|-------|---------|\n| `v-worker` | Code implementation |\n| `v-designer` | UI/UX, styling, components |\n| `v-researcher` | Documentation, codebase analysis |\n| `v-vision` | Screenshot/image analysis |\n\n### Haiku Tier (Speed)\n\n| Agent | Purpose |\n|-------|---------|\n| `v-finder` | Fast file/pattern search |\n| `v-writer` | Documentation writing |\n\n---\n\n## Skills\n\n| Skill | Purpose |\n|-------|---------|\n| `v-turbo` | Parallel execution, maximum speed |\n| `v-git` | Clean commits, git mastery |\n| `v-style` | Beautiful UI, design systems |\n| `v-evolve` | Self-improvement, creates new capabilities |\n| `v-continue` | Session restoration, resume work |\n\n---\n\n## How It Works\n\n### The 5-Phase System\n\nEvery task follows this proven structure:\n\n```\n┌─────────────────────────────────────────────────┐\n│              THE 5-PHASE SYSTEM                 │\n├─────────────────────────────────────────────────┤\n│                                                 │\n│  Phase 1: RECON (Parallel)                      │\n│  ├─ v-analyst: Analyze requirements             │\n│  ├─ v-finder: Find related code                 │\n│  ├─ v-researcher: Research best practices       │\n│  └─ v-advisor: Identify risks                   │\n│                                                 │\n│  Phase 2: PLANNING                              │\n│  └─ v-planner: Create comprehensive plan        │\n│                                                 │\n│  Phase 3: EXECUTION (Parallel)                  │\n│  ├─ v-worker: Implement features                │\n│  ├─ v-designer: Build UI components             │\n│  └─ v-writer: Write documentation               │\n│                                                 │\n│  Phase 4: VERIFICATION TRIBUNAL                 │\n│  ├─ v-critic: Quality review                    │\n│  ├─ v-analyst: Logic verification               │\n│  └─ Tests: Automated checks                     │\n│  ALL THREE MUST APPROVE                         │\n│                                                 │\n│  Phase 5: POLISH (Optional)                     │\n│  ├─ Refactor if needed                          │\n│  ├─ Add docs/comments                           │\n│  └─ Security/performance check                  │\n│  SKIP if not needed                             │\n│                                                 │\n└─────────────────────────────────────────────────┘\n```\n\n### Work Document Tracking\n\nEvery `/vibe` task creates a tracking document:\n```\n.vibe/work-{timestamp}.md\n```\n\nThis ensures **nothing is forgotten**. Each task is tracked with checkboxes and evidence.\n\n### Evidence-Based Completion\n\n**Nothing is \"done\" without proof:**\n- Code must actually RUN (output shown)\n- Tests must actually PASS (results pasted)\n- Every feature verified with `file:line` references\n\n**Forbidden phrases:**\n- \"Should work\" → Must TEST it\n- \"I think it's done\" → Must PROVE it\n- \"Looks correct\" → Must RUN it\n\n### Infinite Retry Engine\n\n```\nAttempt 1: Standard approach\nAttempt 2: Alternative method\nAttempt 3: Escalate to Opus\nAttempt 4: v-analyst deep dive\nAttempt 5: Create new agent\n...continues until success\n```\n\n### Session Management (NEW)\n\nNever lose progress when context runs out:\n\n```\n┌─────────────────────────────────────────────────┐\n│  Context Warning System                         │\n├─────────────────────────────────────────────────┤\n│  25% remaining → Soft warning                   │\n│  15% remaining → Show /v-continue command       │\n│  5% remaining  → Final warning                  │\n└─────────────────────────────────────────────────┘\n```\n\n**How it works:**\n- Work file (`.vibe/work-*.md`) is updated in real-time\n- No extra save needed = No wasted tokens\n- `/v-continue` reads the latest work file\n\n**Usage:**\n```\n# Previous session shows warning\n[CONTEXT WARNING: 15% REMAINING]\nTo continue: /v-continue\n\n# New session\nUser: /v-continue\n\n# Claude reads work file and continues\n[SESSION RESTORED]\nResuming from where we left off...\n```\n\nNo more losing work when sessions end!\n\n---\n\n### Self-Evolution (The Secret Sauce)\n\nThis is what makes Vibe-Claude different. When Claude encounters something it can't handle well:\n\n```\nDay 1: \"I need to optimize database queries\"\n       → Claude struggles a bit\n\nDay 2: Claude creates v-db-optimizer agent\n       → Saves to ~/.claude/agents/v-db-optimizer.md\n\nDay 3+: All DB tasks routed to specialized agent\n        → Fast, efficient, tailored to YOUR codebase\n```\n\n**Evolution is logged:**\n```\n~/.claude/evolution-log.md\n\n## [2024-01-15] Created v-db-optimizer\n\n### Reason\nRepeated database optimization requests with suboptimal results\n\n### Change\nCreated specialized agent with PostgreSQL expertise\n\n### Effect\nDB optimization tasks now 3x faster with better results\n```\n\nThe more you use Vibe-Claude, the more it adapts to YOUR specific needs.\n\n---\n\n## Commands\n\n| Command | Delegates To | Description |\n|---------|--------------|-------------|\n| `/vibe \u003ctask\u003e` | Multi-agent | Maximum power mode - parallel + escalation + infinite retry |\n| `/v-turbo \u003ctask\u003e` | Parallel agents | Maximum speed with concurrent execution |\n| `/v-plan \u003ctask\u003e` | v-planner | Strategic planning session |\n| `/v-review` | v-critic | Critical evaluation of code/plans |\n| `/v-analyze \u003ctarget\u003e` | v-analyst | Root cause analysis, debugging |\n| `/v-continue` | v-continue | Resume work from previous session |\n| `/v-update` | - | Check for and install vibe-claude updates |\n| `/v-cancel` | - | Stop current vibe session, save progress |\n\n---\n\n## File Structure\n\n```\n~/.claude/\n├── CLAUDE.md          # Main system prompt\n├── README.md          # This file\n├── agents/            # 11 specialized agents\n│   ├── v-analyst.md\n│   ├── v-worker.md\n│   ├── v-designer.md\n│   └── ...\n├── skills/            # 5 enhancement skills\n│   ├── v-turbo/\n│   ├── v-git/\n│   ├── v-style/\n│   ├── v-evolve/\n│   └── v-continue/\n└── commands/          # Slash commands\n    ├── vibe.md\n    └── ...\n```\n\n---\n\n## FAQ\n\n**Q: Do I need to know how to code?**\nA: No.\n\n**Q: What do I need to do?**\nA: Type `/vibe` and describe what you want.\n\n**Q: What if it doesn't work?**\nA: Claude retries automatically. Until it works.\n\n**Q: Is it expensive?**\nA: Yes. But it works.\n\n**Q: Can I customize the agents?**\nA: Yes. Edit the markdown files in `~/.claude/agents/`.\n\n---\n\n## The Vibe Coder Manifesto\n\n1. **Don't think, describe** - Say what you want, not how\n2. **Trust the process** - Let Claude figure it out\n3. **Money solves problems** - Opus is worth it\n4. **Perfection is automatic** - Retries until right\n5. **Evolution is constant** - System improves itself every day\n\n---\n\n## Contributing\n\nPull requests welcome. Keep it simple. Keep it vibe.\n\n---\n\n## Inspired By\n\nThis project draws inspiration from:\n\n- [opencode](https://github.com/anomalyco/opencode) - Open-source AI coding assistant\n- [Claude Code Documentation](https://docs.anthropic.com/en/docs/claude-code) - Official Anthropic documentation for Claude Code\n- [Claude Agent SDK](https://github.com/anthropics/anthropic-sdk-python) - Multi-agent patterns and best practices\n- The open-source AI coding community\n\n---\n\n## License\n\nMIT\n\n---\n\n## Author\n\nCreated with vibes by [@kks0488](https://github.com/kks0488)\n\n---\n\n**Don't think. Just vibe. Claude does the rest.**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkks0488%2Fvibe-claude","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkks0488%2Fvibe-claude","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkks0488%2Fvibe-claude/lists"}