/doppler-setup

---

🚨 EXECUTION NOTICE FOR CLAUDE

When you invoke this command via SlashCommand, the system returns THESE INSTRUCTIONS below.

YOU are the executor. This is NOT an autonomous subprocess.

• ✅ The phases below are YOUR execution checklist
• ✅ YOU must run each phase immediately using tools (Bash, Read, Write, Edit, TodoWrite)
• ✅ Complete ALL phases before considering this command done
• ❌ DON't wait for "the command to complete" - YOU complete it by executing the phases
• ❌ DON't treat this as status output - it IS your instruction set

Immediately after SlashCommand returns, start executing Phase 0, then Phase 1, etc.

See @CLAUDE.md section "SlashCommand Execution - YOU Are The Executor" for detailed explanation.

---

Security Requirements

CRITICAL: All generated files must follow security rules:

@~/.claude/plugins/marketplaces/dev-lifecycle-marketplace/docs/security/SECURITY-RULES.md

Key requirements:

• Never hardcode API keys or secrets
• Use placeholders: your_service_key_here
• Protect .env files with .gitignore
• Create .env.example with placeholders only
• Document key acquisition for users

Arguments: $ARGUMENTS

Goal: Complete Doppler setup with scripts, documentation, and GitHub integration

This command uses the doppler-management skill to generate all necessary files.

---

Phase 1: Discovery & Validation

Goal: Detect project context and check prerequisites

Actions:

• Parse $ARGUMENTS for project name or detect from directory: !{bash basename $(pwd)}
• Detect GitHub repository: !{bash git remote -v 2>&1 | grep origin | head -1 | sed 's/.github.com[:/](.).git.*/\1/' || echo "not-detected"}
• Check Doppler CLI installation: !{bash which doppler && doppler --version || echo "not-installed"}
• Check authentication: !{bash doppler me 2>&1 | grep -q "email" && echo "authenticated" || echo "not-authenticated"}
• Load project configuration: @.claude/project.json
• Check for existing .env files: !{bash ls -la .env* 2>/dev/null | grep -v .example || echo "no-env-files"}

If Doppler not installed:

• Display: "Install Doppler CLI: curl -Ls https://cli.doppler.com/install.sh | sh"
• Exit with instructions

If not authenticated:

• Display: "Run 'doppler login' to authenticate"
• Exit with instructions

---

Phase 2: Doppler Project Setup

Goal: Create Doppler project and environments

Actions:

• Create Doppler project: !{bash doppler projects create $PROJECT_NAME --description "$PROJECT_NAME - AI-powered application" 2>&1}

• Create environments with proper names and slugs: !{bash doppler environments create dev dev --project $PROJECT_NAME 2>&1 || echo "dev exists"} !{bash doppler environments create staging stg --project $PROJECT_NAME 2>&1 || echo "stg exists"} !{bash doppler environments create production prd --project $PROJECT_NAME 2>&1 || echo "prd exists"}

• Configure local development: !{bash doppler setup --project $PROJECT_NAME --config dev --no-interactive 2>&1}

• Verify environments created: !{bash doppler environments --project $PROJECT_NAME 2>&1}

---

Phase 3: Generate Scripts

Goal: Create all Doppler utility scripts from templates

Use doppler-management skill templates:

Create scripts/doppler/ directory: !{bash mkdir -p scripts/doppler}

Generate migrate-to-doppler.sh:

• Copy from: skills/doppler-management/scripts/migrate-to-doppler.sh
• Replace variables:
  • {{PROJECT_NAME}} → $PROJECT_NAME
  • {{GITHUB_REPO}} → $GITHUB_REPO (detected)
  • {{GENERATION_DATE}} → $(date +%Y-%m-%d)
• Output to: scripts/doppler/migrate-to-doppler.sh
• Make executable: !{bash chmod +x scripts/doppler/migrate-to-doppler.sh}

Generate run-with-doppler.sh:

• Copy from: skills/doppler-management/scripts/run-with-doppler.sh
• Replace {{PROJECT_NAME}} → $PROJECT_NAME
• Output to: scripts/doppler/run-with-doppler.sh
• Make executable: !{bash chmod +x scripts/doppler/run-with-doppler.sh}

Generate setup-doppler-github.sh:

• Copy from: skills/doppler-management/scripts/setup-doppler-github.sh
• Replace variables:
  • {{PROJECT_NAME}} → $PROJECT_NAME
  • {{GITHUB_REPO}} → $GITHUB_REPO
• Output to: scripts/doppler/setup-doppler-github.sh
• Make executable: !{bash chmod +x scripts/doppler/setup-doppler-github.sh}

---

Phase 4: Generate Documentation

Goal: Create comprehensive Doppler documentation

Use doppler-management skill templates:

Create docs/doppler/ directory: !{bash mkdir -p docs/doppler}

Generate README.md:

• Copy from: skills/doppler-management/templates/docs/README.md
• Replace variables:
  • {{PROJECT_NAME}} → $PROJECT_NAME
  • {{GITHUB_REPO}} → $GITHUB_REPO
• Output to: docs/doppler/README.md

Generate integration-guide.md:

• Copy from: skills/doppler-management/templates/docs/integration-guide.md
• Replace variables as needed
• Output to: docs/doppler/integration-guide.md

Generate github-integration.md:

• Copy from: skills/doppler-management/templates/docs/github-integration.md
• Replace {{GITHUB_REPO}} → $GITHUB_REPO
• Output to: docs/doppler/github-integration.md

Generate environment-setup.md:

• Copy from: skills/doppler-management/templates/docs/environment-setup.md
• Replace variables as needed
• Output to: docs/doppler/environment-setup.md

Copy PLUGIN-DESIGN.md:

• Copy from: skills/doppler-management/templates/docs/PLUGIN-DESIGN.md
• Output to: docs/doppler/PLUGIN-DESIGN.md

---

Phase 5: GitHub Actions Workflow

Goal: Create test workflow for verifying Doppler integration

Actions:

• Create .github/workflows/ directory if not exists: !{bash mkdir -p .github/workflows}

• Generate test-doppler-secrets.yml:

  • Copy from: skills/doppler-management/templates/workflows/test-doppler-secrets.yml
  • Replace variables as needed
  • Output to: .github/workflows/test-doppler-secrets.yml

---

Phase 6: Update .gitignore

Goal: Protect Doppler configuration files

Actions:

• Check if .gitignore exists

• Add Doppler entries if not present:

  # Doppler (secret management)
  .doppler.env
  doppler.yaml
  .doppler/
  

• Add to .gitignore: !{bash grep -q "doppler" .gitignore 2>/dev/null || echo -e "\n# Doppler (secret management)\n.doppler.env\ndoppler.yaml\n.doppler/" >> .gitignore}

---

Phase 7: Generate Summary Document

Goal: Create quick reference guide

Actions:

• Generate DOPPLER-SETUP-SUMMARY.md in project root
• Include:
  • Setup status
  • File locations
  • Next steps checklist
  • Common commands
  • Dashboard links
  • Migration checklist

---

Phase 8: Summary & Next Steps

Goal: Display completion status and guide user

Display:

╔════════════════════════════════════════════════════╗
║  Doppler Setup Complete!                           ║
╚════════════════════════════════════════════════════╝

Project: $PROJECT_NAME
Repository: $GITHUB_REPO
Environments: dev, stg, prd

Files Created:
✓ scripts/doppler/
  ├── migrate-to-doppler.sh       (8.4K)
  ├── run-with-doppler.sh         (1.3K)
  └── setup-doppler-github.sh     (8.2K)

✓ docs/doppler/
  ├── README.md                    (9.7K)
  ├── integration-guide.md         (15K)
  ├── github-integration.md        (12K)
  ├── environment-setup.md         (17K)
  └── PLUGIN-DESIGN.md            (Design docs)

✓ .github/workflows/
  └── test-doppler-secrets.yml    (6.8K)

✓ DOPPLER-SETUP-SUMMARY.md        (11K)

✓ .gitignore updated

═══════════════════════════════════════════════════

Next Steps:

1. EDIT MIGRATION SCRIPT (Required)
   nano scripts/doppler/migrate-to-doppler.sh

   Replace placeholders with real values:
   - GOOGLE_API_KEY
   - SUPABASE_URL
   - SUPABASE_ANON_KEY
   - SUPABASE_SERVICE_KEY

2. RUN MIGRATION
   scripts/doppler/migrate-to-doppler.sh

3. SETUP GITHUB INTEGRATION
   scripts/doppler/setup-doppler-github.sh

4. TEST LOCAL DEVELOPMENT
   scripts/doppler/run-with-doppler.sh uvicorn api.main:app --reload

5. VERIFY SECRETS
   doppler secrets --project $PROJECT_NAME --config dev

6. CLEAN UP OLD .env FILES (After verification)
   trash-put .env.development .env.staging .env.production

═══════════════════════════════════════════════════

Documentation:
- Quick Start: docs/doppler/README.md
- Full Guide:  docs/doppler/integration-guide.md
- GitHub Setup: docs/doppler/github-integration.md
- Summary:     DOPPLER-SETUP-SUMMARY.md

Dashboards:
- Doppler:  https://dashboard.doppler.com/workplace/projects/$PROJECT_NAME
- GitHub:   https://github.com/$GITHUB_REPO

═══════════════════════════════════════════════════

SECURITY REMINDER:
⚠️ migrate-to-doppler.sh contains PLACEHOLDERS only
⚠️ You MUST edit with real secrets before running
⚠️ Never commit this file after adding real secrets

---

Available Skills

This command has access to foundation plugin skills:

• doppler-management: Complete Doppler setup with all scripts and templates
• environment-setup: Tool verification and system checks
• mcp-configuration: MCP server configuration management
• project-detection: Tech stack and dependency detection

To use a skill: !{skill skill-name}