commit 002c1f2cfe3e608b8425fc2091b0a73c8de5b711 Author: primal Date: Mon Jan 26 16:31:27 2026 -0500 Initial commit with CLAUDE.md diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..5ef75f9 --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,39 @@ +# CLAUDE.md + +This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. + +## Overview + +AT Protocol Personal Data Server (PDS) for the 1440.news domain. Hosts Bluesky-compatible accounts for news feed aggregation. + +## Account Structure + +- `wehrv.1440.news` - Owner/admin account +- `{domain}.1440.news` - Catch-all feed per news source (e.g., `wsj.com.1440.news`) +- `{category}.{domain}.1440.news` - Category-specific feeds (future) + +## Infrastructure + +Runs as a Docker service behind Traefik. Related services: +- `app.1440.news` - Crawler that discovers feeds and posts to PDS accounts +- `traefik` - Reverse proxy handling TLS termination + +## Domains + +- `pds.1440.news` - PDS API endpoint +- `*.1440.news` - Account handles resolve here + +## Build & Run + +```bash +# Start service +docker compose up -d --build + +# View logs +docker logs -f pds-1440-news +``` + +## References + +- [AT Protocol PDS](https://github.com/bluesky-social/pds) +- [AT Protocol Specs](https://atproto.com/)