feat: rebuild site with Astro

.github/workflows/deploy.yml

@@ -0,0 +1,39 @@
+name: Deploy static site
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+      - run: npm ci
+      - run: npm run build
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: dist
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -1,2 +1,7 @@
 # Temporary files (screenshots for PR comments, etc.)
 temp/
+
+# Astro build and generated type metadata
+dist/
+.astro/
+node_modules/

README.md

@@ -35,12 +35,19 @@ rMax.AI is an agent-first research lab focused on building, evaluating, and publ
 3. Prefer small, testable behaviors with explicit success criteria and recovery paths.
 4. Test changes by running the agent orchestration in a controlled environment or via manual prompt simulations.
 
-## Local preview
+## Local development
 
-- This is a static site. Quick local preview:
-  - python -m http.server 8000
-  - Open http://localhost:8000
-- Use scripts/ for maintenance tasks such as sitemap generation.
+The site is built with Astro and deployed as static HTML. Markdown notes in
+`notes/<slug>/index.md` are the publication source; Astro renders the note
+pages and index during the build.
+
+- `npm install`
+- `npm run dev` for a local preview
+- `npm run check` for Astro diagnostics
+- `npm run build` to create the production artifact in `dist/`
+
+GitHub Pages deploys the `dist/` artifact with the custom-domain `CNAME` and
+`.nojekyll` files from `public/`.
 
 ## Contributing
 - Open issues or PRs on GitHub: https://github.com/rmax-ai/rmax-ai.github.io

astro.config.mjs

@@ -0,0 +1,8 @@
+import { defineConfig } from 'astro/config';
+import sitemap from '@astrojs/sitemap';
+
+export default defineConfig({
+  site: 'https://rmax.ai',
+  output: 'static',
+  integrations: [sitemap()],
+});

notes/cloudflare-temporary-accounts-ai-agents/index.md

@@ -1,5 +1,5 @@
 ---
-title: Temporary Accounts for AI Agents: How Cloudflare Removes Friction Without Removing Control
+title: "Temporary Accounts for AI Agents: How Cloudflare Removes Friction Without Removing Control"
 slug: cloudflare-temporary-accounts-ai-agents
 description: A technical note on Cloudflare temporary accounts for AI agents, arguing that bounded, expiring capability is a practical onboarding pattern for agent-native platforms.
 author: Max

notes/mlops-agent-harness-engineering/index.md

@@ -10,12 +10,12 @@ status: "published"
 date: 2026-03-22
 updated: 2026-03-22
 tags:
-	- agents
-	- mlops
-	- harness
-	- systems-engineering
-	- verification
-	- observability
+  - agents
+  - mlops
+  - harness
+  - systems-engineering
+  - verification
+  - observability
 reading_time: "8–10 min"
 canonical_url: "https://rmax.ai/notes/mlops-agent-harness-engineering/"
 license: "CC BY 4.0"

notes/personal-software-factory/index.md

@@ -10,11 +10,11 @@ status: "published"
 date: 2026-01-20
 updated: 2026-01-20
 tags:
-	- "agents"
-	- "software-architecture"
-	- "developer-productivity"
-	- "tooling"
-	- "operations"
+  - "agents"
+  - "software-architecture"
+  - "developer-productivity"
+  - "tooling"
+  - "operations"
 reading_time: "4 min"
 canonical_url: "https://rmax.ai/notes/personal-software-factory/"
 license: "CC BY 4.0"

notes/tests-not-silver-bullet-resilience-first-observability/index.md

@@ -10,12 +10,12 @@ status: published
 date: 2026-02-08
 updated: 2026-02-08
 tags:
-	- testing
-	- reliability
-	- observability
-	- resilience
-	- operations
-	- ai-assisted-development
+  - testing
+  - reliability
+  - observability
+  - resilience
+  - operations
+  - ai-assisted-development
 reading_time: 5–7 min
 canonical_url: https://rmax.ai/notes/tests-not-silver-bullet-resilience-first-observability/
 license: CC BY 4.0