Skip to content

OTR_CurrentChallenges

nishi_74322014 edited this page Oct 28, 2026 · 12 revisions

Open 棟梁の課題と対応

概要

Open 棟梁(OpenTouryo)と汎用認証サイト(MultiPurposeAuthSite)が、今直面している課題と、その対応を整理する。

  • 外部の生成 AI が挙げた課題の一覧を出発点にし、リポジトリの実態(2026-10 時点の origin/develop)に照らして書き直した。
  • 一覧では Open 棟梁と汎用認証サイトの話が混ざっていたので、どちらの課題かを分けて書く。
  • 一覧に無かった課題(担い手の集中、組織・マネジメント)を加えた。
# 課題 主に誰の課題か 対応の状況
1 .NET Framework 4.8 と .NET 10 の並行維持 両方 対で作り、両方をビルド・テストしている。net48 の終わらせ方は未定
2 セキュリティ仕様への追従 主に汎用認証サイト(部品は Open 棟梁) 03-30 / 02-10 で大きく前進。適合性テストの仕組みが無い
3 コーディング・エージェントの時代のフレームワーク Open 棟梁 方式をエージェント向けに書き出し済み。効果の計測はこれから
4 学習コストとドキュメントの維持 Open 棟梁 覚える人を絞る。文書はリポジトリ内でエージェントと保守する
5 担い手の集中(持続性) 両方 エージェントで 1 名でも更新のペースは過去最高。知識をリポジトリに置く。レビュー・検収の担い手は課題のまま
6 組織・マネジメント 展開する組織 技術では解決しない。リードエンジニアの位置付けの問題

詳細

1. .NET Framework 4.8 と .NET 10 の並行維持

実態

  • Open 棟梁のフレームワーク本体は、主なアセンブリが *_net48.csproj と *_netcore100.csproj の対で作られている(各 10 個)。
    Web Forms・WCF(ServiceInterface/WCFService。.NET Framework 4.8 のみ)など、.NET Framework にしか無い技術の部品も残っている。
  • テストの期待値(ゴールデン・ファイル)も、net48 版・.NET 10 版・Linux 版で別に持っている。
  • 汎用認証サイトも、net48 版と net10.0 版を並行して持つ。
    両者は少しずつずれる(例:net48 版の WebAuthn は、ライブラリが対応しなくなったため 02-10 で削除)。

対応

  • 業務ロジックとランタイム・フレームワークの間に緩衝層を置く設計で、両方を同じ方式で書けるようにしている(ランタイム・フレームワーク)。
  • ビルド・全テスト・スモークテストのスクリプトで、両方のターゲットを毎回検証する(リリース・エンジニアリング)。
  • 対の同期(片方に入れた修正を、もう片方にも入れる作業)は、コーディング・エージェントに任せやすい種類の作業で、実際にそうしている。
  • 移行の手順は バージョンアップの進め方 に纏めている。

残る課題

  • net48 版をいつ、どう終わらせるかの方針が無い。
    .NET Framework 4.8 は OS のライフサイクルに従ってサポートされるので、利用者の既存資産がある限り続く。
  • 片方にしか無い機能が増えると、「同じ方式で書ける」という前提が崩れていく。差を一覧で管理する必要がある。

2. セキュリティ仕様への追従

実態

主に汎用認証サイトの課題で、Open 棟梁はその部品(JWT・JWS・JWE・SAML2・OAuth2 / OIDC のクライアントなど)を提供する立場にある。

領域 状況(origin/develop)
FAPI(Part 1・2)、CIBA、mTLS 以前の版から実装がある。mTLS のトークンの紐付けは、02-10 で RFC 8705 の形式に直した
PAR・DPoP・DCR・ログアウト 02-10 で追加(汎用認証サイトの ANALYSIS-IdP.md の D 項目は、D-14 を除いて対応済み)
OAuth 2.1 への整合 02-10 で既定を変えた(雛形の Implicit / ROPC を無効、PKCE の扱い)
XML 署名の付け替え(XSW) Open 棟梁の SignedXml2.Verify が署名の数学的な正しさしか見ていなかったのを、2026-10-19 に直した(署名の対象と、消費する要素の一致を確認)
署名・暗号の既定 Open 棟梁 03-30 で、SAML2 の署名の既定を SHA1 → SHA256、ECB を非推奨、パスワードからの鍵の導出を修正など

対応

  • 仕様との差を、エージェントに適合性の分析(ANALYSIS-IdP.md)として洗い出させ、項目ごとに Issue にして直す、という進め方を取っている。
  • 直した振る舞いは、E2E テスト(3 方言の DB)で回帰を検知する。
  • 汎用的な部品は、汎用認証サイトから Open 棟梁へ移している(OTR #634)。

残る課題

  • 適合性テストの仕組みが無い(D-14。OpenID Foundation の Conformance Suite を回す手順)。
    自前のテストでは、仕様の読み違いをそのまま正しいと判定してしまう。
  • 修正の多くは後方互換性に影響する(sub の値、redirect_uri の比較、署名の既定、暗号文など)。
    利用者の移行の手間が増えるので、リリース情報で後方互換性を明示し続ける必要がある。
  • 仕様は今後も変わる。追従を続けられるかは、5 の担い手の問題でもある。

3. コーディング・エージェントの時代のフレームワーク

実態

対応

  • 方式を、エージェントが読める形で書き出している。
    • リポジトリの AGENTS.md・CODING.md・領域ごとの ANALYSIS.md(19 個)。
    • エージェント用スキル(OpenTouryoCodingAgentAssets)。常に載せるインストラクションと、必要なときだけ読まれるスキルに分けている。
  • 開発者(エージェント)が触る固有の API を、UOC_ メソッドなどのスロットに絞っている(コーディング・エージェント時代の開発基盤)。

残る課題

  • 効果は、Open 棟梁を使った案件ではまだ計測していない(開発基盤のKPIとKGI)。
    フレームワーク自体の開発では、更新のペースが大きく上がった(5 を参照)。
  • スキルは、フレームワークの版が上がるたびに古くなる。版の差分(詳細なリリース情報)からスキルを直す流れを作る必要がある。

4. 学習コストとドキュメントの維持

実態

  • 厳格な層構造・共通処理・設定ファイル・独自の実装パターンがあり、参画する開発者にとって学習コストが高い。
  • 加えて、標準化フレームワークは他の案件で出会う確率が低いので、技術者に習得を敬遠されてきた(需給の問題)。

対応

  • 覚える人を絞る:方式を決めて検証するリードエンジニア・纏め者が深く理解し、スロットを埋める作業はエージェントに任せる
    (標準化フレームワークの習得の需給とコーディング・エージェント)。
  • 文書をリポジトリの中に置き、エージェントと一緒に保守する:ANALYSIS.md・TESTING.md・CONFIGURATION.md など(汎用認証サイトの作業中ブランチでは、設計の経緯を DesignNotes/ に分けている)。
    コードの変更と同じ PR で文書も直すので、ずれにくい。
  • 利用者向けの情報は、この Wiki(使い方・リリース)と、GitHub の Wiki(チュートリアル)に分けている。

残る課題

  • AI に任せるほど、人の理解は落ちる、という調査がある。検証できる人を育てる仕組みが別に要る。
  • GitHub の Wiki(チュートリアル)と、リポジトリ内の文書・この Wiki の間で、内容がずれうる。

5. 担い手の集中(持続性)

外部の生成 AI の一覧では「コミュニティでの貢献とフィードバックの循環」として触れられていたが、実態はより具体的である。

実態

  • 03-20 以降の Open 棟梁の develop のコミット(マージを除いて 277)は、依存パッケージの自動更新(3)を除き、1 名のアカウントによる。
    汎用認証サイトの 02-00 以降(312)も同じである。
  • 一方で、更新のペースは大きく上がっている。コーディング・エージェントを使い始めた影響である。
年 Open 棟梁 汎用認証サイト 備考
2017〜2019(ピーク) 190〜287 / 年 100〜132 / 年 活発に開発していた時期(当時も主な担い手は同じ)
2020〜2022 13〜60 / 年 5〜28 / 年 保守中心
2025 46 1 03-10・03-20 のリリース
2026(〜10 月) 276 311 ほぼ 7〜10 月の 4 か月分

(origin/develop のマージを除くコミット数。2026-10 時点)

  • 2026 年は、4 か月ほどで、過去の最も多かった年の 1 年分に並ぶか超えている
    (Open 棟梁は 2026-08 の 1 か月で 182、汎用認証サイトは 2026-09〜10 の 2 か月で 308)。
  • しかも、件数だけでなく中身も重い。差分の本体を読むと、セキュリティの修正・テストの拡充・設計文書の整備が大半を占める
    (詳細なリリース情報の未リリース区間。汎用認証サイトは約 27 万行の追加)。
  • つまり、コーディング・エージェントで同じ 1 名が、活発だった頃の数倍の速さで書けるようになった。

対応

  • 知識を、人ではなくリポジトリに置く(AGENTS.md・ANALYSIS.md・スキル・詳細なリリース情報)。
    担い手が替わっても、エージェントと一緒に引き継げるようにする。
  • リリースの手順を、スクリプトとエージェントの作業に落としている(リリース・エンジニアリング)。

残る課題

  • レビュー・検収の担い手。書く手はエージェントで増やせるが、検証する人は増やせない。
    ペースが上がった分だけ、検証が追い付かなくなる。
    develop → master の PR はレビュー 1 名が必須なので、ここが詰まるとリリースが止まる。
  • 利用者からのフィードバック(Issue・事例)を集める経路が細い。

6. 組織・マネジメント

外部の生成 AI の一覧には無かったが、開発基盤の横展開を妨げてきたのは、技術よりもこちらである。

  • 課題の多くは、ポートフォリオ・プログラム・マネジメントと、ステークホルダー・エンゲージメントの問題である
    (開発基盤を横展開する際の課題)。
  • コーディング・エージェントで、方式は対面の信頼関係が無くても浸透するようになった。
    残るのは、方式を決め、書き出し、検証するリードエンジニアを、組織がどう位置付けるかである(ソリューション提供のサポート)。

参考


Tags: 再構築

NetDevInfraWiki

マイクロソフト系技術情報 Wiki
Open 棟梁 Wiki
開発基盤部会 Wiki

移行管理: DONE / TODO

Clone this wiki locally