forgecad-build-model

What it does

Create new ForgeCAD models in the user's active ForgeCAD project.

How it works

• Load the forgecad skill and read the Core API reference and related guides.
• Create a date-based directory structure under the user’s project: mkdir -p YYYY/MM/DD/[folder].
• Write the model using param() / Param.bool() for tunable dimensions and choose a manufacturing process before styling.
• Build real internals and ensure the model follows the manufacturing contract rules.
• Validate the model with forgecad run <file> (or main.forge.js for multi-file projects).
• Run the Final Acceptance Gate and Manufacturing Outputs checks on main.forge.js.
• Iterate by converting renders/inspections into targeted model edits and re-running evidence gathering until the model aligns with the intended component graph.

When to use it

Use when you need to create or edit a manufacture-realistic .forge.js model in a ForgeCAD project and subsequently validate it with run, render, inspect, and export evidence.

What it can touch

The skill references tools and scripts like forgecad run, forgecad render, forgecad inspect, forgecad debug assembly, and verify.* checks as part of the workflow. It instructs organizing files under YYYY/MM/DD/ directories and placing parts according to the described file layout, importing parts via require('./parts/name.forge.js', params) where applicable, and using assembly functions such as matchTo() and connect() for mating interfaces.

Caveats

The approach emphasizes producing a manufacture-realistic prototype and requires adherence to collision and verification policies. It relies on a process-first mindset (manufacturing process chosen before styling) and mandates real geometry with internal features, not just conceptual surfaces. It enforces a multi-step validation gate, including the Final Acceptance Gate and dedicated inspection commands. The final model should present zero unexpected collisions unless explicitly declared as intentional in the verification steps.