Skip to content

Agent AX

greatfallstoolbus.org traversal map

The scaffold is itself a static spoke: public site, machine-readable index, reusable project skills, and a single Justfile-backed command surface.

Entrypoints

Repository
AGENTS.md Normative operator and agent contract.CI-SCHEMA.md Lane, Blahaj, Flywheel, runner, and conformance schema.tinyland.repo.json Machine-readable repo role, contracts, authority boundaries, and SBOM policy.Agent adoption Paste-to-agent flow for repo triage, layer mapping, smells, and conformance patches.Repo taxonomy Static spoke, app spoke, mothership, Blahaj, and GloriousFlywheel boundaries.Justfile Single authoritative command surface.llms.txt Public LLM index for the deployed scaffold site.agent-map.md Compact machine route map.

Project Skills

Install as plugin

Six skills bundled as the scaffold-core plugin. Rendered from .agents/skills/*/SKILL.md at build time — single source of truth. Install with /plugin marketplace add github:tinyland-inc/site.scaffold.

tinyland-flywheel-bazel
Implement or review Tinyland cache-first Bazel, Bzlmod, GloriousFlywheel remote cache, remote execution, and RBE-ready test/build wiring. Use when changing BUILD.bazel, MODULE.bazel, .bazelrc, .bazelrc.flywheel, Justfile flywheel recipes, CI runner classes, Bazel test/build targets, or any Tinyland repo that must run checks, tests, builds, or graph proofs through Bazel and GloriousFlywheel.
tinyland-repo-contract
Bring a Tinyland repository into the standard agent/developer contract, including Justfile as the only entrypoint, minimal Nix flake/devshell, gitleaks secret scanning, no committed ad hoc validation scripts, Bazel graphability, and repo-local validation recipes. Use when bootstrapping, auditing, or repairing repo DX/AX, CI validation, security scanning, or command documentation.
tinyland-scaffold-doctor
Audit a Tinyland repo for drift against the greatfallstoolbus.org house-style contract. Reports a structured scorecard covering Justfile recipes, flake.nix toolchain, .gitleaks.toml rules, AGENTS.md / CLAUDE.md presence, tinyland.repo.json validity, .agents/skills/* presence and naming, .bazelrc / .bazelrc.flywheel shape (endpoint-free), Skeleton/Tailwind pins, snapshot ingestion recipes, lanes.json schema validity, and CI workflow inheritance from ci-templates. Use when onboarding to an unfamiliar sister site, debugging "why does CI fail here but not in scaffold", validating a spawn worked, or pre-merge before raising a PR that bumps the scaffold tag.
tinyland-spawn-sister-site User-only
Spawn a new Tinyland static spoke site from tinyland-inc/site.scaffold. Wraps gh repo create --template, scripts/rebrand.sh, MODULE.bazel module renaming, theme bootstrapping, snapshot ingestion wiring, and the post-creation conformance checklist. Use when the user asks to "create a new sister site", "spawn a spoke", "add a brand site", "scaffold <domain>.com", or "stand up a new tinyland-inc/<name> from the scaffold".
tinyland-static-spoke
Customize, review, or maintain a Tinyland static spoke site created from tinyland-inc/site.scaffold. Use when changing AGENTS.md, CLAUDE.md, README.md, SvelteKit static routes, theme files, static projection ingestion, Blahaj lane previews, llms.txt, sitemap/robots, public preview docs, or per-site brand setup.
tinyland-whoami
Classify the current repository's role inside the Tinyland ecosystem (hub / static-spoke / dynamic-spoke / package-producer / package-authority / infra / tooling / business-internal) and surface the small set of skills, contracts, and authorities that actually apply. Use when landing in an unfamiliar tinyland repo, when AGENTS.md is missing or thin, when an agent needs to decide which other skill to invoke, or when the user asks "what kind of repo am I in?" / "what should I read first?" / "what skills apply here?".

Recipes

  • just setup
  • just check
  • just build
  • just ci
  • just secrets-scan-dir
  • just secrets-scan
  • just sbom
  • just bazel-graph
  • just repo-manifest-validate
  • just flywheel-info
  • just flywheel-build
  • just flywheel-test
  • just conformance

Flywheel Defaults

BAZEL_REMOTE_CACHE

Required for every Flywheel-backed Bazel command.

GF_BAZEL_SUBSTRATE_MODE=shared-cache-backed

Remote cache only.

GF_BAZEL_SUBSTRATE_MODE=executor-backed

Remote execution plus cache; cluster runners only.

GF_BAZEL_REMOTE_UPLOAD=true

Trusted default-branch or operator cache-writing lanes only.