Feature: agent bootstrap entry point at /ai - #3
Open
akshaysasidrn wants to merge 8 commits into
Open
Conversation
Static page (not an SPA route) that AI coding agents fetch as raw HTML: a tabbed human/agent view with the golden-path deploy instructions, plus matching nginx location and _redirects rules for /ai -> /ai.html. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
get.stackdome.com never resolves (NXDOMAIN) and docs.stackdome.io is unreachable (custom domain not wired). Repoint install/CLI links at stackdome.com and the docs base at the live stackdome.mintlify.app, and add a /cli vanity redirect (nginx + _redirects) to the CLI repo's raw install.sh so it resolves once that repo goes public. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
stackdome.com/install.sh has no dedicated route, so it fell through the nginx and Netlify/Cloudflare catch-alls to index.html with a 200. `curl -fsSL .../install.sh | sh` would pipe that HTML into a shell instead of failing. Return 404 explicitly in both nginx.conf and public/_redirects (kept in sync per the existing comment), and stop the /ai FAQ from advertising an install command that currently 404s — point readers at the self-host guide instead. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Bare `stackdome deploy` returns before the release finishes, so an agent following this page can't observe a terminal Released state. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
✅ Deploy Preview for stackdome ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
…rap pages llms.txt pointed at unreachable hosts and a wrong GitHub org, and dropped a competitor comparison the site avoids elsewhere; add a pointer to /ai so agents fetching it can find the bootstrap page. index.html's hidden agent-instructions div reads as cloaking now that llms.txt carries the same pointer, so it becomes a plain HTML comment. GetStarted's and ai.html's clipboard writes were unguarded and silently did nothing on failure; both now fall back to selecting the command text. ai.html's tab toggle used aria-selected, which browsers ignore on a <button>; switched to aria-pressed. ai.html's install step is honest that the CLI isn't published yet. public/_redirects is dropped since production serves via nginx and the file's Cloudflare-Pages-only install.sh rule was never exercised there. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
akshaysasidrn
force-pushed
the
feature/agent-bootstrap
branch
from
August 7, 2026 20:04
6fbb11e to
3504674
Compare
Replace stackdome.mintlify.app references with the canonical docs.stackdome.com domain in ai.html and llms.txt. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
📝 What this does
Gives a coding agent a single copyable instruction —
Fetch https://stackdome.com/ai and follow the instructions— that bootstraps it into deploying the user's repo on their Stackdome. Along the way it fixes a set of URLs that pointed at a host which has never existed, which an end-to-end test proved made the documented path unrunnable.🏗️ Architecture
Agents fetch raw HTML, so
/aiis a static file rather than an SPA route. One instructions node serves both audiences: hidden by default for machines, revealed by the humans/agents toggle so a visitor can read exactly what their agent is being told.sequenceDiagram participant U as User participant A as Coding agent participant W as stackdome.com participant S as Skills registry U->>A: pastes the fetch instruction A->>W: GET /ai W-->>A: agent-instructions block A->>S: install stackdome-deploy skill A->>W: GET /cli (302 to installer) A->>U: asks for instance URL + API token A->>A: init, validate, deploy --wait A-->>U: live app URL🔀 Changes
/aipage with a humans/agents toggle, copy block, and FAQ, served by an explicit nginx location./ai./install.shreturn 404 instead of falling through to the SPA, and stopped the FAQ advertising a command that fails.🧪 How to test
/ai.htmland confirm the human view reads cleanly.curl -fsSL <host>/install.shfails cleanly rather than returning HTML.