Use completion, linked snippets and live diagnostics

Start with current source analysis

Use completion to insert the intended supported token, and snippets to create an editable source pattern. The suggestions describe syntax and known symbols; choose circuit values and check the resulting source yourself. A suggestion or live text status is not a simulation result.

Extract the shared four-file teaching ZIP. Open cells.cir for local parameter completion and editor.cir for its include path. Use snippet.cir as the separate scratch file. Keep the files together; the paired navigation guide supplies the complete optional static C API client for agents.

Complete a local parameter without changing adjacent fields

1. In cells.cir, temporarily change Rseries in out RVAL to Rseries in out RV. Put the caret after RV and request completion with Ctrl+Space on Windows/Linux or Cmd+Space on macOS.
2. Select the RVAL parameter. Read its kind and contextual reference; its displayed default does not establish the effective value for every X instance. Escape dismisses the list and preserves RV.
3. Request completion again, select RVAL and press Tab or Enter. The whole RV value token becomes RVAL, preserving the resistor name and terminals. One Undo restores RV. Undo the original temporary edit to return to the saved teaching source.
4. Use the suggestion’s Reference/F1 or Definition/F12 actions when you need more context. These reference/navigation controls are documented; the scoped check here covers actual parameter acceptance/cancellation and Undo.

Complete a quoted include and correct a diagnostic

The checked include completion preserves existing quotes and can be undone. Other folder/quote/limit cases retain the maintained manual’s applicability limits. The native scenario waits for the real asynchronous candidate rather than treating an initial checking row as a filename.

1. In editor.cir, temporarily replace the include argument with "ce", leaving the closing quote. Put the caret after ce, inside the quotes, and request completion.
2. Wait for the directory result; a Checking/information row is not an insertable file. Select cells.cir and accept. The completed argument remains "cells.cir". Listing is relative to the saved containing source, not an arbitrary shell directory.
3. For the recovery exercise, temporarily change the argument to "absent.cir". Read the current incomplete-analysis diagnostic and its source location. Restore the real reference and wait for current analysis; the native check returns to Text: no issues.
4. Keep an unsaved buffer distinct from the disk copy. Save deliberately when the intended edit is ready. Before posting a diagnostic screenshot or JSON, review its source paths; a genuine path-bearing diagnostic image was withheld from this guide.

Insert and fill a linked subcircuit snippet

The native checks invoke the production insertion method with the actual built-in template and the production key handlers for field editing, Escape and Undo/Redo. Physical menu selection, all template/choice fields and user-library editing are not qualified by this check.

1. Open snippet.cir and place the caret at the start of the .END line. Choose Edit > Insert snippet > Blocks > Subcircuit block, or the corresponding editor context menu entry.
2. Replace the selected cell name with pair. The matching .ENDS name changes with it. Tab to the input, output and body fields; enter in, out and R1 in out 1000, respectively. Shift+Tab returns to an earlier field.
3. Escape ends field editing and keeps the inserted text. One Undo restores the source from before insertion, including the filled field edits. Redo restores the completed source. Save explicitly when you want it on disk.
4. The scratch file has no X instance, so an unused-subcircuit advisory can be expected. Use the reusable-cell guide to instantiate a cell and simulate a complete circuit. Keep actual errors and incomplete analysis separate from that advisory.

Use the same source contract from an agent

The paired navigation guide and the same ZIP provide inspect_editor.py, a complete static source-graph client. It reads saved files unless explicit included-source snapshots are supplied as overlays. Preserve its complete/incomplete verdict, diagnostic severities, declaration identities and source spans when proposing edits.

This API route supplies static inspection; it does not simulate the GUI completion popup or linked snippet session. Generate a complete source edit deliberately, inspect that exact generation and then run a suitable saved-circuit/numerical check when required. The CLI teaching check and native editor checks retain their separate meanings.

Save editor.cir

* Public editor navigation and completion teaching circuit
.INCLUDE "cells.cir"
.PARAM RB=1000
Vdrive input 0 DC 1
Xleft input left divider RVAL=RB
Xright input right divider RVAL=2*RB
.PRINT V(left) V(right)
.TRAN 1p 10p
.END

Save cells.cir

* A public resistive divider with a local parameter
.SUBCKT divider in out RVAL=1000
Rseries in out RVAL
Rshunt out 0 RVAL
.ENDS divider

Save snippet.cir

* Public scratch file for snippet insertion; no numerical result is implied
.END