spencerbraun/backdraft

backdraft は何をしますか？

共有可能で自己完結したドキュメントをクリック可能な引用とともに提供します。あらゆるエージェントをファイルに検証可能な形で基づかせるCLIおよびエージェントスキルです。

概要

Backdraft は、AIエージェントがファイルから読み取った内容に基づいて、検証可能で参照可能なドキュメントを作成できるようにするツールです。各主張は元のソースファイルにリンクされており、誰でも出力の正確性を確認できます。

特徴

• クリック可能な引用: 各事実または主張は、元のソースファイルへの直接リンクが埋め込まれています。
• 自己完結型ドキュメント: 単一のマークダウンファイルにすべてのコンテキストと参照が含まれています。
• CLI ツール: コマンドラインから backdraft ドキュメントを作成、検証、共有できます。
• エージェント統合: Claude Code、Cursor、Codex などのAIエージェント内でスキルとして動作します。
• 検証可能なグラウンディング: エージェントが指定されたファイルにのみ基づいて応答することを保証します。

使用方法

CLI として

# 新しい backdraft ドキュメントを作成
backdraft create output.md --files src/main.ts,src/utils.ts

# 既存の backdraft ドキュメントを検証
backdraft verify document.md

# 引用を含むドキュメントを表示
backdraft view document.md

エージェントスキルとして

# エージェントにこのスキルを使用するよう指示
Read the files in my project and create a backdraft document summarizing the key architecture decisions.

仕組み

1. エージェントが指定されたファイルを読み取ります。
2. ファイルから抽出した各主張または事実に対して、ソースファイルと行番号を追跡します。
3. エージェントが backdraft マークダウン形式で応答を生成し、各主張を引用でリンクします。
4. backdraft CLI がドキュメントを検証し、すべての引用が有効であることを確認します。
5. ドキュメントをチームと共有でき、誰でもソースをクリックして確認できます。

サポートされるプラットフォーム

• Claude Code
• Cursor
• Codex
• その他のAIエージェントおよびLLM

例

# アーキテクチャの概要

プロジェクトはクリーンアーキテクチャパターンに従っています[src/main.ts](src/main.ts#L10-L15)。

データベース層にはPostgreSQLが使用されています[src/utils.ts](src/utils.ts#L42)。

ライセンス

MIT