開発ドキュメントの書き方を学ぶ公開講座|要求定義・設計書・トレーサビリティ | Qbook

カテゴリで絞り込む

トレンドワード

テストツール
more
AI仕様書インスペクションツール
テスト自動化ツール
テスト管理ツール
生成AIテスト設計ツール
テストケース生成ツール
Qbookについて
Facebook x

開発ドキュメントの残し方・つなげ方~形骸化と手戻りを防ぐ開発手法~

2日間開催
2日開催
開発ドキュメントの残し方・つなげ方~形骸化と手戻りを防ぐ開発手法~
この講座の概要

講座概要

想定受講者像

  • これから開発プロジェクトを始めるにあたり、何をドキュメントとして残せばよいか迷っている開発者の方
  • 設計書やテスト関連ドキュメントを書く際に、記載内容や粒度に自信が持てない方
  • 開発チームを率いる、または立ち上げようとしており、ドキュメントの方針を整えたい開発マネージャの方
  • ドキュメントが作りっぱなしになっており、参照しやすい管理の仕方を見直したい方
  • 手戻りや仕様変更に強い、保守性の高い開発の進め方を身につけたい方

「ドキュメントを作ったのに誰も見ない」「仕様変更のたびに手戻りが起きる」「何をどこまで書けばいいのかわからない」。開発では、こうした悩みがプロジェクトの品質を左右します。
本講座では、ソフトウェアの品質目標の考え方から出発し、要求定義・基本設計・詳細設計といった上流工程、そしてテスト計画・テスト設計といったテスト工程まで、各工程で作成するドキュメントのポイントと注意点を順に整理します。要求からテストまでのトレーサビリティを確保する考え方を、演習を交えて身につけます。

オンライン開催・1名から・拠点を問わず受講できます

解決できる課題

ドキュメントの記載内容が人によってばらつく、「ソースコードを見ないとわからない」ことが増えて属人化する、仕様変更のたびに手戻りが発生する、といった状況を、上流工程からテスト工程までの一連の流れとトレーサビリティの考え方に紐づけて整理します。

講座の目的

  • ソフトウェアの品質目標と品質特性を整理し、上流工程でのドキュメントレビューとトレーサビリティの重要性を理解する
  • 要求定義・基本設計・詳細設計の各ドキュメントに必要な情報と、その管理の考え方を押さえる
  • テスト工程の全体像から、テスト計画・テスト設計までのドキュメントのポイントを理解し、開発プロセス全体を一貫した視点で捉えられる状態にする

重点領域と学習範囲

上流工程からテスト工程までの各ドキュメントについて、「何を・なぜ・どこまで残すのか」を、演習を通して自分のプロジェクトに置き換えながら整理します。

  • ソフトウェアの品質目標と品質特性(品質を定める観点)
  • 開発プロセスの問題点と、上流・下流工程における品質管理の考え方
  • 要求定義書に必要な情報とポイント(演習)
  • 基本設計仕様書のポイントと、要求と機能を結ぶトレーサビリティの管理(演習)
  • 詳細設計書に記載すべき内容とその理由
  • テスト工程の全体像と、テスト計画で作成するドキュメント
  • テスト設計プロセスで作成するドキュメント(演習)

到達目標

  • ソフトウェアの品質目標を品質特性から整理し、リリースできる品質かを確認する観点を説明できる
  • 要求定義書・基本設計仕様書・詳細設計書に記載すべき内容と、その理由を説明できる
  • 要求から設計・テストまでのトレーサビリティを確保する進め方を整理できる
  • テスト計画・テスト設計で作成するドキュメントの内容を、自分のプロジェクトに当てはめて整理できる
  • 自分のプロジェクトのドキュメント一覧とトレーサビリティの管理方法を洗い出せる

こんな方におすすめ

これから開発プロジェクトを始める開発者や開発マネージャの方、内製開発を進めるうえで、ドキュメントに何をどのように残すべきか整理したい方に向けた講座です。上流工程からテスト工程まで、開発プロセス全体を通したドキュメントの考え方を、基礎から体系的に学びたい方に適しています。

本講座では、上流工程からテスト工程までのドキュメント作成のポイントを一連の流れとして押さえ、トレーサビリティを確保することで、手戻りに強く保守性の高い開発を行うための土台を整えます。
開催日程をご確認のうえ、要求からテストまでつながるドキュメントの作り方・管理の仕方を身につける機会として、ぜひ受講をご検討ください。

開催日程
お支払方法
銀行振込による前払い制となります。
お申込後、請求書を送付いたしますので、詳細をご確認いただき、お振込ください。
領収書について
領収書をご希望の際はお申込み完了後のメールに記載のURLよりお申込みください。
※ 領収書の発行にはお振込み時の控えを確認いたしますので、ご留意ください。
その他
本講座はWeb会議サービス「Zoom」で開催いたします。
講義資料は郵送にてお届けいたします。
進行次第で終了時間が前後する場合がございます。
カリキュラム
01

ソフトウェアの品質目標

リリースできる品質であることを確認するために、ソフトウェアの品質目標をどのような観点で定めるのかを、品質特性を通じて整理します。

扱うポイント
  • ソフトウェア品質の現状認識
  • リリースできる品質かを確認するための品質目標
  • 品質特性による品質目標の整理
02

開発プロセスと問題点

品質問題が発生するのはどのような場合かを起点に、上流工程と下流工程の品質管理の考え方を整理します。

扱うポイント
  • 品質問題が発生するケース
  • 上流工程と下流工程の品質管理の考え方
  • 上流工程でのドキュメントレビューの重要性
  • 上流工程と下流工程のトレーサビリティの重要性
03

上流工程のドキュメントと品質向上①要求定義

演習

ステークホルダーの「やりたいこと」を正しく確認し、システムに落とし込むために必要な情報を整理する、要求定義のポイントを学びます。

扱うポイント
  • 要求定義に必要な情報
  • ステークホルダーの「やりたいこと」の確認
  • 要求定義書に必要な考え方
  • 要求定義書に必要な情報を整理する演習
04

上流工程のドキュメントと品質向上②基本設計

演習

どの機能でどの要求を実現しているのかを整理し、手戻りや仕様変更に強い開発につなげる、基本設計仕様書の作り方と管理の仕方を学びます。

扱うポイント
  • 基本設計のポイント
  • 要求を機能に落とし込む際のトレーサビリティ
  • 基本設計仕様書の管理
  • 要求と機能を結ぶトレーサビリティを管理する演習
05

上流工程のドキュメントと品質向上③詳細設計

「ソースコードを見なければわからないこと」を減らすために、詳細設計書に記載すべき内容とその理由を整理します。

扱うポイント
  • 開発スタイルによる詳細設計の作成範囲の違い
  • 属人的で非効率な開発になる理由
  • 詳細設計書に記載すべき内容とその理由
06

テスト工程の全体像

上流工程から作り込んだ品質をテスト工程で検証するために、テスト工程の全体像と各工程のポイントを確認します。

扱うポイント
  • テスト工程の全体像
  • 各テスト工程におけるポイント
  • 工程内でのテストプロセス
07

テスト計画

テストプロセスの中でも最も重要と言えるテスト計画について、検討する内容とテスト計画書の記載内容を学びます。

扱うポイント
  • テストの目的や背景
  • テストアプローチの概要
  • テスト管理に必要な内容
  • テスト計画書の記載内容
08

テスト設計プロセスとドキュメント

演習

テスト計画に従って具体的なテスト内容を考えるテスト設計の流れと、作成するべきドキュメントを、バルテスが長年培ってきたノウハウとともに学びます。

扱うポイント
  • テスト設計の流れ
  • テスト設計で作成するべきドキュメント
  • テスト設計の流れとドキュメントを確認する演習
この講座へのお申し込みはこちら

よくあるご質問

問題ございません。

「何をドキュメントとして残せばよいか迷っている」「設計書やテスト関連ドキュメントの記載内容や粒度に自信が持てない」といった状態からご参加いただける内容です。ソフトウェアの品質目標の考え方から出発し、上流工程からテスト工程までのドキュメントを順に整理する構成のため、基礎から体系的に学びたい方に適しています。
開発者の方に加え、ドキュメントの方針や管理の仕方を見直したい開発マネージャの方も対象としています。

事前のご準備は不要です。

第1章で品質特性を通じてソフトウェアの品質目標を定める観点を整理し、第2章で上流工程と下流工程をつなぐトレーサビリティがなぜ重要なのかを扱います。そのうえで、第4章では要求と機能を結ぶトレーサビリティの管理を演習で確認します。
用語を覚えることよりも、どの機能でどの要求を実現しているのかを追える状態をつくる考え方を身につけていただくことを重視した構成です。

演習は第3章・第4章・第8章の3つのパートで実施します。
第3章では要求定義書に必要な情報とポイント、第4章では基本設計仕様書のポイントと要求と機能を結ぶトレーサビリティの管理、第8章ではテスト設計の流れと作成すべきドキュメントを、それぞれ演習で確認します。
各ドキュメントについて「何を・なぜ・どこまで残すのか」をご自身のプロジェクトに置き換えながら整理するため、演習で整理した要求定義・基本設計のアウトプットをそのまま持ち帰っていただけます。

要求定義書・基本設計仕様書・詳細設計書に記載すべき内容とその理由を説明でき、テスト計画・テスト設計で作成するドキュメントをご自身のプロジェクトに当てはめて整理できるようになります。
また、品質特性からリリースできる品質かを確認する観点を持ち、要求から設計・テストまでのトレーサビリティを確保する進め方を整理できるようになります。
受講後は、ご自身のプロジェクトのドキュメント一覧とトレーサビリティの管理方法を洗い出すところから、手戻りに強く保守性の高い開発に活かしていただけます。

要求の獲得から要件定義までをさらに深めたい方には「上流工程の勘所 ~要求の獲得・ヌケモレのない要件定義~」が、仕様変更に強い設計の考え方と設計判断を身につけたい方には「仕様変更に負けない! 手戻りのないソフトウェア設計」がおすすめです。

監修者紹介
江添 智之
この講座に込めた思い
ドキュメントは、作ること自体が目的になると形骸化し、かえって開発の負担になってしまいます。そうしたドキュメントはメンテナンスも不十分になり、いつの間にか実装とかけ離れてしまいます。私自身も開発プロジェクトの中で、ドキュメントの内容とプログラムの仕様が異なり、「これはどちらが正しいのか」と困った経験が何度もあります。 大切なのは、誰が・何のために・何を参照するのかを意識し、必要な情報を必要な形で残すことです。品質は、テスト工程だけでなく上流工程のドキュメントから作り込まれていきます。 本講座では、要求からテストまでをつなぐトレーサビリティの考え方を中心に、プロジェクトの品質を高めるドキュメントの作り方・管理の仕方をお伝えします。これから開発を始める方にも、進め方を見直したい方にも、ぜひご活用いただきたい講座です。
バルテス株式会社 R&C部 上席研究員
江添 智之 Tomoyuki Ezoe

WEB系、エンタープライズ系、医療系など様々な開発業務にプログラマ、システムエンジニア、プロジェクトリーダーとして携わった後、バルテスにてテストエンジニア・コンサルタント業務に従事。現職では主にテスト業務に関する研究開発および人材育成を担当し、社内外を含めて多くのプロジェクトでアジャイルコーチを行う。

江添 智之
バルテス株式会社 R&C部 上席研究員
江添 智之
Tomoyuki Ezoe

WEB系、エンタープライズ系、医療系など様々な開発業務にプログラマ、システムエンジニア、プロジェクトリーダーとして携わった後、バルテスにてテストエンジニア・コンサルタント業務に従事。現職では主にテスト業務に関する研究開発および人材育成を担当し、社内外を含めて多くのプロジェクトでアジャイルコーチを行う。

監修者一覧はこちら
この講座へのお申し込みはこちら
留意事項

講座当日について
※ 接続確認として、講座開始15分前からログインをお願いいたします。
※ ビデオ・写真の録画・撮影や、音声の録音はご遠慮ください。
※ 今後の講座運営に利用するため、運営側にて録音・録画を行う場合がございます。なお、参加者の音声・画像を外部公開することは一切ございません。
※ 講座資料の無断転載はご遠慮ください。
※ 参加者の通信環境や機器等による原因で視聴できなかった場合につきましては責任を負いかねます。

注意事項
※ お申込み後のキャンセルはお早めにご連絡をお願いいたします。また開催当日~1週間前のキャンセルとなる場合は、お申込金額全額をキャンセル料として頂戴致しますのでご了承ください。また当日欠席・遅刻によるご返金等は一切お受けしておりません。
※ 最少催行人数に満たない場合は、開催を中止することがありますので、ご了承願います。その際は、開催3日前までに、本ページおよびメールにてご連絡いたします。
※ 講座開催をWebサイト等を通じて報告等を行う場合がございます。その際に特定の個人がフォーカスされないように撮影した写真を掲載する場合がございます。予めご了承下さい。
※同業他社様からのお申込みはお断りをさせていただく場合がございます。予めご了承ください。
※ 本サービス申込者が下記に該当する場合、利用者として承認せずサービスを提供しない場合があります。その判断の理由については一切利用者に開示しません。また申込者は、判断の結果に対して異議を述べることはできません。

(1) 自らまたは第三者を利用して、当社の名誉や信用等を毀損し、もしくは毀損するおそれのある行為をした場合
(2) 自らまたは第三者を利用して当社の業務を妨害し、または妨害するおそれのある行為をした場合
(3) 当社に対して、自らまたは第三者を利用して、詐術、暴力的行為または脅迫的言辞を用いるなどした場合
(4) 申込者ならびに関係者が暴力団関係者ならびに反社会的勢力である旨が判明した場合

※ 自然災害、交通機関の事故、講師の発病等、不可抗力な事情により開催を中止することがあります。事前に中止が判明した場合は、本ページおよびメールにてお知らせいたします。各自でご確認ください。当日に中止が決まった場合は、本ページおよびメールと電話にてお知らせし、開催日の変更もしくは参加料の返金をいたします。 なお、旅費(航空券含む)や宿泊費とそれらのキャンセル諸費用については保証いたしません。

開催日の近い講座
開発ドキュメントの残し方・つなげ方~形骸化と手戻りを防ぐ開発手法~
    2日開催
こんな方におすすめ: 開発者、開発マネージャ、内製開発を進める方
開発ドキュメントの残し方・つなげ方~形骸化と手戻りを防ぐ開発手法~
AI駆動開発のレビュー入門~そのAI成果物、どうやって確認する?~
    2日開催
こんな方におすすめ: 開発者、QAエンジニア、テストリーダー、PM・PL
AI駆動開発のレビュー入門~そのAI成果物、どうやって確認する?~
AI時代のテストと品質 ~事例から学ぶ QA4AI・AI4QA~
    2日開催
こんな方におすすめ: QAエンジニア、テストリーダー、リリース判断に関わる管理者
AI時代のテストと品質 ~事例から学ぶ QA4AI・AI4QA~
実践 Microsoft 365 Copilot ~あなたの知らない使いこなし術を学ぼう~
    2日開催
こんな方におすすめ: 生成AI活用をこれから始める方、情報システム部、業務部門の担当者
実践 Microsoft 365 Copilot ~あなたの知らない使いこなし術を学ぼう~
仕様変更に負けない! 手戻りのないソフトウェア設計
    2日開催
こんな方におすすめ: 開発者、主に基本設計~詳細設計担当者
仕様変更に負けない! 手戻りのないソフトウェア設計
業界スキルを極めよ!JSTQB® CT-AuT資格対策
    1日開催
こんな方におすすめ: 自動車システムの開発者(テスト設計者、テストマネージャ、開発責任者、開発担当者など)​
業界スキルを極めよ!JSTQB® CT-AuT資格対策
アジャイル開発の品質管理とテスト自動化
    2日開催
こんな方におすすめ: 開発者、開発プロジェクト管理者、アジャイルテスト担当者
アジャイル開発の品質管理とテスト自動化
属人化から脱却!ヌケモレを防止できるテスト設計手法
    2日開催
こんな方におすすめ: 開発者、開発プロジェクト管理者、テスト担当者
属人化から脱却!ヌケモレを防止できるテスト設計手法
発注品質に効く!受け入れテストの勘所と開発委託の品質向上
    2日開催
こんな方におすすめ: 開発委託している企業・外部委託しているエンジニア
発注品質に効く!受け入れテストの勘所と開発委託の品質向上
すべてはここから!ソフトウェアの品質とテストの基本
    2日開催
こんな方におすすめ: テスト業務に関わる全ての方
すべてはここから!ソフトウェアの品質とテストの基本
新卒や若手におすすめ!ソフトウェアテスト入門
    2日開催
こんな方におすすめ: これからソフトウェアの開発やテストに携わる新入社員
新卒や若手におすすめ!ソフトウェアテスト入門
品質計画の立て方とソフトウェアメトリクス
    2日開催
こんな方におすすめ: 開発リーダ・品質管理・PMO・プロセス改善推進の方
品質計画の立て方とソフトウェアメトリクス
狭き門を突破せよ!JSTQB<sup>®</sup> ALTM合格への道!
    2日開催
こんな方におすすめ: JSTQB® ALTM資格の合格を目指す方
狭き門を突破せよ!JSTQB® ALTM合格への道!
上流工程の勘所 ~要求の獲得・ヌケモレのない要件定義~
    2日開催
こんな方におすすめ: 上流工程で品質を押さえたい開発エンジニア
上流工程の勘所 ~要求の獲得・ヌケモレのない要件定義~
開発工程で抑える!コードレビュー&ホワイトボックステスト
    2日開催
こんな方におすすめ: 開発担当者・ホワイトボックステスト業務に携わる方
開発工程で抑える!コードレビュー&ホワイトボックステスト
即戦力を育てる!若手プロジェクトリーダー養成
    2日開催
こんな方におすすめ: マネジメント力を養いたいエンジニア
即戦力を育てる!若手プロジェクトリーダー養成
バルテス直伝!シナリオテストの極意!
    2日開催
こんな方におすすめ: テスト設計に関わる方、シナリオテスト未経験の方
バルテス直伝!シナリオテストの極意!
リスクベースドテストを取り入れたテスト計画
    2日開催
こんな方におすすめ: リスクを考慮したテスト計画の立て方を身につけたい方
リスクベースドテストを取り入れたテスト計画
「不具合分析」と「なぜなぜ分析」
    2日開催
こんな方におすすめ: 管理者・リーダ・品質管理・改善推進などの方
「不具合分析」と「なぜなぜ分析」
もっと見る