Requirements Development Plan Template
Requirements Development Plan Template
DEVELOPMENT
PLAN
TEMPLATE
VERSION 1.0
REQUIREMENTS DEVELOPMENT PLAN
This template was created to enable departments to more easily develop their project
plans. The Department of Technology, Consulting and Planning Division, created this
template based on its experiences. The template relies on industry best practices
combined with decades of experience on California state information technology
projects. The way it was structured is to enable a department to complete the
information related to its project without having to write background information
related to the discipline. A department may use as much or as little of the template as it
wishes.
Template Instructions:
Instructions for completing this template – written for the author of the project
plan - are encased in [ ] and the text is italicized and bolded.
Examples are provided as a guideline to the type of sample information presented
in each section and the text is italicized.
Boilerplate standard language for each section is written in the document font and
may be used or modified, as necessary.
A department’s project specific information goes within the brackets << >>.
Informational text is italicized within square brackets [ ] for informational purposes
to the person who has to create the plan and includes background information,
explanation, rationale, etc.
Page
8/8/2006
REQUIREMENTS DEVELOPMENT PLAN
APPROVAL SIGNATURES
CONTRACTOR DATE
<<Deliverable Owner>>
<<Signature>>
<<John Doe, Manager>>
<<SIGNATURE>> <<DATE>>
Comments
Page
8/8/2006
REQUIREMENTS DEVELOPMENT PLAN
DOCUMENT HISTORY
DOCUMENT APPROVAL HISTORY
Prepared By
Reviewed By
Page
8/8/2006
REQUIREMENTS DEVELOPMENT PLAN
TABLE OF CONTENTS
1. INTRODUCTION............................................................................................................................ 1
1.1. PURPOSE................................................................................................................................................. 1
1.2. SCOPE........................................................................................................................................................ 1
1.2.1. IN-SCOPE.................................................................................................................................................. 1
1.2.2. OUT-OF-SCOPE...................................................................................................................................... 2
1.3. RELATIONSHIP TO OTHER PROJECT PLANS..........................................................................2
1.4. DOCUMENT MAINTENANCE..........................................................................................................3
1.5. REFERENCES......................................................................................................................................... 4
Page
8/8/2006
REQUIREMENTS DEVELOPMENT PLAN
1. INTRODUCTION
1.1. PURPOSE
The purpose of the Requirements Development Plan is to describe the roles and responsibilities for
the <<Project Name>> Project requirements development effort and define the planning, activities,
and tasks that will be performed as part of this effort. The planning, activities, and tasks include:
planning how the activities will be performed (the processes), defining what approach will be taken
with various stakeholders and stakeholder groups or classes (groups/classes 1) to elicit their
requirements, identifying how the elicited requirements will be analyzed, and defining how the
requirements will be documented, reviewed, validated/approved, and controlled to form the initial
baseline set of Project requirements. The requirements referenced in this Plan are the
requirements that <<will/may>> be included within a Request for Proposals (RFP) 2, which are
generally referred to as stakeholder and system level requirements. For that reason, this Plan
complies with ISO/IEC/IEEE 15288-20083 instead of ISO/IEC/IEEE 12207-2008 as the former is a
Stakeholder/System-level Standard while the latter is a Software-level Standard.
A requirement is defined as, “A condition or capability that must be met or possessed by a system
or system component to satisfy a contract, standard, specification, or other formally imposed
documents” (IEEE 610.12-1990 [R2002]). Therefore, requirements identify, in objective terms, the
criteria that will be used to measure the success of the Project. The main objective or goal in
defining requirements is to communicate to the developing organization what the stakeholders
need.
1.2. SCOPE
1.2.1. IN-SCOPE
The scope of the processes, activities and tasks defined within this Requirements Development Plan
are the following items:
[Identify the list of items that will be included within the scope of this Plan. See below
for examples.]
The elicitations of requirements for the system from all stakeholders defined in the <<Project
Name>> Project Charter (or include a list of the stakeholders if a Project Plan or the Project
Charter, which may define this list, does not currently exist).
1
The term group/classes, or group/class is used intentionally within this document to be consistent with
industry standards and to express the idea that collections may consist of groups of humans and/or classes of
non-human objects, such as interfaces consisting of real time and batch interfaces which in themselves have
requirements.
2
The State may elect to assume responsibility for some of the requirements and not include them as part of
an RFP. Regardless, they are still Project Requirements and still need to be treated the same as those that are
the responsibility of a vendor.
3
While this Plan adheres to the ISO/IEC/IEEE Standard, the planning, activities, and tasks are more focused
on common sense, experience, and expertise gained from developing requirements for numerous major
systems.
Page of 21
REQUIREMENTS DEVELOPMENT PLAN
The Project Scope, as defined with the Feasibility Study Report (FSR) and Project Charter, shall
be used to limit the scope of the requirements documented in the output of the effort described
within this Plan. If a detailed Scope Statement does not exist, the scope must be defined in
detail in this section because it is essential to moving forwards with requirements
development.
1.2.2. OUT-OF-SCOPE
The following items are not within the scope of this Requirements Development Plan and are
therefore excluded:
[Provide a list of items that are related to Requirements Development but are not
included in this Plan. This includes those which may be identified in other Project
Plans, such as the following:]
The Requirements Management process, which defines the activities and tasks used to control
and manage changes to the baseline requirements, is not included within this Plan but is
documented in the Requirements Management Plan.
Page of 21
REQUIREMENTS DEVELOPMENT PLAN
[Describe how the activities, tasks, and resources necessary to perform this
effort will be documented and managed under Schedule Management. If a
Schedule Management Plan does not yet exist, describe how the Requirements
Development activities and tasks will be captured and documented in the
project schedule and how it will be maintained under the umbrella of Schedule
Management.]
Communications Management Plan
[If one exists, describe how the communications with the stakeholders will be
managed between the needs of this Plan and the communications described in
the Communications Management Plan.]
Governance Plan
Page of 21
REQUIREMENTS DEVELOPMENT PLAN
This document contains a Revision History Log. When changes occur, the version number will be
updated to the next increment and the date, change description, and the author who made the
change recorded in the Log.
1.5. REFERENCES
The following are references used in the creation of this Plan:
ISO/IEC 15288:2008(E), IEEE STD 15288-2008, Systems and software engineering - System
life cycle processes
[Only list the references that are actually used and cited within this document.]
Page of 21
REQUIREMENTS DEVELOPMENT PLAN
2.1.2. RESPONSIBILITY
Their responsibility is to understand the approach used to elicit the requirements from all of the
Stakeholders as well as the approach used to develop and finalize the requirements. Then, when
presented with the requirements, they will review a representative sample of the requirements to
provide the final level of assurance that the requirements will communicate the stakeholders’ needs
to any potential vendor. If the requirements are deficient, they will identify issues and problems
that need to be corrected. Once acceptable, the Executive Steering Committee will be responsible
for approving the Project requirements, which will then become baselined and fall under formal
Requirements Management control.
2.2.1.2 RESPONSIBILITY
The Executive Sponsor will provide the necessary support to the Project Manager to ensure that
resources are available to support the execution of this Plan and to provide the advocacy to all of
the internal and external units and organizations that are required to participate in the
requirements development effort.
2.2.2.2 RESPONSIBILITY
The Business Sponsor is responsible for ensuring that this Plan identifies an approach that will
addresses all of the organizational business users, their needs, and the organization’s business
support needs (e.g., Legal, IT Operations, Public Relations, etc.). The Business Sponsor also
provides advocacy to the business and support components of the organization to ensure that the
documented requirements will meet the overall organization’s needs. Ultimately, the Sponsors
(Business and Executive) are responsible for approving this Plan and ensuring that the activities
and tasks are executed by the Project Manager.
Page of 21
REQUIREMENTS DEVELOPMENT PLAN
2.3.2. RESPONSIBILITY
The Project Director is responsible for tracking the progress of the requirements development
effort, identifying significant deviations, and assisting the Project Manager in resolving obstacles,
issues, and problems in order to keep the effort on schedule without compromising the quality
(completeness, correctness, readability, etc.) of the resulting requirements.
2.4.2. RESPONSIBILITY
The Project Manager is responsible to work with the Requirements Development Lead to review
the requirements development approach, verify that all stakeholders are accounted for and the
planned elicitation approach appears sound for each, and ensure that the tools necessary to
develop, document, and maintain the requirements throughout the process are available. The
Project Manager will schedule the activities, tasks, and resources necessary to execute the effort
and monitor and track the execution. If obstacles, issues, or problems arise, the Project Manager
will either resolve them or escalate them to the Project Director or Sponsors for resolution.
2.5.2. RESPONSIBILITY
The Requirements Development Lead is responsible for executing all of the activities and tasks
within this Plan and complying with the planned process. The Lead will work with the Project
Manager to define and identify the resources needed to accomplish each activity and task, verify the
tools are available, and assist in the scheduling of the execution of the effort.
Page of 21
REQUIREMENTS DEVELOPMENT PLAN
2
Again, this is for planning purposes; the actual number of iterations and/or recursions will be determined
by the ability to elicit the requirements and the completeness obtained.
Page of 21
REQUIREMENTS DEVELOPMENT PLAN
Define Process
Data & Rules
Define Process
Requirements
Document
Processes
Document Process
Requirements
Document Process
Data & Rules
Stakeholder Interest
XYZ Unit As a user of the system, they have an interest in ensuring that the system
performs the XYZ functionality necessary for the unit to perform their business
function and that reports can be generated.
Chief Deputy As an Executive Sponsor, he/she has an interest in ensuring the Project cost,
3
While Figure 2 is not meant to imply a “Spiral” software development model, it does result in a similar effect
of reducing risk through each progressive spiral. In this case, it helps to reduce the risk that the requirements
will be incorrect or incomplete.
Page of 21
REQUIREMENTS DEVELOPMENT PLAN
Stakeholder Interest
Director schedule, quality, risks and issues are carefully monitored, managed, and that
…
Cashiering Unit …
IT Support Unit The IT Support unit has an interest in ensuring the system can be supportable
by the organization and that all artifacts delivered will be usable and
accurately reflect the procedures necessary to be supported by the units’
resources.
Enterprise The EA has an interest in ensuring the new system will meet the performance
Architect (EA) and other operational needs of the organization.
Training Office The Training Office has an interest in ensuring that the system documentation
and training material is developed, with appropriate tools available as
necessary to train all of the impacted stakeholders.
Project The PM has an interest in managing the execution of the Project and ensuring
Manager that there are sufficient artifacts created and delivered that will allow the
necessary tracking, managing, and reporting for the Project.
Etc. …
[Identify all of the stakeholders and their interests in the Project. Ensure you not only
look at the development effort but also the maintenance and operations and other
post-deployment users. If the Project developed a Product-based work breakdown
structure (WBS), this would be an excellent starting point for identifying these
stakeholders. Think about the notion that these stakeholders will be elicited for
requirements for their area of interest. However, do not identify specific products,
such as a System Administration Manual for the IT Unit, but focus on the types of
products and services. From a WBS perspective, this would be a level-2 or level-3 view
of the products and/or services.]
Page of 21
REQUIREMENTS DEVELOPMENT PLAN
[There are literally hundreds of techniques and methods that can be used to elicit
requirements, though most involve some form of an interviewing technique. Note that
not all techniques work well with all stakeholders; the Project must understand the
stakeholders and stakeholders classes/groups and identify an approach suitable for
the specific stakeholder or class/group. As an example, a top-down business process
model to detail user interactions, data, and rules might work well with specific
business users but this same approach would not work well for an Executive Sponsor
or the IT organization that may be maintaining the solution. For ideas, reference the
Page of 21
REQUIREMENTS DEVELOPMENT PLAN
[The Project needs to define the format and structure of the final elicited requirements
documents, which are the documents that will be provided to the requirements
analysis activity. This is important for a number of reasons: 1) it establishes a
common and consistent expectation of the types of data that must be collected for each
context area; 2) it supports the analysis activity and tasks by providing a consistent
input into the categorization and filtering of requirements defined in section ; 3) it
reduces the amount of re-writing that the analysis team will need to do to ensure
context and requirements sets are defined; and, 4) it simplifies the identification of
missing or incomplete requirement sets during both elicitation and analysis. While
the Use Case approach to documenting the final elicited requirements is identified
here, any artifact that keeps the requirements context with the set and types of
requirements elicited is sufficient.]
The final requirements document for each requirements context area will be documented in Use
Cases in accordance with the template provided in <<define where the template is located>>.
All of the requirement artifacts collected shall be stored in a secure repository, <<identify where>>.
The artifacts that will be captured will consist of all tools, techniques, diagrams, flow charts, photos,
documents, files, etc. that were used in the elicitation process. While some of these artifacts will be
used as reference later during the analysis activity, others will be formalized to define or support
Page of 21
REQUIREMENTS DEVELOPMENT PLAN
the requirements and will be incorporated into the final requirements document (e.g., the baseline
requirements document).
During the elicitation effort (as further defined in Section ), the collected requirements will not be
reviewed or analyzed in any way other than to ensure that the captured requirements are clear,
complete, and understandable. Section identifies the specific effort to analyze the requirements
based on the artifacts captured and stored.
To accomplish this purpose, the Requirements Development process defined within this Plan
includes the following elements:
o Including identifying1 stakeholders and stakeholder classes and working with them
to define the requirements.
1
The identification of stakeholders and stakeholder classes/groups was done in Section .
Page of 21
REQUIREMENTS DEVELOPMENT PLAN
“Identify the individual stakeholders or stakeholder classes who have a legitimate interest
in the system throughout its lifecycle”.
This task was identified under Requirements Development Planning, Section , to support the
planning for the overall Requirements Development effort, which must consider the number of
stakeholders that will be involved.
The other task under this activity is the actual elicitation effort, which can be viewed as the
execution of the planned activities and tasks of elicitation with the identified stakeholders and
stakeholder classes/groups.
Page of 21
REQUIREMENTS DEVELOPMENT PLAN
Page of 21
REQUIREMENTS DEVELOPMENT PLAN
[Identify the constraints on the system/solution. These constraints may come from a
variety of sources but are commonly identified within an FSR or other project approval
documents or from Departmental internal decisions. The constraints identified here
will be used as the “filters” when performing the requirements analysis effort and
therefore the more complete they are, the more useful they will be when reviewing the
requirements elicited. Typical and common examples include:
The system/solution must be hosted within the OTech Managed Services
environment.
Existing legacy system data exchange interfaces with external trading partners
shall not be modified or changed in any way.
The system/solution must be consistent with and use the operating systems,
databases, and programming languages currently supported by the
Department.]
4.2.2. DEFINE OPERATION AND SUPPORT ACTIVITY SEQUENCES
The following identifies operational and support scenarios that are out of the normal or routine
business processing flows. These scenarios aid in identifying additional system requirements
necessary to meet the unusual or non-routine needs of Project stakeholders. The intent of adding
these scenarios is to broaden the view of the requirements that need to be defined for the project.
[Define a representative set of operation and support scenarios. These are not
business process flows of other business-related scenarios. The objective of these
scenarios is to aid in potentially identifying requirements that may not have been
identified by any stakeholder or stakeholder group. Examples would include scenarios
related to availability of the system, especially around key periods such as the end-of-
the-month reporting, legal audits that may be performed, Public Record Act (PRA)
requests, public-facing attempts to hack the system, user interactions with the system
for training purposes, etc. These are primarily non-functional types of scenarios that
are looking at the system as a “black box”.
As an example:
Scenario X: The Department’s Legal Office (Source) has received a Public
Records Act request (Stimulus) for business license data. The system is in
normal operations mode (Environment Conditions) and the Legal Office
accesses the Reporting subsystem (System Artifact Involved) and generates a
Page of 21
REQUIREMENTS DEVELOPMENT PLAN
report (Response) that provides the requested data. The data included within
the report only includes data that is publicly releasable and complies with all
legal statutes (Response Measure).
From this sample, while the Legal Office may have been identified as a stakeholder,
this scenario is used to help ensure that all of the necessary requirements to cover
such a situation are identified.
While it may appear difficult to develop such scenarios, the best approach is to draw
the system as a box on a whiteboard and ask what could happen to the system, from
the operation and support perspectives and then from different stakeholders’
perspectives. Start with brief scenarios (e.g., “external hackers attempt to force a
denial-of services”, “regional power outage”, “major technology supplier goes out of
business”, “end-of-month and the system goes down”), and further elaborate on those
scenarios that appear reasonable or could potentially become real that the system
development needs to consider; never delete any identified scenario but simply archive
the ones that are not expanded. Document the resulting scenarios within this section.
Again, the objective is to try to find gaps in requirements that may be missed by
eliciting requirements from the stakeholders. By documenting the scenarios in this
section, additional attention will be focused on ensuring that the requirements
necessary are defined or, during analysis, gaps identified. This effort will never be
100% complete and perfect; however, the more gaps found early, the easier they can
be closed.]
4.2.3. IDENTIFY HUMAN-SYSTEM INTERACTIONS
The following identifies the high-level requirements for the interfaces between human users and
the system to be developed. Information systems have a significant human-to-system interface
(visual and well as manual) and the requirements for these interactions must be elicited and
documented.
[Included in this section are the usability requirements that must be considered for the
system. Typically, this is not a long list of items but for some systems there may be
unique human-system interactions that must be specified. An example of a typical
requirement for Web-accessible systems is a requirement for Section 508 (29 U.S.C.
‘794 d) and/or W3C Web Content Accessibility Guidelines 1.0 compliance. Other
examples may include different levels of training and/or resource skills available to
use, maintain, and operate the system. Identify either the human-system interaction
requirements or the approach that will be taken to identify these usability
requirements. Again, these are typically requirements that are missed when eliciting
requirements from the stakeholders.]
Page of 21
REQUIREMENTS DEVELOPMENT PLAN
Page of 21
REQUIREMENTS DEVELOPMENT PLAN
The initial requirement sets will then pass through another filter that reviews each individual
requirement to verify that the requirement text is well formed, meaning the requirement does not
use ambiguous words, it is complete, readable and correct (within the requirements set context),
and generally adheres to the controlling inputs, which are characteristics of individual
requirements defined in .
The results of this final filtering stage are sets of well-formed individual requirements, again with
the requirements context retained. Each set is then analyzed to verify that the set as a whole is well
formed, as defined in , and to identify missing requirements, conflicts between requirements within
the set, level-setting2 of requirements within the set, the identification of prioritizations, and other
attributes.
2
Level-setting of requirements simply means that the requirements within a set are specified at roughly the
same level of detail, except where necessary to be otherwise.
Page of 21
REQUIREMENTS DEVELOPMENT PLAN
[The Project should define the attributes that will be set at this step. Attributes are
simply a method for characterizing requirements, which can be used to support other
activities, such as testing for high priority or criticality requirements, or for reporting.
provides a sample list of potential attributes that should be considered.]
After this analysis, problems in the form of requirements gaps in completeness, conflicts or
inconsistency, affordability (not just from a cost perspective, but schedule, risk, M&O, etc.), scope,
etc. will be identified. These problems will be resolved with the stakeholder and stakeholder
class/group that provided the requirement for the requirement context identified with the
requirements set. If conflicts exist between stakeholders or stakeholder classes/groups, they will
be resolved in accordance with the method defined in Section . Once resolved, each requirement
set, including the requirements set context, will be reviewed per Section , and validated per
Section , with the stakeholder and stakeholder class/group that has a legitimate interest in the
requirements.
Once validated, the requirements sets, with all reference material will be baselined and provided to
the Requirements Management process to control per Sections and .
Page of 21
REQUIREMENTS DEVELOPMENT PLAN
This section must also identify how conflicts between stakeholders and stakeholder
classes/groups will be resolved.
Regardless of how the problems are resolved, the Project must identify that records
will be kept on how they were resolved and by whom or what the agreement was.]
4.3.3. PROVIDE FEEDBACK
[Sometimes agreements cannot be reached on conflicting requirements, unrealistic
requirements will not be changed, or continually requested requirements are beyond
the Project scope. The Project needs to define how these will be handled. If the Project
has an issue management or an escalation process in place, these might be cited.
However, if neither of these exists at this point in the Project, an approach must be
defined within this Plan.]
4.3.4. VALIDATE REQUIREMENTS
[Describe how the Project plans to validate the requirements. As stated previously, it is
important to keep requirement sets and their context together when performing any
requirements validation effort; validation should not be simply a review of a long list
of individual requirements as context adds significant value for understanding what is
specifically being required.
The most common way to validate requirements is by performing a series of
requirements reviews that are focused on the requirements context and the individual
requirements within that context. For example, a requirements review session context
may be for patient in-processing and all of the requirements related to this context will
be reviewed and validated. As always, issues or action items are likely to be generated
from these meetings so this section must define how these will be captured, tracked,
and resolved.
Finally, the sign-off or formal acceptance or approval of the requirements and issues
or action items must be described within this section; this sign-off or formal
acceptance or approval must be made by the stakeholders that have an interest in the
requirement context and the individual requirements documented.]
4.3.5. DOCUMENT REQUIREMENTS
[This section must identify the documentation that will be kept and maintained
throughout the requirements analysis effort, which will also end up being passed to
the Requirements Management process for tracking and controlling. While a Project
may consider keeping little documentation other than the final requirements, it is
important that the document necessary to support the attribute assessments, at a
minimum, be retained. For example, documentation related to the source of the
requirement(s), a requirements priority, issues related to a specific requirement such
Page of 21
REQUIREMENTS DEVELOPMENT PLAN
Page of 21
REQUIREMENTS DEVELOPMENT PLAN
Necessary
Implementation Free
Unambiguous
Consistent
Complete
Singular
Feasible
Traceable
Verifiable
5.2.6 Characteristics of a set of requirements
Complete
Consistent
Affordable (not cost-wise but within constraints)
Bounded
5.2.7 Requirement language criteria
Page of 21
REQUIREMENTS DEVELOPMENT PLAN
Identification
Stakeholder Priority
Dependency
Risk
Source
Rationale
Difficulty
5.2.8.2 Examples of requirements type attributes
Functional
Performance
Usability/Quality-in-Use
Interface
Design Constraint
Process
Non-Functional
Quality
Human Factors
Page of 21
REQUIREMENTS DEVELOPMENT PLAN
For COTS products, the requirements are defined in as-is terms with
respect to business processes and other organizational processes. One
of the most important requirements to put on contracts are the
Organizational Change requirements and one of the first deliverables
from the vendor should be the mapping of the as-is to the to-be
COTS processes, with the to-be processes an approval item. This deliverable
must be provided as early as possible but it must be complete, mapping
all of the critical steps, data collection elements, and all other critical
items from the as-is to the to-be process. This is needed early to support
the organizational change work that must be performed to prepare the
users for the change.
Page