Skip to content

Add Agentic Field Guide website (agenticfieldguide.ai) - #2

Merged
AdminTurnedDevOps merged 32 commits into
mainfrom
agentic-field-guide-site
Oct 4, 2026
Merged

AdminTurnedDevOps merged 32 commits into
mainfrom
agentic-field-guide-site

Conversation

@AdminTurnedDevOps

Copy link
Copy Markdown
Owner

Adds an interactive website for the labs at agenticfieldguide.ai, built from this repo's markdown, plus Terraform for Azure Static Web Apps and Azure DNS, and a GitHub Actions pipeline.

What's in it

  • site/: Astro 7 site. README.md drives the navigation (tracks, labs, coming-soon items); lab pages render the repo's markdown in place, so content is never written twice.
  • Whiteboard design (Excalifont headings, Excalidraw palette, the repo banner), light and dark mode.
  • Copy buttons; "Your values" fill-in for $VARS in commands (secret-looking names are never stored or substituted); Pagefind search.
  • Security: hash-based CSP with no unsafe-inline; values inserted as text only; all GitHub Actions pinned to commit SHAs; fork PRs build and test but never deploy.
  • site/infra/: Terraform (azurerm 5.8.0) for the resource group, Static Web App (Free), DNS zone, apex + www custom domains, SPF record. Already applied except the www binding, which completes after the Squarespace nameserver switch.
  • .github/workflows/site.yml (build, unit tests, astro check, build + link check, Playwright, deploy, close preview) and site-infra.yml (Terraform fmt/validate only; CI never applies).

Content edits to existing files (please check)

  • Image syntax used for links fixed in deploy-agw.md, installation.md, kagent-substrate.md.
  • Alt text added to the README banner and 7 lab screenshots. The wording was drafted from the images; adjust as you like.
  • README gains a line linking to the site.

Deliberate deviations from the spec

  • CSP script-src includes 'wasm-unsafe-eval' (Pagefind runs as WebAssembly).
  • Terraform checks run in a separate site-infra.yml workflow.
  • Rough.js draws only the home-page arrow; boxes use CSS.
  • Playwright starts astro preview --ignore-lock (Astro 7 backgrounds preview in agent shells otherwise).
  • www custom domain added (Free plan allows 2 custom domains).

Verification

Unit tests 57/57, astro check 0 errors, build with internal link check, Playwright 12/12, Terraform fmt + validate.

Design spec: docs/superpowers/specs/2026-10-04-agentic-field-guide-site-design.md
Implementation plan: docs/superpowers/plans/2026-10-04-agentic-field-guide-site.md

🤖 Generated with Claude Code

AdminTurnedDevOps and others added 30 commits October 4, 2026 12:55
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…xcludes

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…e build

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…d theme

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…s Makefile

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…e tests

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…t credentials

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@github-actions

github-actions Bot commented Oct 4, 2026

Copy link
Copy Markdown

Azure Static Web Apps: Your stage site is ready! Visit it here: https://lively-smoke-0d84eea0f-2.eastus2.4.azurestaticapps.net

Azure Static Web Apps' trailingSlash "always" 301-redirected every file
(CSS, JS, fonts, images, Pagefind) to a non-existent "/" URL on the PR
preview. The default serves both /lab and /lab/, and all generated links
already end in a slash. The unit test now guards against reintroducing it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@github-actions

github-actions Bot commented Oct 4, 2026

Copy link
Copy Markdown

Azure Static Web Apps: Your stage site is ready! Visit it here: https://lively-smoke-0d84eea0f-2.eastus2.4.azurestaticapps.net

@AdminTurnedDevOps
AdminTurnedDevOps merged commit 7f96d1b into main Oct 4, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant