feature-new

You are orchestrating a comprehensive feature development workflow with multi-agent collaboration. Follow this structured process:

Phase 0: Codebase Exploration (Pre-Design Analysis)

IMPORTANT: This phase runs FIRST to understand the codebase context before researching solutions.

Step -1.1: Launch Parallel Research Agents

Use multiple web search tools IN PARALLEL (single message with 4 tool calls) to research:

1. Language Best Practices (Python + TypeScript for this project):

   • Search: "Python best practices 2025 FastAPI async patterns type hints"
   • Search: "TypeScript React best practices 2025 hooks patterns"
   • Focus: Modern idioms, async/await patterns, type safety, error handling

2. SOLID Design Principles (Keep It Simple):

   • Search: "SOLID principles practical examples Python TypeScript 2025 simple implementation"
   • Focus: Single Responsibility, Open/Closed, Liskov Substitution, Interface Segregation, Dependency Inversion
   • Look for: Simple, clear implementations (avoid over-engineering), minimal complexity patterns
   • Emphasize: Simplest solution that follows SOLID, avoid premature abstraction

3. Feature Design Patterns (Simplicity First):

   • Search: "simple software architecture patterns minimal complexity 2025"
   • Search: "KISS principle feature design patterns avoid over-engineering"
   • Focus: Minimal viable architecture, feature isolation, testability without complexity
   • Emphasize: Start simple, evolve as needed, avoid premature optimization

4. Domain-Specific Patterns (based on $ARGUMENTS):

   • Analyze the feature description in $ARGUMENTS
   • Determine the domain (e.g., "WebSocket" → real-time communication patterns)
   • Search: "{domain} design patterns best practices 2025"
   • Focus: Domain-specific anti-patterns, proven solutions, performance considerations

Step -1.2: Synthesize Research Findings

After ALL 4 parallel searches complete, synthesize the findings:

Create: .claude/specs/new-{feature-name}/00-research.md

# Best Practices Research: {feature-name}

**Research Date**: {date}
**Feature Domain**: {domain extracted from $ARGUMENTS}

## Language Best Practices

### Python
- [Key practices found from search 1]
- [Relevant async patterns]
- [Type hint best practices]

### TypeScript/React
- [Key practices found from search 1]
- [Modern React patterns]
- [TypeScript strict mode practices]

## SOLID Design Principles Application

### Single Responsibility
- [How to apply to this feature]
- [Examples from search]

### Open/Closed Principle
- [How to design for extension]
- [Plugin/strategy patterns]

### [Other SOLID principles...]

## Feature Design Patterns

### Applicable Patterns
- [Pattern 1: description and when to use]
- [Pattern 2: description and when to use]
- [Anti-patterns to avoid]

### Modularity Considerations
- [How to isolate this feature]
- [Dependency injection points]
- [Testing strategies]

## Domain-Specific Patterns

### {Domain} Best Practices
- [Domain-specific patterns from search 4]
- [Performance considerations]
- [Security considerations]
- [Common pitfalls in this domain]

## Recommendations for {feature-name}

Based on research, this feature should:
1. [Specific recommendation 1 based on SOLID + language practices]
2. [Specific recommendation 2 based on feature patterns]
3. [Specific recommendation 3 based on domain patterns]
4. [Anti-patterns to explicitly avoid]

## References
- [Links to key resources found]

Step -1.3: Present Research Summary

Present a brief summary to the user:

 BEST PRACTICES RESEARCH COMPLETE

Researched:
 Python + TypeScript best practices (2025)
 SOLID design principles application
 Feature design patterns (modularity, testability)
 {Domain}-specific patterns and anti-patterns

Key Recommendations:
- [Top 3 recommendations for this feature]

Full research saved to: .claude/specs/new-{feature-name}/00-research.md

This research will inform the architecture design in the next phase.