# openDevTeam
**Repository Path**: jayEntp/open-dev-team
## Basic Information
- **Project Name**: openDevTeam
- **Description**: Zero-dependency Claude Code plugin: 6 specialized AI agents for full-stack development teams
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://opendevteam.han391904.workers.dev/
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-02-21
- **Last Updated**: 2026-02-25
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README

# openDevTeam
**Your AI Dev Team. In the Terminal.**
Zero-dependency CLI that installs 6 specialized AI agents into [Claude Code](https://claude.ai/download) or [OpenCode](https://opencode.ai).
[](LICENSE)
[](https://nodejs.org/)
[](#)
[Homepage](https://opendevteam.han391904.workers.dev/) · [Quick Start](#quick-start) · [Agents](#agents) · [Workflow](#workflow-examples) · [Docs (CN)](USAGE.md)
---
## Why
You're using Claude Code or OpenCode. You want specialized agents — a product manager, backend dev, frontend dev, QA, DevOps, tech lead — without the bloat. One command, zero dependencies, 6 agents ready to go.
## Quick Start
### Install from source (recommended)
```bash
git clone https://github.com/jayEntp/openDevTeam.git
cd openDevTeam
npm link
```
`npm link` registers both the `odt` (Claude Code) and `odt-oc` (OpenCode) commands globally.
### For Claude Code
```bash
odt init
```
> Or run directly: `node bin/odt.js init`
### For OpenCode
```bash
odt-oc init
```
> Or run directly: `node bin/odt-oc.js init`
> **Unlink when no longer needed:** `npm unlink -g open-dev-team`
### Use in Your AI Coding Tool
After installation, open your tool in the project and start using agents:
```bash
/pm "Define requirements for user authentication"
/be "Implement JWT auth API with refresh tokens"
/fe "Create login form with validation"
/qa "Test the full authentication flow"
/ops "Set up CI/CD pipeline"
/tl "Review the architecture"
```
## Agents
| Command | Agent | What it does |
|:-------:|-------|-------------|
| `/pm` | **Product Manager** | Requirements analysis, PRDs, user stories, roadmaps |
| `/fe` | **Frontend Dev** | React/Vue/Angular, TypeScript, responsive UI, accessibility |
| `/be` | **Backend Dev** | REST/GraphQL APIs, databases, auth, microservices |
| `/qa` | **QA Engineer** | Test strategies, automation, E2E, defect reporting |
| `/ops` | **DevOps Engineer** | CI/CD, cloud infra, containers, monitoring, deployment |
| `/tl` | **Tech Lead** | Architecture decisions, code review, tech selection |
## CLI Commands
### Claude Code (`odt`)
| Command | Description |
|---------|-------------|
| `odt init` | Interactive install wizard |
| `odt install --local` | Install to current project (`./.claude/`) |
| `odt install --global` | Install to all projects (`~/.claude/`) |
| `odt uninstall` | Remove installed files (manifest-based, safe) |
| `odt status` | Show installation status and agent health |
| `odt doctor` | Diagnose environment (Node, Claude Code, permissions) |
| `odt list` | List all 6 agents |
| `odt help` | Show help |
| `odt version` | Print version |
### OpenCode (`odt-oc`)
| Command | Description |
|---------|-------------|
| `odt-oc init` | Interactive install wizard |
| `odt-oc install --local` | Install to current project (`./.opencode/`) |
| `odt-oc install --global` | Install to all projects (`~/.opencode/`) |
| `odt-oc uninstall` | Remove installed files (manifest-based, safe) |
| `odt-oc status` | Show installation status and agent health |
| `odt-oc doctor` | Diagnose environment (Node, OpenCode, permissions) |
| `odt-oc list` | List all 6 agents |
| `odt-oc help` | Show help |
| `odt-oc version` | Print version |
## How It Works
### Claude Code
```bash
odt install --local # generates files into .claude/
```
```
.claude/
├── agents/ ← 6 curated agent prompt files
│ ├── product-manager.md
│ ├── frontend-dev.md
│ ├── backend-dev.md
│ ├── qa-engineer.md
│ ├── devops-engineer.md
│ └── tech-leader.md
├── commands/ ← 6 shortcut files (auto-generated)
│ ├── pm.md
│ ├── fe.md
│ ├── be.md
│ ├── qa.md
│ ├── ops.md
│ └── tl.md
└── CLAUDE.md ← project context for Claude
```
### OpenCode
```bash
odt-oc install --local # generates files into .opencode/
```
```
.opencode/
├── agents/ ← 6 curated agent prompt files
│ ├── product-manager.md
│ ├── frontend-dev.md
│ ├── backend-dev.md
│ ├── qa-engineer.md
│ ├── devops-engineer.md
│ └── tech-leader.md
└── commands/ ← 6 shortcut files (auto-generated)
├── pm.md
├── fe.md
├── be.md
├── qa.md
├── ops.md
└── tl.md
AGENTS.md ← project context (in project root)
```
### Key Design Decisions
- **Single source of truth** — command files are generated at install time from the agent registry, not stored as static templates
- **Manifest-based uninstall** — `.odt-manifest.json` (Claude Code) / `.odt-oc-manifest.json` (OpenCode) tracks every installed file. Uninstall removes only what it put there. Your custom agents are never touched.
- **Zero dependencies** — pure Node.js built-in modules only
- **Parallel support** — Claude Code and OpenCode can coexist in the same project without conflict
## Workflow Examples
### Full Development Cycle
```bash
/pm "Define login feature requirements with acceptance criteria"
/tl "Design auth architecture — JWT vs session, token refresh strategy"
/be "Implement login/register API with JWT + refresh tokens"
/fe "Create login page with form validation and error handling"
/qa "Write test plan covering happy path, edge cases, and security"
/ops "Configure GitHub Actions CI/CD with staging and production"
```
### Cross-Review
```bash
/be "Review the frontend auth implementation for security issues"
/fe "Review the API response format — is it frontend-friendly?"
/tl "Review overall auth architecture for scalability"
```
### Iterative Enhancement
```bash
/be "Implement basic email/password login"
/be "Add rate limiting and brute-force protection"
/be "Add OAuth2 support for Google and GitHub"
```
## Customization
### For Claude Code
Create agents in `.claude/agents/` and commands in `.claude/commands/`:
```markdown
---
name: my-agent
description: My custom agent
model: inherit
permissions:
- read
- write
- edit
- bash
---
# My Agent
You are a [role]. Your responsibilities: [description].
## Workflow
1. Analyze
2. Design
3. Implement
4. Verify
```
Command shortcut (`.claude/commands/my.md`):
```markdown
---
name: my
description: My custom command
---
You are now operating as the **My Agent** agent.
Load and follow the full agent prompt from `.claude/agents/my-agent.md`.
Execute the user's task: $ARGUMENTS
```
### For OpenCode
Create agents in `.opencode/agents/` and commands in `.opencode/commands/`:
```markdown
---
name: my-agent
description: My custom agent
mode: primary
tools:
read: true
write: true
edit: true
bash: true
---
# My Agent
You are a [role]. Your responsibilities: [description].
## Workflow
1. Analyze
2. Design
3. Implement
4. Verify
```
Command shortcut (`.opencode/commands/my.md`):
```markdown
---
description: My custom command
agent: my-agent
---
Execute the user's task: $ARGUMENTS
```
Now use it in either tool: `/my "do something"`
Custom files are safe — uninstall only removes manifest-tracked files.
## Requirements
- **Node.js** >= 18
- **Claude Code** ([download](https://claude.ai/download)) and/or **OpenCode** ([download](https://opencode.ai))
Run `odt doctor` or `odt-oc doctor` to verify your environment.
## Documentation
- **[Homepage](https://opendevteam.han391904.workers.dev/)** — Project homepage & live demo
- **[USAGE.md](USAGE.md)** — Detailed usage guide with examples (Chinese)
## Contributing
1. Fork the repo
2. Create your branch (`git checkout -b feature/my-feature`)
3. Commit changes (`git commit -m 'Add my feature'`)
4. Push (`git push origin feature/my-feature`)
5. Open a Pull Request
## License
[MIT](LICENSE) © 2026 [jayEntp](https://github.com/jayEntp)