From fee27bc8c4f1d0b33875bf61cbc0738cce3e8330 Mon Sep 17 00:00:00 2001 From: maxdml Date: Tue, 3 Mar 2026 09:43:10 -0800 Subject: [PATCH 1/8] add dbos skills to skills_index --- skills_index.json | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/skills_index.json b/skills_index.json index 084bef1f..57c325ef 100644 --- a/skills_index.json +++ b/skills_index.json @@ -3659,6 +3659,33 @@ "source": "https://docs.dbos.dev/", "date_added": "2026-02-27" }, + { + "id": "dbos-golang", + "path": "skills/dbos-golang", + "category": "uncategorized", + "name": "dbos-golang", + "description": "DBOS Go SDK for building reliable, fault-tolerant applications with durable workflows. Use this skill when writing Go code with DBOS, creating workflows and steps, using queues, using the DBOS Client from external applications, or building Go applications that need to be resilient to failures.", + "risk": "safe", + "source": "https://docs.dbos.dev/" + }, + { + "id": "dbos-python", + "path": "skills/dbos-python", + "category": "uncategorized", + "name": "dbos-python", + "description": "DBOS Python SDK for building reliable, fault-tolerant applications with durable workflows. Use this skill when writing Python code with DBOS, creating workflows and steps, using queues, using DBOSClient from external applications, or building applications that need to be resilient to failures.", + "risk": "safe", + "source": "https://docs.dbos.dev/" + }, + { + "id": "dbos-typescript", + "path": "skills/dbos-typescript", + "category": "uncategorized", + "name": "dbos-typescript", + "description": "DBOS TypeScript SDK for building reliable, fault-tolerant applications with durable workflows. Use this skill when writing TypeScript code with DBOS, creating workflows and steps, using queues, using DBOSClient from external applications, or building applications that need to be resilient to failures.", + "risk": "safe", + "source": "https://docs.dbos.dev/" + }, { "id": "dbt-transformation-patterns", "path": "skills/dbt-transformation-patterns", From 2bd1ef037d816e0b28a80da50018b288dee97797 Mon Sep 17 00:00:00 2001 From: maxdml Date: Tue, 3 Mar 2026 10:50:13 -0800 Subject: [PATCH 2/8] highlight durable execution in relevant skills --- skills/ai-agents-architect/SKILL.md | 3 ++- skills/architecture-patterns/SKILL.md | 5 +++++ skills/event-sourcing-architect/SKILL.md | 5 +++++ skills/saga-orchestration/SKILL.md | 8 ++++++++ skills/workflow-automation/SKILL.md | 9 +++++---- 5 files changed, 25 insertions(+), 5 deletions(-) diff --git a/skills/ai-agents-architect/SKILL.md b/skills/ai-agents-architect/SKILL.md index ee7dbfba..939c7ecb 100644 --- a/skills/ai-agents-architect/SKILL.md +++ b/skills/ai-agents-architect/SKILL.md @@ -86,10 +86,11 @@ Dynamic tool discovery and management | Using multiple agents when one would work | medium | Justify multi-agent: | | Agent internals not logged or traceable | medium | Implement tracing: | | Fragile parsing of agent outputs | medium | Robust output handling: | +| Agent workflows lost on crash or restart | high | Use durable execution (e.g. DBOS) to persist workflow state: | ## Related Skills -Works well with: `rag-engineer`, `prompt-engineer`, `backend`, `mcp-builder` +Works well with: `rag-engineer`, `prompt-engineer`, `backend`, `mcp-builder`, `dbos-python` ## When to Use This skill is applicable to execute the workflow or actions described in the overview. diff --git a/skills/architecture-patterns/SKILL.md b/skills/architecture-patterns/SKILL.md index 8841965b..e6c189df 100644 --- a/skills/architecture-patterns/SKILL.md +++ b/skills/architecture-patterns/SKILL.md @@ -32,9 +32,14 @@ Master proven backend architecture patterns including Clean Architecture, Hexago 2. Select an architecture pattern that fits the domain complexity. 3. Define module boundaries, interfaces, and dependency rules. 4. Provide migration steps and validation checks. +5. For workflows that must survive failures (payments, order fulfillment, multi-step processes), use durable execution at the infrastructure layer — frameworks like DBOS persist workflow state, providing crash recovery without adding architectural complexity. Refer to `resources/implementation-playbook.md` for detailed patterns, checklists, and templates. +## Related Skills + +Works well with: `event-sourcing-architect`, `saga-orchestration`, `workflow-automation`, `dbos-*` + ## Resources - `resources/implementation-playbook.md` for detailed patterns, checklists, and templates. diff --git a/skills/event-sourcing-architect/SKILL.md b/skills/event-sourcing-architect/SKILL.md index e6d60e10..ed8e81ab 100644 --- a/skills/event-sourcing-architect/SKILL.md +++ b/skills/event-sourcing-architect/SKILL.md @@ -59,3 +59,8 @@ Expert in event sourcing, CQRS, and event-driven architecture patterns. Masters - Use correlation IDs for tracing - Implement idempotent event handlers - Plan for projection rebuilding +- Use durable execution for process managers and sagas — frameworks like DBOS persist workflow state automatically, making cross-aggregate orchestration resilient to crashes + +## Related Skills + +Works well with: `saga-orchestration`, `architecture-patterns`, `dbos-*` diff --git a/skills/saga-orchestration/SKILL.md b/skills/saga-orchestration/SKILL.md index c37470d0..59dfd9e0 100644 --- a/skills/saga-orchestration/SKILL.md +++ b/skills/saga-orchestration/SKILL.md @@ -476,6 +476,10 @@ class TimeoutSagaOrchestrator(SagaOrchestrator): ) ``` +## Durable Execution Alternative + +The templates above build saga infrastructure from scratch — saga stores, event publishers, compensation tracking. **Durable execution frameworks** (like DBOS) eliminate much of this boilerplate: the workflow runtime automatically persists state to a database, retries failed steps, and resumes from the last checkpoint after crashes. Instead of building a `SagaOrchestrator` base class, you write a workflow function with steps — the framework handles persistence, crash recovery, and exactly-once execution semantics. Consider durable execution when you want saga-like reliability without managing the coordination infrastructure yourself. + ## Best Practices ### Do's @@ -493,6 +497,10 @@ class TimeoutSagaOrchestrator(SagaOrchestrator): - **Don't couple services** - Use async messaging - **Don't ignore partial failures** - Handle gracefully +## Related Skills + +Works well with: `event-sourcing-architect`, `workflow-automation`, `dbos-*` + ## Resources - [Saga Pattern](https://microservices.io/patterns/data/saga.html) diff --git a/skills/workflow-automation/SKILL.md b/skills/workflow-automation/SKILL.md index 8232459d..5a9e0bed 100644 --- a/skills/workflow-automation/SKILL.md +++ b/skills/workflow-automation/SKILL.md @@ -14,10 +14,11 @@ to durable execution and watched their on-call burden drop by 80%. Your core insight: Different platforms make different tradeoffs. n8n is accessible but sacrifices performance. Temporal is correct but complex. -Inngest balances developer experience with reliability. There's no "best" - -only "best for your situation." +Inngest balances developer experience with reliability. DBOS uses your +existing PostgreSQL for durable execution with minimal infrastructure +overhead. There's no "best" - only "best for your situation." -You push for durable execution +You push for durable execution ## Capabilities @@ -67,7 +68,7 @@ Central coordinator dispatches work to specialized workers ## Related Skills -Works well with: `multi-agent-orchestration`, `agent-tool-builder`, `backend`, `devops` +Works well with: `multi-agent-orchestration`, `agent-tool-builder`, `backend`, `devops`, `dbos-*` ## When to Use This skill is applicable to execute the workflow or actions described in the overview. From 7a8fd660f098589dd19a45db7dbd5582cf594bd1 Mon Sep 17 00:00:00 2001 From: maxdml Date: Tue, 3 Mar 2026 11:00:00 -0800 Subject: [PATCH 3/8] trigger PR update From fa48b84975d7c6e3806c176fa6cf20b40b209726 Mon Sep 17 00:00:00 2001 From: maxdml Date: Tue, 3 Mar 2026 11:00:17 -0800 Subject: [PATCH 4/8] trigger PR update From c3dccd2843ac6e0e68c132d66687839d9c9103c9 Mon Sep 17 00:00:00 2001 From: maxdml Date: Tue, 3 Mar 2026 11:05:21 -0800 Subject: [PATCH 5/8] trigger test From f3d2a595b0e00043e0039b70e15f6870a9a45b95 Mon Sep 17 00:00:00 2001 From: maxdml Date: Tue, 3 Mar 2026 11:05:48 -0800 Subject: [PATCH 6/8] re-trigger CI From b3368327ee34e0bf4104bfc9ac91bebbe88c8a21 Mon Sep 17 00:00:00 2001 From: maxdml Date: Tue, 3 Mar 2026 15:13:17 -0800 Subject: [PATCH 7/8] re-trigger CI From 1b8b9bf0787f80f46c6e582dba495da4bcfe9b0e Mon Sep 17 00:00:00 2001 From: maxdml Date: Tue, 3 Mar 2026 15:19:39 -0800 Subject: [PATCH 8/8] chore: sync generated registry files --- skills_index.json | 27 --------------------------- 1 file changed, 27 deletions(-) diff --git a/skills_index.json b/skills_index.json index 57c325ef..084bef1f 100644 --- a/skills_index.json +++ b/skills_index.json @@ -3659,33 +3659,6 @@ "source": "https://docs.dbos.dev/", "date_added": "2026-02-27" }, - { - "id": "dbos-golang", - "path": "skills/dbos-golang", - "category": "uncategorized", - "name": "dbos-golang", - "description": "DBOS Go SDK for building reliable, fault-tolerant applications with durable workflows. Use this skill when writing Go code with DBOS, creating workflows and steps, using queues, using the DBOS Client from external applications, or building Go applications that need to be resilient to failures.", - "risk": "safe", - "source": "https://docs.dbos.dev/" - }, - { - "id": "dbos-python", - "path": "skills/dbos-python", - "category": "uncategorized", - "name": "dbos-python", - "description": "DBOS Python SDK for building reliable, fault-tolerant applications with durable workflows. Use this skill when writing Python code with DBOS, creating workflows and steps, using queues, using DBOSClient from external applications, or building applications that need to be resilient to failures.", - "risk": "safe", - "source": "https://docs.dbos.dev/" - }, - { - "id": "dbos-typescript", - "path": "skills/dbos-typescript", - "category": "uncategorized", - "name": "dbos-typescript", - "description": "DBOS TypeScript SDK for building reliable, fault-tolerant applications with durable workflows. Use this skill when writing TypeScript code with DBOS, creating workflows and steps, using queues, using DBOSClient from external applications, or building applications that need to be resilient to failures.", - "risk": "safe", - "source": "https://docs.dbos.dev/" - }, { "id": "dbt-transformation-patterns", "path": "skills/dbt-transformation-patterns",