sndev.io / docs

Why sn

Built for consulting firms moving from time-and-materials to fixed-price delivery.

ServiceNow consulting firms are watching two things change at the same time. AI is doing more of the mechanical build work — writing business rules, generating ATF tests, scaffolding flows — and clients who see that are pushing harder for fixed-price and outcome-based engagements instead of time-and-materials. The firms that come out ahead of this shift need three things their current tooling doesn’t give them: they need to deliver faster, they need to deliver predictably enough to quote fixed prices without bleeding margin, and they need to let junior-heavy teams ship without a partner reviewing every change.

sn is built for that shape of work.

The three ways consulting firms build on ServiceNow today

Clicking through the UI

Studio, UI Builder, form layouts, Flow Designer, manual update sets. It works, it’s what juniors learn first, and it’s where most delivery hours still go. It also produces nothing reusable between clients, nothing testable without someone separately writing ATF, and nothing reviewable before it lands on the instance. Under T&M, that was tolerable. Under fixed price, it’s where the margin goes to die.

The official Fluent SDK @servicenow/sdk

A real TypeScript DSL from ServiceNow that compiles to XML update sets. The right direction — typed, source-controlled, PR-reviewable — but coverage is partial, it doesn’t manage the update-set lifecycle on the target instance, and it has no first-class story for idempotent re-runs, test execution, or backout when a deploy fails mid-way.

Letting AI guess the API

Ask Claude or ChatGPT for a runScript, paste the answer. Fast the first time, painful the fifth. The model hallucinates field names, creates duplicate records on re-run, and has no way to verify the artifact actually landed correctly on the instance. AI without guardrails does not become cheaper at scale — it becomes a cleanup cost.

What sn does instead

sn is a single binary CLI that sits between your team (and the AI assistants they use) and the target ServiceNow instance. Four things are structural, not add-ons:

  • Idempotent execute. Every operation upserts against a stable key. A manifest that fails at step 12 of 15 is re-runnable, not a cleanup job.

  • Update-set lifecycle + backout. sn opens, activates, and tracks its own update sets. When something needs to come out, sn backout <sys_id> is a command, not a war story.

  • Execute → validate → test as first-class commands. Structural validation, update-set validation, ATF suites, instance scans, and catalog lifecycle checks all run from the same manifest.

  • AI-native by design. sn ops exposes every skill, operation, and input schema to the AI as a queryable surface. Installing sn drops a scoped .claude/sn-skills.md file so Claude works against a fixed API, not by guessing at the whole platform.

The net: AI can do most of the work, and sn is what keeps it honest enough to put on a fixed-price statement of work.

Is this right for you?

Who this is for

Firms where the same senior architect can’t personally review every manifest. Firms where juniors ship directly to client instances and the review model has to be automated, not manual. Firms bidding fixed-price engagements and needing delivery confidence to make the numbers work. Firms that want the same build logic to move between client engagements instead of being rebuilt every time.

Who this isn’t for

Solo admins on a single instance who aren’t billing other people for their work. Teams with zero TypeScript tolerance. Work that lives entirely in visual designers — Flow Designer canvas, UI Builder preview — where the point is the visual feedback loop. sn complements those surfaces rather than replacing them.

ServiceNow® and @servicenow/sdk are trademarks of ServiceNow, Inc. sn is an independent project and is not affiliated with, endorsed by, or sponsored by ServiceNow, Inc. All product names, logos, and brands are property of their respective owners.