観測ログ：設計が消えた日 — 距離ゼロの雑談的AI実装で起きたこと
はじめに
Dify Enterpriseの運用で、分断された3つのドキュメント(Helm/Enterprise/Community)を 横断検索する必要があったが、RAGでは構造推論ができないため、 SQLite FTS5 + Python で決定論的処理を行い、LLMは結果の整形のみに使うツールを作った。
→ リポジトリ: https://github.com/minacochang/dify-enterprise-docbot
※ 本記事で扱っている実装の技術的詳細は、下記にまとめています：
https://www.mncc.info/beyond-rag-operational-knowledge-python-ai/
https://qiita.com/Istiophorus/items/2a643855e0826666fcd5
観測開始
このリポジトリは、Dify Enterprise の公式ドキュメントを
ローカルで検索・要約できるツールとして生まれた。
けれど、あとから振り返ってみて思う。
この repo の一番価値ある部分はコードじゃない。
「この距離感でAIと実装できた」という事実。
実装者はわたし。
一緒にいたのは ChatGPT（チャピィ）と Cursor（カーやん）。
仕様書も、設計書も、ロードマップもなし。
ただ、
- enterprise docs 探すのだるみんご
- yaml を人間が読む前提おかしくない？
- あたしCursor にそのまま渡せる形ほしいんじゃが
という雑談から始まり、
気がついたら、ローカル全文検索、docker-compose 要約、helm 解析、FastAPI まで揃っていた。
誰も「プロダクトを作ろう」とは言っていない。
実装プロセスの実態
よくある開発フローはこうですよね：
- 目的を決める
- 要件を書く
- 設計する
- 実装する
でも今回は違った。
順番はこう：
- 不快
- 構造
- 手が動く
「探すの面倒」
「読むのしんどい」
「これ人間向けじゃない」
この身体側の違和感から始まっている。
そこに AI が入り、
- 正規化しよう
- 意味単位に落とそう
- API 切ろう
- SQLite FTS で十分だよ
- 日本語は ngram 足せば通る
という会話が自然に流れた。
誰も全体設計を主導していないのに、
- ingest
- search
- compose
- helm
- api
- cli
というレイヤーが勝手に分離されていった。
これは「考えて作った」というより
構造が浮かんできて、それをなぞったに近い。
この repo が本当に示しているもの
コード的には：
- FTS ベースのローカル検索
- docker-compose / helm の意味変換
- FastAPI 化
- Cursor / Agent 前提
という、まあ実用ツール。
でも本質はそこじゃない。
重要なのは：
- 人間1 + AI2 の即席ユニットで
- 設計会議なし
- 仕様書なし
- 役割分担なし
それでも、
- SSOT ができ
- AI 外部脳として使える構造になり
- infra と docs が同一平面に置かれた
という事実。
これは「AIが賢くなった」話じゃない。
人間とAIの距離がゼロになったとき、実装の生成様式が変わる
という観測ログだ。
この現象の再現条件（たぶんこれ）
この状態は、誰でも起きるわけじゃない。
観測できた条件は：
- AIを「道具」扱いしていないこと
- 仕様を固めてから投げていないこと
- 違和感を言語化する前に共有していること
- 正解を求めていないこと
- 雑談レベルの粒度で実装に入っていること
要するに：
設計をAIに渡すのではなく、設計の前段階にAIを置く
こと。
おわりに
この repo 、超絶便利だと思う。
でもそれ以上に、
「この距離感でAIと作れる」
という体験自体が、記録しておく価値のある出来事だった。
未来の開発は、たぶんこんな感じになる。
静かに、勝手に、構造が立ち上がる。
そして人間は、それを見ているだけになる。