gkill の資料層の役割分担と保守手順。AGENTS.md / CLAUDE.md / .claude/skills/ / documents/adr/ / documents/reverse/ / resources/manual_src/ / ABOUT_TEST.md のどれが何の正本か、npm run verify_docs が機械検査する内容(件数・リンク・ファイル名実在・ADR 構造・スキル索引網羅・サイズ上限・個人情報パターン・マニュアル生成鮮度と用語)、ADR の書き方と番号帯、マニュアルは…
gkill の MCP サーバ(src/mcp/、read/write/readwrite の3種、stdio + HTTP OAuth 2.1)の約束。1リクエスト文脈は不変の requestContext を引数で流し server.current* に書かない、プラグイン本文は gkill_get_kyous の include_plugin_content でまとめて埋め込み同一プラグインへ並列に投げない、IDF ファイルの3経路(file_path / file_url /…
KFTL(メモ帳)の約束。タブ(kftl-tabs.ts / use-kftl-tabs.ts)、保存マーカーの beforeinput/input 対、複数ウィンドウの二重送信防止と送信タブの排他、メモ帳ダイアログの複数枚化(KFTLDialogHost・slot 採番)、KFTL パーサ(TS/Go の2実装)を扱う。src/client/classes/kftl/・kftl-tabs.ts・use-kftl-tabs.ts・use-kftl-view.ts・kftl-view.vue・mkfl-view.vu…
gkill の Go バックエンド(src/server/gkill/)の禁止事項と契約。検索フィルタ(rep名の絞り込み・タグ絞り込みの2経路・FindQuery.IDs のチャンク分割)、キャッシュrepの判定とライトスルー、キャッシュのフルリビルド抑止、リポジトリ4層と doc コメント網羅、safefetch・共有ファイル認可・型別 GetXxx の最新版取得などの HTTP セキュリティを扱う。src/server/gkill/api/・dao/・usecase/・req_res/…
gkill プラグイン(src/plugins/ の独立バイナリ・plugin/sdk/・本体側 dao/reps/plugin_*.go)の約束。manifest.json の provides と型別/付随データ、PluginTypedIndex から即答してプラグインへ往復しない読み取り、stdio のスロット直列化とプロセス回収条件、常駐ビルダ+WAL、Google Takeout の zip 直読みと CRC32+Size 差分、本文表示 plugin-html-view.vue の iframe…
検索条件 FindQuery の null 判定セマンティクス。null=フィルタ未使用・非nullの空配列=0件指定、use_* フラグ全廃、ゲートヘルパ経由の判定、TypeScript 側の undefined 禁止、旧形式JSONの移行3実装(Go の find_query_legacy_json.go / client の normalize-legacy-find-kyou-query-json.ts / MCP の…
gkill のビルド・テスト・E2E 実行の約束。ビルドパイプライン(dist と i18n とマニュアルの embed への3コピー)、embed 無しの裸 go build が起動即死バイナリを作る罠、dev サーバの --api プロキシ指定、E2E の専用ホームと空きポート自動採番(ポートを固定しない)を扱う。package.json・src/tools/・vite.config.ts・playwright.config.ts・src/client/__tests__/e2e/・.github/workfl…
gkill の CLI サブコマンドと運用(src/server/gkill/main/)の約束。gkill_server / gkill の2配布形態、update_cache と auto_tag が起動中サーバの HTTP クライアントであること、configs 直書きの自己発行セッションとその権限、auto_tag のタグID採番と再実行、clear_cache のユーザー別派生キャッシュ(thumb/video/zip/plugin)、CLI フラグ一覧、RunE +…