BC
Brad CodyAdministrator
Current productMatchmaking and assignments
Reverse spec drafted

Full matching run

Governed shortlist, review and offer preparation beyond advisory live scores.

Observed route/admin/matchmakingFuture Spec 10
Current maturityOffer-preparation prototype without exposed immutable run lifecycle
Evidence confidenceVerified
Last reviewedAugust 4, 2026
Visual evidenceDeferred during UI updates

Current-state summary

The full workspace supports subject selection, profile review, temporary criteria, a shortlist and a Send designer offers modal. What is not visible is the durable Match Run lifecycle promised by the product: run ID, queued/running state, criteria version, evaluated time, stale state, comparison, override reasons, history or rerun linkage. The current screen therefore behaves as a mutable matching form around seeded results rather than a reproducible governed run.

Interface inventory

Anatomy and verified behavior

Verification states separate observed behavior from requirements or assumptions.

ElementCurrent behaviorVerification
Run identityPolicy v2 is shown, but no Match Run ID, timestamp, criteria hash or engine version appears.Absent live
ShortlistCounter and add/remove actions are present.Verified live
Offer composerShortlisted candidates, summary, response deadline and pre-acceptance disclosure are present.Verified live
Run history/compareNo tabs or history surface appears.Absent live

User journeys

Current flows

01

Governed run to outreach

  1. Validate readiness
  2. Create immutable run
  3. Evaluate cohort
  4. Review explanations
  5. Save shortlist
  6. Prepare offers
  7. Confirm disclosure and send
Observed result

Only review, shortlist and preparation surfaces are visible; immutable execution is not evidenced.

State model

Current and expected states

Draft criteria

Temporary adjustment panel.

Completed result

Seeded candidate cards appear without completion metadata.

Stale/superseded

Not represented.

Queued/running/failed/partial

Not represented.

Outreach prepared

Offer modal appears.

Product rules

Non-negotiable boundaries

  • Completed runs are immutable and reproducible.
  • Rerun creates a linked successor and never mutates prior results.
  • A shortlist belongs to one run and subject.
  • Outreach validates run freshness and disclosure at send time.
  • Human selection and override require reasons and audit.
Dependencies
Readiness validatorCriteria SetMatch execution workerResult explanationsShortlistOffer serviceAudit/history

Known current limitations · 5 mapped

What is missing, broken or unverified

Future Spec 10 owns closure →
  1. No immutable run identity or lifecycle is visible.
  2. No compare, run history, override, exclusion or candidate-error experience exists.
  3. Seeded results can outlive their subject selection.
  4. Offer creation is reachable from inconsistent state.
  5. Actual execution and send were not tested.

Future alignment

Required evolution

  • 01Implement the Match Run lifecycle and workspace tabs from Spec 10.
  • 02Add comparison, history, freshness, failure and partial-result handling.
  • 03Require send-time subject/run/shortlist integrity validation.
  • 04Preserve outreach and assignment linkage back to the source run.

Current baseline

Acceptance record

  • Current run-related controls are documented without claiming an execution engine.
  • Offer preparation is evidenced but sending is not.
  • Missing immutable-run states are explicit.
  • Stale-result outreach is a release blocker.

Reverse-spec completeness

Documentation coverage

The interface is still changing, so visual evidence and repository tracing remain intentionally incomplete.

Purpose and user outcome

Documented

Roles and access

Documented

Routes and entry points

Documented

Page and component anatomy

Documented

Fields and displayed data

Documented

Primary actions

Documented

Forms and validation

Documented

States and transitions

Documented

Empty, loading and error states

Documented

Responsive behavior

Partial

Accessibility behavior

Partial

Activity and audit events

Partial

Data sources and persistence

Documented

Notifications and automation

Partial

Known defects and limitations

Documented

Reusable component dependencies

Documented

Future-spec conflicts

Partial

Visual and repository evidence

Deferred

Acceptance of current baseline

Documented