cadSet/cad-experience-plugin/skills/cad-experience-builder/references/experience-library-schema.md

Published experience library

The published library uses schema version 2.0 and contains only promoted, generalized experience:

{
  "schema_version": "2.0",
  "library_kind": "generalized_cad_experience",
  "induction_mode": "llm_proposals_with_deterministic_evidence_verification",
  "policy": {
    "instance_parameters_allowed": false,
    "absolute_coordinates_allowed": false,
    "llm_semantic_review_required": true,
    "draft_evidence_verified": true,
    "router_consumable": true,
    "minimum_support": 20
  },
  "corpus_summary": {
    "accepted_case_count": 1000,
    "duplicate_case_count": 12
  },
  "experience_summary": {
    "llm_proposal_count": 24,
    "promoted_experience_count": 18,
    "candidate_experience_count": 6,
    "by_kind": [{"kind": "feature_motif", "count": 7}],
    "by_scope": [{"scope": "flanged_hub_adapter", "count": 5}]
  },
  "experiences": [
    {
      "id": "motif.base_flange+hollow_sleeve",
      "kind": "feature_motif",
      "scope": ["flanged_hub_adapter"],
      "when": {"features": ["base_flange", "hollow_sleeve"]},
      "guidance": "Treat these feature roles as a reusable composition.",
      "support": 243,
      "confidence": 0.91
    }
  ],
  "candidate_experiences": [
    {
      "id": "motif.flanged_hub_adapter.base_flange+hollow_sleeve",
      "kind": "feature_motif",
      "scope": ["flanged_hub_adapter"],
      "when": {"features": ["base_flange", "hollow_sleeve"]},
      "support": 7,
      "required_support": 20,
      "remaining_support": 13,
      "promotion_state": "candidate",
      "consumer_policy": "visible_for_review_but_not_available_to_cad_router"
    }
  ]
}

Allowed numeric values describe evidence strength or dimensionless distributions: support counts, confidence, frequency, percentiles, and sample counts. Absolute lengths, diameters, heights, radii, angles tied to a single case, positions, and coordinates are forbidden.

Consumers query this library by requested family and feature vocabulary. They must not receive the induction corpus, private case JSON, or candidate_experiences. Only experiences is executable guidance.

Reconstruction grammar

reconstruction_grammar is the executable bridge between generalized experience and a backend-neutral design plan. It may contain only:

• symbolic parameter_roles;
• symbolic datum_roles;
• required or optional semantic feature and relation roles;
• canonical stages with tokenized operation, feature, and reference roles;
• qualitative cardinality classes such as single, paired, repeated, or dense;
• validation roles.

It must not contain parameter values, exact member counts, absolute coordinates, source identifiers, face references, or executable teacher geometry. The publisher verifies that every promoted role and stage is present in enough independent private cases. A consumer instantiates the grammar using the user's dimensions, inferred dimensionless distributions, and backend operations.