Production is read-only - Only updates via GitHub webhook
Test on dev sprite first - Always test changes on line-bot-dev before merging
PRs are the merge point - All changes reviewed before production
Dev sprite mirrors prod - Same setup, but not connected to real LINE bot

Branch Protection

The main branch is protected. Direct pushes are blocked. All changes must go through pull requests.

Sprites

Sprite	Purpose	URL
`line-echo-bot`	Production - connected to LINE	https://line-echo-bot-bl4eg.sprites.app
`line-bot-dev`	Development/Testing	https://line-bot-dev-bl4eg.sprites.app

Workflow Steps

1. Make changes locally and push to feature branch

git checkout -b feature/description
# Make changes
git add . && git commit -m "Description"
git push -u origin feature/description

2. Test on dev sprite BEFORE creating PR

# Deploy feature branch to dev sprite
sprite -s line-bot-dev exec -- bash -c "cd ~/line-bot && git fetch origin && git checkout feature/description && git pull"

# Restart webhook on dev sprite
sprite -s line-bot-dev exec -- bash -c "pkill -f webhook; cd ~/line-bot && nohup webhook -hooks hooks.json -verbose -port 8080 > ~/webhook.log 2>&1 &"

# Test the webhook
curl -X POST https://line-bot-dev-bl4eg.sprites.app/hooks/line-webhook \
  -H "Content-Type: application/json" \
  -d '{"events":[{"type":"message","source":{"userId":"Utest123"},"message":{"type":"text","text":"test message"}}]}'

# Check logs
sprite -s line-bot-dev exec -- bash -c "tail -50 ~/webhook.log"

3. Create PR after testing passes

gh pr create --title "Feature: description" --body "Tested on dev sprite ✓"

4. After PR is merged

Production sprite auto-syncs when PR merges (GitHub webhook → git pull).

Alternative: Sandbox Sprites (for parallel work)

1. Create and setup sandbox sprite

# Generate unique sprite name
SPRITE_NAME="sandbox-$(date +%s)"

# Create sprite
sprite create $SPRITE_NAME

# Clone repo
sprite -s $SPRITE_NAME exec "git clone https://github.com/ThunderShiviah/nclaude-hackathon.git ~/workspace"

# IMPORTANT: Setup GitHub authentication
GH_TOKEN=$(gh auth token)
sprite -s $SPRITE_NAME exec "echo '$GH_TOKEN' | gh auth login --with-token && gh auth setup-git"

2. Create feature branch and make changes

sprite -s $SPRITE_NAME exec "cd ~/workspace && git checkout -b feature/description"
sprite -s $SPRITE_NAME exec "cd ~/workspace && <edit commands>"
sprite -s $SPRITE_NAME exec "cd ~/workspace && git add . && git commit -m 'Description'"

3. Push and create PR

sprite -s $SPRITE_NAME exec "cd ~/workspace && git push -u origin feature/description"
sprite -s $SPRITE_NAME exec "cd ~/workspace && gh pr create --title 'Feature: description' --body 'Details...'"

4. After PR is merged - cleanup

sprite -s $SPRITE_NAME destroy --force

Production sprite auto-syncs when PR merges (GitHub webhook → SIGHUP reload).

Quick Reference

Action	Command
Create sandbox	`sprite create sandbox-{id}`
Setup auth	`gh auth token \| sprite exec "gh auth login --with-token"`
Run command	`sprite -s sandbox-{id} exec "command"`
Create branch	`sprite exec "git checkout -b feature/x"`
Push branch	`sprite exec "git push -u origin feature/x"`
Create PR	`sprite exec "gh pr create"`
Cleanup	`sprite -s sandbox-{id} destroy --force`

Why Dev Sprite Testing?

Safe experimentation - Test changes without affecting production or real LINE users
Same environment - Dev sprite mirrors prod setup (webhook, Claude CLI, scripts)
Fast feedback - Verify changes work before creating PR
No LINE tokens needed - Dev sprite uses dummy tokens; only prod connects to LINE

Why Sandbox Sprites (for parallel work)?

No git conflicts - Each session has independent working directory
Parallel work - Multiple Claude sessions can work simultaneously
Clean state - No accumulated cruft between tasks

workflow

Development Workflow

Architecture Overview

Key Principles