Agora

Public site: https://agora.castalia.institute/ — GitHub Pages from this repo (/docs). If the custom domain fails, open https://inquiryinstitute.github.io/agora/ until DNS is configured (see docs/DNS.md).

Agora is Castalia’s executable marketing-in-the-age-of-AI platform: worlds (audience and message models), runs, evidence with provenance, plans (structured, reviewable steps), and lineage for defense and compliance.

It implements the architecture described for the Mag.AI-Marketing program—teaching and production share the same primitives.

Dev container (Mag.AI students)

Use .devcontainer/ with VS Code Dev Containers or GitHub Codespaces. The base image is Google’s official google-cloud-cli:slim (gcloud preinstalled); Node 22, Python 3.12, and GitHub CLI are added as features, then the setup script installs check-jsonschema and runs npm ci in site/ and executors/openclaw-agora-bridge/. After the container finishes, run schema checks from the repo root, preview the site with cd site && npm run dev (port 4321), build Pages output with bash .devcontainer/build-pages.sh (loads optional site/.env), and see .devcontainer/README.md for deploy-from-container steps and optional gcloud / gh auth.

Repository layout

Path	Purpose
.devcontainer/	Dev Containers / Codespaces definition for Mag.AI students (Node + Python + deps)
schemas/	JSON Schemas (draft 2020-12) for Plan and Evidence artifacts
examples/	Minimal JSON instances validated in CI
site/	Astro source for the public front page; npm run build writes static output to docs/ for GitHub Pages
docs/ARCHITECTURE.md	Platform map and phase checklist summary
docs/OPENCLAW_TOOLS.md	Draft tool surface for OpenClaw execution (bridge, research, content, gated channels)
docs/OPENCLAW_AGENTS.md	Recommended OpenClaw agents per task + agents-catalog.json
docs/AGORA_USES.md	Example uses & prompts (creatives via Nano Banana / Gemini image, social post, social research)
docs/CHAT.md	GitHub Pages /chat/ ↔ OpenClaw gateway (CORS, auth, PUBLIC_OPENCLAW_GATEWAY_URL)
docs/PAGES_GOOGLE_AUTH.md	Google OAuth on /chat + edge options (Cloudflare Access, IAP)
executors/openclaw-agora-bridge/	Stub OpenClaw plugin + tool-catalog.json for Tier A–F tool names
custodian/	AWS CLI (--profile custodian), IAM policies, Route 53 helpers; optional Cloud Custodian
deploy/gcp/	GCP notes: e2-micro VM + Gemini (Vertex vs API key), firewall, service accounts, secrets; GCLOUD_OAUTH.md for gcloud + OAuth Web client for /chat
deploy/openclaw-gateway/	Dockerfile + Compose + Actions: GHCR publish; optional fully automated GCE rollout over SSH (vars + secrets in that README)

Schemas

Schema	$id (stable)
Plan	https://raw.githubusercontent.com/InquiryInstitute/agora/main/schemas/agora-plan.schema.json
Evidence	https://raw.githubusercontent.com/InquiryInstitute/agora/main/schemas/agora-evidence.schema.json

Downstream tools should resolve $id from this repo’s main branch unless you pin a release tag. When the public site serves stable schema URLs under agora.castalia.institute, those may become the preferred $id (keep GitHub raw as fallback).

Validate locally

pip install 'check-jsonschema>=0.29'
check-jsonschema --schemafile schemas/agora-plan.schema.json examples/minimal-plan.json
check-jsonschema --schemafile schemas/agora-evidence.schema.json examples/minimal-evidence.json

Public site (Astro)

The landing page is built with Astro in site/. Output is written to docs/ (same folder GitHub Pages publishes).

cd site && npm ci && npm run build

For local preview during development: cd site && npm run dev.

The static site includes /chat/ — a browser UI that talks to an OpenClaw Gateway over the OpenAI-compatible HTTP API. Build and run the gateway from this repo: deploy/openclaw-gateway/ (Docker image + Compose; CI builds it). Configure CORS for your Pages origin. The chat form uses gateway URL + Bearer token (session / local storage). Optional: PUBLIC_OPENCLAW_GATEWAY_URL in site/.env (see site/.env.example). Edge auth and optional Google patterns are documented in docs/CHAT.md and docs/PAGES_GOOGLE_AUTH.md.

Commit the updated docs/ after changing the front page so Pages stays in sync.

Related

• Agora (Castalia) — public site
• Mag.AI-Marketing — platform design (pedagogy-aligned specification)
• Castalia Magisterium

License

MIT — see LICENSE.