agent-framework/env.example at main · nxtlvlrob/agent-framework · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
# Comet Apps Agent Framework - Environment Variables
# Copy this file to .env and fill in your values

# ===========================================
# REQUIRED: API Keys
# ===========================================

# Anthropic API Key (for Claude)
ANTHROPIC_API_KEY=sk-ant-...

# GitHub Token (with repo scope)
GITHUB_TOKEN=ghp_...

# ===========================================
# PROJECT CONFIGURATION
# ===========================================

# Project Name
# Agent will create repo if it doesn't exist
# Will be prefixed with "agent-" automatically
PROJECT_NAME=todo-app

# Knowledge Template (cloned once on first run)
# This is the template that gets copied into each project's .knowledge/ folder
# Format: owner/repo
KNOWLEDGE_TEMPLATE=your-username/knowledge-template

# SaaS Boilerplate Repository
# This is the template that gets cloned as the starting point for new products
# Format: owner/repo
BOILERPLATE_REPO=your-username/saas-boilerplate

# ===========================================
# BRANCHING STRATEGY
# ===========================================

# The branch the agent works on (typically release/dev)
# Agent will create this branch if it doesn't exist
PROJECT_BRANCH=release/dev

# The staging branch (merged to when dev is ready)
# Used for pre-production testing and Vercel preview
STAGING_BRANCH=release/stage

# The production branch (human-controlled)
# Agent can prepare PRs but never directly merges to this
PRODUCTION_BRANCH=release/prod

# Auto-merge to staging when build passes?
# If "true", agent will auto-merge dev → stage when tests pass
# If "false", agent creates a PR instead (recommended for safety)
AUTO_MERGE_TO_STAGING=false

# ===========================================
# VERCEL DEPLOYMENT
# ===========================================

# Vercel Token (from https://vercel.com/account/tokens)
# Required for project setup and deployment management
VERCEL_TOKEN=

# Vercel Team ID (optional, for team projects)
# Find at: https://vercel.com/teams -> Team Settings
VERCEL_TEAM_ID=

# Vercel Org ID (your personal account ID if no team)
# Find at: https://vercel.com/account -> General
VERCEL_ORG_ID=

# Auto-link to Vercel on project init?
# If "true", deployer will automatically create Vercel project
AUTO_SETUP_VERCEL=true

# Vercel project settings
# These are used when auto-creating the Vercel project
VERCEL_FRAMEWORK=nextjs
VERCEL_ROOT_DIRECTORY=./
VERCEL_BUILD_COMMAND=npm run build
VERCEL_OUTPUT_DIRECTORY=.next

# Branch → Environment mapping for Vercel
# release/dev → Preview (automatic via git push)
# release/stage → Preview with "staging" alias
# release/prod → Production (only via manual promote or human merge)

# ===========================================
# GIT IDENTITY
# ===========================================

# Git commit identity
GIT_AUTHOR_NAME=Comet Agent
GIT_AUTHOR_EMAIL=agent@cometapps.dev

# ===========================================
# ORCHESTRATION MODE
# ===========================================

# Set to "smart" for full autonomous pipeline
# Leave empty for single-role mode (uses AGENT_ROLE)
ORCHESTRATE_MODE=smart

# Maximum total cycles before forced stop
MAX_CYCLES=20

# Maximum consecutive developer cycles before forcing a review
MAX_DEV_CYCLES=5

# Run reviewer every N developer cycles
REVIEW_EVERY=3

# ===========================================
# LOGGING & OUTPUT
# ===========================================

# Logging: "pretty" (default) or "json" for raw output
LOG_FORMAT=pretty

# ===========================================
# PRODUCT ENVIRONMENT VARIABLES
# ===========================================
# These get pushed to Vercel by the DEPLOYER agent.
#
# ⚠️  WARNING: If these are empty, the deployer will push empty values to Vercel,
#    which will cause your deployment to fail with auth/database errors!
#
# The container will:
# 1. FAIL TO START if ANTHROPIC_API_KEY, GITHUB_TOKEN, or PROJECT_NAME are missing
# 2. WARN on startup if MONGODB_URI, CLERK_SECRET_KEY, or NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY are empty
# 3. FAIL during deployment if trying to push empty values to Vercel

# ===========================================
# REQUIRED FOR DEPLOYMENT TO WORK
# ===========================================
# Without these, your deployed app will crash!

# MongoDB - Your database connection string
MONGODB_URI=mongodb+srv://user:password@cluster.mongodb.net/dbname

# Clerk Authentication - Get these from clerk.com dashboard
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_...
CLERK_SECRET_KEY=sk_test_...
CLERK_WEBHOOK_SECRET=whsec_...

# ===========================================
# OPTIONAL - App Features
# ===========================================
# These are optional but needed for full functionality

BILLING_SYNC_SECRET=

# Clerk Plan IDs (from Clerk Dashboard)
CLERK_PLAN_ID_SINGLE_PRO=
CLERK_PLAN_ID_PORTFOLIO_PRO=
CLERK_PLAN_ID_ENTERPRISE=

# Sentry Error Tracking (recommended for production)
SENTRY_DSN=
NEXT_PUBLIC_SENTRY_DSN=

# Upstash Redis (Rate Limiting - recommended)
UPSTASH_REDIS_REST_URL=
UPSTASH_REDIS_REST_TOKEN=

# Cloudflare R2 (File Storage - Optional)
R2_ACCOUNT_ID=
R2_ACCESS_KEY_ID=
R2_SECRET_ACCESS_KEY=
R2_BUCKET_NAME=