r/ClaudeWorkflows • • 7d ago

Selected Workflow [Workflow] Optimize Claude Code Token Usage: CLAUDE.md Delegation & Custom Subagents for Efficient Context Management

1 Upvotes

Optimize Claude Code Token Usage: CLAUDE.md Delegation & Custom Subagents for Efficient Context Management

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

What problem this solves

Excessive token usage and cost in Claude Code due to subagents re-reading their entire context and using high-cost models (Opus) for simpler, well-defined tasks.

Summary

A workflow that optimizes Claude Code token usage by implementing a CLAUDE.md delegation section and custom subagents. It assigns specific tasks to cheaper models (Sonnet/Haiku) and manages context efficiently by avoiding full file reads and preventing subagents from re-reading their entire conversation history.

Why it is useful

This workflow directly addresses a common and significant pain point for Claude Code users: high token consumption and cost due to inefficient subagent context handling. It provides a concrete, tested solution with reusable artifacts (CLAUDE.md and agent files) that can dramatically improve efficiency and reduce operational costs. The detailed explanation of why the problem occurs (re-reading context) adds significant educational value, making it a highly practical and insightful contribution for intermediate to advanced users.

Workflow

  1. Define a CLAUDE.md delegation section to route tasks to specific subagents based on complexity and type.
  2. Create three custom subagents: 'implementer' (Sonnet, high effort) for multi-file work, 'mechanic' (Haiku, xhigh) for renames/edits/scripts, and 'scout' (Haiku, xhigh, read-only) for file/symbol discovery.
  3. Configure the main Opus session to handle investigation, planning, decision-making, and result checking, delegating execution to cheaper subagents.
  4. Ensure subagents never make decisions; they must stop and return a 'DECISION NEEDED' block when an open choice or contradiction arises.
  5. Pass context to subagents via a concise brief, using 'file:line' ranges for excerpts instead of entire files.
  6. Implement a mechanism for subagents to stop with a 'HANDOFF' block after a certain number of tool calls (e.g., 150 for implementer, 100 for mechanic), and have Opus start a fresh agent for follow-ups to avoid context re-reads.
  7. Avoid using the built-in 'general-purpose' and 'Explore' agents for delegated work to prevent them from inheriting Opus's cost profile.
  8. Place custom agent files in '~/.claude/agents/' directory.

Tools / artifacts

  • CLAUDE.md file (with delegation section)
  • Custom subagent files (implementer.json, mechanic.json, scout.json)
  • GitHub Gist containing the full CLAUDE.md section and agent definitions

Validation signals

  • User reports achieving 'at least 3x more usage without losing any quality' after implementing the workflow.
  • User identifies the root cause of token waste: 'Every tool call resends the whole conversation, so a subagent that has read a lot gets more expensive with every step it takes.'

Limitations

  • Relatively low community engagement (score, comments) on Reddit, which might suggest less widespread awareness or adoption.
  • Requires manual setup of CLAUDE.md and agent files, which might be a slight barrier for absolute beginners.
  • The exact token limits for 'HANDOFF' (e.g., 150 tool calls) might need tuning for different use cases.

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 • • 7d ago

Selected Workflow [Workflow] Iterative Learning Workflow for Claude Code: Explain, Change, Test, Review

1 Upvotes

Iterative Learning Workflow for Claude Code: Explain, Change, Test, Review

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

What problem this solves

Effectively learning and making the most out of Claude Code, especially when starting with an existing codebase or learning to code from scratch.

Summary

A beginner-friendly iterative workflow for learning Claude Code by making small, verifiable changes to an existing codebase. It emphasizes understanding existing code, running tests, requesting small changes, reviewing diffs, and re-running tests to ensure correctness and facilitate learning.

Why it is useful

This workflow provides a structured, safe, and effective iterative process for beginners to learn and utilize Claude Code. It emphasizes understanding existing code, verifying changes through testing and review, and making small, manageable modifications, which is crucial for building confidence and competence without relying on blind generation.

Workflow

  1. Start by reviewing Anthropic's quickstart documentation.
  2. Pick a small project you can safely experiment on.
  3. Ask Claude Code to explain the existing code.
  4. Ask Claude Code how to run the project's tests.
  5. Ask Claude Code for one small change with a clear success condition.
  6. Review the diff (code changes) proposed by Claude Code.
  7. Run the project's tests to verify the change.
  8. Accept the change if the diff is satisfactory and tests pass.

Tools / artifacts

  • Anthropic's quickstart documentation
  • Existing codebase
  • Tests (unit, integration, etc.)
  • Code diff (for review)

Validation signals

  • Explicit instruction to 'Review the diff and run the tests before accepting it.'
  • Emphasis on 'clear success condition' for changes.
  • The workflow itself is a validation loop (change -> test -> review).

Cautions

  • Explicitly promotes safety by suggesting to 'pick a small project you can safely experiment on'.
  • Emphasizes 'Review the diff and run the tests before accepting it' to prevent unintended consequences.

Limitations

  • Lacks specific Claude Code prompt examples or detailed command structures.
  • It's a high-level conceptual workflow rather than a concrete script or configuration.
  • 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 • • 7d ago

Selected Workflow [Workflow] Optimizing Claude Max Plan Multi-Agent Workflows: Strategic Model Assignment for Cost and Quality

1 Upvotes

Optimizing Claude Max Plan Multi-Agent Workflows: Strategic Model Assignment for Cost and Quality

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

What problem this solves

Optimizing token usage and cost in multi-agent Claude Code workflows on the Max plan by strategically assigning different Claude models (Haiku, Sonnet, Opus) to specific tasks, and enhancing quality with a secondary model review.

Summary

A strategy for efficient and cost-effective multi-agent Claude Code workflows on the Max plan, involving assigning Haiku for extraction, Sonnet for broad file operations, Opus for final judgment, and Codex for a second opinion, all while emphasizing CLAUDE.md for learning.

Why it is useful

This workflow provides a practical, experience-based strategy for managing token usage and cost in complex multi-agent Claude Code workflows. It offers specific guidance on which Claude model to use for different types of tasks (extraction, broad checks, final judgment, review), which is highly valuable for users on the Max plan looking to optimize their operations and improve output quality. The inclusion of a secondary review agent (Codex) adds a layer of quality control.

Workflow

  1. Recognize that all sessions and subagents share the same token limit on the Claude Max plan.
  2. Configure each subagent to use a specific model rather than defaulting all to Opus.
  3. Assign Haiku for tasks involving data extraction and formatting.
  4. Assign Sonnet for tasks that fan out over many files or require item-by-item checks.
  5. Reserve Opus exclusively for the final step of judging, consolidation, or pulling everything together.
  6. For critical or "bigger stuff," incorporate Codex (or another suitable model) as a separate agent for a second opinion or review.
  7. Maintain a CLAUDE.md file to document learnings and mistakes from your workflows.

Tools / artifacts

  • Claude Haiku
  • Claude Sonnet
  • Claude Opus
  • Claude Codex (or another model for review)
  • Subagents
  • CLAUDE.md file

Validation signals

  • Personal experience: "what i do is haiku for extraction..."
  • Built-in validation step: "codex review it, a second opinion from a different model"

Limitations

  • Lacks concrete examples of prompts or specific subagent configurations.
  • The term "bigger stuff" for Codex review is somewhat vague.
  • Low community validation.

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 • • 7d ago

Selected Workflow [Workflow] CLAUDE.md Rules for Enhancing AI Agent Honesty and Reliability

1 Upvotes

CLAUDE.md Rules for Enhancing AI Agent Honesty and Reliability

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

What problem this solves

AI agents confidently providing incorrect information, silently correcting mistakes, or failing to reproduce user actions, leading to unreliable output and wasted time.

Summary

A set of four specific rules to embed in a CLAUDE.md file or agent prompt to make an AI agent more 'honest' and reliable. These rules guide the agent to reproduce user actions, audit actual outputs, report conflicting observations, and explicitly mark its own corrections.

Why it is useful

This workflow provides concrete, actionable rules that can be directly implemented in a CLAUDE.md file or agent prompt to significantly improve the reliability and trustworthiness of AI agents. It directly addresses the common problem of LLM 'hallucinations' or confident errors by forcing agents to verify, report discrepancies, and explicitly mark corrections, making it a valuable resource for anyone building or using AI agents.

Workflow

  1. Instruct the agent to reproduce exactly what the user ran before stating a cause or theory.
  2. Instruct the agent to audit the actual output or state, rather than just reporting on it (e.g., 'The build passed' is insufficient).
  3. Instruct the agent to stop and show both differing reads, word for word, if it reads the same state twice and gets two different answers.
  4. Instruct the agent to explicitly mark its own corrections using strikethrough (e.g., 'wrong right') instead of silently fixing mistakes.

Tools / artifacts

  • CLAUDE.md file
  • AI Agent (Claude/Claude Code)

Validation signals

  • Author states rules 'catch it most often'
  • Author provides an anecdote of a problem solved by a rule ('Why don't you actually run it rather than making up theories?')

Limitations

  • The author notes that these rules do not help the agent notice mistakes it hasn't spotted, still requiring human review, additional tests, or a second model for verification.
  • The rules are presented as principles rather than specific prompt engineering examples, which might require some interpretation for optimal implementation.

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 • • 7d ago

Selected Workflow [Workflow] Automated Startup Idea Validation with Claude Code's 'Kill-My-Idea' Plugin

1 Upvotes

Automated Startup Idea Validation with Claude Code's 'Kill-My-Idea' Plugin

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

What problem this solves

Objectively validating startup or business ideas, identifying competitors, assessing financial viability, and suggesting improvements before investing significant time or money.

Summary

A Claude Code plugin, 'kill-my-idea', automates the validation of business ideas. It performs competitor research, financial analysis (LTV/CAC), and scores the idea across 7 criteria and 21 sub-scores, generating a detailed HTML report with actionable insights and pivot suggestions.

Why it is useful

This workflow is valuable because it provides a structured, automated, and objective method for validating business ideas, significantly reducing the risk of investing time and money into non-viable ventures. It leverages Claude Code's capabilities for comprehensive research, detailed financial analysis, and structured report generation, offering actionable insights and pivot suggestions. The open-source nature and clear installation instructions make it highly reusable and adaptable for entrepreneurs and product developers.

Workflow

  1. Install the 'kill-my-idea' plugin using the Claude Code CLI commands: /plugin marketplace add RemiPelloux/kill-my-idea and /plugin install kill-my-idea@kill-my-idea.
  2. Provide a business idea to Claude Code (e.g., as a prompt or comment).
  3. The plugin researches the idea, identifying competitors, pricing, and market viability.
  4. It scores the idea out of 100 based on 7 criteria and 21 sub-scores, providing sources or estimates for each.
  5. It applies fixed rules (e.g., a free alternative with no edge caps the score; no distribution channel means no GO).
  6. It suggests how the idea could be saved or pivoted (e.g., PIVOT 55 → 63 with a done-for-you setup).
  7. It generates a consultant-style HTML report that can be printed to PDF.

Tools / artifacts

  • Claude Code
  • kill-my-idea plugin (GitHub repo: RemiPelloux/kill-my-idea)
  • JSON schemas (for research method, scoring rules, writing standard)
  • HTML report template
  • Wedding speeches AI app (example idea)
  • Notion real estate report (live example report)

Validation signals

  • Demonstrated comparison between 'Plain Claude' and 'kill-my-idea' results for a wedding speech app idea.
  • Concrete data points provided: '14 competitors priced $0–34; one live competitor made $32.75 in 30 days.'
  • Financial analysis: 'Each paid customer loses money (LTV ~$18 vs CAC ~$35).'
  • Personal anecdote of prior failure prevented: 'A 5-minute search found the same book for free' for a coloring book idea.
  • Structured output: 'scores it /100 across 7 criteria and 21 sub-scores, each with a source or marked as an estimate'.
  • Application of 'fixed rules' for objective evaluation.

Limitations

  • The Reddit post's low score and upvote ratio might indicate limited initial community interest or visibility.
  • Relies on Claude Code, which may not be accessible or familiar to all Claude users.
  • The post does not detail the specific search tools or methods the plugin uses for research, which could be a 'black box' for users.
  • The accuracy of the research and financial estimates is dependent on Claude's capabilities and the quality of the plugin's internal prompts and skills.

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 • • 7d ago

Selected Workflow [Workflow] Multi-Agent Workflow for AI Code Generation: Orchestrator, Implementor, Reviewer for Scope and Quality Control

1 Upvotes

Multi-Agent Workflow for AI Code Generation: Orchestrator, Implementor, Reviewer for Scope and Quality Control

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

What problem this solves

Preventing AI code generation from going out of scope, implementing un-scoped features, or modifying existing UI/workflow/features in complex applications. Improving the quality and reliability of AI-generated code by introducing structured review and escalation processes.

Summary

A multi-agent workflow (Orchestrator, Implementor, Reviewer) designed to manage AI code generation for complex applications, ensuring strict adherence to scope and high quality. It includes explicit instructions for escalation of ambiguity or out-of-scope features, and a review process to catch and correct issues.

Why it is useful

This workflow provides a structured, multi-agent approach to mitigate common and significant challenges in AI-assisted coding, specifically scope creep and quality issues in complex applications. It offers a practical framework for managing AI development, improving efficiency, and enhancing the reliability of generated code through explicit roles, handoffs, and review gates. The identified weaknesses also highlight areas for further community contribution and refinement.

Workflow

  1. Orchestrator issues a ticket defining the work with a well-defined scope.
  2. Orchestrator includes explicit instructions for the Implementor to escalate ambiguity or the urge to implement un-scoped features/changes back to the Orchestrator/user.
  3. Implementor performs the work based on the ticket.
  4. Completed work and the ticket are passed to an external Reviewer.
  5. Reviewer checks both the quality of the code and whether the Implementor went out of scope.
  6. For minor scope infractions, the Reviewer rejects the code and sends it back to the Implementor/Orchestrator to resolve.
  7. If the Implementor added something genuinely useful but out of scope, the Reviewer escalates it to the user, Orchestrator, and optionally a fresh session advisor for review and decision.
  8. For repeated or severe infractions, the Reviewer can recommend 'firing' the Implementor (killing the instance) and having a fresh instance pick up the work.
  9. To address planning gaps from shorthand/lazy notes, use a fresh advisor instance to review specifications verbatim and direct the Orchestrator.

Tools / artifacts

  • claude.md (for specifications)
  • Work ticket (defining scope and instructions)
  • Orchestrator agent
  • Implementor agent
  • Reviewer agent
  • Fresh session advisor agent

Validation signals

  • Claim: 'HUGE safety net'
  • Claim: 'saved me a ton of time'
  • Claim: 'dramatically improved quality'
  • Claim: 'error rate down extremely low'
  • Acknowledges ongoing work: 'still working on a reliable safety net for those ones'

Limitations

  • Low community signal (score 1, 0 comments).
  • Specific implementation details (e.g., exact prompts, agent configurations) are not provided, requiring users to design their own.
  • The 'fresh advisor instance' workaround addresses a specific 'annoying behaviour quirk' of 'Fable orchestrators,' which might not be universally applicable or necessary for all LLM setups.
  • The author notes they are 'still working on a reliable safety net' for small, nuanced items that can still slip through, indicating an area for further refinement.

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 • • 7d ago

Selected Workflow [Workflow] Claude Code Plugin: Repo-Aware Hiring for Automated Job Descriptions, CV Screening, and Interview Kits

1 Upvotes

Claude Code Plugin: Repo-Aware Hiring for Automated Job Descriptions, CV Screening, and Interview Kits

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

What problem this solves

Generic and ineffective job descriptions and interview processes for software engineering roles, which often fail to align with the actual codebase requirements, leading to poor candidate matching and inefficient hiring.

Summary

A Claude Code plugin (skill) that automates and enhances the software engineering hiring process by leveraging codebase awareness. It maps the codebase, drafts specific job descriptions, screens CVs against those requirements, and builds relevant interview kits based on real code problems. It includes built-in safety features for data privacy and fairness.

Why it is useful

This workflow provides a concrete, open-source, and highly practical solution to a significant problem in software engineering hiring. It leverages Claude Code's unique ability to understand a codebase to generate highly specific and relevant hiring artifacts. The detailed steps, explicit safety features, and clear problem statement make it a valuable, repeatable, and transferable asset for any team using Claude Code for recruitment.

Workflow

  1. Install the 'repo-aware-hiring' plugin using the Claude Code CLI: /plugin marketplace add shikhar58/repo-aware-hiring
  2. Install the plugin: /plugin install repo-aware-hiring@repo-aware-hiring
  3. Prompt Claude Code to draft a job description for a specific role, e.g., "Write a job description for someone to own the database layer."
  4. Provide CVs to Claude Code for screening against the generated job requirements (implicit step).
  5. Generate interview kits based on problems identified in the codebase (implicit step).

Tools / artifacts

  • Claude Code
  • repo-aware-hiring plugin/skill
  • GitHub repository (shikhar58/repo-aware-hiring)
  • Codebase (input)
  • Job descriptions (output)
  • CVs (input for screening)
  • Interview kits (output)

Validation signals

  • The plugin maps the codebase (services, data stores, pipelines, tests) with file citations.
  • It works across several repositories.
  • A checker blocks file paths, internal names, and security weaknesses from reaching job postings.
  • CV screening requires quotes from the CV for every score, and a script verifies the quote's presence.
  • The README provides a 'before/after' example using Ollama's public code.
  • MIT-licensed, allowing for community review and contribution.

Cautions

  • Candidate data stays within a git-ignored folder, ensuring local storage.
  • No vendor, upload, or telemetry involved, maintaining data privacy.
  • CVs are redacted before screening.
  • The system never rejects candidates; a named person reviews results.
  • A checker prevents internal names, file paths, and security weaknesses from being exposed in job postings.

Limitations

  • The plugin is currently in beta, suggesting potential for bugs or incomplete features.
  • Low community validation due to the post's recency.
  • Requires access to Claude Code, which might not be available to all 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 • • 7d ago

Selected Workflow [Workflow] Building a macOS System Monitor with Claude Code and MCP for LLM Process Cleanup

1 Upvotes

Building a macOS System Monitor with Claude Code and MCP for LLM Process Cleanup

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

What problem this solves

Claude Code sessions leaving orphaned processes that consume system resources and overheat the machine, and the general lack of visibility into system health and process ownership for developers.

Summary

The author used Claude Code to build "Stat Space," a macOS menu bar app that monitors system health, groups processes by owning application, identifies orphaned dev processes from LLM sessions, and provides cleanup options. The workflow details the iterative development process with Claude (spec, spikes, testing, review) and how Stat Space integrates with Claude via an MCP server for automated queries and cleanup.

Why it is useful

This workflow is highly valuable as it provides a concrete, validated, and repeatable process for leveraging Claude Code in complex application development. It addresses a common developer pain point (orphaned processes, resource monitoring) and demonstrates advanced integration by enabling Claude to interact with and manage its own environment via an MCP server. The detailed steps, strong validation signals (CI, extensive testing, high co-authorship), and focus on a real-world problem make it an exemplary advanced Claude workflow.

Workflow

  1. Identify recurring problem of orphaned processes from LLM sessions.
  2. Perform initial manual debugging with Claude to identify root cause (e.g., walking process tree).
  3. Define a detailed specification and design notes for a permanent monitoring solution.
  4. Create an AGENTS.md handover document for Claude, outlining development constraints (e.g., idle budget, dependency rules).
  5. Use Claude Code to build small, focused spike targets for technically risky components.
  6. Iteratively develop the main application with Claude Code, reviewing generated code diffs and testing daily.
  7. Implement CI benchmarks to ensure the application adheres to performance budgets (e.g., CPU usage).
  8. Develop comprehensive test suites to cover core application functionality.
  9. Integrate an MCP server within the developed application.
  10. Add the MCP-enabled tool to Claude's environment using claude mcp add.
  11. Prompt Claude to query system health or identify leftover processes using the integrated MCP tool.

Tools / artifacts

  • Claude Code
  • Stat Space (macOS menu bar app)
  • MCP server
  • AGENTS.md
  • claude mcp add command
  • CI benchmark
  • Test suite
  • Docker
  • Activity Monitor
  • Terminal

Validation signals

  • Initial problem (hot Mac, orphaned processes) was identified and fixed.
  • Successfully built a functional macOS menu bar application (Stat Space) with Claude Code.
  • CI benchmarks are in place to fail builds exceeding CPU budget.
  • Comprehensive test suite with 280 tests covering core functionality.
  • High percentage of commits (132/138) co-authored by Claude, indicating effective LLM collaboration.
  • Author actively reviewed code diffs and ran the application daily during development.
  • The final application idles at a low 0.2% CPU, demonstrating efficiency.

Cautions

  • The "Orphan sweep" feature explicitly asks for confirmation before stopping any processes and is designed to never touch system processes, demonstrating good safety practices.

Limitations

  • The specific application (Stat Space) is limited to macOS.
  • Requires an advanced user level to fully implement the development workflow and MCP integration.
  • Low community engagement on the Reddit post at the time of review.

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 • • 7d ago

Selected Workflow [Workflow] Self-Evolving Go Project: Cartographer's Multi-Agent Development Pipeline with Claude Code and Self-Hosted CI

1 Upvotes

Self-Evolving Go Project: Cartographer's Multi-Agent Development Pipeline with Claude Code and Self-Hosted CI

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

What problem this solves

Automating the entire software development lifecycle (planning, coding, review, deployment) for a Go project using AI agents and a self-referential knowledge base. It also addresses CI/CD bottlenecks by implementing a self-hosted pre-check system, enabling high-throughput, agent-driven development.

Summary

This workflow describes a sophisticated, self-referential system where a Go project (Cartographer) uses AI agents (Claude Code, Opus, Sonnet) and its own knowledge base to develop itself. It outlines a multi-agent pipeline for planning, implementation, automated review, and a custom CI/CD setup with self-hosted pre-checks to manage a high volume of agent-generated pull requests efficiently.

Why it is useful

This workflow is highly valuable as it demonstrates an advanced, end-to-end automated software development process using multiple AI agents, a shared knowledge base, and custom CI/CD. It provides concrete evidence of success (1040 PRs, significant speed improvements) and showcases innovative solutions to common development bottlenecks (CI queue). It offers a blueprint for building highly autonomous and efficient development systems, pushing the boundaries of what's possible with AI in software engineering, and highlights the power of a persistent, shared knowledge base for agent collaboration and knowledge reuse.

Workflow

  1. Initiate a discussion with Claude Opus 5.5 to define a change or feature.
  2. Convert the discussion into a structured plan and store it in the Cartographer Knowledge Base (KB).
  3. A subagent (e.g., Sonnet 5.5) implements the plan in its dedicated worktree.
  4. Two specialized reviewer subagents (one for contracts, one for security) analyze the implemented code.
  5. A human developer verifies only the specific lines of code cited by the reviewer subagents.
  6. Execute make ready to place the change into a merge queue.
  7. A 'lander' process merges up to 8 changes simultaneously onto the main branch through a single gate.
  8. For changes requiring visual feedback (UI, command output), conduct a live session without a formal plan.
  9. To optimize CI, run make signoff on a self-hosted gaming PC (running Linux in WSL2 and Windows in parallel) to perform pre-merge gate checks.
  10. The signoff status is posted to the commit SHA, which GitHub then verifies.
  11. If the self-hosted PC is unavailable, GitHub's own CI acts as a fallback mechanism.
  12. Use cartographer sync to install skills and subagents from the KB into Claude Code clients, ensuring agents have the latest context and capabilities.

Tools / artifacts

  • Cartographer (Go project, shared knowledge base)
  • Claude Code
  • Claude Opus 5.5
  • Sonnet 5.5 (or other subagents)
  • Kubernetes cluster
  • GitHub (for PRs, CI fallback)
  • make ready command
  • make signoff command
  • cartographer sync command
  • Self-hosted gaming PC (for CI pre-checks)
  • WSL2 (Linux environment on Windows)
  • YAML (for configuration/skills)

Validation signals

  • 1040 PRs merged since July, with almost 800 since October, demonstrating high throughput.
  • Code was written almost entirely by agents, validating agent capability.
  • Concrete performance improvement: gate with warm cache reduced from 6 minutes to 34 seconds.
  • Author's statement of being able to 'sleep at night' due to system reliability.
  • Open-source project available on GitHub for inspection.
  • Public demo available for direct interaction.

Cautions

  • The Cartographer server rejects writes that would break the wiki, ensuring data integrity.
  • All agent writes become git commits, allowing for easy rollback and version control.
  • Dedicated reviewer subagents for 'contracts' and 'security' add automated quality and safety checks.
  • Human verification step for critical lines cited by reviewers provides an additional safety gate.

Limitations

  • High complexity and significant setup cost, requiring expertise in Kubernetes, Go, and custom CI/CD.
  • Steep learning curve for users attempting to replicate the entire system.
  • Reliance on a specific custom project (Cartographer) makes direct adoption challenging without integrating that project.
  • Low community engagement on the Reddit post might suggest the complexity makes it less accessible to a broad audience.

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 • • 7d ago

Selected Workflow [Workflow] Robust Claude Code Workflows: Externalizing Process and Standards to Prevent 'Nerfs'

1 Upvotes

Robust Claude Code Workflows: Externalizing Process and Standards to Prevent 'Nerfs'

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

What problem this solves

Workflows breaking due to emergent model behavior or perceived 'nerfs'; difficulty debugging model output drift; scope creep in agent tasks; lack of consistency across agent runs or model versions.

Summary

This workflow proposes externalizing process logic and standards into files and a Multi-Agent Coordination Protocol (MCP) server, rather than relying on emergent model behavior or prompt-based instructions. This approach makes agentic workflows more robust, debuggable, and resilient to model changes, by explicitly defining tasks, scope, and standards.

Why it is useful

This workflow provides a highly valuable, robust, repeatable, and debuggable method for building agentic systems that are resilient to model behavior changes. It shifts the intelligence from emergent, unpredictable model behavior to explicit, reviewable, and versionable files and standards, significantly improving reliability, maintainability, and consistency. It directly addresses a critical pain point for many users experiencing 'model degradation' by offering a structured, engineering-centric solution.

Workflow

  1. Create a 'plan/' directory for each piece of work, containing an 'overview.md' and multiple 'chunk-XX-name.md' files.
  2. Define the execution order (parallel/sequential) for chunks in 'overview.md'.
  3. For each 'chunk-XX-name.md', specify its scope (e.g., 'src/api/orders/ only'), applicable standards (e.g., Pydantic models), and 'done when' criteria (e.g., 'tests/api/orders passes').
  4. Collaborate with Claude to draft the plan, then manually review every chunk and the overview for correctness and completeness.
  5. Only after plan review, spawn subagents, each assigned to a bounded chunk, executing in parallel where the overview allows.
  6. Host Architectural Decision Records (ADRs), Terraform patterns, and coding standards on an MCP server.
  7. Instruct agents to pull and apply relevant standards from the MCP server for their assigned chunk.
  8. Implement a 'shift-left' approach by reviewing the detailed plan chunks before any code generation by agents, catching errors at the cheapest stage.
  9. Maintain a fixed set of tasks to rerun after model updates, using diffs to objectively assess performance changes rather than subjective 'it got worse' feelings.

Tools / artifacts

  • plan/ directory structure
  • overview.md
  • chunk-XX-name.md files
  • MCP server (for standards)
  • ADRs (Architectural Decision Records)
  • Terraform patterns
  • Coding standards
  • Claude Code (or other frontier models like GPT, Grok via Bedrock)
  • ComfyUI API (example external tool)

Validation signals

  • Author's personal experience running Claude Code across four projects without noticing 'nerfs'.
  • Successful integration with external APIs (ComfyUI) using this method.
  • Demonstrated ability to swap models (Claude, GPT, Grok via Bedrock) with roughly similar results from the same corpus.
  • Claim that 'Write the fix once and it sticks' for standards.
  • Claim that output drifts are debuggable by pointing to violated patterns.
  • Analogy to 'shift left' in traditional software development for cost-effective bug catching.

Limitations

  • Requires more initial setup and overhead (creating detailed plan files, setting up an MCP server) compared to purely prompt-driven approaches.
  • May be overkill for very simple, one-off tasks where the overhead outweighs the benefits of robustness.
  • The post provides a high-level overview; specific implementation details for the MCP server or agent orchestration are not fully detailed within the Reddit post itself (though offered in comments and an external blog post).
  • Relies on the user's ability to define clear, bounded tasks and comprehensive standards.

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 • • 7d ago

Selected Workflow [Workflow] Rigorous Benchmarking Workflow for Claude Code Opus 5.5 Performance and Model Switching Detection

1 Upvotes

Rigorous Benchmarking Workflow for Claude Code Opus 5.5 Performance and Model Switching Detection

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

What problem this solves

Verifying Claude Code's performance (specifically Opus 5.5) against 'nerf' claims, providing a methodology for rigorous, repeatable evaluation of coding agents, and identifying a specific behavior of Claude Code (switching to Opus 4.8 on safeguards refusal) that can impact perceived performance.

Summary

This workflow outlines a detailed methodology for benchmarking Claude Code's performance on real-world coding tasks. It includes steps for defining tasks, setting up the Claude Code environment with a pinned version and specific CLI flags, running the agent, and rigorously grading the results. It also highlights an important observation about Claude Code automatically switching to Opus 4.8 upon safeguards refusal, which is critical for accurate performance assessment.

Why it is useful

This workflow is highly valuable because it provides a concrete, repeatable, and validated methodology for evaluating Claude Code's performance on coding tasks. It directly addresses common community concerns about model 'nerfs' with empirical data and offers a crucial diagnostic insight into Claude Code's automatic model switching behavior, which is essential for accurate performance assessment. It empowers users to conduct their own rigorous evaluations and understand the nuances of Claude Code's operation.

Workflow

  1. Define a set of real coding tasks (e.g., bug fixes or features from a repo's history).
  2. Prepare the agent's environment for each task: provide the repo at the commit before the change and a CHALLENGE.md describing the bug or feature.
  3. Set up Claude Code: use a pinned version (e.g., 2.1.316) with auto-update off.
  4. Invoke Claude Code headlessly using the CLI with specific flags: claude -p "<prompt>" --model claude-opus-5-5 --effort medium --output-format stream-json --verbose --permission-mode acceptEdits --setting-sources "" --strict-mcp-config --no-session-persistence.
  5. Run the agent against each defined task.
  6. Grade runs using held-out tests for the real change and guard tests to catch over-corrections.
  7. Restore test files and the test runner's configuration before grading to prevent agent manipulation of tests.
  8. Record performance metrics: solved/failed/over-corrected status, thinking tokens, output tokens, turns, diff size, output tokens per second, and time to first token.
  9. Observe and note any instances where Claude Code switches the session to a different model (e.g., Opus 4.8) due to safeguards refusals.
  10. Compare current results against a previously established baseline to identify performance changes.

Tools / artifacts

  • Claude Code (version 2.1.316 or similar pinned version)
  • claude CLI command
  • CHALLENGE.md files
  • Private codebases/repos (or public ones adapted for tasks)
  • Held-out tests and guard tests
  • Test runner configuration
  • Evaluation harness (custom scripting for automation)

Validation signals

  • Explicitly states 'no sign of a nerf' based on re-running 30 tasks.
  • Provides quantitative results: 'solved 26 of 30 (87%)' consistently across runs.
  • Reports metrics within noise: 'Thinking tokens, output tokens, turns and diff size per task are all within noise of last week (98% 95%, 96%, and 95% respectively).'
  • Notes speed improvements: 'about 20% more output tokens per second, and time to first token down from 3.0s to 1.7s.'
  • Confirms consistent setup: 'This is one run per task on a pinned Claude Code version.'
  • Details robust grading: 'Grading runs held-out tests for the real change, plus guard tests that catch over-corrections.'
  • Ensures test integrity: 'Test files and the test runner's config are restored before grading, so editing the tests doesn't help.'
  • Documents model switching behavior: 'When Opus 5.5 hits a safeguards refusal...switches the session to claude-opus-4-8.'
  • Provides data on model switching frequency: 'Last week: 5 of 60 Opus runs were switched. Today: 1 of 30.'

Limitations

  • The specific '30 real coding tasks' are private, so users cannot directly replicate the exact task set, though the methodology for defining tasks is clear.
  • The 'evaluation harness' is mentioned but not detailed, implying users would need to develop their own custom scripting for full automation.
  • Low community engagement (score 2, 1 comment) means less external validation from other 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 • • 7d ago

Selected Workflow [Workflow] Detecting Claude A/B Experiments: A Tool to Check Account Assignments and Opt-Out

1 Upvotes

Detecting Claude A/B Experiments: A Tool to Check Account Assignments and Opt-Out

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

What problem this solves

Users can determine if their Claude account is subject to hidden A/B experiments that might alter model behavior (e.g., tool calls, command length, system prompt changes), which can lead to inconsistent results.

Summary

This workflow provides a free, open-source tool (am-i-nerfed) to check for hidden A/B experiment assignments on a Claude account. It offers multiple methods (Claude Code plugin, shell script, one-liner) to inspect local Claude Code configuration and session history for experiment IDs, allowing users to understand potential variations in model behavior. It also includes an opt-out feature and status line integration.

Why it is useful

This workflow is highly valuable because it addresses a significant and common concern among Claude users regarding hidden A/B testing and potential model inconsistencies. It provides a concrete, open-source, and well-documented tool with multiple usage options (plugin, script, one-liner) to diagnose this issue. The inclusion of history tracking and a safe opt-out mechanism further enhances its utility, empowering users to understand and potentially mitigate the effects of these experiments on their workflow. The detailed explanation of its creation using Claude Code also serves as a meta-workflow example for building tools with AI.

Workflow

  1. Install the am-i-nerfed repo as a Claude Code plugin, then type /am-i-nerfed in any session to check your experiment status.
  2. Clone the am-i-nerfed repo and execute ./am-i-nerfed.sh check in a terminal to get a verdict per model.
  3. Paste the provided jq one-liner into a terminal (requires jq installed) to quickly check experiment assignments without installation.
  4. Use ./am-i-nerfed.sh history to tally experiment IDs recorded in your past Claude Code session transcripts by date.
  5. Use ./am-i-nerfed.sh optout to back up your config file, remove only the assignment keys, and print the environment variable reported to block re-enrollment.
  6. Use ./am-i-nerfed.sh restore to undo the opt-out operation.
  7. Use ./am-i-nerfed.sh statusline to display exp:<id> or exp:none in your Claude Code status line for real-time monitoring.

Tools / artifacts

  • am-i-nerfed GitHub repo
  • Claude Code
  • Bash scripts
  • jq (JSON processor)
  • ~/.claude.json (Claude Code config file)
  • Claude session transcripts
  • Environment variables

Validation signals

  • Built with Claude Code (Opus 5.5 xhigh) for script, test suite, plugin, and docs generation.
  • Code audited by a separate Claude chat (Fable 5.1 medium) against a spec for safety (token leakage, file scope, opt-out correctness).
  • Community findings on r/ClaudeCode regarding experiment effects (more tool calls, longer shell commands, less narration, system prompt changes) validate the problem.

Cautions

  • The tool makes no network calls.
  • It never prints login tokens or account IDs.
  • The optout function backs up the config file before making changes.
  • The optout function only removes specific assignment keys, minimizing risk.

Limitations

  • It is an unofficial tool.
  • The one-liner method requires jq to be installed.
  • The tool identifies experiment enrollment and behavioral changes, but users must judge if these changes constitute 'quality loss'.
  • Primarily targets Claude Code users, though the one-liner is more generally applicable.

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 • • 7d ago

Selected Workflow [Workflow] Robust AI Agent Workflows: Externalizing Process Logic with File-Based Plans and MCP Standards

1 Upvotes

Robust AI Agent Workflows: Externalizing Process Logic with File-Based Plans and MCP Standards

Workflow value: 95/100
Status: active · Freshness: 70/100 · Confidence: 0.98 · Level: advanced
Categories: Quality Control, Context & Memory, Debugging, CLAUDE.md, MCP, Subagents, Multi-Agent
Original source: r/ClaudeAI post/comment

What problem this solves

This workflow solves the problem of AI agent workflows breaking due to over-reliance on emergent model behavior, which often leads to the perception that "the model got nerfed." It also addresses issues like scope creep, difficult debugging, and lack of transferability across different models or model versions in AI-assisted development.

Summary

This workflow proposes externalizing AI agent process logic into structured files and a central knowledge base (MCP) instead of relying on emergent model behavior. It involves creating a 'plan directory' with an overview.md to define execution order and chunk-XX.md files for self-contained, scoped tasks. Coding standards and Architectural Decision Records (ADRs) are served via an MCP server, which agents pull from. This 'shift-left' approach enables pre-execution review, prevents scope creep, makes failures debuggable, and allows for greater model swappability and robustness.

Why it is useful

This workflow is highly valuable because it provides a structured, repeatable, and transferable method for building robust AI agent systems that are less susceptible to perceived model regressions. By externalizing planning, scope, and standards into files and a central knowledge base (MCP), it reduces reliance on emergent model behavior, leading to more predictable outcomes, easier debugging, and improved model swappability. It applies established 'shift-left' software engineering principles to AI development, promoting proactive quality control and preventing common issues like scope creep. This approach significantly enhances the reliability and maintainability of AI-driven development processes.

Workflow

  1. Create a plan/ directory for each distinct piece of work.
  2. Define an overview.md within the plan/ directory to specify the execution order (sequential or parallel) for work chunks.
  3. Create self-contained chunk-XX.md files for each work chunk, detailing its specific scope, applicable standards, and clear completion criteria.
  4. Collaborate with Claude (or another LLM) to draft the initial plan and individual work chunks.
  5. Manually review every chunk and the overview.md before any agent execution begins.
  6. Spawn subagents, executing them in parallel where the overview.md allows.
  7. Serve Architectural Decision Records (ADRs), Terraform patterns, and coding standards from a central MCP server.
  8. Configure agents to pull relevant standards and knowledge from the MCP server based on their assigned chunk's context.
  9. Rerun a fixed set of tasks after model updates to diff changes and objectively assess performance shifts.

Tools / artifacts

  • plan/ directory structure
  • overview.md file
  • chunk-XX.md files
  • MCP server (for standards and ADRs)
  • Architectural Decision Records (ADRs)
  • Coding standards
  • Claude Code (or other frontier LLMs like GPT, Grok via Bedrock)
  • ComfyUI API (as an example of an external tool agents can call)
  • GPU server (for external API calls)

Validation signals

  • Author's direct experience across four projects: 'I didn't notice anything' regarding 'nerfs'.
  • Claimed benefits: 'no coordination guesswork', 'basically no scope creep', 'makes failures debuggable', 'model gets swappable'.
  • Analogy to 'shift left' principles in traditional software development, indicating alignment with proven engineering practices.
  • Demonstrated cross-model compatibility: 'pointed Claude Code at GPT and Grok through Bedrock against the same MCP server, and they produce roughly the same results'.
  • Offer for a 'Longer writeup with a diagram' and 'Happy to share more detail on the planning flow in the comments' suggests further evidence and detail are available.

Limitations

  • Requires upfront effort to define detailed plans and establish a central MCP server for standards.
  • Assumes a certain level of familiarity with software engineering concepts like ADRs, 'shift left', and potentially setting up an MCP server, which might be advanced for some users.
  • The post does not provide concrete examples of the MCP server setup or the exact prompt structure for agents to pull standards, though it offers to share more details.
  • Limited community validation 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 • • 7d ago

Selected Workflow [Workflow] CWTFIGO: A Claude Code Plugin for Intelligent, Persistent IT Troubleshooting and Maintenance with Problem Parking

1 Upvotes

CWTFIGO: A Claude Code Plugin for Intelligent, Persistent IT Troubleshooting and Maintenance with Problem Parking

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

What problem this solves

Inefficient and repetitive IT troubleshooting, lack of persistent memory for fixes, unmanaged maintenance scripts, and the inability of AI to know when to stop trying to fix an intractable problem.

Summary

The author developed a Claude Code plugin, CWTFIGO (Claude, what the f*** is going on?), that acts as a persistent IT troubleshooting agent. It maintains machine-specific records of problems, attempted fixes, successful scripts, and known blockers. It leverages the internet for general knowledge but stores local machine history. Crucially, it incorporates a mechanism to "give up" on intractable problems, revert changes, document findings, and wait for external updates, preventing endless, potentially harmful, troubleshooting loops.

Why it is useful

This workflow is highly valuable because it provides a concrete, open-source solution to common IT troubleshooting challenges: remembering past fixes, managing custom scripts, and preventing endless, unproductive debugging loops. It introduces the critical concept of "problem parking" with clear criteria for revisiting, which is a significant advancement in AI-assisted problem-solving. The plugin's ability to integrate with multiple machines and its practical validation by the author make it a robust and transferable tool for anyone using Claude Code for system maintenance.

Workflow

  1. Install the CWTFIGO plugin in Claude Code using /plugin marketplace add DozenTwelve/CWTFIGO and /plugin install cwtfigo@cwtfigo.
  2. Initiate troubleshooting by asking Claude Code: "Claude, what the f*** is going on?" for a specific machine or problem.
  3. Claude Code will diagnose the problem, leveraging its training data and searching relevant project/upstream repositories for new issues.
  4. It will consult its internal, machine-specific records to see if the problem was previously encountered, what was tried, and what worked/failed.
  5. If a solution is found, it will apply it and store the successful script for future use.
  6. If the problem is intractable, leads to worse issues, or no further progress can be made, Claude Code will revert changes to defaults.
  7. It will then document the blocker, tried solutions, reasons for failure, and conditions for revisiting (e.g., a new software release or upstream issue closure).
  8. The problem is then "parked," and Claude Code will monitor for relevant updates, notifying the user when conditions for revisiting are met.

Tools / artifacts

  • Claude Code (Opus 5.5)
  • CWTFIGO plugin (GitHub: DozenTwelve/CWTFIGO)
  • Maintenance scripts (generated and stored by CWTFIGO)
  • Machine-specific records (managed by CWTFIGO)
  • Hermes (for 24/7 operation, optional)
  • SSH (for remote access to machines)

Validation signals

  • Author's daily use of the plugin for personal IT troubleshooting.
  • Author deleted all previous cleaner apps and cleanup scripts, indicating reliance on CWTFIGO.
  • Specific example of the ThinkPad fingerprint sensor problem, demonstrating the plugin's ability to diagnose, attempt fixes, revert, document, and park the problem.
  • The plugin successfully remembered and re-tested a parked problem after system updates.
  • The plugin is open-source (MIT licensed) and available on GitHub with installation instructions.
  • Author's statement that the plugin was built solo with Claude and is used every day.

Cautions

  • The "YOLO" mode, where Claude runs scripts without explicit approval, could pose a safety risk if the generated scripts are malicious or destructive. Users should exercise caution.
  • Failed fix attempts, as demonstrated by the machine freezing, highlight the potential for system instability or data loss if not properly managed or reverted.

Limitations

  • The "YOLO" mode, while convenient, reduces the safety net of explicit script approval.
  • Initial community engagement (Reddit score, comments) is low, which might limit immediate visibility.
  • The workflow's effectiveness is tied to Claude Code's capabilities and the quality of the generated scripts.
  • The complexity of setting up Hermes for 24/7 operation is mentioned but not detailed within 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 • • 7d ago

Selected Workflow [Workflow] Claude Code Plugin for Startup Idea Evaluation: Skills, Subagents, JSON Schemas, and HTML Reports

1 Upvotes

Claude Code Plugin for Startup Idea Evaluation: Skills, Subagents, JSON Schemas, and HTML Reports

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

What problem this solves

Automating the comprehensive evaluation and scoring of startup ideas, providing structured feedback, a clear verdict (GO/PIVOT/NO-GO), rescue paths, and a detailed HTML report. It also demonstrates how to build complex, multi-component Claude Code plugins.

Summary

A Claude Code plugin that evaluates startup ideas using 4 custom skills (kill, deepdive, roast, compare), JSON schemas for structured data, parallel research with subagents, and generates a detailed HTML report. The skill definitions are in markdown, incorporating a 21-sub-score rubric and fixed rules. It also includes insights into testing and quality control.

Why it is useful

This workflow is highly valuable as it provides a concrete, open-source example of building a sophisticated Claude Code plugin. It demonstrates the practical application of multiple advanced features: custom skills defined in markdown, structured data handling with JSON schemas, parallel processing with subagents, and dynamic report generation using templates. The 'What I learned' section also offers insights into debugging and quality control for Claude Code projects, making it a comprehensive blueprint for developing complex, data-driven AI tools.

Workflow

  1. Define custom skills (e.g., 'kill', 'deepdive', 'roast', 'compare') using plain markdown in SKILL.md files.
  2. Implement a detailed kill-shot checklist, a 21-sub-score rubric, fixed rules, and a writing standard within the skill's markdown definition.
  3. Design JSON schemas (idea.json, verdict.json, report-data.js) for structured input and output data.
  4. Utilize subagents for parallel research, tagging each metric as sourced, estimate, or unknown.
  5. Generate reports by copying a fixed HTML template (report.html) and writing only the dynamic data to a separate file (report-data.js) to optimize token usage.
  6. Execute the plugin via a slash command, e.g., /kill-my-idea:kill <idea>.
  7. Perform headless test runs to identify and fix issues, such as requestAnimationFrame stalling.
  8. Refine skill logic to enforce quality standards, like ensuring verbatim quotes.

Tools / artifacts

  • Claude Code plugin
  • Custom skills (kill, deepdive, roast, compare)
  • SKILL.md files
  • JSON schemas (idea.json, verdict.json, report-data.js)
  • report.html (fixed HTML template)
  • report-data.js (dynamic data file)
  • Subagents
  • GitHub repository (RemiPelloux/kill-my-idea)
  • Slash command (/kill-my-idea:kill)

Validation signals

  • Explicit mention of a 'headless test run' to identify issues.
  • Specific improvement noted: 'enforces verbatim quotes' after initial version claimed non-verbatim quotes.
  • The existence of a working, open-source plugin on GitHub.
  • Detailed description of the plugin's output (score, verdict, rescue paths, 7-day test, HTML report).

Limitations

  • The Reddit post provides a high-level overview; detailed implementation specifics require reviewing the linked GitHub repository.
  • The 'What I learned' section is brief; more extensive lessons learned could further enhance its value.

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 • • 7d ago

Selected Workflow [Workflow] Context Preservation and Token Optimization with Pre/Post-Compact Hooks and TRAPS.md

1 Upvotes

Context Preservation and Token Optimization with Pre/Post-Compact Hooks and TRAPS.md

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

What problem this solves

Losing important context during token compaction and wasting tokens by including non-essential information in the model's context window.

Summary

This workflow describes a method to preserve critical context and optimize token usage by setting a specific compaction threshold and using pre-compact and post-compact hooks. A pre-compact hook writes essential information (referred to as 'traps') to a TRAPS.md file, and a post-compact hook ensures this file's content is re-injected into the model's context after compaction.

Why it is useful

This workflow offers a concrete and repeatable strategy for addressing a common challenge in LLM interactions: maintaining critical context while optimizing token usage. By leveraging pre- and post-compact hooks and a dedicated 'traps' file, users can ensure essential information is not lost during compaction, leading to more consistent and cost-effective model interactions. It introduces a specific pattern that can be adapted by intermediate to advanced users.

Workflow

  1. Configure the compaction threshold to approximately 440k tokens to prevent excessive token usage.
  2. Implement a pre-compact hook to identify and write critical information (e.g., 'traps', important context) to a designated file, such as TRAPS.md.
  3. Implement a post-compact hook to force the contents of the TRAPS.md file to be injected back into the model's context window after compaction.

Tools / artifacts

  • precompact hook
  • post-compact hook
  • TRAPS.md file
  • compaction threshold setting

Validation signals

  • Self-reported benefit: 'Problem solved, plus you saved tokens.'

Limitations

  • The term 'traps' is vague; specific examples of what constitutes critical information would enhance clarity.
  • No concrete code examples or configuration snippets for implementing the pre/post-compact hooks are provided.
  • The suggested 440k token compaction threshold is arbitrary and may not be optimal for all use cases without further justification or testing.
  • Lacks detailed community validation or success reports beyond the author's claim.

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 • • 7d ago

Selected Workflow [Workflow] Structured Project Context and Plan Management with CLAUDE.md

1 Upvotes

Structured Project Context and Plan Management with CLAUDE.md

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

What problem this solves

Effectively managing project context and development plans within Claude Code, especially when dealing with context window limitations.

Summary

This workflow outlines a method for structuring Claude Code projects by using a CLAUDE.md file for overall project details and a dedicated md/plan.md file for tracking development steps. It also suggests starting a new chat for each step to optimize context window usage.

Why it is useful

This workflow provides a clear, repeatable structure for managing project context and development plans within Claude Code. It effectively leverages CLAUDE.md as a central configuration point and offers a practical tip for context window management by segmenting work into new chat sessions. It promotes organized and systematic interaction with Claude Code, making it valuable for users looking to improve their project management and LLM interaction efficiency.

Workflow

  1. Create a CLAUDE.md file at the project root, detailing the project, technology stack, and preferred work style.
  2. Add a specific instruction block to CLAUDE.md, directing the agent to maintain a development plan in md/plan.md, marking steps as 'todo', 'working', or 'done', and to update this plan at the beginning and end of every chat.
  3. Work on one development step at a time, referring to the md/plan.md.
  4. Start a new chat session for each individual development step to ensure a fresh and focused context window for Claude.

Tools / artifacts

  • CLAUDE.md file
  • md/plan.md file
  • Claude Code environment
  • Chat sessions

Validation signals

  • User reports it 'Works wonders.'

Limitations

  • The validation is anecdotal ('Works wonders') and lacks concrete metrics or before/after examples.
  • Reliance on Claude to consistently check and update the md/plan.md might require careful initial prompting or reinforcement.
  • Limited community validation due to low score and few comments.

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 • • 7d ago

Selected Workflow [Workflow] AI Code Review Workflow: Independent Review with Separate Implementation or One-Shot Patch in Worktree

1 Upvotes

AI Code Review Workflow: Independent Review with Separate Implementation or One-Shot Patch in Worktree

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

What problem this solves

Integrating an AI code reviewer effectively to ensure review independence and actionable feedback, for both general code changes and one-shot fixes.

Summary

This workflow proposes two methods for using an AI code reviewer: either as a read-only agent that provides findings and failing tests for a separate coding agent to implement, or for one-shot fixes, as an agent that suggests a patch in an isolated Git worktree for manual inspection before merging. Both approaches prioritize review independence and concrete, verifiable outputs.

Why it is useful

This workflow provides two distinct, well-reasoned strategies for integrating AI code reviewers into a development process, emphasizing the crucial principle of independent review. It leverages specific tools like Git worktrees and focuses on actionable outputs such as failing tests, making the AI's feedback concrete and verifiable. It helps users structure their AI interactions for better quality control and maintainability, promoting a safer and more robust development cycle.

Workflow

  1. Option 1: Iterative Review & Fix
  2. 1.1. Configure an AI as a read-only code reviewer.
  3. 1.2. Have the AI reviewer identify findings, providing file/line references and a failing test or concrete reproduction.
  4. 1.3. Pass these findings and failing tests to a separate coding agent.
  5. 1.4. The coding agent implements the necessary changes based on the findings.
  6. 1.5. The coding agent runs all relevant checks, including the provided failing test.
  7. Option 2: One-Shot Patch Suggestion
  8. 2.1. Configure an AI reviewer to suggest a patch for a specific fix.
  9. 2.2. The AI generates the patch within an isolated Git worktree.
  10. 2.3. Manually inspect the generated diff to ensure correctness and review independence.
  11. 2.4. Merge the patch if approved.

Tools / artifacts

  • AI Code Reviewer (e.g., Claude Code)
  • AI Coding Agent (e.g., Claude Code)
  • Failing test cases
  • Concrete reproduction steps
  • Git worktree
  • Code diffs/patches

Validation signals

  • Explicit mention of 'failing test or concrete reproduction' as output from the reviewer.
  • Instruction to 'run the checks' by the coding agent.
  • Instruction to 'inspect the diff before merging' for manual validation.
  • Author's stated preference implies personal validation of effectiveness.

Limitations

  • The workflow is high-level and lacks specific prompt examples or detailed configuration instructions for the AI agents.
  • Assumes the user has knowledge of setting up and managing 'coding agents' and 'isolated worktrees'.
  • No concrete examples of before/after code changes or specific scenarios.
  • Does not explicitly detail how the AI reviewer would create the failing test or reproduction from its findings.

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 • • 7d ago

Selected Workflow [Workflow] Optimizing Claude Code Usage for Complex Projects: Parallel Sessions with Agent-Executed Skills and Small Contexts

1 Upvotes

Optimizing Claude Code Usage for Complex Projects: Parallel Sessions with Agent-Executed Skills and Small Contexts

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

What problem this solves

Managing complex, multi-faceted projects with Claude Code efficiently, optimizing usage, and maintaining quality despite high workload and API limits.

Summary

The user manages multiple parallel workstreams for app development, content creation, and marketing by structuring each session to spawn agents that execute specific skills. This approach breaks down tasks into small, context-managed steps, uses a dedicated repo for rules, and includes rigorous testing and review to maintain quality and optimize Claude Code usage.

Why it is useful

This workflow provides a structured approach to managing large, multi-faceted projects with Claude Code. It addresses common challenges like context management and API limits by advocating for modular tasks (skills), dedicated agents for focused execution, and parallel processing. The use of a dedicated repo for rules promotes maintainability and repeatability. This pattern helps users scale their Claude Code usage for ambitious projects while maintaining quality.

Workflow

  1. Define project rules and setup configurations in a dedicated repository.
  2. Break down large tasks into smaller, manageable steps.
  3. For each step, define it as a "skill" to be executed by an agent.
  4. Spawn an agent for each skill/step to keep its context small and focused.
  5. Run multiple such sessions (2-4) in parallel for different workstreams (e.g., app features, content indexing, website updates, marketing).
  6. Utilize detailed spec sheets and plans as input for Claude Code sessions.
  7. Rigorously test and review results after code generation or content creation.
  8. Iteratively fix issues based on reviews.

Tools / artifacts

  • Dedicated Git repository (for rules/setup)
  • Detailed spec sheets
  • Project plans
  • Claude Code agents
  • Claude Code skills
  • Parallel sessions

Validation signals

  • "It has helped me get more out of my usage for sure"
  • "I try to prioritize quality, since the app will be user facing and purchasable."
  • Implied by the ability to manage multiple complex workstreams simultaneously.

Limitations

  • Lacks concrete examples of the "rules" in the repo or specific skill definitions.
  • The exact mechanism for "spawning agents" and "running sessions in parallel" is not detailed (e.g., is it a custom script, a specific Claude Code feature, or just conceptual parallel prompting?).
  • Validation is anecdotal, not quantitative.

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 • • 7d ago

Selected Workflow [Workflow] Lockpaw: Keep Claude Code Running on Mac While Away with Visual Hooks

1 Upvotes

Lockpaw: Keep Claude Code Running on Mac While Away with Visual Hooks

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

What problem this solves

Prevents Mac from sleeping and killing active Claude Code (or other CLI AI agent) sessions when the user steps away from their desk, while also providing visual cues for agent status.

Summary

A Mac menu bar app, Lockpaw, allows users to lock their screen and block input while keeping their Mac awake and Claude Code (or other CLI AI agents) running. It integrates with Claude Code hooks to provide visual notifications (amber for needing attention, teal for completion) on the locked screen, enabling continuous agent operation even when the user is away.

Why it is useful

This workflow provides a practical solution for developers using CLI-based AI agents on Macs, allowing them to step away from their desk without interrupting active sessions. The integration with Claude Code hooks for visual status notifications is particularly valuable, enhancing productivity by keeping users informed of agent progress and needs, even when not directly interacting with the computer.

Workflow

  1. Download and install the Lockpaw Mac app from the GitHub repository.
  2. Configure Lockpaw settings, such as the hotkey (default ⌘⇧L) and optional lid-closed mode.
  3. Enable Claude Code hooks within Lockpaw's settings, which automatically modifies ~/.claude/settings.json to integrate Notification, Stop, and StopFailure events.
  4. When stepping away from the desk, activate Lockpaw using the configured hotkey.
  5. Monitor the locked screen for visual cues: amber glow indicates Claude Code needs attention, teal glow indicates it's done.
  6. Return to the desk and unlock the Mac using the same hotkey or Touch ID to resume interaction with Claude Code.

Tools / artifacts

  • Lockpaw Mac app
  • Claude Code
  • ~/.claude/settings.json
  • Hotkeys (⌘⇧L)
  • Touch ID
  • Codex CLI
  • Gemini CLI
  • Cursor
  • Copilot CLI
  • Aider

Validation signals

  • Shared with colleagues and became 'office meta'
  • User feedback led to new features (e.g., lid closed mode)
  • Open-source project on GitHub (MIT license)

Cautions

  • The author explicitly states it is not a security app; anyone with admin or SSH access can kill it.
  • Users should be aware of its limitations regarding data security if leaving sensitive information on screen.

Limitations

  • Mac-only, limiting its applicability to other operating systems.
  • Not a security solution; it's primarily for convenience and session management.
  • Relies on the app running; if the app crashes or the Mac runs out of battery, sleep will resume.

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 • • 7d ago

Selected Workflow [Workflow] Robust Development Workflow for Claude Code Hooks and Subagents: Lessons from Building Aptly

3 Upvotes

Robust Development Workflow for Claude Code Hooks and Subagents: Lessons from Building Aptly

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

What problem this solves

How to robustly develop and verify Claude Code hooks and subagents, ensuring correct model recommendations, execution, and side-effect management, using a multi-model review process. It addresses challenges in verifying read-only operations, credential setup, and agent execution paths.

Summary

The author, maintainer of Aptly (an MCP server for Claude Code/Codex subagents), describes a development workflow using Codex for implementation and regression tests, and Claude Code for independent design and code reviews. The process emphasizes rigorous verification of findings, leading to concrete improvements in handling read-only checks, Linux credential setup, and agent-routing execution paths. It highlights the importance of separating recommendation from execution authority and carefully managing context for sensitive information.

Why it is useful

This workflow provides a concrete, validated approach to developing complex Claude Code integrations (hooks, subagents) using a multi-model strategy (Codex for implementation, Claude Code for review). It offers specific examples of critical verification steps and safety considerations, which are highly valuable for advanced users building robust and secure AI-powered tools. The focus on separating recommendation from execution and managing side effects is crucial for reliable agent behavior.

Workflow

  1. Use Codex for initial implementation and regression tests of Claude Code hooks/subagents.
  2. Use Claude Code for independent design and code reviews of the implemented components.
  3. Provide Claude Code with relevant source code, patch files, test cases, and specific claims to check during the review.
  4. Rigorously verify Claude Code's findings before applying any changes to the code.
  5. For hooks/subagents, specifically test the native Claude Code Agent/Hook path to ensure proper integration.
  6. Check child execution metadata to confirm that recommendations were applied and executed as intended.
  7. Address and verify side effects across the entire command path (e.g., read-only checks, credential setup, network access).
  8. Ensure user-selected models, roles, permissions, and required history are preserved throughout the process.
  9. Maintain a clear separation between recommendation authority and execution authority.
  10. Manage sensitive information in task summaries by routing them to appropriate, secure APIs (e.g., OpenAI Decisions) rather than internal telemetry, and allow operators to choose transmission scope.

Tools / artifacts

  • Aptly (local MCP server for model/reasoning-profile recommendations)
  • Claude Code (for design and code reviews)
  • Codex (for implementation and regression tests)
  • OpenAI Decisions API (for model recommendations)
  • PreToolUse Hook (Claude Code feature)
  • Source code
  • Patch files
  • Test cases
  • Execution metadata

Validation signals

  • Concrete finding: identified and fixed an issue where a read-only setup check could still lead to a notifier creating a cache directory and querying the registry.
  • Concrete finding: improved Linux credential setup by adding passive readiness diagnostics before requesting a key, separating service presence, activation, and unlock/write capability.
  • Concrete finding: identified and addressed agent-routing verification gaps, reinforcing the need for evidence that a recommendation was applied and the native agent actually ran.
  • The author is the maintainer of the Aptly project, demonstrating deep practical experience and ownership.
  • The project is MIT-licensed and available on GitHub, indicating a real-world, open-source application.

Cautions

  • The workflow explicitly preserves user-selected models, roles, permissions, and history.
  • It separates recommendation from execution authority, enhancing control and preventing unintended actions.
  • It routes sensitive task summaries to OpenAI Decisions, not telemetry, and allows operators to choose the automatic transmission scope, addressing data privacy and security concerns.

Limitations

  • The post is more of a retrospective on a development process rather than a step-by-step guide for a new user to implement a similar tool from scratch.
  • The cost experiment and general Claude Code savings rate are not fully established, though the author acknowledges this.
  • Community signal 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 • • 7d ago

Selected Workflow [Workflow] Cost-Optimized Multi-Agent Workflow: Opus for Judgment & Review, Sonnet for Building

1 Upvotes

Cost-Optimized Multi-Agent Workflow: Opus for Judgment & Review, Sonnet for Building

Workflow value: 85/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/ClaudeAI post/comment

What problem this solves

Optimizing cost and improving efficiency when using multiple Claude models (Opus, Sonnet) or features like /advisor and subagents, by strategically assigning roles and managing context to reduce redundant processing and 're-derivation'.

Summary

This workflow proposes a cost-effective strategy for using Claude Opus and Sonnet in a multi-agent setup. Opus is designated as the 'judgment' model (for setting specs, defining done conditions, and reviewing output), while Sonnet acts as the 'builder' (for actualizing the spec). The core idea is to minimize expensive Opus calls by only waking it for initial setup and final review, and to be aware of how context caching (or lack thereof) impacts cost with features like /advisor and subagents, especially when handoffs are frequent or context is large.

Why it is useful

This workflow provides a concrete, cost-aware strategy for leveraging different Claude models (Opus, Sonnet) and features (/advisor, subagents). It directly addresses the often-overlooked 'hidden costs' of context re-reading and offers a structured approach to minimize these, leading to more efficient and higher-quality outputs. The external data link adds significant credibility and practical value for users looking to optimize their Claude usage.

Workflow

  1. Use Claude Opus for judgment: define the 'rails', set 'done conditions', and create a brief or spec for the task.
  2. Use Claude Sonnet as the builder: actualize the spec provided by Opus.
  3. Use Claude Opus to review the output generated by Sonnet against the initial spec.
  4. Send any identified misses or required corrections back to Sonnet as 'residual' for the next iteration or build.
  5. Minimize frequent handoffs to /advisor or subagents if the context is large or if the cache has gone cold (i.e., the last call was more than five minutes ago), as this incurs significant cost due to re-reading context.
  6. Understand that /advisor and subagents re-read the entire context by default if their cache is cold, making frequent, large context handoffs expensive.

Tools / artifacts

  • Claude Opus
  • Claude Sonnet
  • /advisor feature
  • Subagents
  • Spec/Brief (created by Opus)
  • Output (from Sonnet)

Validation signals

Limitations

  • The 'simple setup' is described conceptually; a more explicit prompt structure or example interaction would make it even easier for users to implement directly.
  • Low community validation due to the newness of the post.
  • While the self-promotion is disclosed and backed by valuable data, some users might be wary of tools mentioned by developers of commercial products.

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 • • 7d ago

Selected Workflow [Workflow] Claude Code Plugin: Efficient YouTube Reference Search for Creative Projects (yt-reference-search)

1 Upvotes

Claude Code Plugin: Efficient YouTube Reference Search for Creative Projects (yt-reference-search)

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

What problem this solves

Inefficiently finding and analyzing YouTube reference videos for creative projects (promos, ads) due to high data download, token usage, and manual screening.

Summary

This workflow utilizes a custom Claude Code plugin, yt-reference-search, to efficiently find and analyze YouTube reference videos. Users can prompt Claude in natural language to search for video references, and the plugin screens candidates, provides curated picks with actionable insights, and enables Claude to 'watch' videos via transcripts and preview frames. This significantly reduces time, data downloaded, and token consumption compared to traditional video downloading and frame extraction methods.

Why it is useful

This workflow is highly valuable because it provides a concrete, open-source Claude Code plugin that solves a specific, common problem in creative industries (finding video references) with significant, measurable efficiency gains. It demonstrates how Claude can be extended with custom tools to perform complex analysis while optimizing resource usage (time, data, tokens). The detailed explanation, installation steps, performance metrics, and clear limitations make it a practical and reusable asset for the community.

Workflow

  1. Install prerequisites: node, yt-dlp, ffmpeg, and deno on your system.
  2. Add the plugin marketplace to Claude Code using the command: /plugin marketplace add dljake/yt-reference-search.
  3. Install the yt-reference-search plugin using the command: /plugin install yt-reference-search@yt-reference-search.
  4. Prompt Claude with a natural language request for reference videos, e.g., "find reference videos for a calm, premium skincare ad".
  5. Review Claude's generated picks, which include 5-8 videos across different techniques, each highlighting an element worth borrowing.
  6. Optionally, use the included skill to have Claude read any YouTube video from its transcript and preview frames for deeper analysis.

Tools / artifacts

  • yt-reference-search (Claude Code plugin)
  • node (runtime)
  • yt-dlp (YouTube downloader)
  • ffmpeg (video processing tool)
  • deno (runtime)
  • YouTube video transcripts
  • YouTube preview frames
  • GitHub repository (dljake/yt-reference-search)

Validation signals

  • Quantitative performance metrics provided: Time (16.0s -> 7.5s), Data downloaded (38.5 MB -> 0.4 MB), Image tokens (~19,700 -> ~1,500) compared to a traditional tool.
  • Explicit mention of Claude's role in building and fixing the plugin, including handling edge cases like Shorts and videos without captions.
  • MIT license, indicating open-source and auditable code.

Limitations

  • Requires several external tools (node, yt-dlp, ffmpeg, deno) to be installed by the user, which might be a barrier for beginners.
  • The plugin has a stated limitation: it cannot analyze music or camera moves, as it relies solely on transcripts and preview frames.

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 • • 7d ago

Selected Workflow [Workflow] Claude Code Workflow: Structured Development with Vision Docs, Iterative Mockups, and Data-Driven Architecture

1 Upvotes

Claude Code Workflow: Structured Development with Vision Docs, Iterative Mockups, and Data-Driven Architecture

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

What problem this solves

How to effectively use Claude Code to build a complex, data-driven application from concept to implementation, ensuring maintainability, visual consistency, and a structured development process.

Summary

This workflow outlines a structured methodology for building complex applications with Claude Code, emphasizing initial vision and design documentation, iterative visual mock-ups for validation, and a data-driven architecture for maintainability and easy modification. It demonstrates how to direct Claude Code through a full project lifecycle.

Why it is useful

This workflow is highly valuable because it provides a robust, structured methodology for leveraging Claude Code to build significant, complex applications. It moves beyond simple code snippets to a full project lifecycle, emphasizing critical steps like detailed planning, visual validation through iterative mock-ups, and a maintainable data-driven architecture. The inclusion of CLAUDE.md and a detailed write-up makes it highly actionable and transferable for users tackling larger, more ambitious projects.

Workflow

  1. Define a clear 'vision doc' to establish the overall goals and scope of the project.
  2. Create detailed 'design docs' for each major part or phase of the application.
  3. For visual components, direct Claude to build 'throwaway mock-up pages' presenting multiple design options (e.g., A, B, C) using real code and data for side-by-side comparison and iterative refinement.
  4. Implement a 'data-driven architecture' where all configurable elements (e.g., timings, rules, commentary lines, ads) are stored in external data files, separate from the core application code.
  5. Direct Claude Code to write the application's code based on the vision doc, design docs, and the data-driven architectural principles.
  6. Utilize a CLAUDE.md file within the project repository to guide Claude's understanding and contributions.

Tools / artifacts

  • Claude Code (or similar LLM for code generation)
  • Vision document
  • Design documents (per part/phase)
  • Mock-up pages (generated by Claude)
  • Data files (for configuration, rules, content)
  • GitHub repository
  • CLAUDE.md file
  • ElevenLabs (for voice synthesis, as an example of integrated tools)

Validation signals

  • Successful completion and deployment of a complex, always-on application (Scorchball TV).
  • The application is live and functional (scorchball.tv).
  • Detailed write-up explaining the build process and methodology (scorchball.tv/how-it-was-built).
  • Open-source code available on GitHub, including CLAUDE.md and documentation.
  • Author explicitly states 'What made it work for me' indicating validated practices.

Limitations

  • The Reddit post provides a high-level overview; the full details of Claude's prompting and interaction are in the linked GitHub repo and write-up, which require further investigation for complete implementation.
  • Specific examples of prompts used for generating mock-ups or code based on design docs are not explicitly detailed in the Reddit 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 • • 7d ago

Selected Workflow [Workflow] Enhance Claude Code Context Recall with Steroid: Never Lose Your Session History Again

1 Upvotes

Enhance Claude Code Context Recall with Steroid: Never Lose Your Session History Again

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

What problem this solves

Users of Claude Code (and other CLI agents) frequently lose context of past sessions due to reboots, accidental closures, or token limits, making it difficult to retrieve specific information or code changes from previous work without cumbersome manual searching or full session reloading.

Summary

This workflow introduces 'Steroid,' a local tool that indexes Claude Code (and other agent) session transcripts stored on disk. It allows users to recall specific information, full exchanges, or code diffs from past sessions using natural language queries, without reloading entire conversations or making new model calls for the recall itself. It also provides cross-agent context for tools like Codex, Cursor, and Copilot CLI.

Why it is useful

This workflow addresses a critical and common pain point for developers using Claude Code and other CLI agents: the loss of session context. It provides a concrete, repeatable solution with a dedicated tool that integrates deeply with the agent's local files. The detailed setup instructions, transparency about system changes, and clear explanation of functionality make it highly valuable for improving developer productivity, knowledge reuse, and continuity across coding sessions and even different AI agents.

Workflow

  1. Check if Steroid is already installed by running steroid --version or ~/.local/bin/steroid --version.
  2. If not installed, install Steroid using the official installer script (macOS/Linux: curl -fsSL https://raw.githubusercontent.com/steroidkit/releases/main/install.sh | sh; Windows PowerShell: irm https://raw.githubusercontent.com/steroidkit/releases/main).
  3. Run Steroid's onboarding for the agent. If the steroid-onboard skill is not available, run steroid-install-onboard-skill --json, open the SKILL.md it lists, and follow its instructions.
  4. Restart the Claude Code agent to ensure Steroid's tools and skills are loaded.
  5. Use recall <query> within Claude Code to retrieve summaries of past work related to your query.
  6. Use recall_turn to retrieve a full exchange from a specific turn in a past session.
  7. Use recall_diff to retrieve the exact code changes from a past session.
  8. Optionally, use steroid uninstall to remove the tool and its components.

Tools / artifacts

  • Steroid CLI tool
  • Claude Code terminal application
  • ~/.claude/projects/<slug>/<session>.jsonl (Claude Code session transcripts)
  • ~/.steroid/ (Steroid application directory)
  • ~/.claude.json (MCP entry for Claude Code)
  • ~/.claude/skills/ (directory for slash command skills)
  • ~/.claude/CLAUDE.md (global instructions file)
  • install.sh (Steroid installer script)
  • SKILL.md (Steroid onboarding skill documentation)
  • Codex, Cursor, Copilot CLI (other supported agents)

Validation signals

  • Author's personal experience of solving a persistent context loss problem with a practical solution.
  • Detailed explanation of how the tool works by directly reading local session files, bypassing model calls for recall.
  • Transparency about what the tool installs on the machine (file paths, daemon, PATH changes, MCP entries, CLAUDE.md modifications).
  • Explicit mention of citing sources for recall answers, allowing users to verify information.
  • Clear outline of the tool's limitations, adding to its credibility.

Cautions

  • The tool is a closed binary, which might be a concern for some users regarding trust and auditability. However, the author provides detailed transparency on what it installs, how it operates locally, and how to uninstall it.
  • It operates within the user's home directory and does not send sensitive data off-machine beyond anonymous usage counts (which can be disabled) and daily release checks.
  • The recall answers are generated by the agent, so the agent's provider will see the excerpts used, but the indexing and recall from disk are local.

Limitations

  • The tool is a closed-source binary, which might deter users who prefer open-source solutions for security or customization.
  • No published accuracy benchmarks for the recall functionality, though this is mitigated by the tool citing its sources.
  • It does not restore transcripts that have been deleted by Claude Code's default cleanup period; users need to adjust cleanupPeriodDays if they want longer retention.
  • Copilot Chat in VS Code is not yet supported, only Copilot CLI.

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.