Specpin 作成者: Lam Ngoc Khuong

Specpinはビジネス仕様（ルール、説明、受け入れ基準）を、実行中のウェブUIの要素に直接付与し、ホバーや閲覧中にブラウザ内でレンダリングします。

仕様駆動のコードジェネレーターではありません：アプリケーションコードを生成しません。既存のインターフェースに対して、Gitでバージョン管理された生きたドキュメントをピン留めするナレッジレイヤーです。specはリポジトリの.specs/ディレクトリにJSONとして保存され、トークン認証されたlocalhost経由で小さなローカルGoのsidecarからアドオンに提供されます。データは一切外部に出ません。

機能:

• ライブ要素にspecをピン留め: 堅牢なマルチシグナルfingerprintマッチング（test-id、aria、selector、xpath、テキスト、位置）により、specはリファクタリング後も生き続け、URLグロブでページ単位にスコープされます。

• マッチ信頼度とページの健全性: 各specがどうマッチしたか（厳密なanchorかselectorか）を表示し、壊れやすいマッチを確認し、data-spec-id属性で厳密マッチを実現。

• 3つの表示モード: tooltip、sidebar、ドラッグ可能なモーダルレンダラー。ワンクリックまたはAlt+Shift+Mで切り替え。

• 手動キャプチャ: 要素をクリックしてその場でspecを作成、ページを離れる必要なし。Alt+Shift+Cでキャプチャを切り替え。

• 書き込み可能なローカルプロジェクト: sidecarなしでもspecの編集、キャプチャ、作成、削除、グループzipエクスポートが可能。

• マルチプロジェクト接続: 1つのアドオンで複数のプロジェクトを同時に管理、originによってページごとにルーティング、プロジェクト単位の有効/無効とソースバッジ（sidecarかローカルか）。

• ガイドモード: 2つのスコープ（チーム、リポジトリにコミット；個人、origin単位）のspec駆動オンボーディングツアー。スポットライトオーバーレイとアンカー付きポップオーバー付き。

• Sidebarサーフェス: FirefoxのsidebarでSpecpinを開き、インラインspecの詳細とライブ自動更新を利用可能。

• spec検索: タイトル、ファイル、タグ、説明によるクライアントサイドのリアルタイムフィルター。

• 多言語specコンテンツ: ロケールキーの文字列、ブラウザ内の言語切り替え、タブ形式のロケール別エディター。

• Markdownフォーマットのspec: 説明とビジネスルールが安全なMarkdownサブセット（太字、斜体、インラインコード、リンク、リスト）をサポート。ツールバーで作成し、全サーフェスでレンダリング。

• ユーザー選択可能なテーマ: システム / ライト / ダーク、デュアルテーマのデザイントークン。

• 3言語インターフェース（EN + VI + JA）、specコンテンツ言語から独立。

デフォルトでセキュア: sidecarはデフォルトで127.0.0.1にバインド（リモート利用は自分のHTTPSリバースプロキシ経由のオプトイン）、bearer-token認証、拡張機能originのみCORSを許可、パストラバーサル防止の書き込みガード。オープンソース。データ収集なし、トラッキングなし、リモートコードなし。