Smith
Browse ExpertsBrowse JobsPost a JobGuidesPlatforms
Become a SmithSign In
Sign In

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

1
Run smith-check

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

$ npx smith-check
2
Copy job.json

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

$ cat rescue-job.json
3
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
ParamEffect
from=smith-checkShows a banner with the scan context
score=43Displays your smith-check score in the banner
platform=boltAuto-selects the source platform and advances to step 2
problem_type=auth-rescuePre-selects the rescue type and sets the job title
symptoms=oauth-loop,session-not-persistingPre-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.

FieldTypeDescription
versionrequiredstringSchema version. Always "1".
platformstringAI tool that generated the project: bolt, loveable, replit, base44, emergent, forge, hercules.
problem_typerequiredstringauth-rescue, payment-fix, security-audit, deploy-fix, bug-sweep, full-rescue, other.
symptomsstring[]Machine-readable symptom slugs. Used to auto-fill what went wrong.
stackobject | string[]Tech stack. Can be an object with named fields (framework, auth, database, payments, hosting, language) or a flat array of technology strings.
urgencystringhours (→ Emergency), days (→ Rush), weeks (→ Standard).
budget_rangeobject{ min, max, currency }. Pre-fills the budget step.
descriptionstringFree-text description. Pre-fills the project description field.
codebaseobject{ url, access, deploy_url }. access: public, private-invite, zip-upload.
contextobjectMetadata: 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