Skip to content

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

spec-kit-team-assign

A spec-kit community extension that assigns tasks from tasks.md to human engineers, splits complex tasks into subtasks, and generates a per-person workboard — all inside your spec-kit workflow.


Why this extension?

Spec-kit's built-in /speckit.tasks produces a great task list, but it doesn't know who on your team should do what. This extension fills that gap:

  • Define your team once in a simple team.yml file
  • Assign tasks automatically by role, round-robin, or get suggestions for manual assignment
  • Split complex tasks into concrete subtasks interactively
  • Generate a workboard grouped by engineer, ready to share in a standup or paste into Notion/Confluence

No Jira. No external tool. Just Markdown files inside your repo.


Installation

specify extension add team-assign

Or install directly from GitHub:

specify extension add --from https://github.com/tarunkumarbhati/spec-kit-team-assign/archive/refs/tags/v1.0.0.zip

Workflow

/speckit.tasks          ← (existing spec-kit command — generate tasks.md first)
        ↓
/speckit.team.setup     ← define your team members and roles
        ↓
/speckit.team.assign    ← assign tasks + split complex ones into subtasks
        ↓
/speckit.team.board     ← generate the per-engineer workboard

Commands

/speckit.team.setup

Guides you through creating .specify/team.yml with your team members, roles, and capacity.

Example team.yml output:

team:
  members:
    - name: "Alice"
      github: "alice"
      role: "backend"
      capacity: 5
    - name: "Bob"
      github: "bob"
      role: "frontend"
      capacity: 5
  sprint: "Sprint 1"
  strategy: "role-match"

Roles: backend, frontend, fullstack, devops, qa (or any custom role).

Strategies:

Strategy Behaviour
role-match Matches task domain to engineer role. Recommended.
round-robin Distributes tasks evenly regardless of role.
manual Leaves assignments empty with suggestions in comments.

/speckit.team.assign

Reads tasks.md and assigns each task to an engineer. For complex tasks, proposes a subtask split and asks for confirmation before applying.

Before:

- [ ] Build the authentication API
- [ ] Create the login page component

After:

## Team summary — Sprint 1

| Engineer | Role     | Assigned | Capacity | Status |
|----------|----------|----------|----------|--------|
| Alice    | backend  | 4 pts    | 5 pts    | ✅ OK  |
| Bob      | frontend | 3 pts    | 5 pts    | ✅ OK  |

- [ ] Build the authentication API [@alice] [3pts]
  - [ ] Define JWT token schema
  - [ ] Implement /auth/login endpoint
  - [ ] Write unit tests for auth middleware
- [ ] Create the login page component [@bob] [2pts]

/speckit.team.board

Generates .specify/specs/<feature>/team-board.md — a workboard view grouped by engineer.

# Team workboard — my-feature
> Sprint 1

## 👤 Alice (backend) — 4 / 5 pts

| Status | Task | Points |
|--------|------|--------|
| ⬜ Todo | Build the authentication API | 3 pts |
| ⬜ Todo | Set up database migrations | 1 pt |

## 👤 Bob (frontend) — 3 / 5 pts

| Status | Task | Points |
|--------|------|--------|
| ⬜ Todo | Create the login page component | 2 pts |
| ⬜ Todo | Add loading state to form | 1 pt |

Re-run at any time to refresh the board as tasks are checked off.


Files created by this extension

File Description
.specify/team.yml Team configuration (created once per project)
.specify/specs/<feature>/tasks.md Updated in-place with [@assignee] and [Npts] annotations
.specify/specs/<feature>/team-board.md Generated workboard (regenerated on each run)

Tips

  • Re-run /speckit.team.assign any time you add new tasks or change the team. It will ask whether to reassign from scratch or only fill unassigned tasks.
  • Re-run /speckit.team.board at the start of each standup — it picks up any tasks checked off since last time.
  • Override estimates by editing [Npts] in tasks.md directly after assignment.
  • Multiple features — the extension always asks which feature's tasks.md to use if there are multiple.

Contributing

Issues and pull requests are welcome. See CONTRIBUTING.md if you want to add new assignment strategies or output formats.


License

MIT — see LICENSE.

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors