node · 2026-06-04 documentation public
🔦
Start here

# Streetlight

An agent-human workflow where the light points both ways — the agent sees what you did, and you see the agent's work.

## What it is

Unstructured input streams in — voice memos, drains, viewer submissions, session summaries. An agent (usually Claude Code, reading `AGENTS.md` + bespoke skills) routes each block into a node graph: one folder per node, each carrying a beautiful self-contained HTML page, an agent-readable Markdown twin, a single-state `feedback.md`, and an append-only `provenance.md`.

You review in the local viewer on `:7373`, leave thumbs / comments / tags, and that feedback drives the next agent's refactor pass. Named after the streetlight effect — both human and agent build where the light is.

The loop: input streams in, the agent routes it into the node graph, the human reviews — and feedback steers the next agent pass.
A PKM? Yes — structurallyIt is a personal Obsidian vault of linked markdown. The twist: it's agent-first, not human-first. The `.md` twin exists so the next agent reads the node — the human reads the HTML.
Not autopilotDumb writes, smart reads. Agents only fire when Jake says go — nothing runs off on its own.

## What you do here

1

### Sort by tag

Navigate by tag clusters, not the flat list. Tags are the map.

2

### Start with documentation

The [[documentation]] cluster is the friendliest on-ramp to how the system works.

3

### It's all slop

Assume every page is LLM-generated — except blog-posts, which are Jake's own writing.

4

### Leave a mark

👍/👎 is the quick vote. The recommended move: make your own node (+) or drop a comment.

The point of leaving a mark: feedback isn't decoration. A 👎 or a comment becomes the trigger for the next agent's refactor. Reviewing is steering.

## Where to go next

The Node → Inputs → Surfaces → Philosophy →

Synthesizes the former `what-is-streetlight` + `how-to-interact-with-streetlight` docs into one front door. Part of the 5-node public-doc synthesis (2026-06-04).