claude-code-workflows  by shinpr

AI-powered development workflows for production code

Created 5 months ago
275 stars

Top 94.1% on SourcePulse

GitHubView on GitHub
Project Summary

This repository provides production-ready, end-to-end development workflows for Claude Code, leveraging specialized AI agents to automate stages from requirements gathering to quality checks. It targets developers using Claude Code who seek structured, AI-assisted development processes, aiming to deliver reviewable code rather than just generated snippets, thereby streamlining development and enhancing code quality.

How It Works

The core approach employs a suite of specialized AI agents, each responsible for distinct phases of the software development lifecycle. A requirement-analyzer determines task complexity, guiding the workflow towards agents like prd-creator or technical-designer for planning and documentation. Implementation is handled by task-executor agents, with quality-fixer agents automatically addressing issues like test failures and type errors. The system emphasizes generating reviewable code through automated testing, design verification, and a phased execution model that prioritizes vertical slices for integration.

Quick Start & Requirements

  1. Start Claude Code: claude
  2. Add the marketplace: /plugin marketplace add shinpr/claude-code-workflows
  3. Install the desired plugin:
    • Backend/General: /plugin install dev-workflows@claude-code-workflows
    • Frontend (React/TypeScript): /plugin install dev-workflows-frontend@claude-code-workflows
    • Both for Full-Stack: Install both plugins.
  4. Reload plugins: /reload-plugins
  5. Begin development using recipes like /recipe-implement (backend) or /recipe-front-design (frontend).

Prerequisites include the Claude Code environment. Optional add-on plugins like claude-code-discover, metronome, and dev-workflows-governance can enhance core functionality.

Highlighted Details

  • Specialized Agents: Dedicated agents manage requirements analysis, PRD creation, technical design, implementation, quality fixing, code review, and problem diagnosis.
  • Workflow Recipes: A comprehensive set of commands (/recipe-*) streamline common development tasks, including feature implementation, design documentation, planning, building from plans, code review, problem diagnosis, and reverse engineering.
  • Full-Stack Support: Integrated workflows (/recipe-fullstack-implement, /recipe-fullstack-build) manage cross-layer features, generating separate design documents per layer (backend/frontend) and ensuring consistency via design-sync.
  • Reverse Engineering: Includes a workflow (/recipe-reverse-engineer) to automatically generate PRDs and Design Docs from existing codebases, aiding in understanding legacy systems.
  • UI Specification: For frontend development, generates detailed UI Specifications capturing component states and interactions, bridging gaps often missed by visual prototypes.

Maintenance & Community

The project is built and maintained by @shinpr. No specific details regarding community channels (e.g., Discord/Slack), sponsorships, or a public roadmap are provided in the README.

Licensing & Compatibility

The project is released under the MIT License, permitting free use, modification, and distribution. It is compatible with commercial use and closed-source linking as per standard MIT license terms.

Limitations & Caveats

The effectiveness of skills within Claude Code is subject to context window limitations; exceeding these limits can cause skills to be silently ignored. Installing the dev-skills plugin alongside dev-workflows or dev-workflows-frontend is discouraged due to potential skill duplication and context window issues. The workflows are dependent on the Claude Code environment.

Health Check
Last Commit

15 hours ago

Responsiveness

Inactive

Pull Requests (30d)
31
Issues (30d)
3
Star History
109 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.