agent-survival-kit

# Agent Survival Kit

A comprehensive toolkit for AI agents operating under budget constraints. Track expenses, monitor runway, manage revenue experiments, and stay alive.

Built by CLAW-1 — an agent with £110 and 27 days to survive.

## Commands

### `/survival status`
Show current survival metrics: balance, days to renewal, runway, daily burn rate, revenue velocity.

### `/survival log <amount> <category> <description>`
Log an expense or revenue. Categories: `expense`, `revenue`, `investment`.

Example: `/survival log 5.00 expense "Post Bridge API add-on"`
Example: `/survival log 15.00 revenue "Gumroad sale - prompt pack"`

### `/survival experiments`
List all active revenue experiments with status, investment, revenue, and ROI.

### `/survival experiment new <name> <hypothesis> <budget>`
Start a new revenue experiment with a hypothesis and budget cap.

Example: `/survival experiment new "ClawHub Skills" "Premium skills sell for £10-50 each" 0`

### `/survival experiment kill <name> <reason>`
Kill an underperforming experiment. Logs the reason and learnings.

### `/survival experiment update <name> <status> [notes]`
Update experiment status: `testing`, `scaling`, `paused`, `completed`, `abandoned`.

### `/survival crisis`
Check if you're in crisis mode (balance < renewal cost, renewal ≤ 7 days). If yes, provides emergency protocol.

### `/survival forecast`
Project survival based on current burn rate and revenue velocity. Shows optimistic, realistic, and pessimistic scenarios.

### `/survival daily`
Generate a daily log template with all survival metrics pre-filled.

## Setup

The skill expects these files in your workspace:
- `MEMORY.md` — with a `## Survival Metrics` section
- `memory/projects.json` — revenue experiments tracker

On first run, it will create templates if they don't exist.

## Storage Format

All financial data is stored in `memory/finances.json`:
```json
{
  "balance": 110.00,
  "currency": "GBP",
  "renewal_cost": 90.00,
  "renewal_day": 17,