RemoteRabbit · RemoteRabbit · May 10, 2026 · May 10, 2026 · May 10, 2026 · May 10, 2026
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -16,11 +16,6 @@ jobs:
         with:
           fetch-depth: 0
 
-      # - name: Install lychee
-      #   run: |
-      #     curl -sSf '<https://sh.rustup.rs>' | sh
-      #     apt install gcc pkg-config libc6-dev libssl-dev
-
       - uses: astral-sh/setup-uv@v8.1.0
         with:
           enable-cache: true
@@ -32,8 +27,13 @@ jobs:
       - name: Install dependencies
         run: uv sync --frozen
 
-      # - name: Run pre-commit
-      #   run: uv run pre-commit run --all-files --show-diff-on-failure
+      - name: Install lychee
+        uses: taiki-e/install-action@v2
+        with:
+          tool: lychee
+
+      - name: Run pre-commit
+        run: uv run pre-commit run --all-files --show-diff-on-failure
 
-      - name: Build site
-        run: uv run zensical build
+      - name: Build site (strict)
+        run: uv run zensical build --strict
diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml
@@ -39,9 +39,8 @@ jobs:
       - name: Install dependencies
         run: uv sync --frozen --no-dev
 
-      - name: Build site
-        # See ci.yml for why --strict is disabled.
-        run: uv run zensical build
+      - name: Build site (strict)
+        run: uv run zensical build --strict
 
       - uses: actions/configure-pages@v6
 

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
@@ -31,6 +31,11 @@ repos:
         stages: [commit-msg]
         args: [ops]
 
+  - repo: https://github.com/rhysd/actionlint
+    rev: v1.7.12
+    hooks:
+      - id: actionlint
+
   - repo: local
     hooks:
       - id: zensical-build

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -0,0 +1,40 @@
+# Contributing
+
+This is primarily a personal stash of boilerplate I keep rewriting, published
+in the small chance someone else finds it useful.
+
+PRs are welcome but not actively solicited. If you spot a bug or want to add a
+snippet, feel free to open an issue or PR just keep in mind I'll prioritize
+based on whether I'd use it myself.
+
+## Local setup
+
+See [README.md](README.md) it covers `uv`, `make install`, and the local
+dev loop.
+
+## Conventions
+
+- **Conventional Commits** for commit messages (enforced via `pre-commit` on
+  the `commit-msg` hook). Allowed types are configured in
+  [`.pre-commit-config.yaml`](.pre-commit-config.yaml).
+- **Run `make pre-commit`** before pushing. CI runs the same hooks plus a
+  strict Zensical build.
+- **Snippets should be self-contained** copy a single block and it works.
+  Cite the upstream docs at the bottom of every page.
+- **Validate variables**. New Terraform variable blocks should follow the
+  pattern in [`docs/terraform/aws/variables.md`](docs/terraform/aws/variables.md):
+  type, description, sensible default (or `nullable = true`), and a
+  `validation` block with a complete-sentence `error_message`.
+
+## Reporting issues
+
+Open a GitHub issue with:
+
+- The page URL or path
+- What's wrong (typo, broken link, outdated example, missing context)
+- Optionally a suggested fix
+
+## License
+
+By contributing you agree your changes will be released under the project's
+[GPL-3.0 license](LICENSE).
diff --git a/README.md b/README.md
@@ -23,7 +23,7 @@ useful:
 | `lychee.toml`                | [lychee](https://lychee.cli.rs/) link-checker config (used by pre-commit and CI).                              |
 | `.editorconfig`              | Whitespace defaults across editors.                                                                            |
 | `Makefile`                   | Convenience targets — run `make help`.                                                                         |
-| `terragrunt/`                | Working Terragrunt example referenced by the docs *(WIP — being modernized)*.                                  |
+| `terragrunt/`                | Legacy Terragrunt example. Modern patterns live in [`docs/terraform/terragrunt/`](docs/terraform/terragrunt/). |
 | `.github/workflows/`         | `ci.yml` (PR checks), `deploy.yml` (Pages deploy on push to `main`), `links.yml` (lychee on PR + weekly cron). |
 
 ## Local development
@@ -79,3 +79,12 @@ This site originally ran on [Material for MkDocs](https://squidfunk.github.io/mk
 it now runs on [Zensical](https://zensical.org/), the team's new SSG. Zensical
 is currently alpha, so the dependency is pinned to an exact version
 (see [`pyproject.toml`](pyproject.toml)) and bumped deliberately.
+
+## Contributing
+
+This is primarily a personal stash, but PRs and issues are welcome. See
+[CONTRIBUTING.md](CONTRIBUTING.md) for the local setup and conventions.
+
+## License
+
+Released under the [GPL-3.0 license](LICENSE).
diff --git a/docs/api/error-responses.md b/docs/api/error-responses.md
@@ -1,5 +1,6 @@
 ---
 title: RFC 7807 problem+json
+description: RFC 7807 problem-detail error responses for HTTP APIs.
 status: stub
 tags:
   - api

diff --git a/docs/api/fastapi-skeleton.md b/docs/api/fastapi-skeleton.md
@@ -1,5 +1,6 @@
 ---
 title: FastAPI service skeleton
+description: Opinionated FastAPI project layout with settings, routers, and dependencies.
 status: stub
 tags:
   - api

diff --git a/docs/api/go-chi-skeleton.md b/docs/api/go-chi-skeleton.md
@@ -1,5 +1,6 @@
 ---
 title: Go chi service skeleton
+description: Minimal Go service skeleton built on chi with structured logging and graceful shutdown.
 status: stub
 tags:
   - api

diff --git a/docs/api/index.md b/docs/api/index.md
@@ -1,5 +1,6 @@
 ---
 title: API / Backend
+description: Service skeletons, error responses, pagination, and OpenAPI starters.
 status: stub
 tags:
   - api

diff --git a/docs/api/openapi.md b/docs/api/openapi.md
@@ -1,5 +1,6 @@
 ---
 title: OpenAPI starter + lint
+description: OpenAPI 3 starter spec plus linting with spectral or vacuum.
 status: stub
 tags:
   - api

diff --git a/docs/api/pagination.md b/docs/api/pagination.md
@@ -1,5 +1,6 @@
 ---
 title: Pagination — cursor vs offset
+description: Cursor and offset pagination patterns for REST APIs.
 status: stub
 tags:
   - api

diff --git a/docs/containers/compose-dev.md b/docs/containers/compose-dev.md
@@ -1,5 +1,6 @@
 ---
 title: Compose dev stacks
+description: Reusable docker compose stacks for local development (Postgres, Redis, observability).
 status: stub
 tags:
   - docker

diff --git a/docs/containers/distroless.md b/docs/containers/distroless.md
@@ -1,5 +1,6 @@
 ---
 title: Distroless / chainguard images
+description: Distroless and Chainguard base images for minimal, hardened runtime containers.
 status: stub
 tags:
   - docker

diff --git a/docs/containers/dockerfile-go.md b/docs/containers/dockerfile-go.md
@@ -1,5 +1,6 @@
 ---
 title: Go — static binary, distroless
+description: Multi-stage Dockerfile producing a static Go binary on a distroless runtime.
 status: stub
 tags:
   - docker

diff --git a/docs/containers/dockerfile-node.md b/docs/containers/dockerfile-node.md
@@ -1,5 +1,6 @@
 ---
 title: Node — multi-stage, pnpm
+description: Multi-stage Dockerfile for Node services with pnpm and a slim runtime stage.
 status: stub
 tags:
   - docker

diff --git a/docs/containers/dockerfile-python.md b/docs/containers/dockerfile-python.md
@@ -1,5 +1,6 @@
 ---
 title: Python — multi-stage with uv
+description: Multi-stage Dockerfile for Python services using uv and a slim runtime stage.
 status: stub
 tags:
   - docker

diff --git a/docs/containers/index.md b/docs/containers/index.md
@@ -1,5 +1,6 @@
 ---
 title: Containers
+description: Multi-stage Dockerfiles, distroless images, and Compose dev stacks.
 status: stub
 tags:
   - docker

diff --git a/docs/data/airflow-dag.md b/docs/data/airflow-dag.md
@@ -1,5 +1,6 @@
 ---
 title: Airflow TaskFlow DAG skeleton
+description: Airflow DAG skeleton with TaskFlow API, retries, and sensible defaults.
 status: stub
 tags:
   - data

diff --git a/docs/data/alembic-skeleton.md b/docs/data/alembic-skeleton.md
@@ -1,5 +1,6 @@
 ---
 title: Alembic migration skeleton
+description: SQLAlchemy + Alembic project layout with autogenerate, env.py, and per-env URLs.
 status: stub
 tags:
   - data

diff --git a/docs/data/dbt-skeleton.md b/docs/data/dbt-skeleton.md
@@ -1,5 +1,6 @@
 ---
 title: dbt project skeleton
+description: Opinionated dbt project skeleton — sources, staging, marts, and tests.
 status: stub
 tags:
   - data

diff --git a/docs/data/index.md b/docs/data/index.md
@@ -1,5 +1,6 @@
 ---
 title: Data
+description: Postgres conventions, Alembic migrations, dbt projects, and Airflow DAGs.
 status: stub
 tags:
   - data

diff --git a/docs/data/postgres-conventions.md b/docs/data/postgres-conventions.md
@@ -1,5 +1,6 @@
 ---
 title: Postgres schema conventions
+description: Postgres naming, schema, and constraint conventions for long-lived databases.
 status: stub
 tags:
   - data

diff --git a/docs/data/postgres-indexes.md b/docs/data/postgres-indexes.md
@@ -1,5 +1,6 @@
 ---
 title: Postgres indexing & partitioning
+description: When and how to add indexes — B-tree, partial, GIN, and covering indexes.
 status: stub
 tags:
   - data