AGENTS.md

1# dbos-python
2 
3> **Note:** `CLAUDE.md` is a symlink to this file.
4 
5## Overview
6 
7DBOS 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.
8 
9## Structure
10 
11```
12dbos-python/
13  SKILL.md       # Main skill file - read this first
14  AGENTS.md      # This navigation guide
15  CLAUDE.md      # Symlink to AGENTS.md
16  references/    # Detailed reference files
17```
18 
19## Usage
20 
211. Read `SKILL.md` for the main skill instructions
222. Browse `references/` for detailed documentation on specific topics
233. Reference files are loaded on-demand - read only what you need
24 
25## Reference Categories
26 
27| Priority | Category | Impact | Prefix |
28|----------|----------|--------|--------|
29| 1 | Lifecycle | CRITICAL | `lifecycle-` |
30| 2 | Workflow | CRITICAL | `workflow-` |
31| 3 | Step | HIGH | `step-` |
32| 4 | Queue | HIGH | `queue-` |
33| 5 | Communication | MEDIUM | `comm-` |
34| 6 | Pattern | MEDIUM | `pattern-` |
35| 7 | Testing | LOW-MEDIUM | `test-` |
36| 8 | Client | MEDIUM | `client-` |
37| 9 | Advanced | LOW | `advanced-` |
38 
39Reference files are named `{prefix}-{topic}.md` (e.g., `query-missing-indexes.md`).
40 
41## Available References
42 
43**Advanced** (`advanced-`):
44- `references/advanced-async.md`
45- `references/advanced-patching.md`
46- `references/advanced-versioning.md`
47 
48**Client** (`client-`):
49- `references/client-enqueue.md`
50- `references/client-setup.md`
51 
52**Communication** (`comm-`):
53- `references/comm-events.md`
54- `references/comm-messages.md`
55- `references/comm-streaming.md`
56 
57**Lifecycle** (`lifecycle-`):
58- `references/lifecycle-config.md`
59- `references/lifecycle-fastapi.md`
60 
61**Pattern** (`pattern-`):
62- `references/pattern-classes.md`
63- `references/pattern-debouncing.md`
64- `references/pattern-idempotency.md`
65- `references/pattern-scheduled.md`
66- `references/pattern-sleep.md`
67 
68**Queue** (`queue-`):
69- `references/queue-basics.md`
70- `references/queue-concurrency.md`
71- `references/queue-deduplication.md`
72- `references/queue-listening.md`
73- `references/queue-partitioning.md`
74- `references/queue-priority.md`
75- `references/queue-rate-limiting.md`
76 
77**Step** (`step-`):
78- `references/step-basics.md`
79- `references/step-retries.md`
80- `references/step-transactions.md`
81 
82**Testing** (`test-`):
83- `references/test-fixtures.md`
84 
85**Workflow** (`workflow-`):
86- `references/workflow-background.md`
87- `references/workflow-constraints.md`
88- `references/workflow-control.md`
89- `references/workflow-determinism.md`
90- `references/workflow-introspection.md`
91- `references/workflow-timeout.md`
92 
93---
94 
95*32 reference files across 9 categories*