Skip to content

How to Use GSD Quick Mode for Ad-Hoc Tasks That Don't Need Full Planning Pipeline

Sometimes I have a small task that doesn’t need the full planning treatment. Maybe it’s a bug fix in a single file, or adding a simple feature. I don’t want to go through the whole discuss-plan-execute-verify pipeline for something that takes ten minutes. That’s where GSD quick mode comes in.

When to Use Quick Mode

Quick mode is designed for ad-hoc tasks that don’t need full planning. Think of tasks like:

  • Bug fixes in a single file
  • Adding a single endpoint or component
  • Simple refactoring (renaming, extracting utilities)
  • Configuration changes

These tasks still benefit from GSD’s guarantees, but they skip the optional steps that would slow things down.

What Quick Mode Gives You

When I run /gsd-quick, I still get the core GSD benefits:

  • GSD agents that execute my task
  • Atomic commits with clear messages
  • State tracking so I can see what happened

What quick mode skips by default:

  • Research phase (domain investigation)
  • Plan checking (plan verification)
  • Post-execution verification (deliverables check)

This makes it perfect for those “just get it done” tasks.

Flag Options for Enhanced Quick Mode

Quick mode becomes more powerful with optional flags:

Quick mode with discussion flag
/gsd-quick --discuss

The --discuss flag gathers context before planning. It surfaces gray areas like “what styling approach should I use for this button?” or “should this be a new file or modify existing code?”

Quick mode with research flag
/gsd-quick --research

The --research flag spawns a focused researcher before planning. I use this when I’m not sure how to approach the implementation.

Quick mode with validation flag
/gsd-quick --validate

The --validate flag adds plan-checking and verification. It gives me quality assurance without running the full pipeline.

Quick mode with full pipeline
/gsd-quick --full

The --full flag enables all phases: discussion, research, plan-checking, and verification. It’s the complete pipeline but in quick-task form.

Where Quick Plans Live

Quick mode stores plans separately from phase plans. They go into:

Quick mode output directory
.planning/quick/001-add-dark-mode-toggle/

The sequential numbering (001, 002, 003…) tracks quick tasks independently. This keeps my main planning directory clean while still maintaining history of ad-hoc work.

Example Usage

Let’s say I need to add a dark mode toggle to my app. I run:

Interactive quick mode prompt
/gsd-quick

GSD prompts me with interactive questions about what I want to do. I describe the task, and quick mode handles the execution with all the GSD guarantees.

If I’m unsure about implementation details, I add the research flag:

Quick mode with research
/gsd-quick --research

This way I get investigation into the best approach without the full planning overhead.

Choosing the Right Approach

Here’s how I decide:

  • Default quick mode: Straightforward task, I know what needs to be done
  • —discuss: Task has unclear requirements or multiple approaches
  • —research: I’m not sure how to implement it
  • —validate: I want quality checks without full pipeline
  • —full: Complex task but I want quick mode tracking

Summary

In this post, I explained how GSD quick mode handles ad-hoc tasks that don’t need full planning. Quick mode provides GSD guarantees (atomic commits, state tracking) while skipping research, plan-checking, and verification by default. I can enhance it with flags: --discuss for context gathering, --research for implementation investigation, --validate for quality checks, or --full for the complete pipeline. Quick plans live in .planning/quick/ with sequential numbering, keeping my main planning directory organized.

Final Words + More Resources

My intention with this article was to help others share my knowledge and experience. If you want to contact me, you can contact by email: Email me

Here are also the most important links from this article along with some further resources that will help you in this scope:

Oh, and if you found these resources useful, don’t forget to support me by starring the repo on GitHub!

Comments