Code step tour

Explain one code path as a self-contained HTML page. The left side is a file tree. The center is a sequence. 次のステップ reveals one arrow. The bottom lists the file, symbol, and line that perform that step.

Do not redraw this UI. Author a JSON file, then render it with the script next to this skill.

Trace first

Read the repository before writing JSON. Every symbol must be a function, callback, or method you opened. line is the 1-based line of that declaration or of the call that performs the step. If the line does not contain the symbol name, drop the symbol.

Keep one main path. Put optional, polling, or failure-only work on a later step with "kind": "dashed". A response that carries an id, key, or status is its own step with "kind": "return".

Use 2 to 6 actors and 3 to 12 steps. Actor ids are stable English tokens (user, ui, api). Labels and notes follow the user's language.

JSON

Write /tmp/code-step-tour/<slug>.json:

The block below is the file shape only. Replace every symbol with one you opened in the target repository.