{"id":47067058,"url":"https://github.com/opensesh/karimo","last_synced_at":"2026-04-26T17:01:26.578Z","repository":{"id":338712435,"uuid":"1158743495","full_name":"opensesh/KARIMO","owner":"opensesh","description":"Harness engineering framework for Claude Code — plan mode on steroids. Product design-driven agent orchestration with sub-agents and agent teams, tuned for developers and designers shipping real features. Phased adoption from PRD execution to automated review, code review, and CI-friendly agent teams","archived":false,"fork":false,"pushed_at":"2026-04-21T21:23:34.000Z","size":3373,"stargazers_count":34,"open_issues_count":0,"forks_count":6,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-21T22:16:13.791Z","etag":null,"topics":["agent-teams","ai-agents","autonomous-development","claude-code","code-review","github-actions","greptile","prd","sub-agents"],"latest_commit_sha":null,"homepage":"https://karimo-overview.vercel.app/","language":"Markdown","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/opensesh.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-15T21:07:33.000Z","updated_at":"2026-04-21T21:22:42.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/opensesh/KARIMO","commit_stats":null,"previous_names":["opensesh/karimo"],"tags_count":52,"template":false,"template_full_name":null,"purl":"pkg:github/opensesh/KARIMO","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opensesh%2FKARIMO","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opensesh%2FKARIMO/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opensesh%2FKARIMO/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opensesh%2FKARIMO/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/opensesh","download_url":"https://codeload.github.com/opensesh/KARIMO/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opensesh%2FKARIMO/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32305039,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T09:34:17.070Z","status":"ssl_error","status_checked_at":"2026-04-26T09:34:00.993Z","response_time":129,"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":["agent-teams","ai-agents","autonomous-development","claude-code","code-review","github-actions","greptile","prd","sub-agents"],"created_at":"2026-03-12T05:07:16.335Z","updated_at":"2026-04-26T17:01:26.570Z","avatar_url":"https://github.com/opensesh.png","language":"Markdown","funding_links":[],"categories":[],"sub_categories":[],"readme":"```\n██╗  ██╗   █████╗   ██████╗   ██╗  ███╗   ███╗   ██████╗\n██║ ██╔╝  ██╔══██╗  ██╔══██╗  ██║  ████╗ ████║  ██╔═══██╗\n█████╔╝   ███████║  ██████╔╝  ██║  ██╔████╔██║  ██║   ██║\n██╔═██╗   ██╔══██║  ██╔══██╗  ██║  ██║╚██╔╝██║  ██║   ██║\n██║  ██╗  ██║  ██║  ██║  ██║  ██║  ██║ ╚═╝ ██║  ╚██████╔╝\n╚═╝  ╚═╝  ╚═╝  ╚═╝  ╚═╝  ╚═╝  ╚═╝  ╚═╝     ╚═╝   ╚═════╝\n```\n\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n[![Version](https://img.shields.io/badge/version-v8.2.1-blue)]()\n[![Claude Code](https://img.shields.io/badge/Claude%20Code-Plugin-blueviolet.svg)]()\n\n**PRD-driven autonomous development for Claude Code.**\n\n\u003e You are the architect, agents are the builders.\n\n---\n\n## See It In Action\n\n\u003c!-- TODO: Embed demo video here --\u003e\n\nWant to see exactly how KARIMO works? Check out the [interactive demo](https://karimo-overview.vercel.app/) to understand why it was built and how it works in detail.\n\n---\n\n## How It Works\n\n```\n┌──────────┐   ┌──────┐   ┌───────┐   ┌────────┐   ┌─────────────┐   ┌─────────┐\n│ RESEARCH │──▸│ PLAN │──▸│ TASKS │──▸│ REVIEW │──▸│ ORCHESTRATE │──▸│ INSPECT │\n└──────────┘   └──────┘   └───────┘   └────────┘   └─────────────┘   └─────────┘\n      │            │           │              │                 │              │\n      └────────────┘           └──────────────┘                 └──────────────┘\n          Loop 1                    Loop 2                           Loop 3\n          Human                     Claude                        Configurable\n```\n\n| Step | What Happens |\n|------|--------------|\n| **Research** | Discover patterns, libraries, gaps |\n| **Plan** | Structured interview captures requirements |\n| **Tasks** | Generate task briefs from research + PRD |\n| **Review** | Claude validates briefs against codebase |\n| **Orchestrate** | Execute in waves (parallel tasks, sequential waves) |\n| **Inspect** | Review each PR (manual, Code Review, or Greptile) |\n\n---\n\n## Commands\n\n| Command | Purpose |\n|---------|---------|\n| `/karimo:research \"feature\"` | **Start here** — Create PRD folder + research |\n| `/karimo:plan --prd {slug}` | Interactive PRD creation |\n| `/karimo:run --prd {slug}` | Brief generation → review → execution |\n| `/karimo:merge --prd {slug}` | Final PR to main |\n| `/karimo:dashboard` | Monitor progress |\n| `/karimo:feedback` | Capture learnings |\n| `/karimo:doctor` | Diagnose issues |\n\nFull reference: [COMMANDS.md](.karimo/docs/COMMANDS.md)\n\n---\n\n## What KARIMO Adds\n\nKARIMO builds on Claude Code's native APIs with custom orchestration:\n\n| Capability | Claude Code (Native) | KARIMO (Custom) |\n|------------|---------------------|-----------------|\n| **Isolation** | Worktree per agent | + Branch identity verification |\n| **Execution** | Task spawning | + Wave-ordered parallelism |\n| **Models** | Static `model:` param | + Complexity routing + escalation |\n| **Recovery** | Worktree persistence | + Git state reconciliation |\n| **Quality** | — | + Semantic loop detection |\n\n**Why custom?** Claude Code provides foundations (worktrees, sub-agents, hooks) but doesn't coordinate task dependencies, detect stuck loops, or recover from crashes. KARIMO adds these as a coordination layer.\n\nDetails: [Feature Architecture](.karimo/docs/ARCHITECTURE.md#feature-architecture)\n\n---\n\n## Adoption Phases\n\n| Phase | What You Get |\n|-------|--------------|\n| **Phase 1** | PRD interviews, agent execution, worktrees, PRs — works out of the box |\n| **Phase 2** | Automated review via Greptile ($30/mo) or Claude Code Review |\n| **Phase 3** | CLI dashboard with velocity metrics |\n\nDetails: [PHASES.md](.karimo/docs/PHASES.md)\n\n---\n\n## Installation\n\n### Via Claude Code marketplace (recommended)\n\n```\n/plugin marketplace add opensesh/KARIMO\n/plugin install karimo@karimo\n/reload-plugins\n```\n\nOnce Anthropic accepts KARIMO into the official marketplace (in review), this becomes:\n\n```\n/plugin install karimo@claude-plugins-official\n```\n\n### Via install script (legacy)\n\n```bash\ngit clone https://github.com/opensesh/KARIMO\nbash KARIMO/.karimo/install.sh ./my-project\n```\n\nIf you previously used `.karimo/update.sh` to sync files into your project's `.claude/plugins/karimo/`, it continues to work but is no longer the recommended path. Plugin-managed installs benefit from Claude Code's built-in update, reload, and scope management.\n\n### Your First Feature\n\n```bash\n/karimo:research \"feature-name\"   # Creates PRD folder + runs research\n/karimo:plan --prd {slug}         # Interactive PRD creation (~10 min)\n/karimo:run --prd {slug}          # Execute tasks in waves\n/karimo:merge --prd {slug}        # Final PR to main\n```\n\n**Prerequisites:** [Claude Code](https://claude.ai/code), [GitHub CLI](https://cli.github.com/) (`gh auth login`), Git 2.5+\n\n---\n\n## Documentation\n\n| Document | Description |\n|----------|-------------|\n| [Getting Started](.karimo/docs/GETTING-STARTED.md) | Installation walkthrough |\n| [Commands](.karimo/docs/COMMANDS.md) | Full command reference |\n| [Architecture](.karimo/docs/ARCHITECTURE.md) | System design, agents, feature breakdown |\n| [Phases](.karimo/docs/PHASES.md) | Adoption phases explained |\n| [Safeguards](.karimo/docs/SAFEGUARDS.md) | Code integrity \u0026 security |\n| [Hooks](.karimo/hooks/README.md) | Lifecycle hooks (Slack, Jira, etc.) |\n| [Context Architecture](.karimo/docs/CONTEXT-ARCHITECTURE.md) | Token-efficient context layering |\n| [Compound Learning](.karimo/docs/COMPOUND-LEARNING.md) | How agents get smarter over time |\n\n---\n\n## FAQ\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eCan I run without automated review?\u003c/strong\u003e\u003c/summary\u003e\n\nYes. Review is optional (Phase 2). PRD interviews, execution, and PRs all work out of the box.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eDo I need to use a feature branch?\u003c/strong\u003e\u003c/summary\u003e\n\nNo. KARIMO supports two modes configured via `/karimo:configure`: feature branch mode (tasks branch from a feature branch) or main mode (tasks branch directly from main). Choose what fits your workflow.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eCan I run multiple sessions at once?\u003c/strong\u003e\u003c/summary\u003e\n\nYes, but be careful when running multiple feature branches with worktrees simultaneously. Typically when a feature branch and work trees are kicked off for a PRD, you only want to be doing research and planning on main. With Claude Opus 4.6, we've seen occasional conflicts. For best results, let one orchestration complete before starting another.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eDo I need to use Greptile?\u003c/strong\u003e\u003c/summary\u003e\n\nNo. You can use manual review, Claude Code Review, or any other review mechanism. Greptile is one option for automated review in Phase 2, but it's entirely optional.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eCan I use other tools for research?\u003c/strong\u003e\u003c/summary\u003e\n\nYes. We use Firecrawl MCP for deeper web research capability. You can integrate any MCP servers or tools that fit your workflow.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eCan I customize for my use case?\u003c/strong\u003e\u003c/summary\u003e\n\nYes. You can modify your local installation directly or fork the repository for more extensive customization. Agent definitions, templates, and skills are all editable.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eHaving issues?\u003c/strong\u003e\u003c/summary\u003e\n\nRun `/karimo:doctor` to diagnose. Still stuck? [hello@opensession.co](mailto:hello@opensession.co)\n\n\u003c/details\u003e\n\n---\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md)\n\n## License\n\n[Apache 2.0](LICENSE)\n\n---\n\n*Built with Claude Code by [Open Session](https://opensession.co)*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopensesh%2Fkarimo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopensesh%2Fkarimo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopensesh%2Fkarimo/lists"}