Assessment workflow

From repository evidence to an approval-ready report

One guided workspace keeps the assessment, evidence package, report, and final human decision connected to the same immutable repository snapshot.

  1. Run

    Create an authorized assessment engagement and capture the exact repository state.

  2. Verify

    Review exact-commit evidence, scanner dispositions, limitations, and cross-format report consistency.

  3. Approve

    Use Final Review to accept the exact report package. NICO never authorizes client delivery automatically.

Create an engagementOpen Final Review

Human review and separate delivery authorization required · Client delivery remains blocked until exact-artifact approval and delivery authorization are both recorded.

NICO Guided Workflow

One assessment intake

Start Express or Comprehensive from one page without duplicating repository details or authorization fields.

Run a JobScanner toolsView steps

Choose a workflow

What are you trying to do?

guided
Quick repo health checkRun ExpressBest for a first look or internal technical baseline.
Complete technical diligenceRun ComprehensiveBest for one immutable snapshot, deeper technical and business-context modules, and formal review.
Repair failed checkUse exact failure evidenceBest when CI, scanner, or report issues need a bounded repair PR.
Retainer projectUse Retainer OpsBest for ongoing weekly evidence and commercial support.

Workflow

One clean order

6 steps
1. Open Run a Jobstep

Use the unified assessment page instead of completing a separate setup wizard.

2. Choose Express or Comprehensivestep

Select the service that matches the evidence depth and review you need.

3. Enter the authorized repositorystep

Use owner/repo or a GitHub URL. Client and project names are optional.

4. Confirm authorization and runstep

Use the single authorization checkbox, then start the selected assessment once.

5. Review evidence and findingsstep

Read unavailable evidence, confidence, findings, and human-review warnings before trusting the score.

6. Review and exportstep

Download draft artifacts only after the exact run and report wording have been reviewed by a human.

Unified inputs

Enter each fact once

lower error risk
RepositoryRequired

owner/repo or GitHub URL for the authorized target.

Client and projectOptional

Useful report labels that do not change authorization or evidence.

Authorization checkboxRequired

Confirms ownership or explicit permission for the selected target.

Assessment serviceRequired

Express or Comprehensive selected on the same intake page.

Run identityRetained

Use the exact returned run ID for continuation, recovery, report, and review.

Draft reportHuman review

Scores and exports remain review-required and are not automatically client-ready.

Client-ready rule

Scores are not the final answer

human review

A higher score means the available evidence looks stronger. It does not remove unavailable-evidence review, exact-run verification, or final wording approval before client delivery.

Normal path

Use Run a Job, select Express or Comprehensive, enter the repository once, confirm authorization, and review the returned evidence-bound draft.

Advanced tools

Use Operations, Recovery, Scanner tools, and Retainer only when the assessment or operator workflow specifically requires them.