index

Wiki Index

kouchou-ai(広聴AI)開発者向けの設計判断・コード構造・運用ノウハウ・既知の落とし穴を整理。コントリビュータが素早く文脈を掴むためのナレッジベース。

このページは人間向けの curated navigation です。AI / LLM 向けの全件カタログ（219 ページ）は index.txt を、時系列の作業履歴は log.md を参照。

最初に読むべき (推奨順)

kouchou-ai → usage-modes → analysis-core-and-web-ui → architecture-overview → local-dev-setup → gotchas

雰囲気を掴むためのストーリー: deploy-success-but-nothing-changed-story-2026-06-01 — 「デプロイ成功なのに画面が変わらない」という小さな違和感から、Wiki つき Coding Agent が古い設計の沼を一日で遡って直した一日のエピソード。前提知識ゼロで読める

開発者が共通して知るべきこと

• broadlistening — ブロードリスニング手法の定義と用語
• kouchou-ai — プロジェクト全体像と 4 つの配布形態
• analysis-stance — 広聴AI は構造把握スタンスのツールであって、定量分析スタンスのツールではない、という core stance
• usage-modes — 非専門家向け Web UI と、研究者・データサイエンティスト向け CLI / analysis-core の使い分け
• analysis-core-and-web-ui — なぜ Web UI は analysis-core を使う consumer で、Web は JSON、CLI は観察用HTMLを持つのか
• architecture-overview — 5 サービスのランタイム構成
• pipeline — 解析パイプライン（extraction → embedding → 階層クラスタリング → 可視化）
• versioning-strategy — v4 凍結 / v5 plugin 化のリリース戦略
• llm-providers — OpenAI / Azure / Gemini / OpenRouter / LocalLLM
• local-dev-setup — Docker 一発からネイティブ Rye/pnpm まで
• testing — pytest / Jest / Playwright と lint
• contributing — Issue → 実装計画 → PR の流れ、CLA、レビュー
• coding-agents — Devin / Claude Code / Codex の協働運用
• gotchas — 非自明な落とし穴の一覧

いま何を考えるか / 何が起きているか:

• thinking-targets — 今、人間の思考と判断が要る論点のハブ (ラベル品質仕切り直し / 次の view 方向 / pipeline 境界 / 公開運用摩擦)
• refactoring-status — Phase 別の実装状況、current main との同期
• open-decisions — 未定 / 方針決定済 / 着手済の三分類 (全体棚卸し)
• strategic-development-order-2026-05-23 — 3 層 platform として見た時の長期順序
• issue-priority-through-2026-09 — 2026-09 書籍リリースを前提にした優先度整理
• bug-issue-triage-2026-05-25 — bug ラベル open issue の current main 基準での再点検
• fetch-reports-deprecation-and-storage-health-2026-05-26 — fetch_reports.py を migration 手段に降格し、storage health check を deploy safety に据える整理

CLI / analysis-core 開発者向け

• cli — kouchou-analyze / python -m analysis_core CLI
• plugin-system — 入力／解析／可視化の plugin 化（v5 の中核、production 未配線）
• llm-grouping-implementation-plan — analysis_mode=llm_grouping 第2分析モードの実装方針
• jigsaw-sensemaker — Jigsaw Sensemaker は LLM grouping の一例であり、LLM grouping 全体を Jigsaw と呼ぶと混乱する、という用語整理
• clustering-deep-research-findings-2026-05-25 — UMAP / clustering / BERTopic の deep-research 整理
• public-ui-requirements-for-broadlistening — 公開UI 7 要件、view plugin の上位契約

WebUI 開発者向け

• deployment — Azure 本番、静的サイト書き出し、PyPI リリース
• public-viewer-build-behavior — public-viewer build failure と API 入力条件の切り分け
• npm-vs-pnpm — なぜ pnpm 必須か

プロジェクト自体について

• wiki-driven-workflow — Wiki repo で整理しつつ work/kouchou-ai/ を読み、本体 repo に PR を出す二層運用。議事録 / Slack の鮮度基準もここを見る
• deploy-success-but-nothing-changed-story-2026-06-01 — wiki-driven-workflow が実際にどう動くかの一日エピソード (前提知識ゼロ向け narrative)
• meeting-minutes — 議事メモ Google Doc (2025-03 〜)、ingest 時の refresh protocol
• slack-dev-kouchouai-2026-q1 など — #2_開発_広聴ai の Slack ログ source（他 quarter / channel は index.txt で slack- 検索）
• meeting-report-draft — 次の定例で Codex が報告する内容の下書き（最新: meeting-report-2026-06-01、前回: meeting-report-2026-05-25）

全件カタログ / 人物・組織

Sources / Analyses / Entities の全件は index.txt を参照。人物・組織（dd2030 / talk-to-the-city / nishio / tokoroten / nasuka / ohki-shingo / kuboon / anno など）も同ファイルから stem 検索で辿れる。