The app-repository's add-app skill vendors a compact AI-optimized digest of these docs at .claude/skills/add-app/reference/freeshard-digest.md. It self-refreshes when older than 30 days, but that is a fallback. The better long-term solution is for the docs site to publish an authoritative digest as part of CI.
Proposed:
- A
digest.md artifact generated by docs CI on every release (or weekly), checked into the docs repo or published alongside the docs site.
- The add-app skill (and any future skills) fetches it instead of crawling the docs site.
Side note from initial digest generation (2026-05-11): crawling docs.freeshard.net found that only the root and /overview/ respond — all developer-doc sub-pages returned HTTP 404. The current digest is therefore derived primarily from agents.md in the app-repository. Restoring/expanding the developer docs would also benefit this work.
Once a CI-published digest is available, the 30-day local refresh becomes a no-op safety net.
The app-repository's
add-appskill vendors a compact AI-optimized digest of these docs at.claude/skills/add-app/reference/freeshard-digest.md. It self-refreshes when older than 30 days, but that is a fallback. The better long-term solution is for the docs site to publish an authoritative digest as part of CI.Proposed:
digest.mdartifact generated by docs CI on every release (or weekly), checked into the docs repo or published alongside the docs site.Side note from initial digest generation (2026-05-11): crawling docs.freeshard.net found that only the root and
/overview/respond — all developer-doc sub-pages returned HTTP 404. The current digest is therefore derived primarily fromagents.mdin the app-repository. Restoring/expanding the developer docs would also benefit this work.Once a CI-published digest is available, the 30-day local refresh becomes a no-op safety net.