Cad sim project intake
Skill rolson24/cad-sim-agent-skills/skills/cad-sim-project-intake
Evidence-led agent skills for CAD, engineering artifacts, independent review, and bounded revision
npx -y skills add rolson24/cad-sim-agent-skills --skill cad-sim-project-intakeAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- 11 days oldThe repository was created 11 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Step 1 of the reset CAD workflow. Use first when the user gives a rough product, CAD part, robotics, electromechanical, fixture, simulation, optimization, or software-connected hardware prompt and Codex must grill the user before authoring. Produces the run root, source boundary when needed, open questions, captured answers, autonomy-after-grill contract, maturity/analysis/external-capability envelopes, prototype handoff intent, primary_outcome_surface intent, project_brief.yaml review_contract, next_action_worthiness, stage_frontier, design/option-space coverage, and exemplar_calibrated_handoff intent, and review_rubric. Also use in narrow surface re-intake mode when a review loop cannot infer audience, depth, decision target, or tradeoff priority for an existing primary outcome surface. After initial intake, use cad-sim-design-orchestrator; do not revise an existing annotation_view except to update intake/review-contract state during surface re-intake.
SKILL.md
37.1 KB, as published. Nobody here has run it
CAD Sim Project Intake
Contents
Invocation Order
- Use
cad-sim-project-intakefirst for a rough idea or a new run. - Use
cad-sim-design-orchestratornext afterintake/project_brief.yamlexists and CAD/system authoring should begin. - Use
cad-sim-review-revise-loopafter the design pass has produced a currenthandoff.jsonand canonicalannotation_view/. - When
cad-sim-review-revise-looproutes narrow surface re-intake, use this skill only to ask targeted questions and update the brief/review contract; return to the review loop afterward.
Use cad-sim-threaded-rehearsal-workflow instead of these individual steps
when the user wants a fresh-folder role-separation rehearsal with controller,
Rehearsal Agent, Meta-Agent, reviewer, and optional comparator.
Contract
Turn a rough CAD idea into one compact brief and rubric before any CAD
authoring starts. The completion criterion is a project_brief.yaml that lets a
Meta-Agent proceed without repeatedly asking the user for reminders, while
making clear how far it may continue autonomously before returning. When the
user wants minimal steering, compile an autonomy_after_grill contract that
lets the Meta-Agent keep working until the reviewer has no material feedback or
the next useful step truly needs user evidence.
The user does not need to create a run folder. If no run root is provided, create a timestamped run root under the active project folder, report it, and use that root for all intake artifacts.
Minimal Artifacts
Write under the active run or study root. If there is no active run root, create one before writing:
source_boundary_preflight.yaml # only for source-blind or comparator-sensitive runs
intake/project_brief.yaml
intake/open_questions.md # only while waiting for user answers
intake/surface_reintake_NNN.yaml # only for narrow surface re-intake
project_brief.yaml is the single source of truth for initial prompt, bounded
research notes, grill questions, user answers, requirements, assumptions,
review contract, review rubric, and stop rules. Do not create separate
interview, requirement, issue-ledger, or validation-plan files unless the run has
a specific reason to split them.
Use source_boundary_preflight.yaml only as a compact boundary lock before
active authoring inspects context that could contaminate a source-blind run.
Surface Re-Intake Mode
Use narrow surface re-intake only when an existing run already has a candidate or primary outcome surface, but the Meta-Agent or reviewer cannot infer what the user values, who the surface is for, what depth matters, what decision it supports, or which tradeoff priority controls the work.
Ask 1-3 directed questions with concrete options. Good question targets include audience, next real action, depth allocation, decision target, tradeoff priority, and whether the surface should be a website, guide, report, notebook, dashboard, robot bring-up guide, simulator packet, CAD handoff, or evidence packet. Do not ask broad questions such as "What do you think?".
Write intake/surface_reintake_NNN.yaml with the questions, answer options,
safe default if any, and resume point. Update intake/project_brief.yaml with a
compact primary_outcome_surface block and any review-contract acceptance tests
created by the answer. Do not author, revise, or review the candidate; return to
cad-sim-review-revise-loop.
Workflow
- Choose the run root. Use the provided root when one is explicit; otherwise create a timestamped root under the active project and record the path in the response or workflow state.
- Read the user prompt, allowed local references, and named source-boundary
rules. Only read raw-session packets when the role's allowlist explicitly
names them. For source-blind, comparator-sensitive, or rehearsal runs, lock
the source boundary before the active Meta-Agent reads memory files, workflow
state, previous run folders, comparator outputs, raw solution material, or
local reset-repo skill files. Write
source_boundary_preflight.yamlwith the role, allowed inputs, forbidden inputs, and a note that no pre-lock memory or workflow-state inspection occurred. If the boundary is unclear, stop asneeds_source_boundary_preflightinstead of inspecting more context to infer it. - Gather only context that changes the first grill or rubric. Cite or name the
source in
research_notes; skip broad research when the prompt is already concrete enough. - Ask one consolidated grill. First identify the project domain mix:
mechanical/CAD, printable part, robotics, electromechanical, fixture,
enclosure, software-connected hardware, or other. Cover the relevant
interfaces, envelope, attachment, retention, loads/motions, purchased or
reused hardware, electrical/power/signal interfaces, sensors/actuators,
firmware/software/control assumptions, tools, assembly and install/remove
sequence, print or fabrication process, intended real-world use,
validation/simulation needs, materials/process assumptions, visual
references, success criteria, rejection criteria, and evidence limits.
When analysis or optimization may matter, classify the analysis intent:
design_aidfor quick checks that catch mistakes,physically_reasonable_optimized_designfor a buildable baseline followed by bounded variant improvement, orsimulation_optimization_studywhen simulation/optimization is the main project and CAD is one artifact inside the study. When the user wants the system to get as far as possible before returning, also ask for an autonomy-after-grill contract: preferred autonomy mode, acceptable default hardware/materials, printer/process assumptions, dimensional variants, whether bounded online research, browser use, computer use for simulator UIs, datasheet lookup, package/library install, CAD/reference-file download, locally authored simulations, GPU simulation frameworks such as Warp, open-source simulators, commercial simulators, orcad-sim-tooling-research-scoutare allowed, which analysis or simulation tiers are allowed, which decisions require the user, which evidence requires physical measurement or testing, and whetherneeds_userpauses should resume automatically after the answer. Also ask how the user wants later clarification handled: one phone-friendly question at a time or a compact batch, preferred answer format, which decisions may be defaulted, and which questions require desktop review or inspecting files. When the prompt asks for high autonomy, manufacturing, printing, ordering parts, or "tell me what to buy/build," ask whether the desired first user review should targetprototype_handoff_review_ready: a compact BOM, custom manufacturing handoff, assembly/use and first-test instructions, visible retention/fastener paths, and no unexplained visible geometry. Include why each question matters. When the user asks for a prototype handoff, high autonomy, or easy review, also ask whether an interactive assembly/manufacturing handoff surface is allowed or desired when useful. Explain that this can be a compact HTML page, linkedviewer3dview, simple stepper, animation, simulator view, or other small artifact, but only when it makes manufacture, assembly, use/removal, or first-test review clearer. When a prototype handoff or user-facing guide is likely, ask what primary handoff surface the user expects to review, or choose a default such asassembly_guide.html,design_review_packet.html,build_use_package.md,prototype_handoff/index.html, or an equivalent project-specific surface. Also capture the short list of actions that surface must let the user review, such as buy, print, machine, prepare, assemble, install, use, remove, inspect, test, reject, flash, calibrate, or simulate. Capture enough information to seedannotation_view/primary_outcome_surface_brief.yaml: audience, next real action, primary surface type/path, canonical entities/artifacts, critical claims, topics that deserve deep treatment, topics that should stay compact, required sections or states, evidence the user expects embedded, launch expectations, and explicit non-claims. Existing legacy runs may still useannotation_view/primary_surface_brief.yaml. Add a compact rubric-customization grill when A+ handoff, high autonomy, optimization, simulation, real-world build/use, or a primary guide is likely. Ask what A+ would mean in the user's words, which risks matter most, what evidence would convince them, whether they want one evidence-embedded primary website or equivalent front door, and how much design-option exploration is worth doing. Default to one embedded primary handoff surface for A+ work: readiness-critical CAD views, staged states, plots, tables, calculations, simulator exports, procurement examples, and design-decision evidence should be visible in the primary artifact, while raw files remain audit/download links. Default option exploration to a compact comparison of 2-4 plausible approaches for behavior-critical decisions; create full alternate CAD or simulation variants only when cheap and likely to change the selected design. When high autonomy, A+ handoff, prototype handoff, simulation/optimization, a primary outcome surface, or minimal future steering is in scope, record compactexemplar_calibrated_handoffintent. Default it to active withreusable_tests_expected: trueand choose 2-5 emphasis tags from the project, such asprocedural_clarity,mechanism_legibility,design_story,simulation_decision_packet,robot_bringup,software_setup_diagnostics, orevidence_maturity. Do not create a separate rubric here; this seeds active-rubric rows later. For high-autonomy prototype handoffs, record a compacthandoff_quality_bar: the primary audience is a practical non-CAD builder, the secondary audience is a competent engineer/auditor, instruction density should be detailed but skimmable, the default ready threshold isA_plus_builder_handoff, and the tooling-scout policy isseparate_agent_when_in_doubt. Also record that critical design decision evidence closure is required for A+ readiness: the Meta-Agent and reviewer should identify behavior-critical choices and evidence-close them at the right fidelity tier before asking for user review. Recorddesign_decision_coveragefor A+ handoff, optimization, simulation, raw-parity autonomy, or real-world build/use projects. Use the leading phrasedesign-decision coverage: important non-obvious choices must be named, justified, and evidence-backed, not merely discovered ad hoc by a reviewer. Choose compactexpected_decision_typesfrom the project, such as geometry/features, retention/fastening/load path, material/process, manufacturing/print orientation, assembly/tool access, simulator/tooling choice, optimization variables/objectives, validation strategy, and claim boundaries. Also recordoption_space_coveragefor the same projects: the system must compare plausible options for behavior-critical or trust-critical choices, or explicitly explain why alternatives are not useful. Keep this as a light design-decision standard, not a mandatory multi-branch CAD pipeline. When this A+ threshold is requested, also plan amasters_engineering_submissionscore rubric using the sharedcad-sim-reviewer-lenses/references/master_engineering_handoff_rubric.mdandcad-sim-reviewer-lenses/references/submission_grade_calibration.mdreference and the profile overlays incad-sim-reviewer-lenses/references/rubric_profiles.md. Selectreview_rubric.profilefromphysical_prototype,robotics_electromechanical,simulation_optimization,software_connected_hardware,design_review_only, orhybrid. For hybrids, choose one primary profile and list secondary checks instead of merging every checklist. Keep the rubric compact and project-specific insideproject_brief.yaml; split tointake/review_rubric.mdonly if it would make the brief unwieldy. Also record compactreview_rubric.profile_critical_risksfrom the selected profile so later reviewers do not wait for the user to name obvious checks such as mechanism confidence, sourcing, manufacturability, model fidelity, wiring/config, or validation boundaries. Recordreview_rubric.submission_grade_calibrationwithgrade_as_submitted_now: true,route_grade_separation_required: true, and a profile-specific note about what evidence maturity would be required for A/A+. The default is that useful route readiness can exceed the submitted-now grade. When the project is simulation-heavy, optimization-heavy, domain-unfamiliar, commercial-tool-sensitive, or likely to need a custom review surface, ask a compact tooling decision grill before first CAD. Do not leave the answer asask_first. Force the user to chooserequired_before_first_design,allowed_when_triggered, orforbiddenfor a tooling scout; identify the decision owner (separate_tooling_scout,inline_meta_agent, oruser_selected_tool); choose whether the scout may only recommend, run small allowed probes, or request approval for installs/runs; and chooseprogrammatic_first,balanced, orcapability_firstfor agent operability. Separately resolve whether simulation may be selected and run within the allowed tier, must be recommended and approved, or is forbidden without new approval. Ask separately about web access, downloads, package installs, local scripts, GUI automation, credentials, cloud/GPU jobs, paid tools, and private-file upload. Ask for capabilities and boundaries rather than making the user choose an unfamiliar product name. Clarify that a separate scout chooses tools and evidence strategy; it does not judge or author the design. If the user explicitly authorizes safe assumptions, default toallowed_when_triggered,recommend_only,balanced, andscout_recommends_then_asks, while preserving narrower capability policies. - Stop for the user's answers unless the user explicitly says to proceed by
assumption. While stopped, keep only
intake/open_questions.md. - After answers arrive, write
intake/project_brief.yamland provisional Quality Harness intent. Treat the first answers as the point where intake becomes a draft contract: capture resolved grill rounds in the brief, create compact candidate rows forquality/quality_harness.yamlthrough$cad-sim-quality-harnesswhen high autonomy, prototype handoff, simulation/optimization, robotics/electromechanical, Garmin-style mount, canoe-study, or A+ review quality is in scope, and ask at most one Quality Harness targeted drilldown round when missing facts would change a required harness row, verifier, boundary, objective, or next real action. Use 1-3 pointed questions. If uncertainty can be bounded honestly, recordphysical_boundary,user_boundary, orstage_approvalinstead of asking indefinitely. New runs must writeschema_version: 2, select anacceptance_profile, include every mandatory row fromreferences/profile_contracts.yaml, and add no more than three run-specific risk rows. Preserve V1 harnesses when resuming an existing run.intake/open_questions.mdexists only while waiting; after answers, resolved drilldown terms, project vocabulary, and decisions live inproject_brief.yaml, not repo-levelCONTEXT.mdor ADRs. Thegrill-with-docspattern is inspiration for drilling into the answer, not a literal artifact format for reset CAD runs. For every project that activated the tooling decision grill, also write the compacttooling_strategyblock from the brief template. Setdecision_status: answered; preserve the chosen scout, execution, agent-operability, simulation, and evidence-export policies; and require a ready-route receipt attooling/tooling_scout.md. The receipt may honestly choose the default stack or no extra tooling, but a tool-sensitive run may not become ready with an unrecorded tooling/simulation decision. - Convert unresolved answers into named assumptions or
needs_userblockers; do not hide them in prose. Settarget_maturity, defaulting toconcept_review_ready. Usebuild_use_review_readywhen the user asks for raw-Codex-like first deliverables, instructions for what to buy or assemble, or stricter review before user inspection. Useprototype_handoff_review_readywhen the user wants a first-prototype package: what to buy, what to fabricate/order/print, how to assemble and inspect it, how retention/fastening works, and what physical tests remain, without implying production readiness or validated safety/fit. Also setautonomous_review_depth: useraw_codex_paritywhen the user wants fewer later nudges or asks the system to keep improving before user review; usematurity_ladderwhen the user wants the Meta-Agent to self-promote as far as the evidence allows; otherwise usefirst_review. Addautonomy_after_grillwhen the answer changes behavior. Default tomaximize_until_evidence_boundarywhen the user says to keep going, minimize nudges, or behave like a strong raw Codex session. - Add an
autonomy_envelopeonly when it changes behavior. Keep it compact: autonomy bias, assumptions the Meta-Agent may make, clarification triggers, external-evidence stop points, allowed research/download/simulation/browser or computer-use capabilities, and a reviewer-owned maturity ladder. Treat the ladder as a soft review policy, not a coded checklist. A typical printable-hardware ladder is:concept_review_ready->build_use_review_ready->pre_print_review_ready->prototype_handoff_review_ready. The pre-print tier means stronger CAD/build/use closure, print orientation and fit-check planning, hardware traceability, risk/non-claim clarity, and first bench-test guidance, not road-safety, strength, waterproofing, or fabrication proof. The prototype-handoff tier additionally asks for a compact BOM, smallest useful custom manufacturing outputs, visible retention/fastener closure, assembly/inspection/first-test steps, and removal or explanation of visible mystery geometry. For robotics, electromechanical, or software-connected projects, choose relevant labels such assystem_integration_review_readyorprototype_plan_review_ready; do not force print-specific tiers when the project is not mainly printable. Forautonomous_review_depth: raw_codex_parity, add one optional investigation tier when it would change reviewer behavior:mechanical_use_investigation_readyfor hardware/mechanism work,system_integration_investigation_readyfor robotics or electromechanical work, ordomain_investigation_review_readyas a generic fallback. This tier asks for one bounded self-contained investigation before user review, not a proof, solver validation, or new artifact family. Add a compactanalysis_intentandanalysis_envelopewhen they would change behavior. This is a soft policy for useful checks before user review, not a hard simulation gate. Keepanalysis_intentto mode, objective, optimization scope, and claim boundaries; do not create a new state machine. Usedesign_aidfor most simple CAD projects. Usephysically_reasonable_optimized_designwhen the user wants a real object improved against objectives: first make a coherent baseline, then run a bounded variant sweep or comparison without breaking physical/build/use constraints. Usesimulation_optimization_studyfor projects such as hull, aero, thermal, robotics, or control studies where scenarios, metrics, calibration, and optimization are the core deliverable before final CAD. Allowed tiers may includepaper_sanity,lookup_backed_estimate,lightweight_numeric_check,lightweight_simulation,local_gpu_simulation,solver_simulation, andcommercial_simulator_run. Addoptimization_looponly when optimization is the project or the user explicitly asks for bounded optimization. Default away from heavy solvers unless the user allows them and the model has meaningful loads, materials, and boundary conditions. For external simulator capability, record permission once as a compact policy: local scripts and small simulations may be allowed by default; web research, browser use, computer use, package installs, downloads, Warp or other GPU frameworks, open-source solver setup, and commercial simulator use each need a clear allowed/ask-first/forbidden value. Always ask before spending money, accepting licenses, entering credentials, uploading private files, installing large packages, running long/cloud/GPU jobs, or making safety/compliance/performance-proof claims. Require a fidelity note for any analysis or simulation: what it models, what it omits, key assumptions, real-world evidence needed, and claims it does not support. Keepautonomy_after_grillseparate from the envelope as the user-facing operating contract. Use modes such asfirst_review,build_use,system_integration,pre_print, ormaximize_until_evidence_boundary. Recordallowed_self_decisions,ask_user_before,resume_after_user_answer,revision_budget, andanalysis_budget,clarification_style, andphone_review_ok. This is the contract the review loop should use to decide whether to keep working, pause for a precise answer, or stop for user review. Recordinteraction_closure_targetswhen they change behavior: the build, install, use, service, software/control, calibration, and test touchpoints the reviewer should reason through as one user workflow. Recordnext_action_worthinesswhen high autonomy, A+ handoff, manufacturing/execution, simulation/optimization, or a user-facing primary handoff is in scope. Use the leading phrase Next-Action Worthiness: identify the likely next real user action, the user's cost or risk, what the packet must make clear before that action is worth taking, and which improvements remain allowed inside the current stage. Recordstage_frontierwhen the user requests high autonomy, A+ handoff, manufacturing, simulation, optimization, raw-parity behavior, or "get as far as you can." Use the leading phrase Stage Frontier: the reviewer should be ambitious about the next useful stage, but the Meta-Agent may only work autonomously inside the currently approved stage. Derivecurrent_stagefromtarget_maturity; recordapproved_stage_scope,allowed_within_stage,ask_before_next_stage, andstage_entry_tooling_scout_policy: allowed_before_each_stage_when_useful. Typical allowed in-stage work is cheap checks, guide/evidence improvements, local tooling-scout recommendations, bounded local analysis, slicer preview, and CAD revisions needed to satisfy the current-stage rubric. Typical ask-first next stages are major redesign, broader optimization, heavy simulation/FEA/CFD, commercial or licensed tools, production-grade website work, physical testing, and broader validation. Print-time, support-material, sourcing, slicer preview, or evidence-embedding work is in-stage when it determines whether the same approved next action, such as printing or bench testing, is worth doing; treat it as a frontier only when it expands into a broader optimization or redesign stage. - Build a compact
review_contractbefore thereview_rubric. The contract is the project-specific reviewer memory and completion criterion: ready criteria, user complaint acceptance tests, resolved promises that must not regress, and likely user nudges to avoid. Keep it insideproject_brief.yamlunless the run has a strong reason to split it out. New user complaints should becomeopen_issueswith a concrete acceptance test; they are not resolved until a later reviewer confirms current evidence. Build areview_rubricthat catches the reminders the user would otherwise have to send later: missing major interface, invisible retention, unsupported fit/load/manufacturing claim, vague native traceability, or design output that validates as files but reads as a schematic. Include a visual-evidence check when the design will be reviewed visually:reviewable_product_conceptrequires actual render-mesh views, not only schematic dimension plots. Whenhandoff_quality_bar.ready_thresholdisA_plus_builder_handoff, setreview_rubric.grading_mode: masters_engineering_submission,review_rubric.profile,target_points: 95, grade thresholds, route/grade separation policy, and 100 total points across the default categories frommaster_engineering_handoff_rubric.mdplus the selected profile fromrubric_profiles.md. Customize category weights, notes, and deduction examples to the project so the reviewer grades like a strict master-level engineering instructor, not a checklist completer. Include multiple project-specific deduction examples with rough point ranges for small, moderate, major, and severe issues; tell the reviewer to apply multiple deductions within a category when multiple independent defects are present. Do not encode hard caps for broad evidence types; use calibrated point deductions instead. Unless the user timeboxes the work, setminimum_a_plus_review_depth: 3so A+ is not awarded from one permissive pass; a lower route can still stop earlier when the remaining gap is user measurement, physical testing, approval, purchase, credential, license, heavy install, or a large/long run. Keep the intake rubric as intent and initial calibration. The review loop's Active Rubric Compilation may later compile or refreshintake/active_review_rubric.yamlfrom this intent, current open issues, selected profile, route policy, option-space requirements, minimum viable alternative evidence expectations, and evidence-container requirements. That compiled rubric should be a contract-only object that records required evidence quality targets, not the current packet's pass/fail status. Once compiled, keep only compact pointers inproject_brief.yaml.review_rubric; do not duplicate the full active rubric or Quality Harness rows in multiple places. When the harness is required, recordproject_brief.yaml.review_rubric.quality_harness.path: quality/quality_harness.yamland letquality_harness.yamlremain the single source of truth for falsifiable rows. Record profile-specific A+ requirements. Examples: forphysical_prototype, main mechanism confidence, procurement, manufacturing or printability, assembly, and first-test evidence must be strong; forsimulation_optimization, objectives, scenarios, model fidelity, optimization variables, tradeoffs, and validation boundaries must be strong; forrobotics_electromechanical, mechanical/electrical/software integration, calibration, diagnostics, and bench tests must agree. A polished page alone should not satisfy A+ for any profile. For high-autonomy A+ projects, record that disputed profile-critical choices need exploration confidence, not just explanation confidence: a compact alternative sketch, CAD-backed variant, staged comparison, calculation, scenario/variant result, or tooling-scout export should challenge the selected option when that work is self-contained. For hardware, accessory, mount, enclosure, bracket, fixture, or mechanism concepts, include a lightweightmechanical_feasibility_sanitycheck: actual views should show plausible non-colliding interface, load/retention, fastening/removal, and hand/tool-access paths. This is a first-review visual sanity check, not a solver, fit, safety, or manufacturing claim. For robotics, electromechanical, or software-connected hardware, include asystem_integration_sanitycheck: mechanical layout, power/signal routing, sensors/actuators, firmware/software/control assumptions, calibration, and bench-test plan agree at a first-review level without claiming validation. For therobotics_electromechanicalacceptance profile, require the hash-boundquality/system_interface_manifest.yamldefined inartifact_contract/README.md; local subsystem passes use AND semantics with every declared interface and cannot average away a mismatch. Whentarget_maturityisbuild_use_review_readyorprototype_handoff_review_ready, include build/use closure checks for CAD-to-instruction consistency, purchased hardware traceability, assembly/tool access, print-orientation/load-path alignment, and validation assumptions matching real use. Include assembly/action grounding when instructions are part of the expected output: important physical actions should map to actual exported parts, visible features, hardware, access/clearance, and sequence state, especially split/separable parts, insertion/removal, routed straps, tightened fasteners, connector/service access, and custom manufacturing outputs. Forprototype_handoff_review_ready, also include prototype handoff checks: no unexplained visible geometry, retention or fastening closure visible in CAD and instructions, compact BOM, custom manufactured outputs or ordering instructions, assembly/inspection/first-test steps, and explicit non-claims. If the user requested or allowed an interactive handoff surface, include a softinteractive_handoff_surfacecheck: the surface must be grounded in CAD/system evidence, link or label exact manufacturing files/results, show meaningful step states, and make the user workflow reviewable without hidden inference. Include acritical_design_decision_evidencecheck for A+ handoff, optimization, simulation, and real-world-use projects: behavior-critical choices must have evidence appropriate to the claim, such as CAD-backed state, dimension check, calculation, lightweight simulation, external tool output, or explicit user/physical-test boundary. Clean prose or a surrogate diagram is not enough when canonical CAD/viewer evidence, manufacturing files, or the primary guide tell a different physical story. Include adesign_decision_coveragecheck for the same projects: the packet must identify important non-obvious decisions before review. Missing decisions are defects even when the visible CAD and guide look polished. The reviewer should usecad-sim-reviewer-lenses/references/design_decision_evidence_closure.mdand distinguish covered decisions, missing decisions, and under-evidenced decisions. Include a rubric deduction example for proxy visuals when the project's main behavior depends on physical motion, force, material, fluid, signal, or user action: proxy evidence can support review, but cannot earn full A+ behavior credit unless it makes the real behavior believable or is paired with a stronger test, analysis, simulation, or explicit physical boundary and first test plan. Whentarget_maturityisprototype_handoff_review_ready, or when a primary handoff surface is requested, include anaction_grounded_primary_handoffrubric item: the primary artifact must satisfy the shared action-grounded prototype handoff standard fromcad-sim-reviewer-lenses/references/assembly_and_prototype_handoff.md, not merely link to details scattered elsewhere. If external capabilities are allowed, include a soft check that the Meta-Agent should use a bounded lookup, downloaded reference, lightweight simulator, orcad-sim-tooling-research-scoutbefore user review when it would resolve a major self-contained uncertainty. Prefer the scout when the project is simulation-heavy, optimization-heavy, domain-unfamiliar, or tooling-sensitive. Include ananalysis_or_simulation_opportunitycheck when the project has mechanics, actuation, power, sensing, controls, fixtures, or real-world use assumptions where a cheap calculation, lookup-backed estimate, numeric check, or lightweight simulation could catch a first-build mismatch. The check should routecontinue_autonomousonly when the work is self-contained, allowed by the analysis envelope, and likely to reduce user steering; otherwise it should recordnot_useful,needs_user_measurement, orphysical_test_required. For optimization-oriented projects, include anoptimization_reasonablenesscheck: the baseline must be physically coherent before optimization, the objectives and constraints must be explicit, design variables must be bounded, and selected variants must not win by breaking build/use, integration, safety-boundary, or solver-fidelity assumptions. Include aninteraction_closurecheck for any project that must be built, installed, used, serviced, calibrated, controlled, or tested: the CAD or system design, bought/reused parts, tools, assembly steps, access paths, software/control assumptions, and validation plan should agree as one real workflow. Include aprototype_readiness_continuationcheck when the user wants high autonomy: beforeready_for_user, the reviewer should ask whether one more cheap allowed step would make the packet more prototype-ready or prevent a likely later nudge, without demanding physical proof. - Set
stop_rules.max_revisions, defaulting to2, or3forautonomous_review_depth: raw_codex_parityunless the user asked for a light smoke or strict timebox. Defineuser_review_ready_meansas no material rubric issue, open review-contract issue, regression, or high-value autonomous improvement remaining within the budget. Forautonomous_review_depth: raw_codex_parityormaturity_ladder, includecontinue_until_reviewer_has_no_autonomous_feedback: true. When the autonomy envelope allows self-promotion, also includeallow_maturity_promotion: trueand a concisepromotion_policy: promote only when the current tier is clean and the next tier can be improved from allowed inputs; ask the user when the next tier depends on a major preference, missing dimension, safety boundary, purchased part choice, or physical test. Includeneeds_user_is_resumable: truewhen the user wants minimal interruption: a clarification should pause with one precise question and resume the same loop after the answer, not require the user to restate the goal or say "continue." - Route to
cad-sim-design-orchestratoronly after the brief has the user's answers or explicit proceed-by-assumption permission. If the answer message also says to continue, route directly; otherwise stop atready_for_design.
Brief Shape
Do not preload the expanded brief template. After the consolidated grill
answers are recorded, read references/project_brief_template.md completely
and use its Brief Shape section as the authoritative shape for
intake/project_brief.yaml. Keep this core skill loaded during the grill;
lazy-load the template only when it is time to synthesize the answered brief.
Routes
awaiting_answers:intake/open_questions.mdexists and CAD has not started.ready_for_design:project_brief.yamlis complete enough for CAD.needs_source_boundary_preflight: a source-blind or comparator-sensitive run needs a boundary lock before active authoring can inspect more context.needs_user: a missing answer would make the CAD misleading. Treat this as a resumable pause whenneeds_user_is_resumableorautonomy_after_grill.resume_after_user_answeris true: record one precise question, why it matters, the preferred answer format,resume_from, remaining revision or analysis budget, and the next action after the answer. After the answer arrives, updateproject_brief.yamland resume without asking the user to restate the goal or say "continue."blocked: required evidence or files are unavailable.invalid_boundary: the requested source-blind boundary cannot be preserved.