Cursor rule

1---
2description: "Shared patterns for MCP integrations, references, and templates in Compozy"
3globs:
4  - "**/compozy.yaml"
5  - "**/workflow.yaml"
6  - "**/workflows/*.yaml"
7  - "**/agents/*.yaml"
8  - "**/tools/*.yaml"
9alwaysApply: false
10---
11# Compozy Shared Patterns
12 
13<configuration_overview type="shared_patterns">
14Shared patterns include MCP integrations, reference syntax, and template expressions used across all Compozy configuration files.
15</configuration_overview>
16 
17## MCP Integration Patterns
18 
19<mcp_patterns type="filesystem_mcp">
20```yaml
21mcps:
22  - id: file_server
23    transport: stdio
24    command: npx
25    args:
26      - -y
27      - "@modelcontextprotocol/server-filesystem"
28      - "./"
29    proto: "2025-03-26"
30    start_timeout: 15s
31```
32</mcp_patterns>
33 
34<mcp_patterns type="http_mcp">
35```yaml
36mcps:
37  - id: search-mcp
38    url: http://localhost:3000
39    transport: sse
40    env:
41      API_KEY: "{{ .env.SEARCH_API_KEY }}"
42```
43</mcp_patterns>
44 
45## Reference Patterns
46 
47<reference_patterns type="local_references">
48```yaml
49# Local references within the same file
50$ref: local::schemas.#(id=="city_input")
51$ref: local::tools.#(id=="weather_tool")
52$ref: local::agents.#(id=="tourist_guide")
53$ref: local::tasks.#(id=="save_results")
54 
55# Global references to project-level resources
56$ref: global::models.#(provider=="groq")
57 
58# Resource references to external files
59$ref: resource::agent::#(id=='file_reader')
60```
61</reference_patterns>
62 
63<reference_patterns type="use_patterns">
64```yaml
65# Using tools
66$use: tool(local::tools.#(id=="weather_tool"))
67 
68# Using agents
69$use: agent(local::agents.#(id=="tourist_guide"))
70$use: agent(resource::agent::#(id=='file_reader'))
71```
72</reference_patterns>
73 
74## Template Expression Patterns
75 
76<template_patterns type="common_expressions">
77```yaml
78# Workflow input access
79"{{ .workflow.input.city }}"
80 
81# Task output access
82"{{ .tasks.weather.output.temperature }}"
83"{{ .tasks.activities.output | toJson }}"
84 
85# Collection item access
86"{{ .item }}"
87"{{ .index }}"
88 
89# Conditional expressions
90'{{ .tasks.clothing.output.clothing | empty | ternary "no_clothes" "has_clothes" }}'
91 
92# Current timestamp
93"{{ now }}"
94 
95# Array length
96"{{ len .output }}"
97```
98</template_patterns>
99