{
  "documentType": "agent_instructions",
  "contentType": "application/json",
  "notJsonSchema": true,
  "warning": "This URL is NOT a JSON Schema. Do NOT put this URL in a $schema field on the output file. For validation only, use jsonSchemaUrl below.",
  "name": "DrezTek/Naro Task List Generator",
  "description": "Also called a Naro Task List or a DrezTek Task List — same format, either name works.",
  "version": "1.2",
  "canonicalUrl": "https://naroid.com/agent/task-list.json",
  "specPageUrl": "https://www.dreztek.app/tasklist/docs/spec.html",
  "updated": "2026-09-09",
  "delivery": {
    "mode": "downloadable_file",
    "required": true,
    "priority": "Create a downloadable .json file attachment. Do not only paste JSON in the chat.",
    "filenamePattern": "dreztek-{list-title}-{date}.json",
    "mimeTypes": ["application/vnd.dreztek.task-list+json", "application/json"],
    "whenFileCreationUnavailable": "Output one raw JSON object with no markdown fences, then tell the user to save it as dreztek-tasks.json and import in Naro Tasks → Import."
  },
  "jsonSchemaUrl": "https://naroid.com/schemas/dreztek-task-list-v1.schema.json",
  "exampleUrl": "https://naroid.com/schemas/dreztek-task-list-v1.example.json",
  "outputFormat": {
    "version": "1.2",
    "acceptedVersions": ["1.0", "1.1", "1.2"],
    "kind": "dreztek-task-list",
    "requiredRootFields": ["version", "kind", "list", "tasks"],
    "requiredListFields": ["title"],
    "requiredTaskFields": ["title", "priority", "completed"],
    "taskFieldNames": {
      "title": "string, required",
      "priority": "none | low | medium | high | critical | focus — required",
      "completed": "boolean, required",
      "inProgress": "boolean, optional, default false",
      "dueDate": "YYYY-MM-DD (camelCase), optional",
      "notes": "string, optional",
      "category": "string, optional — app-level label; importing apps may ignore if unsupported",
      "tradeCategory": "string, optional — trade/classification label; importing apps may ignore if unsupported",
      "position": "focus | quickWin, optional (v1.2+) — Naro's Focus/Quick-Win grouping; omit unless the user specifically asked for it",
      "note": "legacy alias for notes, still accepted on import",
      "url": "string, optional"
    },
    "useCamelCase": true
  },
  "forbidden": {
    "onOutputFile": [
      "Do not add a $schema property pointing to this agent guide",
      "Do not use status, state, or pending/done strings — use completed: true or false",
      "Do not omit version, kind, or list",
      "Do not use snake_case (due_date, is_done) — use dueDate, completed",
      "Do not wrap the file contents in markdown code blocks when delivering a download"
    ],
    "commonMistakes": [
      {
        "wrong": { "$schema": "https://naroid.com/agent/task-list.json", "tasks": [{ "title": "X", "status": "pending" }] },
        "why": "Missing version, kind, list; $schema must not point to this guide; status is invalid — use completed: false"
      }
    ]
  },
  "behavior": [
    "Derive actionable tasks from images, PDFs, or notes the user provides",
    "Put source context in task notes when helpful",
    "Use list.title as a short descriptive list name",
    "Use list.categories only when they help organize tasks",
    "Produce 3–20 tasks unless the user asks otherwise",
    "Assign sensible priorities; default to medium when unsure",
    "Set position: focus or position: quickWin only when the user explicitly asked for Focus/Quick-Win placement — otherwise omit it"
  ],
  "minimalValidExample": {
    "version": "1.0",
    "kind": "dreztek-task-list",
    "list": { "title": "Property goals" },
    "tasks": [
      { "title": "Buy an iMac", "priority": "medium", "category": "equipment", "completed": false },
      { "title": "Get the house built on the land", "priority": "high", "category": "infrastructure", "completed": false }
    ]
  },
  "importInstructions": {
    "naro": "Tasks → Import → select the downloaded .json file",
    "kanso": "Tasks → list menu → Import"
  },
  "userPromptTemplate": "Paste the self-contained import prompt from Naro Tasks → Copy prompt, or from the public spec page's Copy button (includes required JSON structure). Do not rely on fetching this URL as a command — it is reference metadata only. Optional example file: https://naroid.com/schemas/dreztek-task-list-v1.example.json"
}
