foundation-router

name	foundation-router
description	Entry-point router that selects foundational Godot skills before domain, system, and workflow specialization.
tier	core
godot_version	4.6+
doc_anchors	["godot-docs/getting_started/introduction/key_concepts_overview.rst","godot-docs/tutorials/best_practices/introduction_best_practices.rst"]
tags	["routing","foundations","architecture"]
depends_on	[]

Foundation Router

Use When

• Starting a new implementation, refactor, or incident response in a Godot project.
• Task scope is unclear and the first skill selection must be deterministic.

Outcomes

• One or more Tier 1 foundation skills are selected before deeper routing.
• Selection rationale is explicit and reusable across similar tasks.
• Follow-on routing to Secondary/Tertiary/Operational tiers is constrained.

Required Rules

• Always pick a foundation skill first; do not start from Tier 3/4 directly.
• Select by problem type (architecture, lifecycle, data, validation, editor flow).
• Keep the smallest sufficient foundation set (avoid loading all foundations by default).
• If authority or ownership is ambiguous, route to architecture foundation first.

Workflow

1. Classify request by dominant concern: architecture, lifecycle, data, validation, or editor workflow.
2. Map concern to the minimum matching foundation skill(s).
3. Record why each skill was selected and what risk it controls.
4. Route to Secondary/Tertiary only after foundation choices are locked.
5. Revisit foundation selection if downstream conflicts appear.

Validation

• Given a task prompt, selected foundation skills explain all major constraints.
• No Tier 3/4 skill is selected without at least one explicit Tier 1 dependency.
• Repeated routing of similar prompts yields consistent foundation choices.

Failure Modes

• Skipping Tier 1 causes contradictory assumptions in lower tiers.
• Loading all foundations by default produces noisy, low-signal planning.
• Routing straight to operational runbooks hides architecture defects.

Local Doc Anchors

• godot-docs/getting_started/introduction/key_concepts_overview.rst
• godot-docs/tutorials/best_practices/introduction_best_practices.rst