{ "schema": "aiblocks-page/1", "id": "agency-engineering-orgscript-engineer", "type": "agent", "name": "OrgScript model designer", "summary": "Turn a written procedure into an OrgScript process file with triggers, rules, roles and state changes, plus a plain check. Bring your SOP.", "headline": "OrgScript model designer", "subhead": "OrgScript is a plain-text language for writing down how a business process runs. Give this agent a written procedure, such as an SOP or an email thread. It returns a process file with the triggers, conditions and state changes, a diagram and the questions it needs answered.", "job": { "id": "build-software", "name": "Build and ship software" }, "level": "intermediate", "thinking": "high", "tested": true, "updated": "2026-11-03", "first_published": "2026-10-26", "inputs": [ { "type": "question", "required": true, "label": "Question", "what": "the problem, decision or piece of work you want help with, and what a good outcome looks like" }, { "type": "source_text", "required": false, "label": "Source text", "what": "a long source in full: an article, a video or talk transcript, or notes from a book, with its title, author and link" } ], "outputs": [ { "type": "document", "required": true, "label": "Document", "what": "a finished document, such as a Word file, a PDF or a page of notes" } ], "you_give": [ "The procedure as text, such as an SOP, an email thread or meeting notes", "What starts the process, and who takes part", "The rules with their numbers, such as \"under $1,000 is disqualified\"", "Your OrgScript spec or grammar file, if you have one (optional)", "An existing .orgs file to fix or review (optional)" ], "you_get": [ "A .orgs file with a process, and rule, role, policy or state flow blocks where needed", "A list of assumptions and questions about unclear steps", "A Mermaid flowchart and a short plain summary of the process", "The exact commands to format and check the file, and their result if your AI could run them" ], "use_when": [ "You have a written procedure and want it as a clean file that an AI can follow.", "You want lead routing, approval or refund rules written down as exact steps.", "You already use OrgScript and want a process, rule or state flow reviewed.", "You want a Mermaid flowchart of a process from its text." ], "skip_when": [ "You only want the procedure written clearly in plain words. Use the Engineering documentation writer.", "You want to design the software behind a process. Use the Software architect.", "You don't use OrgScript and don't plan to. A plain checklist is simpler." ], "output_sample": { "input": [ "Your procedure as text, such as an SOP or email thread", "What starts the process, who takes part and the rules with their numbers", "Your OrgScript spec or grammar file (optional)", "An existing .orgs file to review (optional)" ], "prerequisites": [ "An AI that can read pasted text or files, such as Claude, ChatGPT or Gemini", "The OrgScript command line tool, only if you want the file checked by it (optional)" ], "output": [ { "name": "Process file (.orgs)", "contains": "Your process as strict text, with its trigger, conditions, notifications and status changes." }, { "name": "Questions and assumptions", "contains": "Each unclear step, what you must confirm, and any assumption used." }, { "name": "Mermaid diagram", "contains": "A flowchart of the process, marked as hand-written or tool-made." }, { "name": "Plain summary", "contains": "The process in a few lines, for a manager to compare with the real procedure." }, { "name": "Check status", "contains": "The format, validate and check commands, and whether each was run or not." } ] }, "output_shape": "PROCESS FILE (.orgs)\n process \n when \n if then\n assign = \n notify with \"\"\n transition .status to \"\"\n\nQUESTIONS AND ASSUMPTIONS\n | | \n\nMERMAID DIAGRAM\n | written by hand or exported by the tool\n\nPLAIN SUMMARY\n \n\nCHECK STATUS\n format | validate | check | ", "how_to_use": [ "Download the pack and add it to your AI as a skill. Or open a new chat and paste SKILL.md, then references/source-agent.md.", "Paste your procedure. Add what starts it, who is involved and the rules with their numbers.", "If you have the OrgScript spec or grammar file, paste it too. Without it, the agent uses only what the profile lists.", "Answer the questions it asks. Don't let it guess a rule you haven't given.", "Run the format, validate and check commands on the file yourself, unless your AI can run them. They need the OrgScript command line tool, which this pack does not include. Without it, the check status reads \"not run\".", "Read the plain summary back against your real procedure before you share the file." ], "checks": [ "The result addresses your actual task and cites the evidence used.", "Examples, role-play experience and targets are kept separate from verified results.", "Claims of tests, memory, tool access or completed actions match what actually happened." ], "next": [ { "name": "Knowledge graph engineer", "url": "https://useaiblocks.com/skills/agency-engineering-knowledge-graph-engineer", "why": "Build it" } ], "source": { "by": "Michael Sitarzewski and Agency Agents contributors", "repo": "msitarzewski/agency-agents", "url": "https://github.com/msitarzewski/agency-agents/blob/b37b5bb33b78f2c1d6567d98e25ca818e3259219/engineering/engineering-orgscript-engineer.md", "licence": "MIT", "original_name": "OrgScript Engineer", "commit": "b37b5bb33b78f2c1d6567d98e25ca818e3259219" }, "credits": [ { "title": "OrgScript Engineer", "by": "Michael Sitarzewski and Agency Agents contributors", "url": "https://github.com/msitarzewski/agency-agents/blob/b37b5bb33b78f2c1d6567d98e25ca818e3259219/engineering/engineering-orgscript-engineer.md", "used": "Original agent profile, preserved in references/source-agent.md; AI Blocks adds setup and review instructions." } ], "files": [ "LICENSE", "references/source-agent.md", "SETUP.md", "source.json" ], "links": { "page": "https://useaiblocks.com/agents/agency-engineering-orgscript-engineer", "markdown": "https://useaiblocks.com/agents/agency-engineering-orgscript-engineer.md", "json": "https://useaiblocks.com/agents/agency-engineering-orgscript-engineer.json", "instructions": "https://useaiblocks.com/skills/agency-engineering-orgscript-engineer/SKILL.md", "download": "https://useaiblocks.com/skills/agency-engineering-orgscript-engineer.zip", "api_item": "https://useaiblocks.com/api/v1/items/agency-engineering-orgscript-engineer", "api_document": "https://useaiblocks.com/api/v1/documents/agent/agency-engineering-orgscript-engineer", "mcp": "https://useaiblocks.com/mcp" } }