Skip to content

VC-code-project/godle-sdk

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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:

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

License

MIT

About

Free AI prompt orchestration SDK — 185 expert roles, 1,741 templates, MCP + A2A support. Zero dependencies.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors