Skip to content

feat(quick): add --research flag for focused pre-planning research#958

Open
RyanAlberts wants to merge 1 commit intogsd-build:mainfrom
RyanAlberts:feat/quick-research-flag
Open

feat(quick): add --research flag for focused pre-planning research#958
RyanAlberts wants to merge 1 commit intogsd-build:mainfrom
RyanAlberts:feat/quick-research-flag

Conversation

@RyanAlberts
Copy link

What

Add --research flag to /gsd:quick that spawns a focused gsd-phase-researcher agent before planning. The flag is composable with existing --discuss and --full flags.

Changes

  • commands/gsd/quick.md — Updated argument-hint and objective to include --research
  • get-shit-done/workflows/quick.md — Added Step 4.75 (research phase), updated flag parsing, banner variants for all flag combinations, planner context to read RESEARCH.md, commit file list, and success criteria
  • get-shit-done/workflows/help.md — Updated Quick Mode section with --research documentation
  • README.md — Updated Utilities table and Quick Mode section
  • CHANGELOG.md — Added entry under Unreleased
  • tests/quick-research.test.cjs — 21 new tests covering frontmatter, workflow structure, file management, and banner variants

Why

Issue #317 (13 👍, priority: high, area: workflow) identifies a gap between /gsd:quick (no quality agents) and /gsd:new-milestone (full ceremony). Currently:

  • /gsd:quick skips research, discuss, plan-checker, verifier
  • /gsd:quick --full --discuss adds discuss + plan-checker + verifier but no research
  • /gsd:new-milestone requires full project ceremony

The --research flag completes the composable flag set, giving users the full quality pipeline for single tasks without milestone overhead: --discuss --research --full.

How it works

  1. User runs /gsd:quick --research "task description"
  2. Workflow parses --research flag → $RESEARCH_MODE
  3. After optional discussion (Step 4.5), new Step 4.75 spawns a single gsd-phase-researcher (not 4 parallel like full phases — quick tasks need targeted, not broad research)
  4. Researcher writes ${QUICK_DIR}/${next_num}-RESEARCH.md
  5. Planner receives RESEARCH.md in <files_to_read> to inform implementation choices
  6. RESEARCH.md is included in the final commit

Testing

  • 21 new tests in tests/quick-research.test.cjs — all pass
  • Full test suite: 556 tests pass, 0 failures
  • Tested on macOS
  • Tested on Windows
  • Tested on Linux

Checklist

  • Follows GSD style (no enterprise patterns, no filler)
  • Updates CHANGELOG.md for user-facing changes
  • No unnecessary dependencies added
  • Uses subagent_type spawning (no hardcoded $HOME paths in new code)
  • No API keys, secrets, or environment variables exposed
  • Cross-platform: workflow changes are markdown-only, tests use path.join()

Breaking Changes

None. The --research flag is additive — existing /gsd:quick, /gsd:quick --discuss, and /gsd:quick --full behavior is unchanged.

Made with Cursor

…sd-build#317)

Add composable --research flag to /gsd:quick that spawns a focused
gsd-phase-researcher before planning. Investigates implementation
approaches, library options, and pitfalls for the task.

Addresses the middle-ground gap between quick (no quality agents) and
full milestone workflows. All three flags are composable:
--discuss --research --full gives the complete quality pipeline.

Made-with: Cursor
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants