yoshi seki

フリーランスエンジニアとして2013年2月から始めました。主に企業に常駐する仕事をしながら副業的にブログやお客様からの受注を受けております。エンジニア歴は15年以上です

【設計シリーズ】システム開発でよく使う設計書 TOP20

【設計シリーズ】システム開発でよく使う設計書 TOP20

2025/8/15  

システム開発の現場で必須となる設計書をTOP20ランキングでご紹介。開発の起点となる要件定義書から、品質保証のためのテスト仕様書、円滑な運用を支えるマニュアルまで。各ドキュメントの役割と重要性を簡潔に解説し、プロジェクト全体の流れを可視化します。エンジニアやPM必携の知識です。

【設計シリーズ:1】プロジェクトの成否はここで決まる。神の領域「要件定義書」を制覇する完全ガイド

【設計シリーズ:1】プロジェクトの成否はここで決まる。神の領域「要件定義書」を制覇する完全ガイド

2025/8/21  

なぜあなたのプロジェクトは炎上するのか?その根本原因「要件定義」を完全制覇するためのガイドです。失敗の本質から、具体的な書き方、明日から使える実践テクニック、スキルアップに役立つ書籍やツールまでを網羅。プロジェクトを成功に導く、全ての開発関係者必読のレポートです。

現代の羅針盤!プロジェクトを成功に導く「基本設計書」の真価と、価値を最大化する神ツール5選

【設計シリーズ:2】プロジェクトを成功に導く「基本設計書」の真価と、価値を最大化する神ツール5選

2025/8/15  

形骸化した設計書はもう卒業!DX時代の複雑なプロジェクトを成功に導く「生きた基本設計書」の真価を解き明かします。手戻りや認識齟齬をなくし、チームの生産性を劇的に向上させる、今すぐ使えるモダンな神ツール5選を具体的な活用シーンと共に徹底解説。

【設計シリーズ:3 】画面設計書 (画面レイアウト) ——— 開発現場の混沌を断ち切る「設計」の技術

【設計シリーズ:3 】画面設計書 (画面レイアウト) — 開発現場の混沌を断ち切る「設計」の技術

2025/8/15  

なぜあなたの画面は分かりにくいのか?開発現場の手戻りや混乱は「画面設計」の欠如が原因です。本レポートは、名著『設計シリーズ:3 画面設計書』を軸に、論理的で高品質な画面を生み出す設計技術を徹底解説。UI/UXの基礎から関連書籍まで網羅し、あなたの開発プロセスを変革します。感覚的なデザインから脱却し、誰からも信頼される設計スキルを身につけませんか?

【設計シリーズ:4】 テーブル定義書(ER図) - システムの魂を宿す「設計図」の描き方と、あなたを達人へと導く珠玉の武器

【設計シリーズ:4】 テーブル定義書(ER図) - システムの魂を宿す「設計図」の描き方と、あなたを達人へと導く珠玉の武器

2025/8/15  

なぜあなたのシステムは複雑化するのか?答えはDB設計にあります。この記事ではテーブル定義書とER図の描き方を基礎から解説。開発効率を劇的に上げる設計思想と、厳選した書籍・ツールも紹介。全エンジニア必読、システムの魂を宿すための設計バイブルです。

【設計シリーズ:5】 詳細設計書という名の羅針盤 - 品質の神は細部に宿り、未来はここから創造される

【設計シリーズ:5】 詳細設計書という名の羅針盤 - 品質の神は細部に宿り、未来はここから創造される

2025/8/15  

ソフトウェア開発の成否を分ける「詳細設計書」。アジャイル時代におけるその重要性を再定義し、技術的負債を防ぎ、チームの力を最大化する普遍的な原則を解説。品質と未来を創造する設計スキルを飛躍させる珠玉の推薦書籍5選も紹介する、全てのエンジニア必読の技術レポートです。

【設計シリーズ:6】品質を”設計”するテスト仕様書作成術と、あなたをプロに変える必読書5選

【設計シリーズ:6】品質を”設計”するテスト仕様書作成術と、あなたをプロに変える必読書5選

2025/8/15  

テスト仕様書作成を「作業」から「品質設計」へと変える。本書籍紹介なしのレポートでは、「とりあえず動く」文化から脱却し、品質を能動的に設計するための思考法を6ステップで徹底解説。エンジニアとしての市場価値を高める本質的なアプローチを提案します。

【設計シリーズ:7】開発現場の混沌を断ち切る、最強の羅針盤『設計シリーズ:7 API仕様書 (IF設計書)』とその活用術

【設計シリーズ:7】開発現場の混沌を断ち切る、最強の羅針盤『API仕様書』完全攻略ガイド

2025/8/15  

「信頼できるAPI仕様書」は、混沌とした開発現場の救世主です。本書は、仕様書の書き方からチーム文化への定着までを網羅し、プロジェクトの生産性を劇的に向上させるための実践的な戦略と戦術を解説する、全エンジニア必携の羅針盤です。

【設計シリーズ:8】 シーケンス図:システムの「振る舞い」を可視化し、開発を加速させる最強の武器

【設計シリーズ:8】 シーケンス図:システムの「振る舞い」を可視化し、開発を加速させる最強の武器

2025/8/15  

ソフトウェア開発の効率を劇的に向上させる「シーケンス図」を徹底解説!システムの振る舞いを可視化し、チームの認識齟齬や手戻りを防ぐための実践的な書き方、活用術を学びます。エンジニア必見のスキルアップ術と、厳選したおすすめ商品も紹介。

【設計シリーズ:9】 画面遷移図:開発の手戻りを防ぎ、プロジェクトを成功に導く「航海図」の描き方

【設計シリーズ:9】 画面遷移図:開発の手戻りを防ぎ、プロジェクトを成功に導く「航海図」の描き方

2025/8/15  

開発の手戻りや認識のズレ、防ぎたくありませんか?その鍵はプロジェクトの全体像を示す「画面遷移図」にあります。本稿では、画面遷移図の重要性から具体的な作成手順、FigmaやMiroなど最新のおすすめツール6選までを徹底解説。プロジェクトを成功に導く「航海図」の描き方がわかります。

【設計シリーズ:10】 システム構成図:ビジネスを加速させる「伝わる」設計書の描き方と最強ツール5選

【設計シリーズ:10】 システム構成図:ビジネスを加速させる「伝わる」設計書の描き方と最強ツール5選

2025/8/15  

「たかが構成図」と侮っていませんか?DX時代の複雑なシステム開発において、質の高いシステム構成図はプロジェクト成功の鍵です。本稿では「伝わる」構成図の描き方から、チームの生産性を劇的に向上させるCacoo、Lucidchartなど最新ツール5選までを徹底解説します。

【設計シリーズ:11】 クラス図 - システムの骨格を視覚化する設計の羅針盤

【設計シリーズ:11】 クラス図 - システムの骨格を視覚化する設計の羅針盤

2025/8/15  

【設計シリーズ:11】クラス図の基本から、テキストで作図できるMermaidでの書き方を横書きサンプル付きで解説。チーム開発を加速させる作図ツールCacooの魅力や、Mermaidとの賢い使い分けも紹介。システムの骨格設計をマスターし、設計の質を高めましょう。

【設計シリーズ:12】 運用マニュアル "生きた"ドキュメントを実現する構成図

【設計シリーズ:12】 運用マニュアル "生きた"ドキュメントを実現する構成図

2025/8/15  

形骸化しがちな運用マニュアルを、"生きたドキュメント"に変える方法を解説します。Mermaidを使い、障害対応フローやシステム構成図をコードで管理する『Docs as Code』を実践。コピー&ペーストで使える5つの構成図サンプルを提示し、チームでの共同作業を加速させる作図ツールCacooの活用法も紹介します。

【設計シリーズ:13】 WBS (作業分解構成図) - プロジェクト成功の羅針盤をMermaidで描く

【設計シリーズ:13】 WBS (作業分解構成図) - プロジェクト成功の羅針盤をMermaidで描く

2025/8/15  

プロジェクト管理の要、WBS(作業分解構成図)を徹底解説。巨大なプロジェクトを管理可能なタスクに分解し、抜け漏れや手戻りを防ぐ手法を学びます。ウェブ制作やイベント運営に使えるMermaid形式の実践的なサンプル付きで、計画立案の質を向上させます。

【設計シリーズ:14】 バッチ処理設計書

【設計シリーズ:14】 バッチ処理設計書

2025/8/15  

システムの安定稼働に不可欠な「バッチ処理設計書」の書き方を網羅的に解説。設計書の目的や構成要素から、Mermaidを用いたフロー図のサンプルまでを詳述し、開発・運用・保守の全工程で役立つ、質の高いドキュメント作成を支援します。

【設計シリーズ:15】 非機能要件定義書 ― システムの「品質」を設計する羅針盤

【設計シリーズ:15】 非機能要件定義書 ― システムの「品質」を設計する羅針盤

2025/8/15  

システムの「品質」を左右する非機能要件。本書では、可用性、性能、セキュリティ等の要件定義について、具体的な指標や実践的プロセスをMermaid図を交えて網羅的に解説します。プロジェクト成功に不可欠な羅針盤です。

【設計シリーズ:16】 ユースケース図 ~システムの振る舞いを可視化する最初のステップ~

【設計シリーズ:16】 ユースケース図 ~システムの振る舞いを可視化する最初のステップ~

2025/8/15  

システム開発の要件定義で不可欠な「ユースケース図」を徹底解説。アクターやユースケース等の基本から、include/extend関係、実践的な作図手順までを網羅。Mermaid形式のサンプルコード付きで、誰でもすぐ活用できる実用的なガイドです。

【設計シリーズ:17】 機能一覧 ― プロジェクトの羅針盤を創る技術

【設計シリーズ:17】 機能一覧 ― プロジェクトの羅針盤を創る技術

2025/8/15  

システム開発の成功に不可欠な設計図、「機能一覧」。その重要性から、具体的な作成ステップ、品質を高める運用方法までを網羅的に解説します。プロジェクトの羅針盤となるこのドキュメントを使いこなし、開発を成功に導くための実践的ガイドです。

【設計シリーズ:18】 帳票設計書

【設計シリーズ:18】 帳票設計書

2025/8/15  

システム開発における「帳票設計書」の包括的ガイド。その重要性から、具体的な作成プロセス、品質を高めるための実践的ポイントまでを網羅的に解説します。Mermaidによるデータフローの可視化や、すぐに使える請求書のサンプルも掲載しています

【設計シリーズ:19】 コーディング規約

【設計シリーズ:19】 コーディング規約

2025/8/15  

コーディング規約の重要性から、具体的な策定・導入プロセス、形骸化させない運用方法までを解説。品質、保守性、生産性を向上させ、チーム開発を円滑にするための実践的ガイドです。Mermaid形式の構成図で視覚的にも分かりやすくまとめています。