2.4 KiB
Loop Library Operating Rules
Adding or editing loops
-
Treat
scripts/loop-data.mjsas the canonical SEO/GEO content catalog for every public loop. -
Keep the matching searchable row in
site/index.htmlaligned with the catalog entry, including title, prompt, attribution, link, and visible count. -
Every loop must have a stable slug, unique search title and description, contributor attribution, published and modified dates, practical context, verification criteria, and related-loop links.
-
After changing the catalog or homepage rows, run
node scripts/build-skill-catalog.mjsandnode scripts/build-loop-pages.mjs, capture the versioned page screenshots, and then runnode scripts/build-social-images.mjs. Commit the skill catalog, screenshots, generated detail pages,site/sitemap.xml, andsite/feed.xml. -
Run the full repository checks before committing:
node scripts/build-skill-catalog.mjs node scripts/build-loop-pages.mjs node scripts/build-social-images.mjs node --check scripts/build-social-images.mjs node --check site/script.js node --check scripts/build-loop-pages.mjs node --check scripts/loop-data.mjs node scripts/check.mjs npm --prefix worker run check python3 -m json.tool site/.herenow/data.json >/dev/null git diff --check -
Do not add a loop if the checks report drift between the homepage, source catalog, installable skill catalog, generated pages, structured data, sitemap, or feed.
Deployment
- Treat
deployin a thread as a request to commit and land only that thread's changes, then deploy the affected site from the newestorigin/maincommit that contains those changes. - Never deploy from a task worktree, dirty checkout, feature branch, or partial
file overlay. Publish the complete
site/directory from a clean deployment checkout on latest integrated main. - Serialize deployments with
/Users/matthewberman/.codex/deploy-locks/loop-library.lock. Wait for an active deployment, then fetch and fast-forward again before selecting the deployment revision. - Hold the lock through here.now finalize and production verification.
- Deploy and verify the form Worker before publishing a site revision that changes Site Data form collections to owner-only.
- Verify both
https://signals.forwardfuture.ai/loop-library/and the backing here.now Site before reporting success.