agent-seed

# agent-seed

**Self-evolving AI assistant starter kit. Markdown-only. Works with any LLM agent.**

Plant the seed. It grows with you.

---

## What is this?

A collection of markdown files that teach AI agents who you are — your voice, your preferences, your work context, your priorities.

It works with [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Codex](https://openai.com/index/introducing-codex/), [Devin](https://devin.ai), [Cursor](https://cursor.sh), [Windsurf](https://codeium.com/windsurf), and anything else that reads markdown.

No API keys. No runtime. No vendor lock-in. Just `.md` files.

### What it does

- **Gives any AI your voice** — communication style, tone, patterns
- **Tracks your daily priorities** — todos, drafts, notes
- **Self-improves** — learns from each session, proposes new agents via PRs
- **Stays small** — enforced size limits prevent markdown bloat
- **Grows with you** — `/setup` generates agents based on YOUR workflow, `/learn` evolves them over time

### What it doesn't do

- Doesn't require API keys or expose secrets
- Doesn't lock you into any tool or vendor
- Doesn't run any code — it's just context files

## Quick Start

### 1. Use this template

Click **"Use this template"** on GitHub, or:

```bash
git clone https://github.com/jcurbelo/agent-seed.git my-agent
cd my-agent
rm -rf .git && git init
```

### 2. Run setup

Open the repo in your preferred AI coding tool and run:

```
/setup
```

The setup wizard will ask about your name, role, communication style, and tools — then generate personalized agents, voice profiles, and context files.

### 3. Start using it

```
/standup    # Morning briefing — scan todos, plan the day
/review     # Quick check-in — what needs attention?
/eod        # End of day — capture learnings, prep tomorrow
/learn      # Self-improvement — prune, evolve, grow new agents
```

## How It Works

### The Index Pattern

Every folder has an `index.md` that links to detail pages — like imports i