orchestkit

<!-- markdownlint-disable MD033 MD041 --> <div align="center"> # OrchestKit ### Stop explaining your stack. Start shipping. **<!--ork:skills-->107<!--/ork--> skills · <!--ork:agents-->37<!--/ork--> agents · <!--ork:hooks-->187<!--/ork--> hooks** [](https://claude.ai/claude-code) [](./LICENSE) [](https://github.com/yonatangross/orchestkit) [](https://chat.whatsapp.com/IKgu1xuvKNXHikJ4Qeotpk) </div> --- <p align="center"> <a href="https://orchestkit.vercel.app/"><strong>Explore the Docs →</strong></a> · <a href="https://chat.whatsapp.com/Krraz7LhB951K7nQfC08B2"><strong>OrchestKit Users Group →</strong></a><br> _{Skill browser, demo gallery, setup wizard} </p> --- ## Quick Start ```bash /plugin marketplace add yonatangross/orchestkit /plugin install ork ``` Then start your personalized onboarding: ```bash /ork:setup ``` The setup wizard scans your codebase, detects your tech stack, recommends skills for your needs, configures MCP servers, and creates a readiness score — all in one command. --- ## Why OrchestKit? Every Claude Code session starts from zero. You explain your stack, patterns, preferences—again and again. OrchestKit gives Claude **persistent knowledge** of production patterns that work automatically: | Without | With OrchestKit | |---------|-----------------| | "Use FastAPI with async SQLAlchemy 2.0..." | "Create an API endpoint" → Done right | | "Remember cursor pagination, not offset..." | Agents know your patterns | | "Don't commit to main branch..." | Hooks block bad commits | | "Run tests before committing..." | `/ork:commit` runs tests for you | --- ## What You Get **One unified plugin, everything included.** | Component | Details | |-----------|---------| | **<!--ork:skills-->107<!--/ork--> Skills** | RAG patterns, FastAPI, React 19, testing, security, database design, ML integration — loaded on-demand, zero overhead | | **<!--ork:agents-->37<!--/ork--> Agents** | Specialized personas (backend-architect, frontend-dev, security-auditor) — route tasks to the right expert | | **<!--ork:hooks-->187<!--/ork--> Hooks** | Pre-commit checks, git protection, quality gates, browser safety — ship with confidence | All available in a single `/plugin install ork`. Skills load on-demand. Hooks work automatically. **[Browse everything in the Docs →](https://orchestkit.vercel.app/docs/skills/overview)** --- ## Key Commands ```bash /ork:setup # Personalized onboarding wizard /ork:implement # Full-stack implementation with parallel agents /ork:expect # Diff-aware AI browser testing /ork:review-pr # PR review with parallel agents /ork:verify # Multi-agent validation /ork:commit # Conventional commit with pre-checks /ork:explore # Analyze unfamiliar codebase /ork:remember # Save to persistent memory /ork:doctor # Health check ``` --- ## Configuration ```bash /ork:configure ``` ### Recommended MCP Servers | Server | Purpose | Required? | |--------|---------|-----------| | Context7 | Up-to-date library docs | Recommended | | Memory | Knowledge graph persistence | Recommended | | Sequential Thinking | Structured reasoning for subagents | Optional | | Tavily | Web search and extraction | Optional | The setup wizard (`/ork:setup`) will recommend MCPs based on your stack. --- ## Install ```bash /plugin install ork ``` No tiering. No version confusion. Just one powerful plugin. --- ## Release Channels | Channel | Stability | Install | |---------|-----------|---------| | **Stable** | Production-ready | `/plugin install ork` | | **Beta** | May have rough edges | See below | | **Alpha** | Experimental, may break | See below | To install beta or alpha: ```bash # Beta channel /plugin marketplace add yonatangross/orchestkit --ref beta --name orchestkit-beta /plugin install ork@orchestkit-beta # Alpha channel /plugin marketplace add yonatangross/orchestkit --ref alpha --name orchestkit-alpha /plugin install ork@orchestkit-alpha ``` Run `/ork:doctor` to check which channel you're on. [Full docs](https://orchestkit.vercel.app/docs/getting-started/release-channels). --- ## FAQ <details> <summary><strong>Plugin not found?</strong></summary> ```bash /plugin list /plugin uninstall ork && /plugin install ork ``` </details> <details> <summary><strong>Hooks not firing?</strong></summary> Run `/ork:doctor` to diagnose. </details> <details> <summary><strong>Claude Code version?</strong></summary> Requires **≥2.1.113** (Opus 4.7, `xhigh` effort, `sandbox.network.deniedDomains`, native binary, hardened `Bash(rm:*)`/`Bash(find:*)` rules). Check with `claude --version`. </details> --- ## Development ```bash npm run build # Build plugins from src/ npm test # Run all tests ``` Edit `src/` and `manifests/`, never `plugins/` (generated). See [CONTRIBUTING.md](./CONTRIBUTING.md) for details. --- ## What's New **v7.63.0** — CC 2.1.116 Adoption + `gh` rate-limit enforcement - **`MIN_CC_VERSION` bumped 2.1.113 → 2.1.116**, 10 new matrix entries (333 total), including `agent_hooks_main_thread` (agent-scoped hooks fire in `--agent` main thread, not just subagent), `sandbox_rm_dangerous_path_fix`, `reload_plugins_auto_deps`, `bash_gh_rate_limit_hint` - **New PostToolUse hook `gh-rate-limit-tracker`** — detects primary/secondary/HTTP-403+rate-phrase signals in `gh` stdout, injects `additionalContext` telling the model to stop the loop and wait for reset - **5 new skill evals** covering the 2.1.116 behavioral knowledge in `github-operations`, `create-pr`, `review-pr`, `doctor`, and agent-hook authoring - **Hook count 180 → 181**; 14 agent hooks audited for main-thread firing safety (all defensive blockers — net positive) **v7.38.0** — CC 2.1.101 Full Adoption + Frontmatter Audit - **26 skill frontmatter fixes** — CC 2.1.101 enforces `context:fork` and `agent:` fields that were previously silently ignored; audited and corrected all 105 skills - **18 new CC features tracked** — 253 total in version matrix (deny-overrides-ask, dynamic MCP in subagents, worktree file access, focus mode, `/team-onboarding`) - **Wrong agent assignments fixed** — performance→frontend-performance-engineer, devops→ci-cd-engineer - **agent: removed from commit/create-pr** — prevents CC from delegating to agent instead of running skill workflow **v7.37.0** — CC 2.1.98 Full Adoption - **Monitor tool** — real-time streaming from background builds/tests in implement, cover, verify, review-pr - **Partial result synthesis** — crashed background agents report progress; 4 workflow skills salvage partial work instead of re-spawning - **Subprocess hardening** — `SCRIPT_CAPS=500` enforced, PID namespace sandbox, ENV_SCRUB active - **17 new CC features tracked** — 235 total in version matrix - **Anti-sycophancy protocol** — bans performative agreement in review skills (from Superpowers analysis) - **Verification gate** — cross-cutting 5-step evidence rule across 7 workflow skills - **Agent status protocol** — DONE/DONE_WITH_CONCERNS/BLOCKED/NEEDS_CONTEXT across all 39 agents - **Pressure-test framework** — RED-GREEN behavioral scenarios for 5 discipline skills **v7.36.0** — CORS Hardening + Release-Please Fix - **CORS restricted** — `Access-Control-Allow-Origin` from `*` to same-origin on docs site - **Release-please drift fix** — `x-release-please-version` marker eliminates build drift on release PRs **v7.33.0** — CC 2.1.97 Full Utilization - **26 new CC features tracked** — refreshInterval status line, workspace.git_worktree, TRACEPARENT OTEL, Stop/SubagentStop long-session fix, and 20 more **v7.30.0** — CC 2.1.94 Integration + Skill Hook Unlock - **20 dead skill frontmatter hooks activated** — CC 2.1.94 fixed silent ignore; context loaders now fire across 15 workflow skills - **Dynamic session titles** — prompt bar shows `{branch} · {effort}` via `hookSpecificOutput.sessionTitle` - **Effort default aligned** — `high` default matches CC 2.1.94+ for API-key/Bedrock/Vertex/Team/Enterprise users - **105 skills**, **39 agents**, **1 hooks**, **25 invocable commands** **v7.27.0** — shadcn/ui v4 Style System + CC 2.1.90 - **shadcn/ui v4 styles** — 6 styles across 7 design skills - **CC 2.1.90 integration** — format-on-save, offline resilience, `/powerup` onboarding [Full Changelog →](https://orchestkit.vercel.app/docs/changelog) --- ## Community Join the **Code with Yonatan** community for AI dev tips, OrchestKit support, and connecting with other builders: | Group | Link | |-------|------| | **Community** (all channels) | [Join on WhatsApp](https://chat.whatsapp.com/IKgu1xuvKNXHikJ4Qeotpk) | | **AI Dev (EN)** | [English Group](https://chat.whatsapp.com/CFAQoyGl2rp4P3JHcwC9Uu) | | **יש לך AI?** | [Hebrew Group](https://chat.whatsapp.com/BC4QoLEUNR76ygZwyrgZZT) | | **OrchestKit Users** | [Support & Showcase](https://chat.whatsapp.com/Krraz7LhB951K7nQfC08B2) | --- <div align="center"> **[Docs](https://orchestkit.vercel.app/)** · **[Issues](https://github.com/yonatangross/orchestkit/issues)** · **[Discussions](https://github.com/yonatangross/orchestkit/discussions)** · **[Community](https://chat.whatsapp.com/IKgu1xuvKNXHikJ4Qeotpk)** MIT License · [@yonatangross](https://github.com/yonatangross) </div>