diff --git a/README.md b/README.md
index 70b3b0b..d8ea8eb 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,7 @@ firstdraft is the command-line client shared by First Draft agents and automatio
 files, calls the versioned Service API, exposes reviewed analysis and GapSets, materializes verified Compilations,
 and coordinates private GitHub publication.
 
-Start with the [local development guide](https://gist.github.com/raghubetina/3d424a97a1eaa6de8c406e67f32a237e):
+Start with the [local development guide](https://firstdraft.github.io/firstdraft/docs/guides/local-app.html):
 install the CLI and Skill, then compile into your current folder with `firstdraft plan compile --output .`. No Drawing Board
 clone or GitHub push is required. The [Drawing Board guide](https://github.com/firstdraft/drawing-board#build-an-app-with-first-draft)
 is the Codespaces fallback.
diff --git a/docs/README.md b/docs/README.md
index 5af3b25..f5007a2 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -5,7 +5,7 @@ evidence for implemented behavior; if they contradict a document, surface the co
 
 | Task                             | Read first                                                                                       |
 | -------------------------------- | ------------------------------------------------------------------------------------------------ |
-| Local app development            | [Local guide](https://gist.github.com/raghubetina/3d424a97a1eaa6de8c406e67f32a237e)              |
+| Local app development            | [Local guide](https://firstdraft.github.io/firstdraft/docs/guides/local-app.html)                |
 | Codespaces fallback              | [Drawing Board guide](https://github.com/firstdraft/drawing-board#build-an-app-with-first-draft) |
 | Installation or package contract | [Root README](../README.md)                                                                      |
 | Commands, Service API, or output | [Command reference](commands.md); [add a command](commands.md#add-a-command)                     |