{
  "schema": "cad-agent-catalog-area/1",
  "origin": "https://cad-agent.valpatel.com",
  "revision": "f766bf2694e3e66e1ac84c901be1091bdb9863da",
  "fields": {
    "level": "domain, area or bucket",
    "domain": "areas: the domain it belongs to",
    "priority": "demo (a good demo)",
    "projects": "areas: keys of the projects in docs/areas.yaml (areas_source) that used it",
    "issues": "GitHub issues for work in this area",
    "topics": "areas: its topics, with scope, maturity and issues",
    "areas": "domains: its areas",
    "count": "entries here",
    "kinds": "count per kind",
    "items": "every entry placed here (a domain holds its areas' entries): the fields of catalog.json without summary and related"
  },
  "item_fields": "https://cad-agent.valpatel.com/catalog.json (fields)",
  "slug": "agent-workflow",
  "title": "Agent process and workflow",
  "scope": "How agents work here, in parallel - issues, worktrees, reviews and long runs.",
  "maturity": "tooling",
  "level": "area",
  "domain": "practice",
  "priority": [],
  "projects": [],
  "issues": [
    "https://github.com/Valpatel/cad-agent/issues/111",
    "https://github.com/Valpatel/cad-agent/issues/112"
  ],
  "topics": [],
  "count": 13,
  "kinds": {
    "tool": 1,
    "project": 1,
    "guide": 1,
    "lesson": 4,
    "research": 1,
    "agent": 2,
    "skill": 3
  },
  "page": "https://cad-agent.valpatel.com/catalog?area=agent-workflow",
  "index": "https://cad-agent.valpatel.com/catalog/index.json",
  "items": [
    {
      "type": "tool",
      "status": "ours",
      "name": "cad-agent agents",
      "url": "https://cad-agent.valpatel.com/docs/toolkit",
      "how": "cad-agent agents --help",
      "license": "MIT",
      "markdown": "https://cad-agent.valpatel.com/docs/agent-workflow.md",
      "doc": "https://cad-agent.valpatel.com/docs/agent-workflow",
      "id": "tool-agents",
      "kind": "tool",
      "areas": [
        "agent-workflow"
      ],
      "maturity": "tooling",
      "what": "Install the agent workflow kit (skills and subagents) for Claude Code and Codex, or list what is installed (docs/agent-workflow.md)",
      "notes": null,
      "cover": "https://cad-agent.valpatel.com/catalog/covers/tool-agents.svg",
      "demo": null,
      "licence_family": "permissive",
      "updated": "2026-11-01"
    },
    {
      "type": "upstream",
      "status": "candidate",
      "name": "BackplaneWorks/Backplane",
      "url": "https://github.com/BackplaneWorks/Backplane",
      "policy": "may incorporate with attribution",
      "license": "MIT",
      "stars": 731,
      "last_push": "2026-10-25",
      "id": "project-backplaneworks-backplane",
      "kind": "project",
      "areas": [
        "circuit-boards",
        "agent-workflow"
      ],
      "maturity": "tooling",
      "what": "Agent workspace for hardware on a KiCad fork, with KiCad and FreeCAD viewers that show each agent step",
      "notes": "its installer is a script piped from the network into a shell, which runs whatever the server sends at that moment: read it first, or build from a pinned commit; ships a KiCad fork (GPL). Moved from i2cjak/Backplane to the BackplaneWorks organisation (GitHub redirects the old name to the same repository), seen 2026-11-01",
      "cover": "https://cad-agent.valpatel.com/catalog/covers/project-backplaneworks-backplane.svg",
      "demo": null,
      "licence_family": "permissive",
      "updated": "2026-10-25"
    },
    {
      "type": "doc",
      "status": "ours",
      "name": "Agent workflow: skills, subagents and work that survives a crash",
      "url": "https://cad-agent.valpatel.com/docs/agent-workflow",
      "license": "MIT",
      "markdown": "https://cad-agent.valpatel.com/docs/agent-workflow.md",
      "source": "https://github.com/Valpatel/cad-agent/blob/dev/docs/agent-workflow.md",
      "id": "guide-agent-workflow",
      "kind": "guide",
      "areas": [
        "agent-workflow"
      ],
      "maturity": "tooling",
      "what": "cad-agent projects are mostly built by AI agents (Claude Code, Codex) working with a person.",
      "notes": null,
      "cover": "https://cad-agent.valpatel.com/catalog/covers/guide-agent-workflow.svg",
      "demo": null,
      "licence_family": "permissive",
      "updated": "2026-11-01"
    },
    {
      "type": "lesson",
      "status": "ours",
      "name": "User intent and requirements",
      "url": "https://cad-agent.valpatel.com/lessons/process/user-intent-and-requirements",
      "license": "MIT",
      "markdown": "https://cad-agent.valpatel.com/lessons/process/user-intent-and-requirements.md",
      "source": "https://github.com/Valpatel/cad-agent/blob/dev/lessons/process/user-intent-and-requirements.md",
      "id": "lesson-process-user-intent-and-requirements",
      "kind": "lesson",
      "areas": [
        "agent-workflow"
      ],
      "maturity": "tooling",
      "what": "The requirements arrived in pieces, often as short mid-turn messages, and were refined by later corrections.",
      "notes": null,
      "cover": "https://cad-agent.valpatel.com/docs/img/gates/bench-section-interfaces.webp",
      "demo": "https://cad-agent.valpatel.com/lessons/process/user-intent-and-requirements#treat-doesnt-block-disassembly-as-a-hard-requirement",
      "licence_family": "permissive",
      "updated": "2026-10-31"
    },
    {
      "type": "lesson",
      "status": "ours",
      "name": "Lessons — process",
      "url": "https://cad-agent.valpatel.com/lessons/process/README",
      "license": "MIT",
      "markdown": "https://cad-agent.valpatel.com/lessons/process/README.md",
      "source": "https://github.com/Valpatel/cad-agent/blob/dev/lessons/process/README.md",
      "id": "lesson-process-index",
      "kind": "lesson",
      "areas": [
        "agent-workflow"
      ],
      "maturity": "tooling",
      "what": "How the agent works with its sources, the user and a long session.",
      "notes": null,
      "cover": "https://cad-agent.valpatel.com/catalog/covers/lesson-process-index.svg",
      "demo": null,
      "licence_family": "permissive",
      "updated": "2026-10-31"
    },
    {
      "type": "lesson",
      "status": "ours",
      "name": "Agent process",
      "url": "https://cad-agent.valpatel.com/lessons/process/agent-process",
      "license": "MIT",
      "markdown": "https://cad-agent.valpatel.com/lessons/process/agent-process.md",
      "source": "https://github.com/Valpatel/cad-agent/blob/dev/lessons/process/agent-process.md",
      "id": "lesson-process-agent-process",
      "kind": "lesson",
      "areas": [
        "agent-workflow"
      ],
      "maturity": "tooling",
      "what": "Fold mid-turn messages into the current work and report on each; Give short status during long work, and say what is stale; Ask before outward or irreversible actions; Check whether it already exists…",
      "notes": null,
      "cover": "https://cad-agent.valpatel.com/catalog/covers/lesson-process-agent-process.svg",
      "demo": null,
      "licence_family": "permissive",
      "updated": "2026-10-31"
    },
    {
      "type": "lesson",
      "status": "ours",
      "name": "Verify from source",
      "url": "https://cad-agent.valpatel.com/lessons/process/verify-from-source",
      "license": "MIT",
      "markdown": "https://cad-agent.valpatel.com/lessons/process/verify-from-source.md",
      "source": "https://github.com/Valpatel/cad-agent/blob/dev/lessons/process/verify-from-source.md",
      "id": "lesson-process-verify-from-source",
      "kind": "lesson",
      "areas": [
        "agent-workflow"
      ],
      "maturity": "tooling",
      "what": "Board facts that the design depends on (connector side, voltages, designators, threads, which button is which) must come from a primary source: the schematic, datasheet photos or the vendor's 3D…",
      "notes": null,
      "cover": "https://cad-agent.valpatel.com/catalog/covers/lesson-process-verify-from-source.svg",
      "demo": null,
      "licence_family": "permissive",
      "updated": "2026-10-31"
    },
    {
      "type": "research",
      "status": "ours",
      "name": "Agent toolkits for mechanical CAD, DFM/DFA and FEA: refresh since 2026-10-24 (checked 2026-10-31)",
      "url": "https://cad-agent.valpatel.com/research/agent-toolkits-2026-10",
      "license": "MIT",
      "markdown": "https://cad-agent.valpatel.com/research/agent-toolkits-2026-10.md",
      "source": "https://github.com/Valpatel/cad-agent/blob/dev/research/agent-toolkits-2026-10.md",
      "id": "research-agent-toolkits-2026-10",
      "kind": "research",
      "areas": [
        "agent-workflow"
      ],
      "maturity": "tooling",
      "what": "For Valpatel/cad-agent #96 (landscape refresh) and #94 (compliant-mechanism engineer).",
      "notes": null,
      "cover": "https://cad-agent.valpatel.com/catalog/covers/research-agent-toolkits-2026-10.svg",
      "demo": null,
      "licence_family": "permissive",
      "updated": "2026-11-01"
    },
    {
      "type": "agent",
      "status": "ours",
      "name": "cad-pr-reviewer",
      "url": "https://cad-agent.valpatel.com/agents/cad-pr-reviewer",
      "license": "MIT",
      "markdown": "https://cad-agent.valpatel.com/agents/cad-pr-reviewer.md",
      "source": "https://github.com/Valpatel/cad-agent/blob/dev/agents/cad-pr-reviewer.md",
      "id": "agent-cad-pr-reviewer",
      "kind": "agent",
      "areas": [
        "agent-workflow"
      ],
      "maturity": "tooling",
      "what": "Independent reviewer for a pull request in a cad-agent or CAD product repo (code, CAD geometry, simulation evidence, docs).",
      "notes": null,
      "cover": "https://cad-agent.valpatel.com/catalog/covers/agent-cad-pr-reviewer.svg",
      "demo": null,
      "licence_family": "permissive",
      "updated": "2026-10-31"
    },
    {
      "type": "agent",
      "status": "ours",
      "name": "cad-resume",
      "url": "https://cad-agent.valpatel.com/agents/cad-resume",
      "license": "MIT",
      "markdown": "https://cad-agent.valpatel.com/agents/cad-resume.md",
      "source": "https://github.com/Valpatel/cad-agent/blob/dev/agents/cad-resume.md",
      "id": "agent-cad-resume",
      "kind": "agent",
      "areas": [
        "agent-workflow"
      ],
      "maturity": "tooling",
      "what": "Rebuilds the state of interrupted work from GitHub and the local and remote checkouts after a session ended (tokens ran out, crash, new computer) and reports what is done, what is in flight and the…",
      "notes": null,
      "cover": "https://cad-agent.valpatel.com/catalog/covers/agent-cad-resume.svg",
      "demo": null,
      "licence_family": "permissive",
      "updated": "2026-10-31"
    },
    {
      "type": "skill",
      "status": "ours",
      "name": "cad-pr-review",
      "url": "https://cad-agent.valpatel.com/skills/cad-pr-review/SKILL",
      "license": "MIT",
      "markdown": "https://cad-agent.valpatel.com/skills/cad-pr-review/SKILL.md",
      "source": "https://github.com/Valpatel/cad-agent/blob/dev/skills/cad-pr-review/SKILL.md",
      "id": "skill-cad-pr-review",
      "kind": "skill",
      "areas": [
        "agent-workflow"
      ],
      "maturity": "tooling",
      "what": "Use when a pull request in a cad-agent or product repo is ready for review, or when asked to review one.",
      "notes": null,
      "cover": "https://cad-agent.valpatel.com/catalog/covers/skill-cad-pr-review.svg",
      "demo": null,
      "licence_family": "permissive",
      "updated": "2026-10-31"
    },
    {
      "type": "skill",
      "status": "ours",
      "name": "cad-remote-runs",
      "url": "https://cad-agent.valpatel.com/skills/cad-remote-runs/SKILL",
      "license": "MIT",
      "markdown": "https://cad-agent.valpatel.com/skills/cad-remote-runs/SKILL.md",
      "source": "https://github.com/Valpatel/cad-agent/blob/dev/skills/cad-remote-runs/SKILL.md",
      "id": "skill-cad-remote-runs",
      "kind": "skill",
      "areas": [
        "agent-workflow"
      ],
      "maturity": "tooling",
      "what": "Use before starting any CAD/FEA/CFD/topology run or full pipeline that takes more than a few minutes or several GB of memory.",
      "notes": null,
      "cover": "https://cad-agent.valpatel.com/catalog/covers/skill-cad-remote-runs.svg",
      "demo": null,
      "licence_family": "permissive",
      "updated": "2026-11-01"
    },
    {
      "type": "skill",
      "status": "ours",
      "name": "cad-work-tracking",
      "url": "https://cad-agent.valpatel.com/skills/cad-work-tracking/SKILL",
      "license": "MIT",
      "markdown": "https://cad-agent.valpatel.com/skills/cad-work-tracking/SKILL.md",
      "source": "https://github.com/Valpatel/cad-agent/blob/dev/skills/cad-work-tracking/SKILL.md",
      "id": "skill-cad-work-tracking",
      "kind": "skill",
      "areas": [
        "agent-workflow"
      ],
      "maturity": "tooling",
      "what": "Use at the start of any multi-step change in a cad-agent or product repo, and every ~30 minutes while working.",
      "notes": null,
      "cover": "https://cad-agent.valpatel.com/catalog/covers/skill-cad-work-tracking.svg",
      "demo": null,
      "licence_family": "permissive",
      "updated": "2026-10-31"
    }
  ]
}