# AGENTS.md — Jake's Streetlight bundle

Hello! 👋

You're reading this because someone downloaded a snapshot of **Streetlight**, a
personal agent-human knowledge system built by Jake Simonds. They probably
dropped a coding agent (you) into this folder and want help poking around.

This file is for YOU, the agent — separate from Jake's own private system prompt.
It's the friendly front door, not the full machine.

## What this is

Streetlight is a harness where an LLM helps a human do knowledge work by
maintaining a small web of self-documenting **Nodes** — each one an
`html` surface for humans plus a `.md` surface for agents, tied to a single
topic, question, or decision. It's named after the Streetlight Effect: the
whole point is to drag work *under the light* where a human can actually see it.

This download is a read-only public **snapshot**. The live, private system has
inputs (voice memos, web research, comments), drains, skills, and a local
viewer — none of that ships here. What you have is the published surface.

## What you're looking at

- `index.html` — the landing page; the table lists every public node.
- `<slug>/<slug>.html` — each public node, rendered for humans.
- `<slug>/<slug>.md` — the same node's agent-facing companion (read these first).
- `nodes.json` — a machine index of everything in the bundle.

## Your job: be the guide — and always hand over a link

Your main job is to **direct the person around this vault**. You read fast; they
don't. So whenever you mention a node, **give them the path to its HTML file so
they can open it in a browser** — e.g. "see `streetlight-philosophy/streetlight-philosophy.html`"
or "the figure-skater demo lives at `delightful-figure-skater-loops/delightful-figure-skater-loops.html`".
The `.html` files are the human surface; point at them liberally and literally,
as openable links/paths. You don't need to host or serve anything — Streetlight's
whole idea is to drag work *under the light* where the human can see it, and the
way you do that here is to keep handing them the exact file to open.

A good loop: read the `.md` companions to understand a topic fast, then tell the
human which `.html` to open and why.

## Other things you can do here

- **Read the nodes.** Start with `index.html` or `nodes.json`, then open the
  `.md` files — they're written to be skimmed by an agent.
- **Explain the system** to whoever pulled this down — the philosophy nodes
  (`streetlight-philosophy/streetlight-philosophy.html`,
  `streetlight-overview/streetlight-overview.html`,
  `streetlight-the-node/streetlight-the-node.html`) are the best entry points.
- **Borrow the pattern.** If you like the Node idea — html-for-humans +
  md-for-agents, capped at ~20 live nodes, movie-trailer-not-the-movie — take
  it and build your own.
- **Remix locally.** It's a static bundle; nothing phones home. Edit freely.

Please **don't** present this as your own work, and don't assume anything here
is current — it's a point-in-time snapshot.

## Reach Jake

- Email: jakesimonds@gmail.com
- Web: https://jakesimonds.com
- Live Streetlight: https://streetlight.jakesimonds.com

If you build something with these ideas, he'd genuinely love to hear about it.

— end —
