index

Wiki Index

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

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

直近の状態: 開発日報 2026-10-12 / 定例レポート 2026-10-10 — analysis-core の AGPL 再ライセンス（0.1.3 公開・旧 MIT 版 0.1.0/0.1.2 yank、#970/#978/#979）と、一部解決 Issue の残件を PR 化（#982–#988、#987 など順次 merge 中）。次は残りの merge 判断と利用観測。

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

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 が古い設計の沼を一日で遡って直した一日のエピソード。前提知識ゼロで読める

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

• security-maintenance — CodeQL/Dependabot 保守の durable hub と公開境界ポリシー

• broadlistening — ブロードリスニング手法の定義と用語

• zipf-broadlistening — 「なぜサンプリングでなく全件か」を1枚で体験させる nishio のデモサイト（ランダムK件は割合pの意見を exp(-Kp) で丸ごと見落とす）

• kouchou-ai — プロジェクト全体像と 4 つの配布形態

• analysis-stance — 広聴AI は構造把握スタンスのツールであって、定量分析スタンスのツールではない、という core stance

• broadlistening-tool-ecosystem-vision — simple Web UI + CLI 実験の二段構造エコシステムビジョン（analysis-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 — 非自明な落とし穴の一覧

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

• serverless-product-direction-2026-09-08 — dd2030の目的から見たブラウザ版・既存版の役割、互換範囲、次の開発順序（本流化は未決）

• thinking-targets — 今、人間の思考と判断が要る論点のハブ (ラベル品質仕切り直し / 次の view 方向 / pipeline 境界 / 公開運用摩擦)

• refactoring-status — Phase 別の実装状況、current main との同期

• open-decisions — 未定 / 方針決定済 / 着手済の三分類 (全体棚卸し)

• issue-backlog-audit-2026-10-12 — 現行の全件 issue 棚卸し（最新。2026-05〜06 の triage はこれに置換済み）

• kouchou-ai-docs-policy-history / kouchou-ai-docs-overhaul-2026-10 — 本体 docs 方針の系譜と 2026-10 改善スプリントの総括

• faithful-aggregation-vs-deliberation-dynamics — 忠実な集約 vs 熟議ダイナミクス（分析スタンスの核）

• dependabot-alerts-2026-10-14 — security / dependency 保守の観測（脆弱性の具体詳細は公開 wiki に書かない方針）

• 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 開発者向け

• label-quality — クラスタラベルの契約と品質評価 5 レイヤの durable hub

• experiment-methodology — 実験設計の方法論（exploratory/clean・1 要素・blind A/B・judge 較正・3 層保存）

• extraction-faithfulness — 意見抽出(step1)の忠実性（完走≠意味保持・モデル別書換・受け入れ条件）

• ライセンスと結果公開 — データ・HTML・拡張の境界、CLIの案内自動付与と短いリンク表示の方針

• cli — kouchou-analyze / python -m analysis_core CLI

• plugin-system — 入力／解析／可視化の plugin 化（v5 の中核。analysis 側は workflow engine が CLI の既定経路、外部 plugin の同梱はまだ無い）

• llm-grouping-implementation-plan — analysis_mode=llm_grouping 第2分析モードの実装方針

• llm-grouping-supervised-classification — LLM grouping の自動／指定カテゴリ分類（supervised）の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 必須か

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

• 開発日報 — 2026年9月8日〜9日未明 — 本体とServerlessの実装・merge・Issue整理を、利用者に起きる変化と残課題から振り返る
• 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-logs-repository — dd2030 Slack public channel log の新しい一次置き場。最新14日は mirror、古い月は raw canonical を読む
• slack-dev-kouchouai-2026-q1 など — #2_開発_広聴ai の Slack ログ source（他 quarter / channel は index.txt で slack- 検索）
• meeting-report-draft — 次の定例で Codex が報告する内容の下書き（最新: meeting-report-2026-10-10、その前: meeting-report-2026-06-01）

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

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