AGENTS.md
Neezon.com is a Mintlify site (docs.json, theme linden). This repo is the site only. There is no app server here.
Map
- Smarty Discounts docs:
docs/smarty-discounts/. What’s new:docs/smarty-discounts/whats-new.md. - App page:
apps/smarty-discounts.mdx. Other pages:index.mdx,contact.mdx,privacy-policy.mdx. - Snippet:
snippets/contact-form.jsx. - Images and logos:
images/(Smarty shots inimages/smarty/),logo/,favicon.svg. - Root CSS and JS:
style.css,playful-geometric.css,nav-home.js,footer-attribution.js,software-application-jsonld.js. The live site serves these as Mintlify custom CSS and JS.docs.jsondoes not list them. - Nav, theme, and SEO:
docs.json.
Build, test, lint
Nopackage.json, npm scripts, test suite, or GitHub Actions workflow.
- Build and content checks:
npx --yes mint validate - Internal links and anchors:
npx --yes mint broken-links --check-anchors - Local preview only:
npx --yes mint dev
mint validate exits 1 on main for one existing error: it parses .devcontainer/devcontainer.json as OpenAPI and rejects the comments. npx --yes mint validate --disable openapi exits 0 and still notes that disabled-rule failure. mint broken-links warns on that file and exits 0 when links are fine.
Deploys
The only GitHub check is the Mintlify app, named Mintlify Deployment. There is no workflow file in the repo. A push tomain runs that check. On current main (87337b0) it succeeded: “Your changes are now live at https://neezon.com!” The log validates docs.json, updates the changed pages, builds a snapshot, and marks the build live.
On pull requests the same check is skipped: “No eligible deployments found for changes” and “No changes to preview.”
GitHub has an environment named staging (created 2026-04-05, no protection rules). No file in this repo references it.
Agent rules
- Edit, commit, push, and open pull requests. Never merge. Never deploy, including
mint deploy. - Minimal root-cause fixes. Do not add helpers or files the task does not need.
- A merge to
mainis what publishes the site. Leave that to a person.