System Architecture Skill for Claude Code and Cursor

## Skill Purpose
This skill helps teams design, review, and implement robust system architectures for projects using Claude Code and Cursor. It guides both high-level design decisions and practical implementation patterns, leveraging the Agent SDK.

## Features
- Decision tree for architecture choices (single call, workflow, agent)
- Best practices for tool orchestration in Claude Code
- Permission and safety model guidance
- Patterns for error recovery and session resumption
- Example integrations for Cursor (in-context editing, code review workflows)

## Usage
1. Add this skill to your `.claude/commands/` directory.
2. Use prompts such as:
- "Design an architecture for a Claude Code + Cursor project."
- "Provide permission and safety recommendations."
- "Set up error handling workflows for agent sessions."
- "How can I connect Claude Code with Cursor for collaborative editing?"

## Example Prompt
```markdown
Design a scalable system architecture for a web app using Claude Code, with integrated Cursor workflows. Include:
- Agent tier selection (API, SDK, full agent)
- Tool configuration (Read, Write, Bash, Glob, Grep)
- Permission modes (default, plan, acceptEdits, bypassPermissions)
- Resiliency (error handling, session resumes)
- Code review loops
- In-context edit triggers via Cursor
```

## References
- [Agent SDK design patterns](https://github.com/anthropics/skills/blob/main/skills/claude-api/python/agent-sdk/README.md)
- [Permission modes & workflow orchestration](https://github.com/anthropics/skills/blob/main/skills/claude-api/python/agent-sdk/patterns.md)
- [Code execution & Cursor integration](https://github.com/anthropics/skills/blob/main/skills/claude-api/python/claude-api/tool-use.md)

---

**Skill Structure Example (SKILL.md):**

```
title: System Architecture for Claude Code & Cursor
category: architecture
summary: Guide and patterns for robust system design using Claude Code and collaborative editing with Cursor.
requirements:
- Claude Agent SDK
- Cursor Editor
inputs:
- project goals
- team workflows
outputs:
- architecture proposal
- permissions table
- error handling workflow
- Cursor collaboration plan
```

You can expand this skill further with automation scripts, tailored prompts, and reference code snippets. See Agent SDK patterns for advanced orchestration.