Idea detail
adv_overview
reqlan rq/marketing_and_media/tutorials.rq:1601
Summary
Audience: viewers who finished get-started and concepts ( or equivalent ) and want the map of craft themes before committing to a deep dive.
Outcome: name the eight advanced themes, understand how they connect to get-started discipline, and pick a first episode.
Runtime: 3 – 4 min.
Demo: `reqlan-tutorials-demo` at advanced baseline — multi-file graph, `.reqlan` present, no new files typed; montage only.
Related: advanced_series_brief general_purpose llm_first concepts_series base multi_base_environment
Attributes
| Key | Value |
|---|---|
| example | ``` // Theme map — spoken over montage, not typed live // 01 imports/ideasets → split files, honest links // 02 attributes/plans → metadata that earns its keep // 03 Ideas Summary graph → cartographic cuts, not dumps // 04 context/tokens → compose slices, pin sparingly // 05 comment references → round-trip from code // 06 HTML export → graph leaves the editor // 07 CLI/MCP → same index, headless agents // 08 modelling patterns → habits that age well (+ non-software vignette) ``` |
| script | SCR: Title card: "Advanced · Overview · Beyond one file". Brand palette. Quiet montage of the demo workspace — Explorer tree, activity bar, Ideas Summary graph tab. VO: You already know the loop — name ideas, link neighbours, create a base, inspect locally, ask with a small slice. Advanced reqlan is not a second install tour. It is judgement about how graphs scale without becoming noise. SCR: Theme map slide builds one tile at a time: imports, attributes, graph maps, context, comment links, export, CLI/MCP, modelling. VO: Eight themes ahead. Imports and ideasets keep multi-file graphs honest. Attributes and plans stay slim unless they drive a view. Ideas Summary is a map you choose — not a mandatory god's-eye dump. Context and tokens carry forward the get-started habit: small slices beat whole-repo pastes. Comment references close the loop from code back to requirements. HTML export and CLI/MCP share the same analytical core — different hosts, same graph. Modelling patterns tie it together — including work that is not software. SCR: Quick beat on active base picker / `.reqlan` in Explorer — no create-base CTA. Nested base shown as dashed boundary on slide only. VO: Bases show up here as craft, not ceremony. One active base at a time. Know where your graph boundary is — nested bases are separate graphs, not folders you merge by accident. That discipline matters when you export, run CLI search, or hand context to an agent. SCR: Discipline slide: small slices, purposeful attributes, maps you choose. VO: Carry get-started forward. Token discipline is a habit, not a feature you toggle once. If an attribute never appears in how you navigate, delete it. SCR: End card: "Start with imports" — first deep dive. CTA: site tutorials index. VO: Pick your first deep dive. We recommend imports — split files before the graph outgrows one document. Every episode stands alone if you need a different entry point. |
| slides | { id title transition fade background brand-dark kicker Advanced · Overview heading Beyond one file body Same language. Better judgement about names, links, bases, and prompt size. asset logo notes You already know the loop. Advanced reqlan is judgement about how graphs scale without becoming noise. }, { id loop-recap transition fade background brand-panel heading Carry the loop forward body Name · link · base · neighbourhood · small AI slice · stitch to code. asset montage-ide notes Advanced is not a second install tour. It is craft on top of verbs you already felt. }, { id map transition slide background brand-panel heading Eight themes ahead body Imports · attributes · graph maps · context · comment links · HTML export · CLI/MCP · modelling patterns code_lang rq code from "./auth.rq" import login_api · @status in-progress · Ideas Summary graph · rq:password_rules notes Each theme has its own deck. Ontology, extension map, and CLI live in Concepts. }, { id bases-craft transition none background brand-contrast heading Bases as craft body One active base. Know the graph boundary. Nested bases stay separate. code_lang txt code demo/.reqlan/ · active base picker · CLI selects one base per run notes No create-base lesson here — boundary discipline for export, CLI, and context. }, { id discipline transition fade background brand-panel heading Carry the discipline forward body Small slices. Maps you choose. Attributes that drive a view — or delete them. code_lang rq code login_api { POST /login… @status in-progress @tags ( auth ) } notes Token discipline and cartographic focus carry forward from get-started. }, { id general-purpose transition fade background brand-panel heading General-purpose graphs body Software is the common case — not the only case. One non-software vignette in the series. code_lang rq code issue_brief { June theme… cite interview_lee. } notes Editorial briefs and ops checklists are still named ideas with neighbours. }, { id next transition fade background brand-dark heading Start with imports body Split ideas across files. Pick from-import or namespace alias — whatever stays readable. fragments Next — Imports and ideasets asset logo notes Pick your first deep dive. We recommend imports before the graph outgrows one document. } |
Ancestor context
Advanced series: eight episodes in [advanced_series], about 8 – 12 minutes each, plus [adv_overview]. Assumes get-started fluency and ideally [concepts_series] vocabulary ( or equivalent ). Goal: multi-file graphs, purposeful attributes, cartographic navigation, AI token discipline, code-comment traceability, HTML publishing, headless CLI / MCP craft ( beyond [con_03_cli] ), and modelling patterns that stay readable. Include at least one non-software vignette ( ops runbook or editorial brief ) to honour [general_purpose]. Bases appear as craft judgement ( active base, nested boundaries ) — not a second create-base lesson. Decks: [adv_overview] and adv_01 – adv_08 under [slide_decks].
con_03_cliAudience: viewers who finished the extension tour and want the headless twin named — CI, scripts, and agents without living in the editor. Outcome: install and run `reqlan` / `rq`; [init] a [base]; run search, analyse, and parse; know `--cwd` / `--json` and one-base-per-run; know export shares [html_export] with the extension. Runtime: 9 – 11 min. Demo: advanced get-started end state of `reqlan-tutorials-demo` — `.reqlan` indexed, `reqs/product.rq` + `reqs/auth.rq` present; integrated terminal at workspace root; extension idle in background ( not the focus ). Related: [cli_package] [commands] [init] [html_export] [base] [multi_base_environment] [llm_first] [function_parity]
| Kind | Idea | Path | Snippet |
|---|---|---|---|
| references | advanced_series_brief | reqlan rq/marketing_and_media/tutorials.rq | advanced_series_brief |
| Kind | Idea | Path | Snippet |
|---|---|---|---|
| ideaset_member | slide_decks | reqlan rq/marketing_and_media/tutorials.rq | — |
| references | advanced_series_brief | reqlan rq/marketing_and_media/tutorials.rq | adv_overview |
| Kind | Idea | Path | Snippet |
|---|---|---|---|
| references | base | base | |
| references | concepts_series | concepts_series | |
| references | general_purpose | general_purpose | |
| references | interview_lee | interview_lee | |
| references | llm_first | llm_first | |
| references | multi_base_environment | multi_base_environment | |
| references | password_rules | password_rules |
Initialising graph…