project-roles

Dev Agent Workflow

Agent-based development workflows for Laravel/Vue projects with Linear integration.

Plugins

🎭 project-roles

Role-based workflows for Laravel/Vue projects with Linear integration.

Features:

• 5 specialized roles (Tech Lead, Backend/Frontend/Fullstack Engineer, Agent Engineer)
• 3 Linear commands (start project, review project, work on issue)
• 5 generic skills (backend-developer, frontend-developer, laravel-data-writer, php-test-writer, linear-issue-writer)

📖 Full Documentation

📋 rules-boilerplate

Bootstrap .claude/rules/ structure with starter templates.

Features:

• /setup-rules command to create directory structure
• Backend, frontend, and data class convention templates
• Based on Laravel/Vue best practices
• Works seamlessly with project-roles plugin

📖 Full Documentation

Two-Tier Convention System

The plugin supports a two-tier convention system:

.claude/
├── rules/              # Techstack rules (can be a git submodule)
│   ├── backend/        # Generic Laravel/PHP patterns
│   └── frontend/       # Generic Vue/TypeScript patterns
└── project-rules/      # Project-specific rules (optional)
    ├── backend/        # This project's backend patterns
    └── frontend/       # This project's frontend patterns

• Techstack rules (.claude/rules/) - Generic patterns that can be shared across projects
• Project rules (.claude/project-rules/) - Patterns specific to this codebase (e.g., example tests, boilerplate)

Roles and skills automatically check for both, loading techstack rules first, then project-specific rules if they exist.

Installation

Quick Install (Both Plugins)

# Add marketplace
/plugin marketplace add https://github.com/RasmusGodske/dev-agent-workflow

# Install both plugins
/plugin install project-roles@RasmusGodske
/plugin install rules-boilerplate@RasmusGodske

# Restart Claude Code

Individual Installation

# Just project-roles
/plugin marketplace add https://github.com/RasmusGodske/dev-agent-workflow
/plugin install project-roles@RasmusGodske

# Just rules-boilerplate
/plugin marketplace add https://github.com/RasmusGodske/dev-agent-workflow
/plugin install rules-boilerplate@RasmusGodske

Quick Start

New Project Setup

# 1. Install plugins
/plugin marketplace add https://github.com/RasmusGodske/dev-agent-workflow
/plugin install project-roles@RasmusGodske
/plugin install rules-boilerplate@RasmusGodske

# Restart Claude Code

# 2. Bootstrap techstack rules
/setup-rules

# 3. Customize rules for your project
# Edit files in .claude/rules/

# 4. (Optional) Add project-specific rules
# Create .claude/project-rules/backend/README.md for project-specific patterns

# 5. Start working with roles
/roles/backend-engineer

Existing Project

# Install plugins
/plugin marketplace add https://github.com/RasmusGodske/dev-agent-workflow
/plugin install project-roles@RasmusGodske

# If you don't have .claude/rules/ yet:
/plugin install rules-boilerplate@RasmusGodske
/setup-rules

Workflow Example

# 1. Activate tech lead role
/roles/techlead

# 2. Start planning a feature
/linear/start-project

# 3. Switch to implementation role
/roles/backend-engineer

# 4. Work on an issue
/linear/work-on-issue PRO-123

# 5. Review project progress
/roles/techlead
/linear/review-project my-project

Team Setup (Auto-Install)

Add to your project's .claude/settings.json:

{
  "plugins": {
    "marketplaces": [
      {
        "source": "https://github.com/RasmusGodske/dev-agent-workflow"
      }
    ],
    "installed": [
      {
        "name": "project-roles",
        "marketplace": "RasmusGodske"
      },
      {
        "name": "rules-boilerplate",
        "marketplace": "RasmusGodske"
      }
    ]
  }
}

When team members trust the repository folder, plugins install automatically.

Requirements

• Claude Code v1.0.0 or higher
• Linear MCP server configured (for Linear commands)
• Laravel/Vue project (optional, but designed for it)

Documentation

• project-roles Documentation
• project-roles Quick Start
• project-roles Testing Guide
• rules-boilerplate Documentation

License

MIT License - See individual plugin LICENSE files

Author

RasmusGodske

• GitHub: @RasmusGodske

Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions

Changelog