🌐 English version (README.en.md)
AI エージェントが仕様・法令・技術文書の原文を引き、決められたルールに沿って検査・作成できるようにする MCP(Model Context Protocol)サーバーと Skill をつくり、その道具で動くアプリと検証器を作っています。
フロントエンドは TypeScript / Angular / RxJS / Svelte を主に使っています。
バックエンドは TypeScript / Node.js が中心で、.NET C# で Web API を書いた経験もあります。
もともとは運用とカスタマーエンジニアを長く務め、そこから開発に移りました。
2025 年 10 月からフリーランスとして、Angular / RxJS / NgRx を使うプロジェクトに参画しています。
公開しているものは、次の 6 つです。
- 動くアプリ — e-shiwake(デモ) — 個人事業主向けの仕訳帳・証憑管理 PWA。17 個のツールを function calling と WebMCP(ブラウザーの中で AI エージェントにツールを渡す仕組み)の両方に渡し、データを書き換える操作は実行前に人が承認します(HITL: Human in the Loop)
- 製品群 — PDF Agent Stack / houki-hub / s1000d-stack — PDF、日本の法令、S1000D の技術文書を、個別のサーバーではなく系列で扱います。判定はコード、説明は LLM。各製品が LLM の 17 の制約のどれに対処しているかは、ディスカッション #14 に一覧にしています。RFC は rfcxml-mcp にまとめています。
- marketplace — claude-plugins — 下の MCP サーバーと Skill を、Claude Code から
/plugin installで入れられます。導入の入口です。 - 道具 — MCP サーバー / Claude Skills — AI エージェントが PDF / W3C / RFC / 日本の法令 / S1000D の原文に直接あたるためのものです。
- 設計の根拠 — AI Agent Architecture / Understanding LLMs — 上の製品群を、なぜその層に分けたかの記録です。製品の使い方ではなく、制約と組み方です。LLM が失敗する理由は 17 の制約 に整理しています。
- 設計判断の支援 — ai-design-advisor — 生成 AI システムの構成を決めるとき、まだ決まっていないことを名指しして返す Skill です。
実装は Claude Code に任せ、設計方針と受け入れ条件は人が決める、という進め方をしています。公開したものは、Grok Build など別のホストで利用者と同じ経路から使い直し、見つかった問題を Issue にして直しています。
毎日の実装は Claude Code で進め、自作の MCP と Skill を開発の流れに組み込んでいます。詳しい手順は AI-Assisted Development Guide にまとめました。
どの手順も、LLM が仕組みの上で起こす失敗(17 の制約)のどれかを抑えるために置いています。各手順の末尾に、抑えたい制約の名前を書きました。製品群では扱っていない制約のうち、Context Rot や Non-determinism などは、主にこの手順で抑えます。Hallucination のように手順を組んでも残る失敗があるため、差分とテスト結果は人が確かめます。
- 規約を先に置く —
AGENTS.md/CLAUDE.mdに設計方針とテスト手順を書いておき、毎回のプロンプトで指示し直さずに済むようにしています(Instruction Decay・Prompt Sensitivity) - 役割を分ける — 調査・実装・レビュー・品質評価を、サブエージェントと Skill に分けて担当させます。要件と受け入れ条件は人が決めます(Self-Evaluation Bias・Context Rot)
- 調べ物は自作の MCP に任せる — 仕様書の原文(PDF / Web 仕様 / 法令 / S1000D)と、実際のファイルや互換性データを突き合わせます(Hallucination・Knowledge Boundary)
- 品質ゲートを通す —
Issue → 実装 → テスト → PRを固定し、仕様との照合や xCOMET(翻訳の品質を採点するモデル)による自動評価をパイプラインに載せます(Compounding Errors・Hallucination) - 公開後に外から測る — npm に公開した版を、別のホスト・OS・配布の形で通しで使う試用を行い、結果を Issue に戻します(pdf-agent-stack の eval)(Non-determinism・Self-Evaluation Bias)
| カテゴリ | 内容 |
|---|---|
| 📦 Claude Plugins (Marketplace) | 自作の MCP / Skill / Slash Command / Sub-agent を /plugin install で導入する入口 |
| 🔌 MCP Servers |
PDF / Web Spec / houki-hub / S1000D / DTIR の 5 ファミリーと、単独の MCP サーバーの一覧 |
| 🧩 Claude Skills | 作業手順をそのまま再利用するための Skill の一覧 |
| 📱 Web Apps & Tools | PWA と実用ツールの一覧 |
| 🧠 設計の根拠 | MCP・Skill・アプリをなぜその構造にしたのかの記録と、日々の実装手順 |
| 📖 Sites & Books | RxJS / Svelte / Web Components / TDD などの学習サイトと、Zenn 書籍 |
| 📓 Notes | デジタル署名・PWA・ローカル LLM・Manifest of Authenticity(デジタル資産の真正性を記述するオープン仕様)などのノート |
| 🧭 Now | いま進めていること・これから試すこと・検討中のこと |
- s1000d-stack — 航空・防衛分野の技術文書規格 S1000D のデータモジュールを、LLM が読み、BREX(顧客ごとの業務ルール)で検査し、XML を書かせずに作成する MCP・Skill の系列です
- 体験型マニュアル作成ツール(SvelteKit / PWA) — 操作を体験しながら学べるマニュアルを作り、その JSON から S1000D のデータモジュールを出します。試作中です
- 公開した版を外から測る — 別のホスト・OS で通しで使い、見つかった問題を Issue にして直しています
続けていること・これから試すこと・検討中のことは docs/now.md に書いています。
- 履歴書作成アプリ — 2021 年、JavaScript を学びながら初めて作った Web アプリです。いま読み返すとソースはとても恥ずかしいのですが、ここが出発点でした。公開中のアプリはこちら
- 職業訓練時の卒業作品: 体験型操作説明 — 券売機の画面画像にボタン領域を重ね、JSON で定義した画面遷移をブラウザーで疑似体験できるようにした 2021 年の制作課題です。いまの体験型マニュアル作成ツールの原点です。