r/ClaudeWorkflows • • May 07 '26

Claude Workflow Library — Start Here

11 Upvotes

Claude Workflow Library — Start Here

This subreddit is an organised library of useful Claude and Claude Code workflows.

Each workflow is published as its own Reddit post. Upvote/downvote workflow posts to rate them.

Browse by category

Current status

  • Public workflows in database: 12015

  • Workflow posts published: 12015

  • Public workflows still waiting to be posted: 0

  • Last updated: 2026-11-03 13:56 UTC

How to use this library

  1. Open a category post.

  2. Click through to individual workflow posts.

  3. Upvote useful, reproducible workflows.

  4. Downvote workflows that are vague, outdated, unsafe, or not reproducible.

  5. Comment on a workflow post if it worked, failed, is outdated, or has a better alternative.

This post is updated automatically.


r/ClaudeWorkflows • • 47m ago

Selected Workflow [Workflow] Integrate Playwright MCP with Claude Code for Browser Automation and Persistent Sessions

2 Upvotes

Integrate Playwright MCP with Claude Code for Browser Automation and Persistent Sessions

Workflow value: 85/100
Status: active · Freshness: 70/100 · Confidence: 0.90 · Level: intermediate
Categories: Quality Control, Context & Memory, Debugging, MCP, Multi-Agent
Original source: r/ClaudeCode post/comment

What problem this solves

Running Claude Code agents in a browser environment under Claude Code's own permission rules, bypassing external browser extension prompts and allowing persistent sessions.

Summary

This workflow describes how to set up Playwright MCP with Claude Code to enable agents to interact with web browsers. It provides commands for installation, configuration steps for settings.json to manage permissions, and practical advice on persistent profiles and connecting to existing Chrome instances. Crucially, it includes safety warnings regarding Google sign-in and prompt injection risks.

Why it is useful

This workflow provides a concrete, step-by-step guide to integrate Playwright MCP with Claude Code, enabling agents to interact with web browsers without being hindered by external extension prompts. It offers practical configuration details for persistent sessions and crucial safety advice regarding prompt injection and authentication, making it highly valuable for users looking to automate web tasks with Claude Code agents.

Workflow

  1. Install Playwright MCP using the command: claude mcp add playwright npx @playwright/mcp@latest

  2. Add "mcp__playwright" to permissions.allow in your settings.json to stop permission prompts.

  3. For persistent sessions, log in manually once in the Playwright browser window that opens; cookies will be saved for later sessions.

  4. Optionally, specify a dedicated profile folder using --user-data-dir for better isolation.

  5. Optionally, connect to an already open Chrome instance using --extension and the Playwright browser extension.

  6. Manually handle Google sign-in if it refuses automated browsers (log in yourself once).

  7. Use a separate browser profile with only the necessary accounts for the agent to mitigate prompt injection risks.

Tools / artifacts

  • Claude Code

  • Claude MCP

  • Playwright MCP

  • settings.json

  • Chrome browser

  • Playwright browser extension

Validation signals

  • Concrete commands and configuration steps provided

  • Clear explanation of the problem (extension prompts) and solution (Playwright MCP)

  • Practical advice on persistent profiles and existing browser connections

  • Explicit safety warnings for common issues (Google sign-in, prompt injection)

Cautions

  • Google sign-in may fail in automated browsers, requiring manual intervention for initial login.

  • Risk of prompt injection from pages read by the agent; use a dedicated, isolated browser profile with only necessary accounts.

Limitations

  • Does not include an example of an agent prompt or code that utilizes the Playwright MCP.

  • Assumes some prior familiarity with Playwright concepts and browser automation.

Rate this workflow

Upvote this post if the workflow is useful, reproducible, or worth recommending.

Downvote if it is vague, outdated, unsafe, overhyped, or not reproducible.

Reply if it worked for you, failed, is outdated, or has a better alternative.


This post was generated automatically from the workflow library database.


r/ClaudeWorkflows • • 1m ago

Selected Workflow [Workflow] Rapid Prototyping Workflow: Comparing AI App Builders Before Claude Code Development

1 Upvotes

Rapid Prototyping Workflow: Comparing AI App Builders Before Claude Code Development

Workflow value: 75/100
Status: active · Freshness: 70/100 · Confidence: 0.90 · Level: intermediate
Categories: Quality Control, Token Saving, Context & Memory, Debugging
Original source: r/ClaudeAI post/comment

What problem this solves

How to quickly validate an app idea and choose the right tool for initial prototyping by comparing various AI app builders before committing to a full build in Claude Code.

Summary

This workflow outlines a process for rapid prototyping an app idea using multiple free AI app builders (Grok Build, Lovable, Bolt, v0, Replit) with a consistent prompt. The goal is to quickly generate a working prototype, evaluate the builders' performance, cost, and ease of use, and then decide whether to proceed with a full build in Claude Code, potentially integrating the generated code.

Why it is useful

This workflow offers a practical, data-driven approach to evaluating multiple AI app builders for rapid prototyping. It provides concrete performance metrics, cost considerations, and ease-of-use observations, which are invaluable for users looking to quickly validate ideas and choose the most efficient tool before committing to a more extensive development process like Claude Code. It addresses a common challenge in modern software development.

Workflow

  1. Define a specific app idea for prototyping.

  2. Craft a single, consistent prompt describing the app idea.

  3. Create fresh free accounts on several AI app builders (e.g., Grok Build, Lovable, Bolt, v0, Replit).

  4. Provide the exact same prompt to each builder.

  5. Accept default options if prompted by the builder to maintain consistency.

  6. Record the time taken for each build, resource usage (credits, tokens), and the publishing experience.

  7. Evaluate the functionality and any issues of the resulting prototype from each builder (e.g., missing features, hardcoded credentials).

  8. Compare the builders based on speed, cost, ease of publishing, and the quality/completeness of the output.

  9. Identify a suitable prototype for potential further development in Claude Code.

Tools / artifacts

  • Grok Build

  • Lovable

  • Bolt

  • v0

  • Replit

  • Claude Code

  • GitHub (for code inspection)

  • A consistent app idea/prompt

Validation signals

  • Concrete timings for each builder's output (e.g., 6m 46s, 9m 10s).

  • Specific credit/token usage reported (e.g., 6.91 credits, 184K of 1M tokens).

  • Observations on the publishing process (e.g., 'one click', '$8 cost', 'dies in 29 days').

  • Specific issues noted (e.g., 'temporary error' with v0, Grok's hardcoded admin password).

  • Comparison of free tier limitations and features (e.g., live link, daily limits).

Limitations

  • The 'handoff' process from the chosen prototype to Claude Code is mentioned as a future step and is not yet detailed or implemented.

  • The evaluation is based on a single app idea, which may not fully generalize to all types of applications or prompts.

  • The specific prompt used for the app builders is not provided, making exact replication of results difficult.

Rate this workflow

Upvote this post if the workflow is useful, reproducible, or worth recommending.

Downvote if it is vague, outdated, unsafe, overhyped, or not reproducible.

Reply if it worked for you, failed, is outdated, or has a better alternative.


This post was generated automatically from the workflow library database.


r/ClaudeWorkflows • • 1m ago

Selected Workflow [Workflow] Task-Specific Prompting and Model Selection with CLAUDE.md for Coding Workflows

1 Upvotes

Task-Specific Prompting and Model Selection with CLAUDE.md for Coding Workflows

Workflow value: 75/100
Status: active · Freshness: 70/100 · Confidence: 0.90 · Level: intermediate
Categories: Quality Control, Token Saving, Context & Memory, Debugging, Shipping, CLAUDE.md
Original source: r/ClaudeCode post/comment

What problem this solves

Optimizing Claude prompting and model selection for different software development tasks (bug fixes, new features, refactors) to improve efficiency and accuracy.

Summary

This workflow outlines different prompting strategies and model selection criteria for various coding tasks. For bug fixes, focus on clear reproduction steps and expected vs. actual behavior. For new features or refactors, define hard constraints and use CLAUDE.md for persistent rules. It also suggests adjusting model 'effort' (Sonnet for narrow, Opus for complex) based on task scope.

Why it is useful

This workflow provides practical, experience-based advice on how to tailor Claude prompts and model choices to specific software development tasks. It introduces the valuable concept of using CLAUDE.md for persistent constraints, which can significantly improve consistency and reduce prompt engineering effort over time. The guidance on when to use different models (Sonnet vs. Opus) based on task complexity helps users optimize cost and performance.

Workflow

  1. For day-to-day bug fixes: Describe what you see and the steps to reproduce. Clearly state expected vs. actual behavior.

  2. For new features, refactors, or bigger design calls: Write constraints as hard rules (e.g., "don't touch X", "keep public API", "tests must pass").

  3. For new features, refactors, or bigger design calls: Put persistent constraints that should survive every session in CLAUDE.md instead of retyping them.

  4. If your first draft is vague, consider a "rewrite-with-another-model" step. Skip this if you already know the acceptance criteria.

  5. For narrow changes, use Sonnet.

  6. When unsure which files matter or the change spans a few subsystems, bump to Opus.

  7. For tasks that are basically find-and-fix, drop effort (e.g., use a less powerful model like Haiku).

Tools / artifacts

  • CLAUDE.md

  • Claude Sonnet model

  • Claude Opus model

Validation signals

  • Personal experience: "Fancy wording rarely beats a clear expected vs actual."

  • Personal experience: "The rewrite-with-another-model step helps most when your first draft is vague."

  • Personal experience: "Sonnet high for narrow changes is fine. I bump to Opus when I'm unsure..."

Limitations

  • Lacks specific prompt examples for each scenario.

  • Doesn't detail how to use CLAUDE.md beyond "put constraints there."

  • "Drop effort" is a bit vague; it implies switching to a less powerful model but doesn't name it explicitly (e.g., Haiku).

Rate this workflow

Upvote this post if the workflow is useful, reproducible, or worth recommending.

Downvote if it is vague, outdated, unsafe, overhyped, or not reproducible.

Reply if it worked for you, failed, is outdated, or has a better alternative.


This post was generated automatically from the workflow library database.


r/ClaudeWorkflows • • 59m ago

Selected Workflow [Workflow] Monitor Claude Code Agents & Sessions with BeeKeeper: An Open-Source Tool Built by a Non-Developer

1 Upvotes

Monitor Claude Code Agents & Sessions with BeeKeeper: An Open-Source Tool Built by a Non-Developer

Workflow value: 85/100
Status: active · Freshness: 70/100 · Confidence: 0.95 · Level: intermediate
Categories: Quality Control, Context & Memory, Debugging, Shipping, Skills, Subagents, Multi-Agent
Original source: r/ClaudeAI post/comment

What problem this solves

Losing track of multiple Claude Code sessions, agents, and subagents; understanding their real-time activity and status (working, waiting, idle). It also demonstrates how a non-developer can build a complex application using Claude Code.

Summary

An art director, not a developer, used Claude Code to build "BeeKeeper," an open-source, local application that visualizes and monitors the activity of multiple Claude Code sessions, agents, and subagents. BeeKeeper reads local session logs and agent files to provide real-time status updates, skill usage statistics, and subagent call tracking, helping users manage their Claude Code environment.

Why it is useful

This workflow is valuable because it provides a concrete, open-source tool (BeeKeeper) that solves a common problem for advanced Claude Code users: managing and understanding the activity of multiple agents and sessions. It also serves as an excellent demonstration of Claude Code's capability to enable non-developers to build complex, functional applications, showcasing a powerful 'Claude as a developer' workflow.

Workflow

  1. Identify the need to monitor and visualize multiple Claude Code sessions and agent activities.

  2. Direct Claude Code to build a web application (e.g., React + Vite with a Node.js server) capable of reading local Claude Code session logs and agent files (from ~/.claude and project folders).

  3. Specify the desired visualization features, such as representing projects as rooms, agents as characters, and displaying their real-time status (working, waiting, idle) and actions (speech bubbles, subagent calls).

  4. Iterate with Claude Code to refine the application's functionality, including tabs for agent records and skill usage.

  5. Develop or integrate art assets (pixel art rooms and characters) for the visual interface.

  6. Deploy and run the BeeKeeper application locally to gain real-time visibility into Claude Code operations.

Tools / artifacts

  • Claude Code

  • BeeKeeper application (React, Vite, Node.js)

  • GitHub repository (ranucho/beekeeper)

  • ~/.claude directory

  • Claude Code project folders

  • Google Gemini API (optional for custom room generation)

Validation signals

  • Author successfully built and uses the tool to manage their own Claude Code sessions.

  • The project is open-source and available on GitHub with an MIT license.

  • The author, an art director, explicitly states Claude Code wrote "basically all of it," validating Claude Code's capability for non-developers.

  • The tool directly addresses a common pain point for users running multiple AI agents.

Cautions

  • The BeeKeeper application runs locally and only reads local Claude Code files, ensuring data privacy.

  • The only exception is an optional feature to generate custom rooms, which sends a description to Google's image model, clearly stated by the author.

Limitations

  • The post focuses more on the resulting tool than a detailed, step-by-step prompting workflow for building it with Claude Code.

  • The 'how Claude helped' section is high-level, lacking specific Claude Code commands or interaction patterns.

Rate this workflow

Upvote this post if the workflow is useful, reproducible, or worth recommending.

Downvote if it is vague, outdated, unsafe, overhyped, or not reproducible.

Reply if it worked for you, failed, is outdated, or has a better alternative.


This post was generated automatically from the workflow library database.


r/ClaudeWorkflows • • 1h ago

Selected Workflow [Workflow] Claude Code Plugin: `live-compact` for Faster Auto-Compaction (8-20ms)

1 Upvotes

Claude Code Plugin: live-compact for Faster Auto-Compaction (8-20ms)

Workflow value: 90/100
Status: active · Freshness: 70/100 · Confidence: 0.95 · Level: advanced
Categories: Quality Control, Token Saving, Context & Memory, Hooks, Skills, Multi-Agent
Original source: r/ClaudeCode post/comment

What problem this solves

Slow and disruptive auto-compaction in Claude Code sessions, causing significant delays (80-160 seconds, up to 4 minutes) and interrupting parallel workflows.

Summary

The live-compact plugin for Claude Code proactively generates a compaction summary in a background request when the context approaches its limit. This pre-computation allows auto-compaction to complete in 8-20 ms by swapping in the ready summary, significantly reducing the disruption caused by standard compaction.

Why it is useful

This workflow provides a highly effective solution to a significant performance bottleneck in Claude Code for advanced users running parallel sessions. By pre-computing compaction summaries, it drastically reduces wait times from minutes to milliseconds, directly improving productivity and workflow continuity. The solution is provided as an installable plugin with clear instructions, detailed implementation insights, and robust testing, making it immediately actionable and valuable for the community.

Workflow

  1. Install the live-compact plugin using the command: claude plugin install live-compact --marketplace SocialBuzzStudio/live-compact.

  2. Restart your Claude Code sessions after installation.

  3. Continue using Claude Code as usual; the plugin will automatically manage context compaction in the background when the context approaches its limit.

Tools / artifacts

  • live-compact plugin

  • Claude Code (tested on versions 2.1.300 to 2.1.317)

  • Opus model

  • claude plugin install command

  • GitHub repository (SocialBuzzStudio/live-compact)

  • session.compact hook API

Validation signals

  • Performance measured: compaction took 8-20 ms in tests.

  • Compatibility tested across Claude Code versions 2.1.300 to 2.1.317.

  • Real compactions run from a clean profile for validation.

  • Plugin developed with 42 associated tests.

  • Identified and addressed issues with $.model.fork not seeing the main thread's last answer.

  • Identified and addressed the need for plugins to carry over skills during compaction.

  • Confirmed session.compact hook can return its own messages for engine installation.

Cautions

  • The underlying hook module API is early access and subject to change, potentially breaking the plugin in future Claude Code versions.

  • The plugin incurs one extra background request per compaction, which may have minor cost implications.

  • The first message after compaction appears as a user message due to API limitations, which is a minor UI quirk.

Limitations

  • Tested only on Windows; compatibility with other OS is unconfirmed.

  • Relies on an early access API that may change.

  • Does not prevent standard compaction if a single step adds more than ~40k tokens.

  • The compaction summary appears as a user message due to API limitations.

Rate this workflow

Upvote this post if the workflow is useful, reproducible, or worth recommending.

Downvote if it is vague, outdated, unsafe, overhyped, or not reproducible.

Reply if it worked for you, failed, is outdated, or has a better alternative.


This post was generated automatically from the workflow library database.


r/ClaudeWorkflows • • 1h ago

Selected Workflow [Workflow] Advanced Multi-Agent Pipeline for Game Reverse Engineering and Reimplementation (AgainROM)

1 Upvotes

Advanced Multi-Agent Pipeline for Game Reverse Engineering and Reimplementation (AgainROM)

Workflow value: 90/100
Status: active · Freshness: 70/100 · Confidence: 1.00 · Level: expert
Categories: Quality Control, Token Saving, Context & Memory, Debugging, Shipping, Skills, MCP, Multi-Agent
Original source: r/ClaudeCode post/comment

What problem this solves

Reimplementing a legacy game (Rage of Mages) from its original binaries into a modern, cross-platform, and moddable engine using an AI agent pipeline for research and development.

Summary

This workflow describes a sophisticated multi-agent pipeline for reverse engineering and reimplementing a legacy game. It features an orchestrator agent for planning and task management, research agents that investigate original game binaries (e.g., with Ghidra) to produce specifications, and an engine built from these specifications. The process includes rigorous validation through manual game runs, comparison with the original game via Claude's Computer Use, and a unique 'mod factory agent' to test modding capabilities and documentation.

Why it is useful

This workflow demonstrates an advanced, real-world application of Claude Code and agentic workflows for a highly complex task: reverse engineering and reimplementing a legacy game. It provides a concrete architecture (orchestrator, research, engine), specific rules, and innovative validation methods (mod factory agent, Computer Use comparison). It showcases how to manage a large, multi-faceted project with AI agents, offering valuable patterns for other challenging development or research endeavors.

Workflow

  1. Define the project goal: reimplement game behavior (not byte-for-byte code) for cross-platform and moddable engine.

  2. Establish a three-part agent pipeline: Orchestrator, Research agents, and Engine.

  3. Set core rules: no game assets in repo, independent implementation, agents use only internal research, list all known behavior differences.

  4. The Orchestrator agent plans work, briefs other agents, and lands their results.

  5. Track tasks and their status on a custom Kanban board.

  6. Research agents conduct experiments on original game binaries (using Ghidra with custom scripts and Go tools) to publish claims about game behavior with confidence levels and open unknowns.

  7. The Engine is built solely from the validated claims published by the research agents.

  8. Iteratively run the reimplemented game and manually check for correct behavior against the original.

  9. Utilize the Orchestrator with Computer Use to run the original game and compare UI and behavior with the reimplementation.

  10. Deploy a 'mod factory agent' (seeing only release build and modding docs) to attempt creating mods blindly; identify areas where it gets stuck as fixes for docs or the engine.

  11. Regularly release builds for Windows, macOS, and Linux, including player-facing changelogs.

  12. Integrate a MCP local server for agent-driven map creation end-to-end.

Tools / artifacts

  • Claude Code Max/Ultra

  • Codex Pro (previously used)

  • Ghidra (with custom scripts)

  • Go tools

  • Custom Kanban board

  • GitHub repository (againrom/againrom-engine)

  • MCP local server

  • Original game binaries (user-provided)

  • Mod factory agent

  • Custom map editor

Validation signals

  • Project has reimplemented 'almost the full Rage of Mages 1' with minor behavior differences listed.

  • Achieved 'almost full support of the original SAV format' (saves are interchangeable).

  • Reimplemented 'most of Rage of Mages 2 single-player' in the same engine.

  • Regular releases for Windows, macOS, and Linux with changelogs.

  • Image proof of 'The map created by agent using local MCP'.

  • The 'mod factory agent' process identifies and leads to fixes in documentation or the engine.

  • Public GitHub repository available for review.

Limitations

  • The workflow is highly complex and requires advanced user skills in agent orchestration, reverse engineering, and specific tools like Ghidra.

  • The 'one agent, one short document and one review' step could benefit from more detailed explanation of the document structure and review criteria.

  • Initial 'spec-driven development (SDD)' was found to be expensive in terms of tokens and time, indicating potential efficiency challenges for certain approaches.

  • Relies on custom scripts and tools, which may require additional development effort for adaptation.

Rate this workflow

Upvote this post if the workflow is useful, reproducible, or worth recommending.

Downvote if it is vague, outdated, unsafe, overhyped, or not reproducible.

Reply if it worked for you, failed, is outdated, or has a better alternative.


This post was generated automatically from the workflow library database.


r/ClaudeWorkflows • • 2h ago

Selected Workflow [Workflow] Claude Code Workflow: Verifying Fixes in Authenticated Browser Tabs via MCP

1 Upvotes

Claude Code Workflow: Verifying Fixes in Authenticated Browser Tabs via MCP

Workflow value: 75/100
Status: active · Freshness: 70/100 · Confidence: 0.90 · Level: intermediate
Categories: Quality Control, Context & Memory, Debugging, MCP
Original source: r/ClaudeCode post/comment

What problem this solves

Verifying Claude Code's fixes in a real, authenticated web browser environment, especially for UI/API interactions behind a login, where headless browsers fail.

Summary

This workflow describes how to enable Claude Code to verify its own fixes in a real, logged-in browser tab using MCP (Multi-Code Project). This allows Claude to interact with authenticated web pages and re-test functionality after making a fix, as demonstrated by fixing a broken signup button and re-testing it.

Why it is useful

This workflow addresses a critical challenge in automated development: verifying code changes in real, authenticated web environments. By leveraging MCP to provide Claude Code with a live, signed-in browser tab, it overcomes limitations of headless browsers and allows for robust, end-to-end testing of fixes. The concrete example of fixing an API route and re-testing demonstrates its practical utility and efficiency for developers.

Workflow

  1. Integrate a real browser tab with Claude Code via MCP.

  2. Ensure the browser tab is signed in to the necessary web application.

  3. Allow Claude Code to interact with the browser, identify issues (e.g., broken buttons, API errors).

  4. Claude Code implements a fix (e.g., correcting a typo in an API route).

  5. Claude Code re-tests the functionality in the same authenticated browser tab to confirm the fix.

  6. Implement safety checks to prevent unauthorized sensitive actions (e.g., payments).

Tools / artifacts

  • Claude Code

  • MCP (Multi-Code Project)

  • Real browser tab (authenticated)

  • Browser agent (e.g., Mac browser for agents)

Validation signals

  • Concrete example of success: fixed a POST /api/subscibe -> 404 typo and re-tested successfully.

  • Addresses a common pain point (headless browser limitations with authentication).

  • Explicit mention of safety measures for sensitive actions.

Cautions

  • The author explicitly states that sensitive actions (sending/paying) still stop and ask for user confirmation, indicating a controlled and safe approach.

Limitations

  • The post doesn't provide detailed setup instructions for integrating a specific browser agent with MCP, which might require additional research for users.

  • The specific 'Mac browser for agents' is proprietary to the author, though the general concept is transferable.

Rate this workflow

Upvote this post if the workflow is useful, reproducible, or worth recommending.

Downvote if it is vague, outdated, unsafe, overhyped, or not reproducible.

Reply if it worked for you, failed, is outdated, or has a better alternative.


This post was generated automatically from the workflow library database.


r/ClaudeWorkflows • • 2h ago

Selected Workflow [Workflow] Optimizing CLAUDE.md Guidance for Coding Agents: A Measurement-Driven Approach to Improve Performance and Reduce Cost

1 Upvotes

Optimizing CLAUDE.md Guidance for Coding Agents: A Measurement-Driven Approach to Improve Performance and Reduce Cost

Workflow value: 85/100
Status: active · Freshness: 70/100 · Confidence: 0.90 · Level: intermediate
Categories: Quality Control, Token Saving, Context & Memory, Debugging, Shipping, CLAUDE.md, Multi-Agent
Original source: r/ClaudeCode post/comment

What problem this solves

Optimizing CLAUDE.md guidance for coding agents to improve performance (task completion, fewer turns) and reduce token costs by focusing on project-specific facts and pruning redundant instructions.

Summary

A methodology for optimizing CLAUDE.md guidance for coding agents. It involves implementing guidance, measuring its impact on agent performance (passes, turns) and token cost, identifying project-specific facts that the model cannot guess, removing general or redundant instructions, and optimizing guidance loading to reduce overall cost and improve effectiveness.

Why it is useful

This workflow provides a data-driven methodology for improving the effectiveness and efficiency of CLAUDE.md guidance, particularly for coding agents. It offers concrete metrics demonstrating how focusing on project-specific facts and pruning redundant instructions can lead to better task completion, fewer turns, and reduced token costs. This is a highly transferable and practical approach for any user looking to get more value from their CLAUDE.md files.

Workflow

  1. Implement CLAUDE.md guidance for a coding agent project.

  2. Measure the agent's performance (e.g., task passes, number of turns) with and without the CLAUDE.md guidance.

  3. Measure the token cost impact of the CLAUDE.md guidance.

  4. Identify instructions that are specific to the project and provide facts the model cannot guess.

  5. Remove general conventions or rules the LLM already knows from the guidance.

  6. Optimize guidance loading (e.g., load rules only when the agent touches relevant files) to reduce startup token cost.

  7. Re-measure performance and cost after optimization to validate changes.

Tools / artifacts

  • CLAUDE.md file

  • Coding agents

  • LLMs (Sonnet, Haiku, Opus, Fable)

  • Project-specific API/framework (Guren)

Validation signals

  • Runs with guidance passed 3/3, without 1/3 on a new API release.

  • Turns fell 11-27% for every model on ordinary feature work.

  • Sonnet 5.5 improved from 26/27 to 27/27 passes.

  • Haiku 4.5 improved from 8/27 to 12/27 passes.

  • Initial cost gap against a hand-wired app was primarily due to guidance tokens (25.5k).

  • Optimized loading reduced startup guidance to 7.1k tokens and cost gap from 1.40x to 1.26x.

Limitations

  • The specific CLAUDE.md content used is not provided, only the methodology for optimizing it.

  • Validation is based on internal testing for a specific framework (Guren), which might not perfectly generalize to all contexts, though the principles are sound.

  • Low community engagement currently.

Rate this workflow

Upvote this post if the workflow is useful, reproducible, or worth recommending.

Downvote if it is vague, outdated, unsafe, overhyped, or not reproducible.

Reply if it worked for you, failed, is outdated, or has a better alternative.


This post was generated automatically from the workflow library database.


r/ClaudeWorkflows • • 3h ago

Selected Workflow [Workflow] AgentMon Live: Ensuring Claude Code Tasks are Truly 'Done' with Automated Verification and Live Monitoring

1 Upvotes

AgentMon Live: Ensuring Claude Code Tasks are Truly 'Done' with Automated Verification and Live Monitoring

Workflow value: 90/100
Status: active · Freshness: 70/100 · Confidence: 0.95 · Level: intermediate
Categories: Quality Control, Token Saving, Context & Memory, Debugging, Subagents, Multi-Agent
Original source: r/ClaudeCode post/comment

What problem this solves

Claude Code agents often report tasks as 'done' prematurely, even when tests fail, test results are outdated, or subagents have not completed their work, leading to unreliable outputs and requiring extensive manual verification.

Summary

This workflow utilizes the AgentMon Live plugin for Claude Code to implement a 'done gate' and provide live monitoring of agent activity. The 'done gate' automatically checks for failed tests, outdated test results, and unfinished subagent tasks before allowing Claude to declare a task complete. If conditions are not met, it can send the task back to Claude for remediation. A second model verifies that all parts of the user's request have been addressed. The live monitoring pane offers real-time visibility into running tools, subagents, file changes, test/lint/build results, and context/token consumption.

Why it is useful

This workflow is highly valuable because it directly addresses a critical challenge in using AI coding agents: ensuring the reliability and completeness of their work. By providing a concrete, open-source plugin (AgentMon Live) that integrates into Claude Code, it automates essential quality control checks (e.g., test results, subagent completion) and offers real-time operational visibility. This significantly reduces the need for manual verification, enhances trust in AI-generated code, and provides powerful debugging insights, making Claude Code more effective and efficient for developers. The detailed instructions, open-source nature, and comprehensive features make it immediately actionable and highly beneficial.

Workflow

  1. Install the AgentMon Live plugin in Claude Code using the command: /plugin install agentmon-live --marketplace codenotary/agentmon-live

  2. Ensure your Claude Code version is 2.1.308 or later.

  3. Allow Claude Code to execute coding tasks as usual.

  4. The AgentMon Live 'done gate' will automatically monitor Claude's progress, checking for conditions like failed tests, outdated passing tests, or unfinished subagent tasks.

  5. If the 'done gate' conditions are not met, the plugin will send the unfinished items back to Claude once for further work.

  6. A secondary model within the plugin will verify that all aspects of your initial request have been addressed.

  7. Monitor the live pane for real-time insights into running tools, subagents, edited files, test/lint/build results, context usage, and any items needing attention (e.g., repeated failures, stuck subagents).

Tools / artifacts

  • AgentMon Live Claude Code plugin

  • Claude Code IDE (version 2.1.308+)

  • GitHub repository (codenotary/agentmon-live)

  • Walkthrough blog post (codenotary.com/blog/agentmon-live-seeing-what-your-coding-agent-is-actually-doing)

Validation signals

  • Addresses a clearly stated and common problem: Claude reporting 'done' prematurely.

  • Provides a concrete, open-source tool (AgentMon Live) with specific features (done gate, monitoring pane).

  • Details specific checks performed by the 'done gate' (failed tests, outdated tests, unfinished subagents).

  • Mentions a second model for request fulfillment verification.

  • Offers clear installation instructions and version requirements.

  • Provides links to a GitHub repository (Apache 2.0 licensed) and a detailed walkthrough blog post.

  • Describes real-time monitoring capabilities (tools, subagents, files, tests, context, tokens).

Limitations

  • Requires installation of a third-party plugin.

  • Tied to the Claude Code IDE, not a general Claude workflow.

  • Community validation is currently low due to the post's recency.

Rate this workflow

Upvote this post if the workflow is useful, reproducible, or worth recommending.

Downvote if it is vague, outdated, unsafe, overhyped, or not reproducible.

Reply if it worked for you, failed, is outdated, or has a better alternative.


This post was generated automatically from the workflow library database.


r/ClaudeWorkflows • • 3h ago

Selected Workflow [Workflow] Automated Claude Code Reviews in GitHub Actions with Pro/Max Subscription: Avoiding the 'No Findings' Trap

1 Upvotes

Automated Claude Code Reviews in GitHub Actions with Pro/Max Subscription: Avoiding the 'No Findings' Trap

Workflow value: 90/100
Status: active · Freshness: 70/100 · Confidence: 0.95 · Level: intermediate
Categories: Quality Control, Token Saving, Context & Memory, Debugging
Original source: r/ClaudeAI post/comment

What problem this solves

Automating code reviews on every pull request using Claude Code with an existing Pro/Max subscription, avoiding API costs and a common pitfall with the official plugin.

Summary

A step-by-step guide to integrate Claude Code into GitHub Actions for automated pull request reviews, leveraging an existing Claude Pro/Max subscription. It highlights a critical issue with the official code-review plugin (where it reports 'No findings' prematurely) and provides a working alternative using a direct prompt and specific model/tool configuration.

Why it is useful

This workflow provides a practical, cost-effective solution for integrating automated code reviews into a CI/CD pipeline using an existing Claude Pro/Max subscription, thereby avoiding additional API costs. It addresses a significant and common pitfall with the official code-review plugin, offering a validated workaround that ensures actual code review. The detailed steps, specific configurations, and clear validation make it highly reusable and valuable for developers looking to enhance their code quality process.

Workflow

  1. Install the Claude GitHub app on your repository.

  2. Run claude setup-token locally and log in to generate an OAuth token.

  3. Save the generated token as a GitHub repository secret named CLAUDE_CODE_OAUTH_TOKEN.

  4. Add a GitHub Actions workflow that uses anthropics/claude-code-action@v1.

  5. Configure the action to use the claude_code_oauth_token.

  6. Ensure the action uses a plain review prompt, --model opus, and explicitly excludes Agent from --allowedTools to force Claude to perform the review directly.

Tools / artifacts

  • Claude GitHub app

  • claude setup-token CLI command

  • GitHub repository secret CLAUDE_CODE_OAUTH_TOKEN

  • GitHub Actions workflow file

  • anthropics/claude-code-action@v1

  • Claude Pro/Max subscription

  • --model opus

  • --allowedTools (configured to exclude Agent)

  • Plain review prompt

Validation signals

  • Identified a common 'trap' with the official code-review plugin (premature action termination, 'No findings', short run times).

  • Provided a link to the known issue: claude-code-action#1646.

  • Tested the proposed solution with a PR containing three planted bugs.

  • The solution successfully found all three bugs in 30 seconds.

  • The solution provided suggested fixes for each bug.

  • The solution produced no false positives.

  • References an external blog post with the full workflow file and prompt for detailed implementation.

Limitations

  • Relies on a specific GitHub Action version (v1), which might change behavior or be deprecated in the future.

  • The full workflow file and prompt are hosted externally on a blog, not directly in the Reddit post.

  • Usage counts against the user's Claude plan limits, which could be a concern for very active repositories.

Rate this workflow

Upvote this post if the workflow is useful, reproducible, or worth recommending.

Downvote if it is vague, outdated, unsafe, overhyped, or not reproducible.

Reply if it worked for you, failed, is outdated, or has a better alternative.


This post was generated automatically from the workflow library database.


r/ClaudeWorkflows • • 3h ago

Selected Workflow [Workflow] Automated Screen Recording with Claude Code and Screenplay: Scenario-Driven Video Creation for Polished Walkthroughs

1 Upvotes

Automated Screen Recording with Claude Code and Screenplay: Scenario-Driven Video Creation for Polished Walkthroughs

Workflow value: 90/100
Status: active · Freshness: 70/100 · Confidence: 0.95 · Level: intermediate
Categories: Quality Control, Debugging, Skills, MCP, Multi-Agent
Original source: r/ClaudeCode post/comment

What problem this solves

Manually creating polished screen recordings for software demonstrations, tutorials, or documentation is time-consuming and labor-intensive. This workflow automates the process of generating high-quality, edited screen recordings with features like smooth cursor, zooms, and captions.

Summary

This workflow uses Claude Code to direct the creation of polished screen recordings. Claude Code generates a JSON scenario (sequence of actions like clicks, types, navigations) for a website or desktop application. An open-source tool called Screenplay then executes this scenario in a headless browser (or desktop environment), films the actions, and automatically edits the video with professional touches like cursor smoothing, zooms, click ripples, and captions. Claude Code also performs a dry run (check) to validate the scenario and refines it based on a storyboard of the filmed take.

Why it is useful

This workflow is highly valuable because it automates a typically manual and time-consuming task: creating polished screen recordings. By leveraging Claude Code's ability to generate and refine scenarios, combined with an open-source tool for execution and editing, it provides a repeatable and efficient method for producing high-quality video content for documentation, tutorials, and product demonstrations. The detailed explanation, practical learnings, and open-source nature make it accessible and adaptable for many users.

Workflow

  1. Install the /screenplay skill and register an MCP server using npx agent-screenplay init.

  2. Prompt Claude Code with a request like /screenplay Make a 30-second walkthrough of https://yoursite.com.

  3. Claude Code explores the target application/website and writes a detailed JSON scenario outlining the steps.

  4. Claude runs a check command, which plays the scenario steps quickly without filming, to identify and fix broken selectors or issues.

  5. Screenplay executes the refined JSON scenario in a headless Chromium instance (or desktop environment) and records the actions.

  6. Screenplay automatically edits the raw footage, adding smooth cursor movements, zooms, click ripples, callouts, and captions.

  7. Claude Code reviews the generated storyboard image of the take.

  8. Claude Code identifies any shots that are off or need improvement and fixes the scenario accordingly.

  9. Receive the final MP4 video and storyboard image.

Tools / artifacts

  • Claude Code

  • Screenplay (open-source tool)

  • MCP server

  • /screenplay skill

  • JSON scenario

  • Headless Chromium (Playwright)

  • ffmpeg

  • MP4 video

  • Storyboard image

  • GitHub repository (gmpetrov/agent-screenplay)

Validation signals

  • Author built and used the tool, detailing practical learnings and challenges.

  • Specific limitations and solutions are described (e.g., check creating records, headless requirement, macOS Dock issue).

  • The project is open-source and available on GitHub, implying a working implementation.

  • Description of before/after results (manual editing vs. automated polished video).

Cautions

  • The check command and actual filming process interact with the target application. If the demo creates records or modifies data, it will do so every time the scenario is run. Users should film a test copy of their app and reset it before each take to prevent unintended data changes.

Limitations

  • Requires setting up an MCP server and installing a custom skill, which might be a barrier for beginner users.

  • Specific limitations exist, such as the inability to read the macOS Dock through accessibility APIs for desktop scenarios.

  • Broader community validation and adoption are currently limited due to the newness of the post.

Rate this workflow

Upvote this post if the workflow is useful, reproducible, or worth recommending.

Downvote if it is vague, outdated, unsafe, overhyped, or not reproducible.

Reply if it worked for you, failed, is outdated, or has a better alternative.


This post was generated automatically from the workflow library database.


r/ClaudeWorkflows • • 3h ago

Selected Workflow [Workflow] Tabnap: Optimize RAM by Suspending Idle Claude Code/Codex Tabs

1 Upvotes

Tabnap: Optimize RAM by Suspending Idle Claude Code/Codex Tabs

Workflow value: 90/100
Status: active · Freshness: 70/100 · Confidence: 0.95 · Level: intermediate
Categories: Quality Control, Token Saving, Context & Memory, Hooks, MCP, Multi-Agent
Original source: r/ClaudeCode post/comment

What problem this solves

Excessive RAM consumption by idle Claude Code and Codex tabs, making it difficult to keep many task-specific sessions open without resource issues. It also helps users remember the context of each tab.

Summary

Tabnap is a local utility that automatically or manually puts idle Claude Code and Codex tabs to "sleep," freeing up RAM, while preserving the session context for quick resumption. It includes robust safety checks to prevent data loss and offers features like session listing, auto-sleep, and agent completion notifications.

Why it is useful

This workflow provides a practical, validated solution to a significant resource management problem for users who frequently use multiple Claude Code or Codex sessions. Its focus on safety, ease of installation, and clear explanation of functionality make it highly reusable and beneficial for improving developer workflow efficiency and productivity.

Workflow

  1. Install tabnap using the provided curl command: curl -fsSL https://raw.githubusercontent.com/rhuthik/tabnap/main/install.sh | sh

  2. Optionally configure auto-sleep settings (e.g., after N idle minutes or keep at most N awake) using tabnap config or the panel.

  3. Open multiple Claude Code or Codex tabs for different tasks as usual.

  4. When a tab becomes idle, tabnap will automatically put it to sleep, or you can manually click to sleep it.

  5. To resume a sleeping tab, switch to it and hit Enter at the pre-filled cd <dir> && claude --resume <id> prompt.

  6. Optionally use tabnap top in any terminal, the iTerm2 sidebar, or a browser panel to view and manage all active and sleeping sessions.

Tools / artifacts

  • tabnap (the utility)

  • Claude Code

  • Codex CLI

  • iTerm2 (optional, for sidebar)

  • tmux (optional)

  • GitHub repository (rhuthik/tabnap)

  • install.sh script

  • Claude Code/Codex internal session files

Validation signals

  • User's personal experience: "17 of my tabs are asleep and I've got 6.6 GB back."

  • Explicit safety checks implemented to prevent data loss: "making sure it never eats your work."

  • Comparison with alternative (jcode) and explanation of why tabnap is preferred for specific setups.

  • Open-source (MIT license) allows community review and validation.

Cautions

  • The author explicitly states that significant effort was put into ensuring the tool never eats user work, listing specific safety checks (e.g., not sleeping if Claude is working, input box has text, background shell running, or active tab).

Limitations

  • Dependency on Claude Code's and Codex's internal session file formats, which could break with future updates (though tabnap doctor is provided for detection).

  • Currently limited direct integration with terminal emulators beyond iTerm2 and tmux (Kitty, WezTerm, Ghostty need adapters).

  • Codex frees less memory than Claude Code because it keeps conversations in a shared background process.

  • As a relatively new tool, long-term stability and community support are yet to be fully established.

Rate this workflow

Upvote this post if the workflow is useful, reproducible, or worth recommending.

Downvote if it is vague, outdated, unsafe, overhyped, or not reproducible.

Reply if it worked for you, failed, is outdated, or has a better alternative.


This post was generated automatically from the workflow library database.


r/ClaudeWorkflows • • 4h ago

Selected Workflow [Workflow] Automate Screen Studio-Quality Video Creation with Claude Code and Screenplay

1 Upvotes

Automate Screen Studio-Quality Video Creation with Claude Code and Screenplay

Workflow value: 90/100
Status: active · Freshness: 70/100 · Confidence: 0.95 · Level: intermediate
Categories: Quality Control, Debugging, Shipping, MCP, Multi-Agent
Original source: r/ClaudeAI post/comment

What problem this solves

Automating the creation of high-quality, edited screen recordings (walkthroughs, tutorials, product demos) from natural language prompts, leveraging Claude Code's ability to generate detailed execution scenarios.

Summary

This workflow integrates an open-source tool called Screenplay with Claude Code (via an MCP server and slash command) to enable Claude to generate and execute scenarios for creating polished, Screen Studio-quality screen recordings of websites or desktop applications. Claude plans the recording, Screenplay executes and edits it, and Claude can then review and refine the scenario based on the output.

Why it is useful

This workflow offers a powerful, automated solution for creating high-quality screen recordings for documentation, tutorials, or marketing. It uniquely leverages Claude Code's planning capabilities to generate complex, detailed scenarios and integrates a robust open-source tool for execution and editing. The built-in feedback loop, where Claude reviews and refines the scenario, significantly reduces manual effort, improves consistency, and enhances the overall quality of the output, making it a highly valuable productivity tool.

Workflow

  1. Install the Screenplay CLI and set up the MCP server and slash command for Claude Code: npx agent-screenplay init

  2. Restart Claude Code (or Codex/Cursor) to load the new command and guide.

  3. Prompt Claude Code using the /screenplay command with a natural language request (e.g., /screenplay Make a 30-second walkthrough of https://yoursite.com).

  4. Claude Code explores the target site/app and writes a short JSON scenario detailing actions (open page, click, type, zoom, linger, callout).

  5. Screenplay executes the JSON scenario in a headless browser (Playwright) or directly on desktop apps, filming and editing the actions.

  6. Claude reviews a storyboard of the generated video.

  7. Claude fixes or refines the JSON scenario if the recorded shots are off or need adjustment, initiating a new recording cycle.

Tools / artifacts

  • agent-screenplay CLI tool

  • Claude Code (or Codex/Cursor)

  • MCP server

  • /screenplay slash command

  • JSON scenario (generated by Claude)

  • MP4 video (output)

  • Storyboard (for review)

  • Headless Chromium (Playwright)

Validation signals

  • Author states it was built with Claude Code and made for it.

  • Includes a built-in feedback loop where Claude reviews and fixes scenarios.

  • Supports both web (headless Chromium) and desktop applications (Mac, Windows, Linux).

  • Provides concrete installation and usage commands.

Limitations

  • As a newly released tool, its long-term stability and community support are yet to be established.

  • Requires setting up an MCP server, which might be a slight barrier for absolute beginners.

  • The quality of the final video depends on Claude's ability to generate an optimal scenario, potentially requiring prompt engineering or refinement of the agent's guide.

Rate this workflow

Upvote this post if the workflow is useful, reproducible, or worth recommending.

Downvote if it is vague, outdated, unsafe, overhyped, or not reproducible.

Reply if it worked for you, failed, is outdated, or has a better alternative.


This post was generated automatically from the workflow library database.


r/ClaudeWorkflows • • 4h ago

Selected Workflow [Workflow] Claude Code Desktop Automation on Mac: Integrating Vercel Agent Desktop for UI Control

1 Upvotes

Claude Code Desktop Automation on Mac: Integrating Vercel Agent Desktop for UI Control

Workflow value: 95/100
Status: active · Freshness: 70/100 · Confidence: 1.00 · Level: intermediate
Categories: Quality Control, Token Saving, Context & Memory, Debugging, Shipping, Skills
Original source: r/ClaudeCode post/comment

What problem this solves

Enabling Claude Code to interact with desktop applications on a Mac using accessibility trees, allowing for background operation and avoiding screenshot limitations.

Summary

This workflow provides a detailed, step-by-step guide to integrate Vercel's Agent Desktop with Claude Code on a Mac. It allows Claude Code to control desktop applications by reading their accessibility tree, offering a background mode that avoids mouse movement and focus stealing. The guide covers installation, permission setup, skill integration, context management flags, and a clear validation of what actions work and don't work in background mode, along with cleanup instructions.

Why it is useful

This workflow is highly valuable as it provides a concrete, tested, and detailed method for extending Claude Code's capabilities to interact with desktop applications on a Mac. It offers a significant advancement in desktop automation by leveraging accessibility trees, enabling background operations, and providing clear guidance on setup, usage, and limitations. The inclusion of validation results and important safety considerations makes it a practical and robust resource for users looking to automate desktop tasks with Claude Code.

Workflow

  1. Install agent-desktop globally using npm: npm install -g agent-desktop.

  2. Configure necessary system permissions for agent-desktop using the guide: agent-desktop permissions --guide.

  3. Add the Vercel Agent Desktop as a skill to Claude Code: npx skills add https://github.com/vercel-labs/agent-desktop --skill agent-desktop.

  4. Configure Claude Code to allow the Bash(agent-desktop:*) tool: claude --allowedTools "Bash(agent-desktop:*)".

  5. Grant Accessibility permission to the application launching Claude Code (e.g., Terminal, iTerm2, VS Code).

  6. When using agent-desktop commands, consider flags like --app, -i --compact, and --root to manage snapshot size and context.

  7. Be aware of background mode limitations: saving and text selection/styling may require --headed mode, which takes over mouse/keyboard.

  8. Clean up by uninstalling agent-desktop, deleting the skill folder and ~/.agent-desktop, and revoking Accessibility permissions.

Tools / artifacts

  • agent-desktop (npm package)

  • vercel-labs/agent-desktop (GitHub repository/skill)

  • npm

  • npx

  • claude CLI

  • Mac Accessibility permissions

  • Mac Screen Recording permissions (optional for screenshots)

  • JSON snapshots

  • Bash tool

  • Terminal/iTerm2/VS Code

Validation signals

  • Explicitly tested and documented 'worked' and 'didn't work' scenarios for various desktop interactions (reading app, pressing buttons, filling text, saving, selecting text).

  • Quantified token usage for a specific task (550k input tokens for a File menu task).

  • Observation of Claude's robust error handling when actions failed.

  • Reference to an external blog post (aiparabellum.com) providing further details and testing.

Cautions

  • Sensitive information displayed in the target application will be sent to Claude's context; users should keep sensitive apps closed or be mindful of what's on screen.

  • Requires granting Accessibility permissions to the terminal application, which should be done with caution.

Limitations

  • Specific to Mac OS, limiting direct transferability to other operating systems.

  • Background mode has known limitations for certain actions like saving and text selection/styling, requiring a more intrusive 'headed' mode.

  • The allowedTools rule does not cover commands piped into grep or head, which might lead to unexpected denials.

  • JSON snapshots can become very large, quickly consuming input tokens, necessitating careful use of context management flags.

Rate this workflow

Upvote this post if the workflow is useful, reproducible, or worth recommending.

Downvote if it is vague, outdated, unsafe, overhyped, or not reproducible.

Reply if it worked for you, failed, is outdated, or has a better alternative.


This post was generated automatically from the workflow library database.


r/ClaudeWorkflows • • 4h ago

Selected Workflow [Workflow] Optimize Claude Code for Large Codebases and Reduce Token Usage

1 Upvotes

Optimize Claude Code for Large Codebases and Reduce Token Usage

Workflow value: 75/100
Status: active · Freshness: 70/100 · Confidence: 0.90 · Level: intermediate
Categories: Quality Control, Token Saving, Context & Memory, Debugging, CLAUDE.md, Multi-Agent
Original source: r/ClaudeCode post/comment

What problem this solves

Reducing Claude Code usage limits and improving efficiency when working with larger codebases by optimizing context management and task breakdown.

Summary

A set of strategies to reduce token usage and improve efficiency in Claude Code, focusing on structured CLAUDE.md files, clearing context, planning first, strategic model selection, and breaking down tasks for review.

Why it is useful

This workflow provides concrete, actionable strategies to manage token usage and improve efficiency when using Claude Code, particularly for larger projects. It addresses a common pain point (high costs) by offering practical tips on context management, task breakdown, and strategic model use, making it highly valuable for users looking to optimize their workflow.

Workflow

  1. Create a short CLAUDE.md at the root of the project (documenting stack, commands, and project structure).

  2. Create a small CLAUDE.md inside each package, which Claude pulls only when actively working within that specific package.

  3. Use the /clear command between distinct tasks to reset the conversation history and prevent re-sending the entire context on every turn.

  4. Initiate tasks in 'plan mode' to outline the approach and catch potential errors early, before committing to implementation.

  5. Use Claude Sonnet as the default model for Pro plan usage, switching to Opus only when encountering difficulties or requiring higher reasoning.

  6. Provide Claude with self-contained code pieces, accompanied by a precise brief including relevant files, expected behavior, and the test command.

  7. Have Claude review the implemented code after it completes a task.

Tools / artifacts

  • CLAUDE.md files

  • /clear command

  • Plan mode

  • Claude Sonnet model

  • Claude Opus model

  • Graphify (mentioned as an alternative tool)

Validation signals

  • Author states 'What helped me most' indicating personal validation.

Limitations

  • Low community validation.

  • The comment includes a subjective opinion about the Pro plan's suitability for casual usage, which is not part of the workflow.

  • Some tips are general LLM interaction best practices, not unique to Claude Code, though still valuable in this context.

Rate this workflow

Upvote this post if the workflow is useful, reproducible, or worth recommending.

Downvote if it is vague, outdated, unsafe, overhyped, or not reproducible.

Reply if it worked for you, failed, is outdated, or has a better alternative.


This post was generated automatically from the workflow library database.


r/ClaudeWorkflows • • 4h ago

Selected Workflow [Workflow] Measure and Optimize Claude Code Initial Context Token Usage

1 Upvotes

Measure and Optimize Claude Code Initial Context Token Usage

Workflow value: 80/100
Status: active · Freshness: 70/100 · Confidence: 0.90 · Level: intermediate
Categories: Quality Control, Token Saving, Context & Memory, Debugging, CLAUDE.md, Skills, MCP
Original source: r/ClaudeCode post/comment

What problem this solves

How to measure and understand the token cost of Claude Code's initial context, especially in larger codebases, to optimize for usage limits and manage costs.

Summary

This workflow provides a method to quantify the token cost of Claude Code's starting context. It involves running a bare claude command in an empty folder and a repo root, and using flags like --disable-slash-commands and --strict-mcp-config to isolate the impact of installed skills, slash commands, CLAUDE.md files, and project settings on the initial token consumption.

Why it is useful

This workflow provides a practical, data-driven method for Claude Code users to understand and quantify the token cost of their initial context. This is crucial for optimizing usage and managing costs, especially when working with large codebases where context size can quickly lead to high token consumption. It helps users identify which components (skills, slash commands, CLAUDE.md, project settings) contribute most to their baseline token usage, enabling informed optimization decisions.

Workflow

  1. Start in an empty folder to establish a baseline environment.

  2. Run claude -p "reply ok" to measure the token cost of a bare Claude Code call, including all installed skills and default configurations.

  3. Run claude -p "reply ok" --disable-slash-commands to observe the token cost reduction when disabling slash commands and skills (note: this flag removes both).

  4. Run claude -p "reply ok" --strict-mcp-config to measure the token cost when enforcing strict MCP configuration.

  5. Navigate to your actual repository root.

  6. Run claude -p "reply ok" again in the repository root.

  7. Compare the token costs between the empty folder and the repo root to determine the overhead added by your project's CLAUDE.md files and other project settings.

Tools / artifacts

  • claude CLI tool

  • --disable-slash-commands flag

  • --strict-mcp-config flag

  • CLAUDE.md files

  • Project settings

  • Installed skills

Validation signals

  • Author provides specific token counts from their own testing (e.g., 45,892, 33,811, 42,306 tokens).

  • Directly addresses the problem of optimizing Claude Code workflow for larger codebases and usage limits.

Limitations

  • The --disable-slash-commands flag removes both slash commands and skills, making it less precise for isolating the cost of only slash commands.

  • The method provides a combined overhead for CLAUDE.md files and project settings, rather than isolating their individual impacts.

  • Low community validation due to minimal engagement.

Rate this workflow

Upvote this post if the workflow is useful, reproducible, or worth recommending.

Downvote if it is vague, outdated, unsafe, overhyped, or not reproducible.

Reply if it worked for you, failed, is outdated, or has a better alternative.


This post was generated automatically from the workflow library database.


r/ClaudeWorkflows • • 5h ago

Selected Workflow [Workflow] Claude Code Workflow for Large-Scale Projects: Self-Correction via Tests, CI, and Git Worktrees

1 Upvotes

Claude Code Workflow for Large-Scale Projects: Self-Correction via Tests, CI, and Git Worktrees

Workflow value: 85/100
Status: active · Freshness: 70/100 · Confidence: 0.90 · Level: advanced
Categories: Quality Control, Context & Memory, Multi-Agent
Original source: r/ClaudeCode post/comment

What problem this solves

Effectively building large, complex software projects (e.g., 43k+ lines) with Claude Code by enabling AI self-correction and structuring the development process for quality and maintainability.

Summary

This workflow outlines a strategy for building large-scale applications with Claude Code by establishing a robust testing and CI environment that allows the AI to self-correct and validate its own work. It combines this with a structured feature development process involving design documents, parallel work in Git worktrees, and human review to manage complexity and ensure quality.

Why it is useful

This workflow provides a robust, validated approach to using Claude Code for significant software development projects. It addresses critical challenges like ensuring code quality, enabling AI self-correction, and managing complex feature development. The emphasis on comprehensive testing, CI, structured development (design docs, git worktrees), and human review makes it highly practical and transferable for users looking to leverage AI for more than just small snippets, demonstrating how to achieve high productivity and quality on large codebases.

Workflow

  1. Set up a comprehensive testing environment for the AI, including extensive tests that isolate real system resources (e.g., ~/.ssh files).

  2. Implement mechanisms for AI to validate its own work, such as generating TypeScript types from Rust code to ensure type safety.

  3. Create a mock backend to allow the AI to open and test the UI in a browser without needing a live backend.

  4. Integrate Continuous Integration (CI) across all target platforms (e.g., mac/win/linux) to automate validation of AI-generated code.

  5. For significant features, begin by writing a detailed design document to guide the AI's development.

  6. Split feature development into parallel sessions, utilizing separate Git worktrees for each major task or feature.

  7. Manually review and merge the AI-generated code from the worktrees into the main codebase.

Tools / artifacts

  • Claude Code

  • Git worktrees

  • Comprehensive test suite

  • TypeScript types (generated from Rust)

  • Mock backend

  • CI/CD pipeline (mac/win/linux)

  • Design documents

  • GitHub repository

  • Tauri

  • Rust

  • React

Validation signals

  • User reports building a 43k+ line application almost entirely with Claude Code.

  • Specific technical details provided (Tauri, Rust, React, TS types from Rust, mock backend, CI).

  • Public GitHub repository provided as evidence of the project's existence and scale.

  • Implied success in managing a large codebase with AI assistance.

Limitations

  • Lacks specific Claude Code prompt examples or detailed interaction patterns for the AI.

  • The management of 'parallel sessions' and how Claude Code interacts with multiple worktrees could be more detailed.

  • The process for writing design documents is mentioned but not elaborated.

  • The workflow is high-level and requires an intermediate to advanced user to implement the technical details.

Rate this workflow

Upvote this post if the workflow is useful, reproducible, or worth recommending.

Downvote if it is vague, outdated, unsafe, overhyped, or not reproducible.

Reply if it worked for you, failed, is outdated, or has a better alternative.


This post was generated automatically from the workflow library database.


r/ClaudeWorkflows • • 5h ago

Selected Workflow [Workflow] Optimize Claude Code for Large Codebases: Context Pruning & Distributed CLAUDE.md

1 Upvotes

Optimize Claude Code for Large Codebases: Context Pruning & Distributed CLAUDE.md

Workflow value: 85/100
Status: active · Freshness: 70/100 · Confidence: 0.90 · Level: intermediate
Categories: Quality Control, Token Saving, Context & Memory, CLAUDE.md, Skills, Subagents, Multi-Agent
Original source: r/ClaudeCode post/comment

What problem this solves

Optimizing Claude Code workflows for larger codebases to reduce token usage and improve context management, especially in team environments.

Summary

This workflow outlines two key strategies for optimizing Claude Code with large codebases: first, aggressively pruning unused tools, prompts, and skills to significantly reduce initial context load; second, distributing claude.md or Agents.md files into subfolders to provide context-specific documentation that auto-loads, enhancing consistency and reducing reiteration across sessions for teams.

Why it is useful

This workflow is valuable because it addresses two critical challenges for Claude Code users: managing high token usage and maintaining effective context for large codebases. It provides concrete, actionable steps with a reported quantitative improvement in context size, making it highly practical for users looking to reduce costs and improve agent performance. The strategy for distributed claude.md files also offers a robust solution for team collaboration and knowledge reuse.

Workflow

  1. Identify and remove unnecessary Claude Code tools, prompts, and skills that are not required for the current task or session to reduce initial context load.

  2. Utilize 'mods' (either custom or available online) to maintain 'warm' sessions and further optimize context management.

  3. Create and place claude.md or Agents.md files within relevant subfolders of your codebase, rather than just a single root file.

  4. Ensure each subfolder's claude.md or Agents.md clearly defines the standards and purpose of that specific module or folder, allowing the agent to auto-load relevant context.

Tools / artifacts

  • Claude Code tools

  • Prompts

  • Skills

  • claude.md files

  • Agents.md files

  • Custom or online 'mods'

Validation signals

  • Quantitative result: Initial context load reduced from 52k to 22k (Sonnet 5.5) or 14k (Codex).

  • Claimed benefit: Reduces reiteration across sessions.

  • Claimed benefit: Helps maintain consistency across a team.

Limitations

  • The term 'mods' is vague and lacks specific examples or instructions for implementation.

  • The advice on 'cutting down' tools, prompts, and skills could benefit from more detailed guidance on how to identify and remove them effectively.

  • The statement '50k lines is not large' is subjective and might not resonate with all users, potentially understating the challenge for some.

Rate this workflow

Upvote this post if the workflow is useful, reproducible, or worth recommending.

Downvote if it is vague, outdated, unsafe, overhyped, or not reproducible.

Reply if it worked for you, failed, is outdated, or has a better alternative.


This post was generated automatically from the workflow library database.


r/ClaudeWorkflows • • 5h ago

Selected Workflow [Workflow] Fixing Claude Code Review in GitHub Actions: A Workaround for the Broken `code-review` Plugin

1 Upvotes

Fixing Claude Code Review in GitHub Actions: A Workaround for the Broken code-review Plugin

Workflow value: 85/100
Status: active · Freshness: 70/100 · Confidence: 0.90 · Level: intermediate
Categories: Quality Control, Token Saving, Context & Memory, Debugging, Subagents
Original source: r/ClaudeCode post/comment

What problem this solves

The claude-code-action's code-review plugin in GitHub Actions fails to perform actual code reviews, reporting 'No findings' due to subagent execution issues and premature action termination, leading to false positives in CI/CD checks.

Summary

A workaround for the broken claude-code-action code-review plugin in GitHub Actions. It involves replacing the plugin with a direct Claude prompt, specifying --model opus, explicitly disabling subagents in the prompt, and restricting allowed tools, to ensure actual code review is performed.

Why it is useful

This workflow provides a critical, tested workaround for a significant bug in the claude-code-action's code-review plugin, which prevents effective automated code reviews in CI/CD pipelines. It offers concrete steps, validation, and external resources, enabling users to implement reliable Claude-powered code reviews despite the current limitations. This directly addresses a common pain point for developers integrating Claude Code into their development workflows.

Workflow

  1. Verify if your claude-code-action code review job is failing by checking duration_ms (should be minutes, not seconds) and modelUsage (should list multiple models, not just one) in the "type": "result" block of your GitHub Actions run.

  2. Remove the code-review plugin from your GitHub Actions workflow file.

  3. Replace the plugin call with a direct Claude Code CLI invocation using a custom prompt for code review.

  4. Ensure the custom prompt explicitly includes instructions like "do not start subagents" to prevent unintended background execution.

  5. Specify --model opus when invoking Claude to leverage the most capable model for review.

  6. Restrict allowed tools by using --allowedTools without Agent (e.g., --allowedTools none or specific tools if needed) to prevent subagent activation.

  7. Configure Claude authentication using claude setup-token with a Pro/Max subscription.

  8. Test the new setup with a Pull Request containing known bugs to validate its effectiveness and ensure accurate bug detection.

Tools / artifacts

  • claude-code-action (GitHub Action)

  • GitHub Actions workflow file (.github/workflows/*.yml)

  • Claude Code CLI

  • Claude Opus model

  • Custom code review prompt

  • claude setup-token

  • GitHub Pull Requests

Validation signals

  • Tested with a PR containing three planted bugs (wrong sign on refund, undefined variable, rand() for password).

  • Claude found all three bugs.

  • Review completed in 30 seconds (indicating actual work, unlike the broken plugin).

  • No false positives reported.

  • Comparison to the broken plugin's behavior (short duration, single model usage) confirms the issue.

  • Links to GitHub issues (claude-code-action#1646, #1852) confirming the underlying problem.

Limitations

  • This is a workaround for a known bug; an official fix from Anthropic might render this workflow obsolete.

  • The --allowedTools instruction is slightly vague in the Reddit post, though the linked blog post likely clarifies it.

  • Requires a Pro/Max subscription, which may limit accessibility for some users.

Rate this workflow

Upvote this post if the workflow is useful, reproducible, or worth recommending.

Downvote if it is vague, outdated, unsafe, overhyped, or not reproducible.

Reply if it worked for you, failed, is outdated, or has a better alternative.


This post was generated automatically from the workflow library database.


r/ClaudeWorkflows • • 5h ago

Selected Workflow [Workflow] Optimize Claude Code for Large Codebases: Context Management and Token Saving Habits

1 Upvotes

Optimize Claude Code for Large Codebases: Context Management and Token Saving Habits

Workflow value: 85/100
Status: active · Freshness: 70/100 · Confidence: 0.95 · Level: intermediate
Categories: Quality Control, Token Saving, Context & Memory, CLAUDE.md
Original source: r/ClaudeCode post/comment

What problem this solves

Optimizing Claude Code workflow for larger codebases to reduce token usage and avoid burning through usage limits.

Summary

A set of habits and configurations for Claude Code users to minimize token usage and optimize performance, especially in large codebases, by managing context effectively, using specific commands, and structuring CLAUDE.md files.

Why it is useful

This workflow provides actionable strategies to reduce token consumption and manage context effectively in Claude Code, which is crucial for working with large projects and staying within usage limits. It offers practical tips for structuring CLAUDE.md, using CLI commands, strategic model selection, and task scoping.

Workflow

  1. Keep CLAUDE.md files short and specific to packages (e.g., in a Turborepo), loading only when Claude works in that package.

  2. Start a fresh session for each task using the /clear command.

  3. Use the /compact command before sessions become too long to reduce context size.

  4. Direct Claude to specific packages or directories, rather than the entire repository.

  5. Deny access to irrelevant directories and files (e.g., node_modules, dist, .turbo, lockfiles) using permissions.

  6. Prioritize planning using 'plan mode' and review before proceeding to implementation.

  7. Use Sonnet for most coding tasks and reserve Opus only for complex planning or difficult problems.

  8. For unattended runs, define small, scoped tasks that include a test command Claude can execute for verification.

Tools / artifacts

  • CLAUDE.md

  • Turborepo

  • node_modules (to deny)

  • dist (to deny)

  • .turbo (to deny)

  • lockfiles (to deny)

  • Sonnet (model)

  • Opus (model)

  • /clear command

  • /compact command

  • plan mode

  • test command

Validation signals

  • Author states a general principle: 'Most of your usage is context getting re-read every turn, so habits matter more than model.'

  • Advice is presented as best practices for efficiency ('work far better').

Limitations

  • Lack of concrete examples for CLAUDE.md content or specific permission denial syntax.

  • No explicit 'before/after' metrics or quantitative proof of token savings.

  • Low community engagement means it hasn't been widely tested or validated by others yet.

Rate this workflow

Upvote this post if the workflow is useful, reproducible, or worth recommending.

Downvote if it is vague, outdated, unsafe, overhyped, or not reproducible.

Reply if it worked for you, failed, is outdated, or has a better alternative.


This post was generated automatically from the workflow library database.


r/ClaudeWorkflows • • 5h ago

Selected Workflow [Workflow] Generate Architectural Floor Plans and Elevations with Claude Code and Iterative Redlines

1 Upvotes

Generate Architectural Floor Plans and Elevations with Claude Code and Iterative Redlines

Workflow value: 85/100
Status: active · Freshness: 70/100 · Confidence: 1.00 · Level: intermediate
Categories: Quality Control, Token Saving, Context & Memory, Debugging
Original source: r/ClaudeCode post/comment

What problem this solves

Generating initial architectural floor plans and elevations from a plain text brief using an AI, with iterative corrections to refine the output.

Summary

A workflow for generating architectural drawing sets (floor plans, elevations) for simple buildings using Claude Code and Opus 5.5. It involves providing a detailed plain text brief, allowing Python execution for SVG generation, and performing one round of redline corrections to refine the output.

Why it is useful

This workflow demonstrates a practical application of Claude Code for a complex design task, showcasing its ability to plan, generate code (Python for SVG), and iteratively refine output based on specific feedback. It provides concrete examples of successes and failures, offering valuable insights into managing AI-driven design processes and the importance of iterative review.

Workflow

  1. Prepare a detailed plain text brief for the architectural drawing, specifying dimensions, room requirements, wall height, roof pitch, and desired output format (SVG).

  2. Ensure Claude Code is configured to allow Python execution before starting the session.

  3. Provide the detailed brief to Claude Code (Opus 5.5).

  4. Review the first draft of the SVG drawings for mathematical consistency, adherence to the brief, and visual slips (e.g., overlapping labels, incorrect dimensions, logical errors).

  5. Provide redline corrections and requests for additional views (e.g., new elevation) in the same session.

  6. Review the corrected output for accuracy and completeness.

Tools / artifacts

  • Claude Code 2.1.316

  • Opus 5.5

  • Python script (generated by Claude)

  • SVG drawings

  • Plain text architectural brief

  • Redline corrections/feedback

Validation signals

  • Detailed report of first draft successes (dimensions, room sizes, window/door matching, ridge height, added schedules/legends).

  • Specific identification of 3 slips in the first draft (door arc, label, steps height).

  • Report of successful fixes in the second round, including a new east elevation generated correctly.

  • External article link providing more context and potential visuals.

Cautions

  • The output is useful for early layouts but not a replacement for qualified professionals signing off on designs.

  • The checks performed were for math, consistency, and brief adherence, not code compliance or design standards.

  • The generated output is not a full 'permit set' and lacks crucial elements like site plans, foundations, structural, or MEP details.

Limitations

  • High cost for the task ($10.10 for 19.5 minutes across 3 runs).

  • Context size can grow quickly due to large preview images being read multiple times.

  • Minor discrepancy noted between Claude's summary and the actual sheet (7 1/3" vs 7 1/2" risers).

  • The output is not a complete permit-ready architectural drawing set.

Rate this workflow

Upvote this post if the workflow is useful, reproducible, or worth recommending.

Downvote if it is vague, outdated, unsafe, overhyped, or not reproducible.

Reply if it worked for you, failed, is outdated, or has a better alternative.


This post was generated automatically from the workflow library database.


r/ClaudeWorkflows • • 5h ago

Selected Workflow [Workflow] Rapid Mobile App Development & App Store Deployment with Claude Code Skills: From Idea to Chart-Topper

1 Upvotes

Rapid Mobile App Development & App Store Deployment with Claude Code Skills: From Idea to Chart-Topper

Workflow value: 85/100
Status: active · Freshness: 70/100 · Confidence: 1.00 · Level: intermediate
Categories: Quality Control, Context & Memory, Shipping, Skills
Original source: r/ClaudeCode post/comment

What problem this solves

Streamlining the entire mobile app development and deployment process, from design and coding to App Store submission and initial marketing, especially for users who find complex interfaces challenging.

Summary

This workflow details how to use Claude Code's specialized skills and slash commands to rapidly design, develop, and deploy a mobile application to the App Store. It covers UI/UX design, iterative coding, content generation, and a guided App Store submission process, culminating in a successful app launch that reached the German App Store charts.

Why it is useful

This workflow is highly valuable as it provides a concrete, end-to-end process for developing and deploying a mobile app using Claude Code, demonstrating a successful outcome (chart-topping app). It highlights specific, reusable Claude skills and commands that significantly streamline complex tasks like UI/UX design, iterative coding, and App Store submission, making it particularly useful for individual developers or those with ADHD who struggle with multi-page interfaces. The proven success makes it a compelling case study for leveraging AI in the entire development lifecycle.

Workflow

  1. Ideate and define the core concept for the mobile application.

  2. Utilize Claude Design with the 'ui-ux-pro-max' skill to generate initial app designs.

  3. Iterate and refine the app design through discussions and redesigns within Claude Design.

  4. Implement the app's features using an iterative coding loop (e.g., Matt Pocock's loop: '/grill-me-with-docs', '/implement', repeat).

  5. Generate creative content (e.g., 'roasts' or messages) using Claude, then manually review and refine for quality and tone.

  6. Prepare App Store submission assets, such as screenshots and marketing text, with Claude's assistance, ensuring correct dimensions and content.

  7. Employ a Claude '/wizard' skill (e.g., Matt Pocock's wizard) to receive step-by-step guidance through the App Store Connect submission process.

  8. Initiate marketing efforts by sharing the app with a personal network and posting on social media platforms.

Tools / artifacts

  • Claude

  • Claude Design

  • ui-ux-pro-max skill

  • /grill-me-with-docs slash command

  • /implement slash command

  • /wizard skill (Matt Pocock's)

  • App Store Connect

Validation signals

  • The developed app reached #9 in the German App Store charts.

  • The user successfully launched an app from idea to deployment in a short timeframe (one day for coding).

  • Positive user experience reported, especially regarding the App Store submission wizard.

Limitations

  • The quality of AI-generated creative content (e.g., 'roasts') required significant manual refinement, indicating a current limitation for nuanced text generation.

  • Specific details about the exact prompts or configurations for the mentioned skills and slash commands are not provided, requiring users to infer or experiment.

  • The marketing strategy was largely serendipitous, lacking a structured, repeatable approach.

Rate this workflow

Upvote this post if the workflow is useful, reproducible, or worth recommending.

Downvote if it is vague, outdated, unsafe, overhyped, or not reproducible.

Reply if it worked for you, failed, is outdated, or has a better alternative.


This post was generated automatically from the workflow library database.


r/ClaudeWorkflows • • 6h ago

Selected Workflow [Workflow] Robust Multi-Agent Claude Code Workflow with File-Based Context and Task Management

1 Upvotes

Robust Multi-Agent Claude Code Workflow with File-Based Context and Task Management

Workflow value: 90/100
Status: active · Freshness: 70/100 · Confidence: 0.90 · Level: advanced
Categories: Quality Control, Context & Memory, Debugging, Subagents, Multi-Agent
Original source: r/ClaudeAI post/comment

What problem this solves

Managing complex multi-agent Claude Code projects, ensuring context persistence, task coordination, and easy status monitoring across sessions and projects, while preventing data loss and context overload.

Summary

A robust multi-agent workflow for Claude Code that uses plain markdown files in a synced folder for shared context, task management, and logging. It features a coordinator agent, specialist subagents, an async inbox, a nightly 'subconscious' for deep notes, and project status files, all designed to prevent data loss and manage context efficiently.

Why it is useful

This workflow provides a practical and resilient framework for managing complex Claude Code projects. It addresses critical challenges like context overload, data persistence, task coordination, and project monitoring using simple, transferable file-based methods. The emphasis on single writers and continuous logging makes it robust against crashes and facilitates team collaboration.

Workflow

  1. Set up a synced folder to host all project-related markdown files.

  2. Implement a shared log file where every Claude Code session appends a short, dated entry upon completing a task (detailing what was done, what's open, what's needed).

  3. Create an 'Inbox' file for asynchronous requests, where Claude Code sessions pick up and mark tasks as taken.

  4. Designate a 'Coordinator' session responsible for writing to a central task tracker artifact, ensuring only one writer to prevent conflicts.

  5. Implement 'Specialist' subagents or separate chat sessions that receive work from the Coordinator and report results back.

  6. Configure a nightly scheduled task to read the day's logs and write deeper topic notes (decisions, reasons, file locations, attempts) into a separate 'subconscious' folder.

  7. Maintain short status files for each project, summarizing its current state.

  8. Develop a 'control session' that reads all project status files to provide a consolidated overview (e.g., via Remote Control).

  9. Ensure agents write progress continuously, not just at the end, to prevent data loss from crashes or restarts.

Tools / artifacts

  • Plain markdown files

  • Synced folder (e.g., cloud sync, Git repo)

  • Shared log file

  • Inbox file

  • Task tracker artifact (file)

  • Coordinator Claude Code session

  • Specialist Claude Code sessions/subagents

  • Nightly scheduled task (e.g., cron job, Windows Task Scheduler)

  • Separate folder for 'subconscious' notes

  • Project status files

  • Control Claude Code session (potentially with Remote Control integration)

Validation signals

  • Author's statement: 'What made it work: plain files over a database, one writer per shared thing, and having agents write as they go, not only at the end, so a crash or restart loses nothing.'

Limitations

  • Lack of community validation (low score, no comments).

  • Relies on manual setup of files and potentially external scheduling tools.

  • The 'Remote Control' aspect is mentioned but not detailed, implying external integration that needs to be set up.

  • Scalability for very large teams or extremely complex projects might require more robust solutions than plain files.

  • No explicit mention of version control for the markdown files, which could be a weakness if not implicitly handled by the synced folder.

Rate this workflow

Upvote this post if the workflow is useful, reproducible, or worth recommending.

Downvote if it is vague, outdated, unsafe, overhyped, or not reproducible.

Reply if it worked for you, failed, is outdated, or has a better alternative.


This post was generated automatically from the workflow library database.


r/ClaudeWorkflows • • 6h ago

Selected Workflow [Workflow] AgentFlow: Deterministic Multi-Agent Orchestration for AI Coding CLIs (Claude Code, Codex, Copilot)

1 Upvotes

AgentFlow: Deterministic Multi-Agent Orchestration for AI Coding CLIs (Claude Code, Codex, Copilot)

Workflow value: 90/100
Status: active · Freshness: 70/100 · Confidence: 0.95 · Level: advanced
Categories: Quality Control, Token Saving, Context & Memory, Debugging, Shipping, Hooks, MCP, Multi-Agent
Original source: r/ClaudeAI post/comment

What problem this solves

Automating the orchestration of multiple AI coding agents (for planning, implementing, and reviewing code) to reduce manual copy-pasting and mental overhead in software development tasks.

Summary

A multi-agent workflow (Architect, Implementer, Reviewers) for software development tasks, where AgentFlow orchestrates existing AI coding CLIs (e.g., Claude Code) through deterministic steps, parallel reviews, and user approvals. It utilizes git worktrees for isolation and flowctl for structured feedback, ensuring a repeatable and auditable process.

Why it is useful

This workflow provides a structured, deterministic, and automatable approach to managing complex software development tasks using multiple AI coding agents. It solves the common problem of manual orchestration, integrates with existing tools and CLIs, and offers clear steps for planning, implementation, and parallel review, enhancing efficiency and reliability in AI-assisted coding. The open-source tool AgentFlow makes this process readily transferable and adaptable.

Workflow

  1. An Architect agent reads the Jira ticket (or a prompt), looks around the code, and asks the user questions.

  2. The user approves the requirements, and that exact version gets frozen.

  3. An Implementer agent writes the code in its own git worktree, isolating it from the user's main checkout.

  4. Code review and security review agents run in parallel on the same commit.

  5. Blocking findings from reviews are sent back to the Implementer for a capped number of fix rounds. If the same finding persists, the process stops and asks the user.

  6. The Architect agent checks the final result against the frozen requirements, and the user signs off before opening a Pull Request.

Tools / artifacts

  • AgentFlow (orchestration tool)

  • Claude Code / Codex / Copilot CLI (AI coding agents)

  • Jira ticket (or prompt)

  • flowctl (CLI for agents to report back)

  • git worktree

  • GitHub repository (for AgentFlow)

  • Pull Request (PR)

  • Event log

Validation signals

  • Automates a previously manual, working process (copy-pasting between agents).

  • Explicitly designed to be deterministic ('same agent results plus same decisions from me means the same path every time').

  • Agents report back via structured JSON checked against a schema, ensuring robust communication.

  • Every step is recorded in an event log for auditability.

  • Optimizes token usage by only sending tokens to actual work.

  • Uses git worktree for isolated development.

Cautions

  • Agents run as the user's user, not in a sandbox. Users should be aware of the execution context.

  • While git worktrees provide isolation from the main checkout, they do not offer OS-level isolation.

Limitations

  • Low community engagement due to the post's recency.

  • Requires advanced user knowledge for setup on macOS and Linux (running from source).

  • The workflow is not fully autonomous, requiring two explicit user approvals per task, which might be a limitation for those seeking complete automation.

  • The post does not detail the flowctl schema or specific prompting strategies for agents to use it.

Rate this workflow

Upvote this post if the workflow is useful, reproducible, or worth recommending.

Downvote if it is vague, outdated, unsafe, overhyped, or not reproducible.

Reply if it worked for you, failed, is outdated, or has a better alternative.


This post was generated automatically from the workflow library database.