Repository navigation
OTR_CurrentChallenges
nishi_74322014 edited this page Oct 28, 2026
·
12 revisions
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 | 組織・マネジメント | 展開する組織 | 技術では解決しない。リードエンジニアの位置付けの問題 |
実態
- 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 のライフサイクルに従ってサポートされるので、利用者の既存資産がある限り続く。 - 片方にしか無い機能が増えると、「同じ方式で書ける」という前提が崩れていく。差を一覧で管理する必要がある。
実態
主に汎用認証サイトの課題で、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 を非推奨、パスワードからの鍵の導出を修正など |
- 詳細は 詳細なリリース情報(03-00〜) と 詳細なリリース情報(汎用認証サイト) を参照。
対応
- 仕様との差を、エージェントに適合性の分析(
ANALYSIS-IdP.md)として洗い出させ、項目ごとに Issue にして直す、という進め方を取っている。 - 直した振る舞いは、E2E テスト(3 方言の DB)で回帰を検知する。
- 汎用的な部品は、汎用認証サイトから Open 棟梁へ移している(OTR #634)。
残る課題
-
適合性テストの仕組みが無い(D-14。OpenID Foundation の Conformance Suite を回す手順)。
自前のテストでは、仕様の読み違いをそのまま正しいと判定してしまう。 - 修正の多くは後方互換性に影響する(
subの値、redirect_uriの比較、署名の既定、暗号文など)。
利用者の移行の手間が増えるので、リリース情報で後方互換性を明示し続ける必要がある。 - 仕様は今後も変わる。追従を続けられるかは、5 の担い手の問題でもある。
実態
- 規約・多層構造・定型コードが、エージェントにとっても「スロット」として働くか、が問われている。
- 外部の調査では、エージェントは学習データに少ない固有の API が苦手で、文書を渡すだけでは足りない
(標準化フレームワークの習得の需給とコーディング・エージェント)。
対応
- 方式を、エージェントが読める形で書き出している。
- リポジトリの
AGENTS.md・CODING.md・領域ごとのANALYSIS.md(19 個)。 - エージェント用スキル(OpenTouryoCodingAgentAssets)。常に載せるインストラクションと、必要なときだけ読まれるスキルに分けている。
- リポジトリの
- 開発者(エージェント)が触る固有の API を、
UOC_メソッドなどのスロットに絞っている(コーディング・エージェント時代の開発基盤)。
残る課題
- 効果は、Open 棟梁を使った案件ではまだ計測していない(開発基盤のKPIとKGI)。
フレームワーク自体の開発では、更新のペースが大きく上がった(5 を参照)。 - スキルは、フレームワークの版が上がるたびに古くなる。版の差分(詳細なリリース情報)からスキルを直す流れを作る必要がある。
実態
- 厳格な層構造・共通処理・設定ファイル・独自の実装パターンがあり、参画する開発者にとって学習コストが高い。
- 加えて、標準化フレームワークは他の案件で出会う確率が低いので、技術者に習得を敬遠されてきた(需給の問題)。
対応
-
覚える人を絞る:方式を決めて検証するリードエンジニア・纏め者が深く理解し、スロットを埋める作業はエージェントに任せる
(標準化フレームワークの習得の需給とコーディング・エージェント)。 -
文書をリポジトリの中に置き、エージェントと一緒に保守する:
ANALYSIS.md・TESTING.md・CONFIGURATION.mdなど(汎用認証サイトの作業中ブランチでは、設計の経緯をDesignNotes/に分けている)。
コードの変更と同じ PR で文書も直すので、ずれにくい。 - 利用者向けの情報は、この Wiki(使い方・リリース)と、GitHub の Wiki(チュートリアル)に分けている。
残る課題
- AI に任せるほど、人の理解は落ちる、という調査がある。検証できる人を育てる仕組みが別に要る。
- GitHub の Wiki(チュートリアル)と、リポジトリ内の文書・この Wiki の間で、内容がずれうる。
外部の生成 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・事例)を集める経路が細い。
外部の生成 AI の一覧には無かったが、開発基盤の横展開を妨げてきたのは、技術よりもこちらである。
- 課題の多くは、ポートフォリオ・プログラム・マネジメントと、ステークホルダー・エンゲージメントの問題である
(開発基盤を横展開する際の課題)。 - コーディング・エージェントで、方式は対面の信頼関係が無くても浸透するようになった。
残るのは、方式を決め、書き出し、検証するリードエンジニアを、組織がどう位置付けるかである(ソリューション提供のサポート)。
- コーディング・エージェント時代の開発基盤
- 標準化フレームワークの習得の需給とコーディング・エージェント
- 開発基盤を横展開する際の課題
- リリース
- リポジトリ内の文書:OpenTouryo の
root/programs/CS/Frameworks/ANALYSIS.md、MultiPurposeAuthSite のroot/programs/ANALYSIS-IdP.md
Tags: 再構築
このWikiは「Open棟梁Project」,「OSSコンソーシアム 開発基盤部会」によって運営されています。