{"id":48779004,"url":"https://github.com/ovargas/virtual-team","last_synced_at":"2026-04-17T07:01:18.081Z","repository":{"id":338493954,"uuid":"1156808266","full_name":"ovargas/virtual-team","owner":"ovargas","description":null,"archived":false,"fork":false,"pushed_at":"2026-04-11T17:39:12.000Z","size":915,"stargazers_count":6,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-13T13:42:25.074Z","etag":null,"topics":["agents","ai","claude","command","skill","team","virtual-team"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/ovargas.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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":"AGENTS.md","dco":null,"cla":null},"funding":{"github":["ovargas"]}},"created_at":"2026-02-13T04:28:31.000Z","updated_at":"2026-04-12T14:21:51.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ovargas/virtual-team","commit_stats":null,"previous_names":["ovargas/claude","ovargas/virtual-team"],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/ovargas/virtual-team","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ovargas%2Fvirtual-team","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ovargas%2Fvirtual-team/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ovargas%2Fvirtual-team/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ovargas%2Fvirtual-team/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ovargas","download_url":"https://codeload.github.com/ovargas/virtual-team/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ovargas%2Fvirtual-team/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31918838,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-16T18:22:33.417Z","status":"online","status_checked_at":"2026-04-17T02:00:06.879Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["agents","ai","claude","command","skill","team","virtual-team"],"created_at":"2026-04-13T13:33:00.964Z","updated_at":"2026-04-17T07:01:18.075Z","avatar_url":"https://github.com/ovargas.png","language":"TypeScript","funding_links":["https://github.com/sponsors/ovargas"],"categories":[],"sub_categories":[],"readme":"# Claude Code Virtual Team\n\nA Claude Code plugin that turns Claude Code into a virtual development team. It provides a deliberate pipeline from idea to shipped code — with agents, commands, and skills that enforce TDD, contract-first development, and quality gates at every step.\n\n## Getting Started\n\n### 1. Install the plugin\n\nIn a Claude Code session, run:\n\n```\n/plugin marketplace add ovargas/virtual-team\n/plugin install virtual-team@virtual-team-marketplace\n```\n\n### 2. Initialize your project\n\nStart a Claude Code session and run:\n\n```\n/virtual-team:start\n```\n\nThis walks you through an interactive interview to define your tech stack, project structure, and conventions. It creates `stack.md` (the source of truth for your project) and sets up the `docs/` directory structure.\n\nAnything you haven't decided yet gets marked as TBD — the architect agent will catch it later when a feature actually needs it.\n\n\u003e **Working on multiple repositories?** You can create a hub repo to coordinate across services — shared decisions, epics, and API contracts in one place. Run `/virtual-team:start --hub` in a new repo to set it up. See the [command reference](docs/command-reference.md#multi-repo-setup) for details.\n\n### 3. Start building\n\nYou only need **5 commands** for daily work:\n\n| Command | What it does |\n|---------|-------------|\n| `/virtual-team:status` | Start your day — shows what's in progress, what's next |\n| `/virtual-team:flow \u003cdescription\u003e` | Build a feature end-to-end (spec → plan → code → review → PR) |\n| `/virtual-team:flow --fix \u003cdescription\u003e` | Fix a bug end-to-end (report → investigate → fix → review → PR) |\n| `/virtual-team:commit` | Create a clean, atomic commit |\n| `/virtual-team:handoff` | End a session — captures state for the next one |\n\nThat's it. Everything else is optional.\n\n## Daily Workflow\n\n### Start your day\n\n```\n/virtual-team:status\n```\n\nShows what's in progress, what's blocked, and suggests the right command to run next.\n\n### Build a feature\n\n```\n/virtual-team:flow Add password reset via email\n```\n\nThis runs the full pipeline in one session:\n\n```\n/feature → /contracts → /plan → /implement → /review + /validate → /pr\n```\n\nInteractive gates between each step resolve decisions and TBDs without leaving the session. If the session is interrupted, just run `/virtual-team:flow` again — it auto-detects where you left off.\n\n### Fix a bug\n\n```\n/virtual-team:flow --fix \"users can't log in after password reset\"\n```\n\nRuns the bug fix pipeline with a mandatory pattern sweep to catch all occurrences:\n\n```\n/bug → /debug → fix → /review + /validate → /pr\n```\n\n### Common variations\n\n```bash\n/virtual-team:flow --deep Add search capability        # agent-powered analysis (thorough)\n/virtual-team:flow --auto Add simple utility           # minimal gates, stops only on failures\n/virtual-team:flow --to=plan Add notifications         # stop after planning\n/virtual-team:flow --from=implement                     # resume from implementation\n/virtual-team:flow --fix BUG-003                       # bug already documented, start at debug\n/virtual-team:flow --fix --quick \"typo in header\"      # skip bug report, go straight to debug\n```\n\n---\n\n## Want More Control?\n\n`/flow` chains the pipeline automatically. You can run each step individually when you want to pause, review, or iterate between steps.\n\n### The Pipeline Steps\n\nThese are the commands that `/flow` runs under the hood. Use them directly when you want granular control:\n\n```\n/feature → /contracts → /plan → /implement → /review + /validate → /pr\n```\n\n| Step | Command | What it produces |\n|------|---------|-----------------|\n| **Spec** | `/virtual-team:feature Add password reset` | Feature spec with acceptance criteria + backlog stories |\n| **Contracts** | `/virtual-team:contracts extract docs/features/...` | API schemas in `contracts/` — locks down payload shapes before code |\n| **Plan** | `/virtual-team:plan FEAT-001` | Phased implementation plan with file references and patterns |\n| **Build** | `/virtual-team:implement FEAT-001` | Working code — picks up stories, executes plan, runs TDD |\n| **Review** | `/virtual-team:review` | Code review (quality + security + domain) against the diff |\n| **Validate** | `/virtual-team:validate FEAT-001` | Gap analysis — compares spec requirements vs actual implementation |\n| **Ship** | `/virtual-team:pr` | PR with summary, testing notes, and backlog updates |\n\n#### Example: manual step-by-step\n\n```bash\n/virtual-team:feature Add password reset via email     # spec + stories\n/virtual-team:contracts extract docs/features/...      # lock down API shapes\n/virtual-team:plan FEAT-001                            # technical plan\n/virtual-team:implement FEAT-001                       # write code (TDD enforced)\n/virtual-team:review                                   # code review\n/virtual-team:validate FEAT-001                        # spec coverage check\n/virtual-team:commit                                   # atomic commit\n/virtual-team:pr                                       # create PR\n```\n\n### Pipeline Flags\n\nThese flags work with both `/flow` and the individual pipeline commands:\n\n| Flag | Effect | Available in |\n|------|--------|-------------|\n| `--deep` | Spawn specialized agents for thorough analysis | `/feature`, `/plan`, `/implement`, `/debug`, `/flow` |\n| `--auto` | Skip confirmations, stop only on failures | `/feature`, `/plan`, `/implement`, `/flow` |\n| `--sdd` | Subagent-driven development — parallel implementation | `/implement` |\n| `--fresh` | Delete checkpoint, start from scratch | `/feature`, `/plan`, `/implement`, `/debug`, `/flow` |\n| `--phase=N` | Resume from a specific phase | `/implement` |\n\n---\n\n## Support Commands\n\nThese commands complement the pipeline. They're grouped by when you'd reach for them.\n\n### Discovery and Research\n\nUse these **before** the pipeline — when you're still exploring what to build.\n\n| Command | What it does |\n|---------|-------------|\n| `/virtual-team:idea Build a task management app` | Structured interview to capture a product concept. Spawns product-owner agent for market/risk analysis with `--deep`. |\n| `/virtual-team:research WebSocket libraries for Go` | Deep-dive research (market, technical, or codebase). Produces a sourced research document. |\n| `/virtual-team:proposal FEAT-001` | Business proposal with scope, timeline, and cost estimates. |\n| `/virtual-team:epic Add multilingual support` | Cross-team initiative for multi-repo products. Defines shared agreements and routes work across repos. Requires a [hub repo](docs/command-reference.md#multi-repo-setup). |\n\n### Bug Investigation\n\nUse these to investigate bugs independently of `/flow --fix`.\n\n| Command | What it does |\n|---------|-------------|\n| `/virtual-team:bug Users can't reset password` | Document a bug report with reproduction steps and severity. |\n| `/virtual-team:debug BUG-003` | Investigate: reproduce → trace → root cause → **mandatory pattern sweep** across the entire codebase. |\n\n### Quality and Review\n\nUse these **after** implementation — to verify and improve.\n\n| Command | What it does |\n|---------|-------------|\n| `/virtual-team:review` | Code review of staged/recent changes (quality + security + domain). |\n| `/virtual-team:validate FEAT-001` | Compare spec vs implementation — finds gaps, deviations, scope creep. |\n| `/virtual-team:tech-review` | Architecture health check — debt, patterns, dependencies, risks. |\n| `/virtual-team:check` | Quiz yourself on technical decisions in the current work. |\n| `/virtual-team:decisions testing` | Quick lookup: \"what did we decide about X?\" with source references. |\n\n### Git and Delivery\n\n| Command | What it does |\n|---------|-------------|\n| `/virtual-team:commit` | Clean, atomic commit following project conventions. |\n| `/virtual-team:pr` | Create PR with summary, testing notes, and backlog updates. Supports `--draft`, `--rebase`, `--base=develop`. |\n| `/virtual-team:worktree` | Create, remove, or clean up git worktrees. |\n\n### Session and Project Management\n\n| Command | What it does |\n|---------|-------------|\n| `/virtual-team:status` | Morning standup — project state, backlog health, what to work on next. |\n| `/virtual-team:handoff` | End a session cleanly — captures exact state for the next session. |\n| `/virtual-team:refine docs/features/...` | Iterate on an existing spec, plan, or document with new context. |\n| `/virtual-team:docs` | Generate project documentation — setup guides, config references, runbooks. |\n\n### Maintenance\n\n| Command | What it does |\n|---------|-------------|\n| `/virtual-team:start` | Initialize or re-initialize project structure and `stack.md`. |\n| `/virtual-team:update-workflow` | Pull latest commands, skills, and agents from the template repo. |\n\n---\n\n## How It Works\n\n### Skills (coding standards)\n\nSkills are domain-specific coding standards that load automatically based on what you're working on:\n\n- **Behavioral skills** (always active): TDD enforcement, verification-before-completion, code review reception\n- **Domain skills** (loaded by context): API design, UI design, data layer, service layer\n- **Stack skills** (you create these): Project-specific patterns matched via `stack.md`\n\n### Agents (specialized sub-agents)\n\n8 read-only agents that analyze and recommend — they never write code:\n\n| Agent | Role | Spawned by |\n|-------|------|-----------|\n| `product-owner` | Market analysis, YAGNI checks | `/idea`, `/feature`, `/epic` |\n| `software-architect` | Architecture decisions, dependency gatekeeper | `/plan`, `/epic` |\n| `security-reviewer` | Security vulnerability scanning | `/review` |\n| `pattern-finder` | Find existing code patterns as templates | `/plan`, `/implement` |\n| `codebase-analyzer` | Trace data flow and system behavior | `/debug`, `/plan` |\n| `codebase-locator` | Find relevant files by area/concern | `/feature`, `/plan` |\n| `docs-locator` | Find docs, plans, decisions by topic | `/feature`, `/plan` |\n| `web-researcher` | External research with source attribution | `/research`, `/idea` |\n\nAgents are spawned with the `--deep` flag. Without it, commands use direct tools (faster, cheaper).\n\n### Hooks (automatic enforcement)\n\nTwo hooks run automatically — no setup needed:\n\n- **SessionStart**: Loads skill-awareness so behavioral skills activate based on context\n- **PreToolUse** (on Edit/Write): Checks TDD discipline and verification discipline before code changes\n\n---\n\n## Further Reading\n\n- **[Command Reference](docs/command-reference.md)** — Full flag reference, story groups, knowledge checks, backlog lifecycle, multi-repo setup, skill customization, and design principles\n- **[Workflow Review](docs/workflow-review-report.md)** — Independent assessment of the plugin's strengths, friction points, and token efficiency\n\n## File Structure\n\n```\ncommands/       — 26 workflow commands (slash commands)\nskills/         — 15 coding standards (domain, behavioral, backlog)\nagents/         — 8 specialized sub-agents (read-only)\nhooks/          — Automatic enforcement (SessionStart, PreToolUse)\nexamples/       — CLAUDE.md templates for hub and service repos\ntests/          — Structural validation (frontmatter, references)\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fovargas%2Fvirtual-team","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fovargas%2Fvirtual-team","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fovargas%2Fvirtual-team/lists"}