AI Dev Kit
Production-ready AI dev workflow scaffold with 59 skills, 33 agents, hooks, and rules.
What Is This?
AI Dev Kit is a complete plugin-oriented developer workspace for AI coding assistants. It ships everything needed to run professional-grade engineering workflows โ TDD, code review, security audit, CI/CD, ML pipelines, infrastructure-as-code, code quality analysis, and debt tracking โ across Claude Code, Codex, OpenCode, and Gemini CLI.
Think of it as a system prompt that scales to 59 specialized skills and 33 domain agents, with lifecycle hooks and automated validation.
Quick Start
Claude Code
/plugin marketplace add noah-sheldon/ai-dev-kit
/plugin install ai-dev-kit@ai-dev-kit
Or install directly via HTTPS:
/plugin marketplace add https://github.com/noah-sheldon/ai-dev-kit
/plugin install ai-dev-kit@ai-dev-kit
Codex
codex extensions add https://github.com/noah-sheldon/ai-dev-kit
Or clone and discover automatically:
git clone https://github.com/noah-sheldon/ai-dev-kit
The marketplace at .agents/plugins/marketplace.json will be discovered automatically.
OpenCode
cd .opencode/plugins && npm install && npm run build
Or install via HTTPS:
npx opencode plugin install https://github.com/noah-sheldon/ai-dev-kit
Gemini CLI
gemini extensions link https://github.com/noah-sheldon/ai-dev-kit
Or install via HTTPS directly:
gemini extensions install https://github.com/noah-sheldon/ai-dev-kit
GitHub Copilot CLI
copilot plugin marketplace add https://github.com/noah-sheldon/ai-dev-kit
copilot plugin install ai-dev-kit@ai-dev-kit
Or install via HTTPS shorthand:
copilot plugin install https://github.com/noah-sheldon/ai-dev-kit
Qwen Code
qwen extensions install https://github.com/noah-sheldon/ai-dev-kit
Or install locally:
qwen extensions install /path/to/ai-dev-kit
Manual Install (any harness)
./install.sh
What's Inside
ai-dev-kit/
โโโ agents/ 33 specialized agents (planner, architect, code-reviewer, debt analyzers, ...)
โโโ skills/ 59 skill playbooks (TDD, security, ML, infra, web, data, ...)
โโโ commands/ 41 workflow commands and shims
โโโ hooks/ lifecycle automation (pre-tool, post-tool, session events)
โโโ rules/ language-specific guidance (common, python, typescript, web)
โโโ manifests/ install manifests for deterministic setup
โโโ schemas/ JSON schemas for validation
โโโ docs/ architecture, design decisions, troubleshooting
โโโ examples/ reusable templates
โโโ scripts/ install, validate, sync, and template helpers
โโโ tests/ smoke tests and surface validation
โโโ .claude-plugin/ Claude Code plugin manifest + marketplace
โโโ .codex-plugin/ Codex plugin manifest
โโโ .agents/ Codex marketplace catalog
โโโ .gemini/ Gemini CLI extension
โโโ .opencode/ OpenCode project config + TypeScript plugin
Agents (33)
Skills (59)
Core Engineering
agentic-engineering api-design api-integrations backend-patterns frontend-patterns frontend-design hexagonal-architecture coding-standards codebase-onboarding
Testing & Quality
tdd-workflow code-review security-review security-scan e2e-testing python-testing eval-harness verification-loop
AI / ML
claude-api openai-api langchain-llamaindex mlops-workflow mlops-rag pytorch-patterns deep-research exa-search search-first iterative-retrieval autonomous-agent-harness autonomous-loops continuous-agent-loop context-prune token-budget-advisor prompt-optimizer mcp-server-patterns
Data
data-pipelines data-pipelines-ai database-migrations postgres-patterns document-processing
Infrastructure
aws-devops aws-deployment docker-patterns deployment-patterns ci-pipeline github-ops observability-telemetry multi-agent-git-workflow
Workflow & Operations
architecture-decision-records dmux-workflows documentation-lookup git-workflow skill-authoring backlog-management workflow-status
Code Quality & Analysis
codebase-report technical-debt-report
Specialized
wxt-chrome-extension
Commands (41)
Build & quality: build-fix code-review doctor eval ml-review quality-gate review review-pr test-coverage validate verify
Workflow: checkpoint feature-dev plan project-template promote resume-session save-session sessions skill-create skill-health
Git & multi-agent: git-agent multi-agent-status
DevEx: context-budget context-prune install uninstall update-codemaps update-docs
Hook automation: hookify hookify-configure hookify-list hookify-help
Loop & continuous: loop-start loop-status
ML: e2e launch
Learning: learn learn-eval
Cross-Platform Support
Core Principles
- Agent-first โ delegate domain work to the right specialist.
- Test-driven โ write tests before implementation when behavior changes.
- Security-first โ validate inputs, avoid unsafe defaults, never hardcode secrets.
- Plan-before-execute โ break complex work into phases with the planner.
- Model fallback โ if a requested model is unavailable, use the default and continue.
Workflow
Request โ Planner โ Architect โ Domain Agents โ AI-Judge โ Implementation โ Code Review โ Security Review โ Merge
- Plan complex work with the
planneragent before touching code. - Write tests first โ use
tdd-guidefor RED/GREEN/REFACTOR discipline. - Implement with domain specialists (python-reviewer, ml-engineer, etc.).
- Validate with
ai-judgeโ rubric covers completeness, correctness, security, feasibility, testability. - Review with
code-reviewerandsecurity-reviewerbefore merge. - Ship with
git-agent-coordinatorfor clean branch management.
MCP Servers (Optional)
MCP servers are not bundled with this kit to avoid corporate network/proxy issues. Add your own MCP servers as needed:
Configure MCP servers in your own .mcp.json at the project root.
Requirements
- Claude Code v2.1+ (hooks auto-load by convention)
- Node.js 24+ LTS (for scripts and validation)
- Git (for agent coordination and version control)
FAQ
Q: How do I adapt this for my project?
Start from docs/examples/project-guidelines-template.md and customize the skills you need.
Q: What if a model is unavailable?
Every agent has a fallback_model setting. If the specified model is down, it falls back to the workspace default.
Q: How do I validate everything is correct?
npm test # smoke tests
node scripts/validate-surface.js # production surface check
Q: Can I install only certain skills? Yes โ the kit supports selective install. Each skill is self-contained. Copy only what you need.
Q: How do I contribute?
See CONTRIBUTING.md. Run npm test before submitting.
Docs
Security
- Never hardcode secrets โ use environment variables or secret managers.
- Validate all external input at boundaries.
- Prefer least privilege and explicit allowlists.
- Review any change touching auth, secrets, or shell execution with
security-reviewer.
See SECURITY.md for the full policy.
License
MIT โ see LICENSE.
Author
Noah Sheldon โ noahsheldon.dev