// user, org, role, skill, scenario, rubric, attempt, result, credential

$ define --platform="primitive_contracts"

AIducation now has an explicit contract map for the actual platform primitives behind the product: users, organizations, roles, skill atoms, scenarios, rubrics, missions, paths, assessments, attempts, results, credentials, manager reports, and org readiness dashboards.

[VIEW_CONTRACT_API][SKILL_GRAPH][ACCESS_MODEL]

Contract surface

14
Contracts
45
Relationships
58
Evidence outputs
42
Fail-closed rules
[+] The support wedge now sits on the same contracts as every other role academy.

// Contract_loop

These contracts make the platform legible from learner practice through enterprise reporting.

Define

Every primitive has required fields, ownership, relationships, source modules, and API surfaces.

Connect

Contracts explain how learners, roles, skill atoms, scenarios, rubrics, attempts, results, and credentials fit together.

Govern

Fail-closed rules keep identity, tenant, grading, visibility, credential, and dashboard evidence from drifting.

Prove

Each primitive names the evidence it creates for portfolios, managers, credentials, exports, and readiness dashboards.

// Primitive_contracts

Each contract states what the primitive owns, which fields are required, what evidence it produces, and where it is implemented.

View grading contracts
user

User

identity

Represents the learner, manager, admin, instructor, or API-linked person whose AI readiness evidence is being produced.

5
Fields
5
Links
4
Evidence
3
Rules

Owns

  • [+] Authentication identity
  • [+] Learner profile
  • [+] Role assignment
  • [+] Organization membership

Fail-closed

  • [rule] Private evidence writes require a resolved user.
  • [rule] Production auth must not fall back to demo identity.
  • [rule] Managers can only inspect learners inside their permitted org or team boundary.
APIidentityEvidence
organization

Organization

identity

Defines the tenant boundary for company academies, custom content, manager reports, exports, policy training, and enterprise integrations.

3
Fields
3
Links
5
Evidence
3
Rules

Owns

  • [+] Tenant identity
  • [+] Company academy
  • [+] Custom branding
  • [+] Approved AI tool catalog

Fail-closed

  • [rule] Org-only content cannot be read without a matching orgId.
  • [rule] Enterprise exports must include tenant identity but not private raw scenario contents.
  • [rule] Platform admins need explicit org context for tenant-scoped mutations.
APIidentityEvidence
skill_atom

Skill Atom

learning

Stores the smallest trainable and assessable AI capability across a role, workflow, tool, industry, or policy boundary.

8
Fields
3
Links
4
Evidence
3
Rules

Owns

  • [+] Trainable capability
  • [+] Failure modes
  • [+] Practice pattern
  • [+] Assessment configuration

Fail-closed

  • [rule] Draft skill atoms cannot count as learner readiness evidence.
  • [rule] Org-only skill atoms cannot leak into public catalogs.
  • [rule] Deprecated skill atoms remain visible only for historical evidence references.
APIlearningEvidence
scenario

Scenario

learning

Represents a realistic work situation used for simulations, drills, assessments, capstones, and company-specific practice.

7
Fields
4
Links
4
Evidence
3
Rules

Owns

  • [+] Scenario context
  • [+] Difficulty
  • [+] Ideal behaviors
  • [+] Linked skill atoms

Fail-closed

  • [rule] Private or org-only scenario text cannot be included in public proof artifacts.
  • [rule] Company-generated scenarios require privacy review before learner use.
  • [rule] Scenario attempts must reference the rubric contract version used at grading time.
APIlearningEvidence
rubric_contract

Rubric Contract

grading

Defines the versioned scoring standard that turns subjective AI workflow performance into comparable readiness evidence.

7
Fields
3
Links
4
Evidence
3
Rules

Owns

  • [+] Rubric dimensions
  • [+] Scoring configuration
  • [+] Failure modes
  • [+] Standards alignment

Fail-closed

  • [rule] Grading cannot persist without rubric contract identity or scoring fallback metadata.
  • [rule] Model output must validate before being accepted as rubric evidence.
  • [rule] Rubric changes require version history so old credentials remain explainable.
APIgradingEvidence
attempt

Attempt

grading

Captures a learner submission, workflow step, simulation turn, or mission action before it becomes a scored result.

5
Fields
3
Links
4
Evidence
3
Rules

Owns

  • [+] Submitted response
  • [+] Attempt number
  • [+] Scenario or step reference
  • [+] Session context

Fail-closed

  • [rule] Attempts require identity before being persisted as readiness evidence.
  • [rule] Oversized or prompt-injection-like submissions must be rejected or flagged before grading.
  • [rule] Attempt data is never exported without proof metadata and tenant filtering.
APIgradingEvidence
result

Result

grading

Stores the evaluated outcome of an attempt, including scores, feedback, failure modes, evidence, and skill atom performance.

8
Fields
3
Links
4
Evidence
3
Rules

Owns

  • [+] Scores
  • [+] Feedback
  • [+] Suggestions
  • [+] Dimension scores

Fail-closed

  • [rule] Result payloads must pass schema validation before persistence.
  • [rule] Failed safety gates cannot be hidden by high aggregate score.
  • [rule] Result exports expose proof references, not private raw responses by default.
APIgradingEvidence
credential

Credential

evidence

Proves a learner demonstrated a defined set of AI skills through certificates, badges, readiness scores, portfolios, and evidence trails.

8
Fields
3
Links
4
Evidence
3
Rules

Owns

  • [+] Certificate number
  • [+] Verification hash
  • [+] Credential status
  • [+] Skills completed

Fail-closed

  • [rule] Credential issuance requires passing score and required proof artifacts.
  • [rule] Revoked or expired credentials must verify as inactive.
  • [rule] Public verification cannot reveal private scenario text or learner submissions.
APIevidenceEvidence
org_readiness_dashboard

Org Readiness Dashboard

enterprise

Shows company-level AI capability, risk, policy comprehension, workflow improvement, credential coverage, and adoption value.

5
Fields
3
Links
5
Evidence
3
Rules

Owns

  • [+] Department readiness
  • [+] Skill coverage
  • [+] Adoption risk
  • [+] ROI confidence

Fail-closed

  • [rule] Dashboard rows require tenant-scoped source evidence.
  • [rule] Executive views should aggregate sensitive learner evidence by default.
  • [rule] Scale recommendations require readiness, risk, and proof artifact coverage.
APIenterpriseEvidence
role

Role

learning

Maps a learner to the AI workflows, tools, risks, skill atoms, scenarios, rubrics, and credentials that matter for their job.

6
Fields
3
Links
4
Evidence
3
Rules

Owns

  • [+] Role academy
  • [+] Vertical positioning
  • [+] Workflow scope
  • [+] Tool mission mix

Fail-closed

  • [rule] Unknown roles route to assessment instead of fabricated credentials.
  • [rule] Custom role curricula require source grounding before publishing.
  • [rule] Role policy enforcement must override generic workflow advice.
APIlearningEvidence
mission

Mission

learning

Packages practice into a guided loop that can include scenarios, tools, workflow steps, timed drills, daily practice, or team competition tasks.

6
Fields
3
Links
4
Evidence
3
Rules

Owns

  • [+] Practice objective
  • [+] Mission steps
  • [+] Target skill atoms
  • [+] Tool requirements

Fail-closed

  • [rule] Mission completion cannot award evidence without required step proof.
  • [rule] Tool missions must respect the approved tool catalog for the learner role.
  • [rule] Practice scoring cannot be promoted to credential evidence without the required rubric gate.
APIlearningEvidence
learning_path

Learning Path

learning

Orders baseline assessment, missions, simulations, tool practice, workflow proof, exit assessment, and credentials for a role or company academy.

6
Fields
3
Links
4
Evidence
3
Rules

Owns

  • [+] Path sequence
  • [+] Maturity track
  • [+] Role target
  • [+] Manager evidence plan

Fail-closed

  • [rule] A path without role context routes to role selection or baseline assessment.
  • [rule] Manager evidence is read-only until attempts and results exist.
  • [rule] Personalized paths must preserve tenant content visibility.
APIlearningEvidence
assessment

Assessment

grading

Measures baseline or exit readiness using role scenarios, rubric contracts, tool practice, and policy safety gates.

6
Fields
3
Links
4
Evidence
3
Rules

Owns

  • [+] Assessment timing
  • [+] Scenario set
  • [+] Pass criteria
  • [+] Blocking gates

Fail-closed

  • [rule] Exit assessment cannot issue credentials when blocking safety gates fail.
  • [rule] Baseline results must not overwrite historical exit evidence.
  • [rule] Assessment evidence must keep rubric contract version metadata.
APIgradingEvidence
manager_report

Manager Report

evidence

Turns learner results into team-level coaching, readiness movement, risk, credential progress, and next actions.

6
Fields
3
Links
4
Evidence
3
Rules

Owns

  • [+] Team rollup
  • [+] Learner rows
  • [+] Weak dimensions
  • [+] Coaching actions

Fail-closed

  • [rule] Managers cannot inspect another org or team without permission.
  • [rule] Reports must separate coaching insight from private raw learner content.
  • [rule] Exported reports require tenant, time period, and evidence references.
APIevidenceEvidence