.env.example

# =============================================================================
# ubtstack configuration
# Copy this file to .env and fill in your values
# =============================================================================

# -----------------------------------------------------------------------------
# Linear API
# -----------------------------------------------------------------------------
# Create a personal API key at: https://linear.app/settings/api
# Required for: creating issues, discovering teams, status transitions
LINEAR_API_KEY=lin_api_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

# -----------------------------------------------------------------------------
# Linear workspace
# -----------------------------------------------------------------------------
# Your workspace slug appears in your Linear URL: linear.app/<slug>/...
# Example: if your URL is linear.app/acme/..., your slug is "acme"
LINEAR_PROJECT_SLUG=your-workspace-slug

# Link all created issues to a specific Linear project (optional)
# How to find: open the project in Linear → look at the URL
# Example URL: linear.app/acme/project/abc-123 → project ID is "abc-123"
# Can also be passed per-run: --project <id>
LINEAR_PROJECT_ID=

# -----------------------------------------------------------------------------
# Linear teams
# -----------------------------------------------------------------------------
# Run this to discover your teams and their workflow states:
#   npx tsx scripts/linear-discover-team.ts
#
# After discovering teams, add these custom workflow states to each team
# in Linear (Settings → Team → Workflow → add under "Started"):
#   - Rework
#   - Human Review
#   - Merging
#
# ENG team: engineering tickets, dispatched to Codex agents via Symphony
# BIZ team: business/product tasks (user interviews, strategy), manual execution
LINEAR_ENG_TEAM_KEY=ENG
LINEAR_BIZ_TEAM_KEY=BIZ

# -----------------------------------------------------------------------------
# Target repository
# -----------------------------------------------------------------------------
# The repo that agents will clone and work on
# Used by Symphony workspace hooks to set up isolated worktrees
TARGET_REPO_URL=https://github.com/your-org/your-repo.git

# Local path to the ubtstack tooling repo (sibling directory)
# Skills and scripts reference this to find validators, templates, etc.
UBTSTACK_PATH=../ubtstack

# -----------------------------------------------------------------------------
# Codebase context paths (relative to target repo root)
# -----------------------------------------------------------------------------
# Planning skills (/kickoff, /plan-ceo-review, /plan-eng-review) scan these
# directories to auto-discover relevant docs before starting a review.
# Comma-separated if multiple directories.
#
# Architecture docs: system design, architecture decisions, technical specs
ARCHITECTURE_DOCS_PATH=docs/technical,docs/architecture

# PRDs: product requirements, feature briefs, user stories
PRD_DOCS_PATH=docs/functional,docs/prd

# Existing specs: specs that may constrain new implementation
EXISTING_SPECS_PATH=docs/specs

# -----------------------------------------------------------------------------
# Approval gate
# -----------------------------------------------------------------------------
# GitHub handle that must approve and merge all PRs
# Used by /ship skill to tag the reviewer in PR descriptions
# Agents never merge — only this person can
APPROVAL_REQUIRED_FROM=your-github-handle

# -----------------------------------------------------------------------------
# Staging / CD
# -----------------------------------------------------------------------------
# URL of the staging environment for CD test verification
# Used by /ship to check if CD tests have been run
# Leave empty if using ephemeral staging (cd-staging.yml workflow)
STAGING_URL=