観測ログ:設計が消えた日 — 距離ゼロの雑談的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 まで揃っていた。

誰も「プロダクトを作ろう」とは言っていない。


実装プロセスの実態

よくある開発フローはこうですよね:

  1. 目的を決める
  2. 要件を書く
  3. 設計する
  4. 実装する

でも今回は違った。

順番はこう:

  1. 不快
  2. 構造
  3. 手が動く

「探すの面倒」

「読むのしんどい」

「これ人間向けじゃない」

この身体側の違和感から始まっている。

そこに 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と作れる」

という体験自体が、記録しておく価値のある出来事だった。

未来の開発は、たぶんこんな感じになる。

静かに、勝手に、構造が立ち上がる。

そして人間は、それを見ているだけになる。