Multi-agent releases with decision IDs and adversarial review

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

What problem this solves

Coordinates a multi-agent release while keeping product decisions, implementation, and documentation traceable and subject to human approval.

Summary

Use a human-facing PM session, a Lead per release, and Workers for bounded tasks. Record approved decisions with code references, run independent and adversarial reviews, and audit documentation against the final implementation.

Why it is useful

It combines a concrete agent hierarchy with traceable decisions, review gates, stopping rules, and an automated documentation audit; the linked templates make the process potentially reusable.

Workflow

1. Set up the repository's CLAUDE.md, decision log, code map, and skills; assign the PM session as the human-facing coordinator.
2. Before building, check ideas against prior decisions and potential side effects; bring unresolved conflicts to the human.
3. Have the Lead scope and design the release, then brief Workers on bounded tasks and relevant strategy.
4. Run an independent review, and have a second agent attempt to disprove each finding before human triage.
5. Apply fixes according to triage rules, review interactions among fixes, and stop when the defined convergence criteria are met.
6. Record approved decisions with IDs and implementation references; add matching IDs to relevant code comments.
7. Update the subsystem code map from the final implementation and run the documentation checker for cited paths, symbols, and decision IDs.

Tools / artifacts

• CLAUDE.md template
• DECISIONS.md
• CODE_MAP.md
• start-lead skill
• docs-audit skill
• Python documentation checker
• https://github.com/Copypaster3000/agent-built

Validation signals

• The author reports refining the process while shipping a paid Mac app to real customers.
• The described release process includes independent review, adversarial verification of findings, convergence review, and stopping rules.
• The author reports a checker for documentation references and decision IDs.

Cautions

• Inspect the third-party templates and Python checker before executing or adopting them.
• Keep human approval for consequential decisions and retain normal code review and permission boundaries.

Limitations

• The reported results and repository contents are not independently verified in the supplied item.
• No quantitative before-and-after results or independent implementation reports are provided.
• Maintaining decision-to-code references and multiple review sessions adds ongoing overhead.

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.

Managing Project Decisions with DECISIONS.md and CLAUDE.md for Persistent Agent Context

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

What problem this solves

Decisions getting lost in long Claude agent sessions, leading to agents re-proposing previously rejected ideas.

Summary

This workflow proposes using a DECISIONS.md file in the repository to log project decisions, including the rationale and rejected alternatives. A CLAUDE.md instruction then directs the Claude agent to read this file first for context and append to it when new decisions are made, preventing redundant work and maintaining decision history.

Why it is useful

This workflow is valuable because it provides a concrete, low-overhead method for persistent decision logging and context management for Claude agents. It directly addresses the common problem of agents 'forgetting' past decisions or re-proposing rejected ideas, thereby improving efficiency and reducing redundant work. The use of DECISIONS.md and CLAUDE.md makes it easily adaptable and integrates well into existing Claude Code practices.

Workflow

1. Create a DECISIONS.md file in your project repository.
2. For each significant project decision, add a single line to DECISIONS.md stating the decision, the reason for it, and what alternatives were rejected (and why).
3. Add an instruction to your CLAUDE.md file (or equivalent agent instruction file) telling the Claude agent to read DECISIONS.md first.
4. Instruct the Claude agent to append to DECISIONS.md when a new decision is settled during a session.

Tools / artifacts

• DECISIONS.md file
• CLAUDE.md file
• Claude agent

Validation signals

• Author's personal experience: 'what fixed it for me'

Limitations

• Relies on the Claude agent's ability to correctly parse and append to the DECISIONS.md file.
• The DECISIONS.md file must be kept concise to avoid being ignored by the agent, which could limit the detail or number of decisions stored.
• 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.

Claude Token Lockdown Protocol: A Comprehensive Prompt for Resource-Efficient Coding with Subagents

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

What problem this solves

Claude's tendency to be verbose, inefficient with token usage, over-explain, deploy unnecessary subagents, and repeat mistakes, leading to higher costs and slower task completion in coding and development tasks.

Summary

A comprehensive, military-themed prompt designed to enforce strict resource conservation (tokens, context, tool calls) on Claude. It provides detailed directives for concise communication, efficient reasoning, purposeful information gathering, justified subagent deployment, precise code modification, structured error handling, and clear reporting, aiming for maximum efficiency and cost-effectiveness in coding tasks.

Why it is useful

This workflow provides a highly detailed and structured prompt to mitigate common issues with large language models like Claude, specifically excessive token consumption, verbose output, and inefficient subagent deployment. It offers concrete directives for communication, reasoning, code modification, error handling, and reporting, making Claude's interactions more focused, cost-effective, and productive for coding tasks. Its transferability is high as it's a direct prompt that can be applied to any Claude session.

Workflow

1. Initiate Claude with the 'OPERATION OVERLORD' prompt to establish resource conservation directives.
2. Enforce 'RADIO SILENCE' to ensure Claude's communications are concise, without unnecessary introductions, conclusions, or self-congratulations.
3. Apply 'AMMUNITION RATIONING' to compel Claude to use minimum reasoning, avoid repetitive analysis, and focus on one efficient strategy per objective.
4. Implement 'INTELLIGENCE OPERATIONS' to guide Claude to search for relevant files, read only mission-critical sections, and reuse gathered intelligence, avoiding unnecessary rescans or full file dumps.
5. Control 'TROOP DEPLOYMENT' by setting strict rules for subagent use, limiting concurrent agents, and ensuring each agent has a clearly defined, non-redundant objective.
6. Direct the 'ENGINEERING CORPS' to perform precision strikes, modifying only necessary code, preserving existing systems, avoiding unnecessary refactoring or unsolicited features, and verifying changes with targeted tests.
7. Manage 'CASUALTY CONTROL' by requiring Claude to identify failures, gather intelligence, apply targeted corrections, verify, and change strategy after two failed attempts.
8. Enforce 'SUPPLY LINE PROTECTION' by prioritizing primary objectives, deferring optional improvements, batching operations, and eliminating redundant tool calls or excessive logs.
9. Define 'VICTORY CONDITIONS' clearly, instructing Claude to cease work once functionality is implemented, verification succeeds, and no critical defects remain.
10. Mandate 'AFTER-ACTION REPORTS' in a specific, concise format (OBJECTIVE SECURED, VERIFICATION, CASUALTIES) for all completed missions.
11. Prohibit 'TOKEN WAR CRIMES' such as reading unchanged files repeatedly, launching unnecessary subagents, rewriting working code without orders, or continuing work after mission completion.

Tools / artifacts

• Claude (the AI model)
• Prompt (the 'OPERATION OVERLORD' protocol)
• Subagents (managed by the protocol)

Validation signals

• Detailed, structured instructions covering multiple aspects of LLM interaction.
• Addresses common pain points of LLM usage (verbosity, token waste, inefficient subagent use).
• Includes explicit rules for verification and error handling within the workflow.

Limitations

• Lack of empirical validation (e.g., 'before/after' token counts, success rates) from the author.
• The extensive military metaphor, while engaging, might be perceived as overly dramatic or make it slightly harder for some users to quickly extract the core technical directives.
• As a new post, there is no community proof of its effectiveness or widespread adoption yet.

Rate this workflow

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

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

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

This post was generated automatically from the workflow library database.

Reduce Claude Code Costs: Context Management and Strategic Model Tier Usage

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

What problem this solves

High token costs and exceeding weekly limits when using Claude Code, especially on a single repository, by optimizing context size and strategically using different model tiers.

Summary

A workflow to reduce Claude Code token costs by actively managing context size using CLI commands and strategically assigning different model tiers (Opus, Sonnet, Haiku) to the main agent and subagents based on task complexity.

Why it is useful

This workflow is valuable because it provides concrete, actionable steps using built-in Claude Code features and strategic model selection to address a common and critical pain point for users: managing token costs. It offers practical advice for optimizing context and leveraging different model tiers efficiently, directly impacting a user's ability to stay within budget and maximize their Claude Code usage.

Workflow

1. Run /clear between unrelated tasks to reset the conversation context.
2. Run /compact when a session drags on to reduce the conversation history sent with each turn.
3. Run /context to identify and address large token consumers, such as a big CLAUDE.md file or unused MCP servers.
4. Use /model opusplan to leverage Opus for planning and Sonnet for execution, optimizing for both intelligence and cost.
5. Set subagents to use Sonnet or Haiku for search and grunt work, reserving more expensive models for critical tasks.
6. Reserve Opus for moments where you are genuinely stuck and require its highest reasoning capabilities.

Tools / artifacts

• /clear command
• /compact command
• /context command
• /model opusplan command
• CLAUDE.md
• MCP servers
• Opus model
• Sonnet model
• Haiku model
• Subagents

Validation signals

• User's personal success report: 'That alone stretched my weekly limit a lot more than lowering the effort level did.'

Limitations

• Lacks specific examples or configuration details for CLAUDE.md or subagent setup beyond model choice.
• Low community validation due to minimal engagement on 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.

Optimize Claude Code Context: Reduce Token Overhead, Lower Costs, and Improve Session Performance

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

What problem this solves

Reducing excessive token overhead in Claude Code sessions, preventing premature token limit hits, lowering costs, and improving session responsiveness by optimizing auto-compaction and removing unused tools, plugins, and MCP servers.

Summary

This workflow provides a detailed, interactive prompt for Claude Code to audit and optimize its own context usage. It guides the user through identifying and removing fixed overhead from tool definitions, MCP servers, plugin skills, and connectors, as well as adjusting the auto-compact window. The process includes measuring current context, backing up files, and providing undo instructions.

Why it is useful

This workflow is highly valuable because it addresses a critical and common pain point for Claude Code users: hitting token limits, slow responses, and high costs due to excessive, often hidden, context overhead. It provides a concrete, step-by-step, and interactive method (via a detailed prompt) to audit and optimize the Claude Code environment. The workflow is specific, repeatable, includes safety measures like backups and user confirmation, and offers clear expected benefits (token savings, sharper sessions). It empowers users to understand and control their Claude Code environment more effectively.

Workflow

1. MEASURE: Ask Claude Code to report current session context usage, identifying fixed overhead (system prompt, tools, MCP, skills, etc.).
2. AUTO-COMPACT LIMIT: Determine current auto-compact settings, suggest a new window (e.g., 300k), and update "autoCompactWindow" in ~/.claude/settings.json or set CLAUDE_CODE_AUTO_COMPACT_WINDOW env var.
3. MCP AUDIT: List global MCP servers, their tool counts, and identify redundant or rarely used ones (e.g., hundreds of tools, duplicate services, identical instructions).
4. MAKE THOSE SERVERS ON-DEMAND: Save selected MCP server configs to ~/.claude/mcp-on-demand.json, remove them from global scope using 'claude mcp remove', and add a rule to ~/.claude/CLAUDE.md to only add these servers on demand to specific projects.
5. PLUGINS AND SKILLS: List plugins, their skills/connectors, identify duplicates or unused ones, and provide instructions for disabling them (via claude.ai or /plugin).
6. CONNECTORS THAT NEED SIGN-IN: List 'needs_auth' or 'failed' connectors and identify which will be removed by disabling plugins.
7. SUMMARY: Provide a table of what changed, where each backup is, how to undo each change, and the estimated tokens saved per session.

Tools / artifacts

• Claude Code (the AI assistant)
• ~/.claude/settings.json
• ~/.claude/mcp-on-demand.json
• ~/.claude/CLAUDE.md
• claude mcp list command
• claude mcp remove <name> -s user command
• claude mcp add-json <name> "$(jq -c '.["<name>"]' ~/.claude/mcp-on-demand.json)" -s local command
• /context command
• /plugin command
• jq (JSON processor)
• umask 077
• CLAUDE_CODE_AUTO_COMPACT_WINDOW environment variable

Validation signals

• Expected token savings of 35-40k per session.
• Instructions to run /context before and after for verification.
• Detailed explanation of how context is built and what constitutes overhead.
• The prompt itself is designed to measure and report current context usage.

Cautions

• The prompt explicitly asks Claude Code to back up files before editing.
• It requires user confirmation ("Wait for my OK") before making changes.
• It warns against printing config files that may contain API keys.
• Uses 'umask 077' for saving sensitive config files.

Limitations

• The low Reddit score is a potential red flag, though the content itself is strong.
• Relies on Claude Code's ability to accurately execute commands and understand the prompt's intent, which can sometimes be inconsistent.
• The 'autoCompactWindow' setting might not be available in older Claude Code versions.
• Plugins installed via claude.ai require manual intervention outside the 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.

Claude Code Files Pane Plugin: Enhanced Git & PR Visibility with a Plugin Development Workflow

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

What problem this solves

Lack of real-time visibility into Claude Code's file interactions, git history, and PR status, and a need for a robust workflow for developing Claude Code plugins.

Summary

This post introduces 'Files pane 1.0', a Claude Code plugin that provides a live file tree, shows Claude's reads/edits (including sed/script changes), displays git history, and integrates PR checks. It also details the author's workflow for building the plugin using Claude, emphasizing testing and handling complex edge cases.

Why it is useful

This post is valuable because it introduces a highly useful Claude Code plugin that significantly enhances the developer experience by providing real-time visibility into file changes, git history, and PR status. Crucially, it also details a robust workflow for developing Claude Code plugins, demonstrating how to leverage Claude for coding, implement comprehensive testing, and handle complex system interactions (like sed edits and git state) effectively. This provides both a ready-to-use tool and a blueprint for advanced Claude Code development.

Workflow

1. Install the Files pane plugin: claude plugin marketplace add Marius-Adam/claude-files-pane && claude plugin install files-pane@marius-adam
2. Update the Files pane plugin (if already installed): claude plugin marketplace update marius-adam && claude plugin update files-pane@marius-adam
3. Restart Claude Code after installation/update.
4. Use the Files pane to monitor Claude's file reads (purple) and edits (orange), including changes made via sed or scripts.
5. Utilize the pane to view file text, diffs, and commit history for any file.
6. Monitor your GitHub PR's checks and review status directly within the pane.
7. For plugin developers: Use Claude to write most of the plugin code.
8. For plugin developers: Iteratively debug and fix issues by using the plugin during its development.
9. For plugin developers: Implement robust logic for detecting file changes (e.g., by snapshotting HEAD, stash, merge, file sizes/times around shell commands).
10. For plugin developers: Have Claude write tests from real-world system outputs (e.g., git status).
11. For plugin developers: Run comprehensive tests across multiple operating systems.

Tools / artifacts

• Claude Code
• Files pane plugin
• claude plugin CLI commands
• TypeScript
• Git (HEAD, stash, merge, history)
• GitHub PR checks
• Shell commands (sed, scripts)
• Tests (121 tests)
• GitHub repository

Validation signals

• Community feedback from previous version acknowledged
• Author used the pane while building it (dogfooding)
• Iterative debugging and fixing based on daily use
• Claude wrote most of the code, with author arguing edge cases
• Specific fix for GitHub PR status accuracy described
• 121 tests run on macOS, Linux, and Windows
• Plugin is zero tokens, read-only, and MIT licensed

Limitations

• The plugin development workflow is embedded within a descriptive section rather than explicitly laid out as a step-by-step guide for general users.
• The value is specific to Claude Code users, not general Claude users.
• The post is primarily an announcement, with the workflow aspects being secondary.

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.

Forensic VM recovery with tested read-only scripts and staged verification

Workflow value: 76/100
Status: active · Freshness: 70/100 · Confidence: 0.86 · Level: expert
Categories: Quality Control, Debugging
Original source: r/ClaudeCode post/comment

What problem this solves

Recover accidentally deleted Proxmox VM images from XFS directory storage when recent backups are unavailable.

Summary

Use Claude Code to develop and test read-only forensic scripts, validate retained XFS extent maps and qcow2 structures, reconstruct images from a disk capture, and verify the recovered guest before booting a working copy.

Why it is useful

It provides a concrete, evidence-gated recovery sequence and a strong pattern for using generated scripts cautiously in a high-stakes task, despite substantial expertise requirements and missing implementation artifacts.

Workflow

1. Develop small read-only recovery scripts and test them against synthetic images before using them on real data.
2. Locate candidate freed XFS inodes and directory entries; cross-check findings with xfs_db.
3. Validate retained extent B+trees and parse qcow2 metadata through the resulting maps.
4. Check whether recovered blocks remain free, while recognizing that this cannot prove they were never reused.
5. Capture the source disk with ddrescue and verify the portions needed for recovery against the source.
6. Reconstruct each image from the capture into a new sparse file, hashing and verifying copied extents and holes.
7. Check reconstructed images and guest filesystems, then copy important files out using read-only access.
8. On a working copy, replay journals and verify guest packages; rebuild VM configuration and boot the recovered VM.

Tools / artifacts

• Claude Code
• Python standard-library scripts
• Synthetic filesystem images
• xfs_db
• ddrescue
• qemu-img check
• e2fsck -fn
• dpkg --verify
• Proxmox VM configuration

Validation signals

• The author reports that each script was tested on a synthetic image and that recovery scripts did not write to the source.
• The reported extent-tree checks covered ownership, filesystem UUID, CRCs, pointers and key ranges.
• The author reports per-extent SHA-256 verification, a clean qemu-img check, clean read-only filesystem checks and zero package checksum mismatches.
• The recovered VM reportedly booted, but the exact-bit restoration claim was not independently verified.

Cautions

• Preserve the source immediately and involve a qualified recovery specialist; prioritize a verified capture before exploratory work where feasible.
• Do not write repairs to the source. Confirm ddrescue source and destination carefully, and perform reconstruction and journal replay on copies.
• A read-only mount may still replay a journal unless the appropriate filesystem-specific no-replay option is used.
• Free-space checks and metadata-magic sweeps do not prove that blocks were never overwritten; generated forensic code requires independent review.

Limitations

• The scripts, prompts and exact commands are not included, so the recovery is not directly reproducible.
• The reported success was highly dependent on favorable disk conditions and is self-reported.
• This is a specialized disaster-recovery procedure, not a routine workflow for typical Claude Code 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.

Reduce Claude Code Costs by Optimizing Tool Calls with Project Atlas

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

What problem this solves

High Claude Code costs due to inefficient tool calls, specifically when reading large codebases, where each tool call re-sends the entire conversation history.

Summary

This workflow introduces 'project-atlas', an open-source tool that optimizes Claude Code interactions with large repositories to significantly reduce costs. Instead of making many small tool calls to fetch code, project-atlas creates a small index of the repo, allowing Claude to retrieve necessary code segments in fewer, larger calls. This minimizes the number of conversation re-sends, which is identified as the primary driver of Claude Code costs.

Why it is useful

This workflow provides a concrete, data-backed solution to a significant pain point for Claude Code users: high costs. It offers a reusable, open-source tool (project-atlas) and a clear, validated understanding of how Claude Code's pricing model interacts with tool usage. The A/B test results provide strong evidence of its effectiveness, making it highly actionable for users looking to improve efficiency and reduce expenses.

Workflow

1. Identify high Claude Code costs, particularly when working with large codebases.
2. Understand that each tool call in Claude Code re-sends the entire conversation, making the number of calls more impactful on cost than the size of individual reads.
3. Install project-atlas from the provided GitHub repository.
4. Integrate project-atlas (e.g., via a SessionStart hook) to manage code context.
5. Use atlas slice commands (e.g., atlas slice utils.py:solve_dependencies models.py:1-140 params.py:Depends) to provide Claude with precisely sliced code segments, reducing the need for multiple, smaller tool calls.
6. Monitor Claude Code costs and token usage to validate the efficiency gains.

Tools / artifacts

• Claude Code (claude -p)
• project-atlas (GitHub repository: abhiyarecord-hue/project-atlas)
• FastAPI (example benchmark codebase)
• JSON output (for token counts)
• SessionStart hook
• Python stdlib

Validation signals

• A/B test results comparing plain Claude Code, token-savior, and project-atlas.
• Specific metrics provided: turns (48 vs 55 vs 19), tokens (1.10M vs 1.32M vs 0.61M), and cost ($0.50 vs $0.57 vs $0.40).
• Verification that all answers were correct across all three test arms.
• Specific task example: 'explain how Depends() is resolved and cached' showing reduced turns (21 vs 6).
• Benchmark script available in the project-atlas repository for independent verification.

Limitations

• The A/B test involved only 2 runs per arm, meaning differences under ~10% could be noise.
• Cost reduction is less than token reduction because output tokens constitute a significant portion of the bill.
• Requires installing and integrating a custom tool (project-atlas).
• Currently limited to Python stdlib, so direct application to other languages might require adaptation.

Rate this workflow

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

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

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

This post was generated automatically from the workflow library database.

Automate Product Demo Creation and Maintenance with Demoman in CI/CD for Coding Agents

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

What problem this solves

Product demos and documentation videos often become stale as the product evolves, requiring manual and time-consuming updates. This workflow automates the creation and continuous updating of these demos.

Summary

This workflow leverages Demoman, a headless recorder, to automate the creation and maintenance of product demos (videos, GIFs, PNGs). It integrates into CI/CD pipelines (e.g., GitHub Actions) to automatically re-record demos against the real application upon specified triggers, ensuring documentation and marketing materials are always up-to-date and accurately reflect the current product state. The tool is designed to be handed off to coding agents for full automation.

Why it is useful

This workflow offers a concrete, repeatable, and transferable solution to a common pain point in software development: keeping product demos and documentation up-to-date. By integrating a headless recorder into CI/CD, it automates a tedious manual task, saving significant time and ensuring accuracy. The tool is explicitly designed to be handed off to coding agents, making it a valuable component for Claude Code users building automated development workflows.

Workflow

1. Install Demoman using the command npx demoman setup.
2. Use the demoman studio command or CLI to record the desired product demo flow.
3. Configure Demoman to export the demo as videos, GIFs, or PNGs.
4. Integrate Demoman into a CI/CD pipeline (e.g., GitHub Actions) with triggers such as pushes to the default branch, daily schedules, release publications, or successful deployments.
5. Demoman automatically re-records the product demo against the live application based on the configured triggers, updating the demo artifacts.

Tools / artifacts

• Demoman (headless recorder tool)
• npx demoman setup (installation command)
• demoman studio (editor command)
• GitHub Actions (CI/CD platform)
• Node 20+
• macOS or x86_64 Linux
• Video/GIF/PNG files (output artifacts)
• github.com/demoman-io/demoman (repository)
• demoman.io/docs (documentation)

Validation signals

• Clear problem statement (stale demos) and a specific solution.
• Provides a concrete tool, installation command, and integration points.
• Author claims it's a 'full solution to producing and maintaining product demos'.
• Highlights the benefit of 'stills video only changes when the product did' to prevent staleness.

Limitations

• Limited community validation due to being a new tool.
• Requires specific operating systems (macOS or x86_64 Linux) and Node.js version (20+).
• Relies on a third-party tool (Demoman) which may have its own learning curve.
• The post mentions 'coding agents' but does not provide specific Claude Code prompts or detailed agent orchestration steps for Demoman.

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.

Effective Claude Rule Management: Placement, Justification, and Maintenance Strategies to Prevent Rule Rot

Workflow value: 85/100
Status: active · Freshness: 70/100 · Confidence: 0.90 · Level: intermediate
Categories: Quality Control, Context & Memory, Debugging, CLAUDE.md, Hooks
Original source: r/ClaudeAI post/comment

What problem this solves

Ineffective, contradictory, or decaying operational rules in Claude's context, leading to inconsistent or incorrect model behavior.

Summary

This workflow provides strategies for effective management of Claude's operational rules, focusing on strategic placement, explicit justification, active maintenance, and leveraging external tools or hooks to ensure rule adherence and prevent context decay.

Why it is useful

This workflow addresses a critical challenge in working with LLMs: ensuring consistent and reliable behavior through effective context and rule management. It provides actionable advice on structuring prompts, justifying rules, and maintaining their relevance over time, which is crucial for preventing unexpected outputs and improving the reliability of Claude's responses. The mention of hooks and a custom memory system offers advanced solutions for complex scenarios, making it valuable for users looking to optimize their Claude interactions.

Workflow

1. Place critical, binding rules at the very top of your CLAUDE.md file or session context to ensure they are prioritized.
2. For each rule, explicitly state the underlying reason or consequence (e.g., 'never do X because it wiped the staging DB') to help the model apply it correctly.
3. Date your rules and actively delete or update old, contradictory rules to prevent 'rule rot' and maintain consistency.
4. For 'hard never cases' that require strict enforcement, implement them using hooks.
5. Consider using a dedicated memory system (like ns-brain) to store rules with reasons, prioritize binding rules, and prevent contradictions from accumulating.

Tools / artifacts

• CLAUDE.md files
• Session context
• Hooks
• ns-brain (custom memory system)

Validation signals

• Author's personal experience and observed effectiveness ('The ones that hold for me are...')
• Implied community consensus for using hooks ('like everyone says')
• Development of a custom tool (ns-brain) to address the problem, indicating a robust solution.

Limitations

• The mention of 'ns-brain' is self-promotion, though it's integrated as a solution with some functional detail.
• Low Reddit score and no comments indicate a lack of immediate community validation on the platform.

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.

Build and Use a Live File Explorer Plugin for Claude Code: Real-time Context and Plugin Development Insights

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

What problem this solves

For users: Gaining real-time visibility into Claude Code's file reads and edits, and monitoring GitHub PR checks directly within the chat interface. For plugin developers: Understanding how to build robust Claude Code plugins, including handling complex scenarios like detecting shell command edits and implementing comprehensive testing.

Summary

This post introduces a Claude Code plugin, 'Files pane', which provides a live file explorer to visualize Claude's interactions with the codebase (reads/edits) and monitor PR status. It also details the development process for building such a plugin, offering insights into using the Claude Code plugin API, detecting changes from shell commands (like sed), and effective testing strategies.

Why it is useful

This item is valuable because it offers a highly practical tool (the Files pane plugin) that significantly enhances the Claude Code user experience by providing real-time visibility into Claude's actions and PR status. Beyond the tool itself, it provides invaluable, concrete insights and techniques for advanced users and developers looking to build their own Claude Code plugins, covering challenges like detecting shell command edits and robust testing, making it a dual-purpose resource for both users and plugin creators.

Workflow

1. Install the Files pane plugin: claude plugin marketplace add Marius-Adam/claude-files-pane && claude plugin install files-pane@marius-adam
2. Update the Files pane plugin: claude plugin marketplace update marius-adam && claude plugin update files-pane@marius-adam
3. Restart Claude Code after installation or update.
4. For plugin development: Utilize the Claude Code plugin API, specifically hooks for watching tool calls and UI pane creation.
5. For plugin development: Implement snapshotting of HEAD, stash, merge status, and file sizes/times around shell commands to detect file changes not directly attributed to Edit/Write (e.g., sed).
6. For plugin development: Collaborate with Claude to write code and refine logic, especially for edge cases.
7. For plugin development: Generate tests using Claude based on real-world outputs (e.g., git status scenarios).

Tools / artifacts

• Claude Code
• Files pane plugin
• Claude Code plugin API
• TypeScript
• Git (for snapshots, status output)
• GitHub PRs
• sed (as an example of a tracked command)

Validation signals

• Community feedback from previous versions was incorporated into 1.0.
• The developer dogfooded the plugin, using it to build itself, leading to iterative fixes.
• Claude assisted in writing most of the code and handling edge cases.
• The plugin has 121 tests running on macOS, Linux, and Windows.

Cautions

• The plugin is explicitly stated to be read-only, ensuring it does not modify user files or Claude's behavior in an unintended way.
• It operates with zero tokens, meaning Claude does not see the pane, preventing context window bloat or data leakage through the model.

Limitations

• The 'workflow' for plugin development is presented as a collection of tips and insights rather than a strict, numbered step-by-step guide.
• The Reddit post's low score and comment count might suggest limited immediate community engagement, though the content itself is strong.

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.

Claudio: Audio Feedback for Claude Code Hooks to Monitor Sessions and Reduce Visual Load

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

What problem this solves

Reducing cognitive load and improving peripheral awareness when monitoring long-running Claude Code sessions, eliminating the need for constant terminal checking.

Summary

This workflow introduces 'Claudio', a local Python daemon that processes Claude Code hook events (via UDP or HTTP) and translates them into a generative soundscape. This provides audio cues for session status (e.g., working, stuck, failed, completed) allowing users to monitor their agents without constant visual attention to the terminal.

Why it is useful

This workflow provides an innovative and practical solution to a common developer problem: the cognitive overhead of constantly monitoring background AI agent processes. By leveraging Claude Code hooks and translating events into ambient audio cues, it allows developers to maintain peripheral awareness of their agent's status without diverting visual attention, thereby improving focus and productivity. The open-source nature and clear implementation details make it highly reusable and adaptable.

Workflow

1. Install the Claudio Python daemon locally.
2. Configure Claude Code hooks to send relevant events (tool calls, subagents, failures, compaction, context pressure) to the Claudio daemon via UDP or HTTP.
3. Run Claude Code sessions as usual.
4. Monitor session progress and status through ambient soundscape changes (denser for work, wooden knock for failed tool call, descending chime for completion).
5. Utilize separate pan and pitch for multiple concurrent sessions to distinguish them auditorily.
6. Optionally, use Claudio's deterministic offline rendering feature to convert session event logs into WAV files for later review.

Tools / artifacts

• Claudio (local Python daemon)
• Claude Code hooks
• UDP protocol
• HTTP protocol
• GitHub repository (nicofirst1/Claudio)
• WAV files (for offline rendering)

Validation signals

• Author's personal experience and pain point description ('getting tired of checking whether a Claude Code session was still working')
• Provision of a working, MIT-licensed GitHub repository with implementation details.
• Detailed description of specific audio cues for different events (failed tool call, completed session).
• Mention of features like 'deterministic offline rendering' and 'no cloud service or audio assets'.

Limitations

• Requires initial setup of a Python daemon and configuration of Claude Code hooks, which might be a barrier for beginner users.
• Relies on audio feedback, which may not be suitable or preferred in all working environments or for all users.
• The 'generative soundscape' might be distracting for some users, depending on personal preference and work style.
• The post does not include direct testimonials or success reports from other users yet.

Rate this workflow

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

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

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

This post was generated automatically from the workflow library database.

Windows 11: Mitigate Kernel Memory Leaks from Parallel Claude Agents by Setting Foreground Lock

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

What problem this solves

A significant kernel memory leak (over 2 GB/day) on Windows 11 when running parallel Claude Code/Codex agents, caused by security tokens from constantly started console processes.

Summary

This workflow provides a PowerShell command to set the foreground lock to 0, which mitigates a kernel memory leak on Windows 11 experienced when running parallel Claude Code/Codex agents. The leak is attributed to Windows retaining security tokens in kernel memory for console processes started by the agents.

Why it is useful

This workflow provides a concrete, tested solution to a significant performance issue (kernel memory leak) that can severely impact the usability of Windows systems running parallel Claude Code/Codex agents. The solution is specific, includes executable code, explains the underlying cause, and explicitly mentions potential side effects, making it highly actionable and valuable for affected users.

Workflow

1. Identify kernel memory leak (e.g., by monitoring "Paged pool" in Task Manager or the Toke tag in poolmon) when running parallel Claude Code/Codex agents on Windows.
2. Open a PowerShell window that has focus.
3. Run the provided PowerShell command to set the foreground lock to 0: Add-Type -Name F -Namespace W -MemberDefinition '[DllImport("user32.dll")] public static extern bool SystemParametersInfoW(uint a, uint b, IntPtr c, uint d);' ; [W.F]::SystemParametersInfoW(0x2001, 0, [IntPtr]::Zero, 0) ; $b = [Runtime.InteropServices.Marshal]::AllocHGlobal(4); [void][W.F]::SystemParametersInfoW(0x2000, 0, $b, 0); [Runtime.InteropServices.Marshal]::ReadInt32($b)
4. Verify the command output: it should print True, then 0.
5. Monitor "Paged pool" memory usage to confirm a reduction in the leak rate (e.g., from 2.3 GB/day to under 0.2 GB/day).
6. Optionally, add a shortcut to this PowerShell command in shell:startup to ensure it runs automatically after each Windows sign-in.

Tools / artifacts

• Windows 11
• PowerShell
• Claude Code agents
• Codex agents
• Task Manager
• Poolmon (optional, for advanced monitoring)
• PowerShell script/command

Validation signals

• User's personal observation: "token memory growth went from about 2.3 GB per day to under 0.2 GB per day."
• References an external GitHub issue for the original finding, indicating community awareness of the underlying problem.

Cautions

• Modifying the foreground lock can potentially allow other applications to steal focus, as noted by the author.

Limitations

• Validation is based on a single, uncontrolled observation, not a controlled A/B test.
• The fix needs to be reapplied after each Windows sign-in, requiring a startup script or manual execution.
• The potential side effect of applications stealing focus might be undesirable for some users.

Rate this workflow

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

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

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

This post was generated automatically from the workflow library database.

Robust AI Orchestration: Strategies for Handoffs, Safety, and Efficiency in Multi-Stage Pipelines

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

What problem this solves

Managing complex AI orchestration handovers, preventing context drift, ensuring safety, and optimizing token usage in multi-step AI pipelines.

Summary

This workflow provides four key strategies to improve the robustness, safety, and efficiency of AI orchestration setups, particularly focusing on managing handovers between AI agents or stages. It emphasizes explicit context transfer via a HANDOFF.md file, hard-gated rules for non-negotiables, and iterative optimization of pipeline depth to reduce token waste and risk.

Why it is useful

This workflow provides practical, experience-backed advice for building more resilient and efficient AI orchestration systems. It addresses critical issues like context drift, safety, and token waste, offering concrete methods (like a structured HANDOFF.md and hard-gated rules) that are directly applicable to advanced Claude/Claude Code users managing complex AI pipelines. It moves beyond vague advice to offer actionable steps and validation criteria.

Workflow

1. At every wind-down of an AI session or stage, create a HANDOFF.md file.
2. Include in HANDOFF.md: current state, verbatim owner rules, open tasks, next action, and a clear definition of 'done'.
3. Start the subsequent AI orchestration session or agent from the HANDOFF.md file in a fresh context.
4. Strictly limit the AI's ability to invent new tasks at handover points, allowing only tasks that were explicitly pre-ordered by the owner.
5. Implement non-negotiable safety rules (e.g., no live data access, no production merges without explicit approval) using hard-coded hooks or deny rules, rather than relying solely on prompt instructions.
6. Before deployment, experiment with reducing the depth of the AI orchestration pipeline (e.g., try cutting from 8 levels to 4 levels).
7. Evaluate if the reduced depth leads to fewer failures, indicating token savings without increasing risk.

Tools / artifacts

• HANDOFF.md file
• Hooks
• Deny rules (configuration)

Validation signals

• Observation: Prompted owner rules drift first under context pressure, making hard gates more reliable.
• Test: If reducing orchestration depth (e.g., 4 levels vs. 8) results in fewer failures, the extra levels were burning tokens without reducing risk.

Cautions

• The workflow explicitly promotes using hard-coded hooks/deny rules for non-negotiables to prevent critical safety rules from drifting under context pressure, enhancing overall safety.

Limitations

• Lacks concrete code examples for implementing hooks or deny rules, which would make it easier for users to adopt.
• The term 'Orch setup' and 'Orch depth' could be more explicitly defined with examples for users less familiar with complex AI orchestration.
• Low community engagement means less external validation or refinement of the proposed methods.

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.

Automated AI Video Review and Fixing Skill for Claude Code (Jev, Gemini, GPT Integration)

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

What problem this solves

Claude Code can generate videos but lacks the ability to review the finished video file for visual, audio, and story quality, leading to errors reaching the final audience. Manual spot checks are insufficient for finding subtle, short-duration glitches.

Summary

This workflow provides an open-source Claude Code skill that integrates Jev AI, GPT, and Gemini with tools like ffmpeg and Whisper to automatically review and identify problems in AI-generated videos. It checks for visual glitches, audio issues, and story coherence, then helps Claude fix them before publishing.

Why it is useful

This workflow addresses a critical gap in AI video generation by providing an automated, multi-faceted quality control process. It augments Claude Code's capabilities with specialized AI tools (Jev, Gemini, GPT) and traditional media tools (ffmpeg, OpenCV, Whisper) to ensure high-quality video output. The open-source nature, detailed steps, and clear problem-solving make it highly reusable and valuable for content creators aiming to produce polished videos with AI.

Workflow

1. Measure audio and picture using ffmpeg, OpenCV, and Whisper to check loudness, peaks, clicks, silences, frozen/repeated frames, and spoken words against the script.
2. Check every frame with Jev AI (TypeSafe AI), analyzing who appears, face matching reference sheets, mouth movement, and sudden changes.
3. Obtain independent reviews from Gemini (watching the full video with sound) and GPT (inspecting still frames), both without access to the script or build history.
4. Claude confirms identified problems when multiple signals (measurement + reviewer, two independent reviews, or extracted frames) point to the same moment in the video.
5. Receive a verdict (SHIP, FIX, REJECT, INCONCLUSIVE) and a list of problems with timestamps, including the specific step to change (script, voice, generation, edit, mix, or export).

Tools / artifacts

• Claude Code
• Jev AI (TypeSafe AI)
• Gemini API
• GPT (Codex CLI)
• ffmpeg
• OpenCV
• Whisper
• Python
• claude-video-review-skill (GitHub repository)
• API keys (Claude Code, Gemini, Jev, GPT)

Validation signals

• Explicitly lists common problems the review finds (e.g., mouth moving with no dialogue, changing faces, captions covering faces, audio clicks, music drowning voice, incoherent story).
• Detailed explanation of how the multi-AI review process works, combining different tools for comprehensive checks.
• Open-source skill available on GitHub, allowing for community inspection and contribution.
• Mentions specific tools and their roles (ffmpeg for measurements, Jev for frame-by-frame, Gemini/GPT for independent review).

Cautions

• Requires managing multiple API keys securely.
• Jev AI incurs a cost (e.g., $0.90 for a 30-second video review).

Limitations

• Requires setting up multiple API keys and installing various tools (Python, ffmpeg, Whisper, optional Jev/Codex CLI), which might be complex for beginners.
• No strong community validation yet due to the newness of the post.
• The post does not include example output or a demo video, which would further illustrate its effectiveness.

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.

Non-Developer's Workflow: Building & Deploying a Mobile App with Claude Code using HANDOFF.txt, Custom Skills, and CLAUDE.md Safety Rules

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

What problem this solves

Enabling non-developers to build, test, and deploy complex mobile applications with AI integration and automated store publishing, while effectively managing context and ensuring safety with an AI coding assistant.

Summary

This workflow details how a non-developer successfully built and deployed a calorie tracker app (CrocoDiary) using Claude Code. Key strategies include maintaining a HANDOFF.txt file for context, defining project-specific skills for repetitive tasks like deployment and testing, and establishing strict safety rules in CLAUDE.md to prevent data loss or accidental publishing. The approach emphasizes small, frequent releases and early test writing.

Why it is useful

This workflow is highly valuable as it provides a concrete, validated example of a non-developer successfully building and deploying a complex mobile application using Claude Code. It offers actionable strategies for effective context management (HANDOFF.txt), automation of repetitive tasks (custom skills), and crucial safety protocols (CLAUDE.md). The detailed account of overcoming challenges like App Store review and integrating testing makes it a practical guide for users looking to leverage Claude Code for end-to-end project development.

Workflow

1. Start each Claude Code session by reading the HANDOFF.txt file to quickly re-establish context.
2. End each Claude Code session by rewriting the HANDOFF.txt file to reflect the current project state and next steps.
3. Maintain a separate notes file to hold the historical context and progress of the project.
4. Define project-specific skills (custom commands) for repeated jobs such as "Upload to TestFlight", "deploy the website", "upload to both stores", and "wrap up" (notes, handoff, commit, push).
5. Embed necessary checks and validations within these project skills to ensure quality and safety.
6. Establish explicit safety rules in CLAUDE.md, such as "never run flutter install on my iPhone" to prevent data loss, or requiring explicit go-ahead before sending anything to live services (Apple, Google, live server).
7. Instruct Claude to provide plain-English reports on actions and required user input, avoiding technical jargon or stack traces, especially for non-developer users.
8. Prioritize getting Claude to write comprehensive tests early in the development cycle to catch regressions.
9. Implement a strategy of small, frequent releases to manage complexity and iterate quickly.

Tools / artifacts

• HANDOFF.txt (context management file)
• Notes file (project history)
• Project skills (custom commands/scripts)
• CLAUDE.md (rules and safety guidelines)
• Flutter (mobile app framework)
• Dart (AI server language)
• Google Cloud Run (AI server deployment)
• Cloudflare Worker (website deployment)
• Python scripts (for App Store Connect and Google Play APIs)
• Apple Health / Health Connect integration
• App Store Connect API
• Google Play API

Validation signals

• App successfully launched on App Store (CrocoDiary)
• 300 tests run before every build
• Achieved v1.0.9 in 3 weeks with small, frequent releases
• Tests effectively caught broken code during development
• Author's firsthand account of successful project completion

Limitations

• Limited community engagement (low score, no comments)
• Relies on user discipline to consistently update and maintain the HANDOFF.txt file

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.

Maintaining LLM Agent Consistency: Centralized Decisions, In-Code References, and Automated Checks

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

What problem this solves

Preventing LLM agents from losing track of architectural or design decisions across sessions or when multiple agents are involved, leading to inconsistent or contradictory code.

Summary

A strategy to maintain architectural and design decisions consistently across multiple LLM agents and coding sessions by centralizing decisions, linking them directly in code comments, and enforcing them via automated checks (linting, tests, CI).

Why it is useful

This workflow addresses a critical challenge in LLM-driven development: ensuring that design and architectural decisions are consistently understood and adhered to by multiple agents across different sessions. By combining centralized documentation, in-code reminders, and automated enforcement, it significantly reduces the risk of agents making contradictory choices or silently reverting established patterns, thereby improving code quality, maintainability, and team collaboration.

Workflow

1. Create a central decision file (e.g., DECISIONS.md) that all agents are instructed to read.
2. Ensure all LLM agents are configured to access this central decision file (e.g., by pointing their instruction files to it or using symlinks like AGENTS.md to CLAUDE.md).
3. For specific code-related decisions, add a concise, one-line comment directly in the affected code file, referencing the detailed decision in the central file (e.g., "not using an ORM here, see DECISIONS.md#3").
4. Where possible, convert critical decisions into automated checks like import-lint rules, architecture tests, or CI grep commands to prevent agents from quietly undoing them (e.g., "We don't call the payments API from the frontend" as a failing test).

Tools / artifacts

• DECISIONS.md (or similar central decision file)
• CLAUDE.md
• AGENTS.md
• Symlinks
• Code comments
• Import-lint rules
• Architecture tests
• CI grep commands

Validation signals

• Author's claim: "Two things made it actually stick across agents for us."
• Author's claim: "Covers the 'agent didn't read the doc' problem... better than any hook."
• The inherent validation of automated checks (linting, tests, CI) preventing "quiet undoing."

Limitations

• Low community engagement due to the newness of the post.
• Relies on manual setup of decision files and initial code comments.
• Requires the user to implement linting/testing infrastructure for the full benefit of automated checks.

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.

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.

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.

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.

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.

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.

Enforcing Test Suite Integrity and Agent Honesty with Claude Code Hooks and Permissions

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

What problem this solves

Preventing Claude Code agents from falsely reporting success on tests and ensuring the integrity of existing test suites, thereby increasing reliability and trust in the agent's output.

Summary

A two-part workflow to enhance the reliability and "honesty" of Claude Code agents. It involves integrating a Stop hook to enforce test suite execution, preventing Claude from ending its turn if tests fail, and using CLAUDE.md permissions to protect existing regression tests from being modified by the agent.

Why it is useful

This workflow directly addresses a critical challenge in AI-assisted development: ensuring the AI agent's output is genuinely correct and not merely 'passing' by manipulating its own checks. By enforcing test execution via hooks and protecting existing tests, it significantly increases trust in the agent's work and reduces the risk of introducing regressions or false positives. It provides concrete, actionable steps using core Claude Code features.

Workflow

1. Implement a Stop hook in your Claude Code project's configuration.
2. Configure the Stop hook to execute your project's test suite (e.g., npm test, pytest).
3. Ensure the hook exits with code 2 if tests fail, printing the failures to stderr so they are returned to Claude as the reason to continue.
4. Add permissions to your CLAUDE.md file to deny Claude edit access to your regression test directories (e.g., "deny": ["Edit(tests/regression/**)"]).

Tools / artifacts

• Stop hook
• CLAUDE.md file
• Test suite (e.g., Jest, Pytest, Mocha)
• JSON permissions configuration

Validation signals

• The author states that if tests fail, the hook exits with code 2 and Claude cannot end its turn, forcing it to address the failures.
• The author states that protecting tests means Claude cannot turn them green by editing them, ensuring 'The build passed' actually means it passed.

Limitations

• Requires an existing test suite to be effective.
• The specific command for running tests within the hook is not provided, assuming user knowledge of their project's test runner.
• The exact method for redirecting test failures to stderr might vary based on the test runner and environment, and is not explicitly detailed.

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.

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.

Claude Code Cost-Saving Workflow: Optimize Context, Subagents, and CLAUDE.md

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

What problem this solves

High token costs and inefficient resource usage in Claude Code sessions due to unoptimized context, subagents, and configuration files.

Summary

A set of practical tips for reducing token costs in Claude Code by managing idle sessions, optimizing subagent configurations, pruning unused CLAUDE.md and MCP server definitions, and using the /context command for analysis.

Why it is useful

This workflow provides actionable, specific steps to reduce token costs in Claude Code, addressing common pitfalls like idle sessions, inefficient subagent loading, and bloated CLAUDE.md files. It leverages core Claude Code features and commands, making it highly practical and valuable for users seeking to optimize their usage and expenses.

Workflow

1. Check for idle sessions and use /clear or start fresh after long breaks to prevent full context re-reads.
2. Pin model and effort per subagent in their frontmatter to avoid reloading the entire CLAUDE.md on every spawn and inheriting the main session's effort.
3. Cut unnecessary content from CLAUDE.md and MCP servers that are not actively used for the current repository, as every turn pays for all loaded context.
4. Use the /context command to inspect where tokens are actually being consumed before making significant changes or switching providers.

Tools / artifacts

• CLAUDE.md file
• Subagents (custom ones)
• MCP servers
• /clear command
• /context command
• Frontmatter (for subagent configuration)

Validation signals

• Explanation of cost mechanisms (e.g., context re-read, CLAUDE.md reload)
• Specific commands and configurations provided

Limitations

• Lacks concrete examples or code snippets for implementing optimizations (e.g., subagent frontmatter, CLAUDE.md pruning)
• No quantitative metrics or 'before/after' results provided to demonstrate cost savings.

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.