dsh-team-superflow

A fixed five-member development team · driven by the spec-superflow state machine · live progress in the Web GUI

Spin up the same fixed dev team every time you use AgentTeams in DeepSeek Harness: a captain (the current session) plus five members, with the team's work flowing through spec-superflow's eight workflow states, visualized as a stepper in the activity panel.

Refactored from NanmiCoder/dsh-agent-teams, integrating the state-machine model of MageByte-Zero/spec-superflow.

Fixed roster

Every agent_teams_create registers the same five members (subagents spawn lazily on their first phase-eligible dispatch):

member	role	active phases
spec-writer	spec writer	exploring · specifying · bridging
architect	designer / architect	specifying · bridging
engineer	engineer	executing · debugging
reviewer	reviewer	executing · debugging
docs	release / docs	executing · closing

State machine

The team record persists the spec-superflow eight-state workflow:

exploring → specifying → bridging → approved-for-build → executing ⇄ debugging → closing
                                    │
                                    └─ build gate: captain confirms before executing
(any non-terminal state) ─────────→ abandoned (terminal)

• Auto-advance: when every task of the current phase completes, the team moves to the next phase (phaseAutoAdvance, default on).
• Build gate: at approved-for-build the captain must call agent_teams_advance_phase with phase=executing, confirm=true.
• Rewind: the captain may move back to specifying (scope change) or bridging (contract drift); a bug moves executing → debugging and returns automatically after fixes.
• Phase-tagged tasks: agent_teams_create_task tags each task with a phase (default: current); the scheduler only dispatches tasks matching the current phase and the member's role scope.

The activity panel adds a state-machine stepper (eight phase pills, overall percent, per-phase task counts, build-gate badge) refreshed from the durable host state.

Install

cd dsh-team-superflow
pnpm install && pnpm build
dsh plugin --profile web add .
dsh web

Usage

Natural language:

Use AgentTeams to add a dark mode to this repo, following spec → contract → implement → review.

Or the slash command:

/agent-teams refactor the auth boundary and produce the full execution contract and tests

Tools

The original ten agent_teams_* tools plus agent_teams_advance_phase:

agent_teams_create / add_member / remove_member / create_task / reassign_task /
agent_teams_claim_task / update_task / send_message / status / advance_phase / delete

Configuration

- id: agent-teams
  config:
    stateDir: .agent-teams
    memberProvider: spawn
    memberModel: deepseek-v4
    memberMaxDepth: 1
    maxMembers: 8
    fixedRoster: true          # false → original behavior (empty team)
    phaseAutoAdvance: true
    promptSectionOrder: 117
    slashCommand: true

Docs

• State machine and phase rules
• Usage guide

License

MIT