custom-environment-setup

name	custom-environment-setup
description	Project-specific environment setup for issue workflows. Calculates test ports and provides initialization context for minions.

Custom Environment Setup

Purpose

This is a project-specific custom skill called by generic workflow skills at defined checkpoints. It provides environment configuration specific to this project (claudecode_webui).

Generic workflow skills invoke this skill if it exists; if absent, the workflow continues without project-specific environment setup.

Input

• issue_number (from $1 argument): The issue number being worked on

Output

When invoked, this skill should set the following environment variables/context for the caller:

Port Calculation

• Backend Port = 8000 + (issue_number % 1000)
• Vite Port = 5000 + (issue_number % 1000)

Examples:

• Issue #42 -> Backend: 8042, Vite: 5042
• Issue #372 -> Backend: 8372, Vite: 5372
• Issue #1234 -> Backend: 8234, Vite: 5234

Auth Token

• Test Auth Token = test (fixed value for all test servers)
  • Passed to backend via --token test so it survives restarts
  • Included in URLs reported to the user for one-click access

Initialization Context Fragment

Return this context fragment for inclusion in minion initialization:

Test Server Configuration:
- Backend Port: ${BACKEND_PORT} (8000 + issue_number % 1000)
- Backend Host: 0.0.0.0 (required for network-accessible dev server)
- Vite Port: ${VITE_PORT} (5000 + issue_number % 1000)
- Auth Token: test (pinned for testing)
- Data Directory: Default (data/) - DO NOT use --data-dir flag

Status Display Context

For /status_workers, provide:

• Port range info: Backend ports 8000-8999, Vite ports 5000-5999
• How to check running servers:

  # Check backend ports
  lsof -i :8000-8999 2>/dev/null | grep LISTEN
  
  # Check vite ports
  lsof -i :5000-5999 2>/dev/null | grep LISTEN
  

Usage by Generic Skills

Generic workflow skills call this skill like:

Invoke custom-environment-setup skill with issue_number=$1

The skill returns port configuration and any project-specific init context. If this skill does not exist, the generic workflow proceeds without port/environment configuration.