GODLE SDK

Free AI prompt orchestration SDK with 185 expert roles, 1,741 prompt templates, and agent protocol support (MCP + A2A).

No API key required. Works in browser and Node.js. Zero dependencies.

What is GODLE?

GODLE is a free, open AI prompt library and orchestration standard. It provides structured, expert-level prompt templates for 185 professional roles across 24 categories — from software engineering and data science to marketing, finance, legal, HR, and more.

Every template includes input/output schemas, eval rubrics, and model routing hints. The SDK connects to a two-layer architecture:

• Layer 1 (free, no auth): Static JSON API with all roles, templates, workflows, and eval rubrics
• Layer 2 (API key): Stateful edge layer with sessions, task execution, streaming, and eval-driven retries

Quick start

Browser

<script src="https://godle.app/api/v3/godle-sdk.js"></script>
<script>
  // List all roles
  const roles = await GODLE.listRoles();
  console.log(roles); // 185 roles

  // Get a specific role with all templates
  const swe = await GODLE.getRole('software-engineering');
  console.log(swe.templates); // 10 prompt templates

  // Generate an expert prompt
  const prompt = await GODLE.generatePrompt('software-engineering', 'system_design', {
    input: 'Design a real-time notification system for 10M users'
  });
  console.log(prompt); // Full structured prompt ready for any LLM
</script>

Node.js

// Using the bundle
const GODLE = require('./sdk/godle-sdk.bundle.js');

// Or import individual modules
const { listRoles, getRole, generatePrompt } = require('./sdk/godle-sdk-core.js');

const roles = await listRoles();
const prompt = await generatePrompt('data-science', 'exploratory_data_analysis', {
  input: 'Analyze customer churn patterns in our SaaS product'
});

SDK modules

Module	What it does
godle-sdk-core.js	listRoles(), getRole(), generatePrompt(), evaluateOutput() — core read-only API
godle-sdk-adapters.js	LLM provider adapters for Anthropic and OpenAI with model routing
godle-sdk-workflows.js	DAG workflow execution with parallel steps, eval-driven retries, token budgets
godle-sdk-sessions.js	Persistent sessions with role-scoped memory and task history
godle-sdk-streaming.js	SSE streaming client with heartbeat monitoring and auto-reconnect
godle-sdk-mcp.js	MCP client and server — JSON-RPC 2.0 tool protocol
godle-sdk-a2a.js	Google A2A client and server — agent-to-agent task dispatch
godle-sdk.bundle.js	All 7 modules bundled as UMD (~128KB)

Available roles (185)

Roles span 24 professional categories:

Engineering & IT: Software Engineering, Frontend Development, Backend Development, DevOps & SRE, ML Engineering, Data Engineering, QA Engineering, Security Engineering, Cloud Architecture, Solutions Architecture, Technical Writing

Data & Analytics: Data Science, Business Intelligence, Data Analytics, Research Science

Product & Design: Product Management, UX Design, UI Design, Product Operations

Marketing: Content Marketing, Growth Marketing, SEO, Social Media, Brand Marketing, Email Marketing, Product Marketing

Sales: Enterprise Sales, Mid-Market Sales, SDR/BDR, Sales Operations, Account Management

Finance: FP&A, Accounting, Treasury, Tax, Audit, Investor Relations

HR & People: HR Business Partnering, Recruiting, L&D, Compensation & Benefits, DEI, People Analytics

Legal: Corporate Law, Compliance, Contract Management, Legal Operations, Privacy/Data Protection

Operations: Supply Chain, Procurement, Facilities, Business Operations

Strategy: Corporate Strategy, M&A, Management Consulting, Business Development

Customer: Customer Success, Customer Support, Community Management

...and more. See the full role list or call GODLE.listRoles().

API endpoints (free, no auth)

All Layer 1 endpoints return JSON with CORS enabled. No API key needed.

GET https://godle.app/api/v3/roles.json              # All 185 roles
GET https://godle.app/api/v3/roles/{slug}.json        # Full role + templates
GET https://godle.app/api/v3/categories.json          # 24 categories
GET https://godle.app/api/v3/workflows.json           # 12 multi-step workflows
GET https://godle.app/api/v3/evals.json               # 1,741 eval rubrics
GET https://godle.app/api/v3/team-packs.json          # 8 agent team compositions
GET https://godle.app/api/v3/capabilities.json        # Searchable capability index
GET https://godle.app/api/v3/index.json               # API manifest

MCP integration

GODLE exposes 4 MCP tools that any MCP-compatible AI agent can call:

{
  "tools": [
    "godle_list_roles",
    "godle_match_capability",
    "godle_execute_task",
    "godle_compose_workflow"
  ]
}

MCP manifest: https://godle.app/.well-known/mcp.json

// Use as MCP client
const client = GODLE.mcp.client('https://godle.app');
const tools = await client.listTools();
const result = await client.callTool('godle_list_roles', { categoryId: 'engineering-it' });

// Expose as MCP server
const server = GODLE.mcp.server();
server.addTool('generate_prompt', { /* schema */ }, async (params) => {
  return GODLE.generatePrompt(params.roleId, params.templateKey, params);
});

A2A integration

GODLE implements Google's Agent-to-Agent protocol for multi-agent orchestration:

A2A agent card: https://godle.app/.well-known/agent.json

// Send a task to GODLE via A2A
const client = GODLE.a2a.client('https://godle.app');
const task = await client.sendTask({
  skill: 'software-engineering',
  message: 'Design a microservices architecture for an e-commerce platform'
});

// Re-expose GODLE as your own A2A agent
const server = GODLE.a2a.server({ name: 'my-agent', skills: ['code-review'] });
const card = server.generateAgentCard();

Workflows

12 pre-built multi-step workflows with DAG execution:

Workflow	Steps	What it does
feature-development	6	PRD to code review pipeline
incident-response	5	Detect, triage, fix, postmortem
content-campaign	7	Strategy to distribution
hiring-pipeline	6	JD to offer letter
design-sprint	5	Research to prototype
data-pipeline-build	5	Schema to monitoring
compliance-audit	6	Scope to remediation
launch-checklist	8	Pre-launch to post-launch
sales-deal-cycle	7	Prospect to close
quarterly-planning	5	OKRs to review
onboarding-playbook	5	Pre-boarding to 90-day check
vendor-evaluation	6	Requirements to contract

const run = await GODLE.run('feature-development', {
  feature: 'Add real-time notifications',
  context: 'B2B SaaS, 50k users, React frontend, Node backend'
});

Team packs

8 pre-configured agent team compositions:

Pack	Roles	Use case
product-trio	PM, Designer, Engineer	Feature development
saas-mvp	6 roles	Ship an MVP
content-engine	4 roles	Content pipeline
growth-team	5 roles	Growth experimentation
data-team	4 roles	Data pipeline + analytics
enterprise-sales-team	4 roles	Enterprise deal cycle
incident-response-team	4 roles	Incident management
compliance-team	4 roles	Compliance audit

Examples

See the examples/ directory:

• examples/browser.html — Browser usage with CDN script tag
• examples/node.js — Node.js usage with require/import
• examples/mcp-client.js — MCP client integration

File structure

godle-sdk/
  sdk/                          # SDK source modules
    godle-sdk-core.js           # Core API (listRoles, getRole, generatePrompt)
    godle-sdk-adapters.js       # LLM provider adapters (Anthropic, OpenAI)
    godle-sdk-workflows.js      # DAG workflow execution engine
    godle-sdk-sessions.js       # Session management with memory
    godle-sdk-streaming.js      # SSE streaming client
    godle-sdk-mcp.js            # MCP client + server
    godle-sdk-a2a.js            # A2A client + server
    godle-sdk.bundle.js         # All-in-one UMD bundle (~128KB)
  docs/
    api-v3.md                   # API reference
    migration-v2-to-v3.md       # v2 to v3 migration guide
    SPEC-AGENTIC-LAYER.md       # Agentic architecture spec
  manifests/
    mcp.json                    # MCP tool manifest
    agent.json                  # A2A agent card
    ai-plugin.json              # ChatGPT plugin manifest
    openapi.json                # OpenAPI 3.1 spec
  examples/
    browser.html                # Browser quick start
    node.js                     # Node.js quick start
    mcp-client.js               # MCP integration example
  llms.txt                      # Compact LLM reference
  llms-full.txt                 # Extended reference with template examples
  LICENSE                       # MIT License
  package.json

Links

• Website: https://godle.app
• AI prompt generator: https://godle.app/app
• Jobs (all 185 roles): https://godle.app/jobs
• API docs: https://godle.app/api
• API playground: https://godle.app/app/playground
• Blog: https://godle.app/blog
• MCP manifest: https://godle.app/.well-known/mcp.json
• A2A agent card: https://godle.app/.well-known/agent.json
• OpenAPI spec: https://godle.app/api/v3/openapi.json

License

MIT