@metasession/workflows

Engineering workflows for AI coding assistants. Install curated workflows for Windsurf, Claude Code, Cursor, and VS Code + Copilot.

Quick Start

# Install all workflows
npx @metasession/workflows init

# Add a specific workflow
npx @metasession/workflows add code-review

# List available workflows
npx @metasession/workflows list

Supported IDEs

IDE	Directory	Slash Commands
Windsurf	.windsurf/workflows/	✅ Yes
Claude Code	.claude/commands/	✅ Yes
Cursor	.cursor/workflows/	❌ Rules-based
VS Code + Copilot	.github/workflows-copilot/	❌ Instructions-based

Commands

init

Initialize all workflows for your project:

npx @metasession/workflows init
npx @metasession/workflows init --ide windsurf

add

Add specific workflow(s):

# Add single workflow
npx @metasession/workflows add code-review

# Add multiple (interactive)
npx @metasession/workflows add

# Add all workflows
npx @metasession/workflows add --all

# Specify IDE
npx @metasession/workflows add code-review --ide cursor

list

List available workflows:

npx @metasession/workflows list
npx @metasession/workflows list --category "Development"
npx @metasession/workflows list --search "github"

remove

Remove a workflow:

npx @metasession/workflows remove code-review

info

Get details about a workflow:

npx @metasession/workflows info code-review

detect

Detect AI coding assistants in your project:

npx @metasession/workflows detect

Available Workflows

🎯 Ideation & Planning

• feature-request - Submit and validate feature requests
• technical-spike - Conduct time-boxed technical investigations
• architecture-decision - Create Architecture Decision Records (ADRs)

📋 PRD & Design

• create-prd - Create comprehensive Product Requirements Documents
• api-design - Design RESTful APIs with security and compliance

💻 Development

• create-github-issue - Create well-structured GitHub issues
• work-on-github-issue - Full workflow from issue to PR
• address-pull-request-comments - Address code review feedback
• code-review - Conduct thorough code reviews
• refactoring - Safely refactor code with proper testing

🧪 Testing

• write-unit-tests - Write comprehensive unit tests
• e2e-testing - Write end-to-end tests with Playwright

🚀 Deployment

• deploy-staging - Deploy to staging environment
• deploy-production - Deploy to production with approvals
• rollback - Execute emergency rollback procedures
• hotfix - Deploy emergency hotfixes

🔒 Compliance & Security

• security-review - Conduct OWASP-based security reviews
• gdpr-compliance - Ensure GDPR/NDPA compliance
• accessibility-audit - Conduct WCAG 2.1 AA accessibility audits

🛠️ Support & Operations

• bug-triage - Triage and prioritize bug reports
• incident-response - Respond to production incidents

📝 Documentation

• update-docs - Update documentation for code changes
• changelog - Generate and maintain changelog entries
• release-notes - Create user-friendly release notes

Usage in Your IDE

After installation, use workflows by typing the slash command:

Windsurf / Claude Code:

/code-review
/create-github-issue
/deploy-production

Cursor: Reference workflows in your prompts or add to .cursorrules.

VS Code + Copilot: Reference workflows in Copilot Chat or add to .github/copilot-instructions.md.

Programmatic Usage

import {
  getAllWorkflows,
  installWorkflow,
  detectIDEs,
} from '@metasession/workflows';

// List all workflows
const workflows = getAllWorkflows();

// Detect IDEs in a project
const detected = await detectIDEs('/path/to/project');

// Install a workflow
const result = await installWorkflow('/path/to/project', 'code-review', 'windsurf');

Contributing

1. Fork the repository
2. Add your workflow to workflows/
3. Update src/registry.ts
4. Submit a PR

License

MIT