claude-code-workflows  by shinpr

AI-powered development workflows for production code

Created 7 months ago
359 stars

Top 78.0% 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

1 day ago

Responsiveness

Inactive

Pull Requests (30d)
9
Issues (30d)
1
Star History
46 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.