qspice-schematic-layout

QSpice: Schematic Layout

How to place parts so a .qsch stays readable for humans: no stacked symbols, upright refdes/value text, and left-to-right signal flow when building ad-hoc topology.

When to use this skill

• Track A scratch authoring with add_component, add_dll_block, wires, and labels
• Any time the agent would guess (position_x, position_y) coordinates
• Before reporting a schematic as "complete" to the user

Preferred workflow

1. describe_topology_authoring_support — confirm layout tools are available.
2. For each new part (unless copying coordinates from a workflow table):
   • Call suggest_component_placement with schematic_path and component_kind, or
   • Call add_component with auto_place=true (same grid logic), or
   • For a known set of parts, call describe_schematic_layout_spec, write a v1 JSON file under the workspace, and batch-apply with apply_schematic_layout_spec.
3. Use the returned position_x, position_y, and rotation_degrees (default 0).
4. After a batch of placements, spot-check with read_component on key refs.
5. Nudge mistakes with set_component_position — the unified placement tool that moves and/or rotates (pass rotation_degrees, multiples of 45°). It preserves attached connections and normalizes refdes/value text by default (see below).
6. Spot-check connectivity with inspect_schematic before simulating.

Wired components: move / rotate keep the circuit intact by default

set_component_position is the one tool you need. It moves and/or rotates a part, and by default:

• preserve_connections=true — attached wire endpoints, junctions, and net labels follow the moved/rotated pins automatically (QSpice GUI drag parity). No manual remove_wire/add_wire refresh needed.
• normalize_text=true — refdes/value symbol text is reset to upright, left-to-right readability, compensating for the body rotation.