v1.8.0

Full Changelog: v1.7.0...v1.8.0

v1.7.0: Workflow Resilience, Adaptive Memory & Adoption

Added

• Pluggable quality gate hooks — NewEngine now wires GateRunner so extra_gates in config actually execute. Added quality_gates.custom config schema (name, command, on_step) for project-defined gate scripts. (#115, PR #194)
• Secrets scanning quality gate — Built-in secrets_scan gate tries gitleaks, detect-secrets, and trufflehog in order; enforced at Coder→Tester and Security Auditor handoffs. New teamwork scan command for on-demand scanning. (#46, PR #194)
• Workflow timeline visualization — teamwork timeline <workflow-id> renders ASCII table (step, role, status, duration, handoff) with ANSI colors. --mermaid flag emits a Mermaid Gantt diagram. (#116, PR #194)
• Workflow checkpointing and resume — Checkpoint state saved to .teamwork/state/.checkpoint-<id>.yaml on step advance; cleared on successful completion. New teamwork resume <workflow-id> command surfaces saved context; --clear deletes checkpoint. (#39, PR #194)
• Role-specific handoff templates — teamwork next shows the template path for the current step transition. teamwork handoff init <workflow-id> writes a pre-structured Markdown template with role-appropriate sections (e.g., Coder→Tester includes "Files Changed", "How to Test", "Edge Cases"). (#118, PR #195)
• Full-text search — teamwork search <query> searches memory entries, handoff artifacts, ADRs, and state files. --domain and --type filters narrow results. Returns ranked results with snippets. (#41, PR #195)
• Structured feedback loop — Reviewer handoffs containing "changes requested" auto-append entries to .teamwork/memory/feedback.yaml. teamwork feedback list [--domain] [--status] and teamwork feedback resolve <id> manage the loop. teamwork next surfaces open feedback to Coder steps. (#44, PR #195)
• Workflow analytics — teamwork analytics summary [--since] [--type] [--format json] aggregates all state files: total/completed/failed/active counts, per-type avg duration, quality gate pass rate, and escalation rate. (#61, PR #195)
• Agent performance scorecards — teamwork metrics agents [--since] [--format json] shows per-role pass rate, rework count, and avg step duration. (#119, PR #195)
• Context distillation — teamwork context <workflow-id> [--step N] assembles a focused Markdown context package: role file, previous handoff, relevant memory entries, relevant ADRs, workflow status, and open feedback. Logs token estimate to metrics. (#62, PR #195)
• Configuration drift detection — teamwork update --check dry-runs an update, comparing local SHA-256 hashes against the upstream manifest and reporting modified, added, and deleted files without writing anything. Exits 1 if drift detected. (#124, PR #196)
• Exportable workflow reports — teamwork report <workflow-id> --format md|html|json generates a comprehensive report: timeline, step durations, handoff summaries, gate results, and cost estimate. (#123, PR #196)
• Example projects — examples/minimal/ (complete feature workflow) and examples/bugfix/ (off-by-one bug with bugfix workflow), each with pre-populated .teamwork/ state, handoffs, and a walkthrough README. (#55, PR #196)
• CLI and docs updated — docs/cli.md, docs/quick-reference.md, and docs/state-machines.md updated to cover all new commands and checkpointing behavior. (PR #196)

Fixed

• Installer missing framework files — .github/workflows/ and mcp-servers/ were silently excluded from teamwork init / teamwork update because they were absent from FrameworkFiles. The CI template (teamwork-ci.yaml.example) and all 5 Python MCP servers are now correctly installed. (PR #197)

v1.6.0: Project Type Awareness

What's New in v1.6.0

This release makes Teamwork meaningfully useful for projects that aren't standard software applications, and closes longstanding documentation gaps in how agents coordinate with each other.

Highlights

Project type detection in setup-teamwork
The setup skill now runs a Step 0 that detects your project type before analyzing the tech stack. It identifies software, database, infrastructure (IaC), and documentation-only projects from file indicators, presents the detected type for confirmation, and recommends a tailored agent set. No more installing an api-agent on a Terraform repo.

Multi-agent PR review sequence documented
docs/protocols.md now has an explicit PR Review Sequence section: Tester → Security Auditor → Reviewer, in that fixed order. Defines what each role does and does not do within the sequence, and how conflicts between roles are resolved.

Agent escalation matrix
docs/protocols.md now has a complete Escalation Matrix covering all roles — defining who escalates to whom before involving the human, the protocol for raising an escalation, and what escalation is not.

Role-specific Project Knowledge sections
All 8 core agent files now have role-appropriate Project Knowledge placeholders instead of the identical generic copy-paste. Each role now lists only the fields that are relevant to how it works.

Security Auditor broadened beyond web apps
The Security Auditor's checklist is now organized by project type with conditional categories: HTTP endpoints (XSS, CSRF, SSRF, etc.), database layer (SQL injection in stored procs, RBAC, encryption), infrastructure code (IAM/RBAC, firewall rules, public storage, secrets in IaC), and CLI (argument injection, privilege escalation, insecure temp files).

Conditional test/CI requirements in workflow skills
All 5 workflow skills (feature, bugfix, hotfix, release, refactor) now distinguish between projects that have test infrastructure and those that don't. Where "tests must pass" was previously a hard gate, it now reads: if test infrastructure exists, run it; if not, document manual verification steps. The bugfix regression test requirement is now a strong preference rather than an absolute mandate.

Issues Closed

• #126 — setup-teamwork skill should detect non-software projects
• #127 — Reviewer, Tester, and Security Auditor overlap on PR review is undocumented
• #128 — Cross-agent escalation paths default to ask the human — should specify agent routing
• #132 — Agent project knowledge sections are identical across all roles
• #134 — Security Auditor agent is web-app focused — lacks database and infrastructure security
• #135 — Workflow skills assume CI/CD, test suites, and build systems universally
• #137 — api-agent installed unconditionally — even for projects with no API (shipped in v1.5.0 / PR #192, tracked in this milestone)

Full Changelog

v1.4.0...v1.6.0

v1.4.0

Changed

• Merged install into init — teamwork init now fetches framework files (agents, skills, docs, instructions) from upstream AND creates the .teamwork/ config directory in a single command. Previously, users needed to run both teamwork install and teamwork init separately. The install command is now a deprecated alias that delegates to init.

Upgrade Guide

If you were using teamwork install, simply replace it with teamwork init. The install command still works but prints a deprecation warning.

New user flow:

1. gh extension install JoshLuedeman/gh-teamwork
2. gh teamwork init

That's it — agents, skills, docs, and config are all set up in one step.

v1.3.1

Full Changelog: v1.3.0...v1.3.1

v1.3.0

What's Changed

• fix: use lowercase Go module path by @JoshLuedeman in #125

Full Changelog: v1.2.0...v1.3.0

v1.2.0

What's Changed

• feat: add agent auto-dispatch guidance to copilot-instructions by @JoshLuedeman in #107
• feat(roles): add Product Owner and QA Lead optional roles by @JoshLuedeman in #108
• feat(cli): add teamwork role create command by @JoshLuedeman in #109
• feat(ci): add GitHub Actions CI template and --ci flag by @JoshLuedeman in #110
• feat(cli): add interactive setup wizard to teamwork init by @JoshLuedeman in #111
• feat(cli): add teamwork logs command by @JoshLuedeman in #112
• feat(cli): add --dry-run flag to teamwork start by @JoshLuedeman in #113

Full Changelog: v1.1.0...v1.2.0

v1.1.0 — Phase 4: MCP Integration

What's New

MCP Server Integration

• MCP server configuration system in .teamwork/config.yaml with 8 pre-configured servers
• teamwork mcp list and teamwork mcp config CLI commands
• MCP Tools sections in all 15 agent files
• MCP validation in teamwork validate
• Comprehensive setup guide at docs/mcp.md

5 Custom Python MCP Servers

Built-in MCP servers in mcp-servers/, each with pyproject.toml, Dockerfile, and tests:

• teamwork-mcp-coverage — Test coverage report analysis (lcov, Istanbul, Go cover.out)
• teamwork-mcp-commits — Conventional commit message generation and validation
• teamwork-mcp-adr — Architecture Decision Record management
• teamwork-mcp-changelog — Changelog generation using git-cliff
• teamwork-mcp-complexity — Code complexity analysis using lizard (30+ languages)

Release Infrastructure

• make release VERSION=vX.Y.Z automated release target
• teamwork --version flag with embedded version via ldflags
• docs/releasing.md release process documentation
• Release awareness in copilot-instructions.md, orchestrator, and documenter agents

Other

• Auto-create GitHub issue assigned to Copilot after teamwork update when CUSTOMIZE placeholders remain

Full Changelog: v1.0.0...v1.1.0

v1.0.0 — Phase 3: GitHub App + Cloudflare Worker Auto-Install

Teamwork v1.0.0

The first stable release of Teamwork — an agent-native development template for teams where AI agents are first-class contributors.

Highlights

Phase 3: Automatic Framework Installation

• GitHub App + Cloudflare Worker — automatically pushes Teamwork framework files to every new repository
• HMAC-SHA256 webhook verification, JWT authentication, atomic Git Data API commits
• .teamwork-skip opt-out and fork detection
• See docs/github-app-setup.md for setup

CLI Enhancements (Phase 2.5)

• teamwork memory, metrics, repos commands
• teamwork cancel, fail, doctor commands
• Multi-repo hub-spoke coordination
• Defect escape rate and cost tracking

Copilot-Native Structure

• 15 Custom Agents at .github/agents/*.agent.md
• 10 Skills at .github/skills/*/SKILL.md
• Path-specific instructions at .github/instructions/

Security Fixes

• Zip-slip vulnerability in tarball extraction (CWE-22)
• Path traversal via workflow IDs (CWE-22)
• File size limits and HTTP timeouts (CWE-400)

Pre-compiled Binaries

File	Platform
teamwork-linux-amd64	Linux x86_64
teamwork-linux-arm64	Linux ARM64
teamwork-darwin-amd64	macOS Intel
teamwork-darwin-arm64	macOS Apple Silicon

Installation

# Via go install
go install github.com/JoshLuedeman/teamwork/cmd/teamwork@v1.0.0

# Via gh extension
gh extension install JoshLuedeman/gh-teamwork
gh teamwork init

# Via binary download (example: macOS Apple Silicon)
curl -sL https://github.com/JoshLuedeman/teamwork/releases/download/v1.0.0/teamwork-darwin-arm64 -o teamwork
chmod +x teamwork

See CHANGELOG.md for the full list of changes.