Skip to content

ServiceNowDevProgram/ServiceNow-SDK-CC-Starter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 

Repository files navigation

ServiceNow SDK: Claude Code Starter

A template repository containing reusable Claude Code skills for ServiceNow SDK development. Pull these into any new project to get a ready-made AI-assisted workflow out of the box.

Usage

Copy the skills/ folder into your project. You can use this Claude Code prompt to do it:

Use gh repo clone and git sparse-checkout to pull only the skills/ folder from the private repo ServiceNowDevProgram/ServiceNow-SDK-CC-Starter into this project. Skip any files we already have in .claude/skills/. Do not copy READMEs.

Skills

Skills are slash-command workflows you invoke in Claude Code (e.g., /git-issues-start). They work together to form an issue-driven development cycle.

Issue Workflow

These skills form a pipeline: surface candidate issues, interview each one, work them, then wrap up.

(file issues manually) or /find-issues/issue-interview/git-issues-start/git-issues-end

Skill What it does
(manual) File issues directly on GitHub as single-sentence titles as things come up, or paste a bug-report message into Claude and ask it to convert each item into its own issue. This is the usual entry point (/find-issues below is only for surfacing unreported problems).
/find-issues (Optional) Launches 5 parallel audit agents (bugs, inconsistencies, incomplete work, performance, UI/a11y) to scan the codebase, dedupes their findings, and lets you pick which ones to file as GitHub issues. Use intermittently to surface things no one has reported yet.
/issue-interview Walks through a collaborative Q&A on a GitHub issue to flesh out requirements, writes a spec into the issue body, and labels it ready for implementation. Supports single-issue, auto (batch non-interactive), and chain (batch interactive) modes. Also checks the existing ready queue for overlapping scope.
/git-issues-start Fetches all ready-labeled issues (or specific issue numbers), analyzes them, builds a parallelized execution plan, and launches isolated worktree agents to implement each one. Gathers each agent's changes into the main working tree as uncommitted changes for your review.
/git-issues-end Surveys the uncommitted changes, picks a commit strategy (per-issue / grouped / single) based on file overlap, creates commits that reference their issues via Closes #N, pushes (with --follow-tags), comments on each issue, and cleans up agent worktrees.

Why this workflow works

The issue-driven structure reshapes how humans and agents split the work.

  • You orchestrate, agents implement. Your attention goes to triage, spec, and review. Agents do the keystrokes. Higher leverage per minute of your time than sitting in the loop for every line.
  • Intent is captured before code is touched. /issue-interview is a forcing function: the Q&A codifies the "why" and concrete acceptance criteria into the issue body before an agent runs. Implementing agents read a spec, not a vague request, so there are fewer wrong turns and less mid-work clarification.
  • The issue body becomes durable context. Research notes from Step 2.5, related-issue references from Step 2.6, acceptance criteria, and edge cases all live in the body. Comments are ephemeral; the body is what the implementing agent actually reads, and what future-you will grep six months later to trace a fix back to the decision that produced it.
  • You can keep many things in flight without losing any. The ready queue is your backlog. File issues as they occur to you (or paste in a bug report), interview them when you have time, and they sit ready until you're ready to execute, with no context lost between steps.
  • Overlap and conflicts are caught early. Step 2.6 checks every new interview against the ready queue before the spec is written. /git-issues-start detects file-level collisions across the whole batch and serializes the ones that would conflict. You can keep filing issues without them silently tripping over each other.
  • Parallel execution without collisions. Worktree isolation runs independent issues concurrently; overlapping ones are serialized automatically. A batch of 8 issues completes in the wall-time of the longest one, not the sum of all eight.
  • A real pre-commit review gate. All agent output lands in your working tree uncommitted. If something's off, you fix it with git checkout -- <file>, not git revert. /git-issues-end then commits, pushes, and auto-closes via Closes #N in one pass, so the safety net costs you nothing when everything's fine.
  • Batching beats one-at-a-time. Spec several issues, execute them as a batch, review once. Fewer context switches, cleaner mental model, more shipped per session than running issues end-to-end serially.
  • Full audit trail, for free. Audit finding (optional) → spec in the issue body → commit message referencing the issue → push with a deploy tag. Every shipped change is traceable from motivation to deployment: the kind of paper trail enterprise processes normally require you to build by hand.

Utility

Skill What it does
/deploy Builds and deploys to a ServiceNow instance. Accepts dev, uat, or prod (defaults to dev). Confirms before production, and creates an annotated git tag for UAT/prod deploys.
/push Stages all changes, commits, and pushes to remote with --follow-tags (carries deploy tags along).
/teams-issue-summary Generates a copy-paste-ready Microsoft Teams markdown table summarizing a range of GitHub issues (includes description, who requested it, and the result).

About

Claude Code starter commands and skills for ServiceNow SDK development

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors