--- name: 3d-print-design description: "Use BEFORE cadquery or openscad skills. Gathers requirements, creates formal specifications, and validates design constraints for 3D printable objects. Triggers on: 'design a stand', 'create a holder', 'make a bracket', 'I need a mount for...', or any 3D printing design request." --- # 3D Print Design Skill Gather requirements and create formal specifications for 3D printable objects before implementation. > πŸ“‹ **Use this skill first**, then hand off to `cadquery` (preferred) or `openscad` for implementation. ## Design Process Overview ``` β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ 1. REQUIREMENTS β†’ 2. SPECIFICATION β†’ 3. TEST PLAN β†’ 4. IMPLEMENT β”‚ β”‚ (this skill) (this skill) (this skill) (cadquery) β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ ``` **Do not skip phases.** Each phase must be completed and approved before proceeding. ## Phase 1: Requirements Gathering (MANDATORY) **Before ANY design work**, use the AskUserQuestion tool to gather requirements. Ask too many questions rather than making assumptions. > ⚠️ **DO NOT SKIP ROUNDS.** Each round covers essential aspects of the design: > - Rounds 1-2: Structure type and device fit > - Round 3: Support configuration > - **Round 4: Construction (wall thickness AND corner style)** ← Often skipped, causes poor edge finishing > - Round 5: Printer constraints > > Skipping Round 4 leads to models with sharp edges that are uncomfortable to handle. ### How to Prompt Use AskUserQuestion with 2-4 focused questions per round. Group related questions together. Continue until all requirements are gathered. ### For Stands/Holders/Cradles **Round 1 - Device & Orientation:** ``` Question: "What device is this stand for?" Options: [User describes device] β†’ Follow up to get exact W Γ— D Γ— H dimensions Question: "Should the device be tilted?" Options: ["Flat (0Β°)", "Slight tilt (5-10Β°)", "Ergonomic tilt (12-15Β°)", "Steep (20Β°+)"] ``` **Round 2 - Stand Architecture:** ``` Question: "What type of stand structure?" Options: [ "Tray/Enclosure - box with hollow interior, device sits on top (Recommended for storage underneath)", "Open Frame - legs or rails with device resting on shelves (lighter, device visible)", "Platform - solid base slab with lip around edges (simple, heavy)" ] β†’ If "Open Frame", proceed to leg style question below β†’ If "Tray/Enclosure", skip to Round 3 β†’ If "Platform", skip to Round 4 ``` **Round 2b - Leg Style (Open Frame only):** Visualize options with ASCII diagrams: ``` SIDE RAILS / SLED BASE CORNER POSTS ───────────────────────── ───────────────────────── β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ device β”‚ β”‚ device β”‚ ────┴─────────────┴──── ────┴──┐ β”Œβ”€β”€β”΄β”€β”€β”€β”€ β”‚β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“β”‚ β”‚β–“β–“β”‚ β”‚β–“β–“β”‚ β”‚β–“β–“β–“ LEFT RAIL β–“β–“β–“β”‚ β”‚β–“β–“β”‚ β”‚β–“β–“β”‚ ════════════════════════ ════════════════════════ (continuous runners (4 discrete posts, along each side) minimal material) A-FRAME / EASEL PERIMETER FRAME ───────────────────────── ───────────────────────── ╱─────────╲ β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β•±β”‚ device β”‚β•² β”‚ device β”‚ β•± β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β•² ────┴─────────────┴──── β•±β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“β•² β”‚β–“β–“β”‚ β”‚β–“β–“β”‚ β•±β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“β•² β”‚β–“β–“β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜β–“β–“β”‚ ════════════════════════ ════════════════════════ (triangular profile, (thin rectangular frame, good for displays) modern floating look) ``` ``` Question: "What leg/base style for the open frame?" Options: [ "Side Rails - two continuous runners, device spans between (Recommended for two-piece printing)", "Corner Posts - four discrete legs at corners (minimal, device visible from all sides)", "A-Frame - triangular easel style (good for displays, tablets)", "Perimeter Frame - rectangular base frame with corner posts (modern, floating look)" ] β†’ If "Side Rails", follow up: "Should rails include crossbars for extra rigidity?" β†’ If "Corner Posts", follow up: "Post style: straight, tapered, or splayed outward?" ``` **Round 3 - Support Configuration:** ``` Question: "How should the device be held in place?" Options: [ "Shelf on all sides with front lip (most secure)", "Shelf on sides, open back for cables", "Minimal - just corners", "Let me specify each side" ] β†’ If "specify each side", ask about front/back/left/right individually ``` **Round 3 - Interior & Features:** ``` Question: "Does the stand need hollow interior storage?" Options: ["No - solid base", "Yes - for batteries/cables", "Yes - for specific items"] β†’ If yes, ask what goes inside with dimensions Question: "What openings are needed?" Options: ["Cable hole in back", "Ventilation slots", "USB/power access", "None", "Multiple"] ``` **Round 4 - Construction:** ``` Question: "How sturdy should this be?" Options: [ "Light duty (3mm walls) - decorative, light devices", "Standard (5mm walls) - most devices (Recommended)", "Heavy duty (8mm walls) - heavy equipment" ] Question: "Corner style?" Options: ["Rounded (8mm) - comfortable grip", "Subtle (3-5mm)", "Sharp - industrial look"] ``` **Round 5 - Printer:** ``` Question: "What printer will you use?" Options: ["Bambu P2S (256mm) (Recommended)", "Bambu P1S/A1 (256mm)", "Prusa MK4 (250Γ—210mm)", "Ender 3 (220mm)", "Other"] ``` ### For Boxes/Enclosures **Round 1:** What needs to fit inside? (get dimensions) **Round 2:** Lid type? (none, removable, hinged, sliding) **Round 3:** Wall thickness and mounting method? **Round 4:** Which sides need openings? ### For Brackets/Mounts **Round 1:** What's being mounted? (dimensions, weight) **Round 2:** Mounting surface? (wall, desk, pole) + attachment method? **Round 3:** Load direction? (hanging, resting, cantilevered) **Round 4:** Fixed or adjustable? ### For Cable Management **Round 1:** Cable diameter(s) and quantity? **Round 2:** Entry/exit configuration? **Round 3:** Mounting method? (adhesive, screw, clip-on) ### When Users Ask for Clarification If a user asks to clarify options or doesn't understand a choice, **visualize with ASCII side-view diagrams**. This is especially helpful for: - Tilt angle options - Slope compensation choices - Shelf vs lip configurations - Interior hollow space options **Example - Visualizing tilt/slope options:** ``` OPTION 1: Add tilt on top (stand tilt + device slope) ───────────────────────────────────────────────────── ___ ___/ | ← device ___/β–“β–“β–“β–“β–“β–“β–“| ___/β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“| |β–“β–“β–“β–“β–“β–“ STAND β–“β–“β–“| ════════════════════════════════════════════ ← desk OPTION 2: Compensate to level ───────────────────────────── _____________________ | device (level) | |β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“| \β–“β–“β–“β–“β–“ STAND β–“β–“β–“β–“β–“β–“β–“/ ════════════════════════════════════════════ ← desk ``` **Example - Visualizing shelf vs lip:** ``` SHELF (supports from below) LIP (retains from side) ───────────────────────────── ───────────────────────── β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ device β”‚ β”‚ device β”‚β–Œβ† lip β””β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“ ← shelf β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“β–“ ``` Include a summary table after the diagrams showing key differences between options. ## Phase 2: Formal Specification (MANDATORY) After gathering requirements, present a formal spec for user approval. **DO NOT proceed to implementation until the spec is approved.** ### Specification Template ```markdown # [Object Name] - Design Specification ## Overview | Field | Value | |-------|-------| | Object | [Name] | | Type | Stand / Box / Bracket / Mount / Other | | Architecture | Tray/Enclosure / Open Frame / Platform | | File | `[filename].py` | ## Device/Contents | Parameter | Value | |-----------|-------| | Model | [Device name] | | Width | ___ mm | | Depth | ___ mm | | Height | ___ mm | | Weight | ___ kg | | Clearance | ___ mm (default: 0.5) | ## Stand Geometry (if applicable) | Parameter | Value | Derivation | |-----------|-------|------------| | Tilt angle | ___Β° | User specified | | Front height | ___ mm | User specified | | Back height | ___ mm | front_height + depth Γ— tan(tilt) | | Stand width | ___ mm | device_width + clearanceΓ—2 + wallΓ—2 | | Stand depth | ___ mm | device_depth + clearanceΓ—2 + wallΓ—2 | ## Open Frame Structure (if Architecture = Open Frame) | Parameter | Value | |-----------|-------| | Leg style | Side Rails / Corner Posts / A-Frame / Perimeter Frame | | Leg/rail thickness | ___ mm | | Crossbars | Y/N (if side rails) | | Post shape | Straight / Tapered / Splayed (if corner posts) | ## Side Configuration | Side | Shelf | Lip | Shelf Width | Lip Height | |------|-------|-----|-------------|------------| | Front | Y/N | Y/N | ___ mm | ___ mm | | Back | Y/N | Y/N | ___ mm | ___ mm | | Left | Y/N | Y/N | ___ mm | ___ mm | | Right | Y/N | Y/N | ___ mm | ___ mm | ## Interior | Parameter | Value | |-----------|-------| | Hollow | Y/N | | Shape | [Description] | | Contents | [What goes inside, with dimensions] | ## Features | Feature | Enabled | Specification | |---------|---------|---------------| | Cable hole | Y/N | ___Γ—___mm, location, corner radius | | Ventilation | Y/N | [Description] | | Mounting holes | Y/N | [Description] | | Other | Y/N | [Description] | ## Construction | Parameter | Value | |-----------|-------| | Wall thickness | ___ mm | | Floor thickness | ___ mm | | Corner radius | ___ mm | | Bottom chamfer | 0.5 mm (elephant foot) | | Pocket fillet | 3 mm (stress relief) | ## Printer | Parameter | Value | |-----------|-------| | Target printer | [Name] | | Bed size | ___ Γ— ___ Γ— ___ mm | | Model footprint | ___ Γ— ___ mm | | Fit check | βœ“/βœ— | ``` **After presenting the spec, ask**: "Does this specification match what you want? Please review each section." ## Phase 3: Validate Spec Completeness Before implementation, verify the spec is complete: ### Checklist - [ ] All dimensions specified (no "TBD" or blanks) - [ ] Clearances defined for moving/fitted parts - [ ] Wall thickness appropriate for load - [ ] Corner radii specified - [ ] All features listed with dimensions - [ ] Printer fit verified - [ ] Interior contents fit verified (if hollow) ### Common Spec Gaps | Missing | Impact | Resolution | |---------|--------|------------| | Clearance not specified | Parts won't fit | Ask: "How tight should the fit be?" | | No corner radius | Sharp edges uncomfortable | Default to 3-5mm | | Wall thickness unclear | Strength unknown | Ask about load requirements | | Cable hole unspecified | Cables can't route | Ask about cable access | ## Manufacturing Constraints ### Minimum Wall Thickness | Application | Minimum | Recommended | |-------------|---------|-------------| | Decorative | 0.8 mm | 1.2 mm | | Functional | 1.2 mm | 2.0 mm | | Structural | 1.6 mm | 2.4 mm | | Load-bearing | 2.4 mm | 3.2 mm | ### Tolerances | Fit Type | Clearance | Use Case | |----------|-----------|----------| | Loose | 0.4-0.6 mm | Easy insertion, rattles OK | | Free | 0.2-0.3 mm | Smooth sliding fit | | Close | 0.1-0.15 mm | Snug fit, slight friction | | Press | -0.05 mm | Interference fit | ### Overhang Limits - **Maximum overhang without supports**: 45Β° - **Bridging limit**: ~50mm (printer dependent) - **Minimum hole diameter**: 2mm (horizontal), 1mm (vertical) ### Chamfers and Fillets | Location | Type | Size | Purpose | |----------|------|------|---------| | Bottom edges | Chamfer | 0.5 mm | Elephant foot prevention | | Top edges | Chamfer | 0.3-0.8 mm | Chip prevention | | Inside corners | Fillet | 2-3 mm | Stress relief | | Outside corners | Fillet | 3-8 mm | Grip comfort, aesthetics | ## Phase 4: Test Plan (MANDATORY) Before implementation, create a test plan that will validate the final model. Include this in the spec file. ### Test Plan Template ```markdown ## Test Plan ### Geometry Validation (run in code) 1. Overall dimensions match spec (width, depth, height Β±0.1mm) 2. Device pocket dimensions correct 3. All specified features present (shelves, lips, holes, etc.) 4. Model is watertight (valid solid) ### Fit Tests (visual/measurement) 1. Device fits in pocket with specified clearance 2. Ghost object shows correct placement 3. No interference between device and stand geometry ### Printability Tests (in slicer) 1. Each part fits on print bed 2. No unsupported overhangs > 45Β° 3. No bridging spans > 50mm 4. Layer orientation appropriate for load direction ### Assembly Tests (if multi-part) 1. Parts align correctly when joined 2. Snap-fits / tabs engage properly 3. Seam is flush (no step or gap) ### Functional Tests (post-print) 1. Device sits at correct angle 2. Device doesn't slide or tip 3. Cables can route as designed 4. Stand is stable on desk (doesn't rock) ``` ### Test Categories by Stand Type **Tray/Enclosure stands:** - Interior hollow space dimensions - Contents fit inside without interference - Shelf supports device at correct height - Cable holes accessible **Open Frame stands:** - Rails/legs provide stable support - No flex under device weight - Open areas don't compromise rigidity - Joints between parts are strong **Multi-piece designs:** - Each piece prints flat without supports - Assembly method works (snap-fit, bolts, etc.) - Assembled stand is rigid (no wobble at seams) ## Handoff to Implementation Once spec AND test plan are approved, hand off to implementation: ``` βœ… Spec approved + Test plan defined β†’ Use `cadquery` skill (PREFERRED) or `openscad` skill (if explicitly requested) ``` The implementation skill will receive the spec and generate code with validation functions that check the test plan items.