Skip to content

LiorCohen/sdd / plugin/fullstack-typescript/skills/command-router

command-router

Unverified

Routes /sdd-run commands to fullstack-typescript skills or system CLI.

Command Router

Routes techpacks.routeCommand(command, args) requests to the appropriate fullstack-typescript skill or system CLI handler. Core never dispatches tech pack commands directly — it invokes this router, which handles argument validation, sub-help, destructive action confirmation, and dispatch.

Input

Invoked by the techpacks gateway with a structured context block:

command: <command-name>
namespace: <tech-pack-namespace>
args: <parsed-args>

Validated against command-router-context.schema.json.


Dispatch Table

Maps the command namespace to its handler.

NamespaceHandlerDescription
local-envINVOKE local-env-orchestration skillOrchestrates local Kubernetes environment management
databasePass-through to tech system CLIDatabase lifecycle operations
contractPass-through to tech system CLIContract generation and validation
configINVOKE config-orchestration skillConfiguration management operations

Handler Details

Skill-handled namespaces (local-env, config): Load the orchestration skill via techpacks.loadSkill and pass the action and args. The skill handles argument validation, sub-help display, and execution.

Pass-through namespaces (database, contract): Execute directly via the tech system CLI:

<tech-pack-root>/system/system-run.sh <namespace> <action> <args>

Skill Paths

Skill NamePath (relative to tech pack root)
local-env-orchestrationskills/orchestrators/local-env-orchestration/SKILL.md
config-orchestrationskills/orchestrators/config-orchestration/SKILL.md

Tech System CLI Path

<tech-pack-root>/system/system-run.sh

Where <tech-pack-root> is the absolute path to the tech pack directory, resolved by the techpacks gateway via techpacks.resolvePath.


Destructive Actions Table

Actions that destroy data or remove deployments. The sdd-run command checks this table before execution and requires explicit user confirmation.

CommandLevelWhat it affects
database teardowndestructiveRemoves the database and all associated resources permanently
database resetdestructiveDrops and recreates the database from scratch — all data is lost
database seedcautionOverwrites existing seed data — existing records may be replaced
local-env destroydestructiveDeletes the local Kubernetes cluster and all resources within it
local-env undeploycautionRemoves deployed applications from the cluster — databases persist

Confirmation Format

For destructive and caution actions, display a warning before executing:

<warning_level> <LEVEL>: <action description>

This will <specific consequence>.

Target: <component or cluster being affected>
Environment: <env if applicable>

Confirm? (yes/no)

Sub-Help: database

When /sdd-run database is invoked without an action, display:

/sdd-run database — PostgreSQL database lifecycle management

USAGE:
  /sdd-run database <action> <name> [options]

ACTIONS:
  setup          Initialize schema, run migrations, and seed
  migrate        Run pending database migrations
  seed           Populate database with seed data                     caution
  reset          Drop and recreate database from scratch              destructive
  teardown       Remove database and all associated resources         destructive
  psql           Open interactive PostgreSQL shell
  port-forward   Forward local port to database pod in Kubernetes

REQUIRED:
  <name>         Database component name (from sdd-settings.yaml)

OPTIONS:
  --env <env>    Target environment (default: local)

EXAMPLES:
  /sdd-run database setup main-db
  /sdd-run database migrate main-db --env staging
  /sdd-run database psql main-db
  /sdd-run database reset main-db

Sub-Help: contract

When /sdd-run contract is invoked without an action, display:

/sdd-run contract — OpenAPI contract management

USAGE:
  /sdd-run contract <action> <name>

ACTIONS:
  generate-types   Generate TypeScript types from OpenAPI spec
  validate         Validate OpenAPI spec for correctness

REQUIRED:
  <name>           Contract component name (from sdd-settings.yaml)

EXAMPLES:
  /sdd-run contract generate-types main-api
  /sdd-run contract validate main-api

Sub-Help: config

When /sdd-run config is invoked without an action, the config-orchestration skill displays its own sub-help. See skills/orchestrators/config-orchestration/SKILL.md.

Sub-Help: local-env

When /sdd-run local-env is invoked without an action, the local-env-orchestration skill displays its own sub-help. See skills/orchestrators/local-env-orchestration/SKILL.md.


Namespace Mapping Note

The local-env namespace is the user-facing name. The local-env-orchestration skill maps this to the env namespace when calling the system CLI:

  • User runs: /sdd-run local-env create
  • Orchestrator executes: <tech-pack-root>/system/system-run.sh env create

This mapping is handled inside the local-env-orchestration skill, not in this router.


Routing Logic

When the techpacks gateway invokes this router:

  1. Parse the context block — extract command, namespace, and args.

  2. Extract the namespace — the first word of the command (e.g., database from database setup).

  3. Check the Dispatch Table — find the handler for the namespace.

  4. If skill-handled — load the orchestration skill and pass the action and args to it.

  5. If pass-through — check the Destructive Actions Table first. If the command matches a destructive or caution action, require confirmation before executing. Then run the system CLI command.

  6. If namespace not found — return an error indicating the namespace is not supported by this tech pack.

reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 464kUpdated Claude CodeCodexVerifiedInstall
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 464kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 318kUpdated Claude CodeCodexUnverifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 318kUpdated Claude CodeCodexUnverifiedInstall