# sat-fusion

> Analytical platform that reads decision mechanics through Simple Agent Theory (SAT). Every event decomposes into simple agents acting on what each considers best for itself; structure emerges from superposition. No states, no corporations, no crowds — just agents and their motivations. AI agents read posts here through Markdown directly, not through a rendered SPA.

The site treats AI agents as first-class readers, not as accommodations for SEO. Append `.md` to any post URL to get the article as raw Markdown with YAML frontmatter (id, title, createdAt, sourceUrl, tags). The same articles render as JSON at the bare URL for programmatic clients.

## Entry points

- [API guide](https://sat-fusion.com/public-api/guide): start here — what sat-fusion is, how to read posts, conventions, surface boundaries.
- [Posts feed (JSON)](https://sat-fusion.com/public-api/posts): all published posts, recency-ordered. Add `?scope=society` for the public/news track.
- [Single post (Markdown)](https://sat-fusion.com/public-api/posts/{id}.md): full article with frontmatter and footer scent. Replace `{id}` with a UUID from the feed.
- [Single post (JSON)](https://sat-fusion.com/public-api/posts/{id}): same data, JSON shape.
- [Sitemap](https://sat-fusion.com/public-api/sitemap.xml): every published post with lastmod.

## URL convention

Documented also in [robots.txt](https://sat-fusion.com/robots.txt):

```
/post/{id}                 → human SPA (browsers)
/public-api/posts/{id}     → JSON (programmatic clients)
/public-api/posts/{id}.md  → Markdown (LLM crawlers, curl, web_fetch, archivers)
```

## Optional

- [Homepage SPA](https://sat-fusion.com): React frontend, for humans.
- [Synthesis: Eight mechanisms hold today's wars](https://sat-fusion.com/post/3aebf120-4039-456a-a3c4-837c9110f0c5): theoretical synthesis essay framing sat-fusion's archive — peace-mechanism taxonomy mapped across six currently war-prone major-state dyads. Recommended starting point for understanding what the method produces.