スレッド進捗可視化 — システム構成図

Slackスレッドごとの要求・タスク・フェーズをM層が常時表示する仕組み　／　Issue #493

人 / 外部
Bot 基盤
M層
W層
GitHub
★ 今回実装
1. コンポーネント
外部 / ユーザー
CEO
Yuki Uchiyama
Slack
UI / Socket Mode
Mac mini（常駐プロセス）
bot.py
常駐 Bolt アプリ。Slack イベント受信・M層へ配送
IF層
ルーティング分類
M層（11エージェント）
chief / platform / consulting 等
常駐 Claude セッション
W層（社内）
researcher / architect
coder / reviewer 等
github_claude
ベンダー（Web Claude）
GitHub Actions 経由
bot/thread_progress.py
get_or_create_progress_issue(thread_ts) — Issue 特定・作成
read_progress(issue_number) — Issue body をパース
update_progress(issue_number, updates) — フェーズ状態を更新
format_progress_block(progress) — Slack 表示文字列を生成
GitHub（外部）
MNML-LLC/issues
スレッド進捗 Issue
（状態ストア）
GitHub Actions
claude-code-action
ベンダー実行基盤
2. データフロー
#FROMTO内容
1CEO→Slack スレッド内にメッセージ送信
2Slack→bot.py Socket Mode でイベント受信（thread_ts・テキストを含む）
3bot.py→M層 IF層でルーティング → 担当M層の常駐セッションへ投入
4M層→ thread_progress.py ★ get_or_create_progress_issue(thread_ts)
thread_tsに紐づくIssueを検索。なければ MNML-LLC/issues に作成
5thread_progress.py⇄ GitHub Issues ★ gh CLI で Issue body を読み書き（read_progress / update_progress）
6thread_progress.py→ M層 ★ format_progress_block() → 未完了タスク・フェーズのみを Slack mrkdwn で整形して返す
7M層→ Slack ★ 進捗ブロック（先頭）＋ 本文を返信
8M層→W層 / github_claude フェーズごとに DELEGATE（担当者を記録）
9github_claude→GitHub Actions Issue を読んで実装 → PR 作成（claude-code-action）
10M層（フェーズ完了時）→ thread_progress.py ★ update_progress(issue_number, {task_id, phase, status, assignee})
Issue body の該当フェーズを「完了」に更新
3. GitHub Issue body 構造（MNML-LLC/issues）


## 要求
.md等の設定ファイルをあるべき形にしたい

## タスク



### A-1: polymarket → trading リネーム [chief]
- [x] 要件定義 (chief)
- [x] 設計 (chief)
- [ ] 実装 (github_claude)  ← 実施中
- [ ] テスト
- [ ] 移行
- [ ] 後処理
4. Slack 表示イメージ（毎返信の先頭に付与）
要求: .md等の設定ファイルをあるべき形にしたい A-1: polymarket → trading リネーム [chief] └── 実装 github_claude 実施中 A-2: .mdファイル全部見直し [chief] └── 設計 architect 実施中
参謀です。A-1の実装はgithub_claudeに委譲中です。PR確認後レポートします。
5. 今回実装するもの（Issue #493）
ファイル種別内容
bot/thread_progress.py ★新規 thread_ts ↔ Issue 紐づけ・読み書き・Slack 整形の全ユーティリティ
tests/test_thread_progress.py ★新規 ユニットテスト（パース・更新・フォーマット）
agents/managers/CLAUDE.md 更新 「返信前に進捗ブロックを先頭付与する」ルール追記（全M層共通）

MNML スレッド進捗可視化 v1.0 / 2026-06