Skip to content

a5c-ai/babysitter / library/methodologies/everything-claude-code/skills/research-first-dev

research-first-dev

Verified

Research-first development methodology that investigates existing solutions, brainstorms alternatives, and evaluates trade-offs before any implementation begins.

  • Parse the request into specific technical requirements
  • Identify the domain and relevant technology stack
  • List known constraints (time, resources, compatibility)
  • Define success criteria

2. Existing Solution Search

  • Search GitHub for similar implementations
  • Check package registries (npm, PyPI, crates.io, etc.)
  • Review documentation for framework-specific solutions
  • Identify relevant design patterns
  • Check for known anti-patterns to avoid

3. Alternative Brainstorming

  • Generate at least 3 alternative approaches
  • Include a "build" option and at least one "buy/reuse" option
  • Consider unconventional approaches

4. Trade-Off Evaluation

  • Complexity: implementation effort, learning curve
  • Time: development timeline, time-to-value
  • Risk: failure modes, dependency risks, maintenance burden
  • Scalability: growth limits, performance under load
  • Score each alternative on all 4 axes

5. Recommendation

  • Rank alternatives by composite score
  • Provide clear recommendation with justification
  • Include risk mitigation plan for chosen approach
  • Define go/no-go criteria

Iterative Retrieval

  • Start broad, narrow based on findings
  • Use confidence scoring to decide when to stop
  • Maximum 3 retrieval rounds per topic
  • Cache findings for reuse in subsequent phases

When to Use

  • New feature development (always)
  • Architecture changes
  • Technology selection
  • Dependency evaluation
  • Performance optimization strategy

Agents Used

  • planner (primary consumer)
  • architect (architecture-specific research)
add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution.Stars: 114kUpdated Claude CodeCodexVerifiedInstall
add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation.Stars: 114kUpdated Claude CodeCodexVerifiedInstall
diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope.Stars: 114kUpdated Claude CodeCodexVerifiedInstall
fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks.Stars: 114kUpdated Claude CodeCodexVerifiedInstall