convez.ai
AgenteAutomaçãoAvançado
ryokkon624

Scrum Agent Base

ryokkon624/scrum-agent-base

Times Scrum autônomos com Claude Agent Teams

Ver no GitHub
InicialPluginScore · de 0 a 100

Framework de times Scrum autônomos baseado em Claude Code Agent Teams, onde SM, DEV, PO e revisores colaboram para executar sprints completos. Orquestra planejamento, implementação, revisão de código e retrospectivas sem intervenção manual.

Instalação

$npx convez-ai ryokkon624/scrum-agent-base

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 3 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Automação de ciclos completos de sprint (planning, dev, review, retro)
  • Orchestração de múltiplos agentes Claude com papéis específicos (SM, DEV, revisores)
  • Rastreamento visual de tarefas em tempo real com Kanban integrado
  • Integração com Discord e GitHub Projects para feedback contínuo
  • Desenvolvimento autossuficiente com revisão automática de convenções, segurança e performance

Veredito

Solução ambiciosa e bem estruturada para automação de processos Scrum com Agent Teams, incluindo memória de contexto e integração Discord. Requer profundo entendimento de Claude Code Agent Teams e configuração complexa, mas oferece valor real para equipes buscando devops/sprint automation inteligente.

README

A tradução para o português deste README ainda está na fila.

scrum-agent-base

HwHubプロジェクトのAIスクラムチーム基盤。 Claude Code Agent Teamsを使ってSM・DEV・レビュアーが連携し、スクラムを自律的に回す。


全体構成

ユーザー(PO)
  ↓ Sprintバックログを起票・優先順位付け
SM(チームリード)
  ↓ Planning → DEV起動 → Reviewerを起動
DEV(teammate)
  ↓ 実装・コミット・SMに報告
Reviewer × 3(teammate・並列)
  ↓ 規約/セキュリティ/パフォーマンスをレビュー・SMに報告
SM
  ↓ 指摘があればDEV再起動(ラリー)
  ↓ 指摘なければSprintレビュー投稿・停止
ユーザー
  ↓ Discordで動作確認・指摘を記録
  ↓ Claude Codeを再起動してRetro指示
SM
  ↓ Retro・指摘をPBI化・Skills更新

ターミナルの起動方法

cd C:\work\claude\scrum-agent-base
claude

Sprintの開始方法

ターミナルから指示する場合

SMモードで動いて。
Sprint XXのPlanningを開始してください。

Discordから指示する場合(--channelsで起動中のターミナルが必要)

scrum-agentsサーバーの #10-planning の該当スレッドや #30-sprint-review などで:

@scrum-agent SMモードで動いて。
Sprint XXのレトロスペクティブを開始してください。

タスク進捗の可視化(claude-task-viewer)

claude-task-viewerを利用。

Agent Teamsが動いているとき、別ターミナルで以下を実行するとブラウザでKanbanが見える:

npx claude-task-viewer --open

http://localhost:3456 が自動で開く。 SMが作成したタスクの進捗(pending / in_progress / completed)がリアルタイムで更新される。

仕組み: Agent Teamsはタスクを ~/.claude/tasks/{team-name}/ 配下のJSONファイルに保存する。 claude-task-viewerはそのJSONを監視してUIに反映するだけ。サーバー不要・インストール不要で動く。


Sprint Reviewの流れ

SMが #30-sprint-review にReviewスレッドを投稿した時点でClaude Codeは停止する。

  1. Discordの #30-sprint-review を確認する
  2. 動作確認を行い、指摘があればスレッドにコメントする
  3. 指摘対応は次のSprintで実施(このSprintでは追加実装しない)
  4. Claude Codeを再起動してRetroを指示する:
SMモードで動いて。
Sprint XXのレトロスペクティブを開始してください。

ディレクトリ構成

scrum-agent-base/
├── CLAUDE.md                    # エージェントが起動時に読む設定ファイル
├── README.md                    # このファイル
├── .claude/
│   ├── settings.json            # Agent Teams有効化設定
│   ├── hooks/
│   │   └── pre-commit.sh        # コミット前フック
│   ├── rules/
│   │   ├── git.md               # Gitコミットメッセージのルール
│   │   └── database.md          # DB変更・マイグレーションのルール
│   ├── agents/
│   │   ├── product-owner.md         # POのsubagent定義
│   │   ├── scrum-master.md          # SMのsubagent定義
│   │   ├── developer.md             # DEVのsubagent定義
│   │   ├── convention-reviewer.md   # 規約レビュアーのsubagent定義
│   │   ├── security-reviewer.md     # セキュリティレビュアーのsubagent定義
│   │   └── performance-reviewer.md  # パフォーマンスレビュアーのsubagent定義
│   └── skills/                      # エージェントが参照するスキル定義
│       ├── scrum-master-workflow/   # SMの作業フロー
│       ├── developer-workflow/      # DEVの作業フロー
│       ├── product-owner-workflow/  # POの作業フロー
│       ├── backend-conventions/     # Backendコーディング規約
│       ├── frontend-conventions/    # Frontendコーディング規約
│       ├── mobile-conventions/      # Mobileコーディング規約
│       │   ├── SKILL.md
│       │   └── patterns/            # 個別バグ由来の詳細実装パターン(必要時のみ参照)
│       ├── discord-operations/      # Discordの操作方法
│       ├── github-issues/           # Github ProjectsのIssuesの操作方法
│       └── sprint-review-prep/      # Sprint Review用HTMLファイル生成
│           ├── SKILL.md
│           └── templates/
│               ├── feature-refactor.html  # feature/refactor用レビューテンプレート
│               └── bug.html               # bug用レビューテンプレート
├── memory/
│   ├── sm/
│   │   ├── short_term.md        # SMの今スプリントの記憶
│   │   └── long_term.md         # SMの過去スプリントの教訓
│   ├── dev/
│   │   ├── short_term.md        # DEVの今スプリントの記憶
│   │   └── long_term.md         # DEVの過去スプリントの教訓
│   └── po/
│       ├── short_term.md        # POの今スプリントの記憶
│       └── long_term.md         # POの過去スプリントの教訓
└── backlog/
    ├── product_backlog.md       # 未使用(Github ProjectsのIssueに移管済み)
    └── sprint_XX/
        └── sprint_backlog.md    # スプリントバックログ(SMがPlanning時に作成)

設定ファイル

Agent Teamsの有効化(~/.claude/settings.json)

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

注意: C:\work\claude\scrum-agent-base\.claude\settings.json ではなく、 ユーザーレベルの ~\.claude\settings.json に設定する。


Discordサーバー(scrum-agents)のチャンネル構成

チャンネルタイプ用途
#skills-changelogTextSkillsファイル更新履歴
#10-planningForumSprint Planning
#20-sprintForumSprint作業・コードレビュー
#30-sprint-reviewForumSprint Review・ユーザーへの確認依頼
#40-retrospectiveForumRetrospective

技術スタック

  • エージェント基盤: Claude Code + Agent Teams
  • エージェント間メッセージング: SendMessage(Agent Teams組み込み)
  • Discordとの連携(投稿): mcp-discord
  • Discordとの連携(受信): Claude Code Channels(--channelsフラグ)
  • Sprint backlog可視化: claude-task-viewer(npx claude-task-viewer)
Ver o original no GitHub

Bom para

Relacionados