Library
Learn the platform
Every question you can ask about HCDI, each answered with its video, then step-by-step guides for every part of the website and platform.
Questions you can ask
Every question the HCDI assistant answers, with the video that answers it. Ask in any of these words.
Loading…
Start here: a tour of the platform
A short tour of the whole platform, from the public site to the report and what follows it.
Guides by topic
Each part of the platform: its video and the steps to follow.
Getting started
What HCDI is, and the public site
How to
Find your way round the public siteVisitor (signed out)
- Purpose
Read what HCDI is, reach the Trust Center and the legal pages, and get to sign-in.
- Navigation path
/ → /methodology → /partners → /contact; footer → /trust-center, /privacy, /terms. (/subprocessors is linked from the DPA, no longer from the footer, since 17 Oct 2026.)
- Steps
- On /, click READ THE METHODOLOGY.
- On /methodology, click AR for Arabic, then EN to return.
- Click Partner With Us, then Contact Us.
- In the footer, click Trust Center, then Privacy Policy and Terms of Service.
- Click Home in the site header, then Sign In in the top strip.
- Expected result
Each page opens with its own tab title. Sign In opens /login with "Sign in to HCDI".
- Common mistake
Treating "Begin an Assessment" in the top strip as a registration link. It only moves down the page. Quoting the Trust Center as a certification is also wrong: it says the opposite.
Getting in: register, sign in, two-factor, passwords, the onboarding gates
How to
Activate your accountevery new login account (Firm Admin, Firm member, Client HR, outside Executive Viewer)
- Purpose
Open the account an HCDI platform administrator created for you. There is no sign-up (D-22-22).
- Navigation path
/login → Activating a new account? → /activate
- Steps
- If you have no account, ask HCDI for one (the Contact page). A platform administrator creates it, a second person approves it, and you receive a temporary credential in person or by telephone.
- On /activate, type your Email and the Temporary credential, then click Continue.
- Type the eight-digit Activation code emailed to you, then click Verify.
- Type a New password in both boxes. If a Terms of Service version is shown, tick it. Click Save password.
- Set up two-factor authentication on your own device (1.2). Store the backup codes, then click Go to the platform.
- Expected result
"Your account is active." and the platform opens. Saving the password records your acceptance of the current Privacy Policy and, when one is published, the Terms of Service.
- Common mistake
Waiting more than 24 hours: the temporary credential stops working, and the administrator issues a new one. Waiting more than 15 minutes for the code: click Start again. Expecting the credential by email: it never travels with the code.
Set up two-factor authenticationany Firm user (required before using Firm Admin privileges)
- Purpose
Turn on two-factor sign-in. Firm Admin acts, HCDI standings and outside Executive Viewers all need it.
- Navigation path
the gate link Settings → Security (enable two-factor authentication), or side navigation Security → /settings/security
- Steps
- Click Set up MFA.
- Scan the QR code with your authenticator app, or use the Manual entry key.
- Type the app's current code in "Enter the 6-digit code from your app to confirm".
- Click Confirm and enable.
- Store the backup codes safely, then click I've saved these codes.
- Expected result
"MFA is enabled on your account." and badge Enabled. A wrong code shows "Incorrect code" and the view stays.
- Common mistake
Pressing Cancel after a wrong code and starting again. That creates a new key, and your app entry stops matching. Correct the code instead. The backup codes are shown only once.
Accept the onboarding agreementsFirm Admin (agreements); every user, when the Privacy Policy is republished
- Purpose
Pass the gates that stand in front of the Deal Workspaces list.
- Navigation path
side navigation Deals → /deals (the gates show there)
- Steps
- Click Deals.
- Tick the MSA checkbox. Type your own name in Your full name, as signer.
- Click Accept this agreement for the MSA.
- Tick the NDA checkbox, then click its Accept this agreement.
- On "Data Processing Agreement", tick the checkbox and click Accept.
- If the Privacy Policy changed since you activated: on "Privacy Policy", tick "I have read and accept the Privacy Policy." and click Accept.
- Expected result
Each agreement shows Accepted and the date. After the DPA, /deals shows the Deal Workspaces page. A new Firm sees "No deals yet. Use “New deal” to create the first one."
- Common mistake
Typing the Firm's name as signer instead of the person's name. Ticking the DPA when you have no authority to bind your firm.
Sign in with two-factorevery user
- Purpose
Sign in.
- Navigation path
/login
- Steps
- Type your email, then click Continue.
- Type your Password, then click Sign in.
- Type the current code in Authenticator code, then click Sign in.
- Expected result
A Firm user lands on /deals with the Firm's engagements. HCDI standings land on their own queue: the HCDI reviewer on /hcdi and The Guard on /hcdi/compliance.
- Common mistake
Retrying many times quickly after a failure. Typing a backup code into Authenticator code without switching.
Find your way after sign-inevery Firm user
- Purpose
Use the notification bell, the language switch and sign-out.
- Navigation path
/deals, top bar and side navigation
- Steps
- Click the bell to open Notifications. Click a row to open its link.
- Press Escape to close the panel.
- Click AR for Arabic or EN for English. The choice is saved to your account.
- When you leave, click Sign out in the top bar.
- Expected result
The panel lists your notices and the interface changes language. Signing out returns you to /login.
- Common mistake
Looking for "My account" under your name. There is no account menu, and security settings are under Security. Expecting client-entered text to be translated: it is shown as typed.
Setting up your Firm
How to
Add a team memberFirm Admin
- Purpose
Get a colleague an account in your Firm.
- Navigation path
side navigation Security → tab Team (/settings/team)
- Steps
- Read the card "Add a team member": accounts are created by HCDI platform administrators.
- Send HCDI the person's name, their email address and the onboarding record that names them.
- When HCDI has created and approved the account, the person activates it (1.1).
- Expected result
Once the account exists, the Members table gains a row for the person.
- Common mistake
Looking for an add form or a temporary password on this page: there is none. Trying to make someone a Deal Lead here: engagement roles are given on the engagement's People tab (M06).
Choose which notices are emailed to youany Firm user
- Purpose
Turn the email copy of a notice on or off.
- Navigation path
Security → tab Notifications
- Steps
- On a row, for example "Submitted for your review", tick or untick Email me.
- Expected result
The box changes. No message appears and there is no Save button.
- Common mistake
Believing the notice is switched off entirely. Only the email copy is.
Set the Firm's brandingFirm Admin
- Purpose
Set the colours the platform uses for your Firm.
- Navigation path
tab Branding
- Steps
- Click Primary color and pick a colour. Do the same for Secondary color if needed.
- Click Save details. It is enabled once something has changed.
- To return to the defaults, click Reset to HCDI navy, then save.
- Expected result
"Saved."
- Common mistake
Expecting a re-brand to change reports already issued. Thinking Reset to HCDI navy saved the colours on its own.
Contribute to benchmarks, or stopFirm Admin
- Purpose
Record whether your Firm contributes to benchmarking.
- Navigation path
tab Data
- Steps
- Tick or untick the checkbox.
- Click Save.
- Expected result
"Saved." and badge CONTRIBUTING or NOT CONTRIBUTING. The badge changes only after Save.
- Common mistake
Ticking the box and leaving without Save.
Prepare single sign-on (SSO)Firm Admin
- Purpose
Connect your Firm's own identity provider.
- Navigation path
tab SSO
- Steps
- Click Redirect URI to register with your identity provider to select it. Give it to your IT team.
- Type Issuer URL, Client ID, Client secret and Email domain.
- Click Test connection.
- Once IT has registered the redirect address, tick Enable SSO for this Firm.
- Click Save configuration.
- Expected result
Only the refusals were shown in training. With no issuer, Test connection shows "Discovery failed: Enter an issuer URL first". Save configuration then names the required fields, and the badge reads NOT CONFIGURED. A working configuration was not shown.
- Common mistake
Enabling SSO before IT registers the redirect address. Sign-ins then fail with "Single sign-on failed. Please try again or contact your Firm Admin." Typing "@acme.com" or a full address as the domain. A blank Client secret keeps the saved one.
Create and revoke an API keyFirm Admin
- Purpose
Give a system access to the Firm's API, and end that access.
- Navigation path
tab API Keys
- Steps
- Type Key name.
- Click Create key.
- Copy the key at once.
- To end access, click Revoke on the key's row.
- Expected result
Created key "{name}". with "This is shown once: copy it now, it cannot be retrieved again:". After Revoke, the row shows badge REVOKED.
- Common mistake
Leaving the page before copying. The key is gone and you must create a new one. Sharing a key by email.
Opening an engagement
Creating an engagement
How to
Find and open an engagementFirm Admin; Deal Lead; any member
- Purpose
Reach an engagement's Overview.
- Navigation path
side navigation Deals (/deals)
- Steps
- Click a stage pill to filter, for example Pre-Signing, or click All.
- Click Open on the row.
- If you are a Firm Admin and not a member, click Join as Deal Lead or Join as Reviewer, but only if you will work on it.
- Expected result
The engagement Overview opens at /deals/:id. A Firm Admin who is not a member sees "You can read this engagement, but not act on it yet". Joining adds you to People with that role.
- Common mistake
Expecting every engagement to appear for every user. A Member sees only the engagements they belong to. A Firm Admin should not join every engagement "to help".
Create an engagementFirm Admin or Firm member
- Purpose
Open a new Deal Workspace.
- Navigation path
/deals → New deal
- Steps
- Click New deal.
- In section 1 Deal basics, type Deal name and choose Transaction type.
- In section 2 Requesting applicant, fill Applicant name, Applicant age, Applicant job title and Applicant department.
- In section 3 Parties, fill Company name and Company Type on both Your Company and Target Company.
- In section 5 Founding Engagements Programme, choose an answer, for example No: this engagement is not in the programme.
- Click Create deal workspace.
- Expected result
/deals/{id} opens with badges for the company, the type and the first stage, for example PRE-SIGNING, and "People 1".
- Common mistake
Leaving section 5 unanswered. That gives "Say whether this engagement is a Founding engagement before creating it (section 5)." Leaving a hidden tab incomplete gives "Complete the Target Company tab: a required field there is still empty." Your Company is the client side, not your advisory Firm. Choosing Domestic M&A for a foreign target: use Cross-border M&A.
Create an assessment (first or later)Deal Lead
- Purpose
Start an assessment at a stage. A later one is the reassessment.
- Navigation path
engagement Overview → card Assessments
- Steps
- Click New Assessment in the header. The page scrolls to the card and focuses the stage select.
- Choose the stage in the card's select.
- Click New Assessment in the card.
- Expected result
"Creating…", then a row "{Stage} · v1.0 · DRAFT".
- Common mistake
Pressing more than once and creating several drafts. Expecting the header button alone to add a row. Expecting a reassessment to carry the earlier scores over.
Change the engagement's stage or detailsDeal Lead
- Purpose
Keep the engagement's stage and its transaction details correct.
- Navigation path
Overview → side column "Move the engagement to another stage"; card "Transaction & parties"
- Steps
- Choose the stage in "Move the engagement to another stage", then click Move.
- If you move backwards, confirm with Yes, move back, or click Cancel.
- To correct details, click Edit on "Transaction & parties", change the fields, and click Save.
- Expected result
The new stage shows in Deal facts and in the header. An edit shows "Saved."
- Common mistake
Confusing the engagement's stage with an assessment's stage. Moving back out of habit.
The Order Form
How to
Accept the Order FormDeal Lead
- Purpose
Sign the engagement's terms. This lifts the Order Form lock on scoring.
- Navigation path
engagement → tab Commercial (/deals/:id/commercial)
- Steps
- Check the proposed terms and the parties.
- Type your name in Your full name (signature).
- Click Accept the Order Form.
- Expected result
Badge Accepted and "Accepted by {name} on {date}. Scoring is unlocked."
- Common mistake
Reading "Scoring is unlocked" as "scoring can start now". The materiality criteria are a separate lock (5.2). A Reviewer cannot accept.
Scoping and materiality
How to
Decide the Founding Engagements Programme flagDeal Lead
- Purpose
Decide whether the engagement is in the Founding Engagements Programme. You must do this before any evidence is uploaded.
- Navigation path
engagement → tab Scoping → card "Founding Engagements Programme"
- Steps
- Decide before uploading anything.
- Click Flag as a Founding engagement, or leave it unflagged.
- Expected result
Badge IN THE PROGRAMME and a note that the engagement may issue scored reports while the methodology values in force are provisional. The button becomes Remove the flag.
- Common mistake
Uploading a document "to get started" first. Once evidence exists, the flag cannot change. Flagging every engagement: places are limited.
Record the materiality criteria and the assessed partiesDeal Lead
- Purpose
Fix, before any scoring, what will count as material and which party is assessed.
- Navigation path
Scoping → cards "Materiality criteria" and "Assessed parties"
- Steps
- Type Decision informed, Declared exposures and Quantitative trigger, as agreed with the client.
- Click Record criteria.
- On a two-party type, choose This engagement assesses, for example Target.
- Click Record assessed parties.
- Expected result
"Recorded by {name} on {date}." For the parties you also see "Assessed: {party}". Each record is in force once recorded.
- Common mistake
Writing the criteria after looking at the evidence. Inventing numeric thresholds nobody agreed with the client. Typing a space to fill a field. Choosing "Acquirer + Target" to be safe.
Record the organisation structure and the remediation disclosureDeal Lead
- Purpose
Record the client's real titles, which name action owners in the report. Also record whether your Firm offers remediation services.
- Navigation path
Scoping → cards "Recorded at scoping" and "Do we offer remediation services to this client?"
- Steps
- Tick only the titles the client actually has, for example CEO, CHRO and Board.
- Click Save structure.
- Answer the remediation question truthfully, for example No, none.
- Expected result
"Saved." for each. The line "Not yet disclosed. Report issuance is refused until it is." disappears.
- Common mistake
Ticking every box. The report would then name titles the client does not have. Answering "No, none" when your Firm does offer such services: the answer is printed in the report.
Record the Integrity Event contactsDeal Lead
- Purpose
Name who is told if an Integrity Event is raised.
- Navigation path
engagement → tab Governance → card "Integrity Event contacts"
- Steps
- Click Edit.
- Fill HCDI Compliance contact, Data Protection Officer, Client governance contact and, if there is one, Partner compliance officer. Use one address per field.
- Click Save.
- Expected result
"Saved." The read view shows the contacts. An empty contact reads "Not specified".
- Common mistake
Naming the deal sponsor as client governance contact. Typing two addresses in one field. Expecting HCDI to be emailed at the HCDI Compliance contact; it is not.
The team, Client HR, respondents and viewers
How to
Add a Firm member to the engagementDeal Lead
- Purpose
Give a colleague a role on this engagement, for example Reviewer.
- Navigation path
engagement → tab People → the add-member form
- Steps
- Choose Role, for example Reviewer.
- Choose the Firm member.
- Keep Party on Delivery side (no party) for your own team.
- Click Add member.
- Expected result
"Added {name} to this engagement as {role}." and the new row.
- Common mistake
Expecting the person to be emailed. A Firm member added this way is not, so tell them. Adding people on the Firm's Team page gives no engagement role.
Invite a Respondent or add the Client HR contactDeal Lead
- Purpose
Bring in people from the assessed company.
- Navigation path
People → the add-member form
- Steps
- Choose Role: Respondent or Client HR.
- Type Respondent name and Respondent email. For Client HR and an outside executive the same fields read Name and Email address.
- On a two-party engagement, choose the Party, for example Target.
- Click Add member.
- Expected result
For a new respondent: "Account created for {name} ({email}) as Respondent." with a temporary password shown once. For Client HR: their account must already exist, created by an HCDI platform administrator; the screen then reads "Added {name} to this engagement as Client HR." and they are told by email.
- Common mistake
Adding Client HR before HCDI has created their account: the add is refused. Adding the same person twice ("This person is already a member of this Deal Workspace"). Inviting a Firm colleague as a respondent to test the portal.
Add an Executive ViewerDeal Lead
- Purpose
Let an executive read reports without working on the engagement.
- Navigation path
People → the add-member form
- Steps
- For someone outside the Firm, choose Executive viewer from outside the firm (by email). Their account must already exist, created by an HCDI platform administrator.
- Type their name and the email address their account was created with.
- Choose their side in Party. It is required.
- Click Add member.
- For a Firm colleague, choose Executive Viewer, pick the Firm member, choose the Party, and click Add member.
- Tick Holds the Full-view recipient role only for the person in the confirmed recipient role.
- Expected result
"Added {name} to this engagement as Executive Viewer." An outside viewer's row shows "OUTSIDE THE FIRM" and no Full-view recipient box.
- Common mistake
Adding an outside viewer before HCDI has created their account: the add is refused. Using the inside option for a client executive; it needs a Firm member. Leaving Party empty for an outside viewer: the browser says "Please select an item in the list." Ticking the recipient box for every senior viewer.
Invite respondents from a CSV fileDeal Lead
- Purpose
Invite many respondents at once.
- Navigation path
People → card "Invite people from a file"
- Steps
- Keep Invite as on Respondents. Choose Email language where a row names none.
- Choose the file in CSV file. Its columns are name, email, party and language.
- Read the preview, "{n} ready to invite, {m} lines not usable.", and the lines it lists.
- Correct the file if needed and choose it again.
- Click Send {n} invitations.
- Expected result
An "Invitations sent" progress bar and tiles for new accounts, existing accounts added, skipped, and emails sent or not sent. Then "All batches sent."
- Common mistake
Sending the file again to "resend". People already invited are skipped and nothing is resent; they can use Forgot password instead. Removing the party column to get a batch through. Uploading the roster here: the roster is Client HR's (M07).
People, roster and evidence
The workforce roster and reconciliation
How to
Upload the workforce rosterClient HR
- Purpose
Supply the assessed company's workforce roster. Only Client HR may do this.
- Navigation path
/client-roster → Open roster → /client-roster/:dealId
- Steps
- Click Open roster on the right company's row.
- Type Documented eligible headcount, as a number only.
- Paste the rows into Roster rows in the format the hint shows.
- Correct any line the alert names.
- Click Upload roster.
- Expected result
"Roster uploaded." The card shows the rows uploaded, the headcount and badge RECEIVED: NOT YET COUNTED.
- Common mistake
Using your own HR level names as entry classes ("“manager” is not an entry class: use general, leadership, board, or leave it empty."). Uploading again "to make sure": the older upload becomes Superseded.
Check a leader or board member against a documentDeal Lead
- Purpose
Corroborate Leadership and Board roster entries against a company document.
- Navigation path
People → card "Leaders and board members checked against documents"
- Steps
- Click Check on the entry.
- Choose the Governance document.
- Type Where in the document.
- Choose Found or Not found.
- Click Record.
- Expected result
Found gives status VERIFIED and a Check again button. Not found gives "NOT FOUND IN THE DOCUMENT" and "AWAITING HCDI'S REVIEWER". That is an evidence conflict, and finalize stays blocked until HCDI's reviewer resolves it (17.3).
- Common mistake
Choosing Found to avoid the conflict; that misrecords evidence. Checking against the roster itself. Writing only "checked".
Structured inquiries, Adaptive Digital Inquiry and the respondent's side
How to
Prepare and distribute a structured inquiryDeal Lead
- Purpose
Send the HCDI question sets to the right respondents.
- Navigation path
engagement → tab Instruments → tab Structured Inquiries
- Steps
- On the consent gate, tick "I consent and agree to the above." and click Continue.
- Under "Respondent roles", click a role pill for each respondent, for example Leadership.
- Click Create on the matching instrument card.
- Click the tab Structured Inquiries and open the set, for example "C-level Structured Inquiry".
- Click Distribute structured inquiry.
- Expected result
Badge Distributed and "This structured inquiry has been distributed and can no longer be edited." The "Sent to" card lists each respondent as PENDING.
- Common mistake
Giving everyone every role. Reading "0 respondents were notified by email." as "nobody received it". Editing an HCDI instrument to fit the client.
Answer a set of questionsRespondent
- Purpose
Give your consent, then answer.
- Navigation path
/respondent
- Steps
- Click Read and accept. Tick "I consent and agree to the above." and click Continue.
- Click ← Back, then Open on the set.
- Read "Before you begin" and click Continue.
- Choose one answer for every statement.
- Click Submit responses.
- Optionally, click Show my answers.
- Expected result
First "Your consent is recorded". After submitting: "You've already sent your responses to this set of questions. Thank you." with the cards "Your report" and "Your own answers".
- Common mistake
Submitting with questions unanswered ("Please answer every question before submitting. {n} of {m} answered"). Trying to submit a second time.
Read structured inquiry resultsDeal Lead
- Purpose
See what respondents said without exposing any one person.
- Navigation path
Structured Inquiries → open a distributed set
- Steps
- Open the set.
- Read each statement's line and the "Sent to" table.
- Expected result
If too few people answered, each statement reads "Withheld: {n} response(s), below the HCDI minimum reporting threshold of {value}." With enough responses, each statement shows an average out of 5.
- Common mistake
Asking HCDI to "unhide" one person's answers. Withheld responses are not evidence.
Run an Adaptive Digital Inquiry sessionDeal Lead
- Purpose
Record a respondent's answers to the authored questions for one indicator.
- Navigation path
scoring page → header link Adaptive Digital Inquiry (…/inquiry)
- Steps
- Choose the Indicator.
- Choose the Respondent. They must already have given consent.
- Click Start inquiry.
- Type the answer to each question shown, then click Save answer.
- Click Submit inquiry.
- Expected result
The row shows "ESCALATED TO REVIEWER", "OPENED UNDER CONSENT", "CLAIMED", "AWAITS A PERSON'S SCORE" and "No score".
- Common mistake
Recording the interview now and asking for consent later. Without consent you get "Waiting for the respondent's consent" and no session starts. Waiting for HCDI to score it: "Reviewer" here means the scoring practitioner.
Evidence: data requests, upload, tagging, Party
How to
Upload, link and tag an evidence documentDeal Lead or Reviewer
- Purpose
Make an indicator scorable and record how far its evidence stands up.
- Navigation path
engagement → tab Data requests (/deals/:id/evidence-requests) → card "Evidence documents"
- Steps
- Choose the file in Document.
- Choose the indicator in Evidence for indicator.
- Set Date the document speaks from and type a factual Description.
- On a two-party engagement, choose the Party.
- Click Upload.
- On the new row, click Tag, choose the status (for example Claimed), and click Save.
- Expected result
"{file} uploaded." The row shows the indicator and UNTAGGED until you tag it. After tagging it shows the status and a Re-tag button, and the untagged banner disappears.
- Common mistake
Uploading with No indicator: that makes no indicator scorable. Leaving documents untagged until submission day. Writing notes to colleagues in the description ("score this high"). Instruction-like text is detected and disclosed.
Answer a company data requestDeal Lead
- Purpose
Record whether the company supplied what was asked for.
- Navigation path
Data requests → "Company data requests"
- Steps
- On the request's card, choose an uploaded document in the select.
- Click Mark provided.
- If the company never supplied it, click Record as missing instead.
- Expected result
The card shows badge PROVIDED with the file and an Unlink button, or badge MISSING. The tiles update.
- Common mistake
Thinking Provided means verified. The document's own status says how far it stands up. Scoring an indicator low because its request is missing.
Set a document's PartyDeal Lead (two-party engagements)
- Purpose
Make sure each party sees only its own documents and the joint ones.
- Navigation path
Data requests → documents table
- Steps
- Click Set party on the row.
- Choose Unattributed, Acquirer, Target or Joint.
- Click Save, or Cancel.
- Expected result
The PARTY column shows the value.
- Common mistake
Leaving documents unattributed. A party-side reader then cannot see them.
Scoring and review
Scoring an indicator, or recording it not evidenced
How to
Score an indicatorDeal Lead or Reviewer
- Purpose
Record the practitioner's score for one indicator.
- Navigation path
Overview → Assessments → Open → Score assessment; left navigation pillar, for example P1
- Steps
- Go to the indicator card.
- Click a score from 1 to 5.
- Under Select all that apply, tick at least one option.
- Optionally, type Additional context (optional).
- Click Save score.
- Expected result
Badge saved. The counters move, for example "1 / 29" and "1 of 6 indicators scored".
- Common mistake
Changing the score after ticking: the ticks clear. Saving without an option; submission is then refused and names the indicator. Copying level-description or option text into the context field or a report.
Record the Party of a findingDeal Lead (two-party engagements)
- Purpose
Record which party a 1–4 finding belongs to, before submission.
- Navigation path
scoring page → indicator card → "Party this action belongs to"
- Steps
- Choose the Party.
- Type the Reason.
- Click Record party.
- Expected result
"Party recorded." The submit hint counts one fewer.
- Common mistake
Saving the score again afterwards ("Saving this score again clears it."). Typing only spaces as the reason.
Work out why an indicator cannot be scoredDeal Lead or Reviewer
- Purpose
Find out what is locking scoring and who can clear it.
- Navigation path
scoring page → notices at the top and the indicator cards
- Steps
- Read the lock notice at the top.
- Follow its link (Order Form or Materiality criteria), or ask the person named.
- For an indicator with no linked evidence, link evidence (9.1). There is no "Record not evidenced" button.
- Expected result
Each lock and who clears it: - "Scoring is locked until this engagement’s Order Form is accepted by its Deal Lead." The Deal Lead accepts it (4.2). - "Scoring is locked until materiality criteria are recorded on the deal page." The Deal Lead records them (5.2). - An open integrity matter suspends the engagement. The Guard closes it (17.2). The wording on this page is. - No linked evidence: the card's controls are disabled. At Submit for Review the platform records the indicator not evidenced. - "This assessment is finalized and can no longer be edited". Use a later assessment (3.3).
- Common mistake
Giving an indicator a 1 because nothing was supplied. Absence is never a low score. Reloading again and again on a lock that needs another person.
Submit for Review, corrective actions and HCDI review
How to
Submit an assessment for reviewDeal Lead
- Purpose
End scoring and start corrective-action drafting and HCDI review.
- Navigation path
scoring page → Submit for Review
- Steps
- Check that every applicable indicator is scored with an option ticked and every document is tagged. On a two-party engagement, also check that every 1–4 score has a Party.
- Click Submit for Review.
- Expected result
Badge IN REVIEW and "{n}/{n} English drafts written. Each Arabic text is drafted as a translation once its English is approved." The button becomes Review corrective actions →.
- Common mistake
Reading "English drafts written" as approval. Assuming the red text still applies after you fixed the cause. Changing a score during review: that reverts the assessment to draft and clears that indicator's draft.
Record an action's attributesDeal Lead
- Purpose
Classify each corrective action and name its owner.
- Navigation path
Review corrective actions → (…/review) → action card → "Action attributes"
- Steps
- Choose Materiality, unless a rule has set it.
- Choose Response type. For Structural response, tick "This action is neither a workshop nor a cadence."
- Choose Timing.
- Choose Accountable function. Leave Accountable role blank unless the function cannot be resolved.
- Type Reasoning (logged).
- Click Record judgment.
- Expected result
"Recorded", badge All three set, and judgment beside each attribute. Implementation instrument shows an instrument. When every card is done and HCDI has approved, the page shows "(n/n indicators fully reviewed)" and Finalize assessment becomes enabled.
- Common mistake
Leaving without Record judgment. Recording a workshop or a cadence as Structural ("Confirm the MR-04 test to record a Structural response."). Typing a person's name in Accountable role. Naming your own Firm's service line.
Write the action for an indicator that could not be evidencedDeal Lead or Reviewer, then HCDI reviewer
- Purpose
Give every not-evidenced indicator an action to establish what could not be evidenced.
- Navigation path
…/review → "Indicators that could not be evidenced"
- Steps
- Type The action, in English.
- Click Save and send for approval.
- Record its attributes on the same card (11.2).
- The HCDI reviewer approves the English, then the Arabic (11.3).
- To change it later, click Write it again, then Save the new text and send it for approval.
- Expected result
The English shows "Awaiting approval" and the Arabic "Awaiting the English". After approval the card looks like 11.3.
- Common mistake
Leaving it unwritten. Finalize counts it as unreviewed.
Release conditions and finalize
How to
Read the release conditionsDeal Lead or Reviewer
- Purpose
See, before you press Finalize, which of the six conditions are met.
- Navigation path
…/review → card Release conditions
- Steps
- Read each row: Met or Missing, with the reason under it.
- After someone else has acted, click Check again.
- Expected result
"{met} of 6 met". The six conditions are Credential valid, Authorisation valid, Conflict check complete, Independent Reviewer assigned, Review completed and Methodology version locked. The card records nothing.
- Common mistake
Pressing Finalize again and again instead of reading this card.
Finalize an assessmentDeal Lead
- Purpose
Close the assessment so that reports can issue.
- Navigation path
…/review → Finalize assessment
- Steps
- Click Finalize assessment.
- Read "Finalizing cannot be undone. Press Confirm finalize to proceed, or Cancel."
- Click Confirm finalize, or Cancel.
- Expected result
The status moves from In review to Finalized and you land on the scoring page. If anything is missing, a red refusal names it and the status stays IN REVIEW, for example "Finalization is refused: {n} of the six release conditions are not met, …".
- Common mistake
Asking an administrator to "push it through". There is no manual gate closure. Looking for an "unfinalize": there is none.
Reports
Generating and issuing reports; report status
How to
Prepare a two-party report for issuanceDeal Lead
- Purpose
Record the Full-view recipient and your attestation before issuing.
- Navigation path
…/review → Open the report (…/report)
- Steps
- In the card "Full-view recipient", type the Recipient role: a role, never a person's name.
- Click Record the recipient role.
- In the card "Before issuing", tick both statements.
- Click Attest and continue.
- Expected result
"Recorded." with badge CONFIRMED and "Recorded recipient role: …". Then "Attested. The report can now be issued."
- Common mistake
Typing a person's name. Ticking because the button needs it: each tick is your personal recorded statement.
Issue the Findings report and the Full reportDeal Lead or Reviewer
- Purpose
Issue the reports of record on a finalized assessment.
- Navigation path
…/report → card "Generate a report"
- Steps
- Choose Format (PDF or Word (.docx)), Language (English or العربية (Arabic)) and Edition (Full view or a party edition, for example Target edition).
- Set Type to Findings report and click Generate report.
- Set Type to Full report and click Generate report.
- Repeat for other languages, formats and editions. For the summary, choose Executive summary.
- In "Generated reports", click Download on a row.
- Expected result
Each issue adds a row "{Type} · {Edition} · {Language} · {Format}" with status VALID. Downloaded files keep their names, for example …-ALLPARTIES-FULL-EN-v1.pdf.
- Common mistake
Issuing the Full report first. It is refused: "A Full Report for this assessment and edition does not issue before its Findings Report …". Generating the same report twice, which leaves two version 1 documents. Sending an edited Word file as the report of record. Renaming the files.
Report Masterclass: reading every report, page by page
How to
Read a report the decision-maker's wayReport reader (board, committee, the recipient role)
- Purpose
Get to a decision without misreading the report.
- Navigation path
Full view PDF → contents links on page 3
- Steps
- On the cover, read the score and the coverage together, and who reviewed the report.
- On page 5, read the three dimensions, the gates chip and the Integrity Events chip.
- Read the material findings, party by party.
- Read the dashboard's conclusion statement and the sufficiency label.
- Read the materiality criteria fixed at scoping.
- Read the action plan: the milestone first, then what not acting means.
- On page 100, read the independence and integrity sections. Then read the disclaimer.
- Ask the delivering team two things the report cannot tell you: its current status, and which gate is open.
- Expected result
You reach your own decision. The report gives a conclusion, never a verdict.
- Common mistake
Stopping at the cover's score. Reading the band as a pass or a fail. Reading a not-evidenced indicator as a score of 1.
Read an action cardReport reader; practitioner
- Purpose
Understand what an action asks, who owns it and what closes it.
- Navigation path
section 1 "MATERIAL FINDINGS"; section 9 "Executive Action Summary"
- Steps
- Read INDICATOR, SCORE, RESPONSE TYPE and ACCOUNTABLE ROLE.
- Read CORRECTIVE ACTION (FINDINGS / GAPS) and FROM FINDING TO ACTION.
- Read IMPLEMENTATION INSTRUMENT, IMPLEMENTATION LIFECYCLE and EXPECTED OUTCOMES.
- Read SYSTEM OF RECORD and EVIDENCE OF CLOSURE.
- In section 9, read MATERIALITY, MILESTONE, WHAT NOT ACTING MEANS and PARTY.
- Expected result
You can say what the client must do, who owns it, by when, and what evidence closes it.
- Common mistake
Ranking actions by response type or by ID. Equating material with urgent. Submitting "the outcomes happened" as completion evidence. Expecting a completed action to change the score; only reassessment does.
Tell the report types apartReport reader
- Purpose
Know which document you hold before you quote it.
- Navigation path
the issued files
- Steps
- Findings Report: the findings, with no action content.
- Full Report and Action Plan: the findings and the action plan.
- Party edition: that party's actions and the joint ones only. The other party's actions are withheld.
- Arabic edition: its own page numbers. Cite those.
- Word file: the same content. An edited copy is not the report.
- Executive Summary report: a separate document from the Executive Summary section.
- Expected result
You quote the right document, with the right page numbers.
- Common mistake
Calling the two-party Full view the "Fit Report". Telling a Findings Report reader that "the actions are in an annex".
Check a report's status, and what not to do with itReport reader
- Purpose
Rely only on a report that still stands, and use it correctly.
- Navigation path
the report's cover and page 100
- Steps
- Read the Report ID on the cover.
- Ask the delivering team or HCDI for the current status, quoting the Report ID. The document prints no status because it is frozen at issuance.
- Before using the report, check the ten don'ts in M14-084.
- Expected result
You know the report's current status before relying on it.
- Common mistake
Relying on an old copy without checking its status. Editing the Word file and circulating it. Sending the Full view to one party. Copying band boundaries, rationale statements or methodology wording. Forwarding the report beyond its intended recipients without HCDI's written consent.
After the report
The Action Tracker and HCDI verification
How to
Record a client transition on the TrackerDeal Lead or Reviewer
- Purpose
Record what the client says happened to an action after issuance.
- Navigation path
report page top bar Action Tracker, or Open the Action Tracker on the review page → action card → "New status"
- Steps
- Click the new status: In progress, Deferred or Risk accepted.
- Type What this records.
- Choose The client's instruction: the client's own message, minute or signed note.
- Click Record transition.
- Expected result
The badge and its definition, for example IN PROGRESS "The accountable role has recorded work under way." The History gains an entry with your name, the note and the instruction.
- Common mistake
Recording a move from a phone call. Choosing any file because the list offers it. Recording Risk accepted on the team's own view of the risk: it must be the client's documented decision.
Submit an action as completeDeal Lead or Reviewer
- Purpose
Pass the client's completion evidence to HCDI for verification.
- Navigation path
Tracker → action card → "New status"
- Steps
- Click Submitted as complete.
- Type What this records.
- Choose The client's instruction and the Completion evidence.
- If someone did the work, type Who did the work (optional) truthfully.
- Click Record transition.
- Click Open in the History entry to check the evidence file.
- Expected result
Badge SUBMITTED AS COMPLETE. Only Deferred and Risk accepted remain for you, and HCDI's verification role decides next.
- Common mistake
Reporting the action to the board as complete. It is the client's statement, not a verification. Attaching the expected outcomes as proof. Leaving the implementer blank when your Firm did the work. Naming a firm that assessed this engagement limits who may deliver the reassessment.
Reassessment, trend and ending the engagement
How to
Read the trendDeal Lead
- Purpose
See scores across the engagement's finalized assessments.
- Navigation path
Overview → Trend & Benchmark (/deals/:id/trend)
- Steps
- Read the tiles and "Score Trend".
- Click Show as table to see a table.
- Expected result
The trend of finalized assessments. Without one the page reads "No finalized assessments yet: finalize at least one to see a trend."
- Common mistake
Expecting a verified Tracker action to move these numbers. Telling a client how they compare with peers: benchmark reads are restricted.
Close or reopen a Deal WorkspaceFirm Admin of the owning Firm
- Purpose
End an engagement that ends without a report, or bring it back.
- Navigation path
engagement → tab Governance → card "Deal Workspace status"
- Steps
- Type Why it is being closed.
- Click Close Deal Workspace, then Confirm close, or Cancel.
- To reopen, type Why it is being reopened and click Reopen Deal Workspace.
- Expected result
Badge CLOSED: the records stay readable and every change is refused. After reopening the badge reads ACTIVE. If a report has been issued you get "A report has been issued on this Deal Workspace, so it is not closed: …" and the badge stays ACTIVE.
- Common mistake
Closing to "pause" work. Asking an administrator to force closure after a report has issued.
Governance side workflows
How to
Record a suspected integrity matterDeal Lead or Reviewer
- Purpose
Report a suspected integrity problem to HCDI Compliance.
- Navigation path
engagement → tab Governance → card "Integrity events"
- Steps
- Choose the Category that matches what you actually suspect.
- Type the Description.
- Click Record suspected integrity matter.
- Expected result
The event shows OPEN and "SUSPECTED: COMPLIANCE DETERMINATION PENDING". At once you see "Engagement suspended: … Nothing can be scored, submitted, finalized or issued until “The Guard” closes it."
- Common mistake
Choosing a category to avoid a suspension. Naming more people than needed. Raising a concern as a finding or a score. Thinking the suspension waits for The Guard: it starts at recording.
Decide on instruction-shaped text in evidenceDeal Lead
- Purpose
Record whether flagged instruction-like text was placed deliberately.
- Navigation path
Governance → card "Instruction-shaped text in evidence"
- Steps
- Read the flagged row.
- Choose your decision, for example No, not deliberate.
- Type the Reasoning.
- Click Record decision.
- Expected result
The row reads "Determined not deliberate" and the button becomes Record a new decision.
- Common mistake
Deleting the evidence item; the flag and the item stay on record. Expecting a flag from a file's own content. Only the description typed at upload and Adaptive Digital Inquiry answers are read. Treating an escalation as an Integrity Event.
The Executive Viewer
How to
Read your side's reports and actionsExecutive Viewer (outside the Firm)
- Purpose
Read your side's issued reports and see where your side's actions stand.
- Navigation path
/viewer
- Steps
- Click Turn on two-factor sign-in and enrol (1.2). Then sign out and sign in again.
- On /viewer, find your engagement ("YOUR SIDE: …").
- Under "ISSUED REPORTS", click Download.
- Under "ACTION TRACKER", read each action's status by indicator code.
- Expected result
Your side's report edition downloads, for example …-PARTYA-FULL-EN-v1.pdf. The Tracker list shows codes and statuses, with no action text and no scores.
- Common mistake
Reporting "no reports" before turning on two-factor. Asking for the Full view, which an outside viewer never receives. Reading "Submitted as complete" as done. Forwarding the report without HCDI's written consent.
Read an engagement as an Executive Viewer inside the FirmExecutive Viewer (inside the Firm)
- Purpose
Read an engagement and its reports without changing anything.
- Navigation path
Deals → the engagement
- Steps
- Open the engagement.
- Open the scoring page from the assessment row's Open.
- On the report page, click Download on a row.
- Expected result
The pages show no edit controls and the reports download. The report page says "Your role on this engagement can read and download the reports but not generate them.".
- Common mistake
Treating the Tracker refusal as a fault: "Reading the Tracker is refused: you are not recorded as holding a recipient role on this engagement."
HCDI Network, certification and troubleshooting
The HCDI Network
How to
Browse the HCDI Networkanyone, signed in or not
- Purpose
Find readiness roles posted by organisations.
- Navigation path
Menu → HCDI Network (/network)
- Steps
- Filter by Operating model and HCDI credential, or set both to Any.
- Click a posting card.
- Follow the "Apply on {host}" link to the organisation's own page.
- Expected result
/network/vacancies/:id shows the posting and its application link, with the link's host shown.
- Common mistake
Calling a posting "HCDI-approved". Asking HCDI for an application; HCDI never receives one. Reading "No roles are posted at the moment." as an empty board: it means nothing matches the filters.
Declare your organisationposter (signed in)
- Purpose
Show that you control a mailbox at your organisation's own domain.
- Navigation path
/network → For corporates (/network/corporates) → "Declare your organisation"
- Steps
- Type Legal name, Email domain (the domain your account uses) and Jurisdiction (two-letter code).
- Choose Legal entity identifier and type the Identifier.
- Click Send me a code.
- Enter the emailed code.
- Expected result
A domain other than your account's is refused ("Your account's email is not at {domain}. …"). A name carrying the HCDI mark is refused. For an organisation already on record: "This organisation was already declared at this domain. Nothing new was created; continue with it below."
- Common mistake
Using a trading name or a department name. Typing the website domain when staff emails use another. Declaring again to "refresh" authority.
Publish and withdraw a postingposter with verified authority
- Purpose
Put a role on the board, and take it down.
- Navigation path
/network/corporates → New posting; Show postings
- Steps
- Click New posting.
- Fill Role title, Country (two-letter code), City, Operating model, Reporting line, HCDI credential and Your application page.
- Click Publish posting.
- To take it down, click Show postings, click Withdraw on the live row, then OK.
- Expected result
"{title}: On the board · until {date}", and the posting appears first on /network/vacancies. After withdrawing, the row reads "Withdrawn" and the posting leaves the board.
- Common mistake
Putting a job description in the title. Using an application link that names HCDI, which is refused. Publishing twice to "bump" a role.
Certification: the scheme, its documents and its holds
How to
Read a certificate, a Statement of Results and the registerCandidate; relying party
- Purpose
Read the scheme's documents correctly.
- Navigation path
the documents; the certification app's "Verify a credential" page
- Steps
- Certificate: read the number, the holder, the level title, the limitation block, the methodology version and the dates. It never states a status.
- Statement of Results: it is marked "NOT A CREDENTIAL". While the pass mark is held, the required standard prints as a visible bracket, which is not a pass mark.
- Register: on "Verify a credential", type the Credential ID and click Look up.
- Expected result
Today every lookup shows "Verification not yet published", the same for a real number and an invented one.
- Common mistake
Using a certificate's dates to decide whether someone is certified today. Accepting a badge image or a Statement as proof. Reading "not yet published" as certified, or as not certified.
When something goes wrong: refusals, errors and recovery
How to
When a button does nothingeveryone
- Purpose
Find out what a disabled button is waiting for.
- Navigation path
any page
- Steps
- Look next to the button.
- Read the sentence there. It says what is missing, for example "Choose a file to upload."
- Supply what is missing, then press the button again.
- Expected result
The button becomes enabled.
- Common mistake
Clicking repeatedly, or reloading.
When a red refusal appearseveryone
- Purpose
Use the refusal to find the fix.
- Navigation path
any page
- Steps
- Read the refusal to its last sentence. That sentence usually names the fix.
- Fix the cause.
- Act again. The old red text may stay on screen until you do.
- Expected result
The status changes once the cause is fixed.
- Common mistake
Reporting a refusal as a bug. It is the platform enforcing a rule.
When you cannot see a buttoneveryone
- Purpose
Find who is allowed to act.
- Navigation path
any page
- Steps
- Read the status line near where the button would be.
- It names who acts next, for example "a second engagement member".
- Ask that person.
- Expected result
The right person does the act.
- Common mistake
Asking a Firm Admin or an administrator to "enable the button".
Training version 0.1. A draft, not yet approved by HCDI.
