Direct answer

The Investment Learning Route Finder maps a reader’s learning goal and existing knowledge to the most relevant Swoopr hub, learning path, academy course, glossary concepts and tools without making an investment recommendation. The tool is educational. It organizes information, exposes relationships, or performs deterministic logic from the inputs shown on the page. It does not recommend an investment, predict an outcome, or substitute for individualized financial, tax, legal, or regulatory advice.

The problem this tool solves

Swoopr’s library is large enough that a new reader can know the question but not the correct entry point. A user researching an ETF may need fund mechanics, index methodology or portfolio construction; a retirement question may be an account-rule question, a tax question or a portfolio-risk question. The route finder turns that ambiguity into a transparent learning sequence.

What you enter or select

Primary required input: What are you trying to understand? Options should include investing basics, building a portfolio, researching a stock, researching an ETF, learning bonds, preparing for retirement, managing risk, learning options, learning crypto, securing crypto, understanding taxes, reading economic data, or designing/backtesting a strategy.

Optional inputs:

  • current familiarity: new / know the basics / can already apply the basics;
  • preferred format: guide / learning path / course / glossary / tool;
  • asset class or domain if the question spans several categories.

Do not ask for age, income, net worth, political identity, protected characteristics, or brokerage holdings to generate a learning route.

The interface should explain each input next to the control. If an input is optional, say what happens when it is omitted. If the tool uses a registry or external data source, show the source and freshness metadata separately from user-entered information.

What the tool returns

Return:

  1. Start here: one canonical page.
  2. Prerequisites: zero to three concepts the reader should understand first.
  3. Practice tool: one tool only when an interactive exercise materially helps.
  4. Deep path: one Learning Path or Academy course.
  5. Verify here: the relevant primary-source hub when the topic contains current rules.
  6. Why this route: one paragraph showing which selected inputs produced the route.

Provide alternatives only when two routes are genuinely different, not as a long recommendation list.

Results should be grouped into observed/selected facts, Swoopr-calculated or matched output, and next educational steps. A result label must never look like a personalized recommendation. If the tool cannot resolve the inputs confidently, it should return an explicit “needs review” or “insufficient information” state.

Methodology

Use a registry-driven decision table rather than an LLM-generated recommendation. Each goal maps to a canonical entity ID. The entity registry supplies prerequisites, preferred learning path, preferred academy course, tools and primary-source relationships.

Pseudo-logic:

goal -> canonical concept/community -> prerequisite edges -> canonical owner -> public tool edges -> journey path -> source edges

If familiarity is “new,” include prerequisites. If familiarity is “can apply basics,” test whether the path has a stage gate and start after satisfied prerequisites. If the selected subject includes current tax, regulatory, index-constituent or rule information, include the primary-source verification route.

Do not rank investments or personalize a portfolio.

The methodology must be visible from the tool page and available without opening a modal that requires JavaScript. Deterministic rules should be documented in plain English and, where helpful, as readable pseudocode. Data-driven outputs should include the registry revision or data timestamp used.

Worked examples

Example: “I want to compare ETFs.” The tool routes to ETF Research, then creation/redemption and index methodology as prerequisites, the ETF Cost Comparison Tool as practice, the ETF Research Learning Path for depth, and provider/issuer sources for current fund and index facts.

Example: “I am approaching retirement.” The route starts at Retirement Investing / Investor Life Stages, adds sequence-of-returns risk and account structure as prerequisites, points to the retirement learning path, and adds IRS source verification for current distribution rules.

Example: “I want to learn technical analysis.” The route points to the Technical Analysis hub or Academy and does not ask for a ticker or suggest a trade.

Examples should use hypothetical or clearly educational inputs unless the tool is explicitly designed to read public, current source data. Examples are demonstrations of method, not suggested actions.

Accessibility requirements

The tool must be usable with keyboard, screen reader, zoom, high contrast and reduced motion.

Every form control needs:

  • a persistent programmatic label;
  • units where relevant;
  • inline help that does not depend on hover;
  • errors associated with the field;
  • a clear reset path.

Results must be announced appropriately without forcing focus unexpectedly. If the tool uses cards, a graph, chips or color-coded categories, the same information must be available in text. Do not use color as the only indicator of category, severity or status.

The tool should remain understandable if charts fail to load. Tables should use real table semantics. Controls that behave like buttons must be real buttons.

Privacy and data handling

Prefer browser-local computation for this tool when practical. Do not request account credentials, passwords, private keys, seed phrases, brokerage tokens or other secrets.

If a backend lookup is required, transmit only the information necessary for that lookup. Do not persist user inputs unless the product explicitly provides a save function and explains the storage behavior.

Limitations

The route finder can organize Swoopr’s curriculum but cannot know whether a concept is financially appropriate for a person. The underlying registries can also lag new content if revision parity fails, so the tool must display its registry revision and refuse to present stale routes when the graph/source registry is out of sync.

A useful limitation statement explains what the tool does not know. Avoid generic disclaimers that hide the actual uncertainty.

Interlinking plan

Link to Where to Start, Learning Paths, Swoopr Academy, Knowledge Center, Investment & Trading Glossary, Tools & Calculators, and Primary Financial Sources. Each returned route should also include direct links to its selected canonical resources.

Each internal link should represent a typed relationship: EXPLAINS, IMPLEMENTS, REQUIRES_KNOWLEDGE_OF, SUPPORTED_BY, COMPARES_WITH, NEXT_TOPIC, or another documented predicate. Do not create a block of loosely related links for SEO.

Structured data and graph identity

Create one stable PublicTool entity ID and one page resource.

The page should be ABOUT the tool. The tool should connect to every concept it implements or explains. If a methodology page exists, use EXPLAINED_BY or the equivalent Swoopr predicate.

Do not expose backend function names as separate public tools.

QA and validation

Before release, test:

  1. empty and incomplete input;
  2. boundary cases;
  3. invalid combinations;
  4. keyboard-only operation;
  5. screen-reader labels and live-region behavior;
  6. browser zoom at 200% and 400%;
  7. no-JavaScript fallback content;
  8. deterministic repeatability;
  9. registry/data-source freshness;
  10. internal-link resolution.

Automated tests should compare known fixtures with expected output. Any rules stored in code and copy must be generated from one source or validated against each other so the methodology cannot drift from the implementation.

Design deep dive 1: Route table design

Build the routing table around learning intents, not investment products alone. A reader choosing “research an ETF” needs mechanics, index methodology, cost and source verification; a reader choosing “prepare for retirement” needs a different chain of accounts, cash-flow, sequence risk and current rules. The route table should therefore point to canonical concept IDs and journey edges rather than hard-coded URL strings scattered through the component.

Implementation exercise: Test the table by removing one target URL from the site registry. The tool should surface a validation error at build time rather than send a user to a dead route.

Release check: A route is valid only when every target is canonical and the explanation names the relationship that caused it to be selected.

This design note belongs in the public methodology because it explains how the tool avoids a specific failure mode. The interface copy can be shorter, but the underlying behavior should remain testable. Where the behavior depends on registry data, include the registry revision in the diagnostic output so a stale configuration can be distinguished from a logic defect.

Design deep dive 2: Familiarity without personalization

The familiarity control exists to skip prerequisites a learner can already demonstrate, not to score a person’s financial sophistication. Keep the states simple and educational. Do not infer experience from wealth, age, trading activity or account size.

Implementation exercise: For each familiarity state, define which prerequisite checks disappear and which remain mandatory because they are safety or mechanics concepts.

Release check: The same goal with different familiarity levels should change the study sequence, never the investment recommendation.

This design note belongs in the public methodology because it explains how the tool avoids a specific failure mode. The interface copy can be shorter, but the underlying behavior should remain testable. Where the behavior depends on registry data, include the registry revision in the diagnostic output so a stale configuration can be distinguished from a logic defect.

Design deep dive 3: Conflict resolution

A user can choose a goal that belongs to several communities, such as “compare an ETF for retirement.” The route engine should resolve this by selecting one start page and then adding secondary context, not by returning a wall of links.

Implementation exercise: Create fixtures where retirement+ETF, options+risk and crypto+taxes overlap. Record which canonical community owns the start and which communities appear as cross-links.

Release check: Conflicts should be deterministic and documented in the route registry.

This design note belongs in the public methodology because it explains how the tool avoids a specific failure mode. The interface copy can be shorter, but the underlying behavior should remain testable. Where the behavior depends on registry data, include the registry revision in the diagnostic output so a stale configuration can be distinguished from a logic defect.

Design deep dive 4: Progress handoff

The route finder should hand a user into a Learning Path or Academy only after the entry resources are clear. If local progress exists, it can offer to resume, but the route logic must not depend on tracking data.

Implementation exercise: Test the experience with no local storage, cleared storage and partially completed paths.

Release check: Core routing must remain functional without an account or saved profile.

This design note belongs in the public methodology because it explains how the tool avoids a specific failure mode. The interface copy can be shorter, but the underlying behavior should remain testable. Where the behavior depends on registry data, include the registry revision in the diagnostic output so a stale configuration can be distinguished from a logic defect.

Design deep dive 5: Search and no-match behavior

A no-match state is better than an invented route. If a user enters an unsupported goal, show the closest reviewed categories and a normal site search box.

Implementation exercise: Feed ambiguous and nonsense inputs into the component. Confirm that it does not hallucinate pages or transform arbitrary text into a new route.

Release check: Every output resource must exist in the registry at build time.

This design note belongs in the public methodology because it explains how the tool avoids a specific failure mode. The interface copy can be shorter, but the underlying behavior should remain testable. Where the behavior depends on registry data, include the registry revision in the diagnostic output so a stale configuration can be distinguished from a logic defect.

Additional test scenario: Familiarity without personalization

Create a fixture that deliberately violates one assumption of the tool, run it through the core logic, and record the expected safe failure state. The user-facing result should explain what could not be resolved without inventing missing information. The diagnostic output should identify the input category, registry revision and rule that caused the stop.

Then repeat the fixture with the missing information supplied from a reviewed registry entry. The result should become deterministic without changing any unrelated output. This paired test demonstrates that the tool is driven by explicit evidence rather than hidden scoring or broad text generation.

Document the scenario in the component test suite and link the relevant methodology section from the test name. That keeps implementation, public explanation and QA synchronized.

Additional test scenario: Progress handoff

Create a fixture that deliberately violates one assumption of the tool, run it through the core logic, and record the expected safe failure state. The user-facing result should explain what could not be resolved without inventing missing information. The diagnostic output should identify the input category, registry revision and rule that caused the stop.

Then repeat the fixture with the missing information supplied from a reviewed registry entry. The result should become deterministic without changing any unrelated output. This paired test demonstrates that the tool is driven by explicit evidence rather than hidden scoring or broad text generation.

Document the scenario in the component test suite and link the relevant methodology section from the test name. That keeps implementation, public explanation and QA synchronized.

Additional test scenario: Familiarity without personalization

Create a fixture that deliberately violates one assumption of the tool, run it through the core logic, and record the expected safe failure state. The user-facing result should explain what could not be resolved without inventing missing information. The diagnostic output should identify the input category, registry revision and rule that caused the stop.

Then repeat the fixture with the missing information supplied from a reviewed registry entry. The result should become deterministic without changing any unrelated output. This paired test demonstrates that the tool is driven by explicit evidence rather than hidden scoring or broad text generation.

Document the scenario in the component test suite and link the relevant methodology section from the test name. That keeps implementation, public explanation and QA synchronized.

Additional test scenario: Progress handoff

Create a fixture that deliberately violates one assumption of the tool, run it through the core logic, and record the expected safe failure state. The user-facing result should explain what could not be resolved without inventing missing information. The diagnostic output should identify the input category, registry revision and rule that caused the stop.

Then repeat the fixture with the missing information supplied from a reviewed registry entry. The result should become deterministic without changing any unrelated output. This paired test demonstrates that the tool is driven by explicit evidence rather than hidden scoring or broad text generation.

Document the scenario in the component test suite and link the relevant methodology section from the test name. That keeps implementation, public explanation and QA synchronized.

Additional test scenario: Familiarity without personalization

Create a fixture that deliberately violates one assumption of the tool, run it through the core logic, and record the expected safe failure state. The user-facing result should explain what could not be resolved without inventing missing information. The diagnostic output should identify the input category, registry revision and rule that caused the stop.

Then repeat the fixture with the missing information supplied from a reviewed registry entry. The result should become deterministic without changing any unrelated output. This paired test demonstrates that the tool is driven by explicit evidence rather than hidden scoring or broad text generation.

Document the scenario in the component test suite and link the relevant methodology section from the test name. That keeps implementation, public explanation and QA synchronized.

Additional test scenario: Progress handoff

Create a fixture that deliberately violates one assumption of the tool, run it through the core logic, and record the expected safe failure state. The user-facing result should explain what could not be resolved without inventing missing information. The diagnostic output should identify the input category, registry revision and rule that caused the stop.

Then repeat the fixture with the missing information supplied from a reviewed registry entry. The result should become deterministic without changing any unrelated output. This paired test demonstrates that the tool is driven by explicit evidence rather than hidden scoring or broad text generation.

Document the scenario in the component test suite and link the relevant methodology section from the test name. That keeps implementation, public explanation and QA synchronized.

Additional test scenario: Familiarity without personalization

Create a fixture that deliberately violates one assumption of the tool, run it through the core logic, and record the expected safe failure state. The user-facing result should explain what could not be resolved without inventing missing information. The diagnostic output should identify the input category, registry revision and rule that caused the stop.

Then repeat the fixture with the missing information supplied from a reviewed registry entry. The result should become deterministic without changing any unrelated output. This paired test demonstrates that the tool is driven by explicit evidence rather than hidden scoring or broad text generation.

Document the scenario in the component test suite and link the relevant methodology section from the test name. That keeps implementation, public explanation and QA synchronized.

Additional test scenario: Progress handoff

Create a fixture that deliberately violates one assumption of the tool, run it through the core logic, and record the expected safe failure state. The user-facing result should explain what could not be resolved without inventing missing information. The diagnostic output should identify the input category, registry revision and rule that caused the stop.

Then repeat the fixture with the missing information supplied from a reviewed registry entry. The result should become deterministic without changing any unrelated output. This paired test demonstrates that the tool is driven by explicit evidence rather than hidden scoring or broad text generation.

Document the scenario in the component test suite and link the relevant methodology section from the test name. That keeps implementation, public explanation and QA synchronized.

Additional test scenario: Familiarity without personalization

Create a fixture that deliberately violates one assumption of the tool, run it through the core logic, and record the expected safe failure state. The user-facing result should explain what could not be resolved without inventing missing information. The diagnostic output should identify the input category, registry revision and rule that caused the stop.

Then repeat the fixture with the missing information supplied from a reviewed registry entry. The result should become deterministic without changing any unrelated output. This paired test demonstrates that the tool is driven by explicit evidence rather than hidden scoring or broad text generation.

Document the scenario in the component test suite and link the relevant methodology section from the test name. That keeps implementation, public explanation and QA synchronized.

Additional test scenario: Progress handoff

Create a fixture that deliberately violates one assumption of the tool, run it through the core logic, and record the expected safe failure state. The user-facing result should explain what could not be resolved without inventing missing information. The diagnostic output should identify the input category, registry revision and rule that caused the stop.

Then repeat the fixture with the missing information supplied from a reviewed registry entry. The result should become deterministic without changing any unrelated output. This paired test demonstrates that the tool is driven by explicit evidence rather than hidden scoring or broad text generation.

Document the scenario in the component test suite and link the relevant methodology section from the test name. That keeps implementation, public explanation and QA synchronized.