CodeAlmanac - AIコーディングエージェントのためのコードベースWiki

• コードだけでは表せない 意思決定、流れ、不変条件、落とし穴（gotchas） を記録し、AIエージェントにコンテキストを提供する生きたWiki
  • システムがなぜ現在の形になっているのか、過去に何が壊れたのか、ワークフローがファイル/サービスをどのように横断するのかを記録
• Wikiはリポジトリ内の Markdownファイル として保存され、ローカルでインデックス化した後、コードのように Gitでレビュー 可能
• エージェントと人間が 同じローカル読み取りコマンド を使用: search, show, topics, health, validate
  • search --mentions src/checkout/ でファイルパス基準の検索をサポートし、--wiki <name> で別のWikiを参照可能
• Wikiを継続的に更新するライフサイクル作業は、build / ingest / garden の3つの明示的なエージェントで実行
  • 別途公開されている Yoke SDK を利用
  • ingest: ファイル、ディレクトリ、Git diff、コミット範囲、GitHub PR/Issue、URL、ローカルエージェントのトランスクリプトをWikiに統合
  • garden: 古いページ、弱いリンク、トピック、重複ページなどを整理
• メンテナンスコマンドを覚えなくてもよいよう、ローカルのmacOS launchdバックグラウンドジョブ を3種類提供
  • Sync（5時間ごと）: 最近のCodex/Claudeとの会話をスキャンし、関連するWikiにingestジョブとしてキュー投入
  • Garden（24時間ごと）: 登録済みの全Wikiについて、古くなった/重複した/リンクが不十分な知識をレビュー
  • Update（24時間ごと）: 安全なタイミングでのみCLIを自動更新し、ライフサイクル作業の実行中はスキップ
• ホスティングサービスやクラウド同期ではなく 完全ローカル実行、ログは ~/.codealmanac/logs/ に保存
• 実行履歴はローカルのジョブレコードとして残り、ターミナルを閉じても参照可能
  • jobs, jobs show, jobs logs, jobs attach, jobs cancel
  • --json でスクリプト連携が可能
• Providerは almanac-yoke を単一窓口として利用し、Codexはapp-server、ClaudeはPython Agent SDKを使用
  • 既存のCodex/Claude Code OAuthセッションを再利用
• serve で起動するローカルビューアは 読み取り専用 で、ページ/検索/トピック/バックリンク/ファイル参照ナビゲーションをレンダリング
• ライフサイクルエージェントは、広範な非対話型ファイルシステム権限で動作
  • almanac/ フォルダはOSサンドボックスではなく、指示/コミットポリシー であるため、信頼できるリポジトリでのみ実行する必要あり
• テレメトリは任意。コード/パス/プロンプト/トランスクリプト/資格情報は送信せず、GeoIPは無効化され、DO_NOT_TRACK=1 でもブロック可能
• Apache-2.0ライセンス