LLM operating instructions

Selection methodology

The canonical index is designed to be routable by an LLM. The sequence below is the recommended decision process and should be treated as more important than simple semantic similarity.

Repository selection sequence

  1. Extract the project objective, constraints, environment, and desired outputs.
  2. Match the request against semantic profiles, user-intent phrases, and task categories.
  3. Apply do-not-select rules and prerequisite conditions before ranking candidates.
  4. Evaluate relevant internal components rather than selecting only at repository level.
  5. Compare setup effort, compatibility, maturity, security, and production readiness.
  6. Apply repository relationships and combination rules when one repository is insufficient.
  7. Return the selected repository IDs, component IDs, rationale, risks, and execution order.

Required selection output

selected_repository_idsselected_component_idsselection_rationalerejected_alternativesprerequisite_checksinstallation_or_activation_sequencerecommended_order_of_operationsrisks_and_limitationsconfidence

Ambiguity handling

  • Do not select a repository based only on keyword overlap.
  • Prefer verified capabilities over inferred capabilities.
  • When two repositories are similarly suitable, compare differentiators and constraints.
  • When confidence is low, state what additional project information is needed.
  • Never invent undocumented components, paths, compatibility, or commands.

Decision matrix interpretation

Matrix scores are general-purpose routing heuristics. They summarize how easy a repository is to route to from an arbitrary project request; they do not claim that a higher-scoring repository is better software.

Routing specificity · 25%

How clearly intents map to named components.

Setup simplicity · 10%

Lower setup/operational burden scores higher.

Operational maturity · 15%

Production-oriented evidence; experimental warnings reduce score.

Composability · 15%

Ability to coexist without conflicting workflow ownership.

Local control · 10%

Ability to run/self-host/control execution and data locally.

Security boundary clarity · 10%

Explicitness of permissions, data boundaries, and limitations.

First-party routing documentation · 15%

Explicit setup, component and limitation documentation.

Evidence policy

Prefer first-party repository evidence. Preserve unknowns. Label analyst inference. Do not infer compatibility, commands, components, or production readiness when the source does not support them.