Idea detail
con_02_extension_tour
reqlan rq/marketing_and_media/tutorials.rq:1267
block
Summary
Audience: viewers who know the ontology nouns and want a calm map of where they appear in the product.
Outcome: name the primary extension surfaces and which job each owns; know where not to dig on day two.
Runtime: 8 – 10 min.
Demo: full get-started end state of `reqlan-tutorials-demo` ( `.reqlan`, `reqs/product.rq`, `reqs/auth.rq`, `src/login.ts` ); activity bar closed; Ideas Summary closed; chat available.
Related: extension activity_bar ideas_summary command_palette ai_integration html_export graph_view local_graph_view simple_views chat_skill_naming installation mcp_tools cli_package commands
Attributes
| Key | Value |
|---|---|
| example | ``` // Five tiles — spoken map, not typed into the editor // 1. Language support → open when authoring or navigating .rq source // 2. Activity bar → open when the question is "what sits near this idea?" // 3. Ideas Summary → open when you need a catalog, table, or focused map // 4. Chat / skills / MCP / palette → open when running a focused graph operation // 5. Export / CLI → open when the graph must leave the editor ``` |
| script | SCR: Title card — Concepts · 02 · Extension tour. Five blank tiles; first tile highlights. VO: You have the names. This episode shows where each one appears in the product. The extension is the host — language support plus views over the same graph the CLI and chat use. Five surfaces. One job each. Depth waits in Advanced. SCR: Tile 1 — editor with `product.rq`. Type one character; show highlighting. Ctrl/Cmd-click a bracket link; peek definition. VO: Surface one: language support. Open this when you are authoring or navigating `.rq` source. Ideas and references live in files — not in a sidebar form. Highlighting, go-to-definition, and bracket navigation are how the nouns stay honest in source control. SCR: Tile 2 — click reqlan activity bar. Caret on `welcome_flow`. Sync on; hop depth 1; copy-as-markdown flash. VO: Surface two: activity bar. Open this when the question is "what sits near this idea inside the active base?" Neighbourhood context, base picker when multiple bases exist, hop depth, copy slice — the local view you felt in get-started, not a workspace-wide dump. SCR: Tile 3 — Command Palette: Reqlan: Open Ideas Summary. Overview glance; Ideas tab with status column; Graph tab one pan — close without opening every tab. VO: Surface three: Ideas Summary. Open this when you need a catalog, a table, or a focused map. Its tabs mirror ideas, ideasets, references, attributes, and bases — use them when the question needs a list or a map, not as a mid-edit habit. If you are typing prose, do it in the editor; open Summary when you need to look something up. SCR: Tile 4 — split beat. Chat: `@reqlan /rq-search empty password`. Command Palette: type `Reqlan:` — show category list. Optional Cursor: `rq-search` skill name flash. VO: Surface four: chat, skills, MCP, and command palette. Open this when you want a focused graph operation — search, add-to-context, export, open Summary — the same small-slice habit as get-started. Skills use the `rq-` prefix; MCP tools share the same index. The palette is where you look when you forgot the exact slash command. SCR: Tile 5 — Command Palette: export HTML form header only, collapsed. Terminal: `npx reqlan search "empty password"` — show three lines of output; return to editor. VO: Surface five: export and CLI. Open this when the graph must leave the editor — static HTML per html_export, headless search per cli_package and commands. Extension and terminal share one analytical core; pick the host that fits the moment. The next concepts pack walks the CLI commands; Advanced covers graph craft, MCP skills, and CI judgement. SCR: Five tiles visible. On-screen quiz prompts appear one at a time — no clicking yet. VO: Try this — surface quiz, say it aloud before you click: one — copy a neighbourhood slice for chat; two — filter every idea marked draft; three — search by meaning when you forgot the idea name. Answers: activity bar, Ideas Summary tables, chat or palette search. If you hesitated on two, that is the Ideas Summary job — not the activity bar. SCR: End card — Concepts · CLI thumbnail. CTA from phonebook. VO: Map first. Next we name the terminal surface — then Advanced when you are ready to craft. |
| slides | { id title transition fade background brand-dark kicker Concepts · 02 heading Extension tour body Five surfaces — one job each. Map, not a laundry list. asset logo notes You named the nouns. This episode maps where they live in the product. }, { id language transition fade background brand-panel heading Language support body Open when authoring or navigating .rq source. code_lang rq code welcome_flow { … Success continues into onboarding_checklist. } notes Ideas and references live in files — not in a sidebar form. }, { id activity-bar transition none background brand-panel heading Activity bar body Open when the question is "what sits near this idea?" asset activity-bar notes Neighbourhood inside the active base — sync, hop depth, copy slice. }, { id ideas-summary transition fade background brand-panel heading Ideas Summary body Open when you need a catalog, table, or cartographic map. asset montage-ide notes Author in the editor; browse in Summary when the question changed. }, { id agents-palette transition fade background brand-panel heading Chat, skills, MCP, palette body Open when running a focused graph operation. asset chat-search code_lang txt code @reqlan /rq-search · Reqlan: · rq-search skill notes Same token discipline as get-started. Palette when you forgot the slash command. }, { id export-cli transition fade background brand-panel heading Export and CLI body Open when the graph must leave the editor. code_lang bash code Reqlan: Export HTML · npx reqlan search "…" notes Shared analytical core. Next concepts pack walks the CLI; Advanced covers craft and CI. }, { id recovery transition none background brand-contrast heading Recovery body Mid-edit in Ideas Summary? Pay navigation tax. Return to source. notes If you live in Summary while typing prose, the question changed — switch surfaces. }, { id quiz transition fade background brand-dark heading Try this — surface quiz body Neighbourhood copy · draft filter · meaning search — name the surface aloud. fragments Answers: activity bar · Ideas Summary · chat/palette notes Hesitated on draft filter? That is Ideas Summary tables — not the activity bar. }, { id end transition fade background brand-dark heading Map first. Terminal next. body Name the CLI surface — then Advanced when you are ready to craft. asset logo fragments Next — CLI notes Concepts · 03 walks init, search, analyse, parse, and export on the same index. } |
Ancestor context
No ancestor chain recorded.
| Kind | Idea | Path | Snippet |
|---|---|---|---|
| None | |||
| Kind | Idea | Path | Snippet |
|---|---|---|---|
| ideaset_member | concepts_series | reqlan rq/marketing_and_media/tutorials.rq | — |
| ideaset_member | slide_decks | reqlan rq/marketing_and_media/tutorials.rq | — |
| references | concepts_series_brief | reqlan rq/marketing_and_media/tutorials.rq | con_02_extension_tour |
| references | get_started_series_brief | reqlan rq/marketing_and_media/tutorials.rq | con_02_extension_tour |
| Kind | Idea | Path | Snippet |
|---|---|---|---|
| references | activity_bar | activity_bar | |
| references | ai_integration | ai_integration | |
| references | chat_skill_naming | chat_skill_naming | |
| references | cli_package | cli_package | |
| references | command_palette | command_palette | |
| references | commands | commands | |
| references | extension | extension | |
| references | graph_view | graph_view | |
| references | html_export | html_export | |
| references | ideas_summary | ideas_summary | |
| references | installation | installation | |
| references | local_graph_view | local_graph_view | |
| references | mcp_tools | mcp_tools | |
| references | onboarding_checklist | onboarding_checklist | |
| references | phonebook | phonebook | |
| references | simple_views | simple_views |
Initialising graph…