Integration Recommendation Policy¶
Supported is not the same as recommended.
ORCA Framework may support many tools, but it should recommend only a smaller set when the user's use case strongly fits the evidence-backed default. The deciding question is not "can ORCA Framework support this?" but "does surfacing this reduce more friction than it creates?"
Core Rule¶
Recommend a tool only when:
- the use case is clear enough
- the fit is strong enough
- the recommendation is backed by ORCA Framework's researched paved-road guidance
- the tool helps the user's actual goal rather than just being popular
Stay neutral when:
- the use case is unclear
- the fit is weak or mixed
- multiple tools are plausible and no strong default exists
- the user did not ask for stack guidance
Switch to setup-help mode when:
- the user already chose the tool
- the user asked to configure or validate a specific integration
- the tool is not ORCA Framework's top default, but it is still compatible with the user's goal
NotebookLM Rule¶
NotebookLM should generally be:
- recommended only when the workflow is clearly knowledge-heavy, research-heavy, or notebook-oriented
- supported when the user explicitly asks for it
- supported when the user already uses it
- kept out of generic stack guidance when the fit is weak or unclear
Do not treat NotebookLM like a default app-stack integration.
Graph And Vault Rule¶
Graphify, Obsidian graph views, and graph-style vault tooling should generally be:
- suggested only when the vault is large, fragmented, or hard to understand
- supported when the user explicitly asks for them
- avoided when direct vault inspection is already enough
Do not treat graph tooling as a baseline setup requirement.
Recommendation Priorities¶
- detect the use case
- decide whether recommendation mode is warranted
- recommend only strong-fit tools
- explain why they fit
- avoid unrelated suggestions
- respect explicit user tool choices
- prefer the lower-friction path when two compatible options are close