base-project-router

Validates Base adapter contracts and resolves project routing from repository snapshots.

Updated Jul 9, 2026
One-click install
npx skills add https://github.com/alsdmlals4-eng/Base --skill base-project-router-alsdmlals4-eng
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: base-project-router
Source: https://github.com/alsdmlals4-eng/Base/tree/main/templates/project-operations/.agents/skills/base-project-router
Command: npx skills add https://github.com/alsdmlals4-eng/Base --skill base-project-router-alsdmlals4-eng

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams sharing a Base repository across multiple game and creative projects need a safe way to confirm that a project's adapter contract, pinned commits, and generated route snapshots are consistent before any planning, asset production, or implementation begins. This Skill enforces that verification gate and resolves which canonical route a project should follow. ## Core Features & Use Cases - Adapter Contract Validation: Confirms PROJECT_BASE_ADAPTER.json records the protected baseline commit, external authority ref, policy source, and SHA-256, then runs check_project_operating_contract.py before any routing. - Work Gate Enforcement: Applies PROJECT_START_CANON_CHECKLIST_REQUIRED and PM_EXECUTION_GATE_REQUIRED, validating project-owned receipts with validate_work_contract_receipt.py across start, resume, and closeout phases. - Route Resolution: Resolves effective_routes from the generated snapshot, giving project-local routes precedence over same-name Base routes, and refuses routing on stale pins, hash drift, alias cycles, or generated-view drift. - Use Case: Before starting a new Godot feature, run the router to verify the Base adapter pin matches the checked-out commit, validate the work receipt, and then follow the resolved canonical project package. ## Quick Start Ask the AI to validate the Base adapter contract and resolve the effective project route before starting any new planning or implementation task.

Frequently Asked Questions about base-project-router

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate a Base adapter contract before routing a project?

Confirm PROJECT_BASE_ADAPTER.json records the protected baseline commit, authority ref, policy source, and SHA-256, then run check_project_operating_contract.py with the project root and Base repository paths. Only read the generated snapshot after a zero exit code.

What happens when the adapter pin does not match the checked-out commit?

The router refuses to route. A stale pin, mismatched pin, hash drift, alias cycle, or generated-view drift blocks all routing, and the Skill stops without reading or executing any routes.

Does a project-local route override a Base route with the same name?

Yes. A project-local route has precedence over a same-name Base route when resolving effective_routes from the generated snapshot. The router then follows the selected canonical package at its recorded path.

Why does routing fail with BLOCKED_UNVERIFIED during project start?

BLOCKED_UNVERIFIED occurs when the benchmark_preflight_receipt is missing, the Base root is unresolved, the pin mismatches, or validate_work_contract_receipt.py returns nonzero. The router will not route into product mutation until the receipt validates.

Can the router execute Godot live editor operations directly?

No. When godot-live-editor-operations is an effective route, the router stays read-only: it completes adapter validation, then reads the capability manifest and that skill's SKILL.md. The selected adapter owns the engine-operation contract.