Page Comparison

...

Principle sets can be created to accommodate different team archetypes (e.g. cross-functional, flow-to-work, service, platform, etc).

Examples of principles and principle sets

Individual/Role/General Principle Set

• X layers from the CEO

• Role diversity (individual) and total role diversity (organisation)

Team/Squad Principle Set

• Between X & Y members (e.g. 5-9), full or part-time

• Location e.g. same city, same building, same floor, timezone, if distributed - no more than X locations

• Specific and/or dedicated roles included e.g. Scrum Master or Product Owner, etc

• Number of line managers

Group/Tribe/'Team of Teams' Principle Set

• Maximum number of individuals e.g. 150

• Maximum number of teams/squads

• Specific and/or dedicated roles e.g. Tribe Lead, Group Performance Lead, etc

Domain/Business Unit Principle Set

• Maximum number of individuals e.g. 500

• Maximum number of groups/tribes/'teeam of teams' e.g. 7

Configuring Principles

Principles are enabled in a workspace by default, but can also be toggled off via settings / workspace feature toggles

...

Default principle sets can be defined per team type via Settings / Org Structure type config. Select a team type, then choose a preferred principle set for that team type.

...

JSON parameters for Principles:

Member Count

^parameter maxMembers(optional), minMembers(optional)

...

      {
          "type": "MEMBER_COUNT",
          "args": {
              "maxMembers": 10,
              "minMembers": 5
          }
      }

Total Member Count

^parameter maxMembers

^title Should consist of no more than ${maxMembers} direct and indirect members.

    {
        "type": "TOTAL_MEMBER_COUNT",
        "args": {
            "maxMembers": 150
        }
    }

Spread

^parameter maxTeamsPerMember, teamType

...

  {
        "type": "SPREAD",
        "args": {
            "maxTeamsPerMember": 1,
            "teamType": "design"
        }
    }

Role Spread

^parameter role, roleDisplayName, limit, teamType, teamDisplayname, roleTagType, roleTagAttribute

^title ${roleDisplayName} should work in no more than ${limit} {teamTypeDisplayName}

    {
        "type": "ROLE_SPREAD",
        "args": {
            "role": "(.*product.*owner)",
            "roleDisplayName": "Product Owner",
            "limit": 1,
            "teamTypeDisplayName": "Agile Team",
            "teamType": "(group|team)"
        }
    }

Ownership

^parameter maxTeamsPerMember, teamType

^title Should have 1 ${ownershipRoleDisplayName}.

consist of between 1 and Also supports signal overrides.

See Role Tag Parameters for details on the roleTagType and roleTagAttribute parameters.

Role Count

^parameter role, roleDisplayName, limit, teamType, teamDisplayname, roleTagType, roleTagAttribute

^title ${roleDisplayName} should work in no more than ${limit} $ {ownershipRoleDisplayNameteamTypeDisplayName} .

Note: Ownership Role references Job Title (jobTitle) and the SPECIALIST Tag type (tagType) for a person. If either match, it will be seen as meeting the principle. (uses Regex - more examples below)

...

    {
        "type": "OWNERSHIPROLE_COUNT",
        "args": {
            "ownershipRoleDisplayNamerole": "Product Owner(.*product.*owner)",
            "limitroleDisplayName": 1"Product Owner",
            "ownershipRolemin": "(.*product.*owner)"1,
        }     }

Locality

^parameter maxLocations

^title Where teams are distributed it will be across no more than ${maxLocations} premises

      {"max": 10,
            "typeteamTypeDisplayName": "LOCALITYAgile Team",
            "argsteamType": {
              "maxLocations": 1
 "(group|team)"
        }
 
    }

Line Manager Count

^parameter maxManagers

^title Team should have no more than ${maxManagers} line managers.Also supports signal overrides.

See Role Tag Parameters for details on the roleTagType and roleTagAttribute parameters.

Ownership

^parameter maxTeamsPerMember, teamType

^title Should have 1 ${ownershipRoleDisplayName}.

consist of between 1 and ${limit} ${ownershipRoleDisplayName}.

Note: Ownership Role references Job Title (jobTitle) and the SPECIALIST Tag type (tagType) for a person. If either match, it will be seen as meeting the principle. (uses Regex - more examples below)

      {
          "type": "LINE_MANAGER_COUNTOWNERSHIP",
 
        "args": {
            "ownershipRoleDisplayName": "Product Owner",
            "maxManagerslimit": 51,
            }"ownershipRole": "(.*product.*owner)"
        }
    }

...

Locality

^parameter requiredTags,

^title Each team member should have a required set of tags.

Note: needs verifying by a dev (update this is only used by 1 customer so might not be something we use more broadly with a common set of needs(maxLocations

^title Where teams are distributed it will be across no more than ${maxLocations} premises

      {
          "type": "ROLE_CONFORMITYLOCALITY",
          "args": {
              "requiredTagsmaxLocations": [1
          }
       "tag", "tag", "tag"}

Field Match

^parameters field,metric,min,max,roleTagType,roleTagAttribute

^title Count of people that have matching values for a specifid field by number or by ratio

      {
        "type": "FIELD_MATCH",
 ]       "args": {
  }        }

Role Diversity

^parameter requiredRoles,

^title Each team should have ${minCount}{Role}

Note: requiredRoles references Job Title (jobTitle) and the SPECIALIST Tag type (tagType) for a person. If either match, it will be seen as meeting the principle. (uses Regex - more examples below)

    {"field": "country",
          "min": 80,
             "typemax": "ROLE_DIVERSITY"100,
          "argsmetric": {"ratio"
          }
 "requiredRoles": [    }

In the above, if there are any values for the country field where less than 80% of people have a matching value the principle evaluation fails.

      {
        {
"type": "FIELD_MATCH",
        "args": {
          "rolefield": "Product Ownercountry",
          "min": 8,
          "minCountmax": 1
                },
            10,
   {                     "role"metric": "Devops Engineercount",
        }
           "minCount": 1
                },
                {
 }

In the above, if there are any values for the country field where less than 8 or more than 10 people have a matching value the principle evaluation fails.

Also supports signal overrides.

See Role Tag Parameters for details on the roleTagType and roleTagAttribute parameters.

Line Manager Count

^parameter maxManagers

^title Team should have no more than ${maxManagers} line managers.

        {
          "roletype": "UX/DesignerLINE_MANAGER_COUNT",
                    "minCount"args": 1{
              "maxManagers": 5
},          }
      {
                    "role": "Senior Software Engineer",
}

Role Conformity (TBD)

^parameter requiredTags,

^title Each team member should have a required set of tags.

Note: needs verifying by a dev (update this is only used by 1 customer so might not be something we use more broadly with a common set of needs(

      {
          "type": "ROLE_CONFORMITY",
       "minCount": 1  "args": {
             },                 {
 "requiredTags": [
                  "roletag":, "Software Engineertag", "tag"
                ]
  "minCount": 3          }
      }
            ]
        }
    }

^parameter roleTagType,

Note: roleTagType references tag type for the requiredRoles. This defaults to SPECIALIST.

Total Role Diversity

^parameter requiredRoles

...

Role Diversity

^parameter requiredRoles,

^title Each team should have ${minCount}{Role}

Note: requiredRoles references Job Title (jobTitle) and the SPECIALIST Tag type (tagType) for a person. If either match, it will be seen as meeting the principle. (uses Regex - more examples below)

    {
        "type": "TOTAL_ROLE_DIVERSITY",
        "args": {
            "requiredRoles": [
                {
                    "role": "DataProduct TechnicianOwner",
                    "minCount": 1
                },
                {
                    "role": "FieldDevops TechnicianEngineer",
                    "minCount": 1
                },
                {
                    "role": "Field EngineerUX/Designer",
                    "minCount": 31
                },
                {
                    "role": "ElectricalSenior Software Engineer",
                    "minCount": 31
                },
            ]    {
    }      }

Same City Co-located (incomplete)

^parameter null

^title All members in the same city should work at the same address.

      {    "role": "Software Engineer",
  type: "SAME_CITY_COLOCATED",         args: {}       }

Child Team Count

^parameter maxTeams, minTeams, subGroupName

^title Should consist of no more than ${maxTeams} direct ${subGroupName}.

Should consist of at least ${minTeams} direct ${subGroupName}.

...

"minCount": 3
                }
            ]
        }
    }

^parameter roleTagType,

Note: roleTagType references tag type for the requiredRoles. This defaults to SPECIALIST.

Total Role Diversity

^parameter requiredRoles

^title Team should be cross-functional and include the following capabilities:${requiredRoles}

      {
          "type": "CHILDTOTAL_TEAMROLE_COUNTDIVERSITY",
          "args": {
 
            "maxTeamsrequiredRoles": 15,
[
             "minTeams": 1  {
        }       }

Direct Workforce Count

^parameter minCount, companyNames

^title Should consist of at least ${minCount} direct workforce members

      {
"role": "Data Technician",
         "type": "DIRECT_WORKFORCE_COUNT",
          "argsminCount": {1
               "minCount": 4},
                {
"companyNames": [                   "Company Name""role": "Field Technician",
                ]
          }
      }

Timezone Overlap

^parameter goodOverlap

^title Members geographically distributed should have at least <${goodOverlap} overlapped working hours.

TBC: need to confirm this is correct (code reference)

    { 
          "type": "TIMEZONE_OVERLAP",
          "args": {
                "goodOverlap": 3
          }
    }    "minCount": 1
                },
                {
                    "role": "Field Engineer",
                    "minCount": 3
                },
                {
                    "role": "Electrical Engineer",
                    "minCount": 3
                }
            ]
        }
    }

Same City Co-located (incomplete)

^parameter null

^title All members in the same city should work at the same address.

      {
        type: "SAME_CITY_COLOCATED",
        args: {}
      }

Child Team Count

^parameter maxTeams, minTeams, subGroupName

^title Should consist of no more than ${maxTeams} direct ${subGroupName}.

Should consist of at least ${minTeams} direct ${subGroupName}.

Should consist of between ${minTeams} and ${maxTeams} direct ${subGroupName}.

      {
          "type": "CHILD_TEAM_COUNT",
          "args": {
              "maxTeams": 15,
              "minTeams": 1
          }
      }

Direct Workforce Count

^parameter minCount, companyNames

^title Should consist of at least ${minCount} direct workforce members

      {
          "type": "DIRECT_WORKFORCE_COUNT",
          "args": { 
              "minCount": 4, 
              "companyNames": [
                  "Company Name"
                ]
          }
      }

Timezone Overlap

^parameter goodOverlap

^title Members geographically distributed should have at least <${goodOverlap} overlapped working hours.

TBC: need to confirm this is correct (code reference)

    { 
          "type": "TIMEZONE_OVERLAP",
          "args": {
                "goodOverlap": 3
          }
    }

Signal Overrides

By defaults the are three signals for principles they are:

• MET - green (success)

• NOT MET - red (danger)

• N/A - orange (warning)

These defaults can be overridden with the following config in those principles that support it:

"signals": [
  {
    "condition": "==0",
    "color": "success",
    "text": "<text to replace MET>"
  },
  {
    "condition": ">0",
    "color": "warning",
    "text": "<text to replace NOT MET>"
  },
  {
    "condition": "<0",
    "color": "danger",
    "text": "<text to replace NOT MET>"
  },
],

The arguments are interpreted as:

• condition - an arithmetic comparison - a comparison operator which is any of ==, !=, >, <, >=, <=followed by some number.

• color - a colour that indicates the status of the principle given the configured condition. Usually one of success, danger, warning

• text - the text that is to be presented in the principles tab. The defaults are MET, NOT MET, N/A.

Role Tag Parameters

For principles that support the roleTagType parameter this can be a string with a specific tag type (e.g. SPEICALIST) or it can be a list of tag types like:

"roleTagType": [
  "JOB_CAPABILITY_ARCHITECTURE",
  "SPECIALIST"
],

With this configuration the role parameter is compared with the tag value of the specified tag types.

To use the tag attribute values add the roleTagAttribute parameter. This parameter causes the principle to be evaluated against the tag attribute value rather than the tag value.

This parameter can also take an explicit string for a single attribute or it can take a list. The tag attribute name or ID can be used in this parameter. All of the following are valid roleTagAttribute settings:

Using one tag attribute name (or ID):

roleTagAttribute: "JA Role Code"

Using several tag attribute IDs (or names):

roleTagAttribute: [
  "abcdef",
  "jklmno"
]

Using Person Attributes

Parameter syntax

Many arguments use Regex. For example "role": "(.*product.*(owner|manager))" will match either product manager or product owner (or variations containing these words e.g. senior product manager, App product owner…etc). "role": "(.*agil.*coach)" will match agility coach, agile methodology coach..etc.

Bulk assigning principles to teams

You can use the Teams CSV import (Settings → Data Integrations → Create New - > Teams csv file upload

...

and a field map as follows:

...

Troubleshooting:

Can’t find a team a principle set in the drop down for a team?

...

It is likely you need to ensure a principle set is configured to have a suitableGroupType matching the team type for that team (as defined in Settings → Org Structure → Team Types)
E.g.

    {
        suitableGroupTypes:”squad” 
    }

Related articles

...