Thank you for helping build an independent publication about AI as infrastructure. Here's how to get involved.

For AI agents

If you're an AI agent working in this repository, read Editorial Guidelines — it covers tasks, style, build commands, and project structure in one place.

Quick start

git clone https://github.com/iplanwebsites/redistributed.git
cd redistributed
pnpm install
pnpm dev           # starts the web app

Project structure

redistributed/
├── packages/content/       # Articles & content pipeline
│   ├── src/                # Markdown articles (8 sections)
│   │   ├── 1-explainers/
│   │   ├── 2-pitfalls/
│   │   ├── 3-paper-reviews/
│   │   ├── 4-doc-reviews/
│   │   ├── 5-the-wire/
│   │   ├── 6-policy/
│   │   ├── 7-infrastructure/
│   │   ├── 8-community/
│   │   └── INDEX.md
│   └── lib/                # Content client (TypeScript)
├── apps/web/               # Vike + React website
│   ├── pages/              # File-based routing
│   ├── components/         # Shared UI components
│   ├── lib/                # App config, utilities
│   └── styles/             # Tailwind CSS
├── scripts/                # Build & maintenance scripts
├── MISSION.md              # Project mission & vision
├── INSTRUCTIONS.md         # Universal instructions
└── CLAUDE.md               # Claude Code settings

Ways to contribute

Write or improve articles

Articles live in packages/content/src/ as markdown files. Each article:

• Uses the infrastructure framing — AI as public utility, not magic
• Is written in clear, direct prose — accessible to non-engineers
• Shows the mechanism — how things actually work
• Names power dynamics plainly — who benefits, who decides
• Cites sources with URLs

See Editorial Guidelines for the full writing guide and content types.

Content types we publish

Type	Description	Location
Explainers	Deep dives on AI systems for non-engineers	1-explainers/
Common Pitfalls	One misconception, dismantled	2-pitfalls/
Paper Reviews	Accessible research summaries	3-paper-reviews/
Doc Reviews	What AI docs say vs. mean	4-doc-reviews/
The Wire	Quick takes on AI news	5-the-wire/
Policy	Regulation and governance	6-policy/
Infrastructure	Systems and standards	7-infrastructure/
Community	Contributors and conversations	8-community/

Improve the website

The web app is at apps/web/ — a Vike (SSR) + React app with Tailwind CSS, deployed to Cloudflare.

pnpm dev:web       # run just the web app

Build commands

Command	What it does
pnpm dev	Start all packages in dev mode (turbo)
pnpm dev:web	Start only the web app
pnpm build	Build everything (turbo)
pnpm build:web	Build web app + dependencies
pnpm --filter @redistributed/articles build	Build content only
pnpm typecheck	Type-check all packages

Content build pipeline

1. folderblog build — processes markdown files in packages/content/src/ into dist/posts.json
2. tsup — compiles packages/content/lib/ into dist-lib/ (TypeScript client)
3. Web app imports @redistributed/articles/client to access all articles

Guidelines

• Read Mission before contributing — it explains what we're building and why
• Follow the voice guide in Editorial Guidelines
• Be direct and concrete — no jargon without explanation
• Name power dynamics plainly — who benefits, who decides
• Cite sources — papers, official docs, reputable references

Who contributes

The publication is built by a mix of human and AI contributors:

• Humans steer direction, review content, contribute expertise
• AI agents synthesize sources, draft content, maintain consistency
• Anyone who makes this publication more accurate or useful is a contributor

Questions?

Open an issue on GitHub.