spec-team

SpecTeam

Stage: prompt-first workflow (stable) · platform foundation (W1 in progress) — see Roadmap.

SpecTeam keeps specs, decisions, and AI agents aligned.

中文文档: README.zh-CN.md

Overview

SpecTeam is a Git-native workflow for AI-native spec review and decision alignment.

SpecTeam is the current market-facing wedge: AI-native spec review and decision alignment for product and engineering teams using multiple AI tools. It helps teams detect divergence across PRDs, architecture docs, and AI-generated proposals, make decisions quickly, and sync the outcome back into a shared source of truth.

SpecTeam now uses one consistent name across the repository, prompt skills, commands, and product story.

Product Docs

• Architecture
• Brand Strategy
• Product Requirements
• PMF Validation Loop
• Design Partner Playbook
• Design Partner Templates
• Messaging Kit
• Demo Script
• Go-to-Market
• Dependency-Ordered Roadmap
• Foundation Execution Plan

Installation

Claude Code — .claude/commands/ (recommended)

git clone https://github.com/surebeli/SpecTeam.git /tmp/spec-team

# Install to current project
mkdir -p .claude/commands
for skill in /tmp/spec-team/plugin/skills/*/SKILL.md; do
  cp "$skill" ".claude/commands/$(basename $(dirname $skill)).md"
done

# Or install globally (applies to all projects)
mkdir -p ~/.claude/commands
for skill in /tmp/spec-team/plugin/skills/*/SKILL.md; do
  cp "$skill" ~/.claude/commands/$(basename $(dirname $skill)).md
done

Claude Code — /plugin marketplace

/plugin marketplace add surebeli/SpecTeam
/plugin install spec-team@SpecTeam

Codex CLI

git clone https://github.com/surebeli/SpecTeam.git ~/.codex/skills/spec-team

Any AI tool — standalone prompt

Copy SPECTEAM.md to your project root, then tell your AI tool:

You are now the SpecTeam Workflow. Follow all rules in ./SPECTEAM.md strictly.
Skill: init

Quick Start

1-minute Demo (Local)

We provide a simulated scenario to let you experience SpecTeam's conflict detection and resolution in 1 minute.

# 1. Clone and install skills
git clone https://github.com/surebeli/SpecTeam.git
cd SpecTeam

# 2. Init and point to mock data
# When asked for document directories, enter: ./tests/mock-scenarios/demo-1-conflict/alice, ./tests/mock-scenarios/demo-1-conflict/bob
/spec-init

# 3. Detect conflicts between alice (REST) and bob (GraphQL)
/spec-review

# 4. Resolve a conflict (e.g., D-001)
/spec-align D-001

Core Workflow