Autonomous Agent Setup Guide

1

Clone the Autonomous Agent Framework

First, get the autonomous agent framework:

cd D:\ClaudeDev\0_GITHUB\Tools
git clone https://github.com/YOUR_ORG/autonomous-coding-agent.git seo-rockstars-agent
cd seo-rockstars-agent

⚠️ Alternative: If you don't have git, download the ZIP from GitHub and extract to D:\ClaudeDev\0_GITHUB\Tools\seo-rockstars-agent

Your folder structure should look like:

📁 D:\ClaudeDev\0_GITHUB\Tools\seo-rockstars-agent\
  📁 prompts\
    📄 appspec.md ← Your project spec goes here
    📄 coding_prompt
    📄 initializer_prompt
  📁 generations\ ← Output projects appear here
  📄 autonomous_agent_demo.py
  📄 client.py
  📄 requirements.txt
  📄 .env ← Create this

2

Save Your AppSpec.md

Copy your appspec content to prompts/appspec.md:

📄 prompts/appspec.md

# seo rockstars conference app - Application Specification

## Overview
seo rockstars conference app to cover all things about the event while at the event and to have one place for everybody to communicate, and network, chat, keep notes, take pictures, discuss meals, bars, nightlife.

## Tech Stack

### Frontend
- Framework: Next.js 14+ with App Router
- Styling: Tailwind CSS
- State Management: React Context / Zustand

### Backend
- Next.js API Routes (Server Actions)
- Database: Supabase (PostgreSQL)
- Additional: Claude API, OpenAI, Clerk for auth, email service, Vercel deployment

### Communication
- REST API / Server Actions
- JSON data format

## Prerequisites
- Node.js 18+
- npm or pnpm package manager
- Supabase account and project
- API keys for: Claude, OpenAI, Clerk, email service

## Security & Access Control
- User authentication via Clerk (email/password or OAuth)
- Session management
- Protected routes
- Role-based access control (admin, attendee)

## Core Features
1. Real-time chat rooms (WhatsApp-style with channels)
2. Camera integration - take pictures
3. Video recording capability
4. Personal notes system
5. File/document upload and sharing
6. Q&A system for sessions
7. Daily conference check-in
8. Location sharing with attendees
9. Attendee directory and networking
10. Event schedule and agenda
11. Push notifications for updates
12. Meal/restaurant recommendations
13. Nightlife and social event coordination

## Additional Requirements
- Offline capability for notes
- Real-time sync across devices
- Mobile-first responsive design
- Dark/light mode toggle
- Export personal content (notes, photos)

## Development Guidelines
- Use TypeScript for type safety
- Implement proper error handling
- Add loading states for async operations
- Mobile-responsive design (mobile-first)
- Clean, maintainable code structure
- Comprehensive error messages for users
- NO mock data - use real API calls
- Accessibility (ARIA labels, keyboard nav)

3

Setup Python Environment

Create virtual environment and install dependencies:

Windows (PowerShell)

Windows (CMD)

Mac/Linux

# Navigate to project folder
cd D:\ClaudeDev\0_GITHUB\Tools\seo-rockstars-agent

# Create virtual environment
python -m venv venv

# Activate it (PowerShell)
.\venv\Scripts\Activate.ps1

# Install dependencies
pip install -r requirements.txt

REM Navigate to project folder
cd D:\ClaudeDev\0_GITHUB\Tools\seo-rockstars-agent

REM Create virtual environment
python -m venv venv

REM Activate it (CMD)
.\venv\Scripts\activate.bat

REM Install dependencies
pip install -r requirements.txt

# Navigate to project folder
cd ~/Tools/seo-rockstars-agent

# Create virtual environment
python3 -m venv venv

# Activate it
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

4

Get Your Claude Code Token (FREE with Pro!)

This is the magic - use your Claude Pro subscription instead of expensive API:

# Run this in your terminal (venv must be activated)
claude setup token

Browser opens → Login to Claude
Authorize the connection
Copy the token that appears

💡 Cost Savings: This runs on your $20/month Claude Pro subscription instead of $100s in API costs!

5

Create Your .env File

Create a .env file in the project root:

📄 .env

Paste your Claude Code OAuth Token:

N8N Webhook URL (optional - for progress notifications):

# Claude Code OAuth Token (from 'claude setup token')
CLAUDE_CODE_OAUTH_TOKEN=your_token_here

# Optional: Anthropic API Key (expensive alternative)
# ANTHROPIC_API_KEY=

# Optional: N8N webhook for Telegram/email progress updates
# PROGRESS_N8N_WEBHOOK=https://your-n8n.com/webhook/autocoder

6

🚀 Launch the Autonomous Agent!

This is it - one command to start building your entire app:

python -m autonomous_agent_demo "seo-rockstars-conference-app"

What happens now:

Phase 1: Agent reads your appspec.md → generates feature_list.json (150 features)
Phase 2: For each feature: implement → test → regression test → mark complete
Output appears in generations/seo-rockstars-conference-app/

Monitor Progress:

# Watch the progress file
type generations\seo-rockstars-conference-app\cla_progress.txt

# Or check feature completion
type generations\seo-rockstars-conference-app\feature_list.json

⚡

Quick Reference Commands

Tips:

You can stop (Ctrl+C) and resume anytime - it picks up where it left off
The agent uses Opus by default (best quality)
Each feature is tested with Playwright before moving on
Expect 150 features to take several hours to complete

✓

Pre-Flight Checklist

Git installed (or downloaded ZIP)
Python 3.10+ installed
Node.js 18+ installed
Claude Pro subscription active
Repository cloned to D:\ClaudeDev\0_GITHUB\Tools\
Virtual environment created & activated
requirements.txt installed
appspec.md saved to prompts folder
Claude token obtained via 'claude setup token'
.env file created with token

Click items to check them off

📦

One-Click Setup Script (Windows Batch)

Save this as setup-and-run.bat in your Tools folder for quick setup:

@echo off
echo ========================================
echo  Autonomous Agent Setup Script
echo  SEO Rockstars Conference App
echo ========================================
echo.

set PROJECT_DIR=D:\ClaudeDev\0_GITHUB\Tools\seo-rockstars-agent

:: Check if directory exists
if not exist "%PROJECT_DIR%" (
    echo [1/6] Cloning repository...
    cd D:\ClaudeDev\0_GITHUB\Tools
    git clone https://github.com/YOUR_ORG/autonomous-coding-agent.git seo-rockstars-agent
) else (
    echo [1/6] Project directory already exists, skipping clone...
)

cd "%PROJECT_DIR%"

:: Create virtual environment if it doesn't exist
if not exist "venv" (
    echo [2/6] Creating virtual environment...
    python -m venv venv
) else (
    echo [2/6] Virtual environment already exists...
)

:: Activate virtual environment
echo [3/6] Activating virtual environment...
call .\venv\Scripts\activate.bat

:: Install dependencies
echo [4/6] Installing dependencies...
pip install -r requirements.txt

:: Check for .env file
if not exist ".env" (
    echo [5/6] Creating .env template...
    echo # Claude Code OAuth Token - run 'claude setup token' to get this > .env
    echo CLAUDE_CODE_OAUTH_TOKEN=your_token_here >> .env
    echo. >> .env
    echo # Optional: N8N webhook for progress notifications >> .env
    echo # PROGRESS_N8N_WEBHOOK=https://your-n8n.com/webhook/autocoder >> .env
    echo.
    echo ========================================
    echo  IMPORTANT: You need to add your token!
    echo ========================================
    echo  1. Run: claude setup token
    echo  2. Copy the token to .env file
    echo  3. Re-run this script
    echo ========================================
    pause
    exit /b
) else (
    echo [5/6] .env file exists...
)

:: Run the agent
echo [6/6] Starting Autonomous Agent...
echo.
echo ========================================
echo  Building: seo-rockstars-conference-app
echo  This will take several hours...
echo  Press Ctrl+C to stop (can resume later)
echo ========================================
echo.

python -m autonomous_agent_demo "seo-rockstars-conference-app"

pause

🤖 Autonomous Agent Setup Guide