次の担当者が使える形で書き残す
構築した人に電話しなくても自社の担当者が運用できるよう、引き継ぎ資料、運用手順書、マニュアルを整えます。
14部門を支える共通インフラ計画
研究機関の14部門に関わるインフラ全体の枠組みを設計。柔軟なモジュール、統一されたデータパイプライン、長期的な定着を支える体系的なサポート方針を備えた。
研究機関の14部門に共通する包括的なインフラの枠組みを設計。モジュール構成、統一されたデータパイプライン、支援方針を備えた。
マニュアル付きPower BIプロジェクト8件を提供
Microsoft Power BIをNodeJS APIとPython FastAPIに連携させ、データ分析と可視化のための8件のPower BIプロジェクトを、詳しいマニュアルとともに納品した。
Node.js API・Python FastAPIによるPower BI分析8プロジェクトを完全なマニュアルとともに提供し、レポート作成効率を60%向上させた。
50,000語のソフトウェア文書を執筆
GitHub、Craft、ConfluenceでMarkdownを使い、50,000語の詳しいソフトウェア文書を執筆。知識の蓄積と工程の透明性を確保した。
GitHub、Craft、Confluenceに50,000語のソフトウェア文書を書き、知識を継続的に残し、透明性と監査可能性を確保した。
APIを100%の一致でHuma v2へ移行
HTTP APIの649パス・760操作をFiberからHuma v2へ移行し、サーバーが登録するルートと公開するOpenAPI記述の100%一致を達成・維持した。
649パス・760操作のHTTP APIをFiberからHuma v2へ移行し、登録ルートと公開OpenAPI記述を100%一致させた。
go‑taskの自動化ターゲット578個を作成
ネイティブ、Docker、HTTPSの開発モード、静的検査、テスト、データベース、デプロイをカバーする、go‑taskの自動化ターゲット578個を作成した。
ネイティブ、Docker、HTTPSの各モードにまたがるgo-taskターゲット578個を作成し、静的検査、テスト、DB、デプロイを1つのツール群で扱えるようにした。
268検査を持つリポジトリの検査基盤を構築
登録済みコミット検査268件、静的検査ルール277件、独自ESLintルール15件からなるリポジトリの検査基盤と、検査自体を試す146件のテストを構築し、人のレビューだけに頼らずビルドで基準を守るようにした。
268件のコミット検査、277件の静的検査ルール、15件の独自ESLintルールと、検査自体の146テストを持つ検査基盤を構築した。
継続的なセキュリティ検査を運用
コード検査、DAST、依存関係・脆弱性検査、SBOM生成、秘密情報検査、SHA固定のActionsと、21件の文書によるセキュリティ監査を組み合わせた継続的なセキュリティ活動を確立した。
コード検査、DAST、依存関係検査、SBOM、秘密情報検査、固定版Actionsを用いる継続的なセキュリティ活動と、21件の監査を実施した。
読み取り専用のホストレポートロールを7個構築
事実、アクセス、git、指標、トラフィック、セキュリティ、プロバイダー資産を、稼働ホストからMarkdownにまとめる7個の読み取り専用レポートロールを構築し、実行で測定していない数値は出力しない規則を設けた。
必要に応じリポジトリから環境を説明でき、無効な安全策2件、未宣言ポート、最後に回収した時点までしかトラフィックの保管がないことを発見した。最後の限界には、回収の間にローテーションで失い、どこにも存在しない1サイトの16日分という具体的な損失も記した。
認証情報漏出後に対象範囲の規則を記述
構成変更によって別会社の資産一覧、ファイアウォール許可、文章が混入したことを受け、リポジトリの対象範囲を定める規則を記述し、隔離した残存物も除外せず秘密情報検査の対象に残した。
範囲の境界は判断基準付きの規則となり、残存物は埋もれず見え、漏れた具体的な形態はコミットを失敗させるようになった。一般的な教訓も記した。危険な成果物は実行するものより、誰も二度と読まない、実行しないものにある。
22静的検査のコミットゲートを構築
HTML、CSS、JavaScript、Python、YAML、Markdown、Shell、リンク、綴り、秘密情報、組版を対象に、1行で説明できる検査22個と詳しい説明が必要な検査5個からなるコミットゲートを構築し、警告扱いや行内抑制を認めない方針にした。
コミット前に機械が定型的な異議を出し、このプロジェクト唯一のレビュー担当となった。コミットは遅く、出来の悪い検査への対応には強い苛立ちがあるという費用も隠さず記した。そのため後に、検査自体を整形・静的検査の対象にした。
51件の文書化した施策として開発を運営
54件の計画文書にわたる51件の施策としてサイト開発を進め、それぞれに未完了項目、測定結果、採用しなかった判断を記録。AIエージェント対応で見つかった8件中6件も、理由を記して見送った。
理由付きの51判断が残り、約4分の3が完了し、見送りも採用と同じように取り出せるようになった。小さな仕事でも文書を要する実際の負担があり、ときには変更より記録のほうが長くなった。
文書を独自の静的検査で管理
文書に、引き下げのみ可能なファイル別行数上限、目次要件、実在パス検査を設けた。完了扱いの9計画中6計画に未完了項目があり、コミットを制御する14タスクがどの文書にも記載されていないことを検出した。
計約2,666実効行の26文書が、増やせない予算下に入り、全パスと記号を実ツリーに照合するようになった。毎コミットを止める14検査が一切記載されていなかったという、機械の規則と人が読む規則の分離こそ、繰り返す価値のある不都合な発見だった。
PDF/UA‑1プロファイルの106項目中106項目に合格
9文書のPDF/UA‑1検証を記録し、設定済みアクセシビリティプロファイルの検査106項目中106項目に合格した一方、アーカイブ版は146規則のうち1項目で不合格だった。
設定したアクセシビリティプロファイルの検査はすべて合格した。保存用は具体的な不足を持つ僅かな未達として率直に示した。両数値とも1つの検証器の結果で、別実装は異なる可能性があり、合格はその検査器が指摘しなかった証拠にとどまるという限界も明確にした。
フックと品質ゲートの不一致を発見
同じ検査を行うという文書の記述に反し、コミットフックと品質ゲートが異なる検査を行っていたことを、一覧を比較するテストで発見。手動でしか動かなかった5個は履歴書の文章を検査するものだった。
同じ検査を実行することを実証し、文章の検査も毎コミットで動くようになった。内容増加とともにフック時間も増え、遅すぎれば迂回される地点があるため、この修正の寿命は検査の速さにかかっている。
言語間の数値照合を構築
英語原文にある数値の欠落と、対象言語に合わない表記で失敗する言語間コンテンツ検査を構築し、指標が抜けたデンマーク語説明2件と英語式引用符を使うウクライナ語16箇所を検出した。
18の実際の不備を解消し、今後もコミット前に原文比較することで種類ごと閉じた。ただし意味は判断できない。数字が残り句読点がその言語のものでも、主張の向きを逆にした訳は正常に通る。
全FFI呼び出しを検証する構文解析器を作成
手書きの仮Cヘッダーで、削除済みの3関数を呼んでもコンパイル・リンクが通り実行時に落ちた問題を受け、実際の7,308行のCヘッダーを読み、全呼び出し箇所、列挙定数、ポインター所有クラスのfinal指定を検証する構文解析器を作成した。
古い参照は実行時でなくビルド時に失敗するため、元のクラッシュの種類を防げる。限界は宣言を理解しても意味は理解しないことであり、同名・同シグネチャのまま上流が意味や所有規則を変えても、無指摘で通る。
利用者を責めないエラーメッセージに改訂
実際にはプロバイダーがアプリ専用パスワードを要求していたのに、サインイン拒否を利用者の入力誤りとするエラー表示を受け、文書化した文体基準に従ってメッセージを書き直し、プロバイダー名を明示するテストを加えた。
エラーは基準に従い、契機の例は旧文で失敗する試験を持った。ただし基準はレビューと1文の1試験で守られ、他の特殊要件を持つ事業者に同じ試験はない。範囲拡大は未解決で、種類ごと閉じたのでなく文書化した状態である。
4リポジトリで共通の履歴基準を維持
4つのリポジトリに対し、Conventional Commits、絵文字禁止、帰属トレーラー禁止という共通の履歴基準をコミットメッセージフックで適用し、作業方法を定める48件の指示文書とともに運用した。
4リポジトリが共通の履歴形式と指示構造を、規律でなくフックで共有した。ただし形式だけを見て内容は見ないため、何も説明しない適合件名も、変更を説明する件名と同じように通る。良い履歴そのものを保証するものではない。
6収集処理が省略した入力を明示
6つのレポート収集処理が、未読ファイル、未導入の検査、認識できなかったjournal行など、読み取れなかった入力範囲を明示するよう変更。収集不能と正常なホストが同じページになると確認し、116件の実測サンプルから閾値を定めた。
数値ページに結果と死角が並ぶようになった。自己測定は品質ゲートではなく、時間上限もないため2倍になっても見えるだけで止めないと明記した。上限には実ホストの基準が必要で、今回意図的に創作しなかった。既存のしきい値は日平均に適用されるため、1分間のピークが平均に埋もれることがある。