lane-selection-governance

Routes engineering tasks to the correct delivery lane using a deterministic 4-gate heuristic.

Updated Dec 24, 2025
One-click install
npx skills add https://github.com/JoyJoin-Tech-Limited/JoyJoin_app_v0.1 --skill lane-selection-governance-joyjoin-tech-limited
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: lane-selection-governance
Source: https://github.com/JoyJoin-Tech-Limited/JoyJoin_app_v0.1/tree/main/.github/skills/lane-selection-governance
Command: npx skills add https://github.com/JoyJoin-Tech-Limited/JoyJoin_app_v0.1 --skill lane-selection-governance-joyjoin-tech-limited

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Engineering teams using AI-assisted delivery often apply the wrong level of process: heavyweight review ceremonies for trivial CSS tweaks, or lightweight direct edits on payment flows and state machines. This Skill prevents lane drift by giving any agent a deterministic 4-gate heuristic that selects the correct delivery lane (Direct, Kickoff, Deliberation Moderator, or Harness Runtime Controller) before implementation begins. ## Core Features & Use Cases - 4-Gate Lane Heuristic: Ordered gates route tasks to HRC (auth, payments, matching, state machines, DB migrations, WebSocket infra), DM (cross-workspace UX/architecture trade-offs), Kickoff (ambiguous scope), or Direct (bounded single-boundary changes). - Quick-Reference Matrix & Anti-Patterns: A concern-to-lane lookup table plus documented anti-patterns (e.g., HRC for a CSS tweak, Direct delivery for a payment flow) with corrective guidance. - Icebreaker Layer Map: A domain-specific mapping of icebreaker stack layers (session lifecycle, phase logic, AI copy, REST routes, UI, WebSocket) to their required lanes. - Use Case: Before modifying the icebreaker phase state machine, run the heuristic: Gate 1 matches on state-machine changes with partial-failure risk, so the task routes to Harness Runtime Controller with a Sprint Contract and verification gate instead of a direct edit. ## Quick Start Ask the agent to run the lane selection heuristic on your planned change, for example: which lane should I use for adding a refund endpoint to the payments service?

Frequently Asked Questions about lane-selection-governance

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

FAQPage Schema
How do I decide which delivery lane to use for a code change?▼

Apply the 4-gate heuristic in order and stop at the first match. Gate 1 routes auth, payments, matching, state machines, DB migrations, and real-time infrastructure to HRC; Gate 2 routes cross-workspace trade-offs to DM; Gate 3 routes ambiguous scope to Kickoff; Gate 4 handles bounded single-boundary changes directly.

When should a task go through the Harness Runtime Controller lane?▼

Use HRC when a change touches auth or sessions, payments or entitlements, deterministic engines like matching or personality assignment, state machines with partial-failure risk, database schema changes with backfill, or WebSocket infrastructure. It produces a Sprint Contract, PGE loop, Council review, and a 5-pillar verification gate.

What is the difference between Deliberation Moderator and Direct delivery?▼

Deliberation Moderator handles cross-workspace changes with genuine UX or architecture trade-offs, producing a 3-perspective consensus plan. Direct delivery fits bounded changes under 10 files inside one boundary with no auth, payment, state machine, migration, or real-time concerns.

Can I choose the lane after I have already written the code?▼

No. Lane selection is a pre-implementation decision, not a post-hoc label. The heuristic must run before the first file edit, and the review checklist audits whether the chosen lane matches the highest-risk concern in the diff.

What are common lane selection mistakes to avoid?▼

Common anti-patterns include running a full Harness chamber for a CSS tweak, direct-delivering a payment flow, using DM for state-machine changes where reliability concerns are under-weighted, and skipping the planning check entirely even for direct delivery.