🌐 English version (README.en.md)
TypeScript / Node.js で構造化ツールをつくる開発者。AI エージェントが信頼できる仕様ドキュメントや開発者ワークフローにアクセスできるようにすることに重点を置いています。
AI エージェント（Claude / Claude Code / GitHub Copilot 等）と協働して開発を進めるためのワークフロー・ノウハウをまとめています。
- 設計指向：AIに「何をどう作るか」を判断させすぎず、人間が仕様・アーキテクチャの責任を持つ
- 構造化ドキュメント：MCP / Skill / 仕様書を、AI が読み解きやすい形で整備する
- 検証ループ：プロンプト → 出力 → 仕様書チェック → 修正、を高速に回す
| Phase | プロジェクト | 説明 | リンク |
|---|---|---|---|
| 1 | understanding-llm-through-claude-code | LLM の構造的制約を理解し、Claude Code の設計思想から「なぜそう設定するのか」を学ぶ | Site · GitHub |
| 2 | ai-agent-architecture | MCP・Skills・Agent 統合の設計思想・アーキテクチャ・実践ノウハウ | Site · GitHub |
| 3 | Management-of-software-systems-and-services | 先人達が培ってきたソフトウェアシステム・サービス開発・管理へ AI を適用 |
自作の MCP / Skill / Slash Command / Sub-agent を Claude Code・Cowork から /plugin install で導入できる marketplace。Anthropic 公式 (anthropics/claude-plugins-official) と同じ form factor。
| Marketplace | 説明 | リンク |
|---|---|---|
| shuji-bonji/claude-plugins | shuji-bonji 製 plugin の catalog（houki / web-spec / quality-tools / domain-specific / dev-meta の5カテゴリ） | GitHub |
# Claude Code
/plugin marketplace add shuji-bonji/claude-plugins
/plugin install houki-research@shuji-bonjiCowork mode の場合、Settings → Plugins に https://github.com/shuji-bonji/claude-plugins を marketplace として追加。
| Plugin | カテゴリ | 状態 | リンク |
|---|---|---|---|
| houki-research | houki | ✅ v0.1.0 | GitHub |
収録予定 plugin（19件、🚧 計画中）の一覧は marketplace の README を参照してください。
AI エージェント（Claude 等）から外部仕様・データを扱えるようにする MCP サーバ群。 ドメイン横断で物語性のあるものは family として独立した小見出しでまとめています。
PDF を「正典 × 実体」の二層で扱う MCP ファミリー。 ISO 32000（PDF 2.0）/ PDF 1.7 / PDF/UA / TS 32001 系などの 仕様書そのものを構造化正典として LLM に提供する層 と、PDF ファイルの オブジェクト・xref・ストリーム・タグ構造を低レベルで解析する層 を組み合わせ、「仕様準拠を意識した PDF 解析・検証」を成立させることを狙っています。
| MCPサーバ | レイヤ | 説明 | リンク |
|---|---|---|---|
| pdf-spec-mcp | 仕様書層（正典） | ISO 32000 系 PDF 仕様の構造化参照。セクション取得・要件抽出（shall / must）・定義参照・バージョン比較 | npm · GitHub |
| pdf-reader-mcp | 実体層（解析） | PDF テキスト・表・署名・タグ・フォント・メタデータの抽出と、内部構造（オブジェクト・xref 等）の検査 | npm · GitHub |
Tip
多くの PDF 系 MCP が「テキストを抜く」抽出ツールに留まる中、本ファミリーは PDF 仕様書を一次資料としてクエリ可能な状態に正典化し、実体解析と双方向に参照する ことを目的としています。電子署名・PDF/UA 準拠・PDF/A 検証など、仕様準拠が問われるユースケース向け。
Web / Internet 標準を AI から構造化されたまま扱うための MCP ファミリー。 IETF（RFC）・W3C / WHATWG（HTML / CSS / WebIDL / PWA 等）の 仕様書側 と、ブラウザ実装の 互換性データ（Baseline / BCD） を、それぞれ専用 MCP として分離し、「仕様で何が要求されているか」と「いまブラウザで何が使えるか」を同じ会話の中で照合できるようにしています。
| MCPサーバ | レイヤ | 説明 | リンク |
|---|---|---|---|
| rfcxml-mcp | IETF（仕様） | IETF RFC（XML2RFC v3）の構造解析・要件抽出・RFC 間依存の参照 | npm · GitHub |
| w3c-mcp | W3C / WHATWG（仕様） | W3C / WHATWG 仕様（HTML 要素・CSS プロパティ・WebIDL・PWA 等）の参照 | npm · GitHub |
| web-compat-mcp | 実装（互換性） | Baseline / Browser Compat Data に基づくブラウザ互換性チェック | npm · GitHub |
Tip
「仕様では MUST なのに、現実のブラウザでは Baseline 入りしていない」「この RFC は別の RFC を Update している」といった、仕様 × 実装 の不一致を AI に検証させたいときに、3 件を同じ会話から呼び出して使うことを想定しています。
ファミリーには属さない単発の MCP。
Domain-specific — 特定ドメインの仕様・データセットを構造化提供。
| MCPサーバ | カテゴリ | 説明 | リンク |
|---|---|---|---|
| epsg-mcp | 地理空間 | EPSG 測地系（CRS）検索・変換推奨 | npm · GitHub |
| ifc-core-mcp | 建築（BIM） | IFC 4.3 エンティティ・継承関係・PropertySet 参照 | npm · GitHub |
Quality / Dev tooling — 品質評価・開発支援（npm スコープなし・命名揺れあり）。
| MCPサーバ | カテゴリ | 説明 | リンク |
|---|---|---|---|
| xcomet-mcp-server | 翻訳品質評価 | xCOMET による機械翻訳の品質評価・エラー検出 | npm · GitHub |
| rxjs-mcp-server | RxJS 開発支援 | RxJS ストリームの実行・デバッグ・可視化 | npm · GitHub |
Claude / Claude Code から呼び出して、特定領域の作業ワークフローを再利用するための Skill
| スキル | 説明 | リンク |
|---|---|---|
| deepl-glossary-translation | PDF仕様書翻訳ワークフロー（DeepL＋用語集） | GitHub |
| spec-compliance-skills | W3C/IETF仕様への準拠性をチェックするためのCoworkプラグイン | GitHub |
| factcheck-skill | 情報の信頼性を科学的・体系的に評価する、Claude Code / Cowork 用ファクトチェック・スキル | GitHub |
| media-literacycheck-skill | インターネット上の情報の信頼性を メディアリテラシー の観点から体系的に評価する、LLM 用スキル | GitHub |
法令・通達・実務情報を AI で扱うための統合エコシステム。 MCP サーバ、TypeScript ライブラリ、Claude Skill、ドキュメントサイトをワンセットで提供することを目指しています。
| MCPサーバ | 説明 | リンク |
|---|---|---|
| houki-egov-mcp | e-Gov 法令API v2 経由で憲法・法律・政令・省令・規則の本文／目次／改正履歴を取得 | npm · GitHub |
| houki-nta-mcp | 国税庁の基本通達・改正通達・事務運営指針・文書回答事例・Q&A・タックスアンサーを SQLite + FTS5 で全文検索 | npm · GitHub |
| スキル | 説明 | リンク |
|---|---|---|
| houki-research-skill | houki-hub MCP family を横断する法令リサーチのオーケストレーション Skill（法律→政令→省令→通達→PDF→判例の参照順序・業法独占への配慮を内蔵） | GitHub |
| パッケージ | 説明 | リンク |
|---|---|---|
| houki-abbreviations | 日本の法令略称・通称の共有辞書（174 エントリ・6 分野）。houki-hub MCP family が共通で利用 | npm · GitHub |
実用ツール・自作プロダクト群
| プロジェクト | 説明 | リンク |
|---|---|---|
| e-shiwake | フリーランス・個人事業主向けの仕訳帳 + 証憑管理 PWAアプリ | 📱 App · GitHub |
| e-shiwake-ai | AIエージェントをフロントエンドとして利用した、e-shiwake | GitHub |
| fact-checklist | 事実確認チェックシート — 情報の信頼性を評価するPWAアプリ | 📱 App · GitHub |
| websocket-practical-guide | WebSocket 実践ガイド — リアルタイムWebアプリ実践PWA | 工事中🏗️ 📱 App · GitHub |
| marble-to-svg | RxJS マーブル記法 → SVG 変換ツール | 🔧 Tool · GitHub |
| WebAPI Test Tool | Step CI を利用した WebAPI テスト実行ツール | GitHub |
学習中・整備中のドキュメントサイト／公開ノート
| サイト | リンク |
|---|---|
| TypeScriptで学ぶ Svelte 5 / SvelteKit | 📖 Site · GitHub |
| TypeScript で RxJS | 📖 Site · GitHub |
| TypeScript で Web Components | 📖 Site · GitHub |
| TypeScriptで学ぶ SOLID設計原則 | 📖 Site · GitHub |
| TypeScript で テスト駆動開発(TDD) | 📖 Site · GitHub |
| 状況認識と意思決定 | 📖 Site · GitHub |
📓 その他のノート・テンプレート
僕のプログラミングの原点
履歴書作成アプリ — 2021年、JavaScriptを学び初めて作ったWebアプリ。ソースは今見るととても恥ずかしいですが、ここが僕にとってスタート地点です。
