Smith›Developers

AI Job Schema

A standard JSON format for describing AI rescue jobs. Generate a job.json with smith-check — then paste it into the import wizard to auto-fill your job brief in seconds.

Quick start

Run smith-check

Scan your project for issues and generate a job.json with your rescue score.

$ npx smith-check

Copy job.json

The CLI prints a shareable URL and outputs job.json to your current directory.

$ cat rescue-job.json

Import to wizard

Paste the JSON into the "Import from job.json" panel on the intake wizard.

Open import wizard

URL param pre-fill

Link directly to the wizard with query params — useful for platform integrations, error pages, and tool deep-links.

https://aismiths.cloud/import?from=smith-check&score=43&platform=bolt&problem_type=auth-rescue

Param	Effect
`from=smith-check`	Shows a banner with the scan context
`score=43`	Displays your smith-check score in the banner
`platform=bolt`	Auto-selects the source platform and advances to step 2
`problem_type=auth-rescue`	Pre-selects the rescue type and sets the job title
`symptoms=oauth-loop,session-not-persisting`	Pre-fills "What went wrong" with humanized symptom labels

Schema reference

The AI Job Schema is an open standard. All fields are optional except version and problem_type.

Field	Type	Description
`version`required	`string`	Schema version. Always "1".
`platform`	`string`	AI tool that generated the project: bolt, loveable, replit, base44, emergent, forge, hercules.
`problem_type`required	`string`	auth-rescue, payment-fix, security-audit, deploy-fix, bug-sweep, full-rescue, other.
`symptoms`	`string[]`	Machine-readable symptom slugs. Used to auto-fill what went wrong.
`stack`	`object \| string[]`	Tech stack. Can be an object with named fields (framework, auth, database, payments, hosting, language) or a flat array of technology strings.
`urgency`	`string`	hours (→ Emergency), days (→ Rush), weeks (→ Standard).
`budget_range`	`object`	{ min, max, currency }. Pre-fills the budget step.
`description`	`string`	Free-text description. Pre-fills the project description field.
`codebase`	`object`	{ url, access, deploy_url }. access: public, private-invite, zip-upload.
`context`	`object`	Metadata: generated_by, generated_at, smith_check_score, smith_check_report_url.

Example job.json

{
  "$schema": "https://schema.aismiths.cloud/job/v1.json",
  "version": "1",
  "platform": "bolt",
  "problem_type": "auth-rescue",
  "symptoms": [
    "oauth-loop",
    "session-not-persisting"
  ],
  "stack": {
    "framework": "next.js",
    "auth": "supabase",
    "database": "supabase-postgres",
    "language": "typescript"
  },
  "urgency": "hours",
  "budget_range": {
    "min": 300,
    "max": 800,
    "currency": "USD"
  },
  "description": "Auth broke after deploying — login redirects back to /login in a loop.",
  "context": {
    "generated_by": "smith-check",
    "generated_at": "2026-07-06T12:00:00Z",
    "smith_check_score": 43,
    "smith_check_report_url": "https://aismiths.cloud/rescue-check/abc123"
  }
}

Resources

ai-job-schema on GitHub

Full JSON Schema, validate.js CLI, examples

ai-job-schema on npm

npx ai-job-schema validate job.json

smith-check on GitHub

Scan your project → generate job.json automatically

rescue-report on GitHub

RESCUE.md spec — what every completed Smith job delivers

Ready to post your job?

Paste your job.json and the wizard fills in the details — no copy-paste of error messages needed.

Open import wizard