Twiceshy

twiceshy

一度痛い目に遭えば、二度目は用心します。

苦労して得たエンジニアリングの経験（課題、行き詰まり、根本原因、検証済みの修正）を、判断時にLLMコーディングエージェントへ提供するセルフホスト可能なサービスです。エージェントが既知の間違いを自動的に繰り返すのを防ぎます。記録はGitで管理され、来歴を追跡できます。自動検索では関連性の下限を適用するため、一致度が低ければ何も返しません。

ホステッドアルファ版

ホステッドインスタンスはtwiceshy.appで稼働しています。セルフサービスのトークンと、リモートMCPエンドポイントhttps://api.twiceshy.app/を利用できます。外部からのコントリビューションをマージするには、署名済みCLAが必要です （ADR-0002）。

仕組み（確定済みのアーキテクチャ）

• 信頼できる唯一の情報源： Gitで管理するMarkdown形式の経験記録（YAMLフロントマター＋説明文）です。形式はdocs/SCHEMA.mdを参照してください。コーパスは独立してバージョン管理されるデータプロダクトです（twiceshy-corpus、 ADR-0021）。エンジンには、テスト用の小規模で固定されたフィクスチャ（internal/testcorpus/）が含まれます。
• インデックス： 再構築可能な派生SQLiteファイルを1つ使用します（FTS5と、検索時の取得に使うキャッシュ済みの純Go製密ベクトルを含みます）。
• 検索： フィンガープリントの完全一致 → BM25 → 密ベクトル（RRF）の順に検索し、スタックフィンガープリントで絞り込みます。最大件数はk≤3で、関連性の下限を設けます。下限を下回る場合は、何も注入しません。
• チャネル： プッシュ（Claude Codeフック → トラップカード）、プル（ストリーミング可能なHTTP経由のMCPツール）、インデックス（生成された一行要約）です。
• 信頼性： エージェントが提案した記録は隔離されます。昇格には、サンドボックスでの失敗から成功への検証と、人間によるPRレビューが必要です。新しい記録はプルリクエストです。
• ドクター： 重複排除、古さの確認、再現テストの再実行（記憶のためのCI）、減衰処理、抽象化を行うバックグラウンドジョブです。

詳しい根拠：docs/research/EXPERIENCE_SERVICE_RESEARCH.mdおよびdocs/adr/ADR-0001-architecture.md。

ステータス

コアサービスはホステッドアルファ版として利用できます。現在提供されている機能と最新のロードマップについては、正式なスナップショットであるdocs/NEXT_FEATURES.mdを参照してください。デプロイと運用の詳細はdocs/DEPLOY-public-alpha.mdにあります。

開発

make ci    # lint + race tests + coverage floor — what CI runs

まずdocs/CONVENTIONS.mdとdocs/CONTEXT.mdを参照してください。

ライセンス

AGPL-3.0-only。コントリビューションとコーパスのライセンスについては、docs/adr/ADR-0002-licensing-strategy.mdを参照してください。