Page tree

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.

Step-by-step guide

How to use and enable visual graph of requirements

Adding Requirement

To add requirement use "..." next to Create button, there after find "Product Requirement for Clarity Map


On this page:

Table of Contents

Specifying properties

After confirming page creation you get confluence page that is done based on template inherited from standard confluence requirement blueprint

Properties relevant for Requirements Clarity map

Property nameDescriptionFormat, possible values
Short nameA title of the node for Clarity Map GraphChar : 15
DescriptionLong description of requirementText
Epiclink to Jira issue, presumably epic
ClarityHow clear is requirement. Defines fill color on Clarity Map Graph
  • UNKNOWN - requirement is terra incognita, you have no clue what is this. (fill color - black)
  • UNCERTAIN - you have some understanding of what is this, there are some areas that needs investigation, but general understanding is present (fill color - grey)
  • CLEAR - you understand fully what needs to be done, how that can be measured and how implementation can be checked. Requirement is ready to be assigned for development team with confidence of delivery (fill color - white)
SizeHow big is requirement. Defines size of the node on Clarity Map Graph. T-shirt size based qualification of size of requirement
  • XS - thesmallest
  • S
  • M
  • L
  • XL - the largest
StatusDefines status of this requirement. As soon as there is associated epic in Jira - Status is determined by status of linked issue, before that - status is not defined
  • NULL
  • OPEN
  • DONE
Question and AnswersOpen questions and answers for given requirementText

Image RemovedImage Added

Adding Requirement Graph

You go with "+" sign on control button bar and then " ...  Other macros", then select Requirement Clarity Map


Space Key Confluence key of the space where your requirements pages are located
Page TitleRoot of the tree where you want macros to start processing
  •  Show/ hide graph UI hints
Whether or not you want to enable hints on the map usage

Insert adds a graph to your confluence page

What you can see and what you can do with a graph



How clear is a requirement is defined by one of three choices

  • UNKNOWN - team doesn't understand what risks are there, what effort is required for this to be implemented
  • UNCERTAIN - team has some understanding of what this requirements is about. There are some unclear items that needs to be researched or investigated
  • CLEAR - team understands complexity of requirement, understands implementation steps, acceptance criteria are defined


Status of corresponding requirement is determined by status of associated Jira epic. In case no epic is yet created - status is NULL. On graph you can easily determine that by color of the bezel

titleUseful hint

Requirement Clarity Map macro needs Application Link between Confluence and Jira to get statuses. To make it work you have to authenticate yourself on Jira side.
The easiest way to do it is to add default “Jira” macro on a page and perform the authentication.


Ray diagram represent hierarchical structure of all requirements underneath provided root element. In sample case "Family"

+ / - signs are options to expand / collapse corresponding node


Selecting a node - opens property panel.

Following values are available for inline editing

  • Short name
  • Clarity
  • Size
  • Description
  • Questions and Answers

Timeline snapshots 

Coming soon


Content by Label
cqllabel in ("kb-how-to-article","release-notes") and type = "page" and space = "RCMD"

Page properties
Related issues