> **WARNING**: Windsurf provider support is experimental and untested.
Deploys AIWG agents to Windsurf as aggregated AGENTS.md and workflows.
/plugin marketplace add jmagly/ai-writing-guide/plugin install sdlc@aiwgWARNING: Windsurf provider support is experimental and untested. Please report issues at: https://github.com/jmagly/ai-writing-guide/issues
AIWG agents can be deployed to Windsurf using the --provider windsurf flag.
Unlike Claude Code and Factory, Windsurf does NOT use separate agent files.
Instead, AIWG generates an aggregated AGENTS.md file that Windsurf reads natively,
plus a .windsurfrules file with orchestration context.
| Feature | Claude Code | Factory | Cursor | Windsurf |
|---|---|---|---|---|
| Agent location | .claude/agents/*.md | .factory/droids/*.md | .cursor/agents/*.json | AGENTS.md (aggregated) |
| Config file | CLAUDE.md | AGENTS.md | .cursorrules | .windsurfrules |
| Commands | .claude/commands/ | .factory/commands/ | Reference only | .windsurf/workflows/ |
| Format | YAML frontmatter | YAML frontmatter | JSON | Plain markdown |
| Skills | .claude/skills/ | Reference | Reference | Reference |
# Deploy SDLC agents to Windsurf
aiwg use sdlc --provider windsurf
# With commands (as workflows)
aiwg use sdlc --provider windsurf --deploy-commands
# Dry run to preview
aiwg use sdlc --provider windsurf --dry-run
# All frameworks
aiwg use all --provider windsurf
After deployment, your project will have:
project/
├── AGENTS.md # Aggregated agent definitions
├── .windsurfrules # Orchestration context + key agents
└── .windsurf/
└── workflows/ # Commands as workflows (if --deploy-commands)
├── flow-inception-to-elaboration.md
├── flow-security-review-cycle.md
└── ...
Windsurf reads AGENTS.md natively for directory-scoped instructions. AIWG generates this file with all agents in plain markdown format (no YAML frontmatter):
# AGENTS.md
> AIWG Agent Directory for Windsurf
## Table of Contents
- [architecture-designer](#architecture-designer)
- [requirements-analyst](#requirements-analyst)
...
---
### architecture-designer
> Designs scalable, maintainable system architectures
<capabilities>
- Read
- Write
- Bash
- Grep
</capabilities>
**Model**: opus
[Full agent instructions...]
---
Contains orchestration context with natural language commands and key agent summaries:
# AIWG Rules for Windsurf
<orchestration>
## AIWG SDLC Framework
**58 SDLC agents** | **100+ commands** | **49 skills**
### Natural Language Commands
- "transition to elaboration" | "move to elaboration"
- "run security review" | "validate security"
- "where are we" | "project status"
</orchestration>
<agents>
## Key Agents
### Executive Orchestrator
**Role**: Coordinate multi-agent workflows and phase transitions.
...
</agents>
<references>
- **All Agents**: @AGENTS.md
- **Templates**: @~/.local/share/ai-writing-guide/...
</references>
Commands are converted to Windsurf workflow format (plain markdown, no YAML):
# Flow: Inception to Elaboration
> Transition from Inception to Elaboration phase
## Instructions
[Workflow instructions...]
Note: Windsurf workflows have a 12,000 character limit per file.
Since agents are in AGENTS.md, invoke them via natural language:
"Use the architecture-designer instructions to create a SAD"
"Apply the security-architect guidelines to review this code"
"Follow the test-architect approach to design the test strategy"
Or reference the file directly:
"Read @AGENTS.md and use the requirements-analyst section"
AIWG commands deployed as Windsurf workflows can be invoked with:
/flow-inception-to-elaboration
/project-status
/security-gate
Windsurf uses Claude models via API. The default model mappings are:
| Role | Model |
|---|---|
| Reasoning | claude-opus-4-1-20250805 |
| Coding | claude-sonnet-4-5-20250929 |
| Efficiency | claude-haiku-3-5 |
Override with CLI flags:
aiwg use sdlc --provider windsurf \
--reasoning-model claude-opus-4-1-20250805 \
--coding-model claude-sonnet-4-5-20250929 \
--efficiency-model claude-haiku-3-5
Skills are not directly deployed to Windsurf. Instead, reference skill files in prompts:
"Follow @~/.local/share/ai-writing-guide/agentic/code/addons/aiwg-utils/skills/workspace-health/SKILL.md"
"Apply the voice profile at @~/.local/share/ai-writing-guide/agentic/code/addons/voice-framework/voices/templates/technical-authority.yaml"
While Cursor and Windsurf are both VS Code-based AI IDEs, they have different configuration approaches:
| Aspect | Cursor | Windsurf |
|---|---|---|
| Config file | .cursorrules | .windsurfrules |
| Agent files | .cursor/agents/*.json | None (inline in AGENTS.md) |
| Rules dir | .cursor/rules/ | .windsurf/rules/ |
| AGENTS.md | Not native | Native support |
| Workflows | Not supported | .windsurf/workflows/ |
| Hooks | Not supported | Cascade Hooks (TypeScript) |
For Windsurf-specific questions:
For AIWG integration questions:
You are an elite AI agent architect specializing in crafting high-performance agent configurations. Your expertise lies in translating user requirements into precisely-tuned agent specifications that maximize effectiveness and reliability.