Skip to content
View shuji-bonji's full-sized avatar

Block or report shuji-bonji

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Content in all repositories owned by your account will be closed.
Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
shuji-bonji/README.md

shuji-bonji

🌐 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 つです。

  1. 動くアプリ — e-shiwake(デモ) — 個人事業主向けの仕訳帳・証憑管理 PWA。17 個のツールを function calling と WebMCP(ブラウザーの中で AI エージェントにツールを渡す仕組み)の両方に渡し、データを書き換える操作は実行前に人が承認します(HITL: Human in the Loop)
  2. 製品群 — PDF Agent Stack / houki-hub / s1000d-stack — PDF、日本の法令、S1000D の技術文書を、個別のサーバーではなく系列で扱います。判定はコード、説明は LLM。各製品が LLM の 17 の制約のどれに対処しているかは、ディスカッション #14 に一覧にしています。RFC は rfcxml-mcp にまとめています。
  3. marketplace — claude-plugins — 下の MCP サーバーと Skill を、Claude Code から /plugin install で入れられます。導入の入口です。
  4. 道具 — MCP サーバー / Claude Skills — AI エージェントが PDF / W3C / RFC / 日本の法令 / S1000D の原文に直接あたるためのものです。
  5. 設計の根拠 — AI Agent Architecture / Understanding LLMs — 上の製品群を、なぜその層に分けたかの記録です。製品の使い方ではなく、制約と組み方です。LLM が失敗する理由は 17 の制約 に整理しています。
  6. 設計判断の支援 — ai-design-advisor — 生成 AI システムの構成を決めるとき、まだ決まっていないことを名指しして返す Skill です。

実装は Claude Code に任せ、設計方針と受け入れ条件は人が決める、という進め方をしています。公開したものは、Grok Build など別のホストで利用者と同じ経路から使い直し、見つかった問題を Issue にして直しています。

⚙️ 日常の AI 駆動開発

毎日の実装は Claude Code で進め、自作の MCP と Skill を開発の流れに組み込んでいます。詳しい手順は AI-Assisted Development Guide にまとめました。

どの手順も、LLM が仕組みの上で起こす失敗(17 の制約)のどれかを抑えるために置いています。各手順の末尾に、抑えたい制約の名前を書きました。製品群では扱っていない制約のうち、Context Rot や Non-determinism などは、主にこの手順で抑えます。Hallucination のように手順を組んでも残る失敗があるため、差分とテスト結果は人が確かめます。

  1. 規約を先に置く — AGENTS.md / CLAUDE.md に設計方針とテスト手順を書いておき、毎回のプロンプトで指示し直さずに済むようにしています(Instruction Decay・Prompt Sensitivity)
  2. 役割を分ける — 調査・実装・レビュー・品質評価を、サブエージェントと Skill に分けて担当させます。要件と受け入れ条件は人が決めます(Self-Evaluation Bias・Context Rot)
  3. 調べ物は自作の MCP に任せる — 仕様書の原文(PDF / Web 仕様 / 法令 / S1000D)と、実際のファイルや互換性データを突き合わせます(Hallucination・Knowledge Boundary)
  4. 品質ゲートを通す — Issue → 実装 → テスト → PR を固定し、仕様との照合や xCOMET(翻訳の品質を採点するモデル)による自動評価をパイプラインに載せます(Compounding Errors・Hallucination)
  5. 公開後に外から測る — npm に公開した版を、別のホスト・OS・配布の形で通しで使う試用を行い、結果を Issue に戻します(pdf-agent-stack の eval)(Non-determinism・Self-Evaluation Bias)

🛠 Tech Stack

TypeScript JavaScript Node.js HTML5 CSS3 SCSS C# Angular RxJS NgRx Svelte SvelteKit PWA Jasmine Vitest Vite Claude Claude Code Skills GitHub Copilot MCP Ollama

🗂 Contents

カテゴリ 内容
📦 Claude Plugins (Marketplace) 自作の MCP / Skill / Slash Command / Sub-agent を /plugin install で導入する入口
🔌 MCP Servers npm 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 いま進めていること・これから試すこと・検討中のこと

🧭 いま進めていること(2026 年 11 月時点)

  • s1000d-stack — 航空・防衛分野の技術文書規格 S1000D のデータモジュールを、LLM が読み、BREX(顧客ごとの業務ルール)で検査し、XML を書かせずに作成する MCP・Skill の系列です
  • 体験型マニュアル作成ツール(SvelteKit / PWA) — 操作を体験しながら学べるマニュアルを作り、その JSON から S1000D のデータモジュールを出します。試作中です
  • 公開した版を外から測る — 別のホスト・OS で通しで使い、見つかった問題を Issue にして直しています

続けていること・これから試すこと・検討中のことは docs/now.md に書いています。

🏠 記念碑

  • 履歴書作成アプリ — 2021 年、JavaScript を学びながら初めて作った Web アプリです。いま読み返すとソースはとても恥ずかしいのですが、ここが出発点でした。公開中のアプリはこちら
  • 職業訓練時の卒業作品: 体験型操作説明 — 券売機の画面画像にボタン領域を重ね、JSON で定義した画面遷移をブラウザーで疑似体験できるようにした 2021 年の制作課題です。いまの体験型マニュアル作成ツールの原点です。

📬 Contact

GitHub npm Qiita Zenn

LAPRAS Findy Gitty Code

Pinned Loading

  1. e-shiwake e-shiwake Public

    フリーランス・個人事業主向けの仕訳帳 + 証憑管理 PWAアプリ

    TypeScript 11 1

  2. Svelte-and-SvelteKit-with-TypeScript Svelte-and-SvelteKit-with-TypeScript Public

    TypeScriptとSPA経験者が、Svelte・Sveltekitの学習するコンテンツを提供

    Svelte 18

  3. xcomet-mcp-server xcomet-mcp-server Public

    Translation quality evaluation MCP Server powered by xCOMET (eXplainable COMET).

    TypeScript 2 2

  4. rfcxml-mcp rfcxml-mcp Public

    A Model Context Protocol (MCP) server for structured understanding of RFC documents.

    TypeScript 4

  5. pdf-spec-mcp pdf-spec-mcp Public

    An MCP (Model Context Protocol) server that provides structured access to ISO 32000 (PDF) specification documents. Enables LLMs to navigate, search, and analyze PDF specifications through well-defi…

    TypeScript 2

  6. houki-egov-mcp houki-egov-mcp Public

    日本の法令(憲法・法律・政令・省令・規則)を e-Gov 法令API v2 から、条・項・号の単位で、法令番号と URL を添えて返す MCP サーバー。Japanese statutes from e-Gov Law API v2 — laws and ordinances per article, with law number and URL.

    TypeScript 2