`README.md`

51 lines
# zero-code-trading-bot

A Claude Code **skill** (own repo, symlinked into `~/.claude/skills/`) that turns a
plain-English trading strategy into a **paper-first** prediction-market bot.

Inspired by **Sharbel (@sharbel)** on X — *"how I built a trading bot with zero
code… just talking to an AI agent and iterating."* Adapted to the house rule that
**anything touching money is gated**: bots ship in paper mode, and going live is a
deliberate, multi-gate, human-approved step.

## What it does

1. **Compile** — you describe a strategy in words; Claude writes a validated
   declarative `strategy.json` (no code you have to write).
2. **Validate** — `scripts/validate_strategy.py` checks the schema and runs every
   rule through a sandboxed evaluator (strategy files are data, never `eval`).
3. **Scaffold** — `scripts/new_bot.py <name>` stamps out a self-contained,
   zero-dependency Python bot project (paper executor + append-only P&L ledger +
   read-only market data + dashboard), git-init'd.
4. **Paper-run** — the bot trades **live Polymarket markets for $0** (public API,
   no key), records simulated fills, and shows P&L.
5. **Go live?** — gated. Requires `LIVE=1` + `SAFE_MODE=0` + a confirmation token +
   a real broker key + a wired order call + a go-live approval memo. The skill
   never does this for you.

## Composes with

- **`polymtrx`** — read-only Polymarket edge scanner (discovery layer).
- **Ken / Kalshi dashboard** (`:7810`) — Kalshi paper portfolios + safe_mode
  autoTrader (Kalshi execution layer).

## Layout

```
SKILL.md                     orchestrator + when-to-use
scripts/new_bot.py           scaffold a bot project
scripts/validate_strategy.py schema + sandbox check
references/strategy-dsl.md    plain-English → strategy.json
references/safety-model.md    the paper-first / gated-live design
references/venues.md          Polymarket + Kalshi wiring, composition
assets/bot-template/          the runnable bot copied per strategy
```

## Safety in one line

Paper by default · sandboxed rules · kill switch · daily-loss breaker · exposure
cap · live trading blocked behind five gates + a human. See
`references/safety-model.md`.

MIT.