コードから「生きたドキュメント」を生み出す
リポジトリをつなぐだけ。AIがコードを根拠にドキュメントを下書きし、コードの変更に自動追従。チームの「読みやすい一次資料」を育て続けます。
docsx.dev/documents
リポジトリを解析
1/4目次案
Overview — プロジェクト概要
Setup — 環境構築
認証フロー（JWT / OAuth）
GitHub 連携の仕組み
ドキュメント
認証フロー（JWT / OAuth）
docsx は JWT を httpOnly Cookie に保存します。
各 Server Action の先頭で requireAuth() を呼びます。
auth.ts:12
tRPC は protectedProcedure で userId を検証します。
trpc.router.ts:48
OAuth は email を一致キーに find-or-create します。
google-oauth.ts:24
ドキュメントが腐る3つの理由
誰も最初の一枚を書かない
SetupやOverviewなど、一番重要なドキュメントを書く時間がなく、知識が属人化してしまいます。
書いてもすぐ古くなる
コードは日々進化しますが、ドキュメントは更新されず、現場の事実から置き去りにされます。
AIの嘘が怖い
一般的なAIドキュメント生成は、存在しない関数やパラメータを捏造するハルシネーションが発生します。
解決策
「コードを根拠にする」
docsxは、すべてのドキュメントを実在するコードと紐付けることで、これらの課題を根本から解決します。
セキュアなGitHub連携
秘密鍵ベースの時限トークン発行により、認証情報を恒久的に残しません。プライベートリポジトリのコードも、高いセキュリティレベルで安全に同期可能です。
- GitHub Appによる粒度の細かい権限設定
- データの暗号化保存と転送
AI提案型ドキュメント生成
いきなり本文を書かせず、まずAIが「目次案」を提案。人間が構成をレビュー・修正し、承認したものだけをRAG（コード検索）に基づきMarkdown生成します。
「いきなり書かせない」ことが、
質の高いドキュメントへの近道です。
質の高いドキュメントへの近道です。
