From ab0bb0f57dff3e1a751e72e8f0bf9b1ea9699211 Mon Sep 17 00:00:00 2001 From: kazuki Date: Fri, 12 Dec 2025 22:09:50 +0700 Subject: [PATCH] fix: remove duplicate uppercase docs paths for macOS compatibility MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The repository had both uppercase (e.g., docs/User-Guide/) and lowercase (e.g., docs/user-guide/) paths tracked, causing persistent dirty state on case-insensitive filesystems (macOS, Windows). This commit removes the uppercase variants and keeps only lowercase paths, which is the conventional standard for documentation directories. ๐Ÿค– Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 --- docs/Developer-Guide/README.md | 172 --- docs/Developer-Guide/contributing-code.md | 401 ------- docs/Developer-Guide/documentation-index.md | 227 ---- .../Developer-Guide/technical-architecture.md | 356 ------ docs/Developer-Guide/testing-debugging.md | 324 ------ docs/Getting-Started/installation.md | 514 -------- docs/Getting-Started/quick-start.md | 492 -------- docs/Reference/README.md | 249 ---- docs/Reference/advanced-patterns.md | 323 ------ docs/Reference/advanced-workflows.md | 309 ----- docs/Reference/basic-examples.md | 553 --------- .../claude-code-history-management.md | 556 --------- docs/Reference/common-issues.md | 79 -- docs/Reference/diagnostic-reference.md | 338 ------ docs/Reference/examples-cookbook.md | 172 --- docs/Reference/integration-patterns.md | 319 ----- docs/Reference/mcp-server-guide.md | 755 ------------ docs/Reference/troubleshooting.md | 124 -- docs/User-Guide-jp/agents.md | 1029 ----------------- docs/User-Guide-jp/commands.md | 415 ------- docs/User-Guide-jp/flags.md | 388 ------- docs/User-Guide-jp/mcp-servers.md | 319 ----- docs/User-Guide-jp/modes.md | 726 ------------ docs/User-Guide-jp/session-management.md | 414 ------- docs/User-Guide-kr/agents.md | 865 -------------- docs/User-Guide-kr/commands.md | 367 ------ docs/User-Guide-kr/flags.md | 271 ----- docs/User-Guide-kr/mcp-servers.md | 340 ------ docs/User-Guide-kr/modes.md | 658 ----------- docs/User-Guide-kr/session-management.md | 311 ----- docs/User-Guide-zh/agents.md | 819 ------------- docs/User-Guide-zh/commands.md | 305 ----- docs/User-Guide-zh/flags.md | 270 ----- docs/User-Guide-zh/mcp-servers.md | 272 ----- docs/User-Guide-zh/modes.md | 603 ---------- docs/User-Guide-zh/session-management.md | 310 ----- docs/User-Guide/agents.md | 936 --------------- docs/User-Guide/commands.md | 367 ------ docs/User-Guide/flags.md | 273 ----- docs/User-Guide/mcp-servers.md | 339 ------ docs/User-Guide/modes.md | 659 ----------- docs/User-Guide/session-management.md | 310 ----- .../mcp-installation.md | 0 43 files changed, 17829 deletions(-) delete mode 100644 docs/Developer-Guide/README.md delete mode 100644 docs/Developer-Guide/contributing-code.md delete mode 100644 docs/Developer-Guide/documentation-index.md delete mode 100644 docs/Developer-Guide/technical-architecture.md delete mode 100644 docs/Developer-Guide/testing-debugging.md delete mode 100644 docs/Getting-Started/installation.md delete mode 100644 docs/Getting-Started/quick-start.md delete mode 100644 docs/Reference/README.md delete mode 100644 docs/Reference/advanced-patterns.md delete mode 100644 docs/Reference/advanced-workflows.md delete mode 100644 docs/Reference/basic-examples.md delete mode 100644 docs/Reference/claude-code-history-management.md delete mode 100644 docs/Reference/common-issues.md delete mode 100644 docs/Reference/diagnostic-reference.md delete mode 100644 docs/Reference/examples-cookbook.md delete mode 100644 docs/Reference/integration-patterns.md delete mode 100644 docs/Reference/mcp-server-guide.md delete mode 100644 docs/Reference/troubleshooting.md delete mode 100644 docs/User-Guide-jp/agents.md delete mode 100644 docs/User-Guide-jp/commands.md delete mode 100644 docs/User-Guide-jp/flags.md delete mode 100644 docs/User-Guide-jp/mcp-servers.md delete mode 100644 docs/User-Guide-jp/modes.md delete mode 100644 docs/User-Guide-jp/session-management.md delete mode 100644 docs/User-Guide-kr/agents.md delete mode 100644 docs/User-Guide-kr/commands.md delete mode 100644 docs/User-Guide-kr/flags.md delete mode 100644 docs/User-Guide-kr/mcp-servers.md delete mode 100644 docs/User-Guide-kr/modes.md delete mode 100644 docs/User-Guide-kr/session-management.md delete mode 100644 docs/User-Guide-zh/agents.md delete mode 100644 docs/User-Guide-zh/commands.md delete mode 100644 docs/User-Guide-zh/flags.md delete mode 100644 docs/User-Guide-zh/mcp-servers.md delete mode 100644 docs/User-Guide-zh/modes.md delete mode 100644 docs/User-Guide-zh/session-management.md delete mode 100644 docs/User-Guide/agents.md delete mode 100644 docs/User-Guide/commands.md delete mode 100644 docs/User-Guide/flags.md delete mode 100644 docs/User-Guide/mcp-servers.md delete mode 100644 docs/User-Guide/modes.md delete mode 100644 docs/User-Guide/session-management.md rename docs/{User-Guide => user-guide}/mcp-installation.md (100%) diff --git a/docs/Developer-Guide/README.md b/docs/Developer-Guide/README.md deleted file mode 100644 index 9742ec2..0000000 --- a/docs/Developer-Guide/README.md +++ /dev/null @@ -1,172 +0,0 @@ -# SuperClaude Framework Developer Guide - -A documentation suite for understanding and extending the SuperClaude Context-Oriented Configuration Framework. - -## Documentation Overview - -This Developer Guide provides documentation for understanding SuperClaude's context architecture and how to extend it: - -### [Contributing Code Guide](contributing-code.md) -**Purpose**: Guidelines for contributing context files and framework improvements -**Audience**: Contributors and framework maintainers -**Key Topics**: Adding context files, naming conventions, documentation standards - -### [Context Architecture Guide](technical-architecture.md) -**Purpose**: Understanding how context files work and are structured -**Audience**: Anyone wanting to understand or extend SuperClaude -**Key Topics**: Context file structure, import system, agent/command patterns - -### [Verification & Troubleshooting Guide](testing-debugging.md) -**Purpose**: Verifying installation and troubleshooting context file issues -**Audience**: Users and maintainers -**Key Topics**: File verification, common issues, diagnostic commands - -### [Documentation Index](documentation-index.md) -**Purpose**: Comprehensive navigation guide and topic-based organization -**Audience**: All users seeking efficient information discovery -**Key Features**: Skill level pathways, cross-references, quality validation, usage guidelines - -## Quick Navigation - -### For New Contributors -1. Start with [Contributing Code Guide](contributing-code.md#development-setup) for environment setup -2. Review [Technical Architecture Guide](technical-architecture.md#architecture-overview) for system understanding -3. Use [Testing & Debugging Guide](testing-debugging.md#quick-start-testing-tutorial) for testing basics - -### For System Architects -1. Begin with [Technical Architecture Guide](technical-architecture.md) for complete system design -2. Reference [Contributing Code Guide](contributing-code.md#architecture-overview) for component patterns -3. Review [Testing & Debugging Guide](testing-debugging.md#integration-testing) for validation frameworks - -### For Testing Engineers -1. Start with [Testing & Debugging Guide](testing-debugging.md) for comprehensive testing procedures -2. Reference [Contributing Code Guide](contributing-code.md#development-workflow) for development integration -3. Use [Technical Architecture Guide](technical-architecture.md#quality-framework) for architecture context - -## Key Framework Concepts - -### Context-Oriented Configuration -SuperClaude is a collection of `.md` instruction files that Claude Code reads to modify its behavior. It is NOT executing software. - -**IMPORTANT**: SuperClaude is NOT a CLI tool or executable software. When you see `/sc:` commands in documentation, these are **context trigger patterns** you type in Claude Code conversations, not terminal commands. - -### Agent Context Files -Specialized instruction sets that provide domain expertise when activated by `@agent-[name]` or automatically by keywords. - -### Command Context Files -Workflow patterns triggered by `/sc:[command]` **context patterns** (not CLI commands) that guide Claude Code through structured development tasks when you type them in Claude Code conversations. - -### MCP Integration -External tools (actual software) that can be configured to provide additional capabilities like documentation lookup or code analysis. - -## What SuperClaude Is NOT - -- โŒ **Not Software**: No code executes, no processes run -- โŒ **Not Testable**: Context files are instructions, not functions -- โŒ **Not Optimizable**: No performance to measure or improve -- โŒ **Not Persistent**: Each Claude conversation is independent - -## Documentation Features - -### Cross-Referenced Integration -All three documents are strategically cross-referenced, enabling seamless navigation between development workflows, architectural understanding, and testing procedures. - -### Accessibility & Inclusivity -- **Screen Reader Support**: Full navigation guidance and diagram descriptions -- **Skill Level Pathways**: Clear progression from beginner to advanced -- **Comprehensive Glossaries**: 240+ technical terms with detailed definitions -- **Learning Resources**: Time estimates and prerequisite guidance - -### Consistent Terminology -Unified technical vocabulary ensures clear communication across all documentation, with key terms defined consistently throughout comprehensive glossaries. - -### Comprehensive Code Examples -All code examples include proper documentation, error handling, and follow consistent formatting standards suitable for production use. - -### Security-First Approach -Security considerations are embedded throughout all documentation, from development practices to testing procedures to architectural design. - -### Professional Quality Standards -- **WCAG 2.1 Compliant**: Full accessibility standards compliance -- **Technical Accuracy**: All examples tested and verified -- **Framework Integration**: Documentation quality matches framework sophistication -- **Community Focus**: Inclusive design for developers of all abilities - -## Document Status - -โœ… **Phase 1 Complete**: Critical issues resolved, basic structure established -โœ… **Phase 2 Complete**: Cross-document consistency, navigation improvements, security integration -โœ… **Phase 3 Complete**: Advanced examples, visual diagrams, enhanced architecture documentation -โœ… **Phase 4 Complete**: Accessibility improvements, comprehensive glossaries, skill level guidance, professional polish - -### Accessibility & Quality Enhancements (Phase 4) -- **240+ Glossary Terms**: Comprehensive technical definitions across all documents -- **Screen Reader Support**: Full accessibility with navigation guidance and diagram descriptions -- **Skill Level Pathways**: Clear learning progressions from beginner to advanced -- **Professional Polish**: Documentation quality aligned with framework sophistication - -## Getting Started - -### Prerequisites -- Python 3.8+ (for installation tool) -- Claude Code installed -- Optional: Node.js 16+ for MCP servers - -### Understanding the Framework -```bash -# Check installation -ls ~/.claude/ -# You'll see context files, not executable code - -# View a command context -cat ~/.claude/commands/implement.md -# You'll see instructions for Claude, not code - -# View an agent context -cat ~/.claude/agents/python-expert.md -# You'll see expertise definitions, not programs -``` - -### Extending SuperClaude -1. **Add Commands**: Create new `.md` files in `~/.claude/commands/` -2. **Add Agents**: Create new `.md` files in `~/.claude/agents/` -3. **Add Modes**: Create new `.md` files in `~/.claude/modes/` - -No compilation, no testing, no deployment - just add context files and Claude Code will read them automatically. - -## Support and Resources - -### Documentation Issues -- **Broken Links**: Report cross-reference issues in GitHub issues -- **Unclear Content**: Request clarification through GitHub discussions -- **Missing Information**: Suggest improvements through pull requests - -### Development Support -- **Technical Questions**: Use GitHub discussions for architecture and implementation questions -- **Bug Reports**: Submit detailed issues with reproduction steps -- **Feature Requests**: Propose enhancements through GitHub issues - -### Community Resources -- **[GitHub Repository](https://github.com/SuperClaude-Org/SuperClaude_Framework)**: Main development and collaboration hub - -## Contributing to Documentation - -We welcome contributions to improve documentation quality, accuracy, and completeness: - -### Documentation Standards -- **Clarity**: Write for your target audience skill level -- **Consistency**: Follow established terminology and formatting -- **Completeness**: Provide working examples and complete procedures -- **Cross-References**: Link related concepts across documents - -### Submission Process -1. Fork the repository and create a feature branch -2. Make documentation improvements following our standards -3. Test all code examples and verify cross-references -4. Submit pull request with clear description of changes - ---- - -**SuperClaude Framework**: Building the future of AI-assisted development through intelligent orchestration and behavioral programming. - -For the latest updates and community discussions, visit our [GitHub repository](https://github.com/SuperClaude-Org/SuperClaude_Framework). \ No newline at end of file diff --git a/docs/Developer-Guide/contributing-code.md b/docs/Developer-Guide/contributing-code.md deleted file mode 100644 index d47603c..0000000 --- a/docs/Developer-Guide/contributing-code.md +++ /dev/null @@ -1,401 +0,0 @@ -# Contributing Context Files to SuperClaude Framework ๐Ÿ› ๏ธ - -Welcome to SuperClaude Framework development! This guide provides everything you need to contribute context files and behavioral instructions that enhance Claude Code through structured prompts and MCP server integration. - -**Project Purpose**: SuperClaude provides Claude Code with structured context files and behavioral instructions. We're building the next generation of AI-assisted development through intelligent prompt engineering. - -## Table of Contents - -1. [Development Setup](#development-setup) - Prerequisites and environment -2. [Architecture Overview](#architecture-overview) - System components and design -3. [Context File Guidelines](#context-file-guidelines) - Standards and practices -4. [Development Workflow](#development-workflow) - Git workflow and submissions -5. [Contributing to Components](#contributing-to-components) - Agents, commands, modes -6. [File Validation](#file-validation) - Quality assurance -7. [Getting Help](#getting-help) - Support and resources - -## Development Setup - -### Prerequisites - -**Required:** -- Python 3.8+ with pip -- Git for version control -- Claude Code installed and working -- Node.js 16+ (for MCP server configuration) - -**Environment Setup:** -```bash -# Fork SuperClaude_Framework on GitHub first -git clone https://github.com/YOUR_USERNAME/SuperClaude_Framework.git -cd SuperClaude_Framework - -# Test installation system -PYTHONPATH=/path/to/SuperClaude_Framework python3 -m setup --help - -# Install to development location -PYTHONPATH=/path/to/SuperClaude_Framework python3 -m setup install --components core -``` - -**Validation Check:** -```bash -# Verify Python version -python3 --version # Should be 3.8+ - -# Check Node.js for MCP configuration -node --version # Should be 16+ - -# Test Claude Code integration -ls ~/.claude/ # Should show Claude Code directory -``` - -## Architecture Overview - -### Framework Structure - -SuperClaude is a **Context-Oriented Configuration Framework** - not executing software, but instruction files that Claude Code reads to modify its behavior. - -``` -SuperClaude_Framework/ -โ”œโ”€โ”€ superclaude/ # Framework components (the source of truth) -โ”‚ โ”œโ”€โ”€ Core/ # PRINCIPLES.md, RULES.md, FLAGS.md -โ”‚ โ”œโ”€โ”€ Agents/ # 15 specialized domain experts -โ”‚ โ”œโ”€โ”€ Commands/ # 21 context trigger patterns (/sc: behavioral instructions) -โ”‚ โ”œโ”€โ”€ Modes/ # 6 behavioral modification patterns -โ”‚ โ””โ”€โ”€ MCP/ # 6 MCP server configurations -โ”œโ”€โ”€ setup/ # Python installation system -โ”œโ”€โ”€ docs/ # Documentation (what you're reading) -โ””โ”€โ”€ tests/ # File validation scripts -``` - -**Key Concepts:** -- **Context Files**: .md instruction files that guide Claude Code behavior -- **Agents**: Domain specialists (e.g., security-engineer.md, python-expert.md) -- **Commands**: Workflow patterns (e.g., implement.md, analyze.md) -- **Modes**: Interaction modifiers (e.g., brainstorming, introspection) -- **MCP Integration**: Configuration for Model Context Protocol servers - -### How It Works - -``` -User Input โ†’ Claude Code โ†’ Reads SuperClaude Context โ†’ Modified Behavior โ†’ Enhanced Output -``` - -1. User types `/sc:implement "auth system"` **in Claude Code conversation** (not terminal) -2. Claude Code reads `superclaude/Commands/implement.md` -3. Command activates security-engineer agent context -4. Context7 MCP provides authentication patterns -5. Claude generates complete, secure implementation - -## Context File Guidelines - -### File Organization - -**Context Files (`.md`):** -- Write clear, actionable instructions for Claude Code -- Use frontmatter metadata for configuration -- Follow existing patterns and naming conventions -- Test instructions produce expected behaviors - -**Installation Scripts (`.py`):** -- Follow PEP 8 style guidelines -- Include docstrings for functions and classes -- Add type hints where beneficial -- Focus on file copying and configuration - -**Example Agent Structure:** -```markdown ---- -name: new-specialist -description: Brief description of expertise -category: specialized|architecture|quality ---- - -# Agent Name - -## Triggers -- Keywords that activate this agent -- File types that trigger activation - -## Behavioral Mindset -Core philosophy and approach - -## Focus Areas -- Domain expertise area 1 -- Domain expertise area 2 - -## Key Actions -1. Specific behavior pattern -2. Problem-solving approach -``` - -### Context File Standards - -**Structure Requirements:** -- Clear, actionable instructions for Claude Code -- Specific triggers and activation patterns -- Examples demonstrating usage -- Boundaries defining scope - -**Quality Standards:** -- Instructions are testable in Claude Code conversations -- Examples produce expected behavioral changes -- Clear activation triggers and context patterns -- Professional language and formatting - -## Development Workflow - -### Git Workflow - -1. **Fork and Clone:** - ```bash - # Fork on GitHub, then: - git clone https://github.com/YOUR_USERNAME/SuperClaude_Framework.git - cd SuperClaude_Framework - git remote add upstream https://github.com/SuperClaude-Org/SuperClaude_Framework.git - ``` - -2. **Create Feature Branch:** - ```bash - git checkout -b feature/your-feature-name - # Work on your changes - git add . - git commit -m "Add: descriptive commit message" - ``` - -3. **Submit Pull Request:** - ```bash - git push origin feature/your-feature-name - # Create PR on GitHub - ``` - -### Pull Request Template - -```markdown -## Description -Brief description of context file changes - -## Type of Change -- [ ] Bug fix in context files -- [ ] New feature (agent, command, mode) -- [ ] Documentation improvement -- [ ] Installation system enhancement - -## Testing -- [ ] Manual testing with Claude Code -- [ ] Context file validation passes -- [ ] Examples validated in Claude Code conversations - -## Checklist -- [ ] Files follow SuperClaude conventions -- [ ] Self-review completed -- [ ] Documentation updated -- [ ] No breaking changes to existing context -``` - -### Code Review Process - -**Manual Review:** -- Context file clarity and effectiveness -- Agent/command logic and triggers -- Documentation accuracy and completeness -- Integration with existing components -- Claude Code behavioral testing results - -## Contributing to Components - -### Adding New Agents - -**Agent Development Process:** -1. Identify domain expertise gap -2. Create agent file in `superclaude/Agents/` -3. Define triggers, behaviors, and boundaries -4. Test with various Claude Code scenarios -5. Document usage patterns and examples - -**Agent Template:** -```markdown ---- -name: agent-name -description: Domain expertise description -category: specialized -tools: Read, Write, Edit, Bash ---- - -# Agent Name - -## Triggers -- Specific keywords: domain, expertise, area -- File patterns: *.domain, specific frameworks -- Complexity indicators: architectural decisions - -## Behavioral Mindset -- Focus on domain best practices -- Systematic approach to problem-solving -- Quality and security considerations - -## Focus Areas -- Core domain expertise -- Related technical areas -- Integration patterns - -## Key Actions -1. Analyze requirements within domain context -2. Apply domain-specific best practices -3. Coordinate with related specialists -4. Validate solutions meet domain standards -``` - -### Adding New Commands - -**Command Structure:** -```markdown ---- -name: command-name -description: Command purpose -category: workflow|utility|analysis -complexity: basic|standard|advanced -mcp-servers: [context7, sequential] -personas: [architect, engineer] ---- - -# /sc:command-name - -## Triggers -- When to use this command -- Context indicators - -## Usage -Type in Claude Code conversation: -``` -/sc:command-name [target] [--options] -``` -**Note**: This is a context trigger pattern, not a terminal command. - -## Workflow Pattern -1. Initial analysis -2. Processing steps -3. Validation and output - -## Examples -Practical usage examples -``` - -### Adding New Modes - -**Mode Development:** -- Define activation triggers -- Specify behavioral modifications -- Create interaction patterns -- Test across different Claude Code scenarios - -## File Validation - -### Context File Validation - -**Manual Validation Process:** -1. Install development version in Claude Code -2. Test agent/command activation triggers in Claude Code conversations -3. Verify behavioral modifications occur as expected -4. Validate context file structure and formatting -5. Test edge cases and error conditions - -**Validation Checklist:** -- [ ] Context files use valid markdown syntax -- [ ] Triggers activate correctly in Claude Code -- [ ] Behavior matches documentation -- [ ] No conflicts with existing components -- [ ] Examples produce expected results in Claude Code conversations - -### File Structure Validation - -```bash -# Check file structure -find ~/.claude -name "*.md" | head -10 - -# Verify context file format -head ~/.claude/agents/python-expert.md - -# Test import system -grep "@import" ~/.claude/CLAUDE.md -``` - -## Getting Help - -### Development Support - -**Documentation:** -- [Technical Architecture](technical-architecture.md) - System design details -- [Verification Guide](testing-debugging.md) - File validation procedures - -**Community Channels:** -- GitHub Issues: Bug reports and feature requests -- GitHub Discussions: Development questions and ideas -- Pull Request Reviews: Context file feedback and collaboration - -**Code Review Guidelines:** -- Provide constructive, specific feedback -- Test changes locally when possible -- Focus on maintainability and clarity -- Respect contributor efforts and learning - -### Issue Reporting - -**Bug Reports:** -1. Describe expected vs actual behavior in Claude Code -2. Provide steps to reproduce with context triggers -3. Include environment details and file versions -4. Share relevant context file configurations - -**Feature Requests:** -1. Explain the behavioral enhancement being proposed -2. Describe how users would benefit -3. Consider integration with existing context patterns -4. Provide usage examples - -## Contributing Guidelines Summary - -### Do's -โœ… **Follow existing patterns and conventions** -โœ… **Test context files thoroughly with Claude Code** -โœ… **Write clear, actionable behavioral instructions** -โœ… **Provide working examples** -โœ… **Focus on user experience improvements** -โœ… **Coordinate with related components** - -### Don'ts -โŒ **Don't break existing functionality** -โŒ **Don't add untested context modifications** -โŒ **Don't ignore style guidelines** -โŒ **Don't create overly complex behavioral patterns** -โŒ **Don't duplicate existing functionality** - -### Quality Standards - -**Context Files:** -- Clear activation triggers -- Specific behavioral instructions -- Practical examples -- Defined scope boundaries - -**Documentation:** -- Accurate and up-to-date -- Working context examples -- Clear navigation structure -- Accessibility considerations - -## License and Attribution - -**MIT License**: SuperClaude Framework is licensed under the MIT License, providing maximum freedom for use, modification, and distribution. - -By contributing to SuperClaude Framework, you agree that your contributions will be licensed under the same MIT License. You retain copyright to your contributions while granting the project perpetual rights to use, modify, and distribute your context files. - -## Acknowledgments - -SuperClaude Framework exists because of the collaborative effort of developers, users, and contributors who believe in advancing AI-assisted development. Every bug report, feature suggestion, documentation improvement, and context file contribution makes the framework better for everyone. - -Your expertise and perspective make SuperClaude Framework better. Whether you're improving context files, adding features, or helping other users, every contribution advances the goal of more effective AI-assisted development. - ---- - -**Welcome to the SuperClaude Framework contributor community!** Your contributions help build the future of AI-assisted development through intelligent context and behavioral programming. diff --git a/docs/Developer-Guide/documentation-index.md b/docs/Developer-Guide/documentation-index.md deleted file mode 100644 index 53052e6..0000000 --- a/docs/Developer-Guide/documentation-index.md +++ /dev/null @@ -1,227 +0,0 @@ -# SuperClaude Framework Developer-Guide Index - -## Document Navigation Guide - -This index provides comprehensive access to all SuperClaude Framework development documentation, organized by topic and skill level for efficient information discovery. - -### Quick Navigation - -**For New Contributors**: Start with [Contributing Guide โ†’ Setup](contributing-code.md#development-setup) - -**For System Understanding**: Begin with [Technical Architecture Guide โ†’ Context Architecture](technical-architecture.md#context-file-architecture) - -**For Verification**: Start with [Verification Guide โ†’ Installation Check](testing-debugging.md#installation-verification) - ---- - -## Primary Documentation - -### ๐Ÿ“‹ [Contributing Context Files Guide](contributing-code.md) -**Purpose**: Complete context file development and contribution guidelines -**Target Audience**: Framework contributors and context file developers -**Length**: ~1,000 lines focused on context file reality - -**Key Sections**: -- [Development Setup](contributing-code.md#development-setup) - Environment configuration and prerequisites -- [Context File Guidelines](contributing-code.md#context-file-guidelines) - Standards and structure -- [Development Workflow](contributing-code.md#development-workflow) - Git workflow and submission process -- [Contributing to Components](contributing-code.md#contributing-to-components) - Agent, command, and mode development -- [File Validation](contributing-code.md#file-validation) - Context file verification methods - -### ๐Ÿ—๏ธ [Context Architecture Guide](technical-architecture.md) -**Purpose**: Understanding how context files work and are structured -**Target Audience**: Anyone wanting to understand or extend SuperClaude -**Length**: ~800 lines focused on context file patterns and Claude Code integration - -**Key Sections**: -- [Context File Architecture](technical-architecture.md#context-file-architecture) - Directory structure and file types -- [The Import System](technical-architecture.md#the-import-system) - How Claude Code loads context -- [Agent Context Structure](technical-architecture.md#agent-context-structure) - Domain specialist contexts -- [Command Context Structure](technical-architecture.md#command-context-structure) - Workflow patterns -- [How Claude Code Reads Context](technical-architecture.md#how-claude-code-reads-context) - Processing sequence -- [Extending the Framework](technical-architecture.md#extending-the-framework) - Adding new components - -### ๐Ÿงช [Verification & Troubleshooting Guide](testing-debugging.md) -**Purpose**: Verifying installation and troubleshooting context file issues -**Target Audience**: Users and maintainers -**Length**: ~500 lines focused on file verification and Claude Code integration - -**Key Sections**: -- [Installation Verification](testing-debugging.md#installation-verification) - Check context file installation -- [Context File Verification](testing-debugging.md#context-file-verification) - File structure validation -- [MCP Server Verification](testing-debugging.md#mcp-server-verification) - External tool configuration -- [Common Issues](testing-debugging.md#common-issues) - Troubleshooting activation problems -- [Troubleshooting Commands](testing-debugging.md#troubleshooting-commands) - Diagnostic procedures - ---- - -## Topic-Based Index - -### ๐Ÿš€ Getting Started - -**Complete Beginners**: -1. [Contributing Guide โ†’ Setup](contributing-code.md#development-setup) - Environment setup -2. [Architecture Guide โ†’ Overview](technical-architecture.md#overview) - Understanding context files -3. [Verification Guide โ†’ Installation Check](testing-debugging.md#installation-verification) - Basic verification - -**Environment Setup**: -- [Development Setup](contributing-code.md#development-setup) - Prerequisites and configuration -- [Installation Verification](testing-debugging.md#installation-verification) - File installation check - -### ๐Ÿ—๏ธ Architecture & Design - -**Context File Architecture**: -- [Context File Architecture](technical-architecture.md#context-file-architecture) - Complete system design -- [The Import System](technical-architecture.md#the-import-system) - How Claude Code loads context -- [Agent Context Structure](technical-architecture.md#agent-context-structure) - Domain specialist patterns -- [Command Context Structure](technical-architecture.md#command-context-structure) - Workflow definitions - -**Component Development**: -- [Contributing to Components](contributing-code.md#contributing-to-components) - Agent, command, mode development -- [Adding New Agents](contributing-code.md#adding-new-agents) - Domain specialist creation -- [Adding New Commands](contributing-code.md#adding-new-commands) - Workflow pattern development -- [Extending the Framework](technical-architecture.md#extending-the-framework) - Framework expansion - -### ๐Ÿงช Verification & Quality - -**File Verification**: -- [Context File Verification](testing-debugging.md#context-file-verification) - File structure validation -- [File Validation](contributing-code.md#file-validation) - Context file verification methods - -**Troubleshooting**: -- [Common Issues](testing-debugging.md#common-issues) - Activation and configuration problems -- [Troubleshooting Commands](testing-debugging.md#troubleshooting-commands) - Diagnostic procedures - -### ๐Ÿ”ง Development Workflows - -**Context File Development**: -- [Development Workflow](contributing-code.md#development-workflow) - Git workflow -- [Context File Guidelines](contributing-code.md#context-file-guidelines) - Standards and practices -- [Pull Request Process](contributing-code.md#pull-request-template) - Submission process - -**Component Development**: -- [Agent Development](contributing-code.md#adding-new-agents) - Domain specialist creation -- [Command Development](contributing-code.md#adding-new-commands) - Workflow pattern creation -- [Mode Development](contributing-code.md#adding-new-modes) - Behavioral modification patterns - -### ๐Ÿ› ๏ธ MCP Integration - -**MCP Configuration**: -- [MCP Server Configuration](technical-architecture.md#mcp-server-configuration) - External tool setup -- [MCP Server Verification](testing-debugging.md#mcp-server-verification) - Configuration validation - -### ๐Ÿšจ Support & Troubleshooting - -**Common Issues**: -- [Commands Not Working](testing-debugging.md#issue-commands-not-working) - Context trigger problems -- [Agents Not Activating](testing-debugging.md#issue-agents-not-activating) - Activation issues -- [Context Not Loading](testing-debugging.md#issue-context-not-loading) - Loading problems - -**Support Resources**: -- [Getting Help](contributing-code.md#getting-help) - Support channels -- [Issue Reporting](contributing-code.md#issue-reporting) - Bug reports and features - ---- - -## Skill Level Pathways - -### ๐ŸŸข Beginner Path (Understanding SuperClaude) - -**Week 1: Foundation** -1. [Architecture Overview](technical-architecture.md#overview) - What SuperClaude is -2. [Installation Verification](testing-debugging.md#installation-verification) - Check your setup -3. [Context File Architecture](technical-architecture.md#context-file-architecture) - Directory structure - -**Week 2: Basic Usage** -1. [How Claude Code Reads Context](technical-architecture.md#how-claude-code-reads-context) - Processing sequence -2. [Common Issues](testing-debugging.md#common-issues) - Troubleshooting basics -3. [Context File Guidelines](contributing-code.md#context-file-guidelines) - File standards - -### ๐ŸŸก Intermediate Path (Contributing Context Files) - -**Month 1: Context Development** -1. [Development Setup](contributing-code.md#development-setup) - Environment preparation -2. [Agent Context Structure](technical-architecture.md#agent-context-structure) - Domain specialists -3. [Command Context Structure](technical-architecture.md#command-context-structure) - Workflow patterns - -**Month 2: Component Creation** -1. [Adding New Agents](contributing-code.md#adding-new-agents) - Domain specialist development -2. [Adding New Commands](contributing-code.md#adding-new-commands) - Workflow creation -3. [File Validation](contributing-code.md#file-validation) - Context verification - -### ๐Ÿ”ด Advanced Path (Framework Extension) - -**Advanced Understanding** -1. [The Import System](technical-architecture.md#the-import-system) - Context loading mechanics -2. [Extending the Framework](technical-architecture.md#extending-the-framework) - Framework expansion -3. [MCP Server Configuration](technical-architecture.md#mcp-server-configuration) - External tool integration - ---- - -## Reference Materials - -### ๐Ÿ“š Key Concepts - -**Framework Fundamentals**: -- Context-Oriented Configuration Framework -- Agent Domain Specialists -- Command Workflow Patterns -- Mode Behavioral Modifications -- MCP Integration Patterns - -### ๐Ÿ”— Cross-References - -**Development โ†’ Architecture**: -- [Context File Guidelines](contributing-code.md#context-file-guidelines) โ†’ [Context File Architecture](technical-architecture.md#context-file-architecture) -- [Adding Components](contributing-code.md#contributing-to-components) โ†’ [Agent/Command Structure](technical-architecture.md#agent-context-structure) - -**Development โ†’ Verification**: -- [Development Workflow](contributing-code.md#development-workflow) โ†’ [File Verification](testing-debugging.md#context-file-verification) -- [File Validation](contributing-code.md#file-validation) โ†’ [Installation Verification](testing-debugging.md#installation-verification) - -**Architecture โ†’ Verification**: -- [How Claude Code Reads Context](technical-architecture.md#how-claude-code-reads-context) โ†’ [Troubleshooting](testing-debugging.md#common-issues) -- [MCP Configuration](technical-architecture.md#mcp-server-configuration) โ†’ [MCP Verification](testing-debugging.md#mcp-server-verification) - ---- - -## Quality Standards - -### โœ… Documentation Accuracy -- **Technical Precision**: All examples reflect SuperClaude reality (context files, not software) -- **Command Accuracy**: Correct Python module execution paths and Claude Code context triggers -- **No Fiction**: Removed all references to non-existent testing frameworks and performance systems - -### โœ… Content Focus -- **Context Files**: Documentation centers on .md instruction files and Claude Code behavior -- **File Verification**: Practical approaches to validating context file installation and structure -- **Real Workflows**: Actual development processes for context file contribution - -### โœ… User Experience -- **Clear Progression**: Skill-based learning paths from understanding to contribution -- **Practical Examples**: Working context file examples and Claude Code integration -- **Support Integration**: Clear guidance to help resources for real issues - ---- - -## Usage Guidelines - -### For Contributors -1. **Start with**: [Development Setup](contributing-code.md#development-setup) -2. **Context Development**: Follow [Context File Guidelines](contributing-code.md#context-file-guidelines) -3. **Validation**: Use [File Validation](contributing-code.md#file-validation) -4. **Support**: Reference [Getting Help](contributing-code.md#getting-help) - -### For Architects -1. **System Understanding**: [Context File Architecture](technical-architecture.md#context-file-architecture) -2. **Component Patterns**: [Agent and Command Structure](technical-architecture.md#agent-context-structure) -3. **Extension**: [Extending the Framework](technical-architecture.md#extending-the-framework) -4. **Integration**: [MCP Configuration](technical-architecture.md#mcp-server-configuration) - -### For Verification -1. **Installation Check**: [Installation Verification](testing-debugging.md#installation-verification) -2. **File Validation**: [Context File Verification](testing-debugging.md#context-file-verification) -3. **Troubleshooting**: [Common Issues](testing-debugging.md#common-issues) -4. **Diagnostics**: [Troubleshooting Commands](testing-debugging.md#troubleshooting-commands) - -This comprehensive index reflects the reality of SuperClaude as a context-oriented configuration framework, focusing on practical context file development and Claude Code integration. \ No newline at end of file diff --git a/docs/Developer-Guide/technical-architecture.md b/docs/Developer-Guide/technical-architecture.md deleted file mode 100644 index 3fb331a..0000000 --- a/docs/Developer-Guide/technical-architecture.md +++ /dev/null @@ -1,356 +0,0 @@ -# SuperClaude Context Architecture Guide - -## Overview - -This guide documents how SuperClaude's Context-Oriented Configuration Framework is structured and how Claude Code interprets these context files to modify its behavior. - -**Important**: SuperClaude is NOT standalone software with running processes, execution layers, or performance systems. It is a collection of `.md` instruction files that Claude Code reads to adopt specialized behaviors. - -## Table of Contents - -1. [Context File Architecture](#context-file-architecture) -2. [The Import System](#the-import-system) -3. [Agent Context Structure](#agent-context-structure) -4. [Command Context Structure](#command-context-structure) -5. [Mode Context Structure](#mode-context-structure) -6. [MCP Server Configuration](#mcp-server-configuration) -7. [How Claude Code Reads Context](#how-claude-code-reads-context) -8. [Extending the Framework](#extending-the-framework) - -## Context File Architecture - -### Directory Structure - -``` -~/.claude/ (SuperClaude Framework Files Only) -โ”œโ”€โ”€ CLAUDE.md # Main context file with imports -โ”œโ”€โ”€ FLAGS.md # Flag definitions and triggers -โ”œโ”€โ”€ RULES.md # Core behavioral rules -โ”œโ”€โ”€ PRINCIPLES.md # Guiding principles -โ”œโ”€โ”€ ZIG.md # Zig language integration -โ”œโ”€โ”€ MCP_Context7.md # Context7 MCP integration -โ”œโ”€โ”€ MCP_Magic.md # Magic MCP integration -โ”œโ”€โ”€ MCP_Morphllm.md # Morphllm MCP integration -โ”œโ”€โ”€ MCP_Playwright.md # Playwright MCP integration -โ”œโ”€โ”€ MCP_Sequential.md # Sequential MCP integration -โ”œโ”€โ”€ MCP_Serena.md # Serena MCP integration -โ”œโ”€โ”€ MCP_Tavily.md # Tavily MCP integration -โ”œโ”€โ”€ MCP_Zig.md # Zig MCP integration -โ”œโ”€โ”€ MODE_Brainstorming.md # Collaborative discovery mode -โ”œโ”€โ”€ MODE_Business_Panel.md # Business expert panel mode -โ”œโ”€โ”€ MODE_DeepResearch.md # Deep research mode -โ”œโ”€โ”€ MODE_Introspection.md # Transparent reasoning mode -โ”œโ”€โ”€ MODE_Orchestration.md # Tool coordination mode -โ”œโ”€โ”€ MODE_Task_Management.md # Task orchestration mode -โ”œโ”€โ”€ MODE_Token_Efficiency.md # Compressed communication mode -โ”œโ”€โ”€ agents/ # Domain specialist contexts (19 total) -โ”‚ โ”œโ”€โ”€ backend-architect.md # Backend expertise -โ”‚ โ”œโ”€โ”€ business-panel-experts.md # Business strategy panel -โ”‚ โ”œโ”€โ”€ deep-research-agent.md # Deep research expertise -โ”‚ โ”œโ”€โ”€ devops-architect.md # DevOps expertise -โ”‚ โ”œโ”€โ”€ frontend-architect.md # Frontend expertise -โ”‚ โ”œโ”€โ”€ learning-guide.md # Educational expertise -โ”‚ โ”œโ”€โ”€ performance-engineer.md # Performance expertise -โ”‚ โ”œโ”€โ”€ python-expert.md # Python expertise -โ”‚ โ”œโ”€โ”€ quality-engineer.md # Quality assurance expertise -โ”‚ โ”œโ”€โ”€ refactoring-expert.md # Code quality expertise -โ”‚ โ”œโ”€โ”€ requirements-analyst.md # Requirements expertise -โ”‚ โ”œโ”€โ”€ root-cause-analyst.md # Problem diagnosis expertise -โ”‚ โ”œโ”€โ”€ security-engineer.md # Security expertise -โ”‚ โ”œโ”€โ”€ socratic-mentor.md # Educational expertise -โ”‚ โ”œโ”€โ”€ spec-panel-experts.md # Specification review panel -โ”‚ โ”œโ”€โ”€ system-architect.md # System design expertise -โ”‚ โ”œโ”€โ”€ technical-writer.md # Documentation expertise -โ”‚ โ”œโ”€โ”€ test-runner.md # Test execution expertise -โ”‚ โ””โ”€โ”€ wave-orchestrator.md # Wave orchestration patterns -โ””โ”€โ”€ commands/ # Workflow pattern contexts - โ””โ”€โ”€ sc/ # SuperClaude command namespace (25 total) - โ”œโ”€โ”€ analyze.md # Analysis patterns - โ”œโ”€โ”€ brainstorm.md # Discovery patterns - โ”œโ”€โ”€ build.md # Build patterns - โ”œโ”€โ”€ business-panel.md # Business expert panel patterns - โ”œโ”€โ”€ cleanup.md # Cleanup patterns - โ”œโ”€โ”€ design.md # Design patterns - โ”œโ”€โ”€ document.md # Documentation patterns - โ”œโ”€โ”€ estimate.md # Estimation patterns - โ”œโ”€โ”€ explain.md # Explanation patterns - โ”œโ”€โ”€ git.md # Git workflow patterns - โ”œโ”€โ”€ help.md # Help and command listing - โ”œโ”€โ”€ implement.md # Implementation patterns - โ”œโ”€โ”€ improve.md # Improvement patterns - โ”œโ”€โ”€ index.md # Index patterns - โ”œโ”€โ”€ load.md # Context loading patterns - โ”œโ”€โ”€ reflect.md # Reflection patterns - โ”œโ”€โ”€ research.md # Deep research patterns - โ”œโ”€โ”€ save.md # Session persistence patterns - โ”œโ”€โ”€ select-tool.md # Tool selection patterns - โ”œโ”€โ”€ spawn.md # Multi-agent patterns - โ”œโ”€โ”€ spec-panel.md # Specification review panel - โ”œโ”€โ”€ task.md # Task management patterns - โ”œโ”€โ”€ test.md # Testing patterns - โ”œโ”€โ”€ troubleshoot.md # Troubleshooting patterns - โ””โ”€โ”€ workflow.md # Workflow planning patterns - -Note: Other directories (backups/, logs/, projects/, serena/, etc.) are Claude Code -operational directories, not part of SuperClaude framework content. -``` - -### Context File Types - -| File Type | Purpose | Activation | Example | -|-----------|---------|------------|---------| -| **Commands** | Define workflow patterns | `/sc:[command]` (context trigger) | User types `/sc:implement` โ†’ reads `implement.md` | -| **Agents** | Provide domain expertise | `@agent-[name]` or auto | `@agent-security` โ†’ reads `security-engineer.md` | -| **Modes** | Modify interaction style | Flags or triggers | `--brainstorm` โ†’ activates brainstorming mode | -| **Core** | Set fundamental rules | Always active | `RULES.md` always loaded | - -## The Import System - -### How CLAUDE.md Works - -The main `CLAUDE.md` file uses an import system to load multiple context files: - -```markdown -# CLAUDE - -*MANDATORY* -@FLAGS.md # Flag definitions and triggers -@RULES.md # Core behavioral rules -@PRINCIPLES.md # Guiding principles -*SECONDARY* -@MCP_Context7.md # Context7 MCP integration -@MCP_Magic.md # Magic MCP integration -@MCP_Morphllm.md # Morphllm MCP integration -@MCP_Playwright.md # Playwright MCP integration -@MCP_Sequential.md # Sequential MCP integration -@MCP_Serena.md # Serena MCP integration -@MCP_Tavily.md # Tavily MCP integration -@MCP_Zig.md # Zig MCP integration -*CRITICAL* -@MODE_Brainstorming.md # Collaborative discovery mode -@MODE_Business_Panel.md # Business expert panel mode -@MODE_DeepResearch.md # Deep research mode -@MODE_Introspection.md # Transparent reasoning mode -@MODE_Task_Management.md # Task orchestration mode -@MODE_Orchestration.md # Tool coordination mode -@MODE_Token_Efficiency.md # Compressed communication mode -*LANGUAGE SPECIFIC* -@ZIG.md # Zig language integration -``` - -### Import Processing - -1. Claude Code reads `CLAUDE.md` -2. Encounters `@import` statements -3. Loads referenced files into context -4. Builds complete behavioral framework -5. Applies relevant contexts based on user input - -## Agent Context Structure - -### Anatomy of an Agent File - -Each agent `.md` file follows this structure: - -```markdown ---- -name: agent-name -description: Brief description -category: specialized|architecture|quality ---- - -# Agent Name - -## Triggers -- Keywords that activate this agent -- File types that trigger activation -- Complexity thresholds - -## Behavioral Mindset -Core philosophy and approach - -## Focus Areas -- Domain expertise area 1 -- Domain expertise area 2 - -## Key Actions -1. Specific behavior pattern -2. Problem-solving approach -``` - -### Agent Activation Logic - -- **Manual**: User types `@agent-python-expert "task"` -- **Automatic**: Keywords in request trigger agent loading -- **Contextual**: File types or patterns activate relevant agents - -## Command Context Structure - -### Anatomy of a Command File - -```markdown ---- -name: command-name -description: Command purpose -category: utility|orchestration|analysis -complexity: basic|enhanced|advanced -mcp-servers: [context7, sequential] -personas: [architect, engineer] ---- - -# /sc:command-name - -## Triggers -- When to use this command -- Context indicators - -## Usage -/sc:command-name [target] [--options] - -## Workflow Pattern -1. Step 1: Initial action -2. Step 2: Processing -3. Step 3: Validation - -## Examples -Practical usage examples -``` - -### Command Processing - -When user types `/sc:implement "feature"` in Claude Code conversation: -1. Claude reads `commands/sc/implement.md` -2. Adopts implementation workflow pattern -3. May auto-activate related agents -4. Follows defined workflow steps - -## Mode Context Structure - -### Behavioral Modes - -Modes modify Claude's interaction style: - -```markdown -# MODE_[Name].md - -## Activation Triggers -- Flag: --mode-name -- Keywords: [triggers] -- Complexity: threshold - -## Behavioral Modifications -- Communication style changes -- Decision-making adjustments -- Output format modifications - -## Interaction Patterns -- How to respond -- What to prioritize -``` - -## MCP Server Configuration - -### Configuration Location - -MCP servers are configured in `~/.claude.json` (NOT part of SuperClaude context): - -```json -{ - "mcpServers": { - "context7": { - "command": "npx", - "args": ["-y", "@upstash/context7-mcp@latest"] - }, - "sequential-thinking": { - "command": "npx", - "args": ["-y", "sequential-thinking-mcp@latest"] - } - } -} -``` - -### MCP Integration - -- **MCP Servers**: Actual software providing tools -- **SuperClaude**: Context that tells Claude when to use them -- **Activation**: Flags or keywords trigger MCP usage - -## How Claude Code Reads Context - -### Context Loading Sequence - -``` -User Input (in Claude Code): "/sc:analyze src/ --focus security" - โ†“ -1. Parse Command: identify 'analyze' command - โ†“ -2. Load Context: read commands/sc/analyze.md - โ†“ -3. Check Flags: --focus security - โ†“ -4. Auto-Activation: load security-engineer.md - โ†“ -5. Apply Patterns: follow analysis workflow - โ†“ -6. Generate Output: using loaded contexts -``` - -### Context Priority - -1. **Explicit Commands**: `/sc:` commands take precedence -2. **Manual Agents**: `@agent-` override auto-activation -3. **Flags**: Modify behavior of commands/agents -4. **Auto-Activation**: Based on keywords/context -5. **Default Behavior**: Standard Claude Code - -## Extending the Framework - -### Adding New Commands - -1. Create `~/.claude/commands/sc/new-command.md` -2. Define metadata, triggers, and workflow -3. No code changes needed - just context - -### Adding New Agents - -1. Create `~/.claude/agents/new-specialist.md` -2. Define expertise, triggers, and behaviors -3. Agent becomes available - -### Adding New Modes - -1. Create `~/.claude/MODE_NewMode.md` -2. Define activation triggers and modifications -3. Mode activates based on triggers - -### Best Practices - -- **Keep Context Focused**: One concept per file -- **Clear Triggers**: Define when context activates -- **Workflow Patterns**: Provide step-by-step guidance -- **Examples**: Include practical usage examples -- **Metadata**: Use frontmatter for configuration - -## Important Clarifications - -### What SuperClaude Is NOT - -- โŒ **No Execution Engine**: No code runs, no processes execute -- โŒ **No Performance System**: No optimization possible (it's just text) -- โŒ **No Detection Engine**: Claude Code does pattern matching -- โŒ **No Orchestration Layer**: Context files guide, not control -- โŒ **No Quality Gates**: Just instructional patterns - -### What SuperClaude IS - -- โœ… **Context Files**: `.md` instructions for Claude Code -- โœ… **Behavioral Patterns**: Workflows and approaches -- โœ… **Domain Expertise**: Specialized knowledge contexts -- โœ… **Configuration**: Settings for actual tools (MCP) -- โœ… **Framework**: Structured prompt engineering - -## Summary - -SuperClaude's architecture is intentionally simple: it's a well-organized collection of context files that Claude Code reads to modify its behavior. The power comes from the careful crafting of these contexts and their systematic organization, not from any executing code or running processes. - -The framework's elegance lies in its simplicity - by providing Claude Code with structured instructions through context files, we can achieve sophisticated behavioral modifications without any software complexity. diff --git a/docs/Developer-Guide/testing-debugging.md b/docs/Developer-Guide/testing-debugging.md deleted file mode 100644 index 15f0caf..0000000 --- a/docs/Developer-Guide/testing-debugging.md +++ /dev/null @@ -1,324 +0,0 @@ -# SuperClaude Verification and Troubleshooting Guide - -## Overview - -This guide covers how to verify your SuperClaude installation and troubleshoot common issues with context files and configurations. - -**Important**: SuperClaude is a collection of context files, not executable software. This guide focuses on verifying context files are properly installed and accessible to Claude Code. - -## Table of Contents - -1. [Installation Verification](#installation-verification) -2. [Context File Verification](#context-file-verification) -3. [MCP Server Verification](#mcp-server-verification) -4. [Common Issues](#common-issues) -5. [Troubleshooting Commands](#troubleshooting-commands) - -## Installation Verification - -### Check Installation Status - -```bash -# Verify SuperClaude installation system is available -python3 -m SuperClaude --version -# Expected: SuperClaude Framework installation help - -# Verify Claude Code CLI integration -claude --version -# Expected: Claude Code version info - -# Check if context files were installed -ls ~/.claude/ -# Expected: CLAUDE.md, FLAGS.md, RULES.md, agents/, commands/, modes/ - -# Verify main context file -head ~/.claude/CLAUDE.md -# Expected: Should show import statements -``` - -### Verify Directory Structure - -```bash -# Check all directories exist -for dir in agents commands modes; do - if [ -d ~/.claude/$dir ]; then - echo "โœ… $dir directory exists" - ls ~/.claude/$dir | wc -l - else - echo "โŒ $dir directory missing" - fi -done -``` - -### Count Installed Components - -```bash -# Should have 14 agents -ls ~/.claude/agents/*.md | wc -l - -# Should have 21 commands -ls ~/.claude/commands/*.md | wc -l - -# Should have 5 modes -ls ~/.claude/modes/*.md | wc -l -``` - -## Context File Verification - -### Verify Core Files - -```bash -# Check core context files exist -for file in CLAUDE.md FLAGS.md RULES.md PRINCIPLES.md; do - if [ -f ~/.claude/$file ]; then - echo "โœ… $file exists ($(wc -l < ~/.claude/$file) lines)" - else - echo "โŒ $file missing" - fi -done -``` - -### Verify Import System - -```bash -# Check CLAUDE.md has correct imports -grep "@import" ~/.claude/CLAUDE.md -# Expected output: -# @import commands/*.md -# @import agents/*.md -# @import modes/*.md -# @import FLAGS.md -# @import RULES.md -# @import PRINCIPLES.md -``` - -### Check File Integrity - -```bash -# Verify files are readable text files -file ~/.claude/CLAUDE.md -# Expected: ASCII text or UTF-8 text - -# Check for corruption -for file in ~/.claude/**/*.md; do - if file "$file" | grep -q "text"; then - echo "โœ… $file is valid text" - else - echo "โŒ $file may be corrupted" - fi -done -``` - -## MCP Server Verification - -### Check MCP Configuration - -```bash -# Verify .claude.json exists -if [ -f ~/.claude.json ]; then - echo "โœ… MCP configuration file exists" - # Check which servers are configured - grep -o '"[^"]*":' ~/.claude.json | grep -v mcpServers -else - echo "โŒ No MCP configuration found" -fi -``` - -### Test MCP Server Availability - -```bash -# Check if Node.js is available (required for MCP) -node --version -# Expected: v16.0.0 or higher - -# Check if npx is available -npx --version -# Expected: Version number - -# Test Context7 MCP (if configured) -npx -y @upstash/context7-mcp@latest --help 2>/dev/null && echo "โœ… Context7 available" || echo "โŒ Context7 not available" -``` - -## Common Issues - -### Issue: Commands Not Working - -**Symptom**: `/sc:` context triggers don't produce expected Claude Code behavior - -**Verification**: -```bash -# Check if command file exists -ls ~/.claude/commands/implement.md -# If missing, reinstall SuperClaude - -# Verify file content -head -20 ~/.claude/commands/implement.md -# Should show command metadata and instructions -``` - -**Solution**: -```bash -# Reinstall commands component -PYTHONPATH=/path/to/SuperClaude_Framework python3 -m setup install --components commands --force -``` - -### Issue: Agents Not Activating - -**Symptom**: `@agent-` invocations don't work in Claude Code - -**Verification**: -```bash -# List all agents -ls ~/.claude/agents/ - -# Check specific agent -cat ~/.claude/agents/python-expert.md | head -20 -``` - -**Solution**: -```bash -# Reinstall agents -PYTHONPATH=/path/to/SuperClaude_Framework python3 -m setup install --components agents --force -``` - -### Issue: Context Not Loading - -**Symptom**: Claude Code doesn't seem to read SuperClaude context - -**Verification**: -```bash -# Check CLAUDE.md is in correct location -ls -la ~/.claude/CLAUDE.md - -# Verify Claude Code can access the directory -# In Claude Code, check if context is loading properly -``` - -**Solution**: -1. Restart Claude Code -2. Ensure you're in a project directory -3. Check file permissions: `chmod 644 ~/.claude/*.md` - -### Issue: MCP Servers Not Working - -**Symptom**: MCP features unavailable - -**Verification**: -```bash -# Check Node.js installation -which node - -# Verify .claude.json syntax -python3 -c "import json; json.load(open('$HOME/.claude.json'))" && echo "โœ… Valid JSON" || echo "โŒ Invalid JSON" -``` - -**Solution**: -```bash -# Install Node.js if missing -# Ubuntu: sudo apt install nodejs npm -# macOS: brew install node -# Windows: Download from nodejs.org - -# Fix JSON syntax if invalid -PYTHONPATH=/path/to/SuperClaude_Framework python3 -m setup install --components mcp --force -``` - -## Troubleshooting Commands - -### Quick Diagnostic - -```bash -#!/bin/bash -# SuperClaude Quick Diagnostic Script - -echo "=== SuperClaude Diagnostic ===" -echo "" - -# Check installation system -echo "1. Installation System:" -if command -v SuperClaude &> /dev/null; then - echo " โœ… SuperClaude installation available" - python3 -m SuperClaude --version -else - echo " โŒ SuperClaude not found - install with: pipx install SuperClaude (or pip install SuperClaude)" -fi - -# Check context files -echo "" -echo "2. Context Files:" -if [ -d ~/.claude ]; then - echo " โœ… ~/.claude directory exists" - echo " - Agents: $(ls ~/.claude/agents/*.md 2>/dev/null | wc -l)" - echo " - Commands: $(ls ~/.claude/commands/*.md 2>/dev/null | wc -l)" - echo " - Modes: $(ls ~/.claude/modes/*.md 2>/dev/null | wc -l)" -else - echo " โŒ ~/.claude directory not found" -fi - -# Check MCP -echo "" -echo "3. MCP Configuration:" -if [ -f ~/.claude.json ]; then - echo " โœ… MCP configuration exists" -else - echo " โŒ No MCP configuration" -fi - -# Check Node.js -echo "" -echo "4. Node.js (for MCP):" -if command -v node &> /dev/null; then - echo " โœ… Node.js installed: $(node --version)" -else - echo " โš ๏ธ Node.js not installed (optional, needed for MCP)" -fi - -echo "" -echo "=== Diagnostic Complete ===" -``` - -### File Permission Fix - -```bash -# Fix permissions on all context files -chmod 644 ~/.claude/*.md -chmod 644 ~/.claude/**/*.md -chmod 755 ~/.claude ~/.claude/agents ~/.claude/commands ~/.claude/modes -``` - -### Complete Reinstall - -```bash -# Backup existing configuration -cp -r ~/.claude ~/.claude.backup.$(date +%Y%m%d) - -# Remove existing installation -rm -rf ~/.claude - -# Reinstall everything -PYTHONPATH=/path/to/SuperClaude_Framework python3 -m setup install - -# Restore any customizations from backup if needed -``` - -## Important Notes - -### What We're NOT Verifying - -- **No Code Execution**: Context files don't execute, so no runtime verification needed -- **No Performance Metrics**: No code runs, so no performance to measure -- **No Unit Tests**: Context files are instructions, not functions -- **No Integration Tests**: Claude Code reads files; verification is behavioral - -### What We ARE Verifying - -- **File Presence**: Context files exist in correct locations -- **File Integrity**: Files are valid text and readable -- **Directory Structure**: Proper organization maintained -- **Configuration Validity**: JSON files are syntactically correct -- **Dependencies Available**: Node.js for MCP servers (optional) -- **Behavioral Testing**: Context files produce expected Claude Code behavior - -## Summary - -Verification for SuperClaude focuses on ensuring context files are properly installed and accessible to Claude Code. Since SuperClaude is not software but a configuration framework, verification centers on file presence, integrity, and behavioral testing in Claude Code conversations. \ No newline at end of file diff --git a/docs/Getting-Started/installation.md b/docs/Getting-Started/installation.md deleted file mode 100644 index 4f23930..0000000 --- a/docs/Getting-Started/installation.md +++ /dev/null @@ -1,514 +0,0 @@ -
- -# ๐Ÿ“ฆ SuperClaude Installation Guide - -### **Transform Claude Code with 21 Commands, 14 Agents & 6 MCP Servers** - -

- Version - Python - Platform -

- -

- Quick Install โ€ข - Requirements โ€ข - Methods โ€ข - Verify โ€ข - Troubleshoot -

- -
- ---- - -## โšก **Quick Installation** - -
- -### **Choose Your Preferred Method** - -| Method | Command | Platform | Best For | -|:------:|---------|:--------:|----------| -| **๐Ÿ pipx** | `pipx install SuperClaude && SuperClaude install` | Linux/macOS | **โœ… Recommended** - Isolated environment | -| **๐Ÿ“ฆ pip** | `pip install SuperClaude && SuperClaude install` | All | Traditional Python setups | -| **๐ŸŒ npm** | `npm install -g @bifrost_inc/superclaude && superclaude install` | All | Node.js developers | -| **๐Ÿ”ง Dev** | `git clone ... && pip install -e ".[dev]"` | All | Contributors & developers | - -
- ---- - -## ๐Ÿ“‹ **Requirements** - -
- - - - - - -
- -### โœ… **Required** - -| Component | Version | Check Command | -|-----------|---------|---------------| -| **Python** | 3.8+ | `python3 --version` | -| **pip** | Latest | `pip --version` | -| **Claude Code** | Latest | `claude --version` | -| **Disk Space** | 50MB | `df -h` | - - - -### ๐Ÿ’ก **Optional** - -| Component | Purpose | Check Command | -|-----------|---------|---------------| -| **Node.js** | MCP Servers | `node --version` | -| **Git** | Version Control | `git --version` | -| **pipx** | Isolated Install | `pipx --version` | -| **RAM** | Performance | 1GB recommended | - -
- -
- -
-๐Ÿ” Quick System Check - -```bash -# Run this to check all requirements at once -python3 --version && echo "โœ… Python OK" || echo "โŒ Python missing" -claude --version && echo "โœ… Claude Code OK" || echo "โŒ Claude Code missing" -node --version 2>/dev/null && echo "โœ… Node.js OK (optional)" || echo "โš ๏ธ Node.js missing (optional)" -git --version 2>/dev/null && echo "โœ… Git OK (optional)" || echo "โš ๏ธ Git missing (optional)" -``` - -
- ---- - -## ๐Ÿš€ **Installation Methods** - -
- -### **Detailed Installation Instructions** - -
- -### **Method 1: pipx (Recommended)** - - - - - - -
- -```bash -# Install pipx if not present -python3 -m pip install --user pipx -python3 -m pipx ensurepath - -# Install SuperClaude -pipx install SuperClaude - -# Run the installer -SuperClaude install -``` - - - -**โœ… Advantages:** -- Isolated environment -- No dependency conflicts -- Clean uninstall -- Automatic PATH setup - -**๐Ÿ“ Best for:** -- Linux/macOS users -- Clean system installs -- Multiple Python projects - -
- -### **Method 2: pip (Traditional)** - - - - - - -
- -```bash -# Standard installation -pip install SuperClaude - -# Or user installation -pip install --user SuperClaude - -# Run the installer -SuperClaude install -``` - - - -**โœ… Advantages:** -- Works everywhere -- Familiar to Python users -- Direct installation - -**๐Ÿ“ Best for:** -- Windows users -- Virtual environments -- Quick setup - -
- -### **Method 3: npm (Cross-platform)** - - - - - - -
- -```bash -# Global installation -npm install -g @bifrost_inc/superclaude - -# Run the installer -superclaude install -``` - - - -**โœ… Advantages:** -- Cross-platform -- NPM ecosystem -- JavaScript familiar - -**๐Ÿ“ Best for:** -- Node.js developers -- NPM users -- Cross-platform needs - -
- -### **Method 4: Development Installation** - - - - - - -
- -```bash -# Clone repository -git clone https://github.com/SuperClaude-Org/SuperClaude_Framework.git -cd SuperClaude_Framework - -# Install in development mode -pip install -e ".[dev]" - -# Test installation -SuperClaude install --dry-run -``` - - - -**โœ… Advantages:** -- Latest features -- Contribute to project -- Full source access - -**๐Ÿ“ Best for:** -- Contributors -- Custom modifications -- Testing new features - -
- ---- - -## ๐ŸŽ›๏ธ **Installation Options** - -
- -### **Customize Your Installation** - -| Option | Command | Description | -|--------|---------|-------------| -| **Interactive** | `SuperClaude install` | Guided setup with prompts | -| **Specific Components** | `SuperClaude install --components core mcp modes` | Install only what you need | -| **Preview Mode** | `SuperClaude install --dry-run` | See what will be installed | -| **Force Install** | `SuperClaude install --force --yes` | Skip all confirmations | -| **List Components** | `SuperClaude install --list-components` | View available components | - -
- ---- - -## โœ… **Verification** - -
- -### **Confirm Successful Installation** - -
- -### **Step 1: Check Installation** - -```bash -# Verify SuperClaude version -python3 -m SuperClaude --version -# Expected: SuperClaude 4.1.5 - -# List installed components -SuperClaude install --list-components -# Expected: List of available components -``` - -### **Step 2: Test in Claude Code** - -```bash -# Open Claude Code and try these commands: -/sc:brainstorm "test project" # Should trigger discovery questions -/sc:analyze README.md # Should provide structured analysis -@agent-security "review code" # Should activate security specialist -``` - -### **Step 3: What's Installed** - -
- -| Location | Contents | Size | -|----------|----------|------| -| `~/.claude/` | Framework files | ~50MB | -| `~/.claude/CLAUDE.md` | Main entry point | ~2KB | -| `~/.claude/*.md` | Behavioral instructions | ~200KB | -| `~/.claude/claude-code-settings.json` | MCP configurations | ~5KB | - -
- ---- - -## ๐Ÿ› ๏ธ **Management** - -
- - - - - - - - - - - - -
๐Ÿ“ฆ Update๐Ÿ’พ Backup๐Ÿ—‘๏ธ Uninstall
- -```bash -# Update to latest -pip install --upgrade SuperClaude -SuperClaude update -``` - - - -```bash -# Create backup -SuperClaude backup --create - -# Restore backup -SuperClaude backup --restore [file] -``` - - - -```bash -# Remove framework -SuperClaude uninstall - -# Uninstall package -pip uninstall SuperClaude -``` - -
- -
- ---- - -## ๐Ÿ”ง **Troubleshooting** - -
-โŒ PEP 668 Error (Python Package Management) - -This error occurs on systems with externally managed Python environments. - -**Solutions (in order of preference):** - -```bash -# Option 1: Use pipx (Recommended) -pipx install SuperClaude - -# Option 2: User installation -pip install --user SuperClaude - -# Option 3: Virtual environment -python3 -m venv superclaude-env -source superclaude-env/bin/activate # Linux/macOS -# or -superclaude-env\Scripts\activate # Windows -pip install SuperClaude - -# Option 4: Force (use with caution) -pip install --break-system-packages SuperClaude -``` - -
- -
-โŒ Command Not Found - -If `SuperClaude` command is not found after installation: - -```bash -# Check if package is installed -python3 -m pip show SuperClaude - -# Run using Python module -python3 -m SuperClaude install - -# Add to PATH (if using --user) -export PATH="$HOME/.local/bin:$PATH" -echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc # Linux -echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc # macOS -``` - -
- -
-โŒ Claude Code Not Found - -If Claude Code is not installed or not in PATH: - -1. Download from [https://claude.ai/code](https://claude.ai/code) -2. Install following platform instructions -3. Verify with: `claude --version` -4. Restart terminal after installation - -
- -
-โŒ Permission Denied - -For permission errors during installation: - -```bash -# Use user installation -pip install --user SuperClaude - -# Or use sudo (not recommended) -sudo pip install SuperClaude - -# Better: use pipx -pipx install SuperClaude -``` - -
- -
-โŒ Missing Python or pip - -**Linux (Ubuntu/Debian):** -```bash -sudo apt update -sudo apt install python3 python3-pip python3-venv -``` - -**macOS:** -```bash -# Install Homebrew first if needed -brew install python3 -``` - -**Windows:** -- Download from [python.org](https://python.org) -- Check "Add Python to PATH" during installation -- Restart terminal after installation - -
- ---- - -## ๐Ÿ“š **Next Steps** - -
- -### **Your Learning Journey** - - - - - - - - - - - - -
๐ŸŒฑ Start Here๐ŸŒฟ Expand Skills๐ŸŒฒ Master Framework
- -**First Week:** -- [Quick Start Guide](quick-start.md) -- [Commands Reference](../User-Guide/commands.md) -- Try `/sc:brainstorm` - - - -**Week 2-3:** -- [Behavioral Modes](../User-Guide/modes.md) -- [Agents Guide](../User-Guide/agents.md) -- [Examples Cookbook](../Reference/examples-cookbook.md) - - - -**Advanced:** -- [MCP Servers](../User-Guide/mcp-servers.md) -- [Technical Architecture](../Developer-Guide/technical-architecture.md) -- [Contributing Code](../Developer-Guide/contributing-code.md) - -
- -
- ---- - -
- -### **๐ŸŽ‰ Installation Complete!** - -You now have access to: - -

- 21 Commands โ€ข 14 AI Agents โ€ข 6 Behavioral Modes โ€ข 6 MCP Servers -

- -**Ready to start?** Try `/sc:brainstorm` in Claude Code for your first SuperClaude experience! - -

- - Quick Start - -

- -
\ No newline at end of file diff --git a/docs/Getting-Started/quick-start.md b/docs/Getting-Started/quick-start.md deleted file mode 100644 index f825ae5..0000000 --- a/docs/Getting-Started/quick-start.md +++ /dev/null @@ -1,492 +0,0 @@ -
- -# ๐Ÿš€ SuperClaude Quick Start Guide - -### **Context Engineering Framework for Claude Code** - -

- Framework - Version - Quick Start -

- -> **๐Ÿ’ก Key Insight**: SuperClaude doesn't replace Claude Code - it **configures and enhances** it through behavioral context injection - -

- How It Works โ€ข - Instant Start โ€ข - Components โ€ข - Workflows โ€ข - When to Use -

- -
- ---- - -
- -## ๐Ÿ“Š **Framework Capabilities** - -| **Commands** | **AI Agents** | **Behavioral Modes** | **MCP Servers** | -|:------------:|:-------------:|:-------------------:|:---------------:| -| **21** | **14** | **6** | **6** | -| `/sc:` triggers | Domain specialists | Context adaptation | Tool integration | - -
- ---- - -## ๐ŸŽฏ **How It Works** - -
- -### **Framework Architecture Flow** - -``` -โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” -โ”‚ User Input โ”‚โ”€โ”€โ”€โ”€>โ”‚ Claude Code โ”‚โ”€โ”€โ”€โ”€>โ”‚ Context Files โ”‚ -โ”‚ /sc:command โ”‚ โ”‚ Reads Context โ”‚ โ”‚ (.md behaviors)โ”‚ -โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ - โ”‚ โ”‚ - โ–ผ โ–ผ -โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” -โ”‚ Enhanced โ”‚<โ”€โ”€โ”€โ”€โ”€โ”‚ Behavioral โ”‚<โ”€โ”€โ”€โ”€โ”‚ MCP Servers โ”‚ -โ”‚ Response โ”‚ โ”‚ Activation โ”‚ โ”‚ (if configured) โ”‚ -โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ -``` - -**The Magic**: When you type `/sc:brainstorm`, Claude reads behavioral instructions from installed `.md` files and responds with enhanced capabilities - -
- ---- - -## โšก **Instant Start** - -
- -### **5-Minute Journey from Installation to First Command** - -
- - - - - - - - - - -
๐Ÿ“ฆ Step 1: Install (Terminal)๐Ÿ’ฌ Step 2: Use (Claude Code)
- -```bash -# Quick install with pipx -pipx install SuperClaude && SuperClaude install - -# Or traditional pip -pip install SuperClaude && SuperClaude install - -# Or via npm -npm install -g @bifrost_inc/superclaude && superclaude install -``` - - - -```text -# Interactive discovery -/sc:brainstorm "web app for task management" - -# Analyze existing code -/sc:analyze src/ - -# Generate implementation -/sc:implement "user authentication" - -# Activate specialist -@agent-security "review auth flow" -``` - -
- -
-๐ŸŽฅ What Happens Behind the Scenes - -1. **Context Loading**: Claude Code imports behavioral `.md` files via `CLAUDE.md` -2. **Pattern Recognition**: Recognizes `/sc:` and `@agent-` trigger patterns -3. **Behavioral Activation**: Applies corresponding instructions from context files -4. **MCP Integration**: Uses configured external tools when available -5. **Response Enhancement**: Follows framework patterns for comprehensive responses - -
- ---- - -## ๐Ÿ”ง **Core Components** - -
- -### **Four Pillars of SuperClaude** - - - - - - - - -
- -### ๐Ÿ“ **Commands** -

21

- -**Slash Commands** - -`/sc:brainstorm` -`/sc:implement` -`/sc:analyze` -`/sc:workflow` - -*Workflow automation* - -		 - -### ๐Ÿค– **Agents** -

14

- -**AI Specialists** - -`@agent-architect` -`@agent-security` -`@agent-frontend` -`@agent-backend` - -*Domain expertise* - -		 - -### ๐ŸŽฏ **Modes** -

6

- -**Behavioral Modes** - -Brainstorming -Introspection -Orchestration -Task Management - -*Context adaptation* - -		 - -### ๐Ÿ”Œ **MCP** -

6

- -**Server Integration** - -Context7 (docs) -Sequential (analysis) -Magic (UI) -Playwright (testing) - -*Enhanced tools* - -
- -
- ---- - -## ๐Ÿ“š **Workflow Patterns** - -
- -### **Complete Development Lifecycle** - -
- -### **๐ŸŒŸ First Project Session** - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
StepCommandWhat Happens
1. Discovery/sc:brainstorm "e-commerce app"Interactive requirements exploration
2. Load Context/sc:load src/Import existing project structure
3. Analysis/sc:analyze --focus architectureDeep architectural review
4. Planning/sc:workflow "payment integration"Generate implementation roadmap
5. Implementation/sc:implement "Stripe checkout"Build with best practices
6. Validation/sc:test --coverageComprehensive testing
7. Save Session/sc:save "payment-complete"Persist for next session
- -### **๐ŸŽจ Domain-Specific Workflows** - -
- -| Domain | Trigger | Specialist Activation | MCP Server | -|--------|---------|----------------------|------------| -| **Frontend** | UI component request | `@agent-frontend` | Magic | -| **Backend** | API endpoint creation | `@agent-backend` | Sequential | -| **Security** | Auth implementation | `@agent-security` | Context7 | -| **Testing** | E2E test scenarios | `@agent-qa` | Playwright | -| **DevOps** | Deployment setup | `@agent-devops` | Morphllm | - -
- ---- - -## ๐ŸŽฏ **When to Use** - -
- -### **SuperClaude vs Standard Claude Code** - - - - - - - - - - -
โœ… Use SuperClaude๐Ÿ’ญ Use Standard Claude
- -**Perfect for:** -- ๐Ÿ—๏ธ Building complete software projects -- ๐Ÿ“Š Systematic workflows with quality gates -- ๐Ÿ”„ Complex, multi-component systems -- ๐Ÿ’พ Long-term projects needing persistence -- ๐Ÿ‘ฅ Team collaboration with standards -- ๐ŸŽฏ Domain-specific expertise needs - -**Examples:** -- "Build a full-stack application" -- "Implement secure authentication" -- "Refactor legacy codebase" -- "Create comprehensive test suite" - - - -**Better for:** -- ๐Ÿ’ก Simple questions or explanations -- โšก One-off coding tasks -- ๐Ÿ“š Learning programming concepts -- ๐Ÿงช Quick prototypes or experiments -- ๐Ÿ” Code snippet generation -- โ“ General programming help - -**Examples:** -- "Explain how async/await works" -- "Write a sorting function" -- "Debug this error message" -- "Convert this loop to functional" - -
- -
- ---- - -## ๐ŸŽ“ **Learning Path** - -
- -### **Your 4-Week Journey to Mastery** - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
WeekFocusSkillsMilestone
1
๐ŸŒฑ		Core Commands -โ€ข /sc:brainstorm
-โ€ข /sc:analyze
-โ€ข /sc:implement -		Complete first project
2
๐ŸŒฟ		Behavioral Modes -โ€ข Mode combinations
-โ€ข Flag usage
-โ€ข Context optimization -		Optimize workflows
3
๐ŸŒฟ		MCP Servers -โ€ข Server configuration
-โ€ข Tool integration
-โ€ข Enhanced capabilities -		Full tool utilization
4
๐ŸŒฒ		Advanced Patterns -โ€ข Custom workflows
-โ€ข Session management
-โ€ข Team patterns -		Framework mastery
- -
- ---- - -## ๐Ÿ’ก **Key Insights** - -
- -### **Understanding SuperClaude's Value** - - - - - - - -
- -### ๐Ÿง  **Not Software** -**It's a Framework** - -SuperClaude is behavioral configuration, not standalone software. Everything runs through Claude Code. - - - -### ๐Ÿ”„ **Systematic** -**Not Ad-hoc** - -Transforms random requests into structured workflows with quality gates and validation. - - - -### ๐Ÿš€ **Progressive** -**Not Complex** - -Start simple with basic commands. Complexity emerges naturally as needed. - -
- -
- ---- - -## ๐Ÿ“– **Next Steps** - -
- -### **Continue Your Learning Journey** - - - - - - - - - - - - -
๐ŸŒฑ Beginner๐ŸŒฟ Intermediate๐ŸŒฒ Advanced
- -**First Week:** -- [Installation Guide](installation.md) -- [Commands Reference](../User-Guide/commands.md) -- [Examples Cookbook](../Reference/examples-cookbook.md) - -Start with `/sc:brainstorm` - - - -**Growing Skills:** -- [Behavioral Modes](../User-Guide/modes.md) -- [Agents Guide](../User-Guide/agents.md) -- [Session Management](../User-Guide/session-management.md) - -Explore mode combinations - - - -**Expert Usage:** -- [MCP Servers](../User-Guide/mcp-servers.md) -- [Technical Architecture](../Developer-Guide/technical-architecture.md) -- [Contributing](../Developer-Guide/contributing-code.md) - -Create custom workflows - -
- -

- - Commands - - - Examples - -

- -
- ---- - -
- -### **๐ŸŽ‰ Ready to Transform Your Development Workflow?** - -

- Start now with /sc:brainstorm in Claude Code! -

- -

- SuperClaude v4.1.5 - Context Engineering for Claude Code -

- -
\ No newline at end of file diff --git a/docs/Reference/README.md b/docs/Reference/README.md deleted file mode 100644 index 713cddf..0000000 --- a/docs/Reference/README.md +++ /dev/null @@ -1,249 +0,0 @@ -# SuperClaude Framework Reference Documentation - -**Navigation Hub**: Structured learning paths and technical references for all skill levels. - -**Documentation Status**: โœ… **Status: Current** - All content verified for accuracy and completeness. - -## How to Use This Reference Library - -This documentation is organized for **progressive learning** with multiple entry points: - -- **๐Ÿ“ฑ Quick Reference**: Jump to specific solutions for immediate needs -- **๐Ÿ“š Learning Paths**: Structured progression from beginner to expert -- **๐Ÿ” Problem-Solving**: Targeted troubleshooting and diagnostic guidance -- **โšก Performance**: Optimization patterns and advanced techniques - -**Verification Standards**: All examples tested, commands validated, patterns proven in real-world usage. - ---- - -## Documentation Navigation Matrix - -| Document | Purpose | Target Audience | Complexity | | -|----------|---------|-----------------|------------|-----------------| -| **[basic-examples.md](./basic-examples.md)** | Copy-paste ready commands and patterns | All users, quick reference | **Basic** | | -| **[examples-cookbook.md](./examples-cookbook.md)** | Recipe collection hub and organization | All users, navigation | **Reference** | | -| **[common-issues.md](./common-issues.md)** | Essential troubleshooting and solutions | All users, problem-solving | **Basic** | As needed | -| **[mcp-server-guide.md](./mcp-server-guide.md)** | MCP server configuration and usage | Technical users, integration | **Intermediate** | | - -| **[advanced-patterns.md](./advanced-patterns.md)** | Expert coordination and orchestration | Experienced users | **Advanced** | | -| **[advanced-workflows.md](./advanced-workflows.md)** | Complex multi-agent orchestration | Expert users | **Advanced** | | -| **[integration-patterns.md](./integration-patterns.md)** | Framework and system integration | Architects, experts | **Advanced** | | -| **[troubleshooting.md](./troubleshooting.md)** | Comprehensive diagnostic guide | All levels, deep debugging | **Variable** | As needed | -| **[diagnostic-reference.md](./diagnostic-reference.md)** | Advanced debugging and analysis | Expert users, complex issues | **Advanced** | | - ---- - -## Recommended Learning Paths - -### New Users (Week 1 Foundation) -**Goal**: Establish confident SuperClaude usage with essential workflows - -``` -Day 1-2: ../Getting-Started/quick-start.md - โ†“ Foundation building and first commands -Day 3-4: basic-examples.md - โ†“ Practical application and pattern recognition -Day 5-7: common-issues.md - โ†“ Problem resolution and confidence building -``` - -**Success Metrics**: Can execute basic commands, manage sessions, resolve common issues independently. - -### Intermediate Users (Week 2-3 Enhancement) -**Goal**: Master coordination patterns and technical depth - -``` -Week 2: advanced-patterns.md - โ†“ Multi-agent coordination and orchestration mastery -Week 3: mcp-server-guide.md + advanced-workflows.md - โ†“ Performance excellence and technical configuration -``` - -**Success Metrics**: Can orchestrate complex workflows, optimize performance, configure MCP servers. - -### Expert Users (Advanced Mastery) -**Goal**: Complete framework mastery and complex system integration - -``` -Phase 1: advanced-workflows.md - โ†“ Complex orchestration and enterprise patterns -Phase 2: integration-patterns.md - โ†“ Framework integration and architectural mastery -Phase 3: diagnostic-reference.md - โ†“ Advanced debugging and system analysis -``` - -**Success Metrics**: Can design custom workflows, integrate with any framework, diagnose complex issues. - -### Problem-Solving Path (As Needed) -**Goal**: Immediate issue resolution and diagnostic guidance - -``` -Quick Issues: common-issues.md - โ†“ Common problems and immediate solutions -Complex Debugging: troubleshooting.md - โ†“ Comprehensive diagnostic approach -Advanced Analysis: diagnostic-reference.md - โ†“ Expert-level debugging and analysis -``` - ---- - -## Command Quick Reference - -### Essential SuperClaude Commands - -| Command Pattern | Purpose | Example | -|----------------|---------|---------| -| `/sc:load` | Restore session context | `/sc:load project_name` | -| `/sc:save` | Preserve session state | `/sc:save "milestone checkpoint"` | -| `--think` | Enable structured analysis | `--think analyze performance bottlenecks` | -| `--brainstorm` | Collaborative requirement discovery | `--brainstorm new authentication system` | -| `--task-manage` | Multi-step operation orchestration | `--task-manage refactor user module` | - -### Performance & Efficiency Flags - -| Flag | Purpose | Best For | -|------|---------|----------| -| `--uc` / `--ultracompressed` | Token-efficient communication | Large operations, context pressure | -| `--orchestrate` | Optimize tool selection | Multi-tool operations, performance needs | -| `--loop` | Iterative improvement cycles | Code refinement, quality enhancement | -| `--validate` | Pre-execution risk assessment | Production environments, critical operations | - -### MCP Server Activation - -| Flag | Server | Best For | -|------|---------|----------| -| `--c7` / `--context7` | Context7 | Official documentation, framework patterns | -| `--seq` / `--sequential` | Sequential | Complex analysis, debugging, system design | -| `--magic` | Magic | UI components, design systems, frontend work | -| `--morph` / `--morphllm` | Morphllm | Bulk transformations, pattern-based edits | -| `--serena` | Serena | Symbol operations, project memory, large codebases | -| `--play` / `--playwright` | Playwright | Browser testing, E2E scenarios, visual validation | - ---- - -## Framework Integration Quick Start - -### React/Next.js Projects -```bash -# Initialize with React patterns ---c7 --magic "implement Next.js authentication with TypeScript" - -# Component development workflow ---magic --think "create responsive dashboard component" -``` - -### Node.js/Express Backend -```bash -# API development with best practices ---c7 --seq "design RESTful API with Express and MongoDB" - -# Performance optimization ---think --orchestrate "optimize database queries and caching" -``` - -### Full-Stack Development -```bash -# Complete application workflow ---task-manage --all-mcp "build full-stack e-commerce platform" - -# Integration testing ---play --seq "implement end-to-end testing strategy" -``` - ---- - -## Problem-Solving Quick Reference - -### Immediate Issues -- **Command not working**: Check [common-issues.md](./common-issues.md) โ†’ Common SuperClaude Problems -- **Session lost**: Use `/sc:load` โ†’ See [Session Management](../User-Guide/session-management.md) -- **Flag confusion**: Check [basic-examples.md](./basic-examples.md) โ†’ Flag Usage Examples - -### Development Blockers -- **Performance slow**: See [Advanced Workflows](./advanced-workflows.md) โ†’ Performance Patterns -- **Complex debugging**: Use [troubleshooting.md](./troubleshooting.md) โ†’ Systematic Debugging -- **Integration issues**: Check [integration-patterns.md](./integration-patterns.md) โ†’ Framework Patterns - -### System-Level Issues -- **Architecture problems**: Use [advanced-workflows.md](./advanced-workflows.md) โ†’ System Design -- **Expert debugging**: Apply [diagnostic-reference.md](./diagnostic-reference.md) โ†’ Advanced Analysis -- **Custom workflow needs**: Study [advanced-patterns.md](./advanced-patterns.md) โ†’ Custom Orchestration [advanced-patterns.md](./advanced-patterns.md) โ†’ Custom Orchestration - ---- - -## Documentation Health & Verification - -### Quality Assurance -- โœ… **Commands Tested**: All examples tested and functional -- โœ… **Patterns Proven**: Real-world usage validation in production environments -- โœ… **Cross-References**: Internal links verified and maintained -- โœ… **Regular Updates**: Documentation synchronized with framework evolution - -### Accuracy Standards -- **Command Syntax**: Verified against latest SuperClaude implementation -- **Flag Behavior**: Tested in multiple scenarios and environments -- **MCP Integration**: Confirmed compatibility with current MCP server versions -- **Performance Claims**: Benchmarked and measured in realistic conditions - -### Reporting Issues -Found outdated information or broken examples? - -1. **Quick Fixes**: Check [common-issues.md](./common-issues.md) first -2. **Documentation Bugs**: Report via project issues with specific file and line -3. **Missing Patterns**: Suggest additions with use case description -4. **Verification Requests**: Request re-testing of specific examples - ---- - -## Expert Tips for Maximum Productivity - -### Daily Workflow Optimization -1. **Session Management**: Always start with `/sc:load`, end with `/sc:save` -2. **Flag Combinations**: Combine complementary flags: `--think --c7` for documented analysis -3. **Progressive Complexity**: Start simple, add sophistication incrementally -4. **Tool Specialization**: Match tools to tasks: Magic for UI, Sequential for analysis - -### Learning Acceleration -1. **Follow the Paths**: Use recommended learning sequences for structured growth -2. **Practice Patterns**: Repeat common workflows until they become intuitive -3. **Experiment Safely**: Use feature branches and checkpoints for exploration -4. **Community Learning**: Share discoveries and learn from others' approaches - -### Troubleshooting Mastery -1. **Systematic Approach**: Always start with [common-issues.md](./common-issues.md) -2. **Evidence Gathering**: Use `--think` for complex problem analysis -3. **Root Cause Focus**: Address underlying issues, not just symptoms -4. **Documentation First**: Check official docs before experimental solutions - ---- - -## Advanced Resources & Integration - -### Framework-Specific Guides -- **React/Next.js**: See [integration-patterns.md](./integration-patterns.md) โ†’ React Integration -- **Vue/Nuxt**: See [integration-patterns.md](./integration-patterns.md) โ†’ Vue Ecosystem -- **Node.js/Express**: See [integration-patterns.md](./integration-patterns.md) โ†’ Backend Patterns -- **Python/Django**: See [integration-patterns.md](./integration-patterns.md) โ†’ Python Workflows - -### Specialized Workflows -- **DevOps Integration**: [advanced-workflows.md](./advanced-workflows.md) โ†’ CI/CD Patterns -- **Testing Strategies**: [advanced-patterns.md](./advanced-patterns.md) โ†’ Testing Orchestration -- **Performance Engineering**: [Advanced Patterns](./advanced-patterns.md) โ†’ Complex Coordination -- **Security Implementation**: [integration-patterns.md](./integration-patterns.md) โ†’ Security Patterns - -### Community & Support -- **Best Practices**: Continuously updated based on community feedback -- **Pattern Library**: Growing collection of proven workflow patterns -- **Expert Network**: Connect with experienced SuperClaude practitioners -- **Regular Updates**: Documentation evolves with framework capabilities - ---- - -**Start Your Journey**: New to SuperClaude? Begin with [Quick Start Guide](../Getting-Started/quick-start.md) for immediate productivity gains. - -**Need Answers Now**: Jump to [basic-examples.md](./basic-examples.md) for copy-paste solutions. - -**Ready for Advanced**: Explore [advanced-patterns.md](./advanced-patterns.md) for expert-level orchestration. \ No newline at end of file diff --git a/docs/Reference/advanced-patterns.md b/docs/Reference/advanced-patterns.md deleted file mode 100644 index b0256f4..0000000 --- a/docs/Reference/advanced-patterns.md +++ /dev/null @@ -1,323 +0,0 @@ -# SuperClaude Advanced Patterns - -**Advanced Context Usage Patterns**: Sophisticated combinations of commands, agents, and flags for experienced SuperClaude users working on complex projects. - -**Remember**: SuperClaude provides context to Claude Code. All patterns here are about guiding Claude's behavior through context, not executing code or coordinating processes. - -## Table of Contents - -### Context Combination Patterns -- [Multi-Agent Context Patterns](#multi-agent-context-patterns) - Combining multiple specialist contexts -- [Command Sequencing Patterns](#command-sequencing-patterns) - Effective command combinations -- [Flag Combination Strategies](#flag-combination-strategies) - Advanced flag usage - -### Workflow Patterns -- [Complex Project Patterns](#complex-project-patterns) - Large project approaches -- [Migration Patterns](#migration-patterns) - Legacy system modernization -- [Review and Audit Patterns](#review-and-audit-patterns) - Comprehensive analysis - -## Multi-Agent Context Patterns - -### Combining Specialist Contexts - -**Security + Backend Pattern:** -```bash -# Security-focused backend development -@agent-security "define authentication requirements" -@agent-backend-architect "design API with security requirements" -/sc:implement "secure API endpoints" - -# What happens: -# 1. Security context loaded first -# 2. Backend context added -# 3. Implementation guided by both contexts -# Note: Contexts combine in Claude's understanding, not in execution -``` - -**Frontend + UX + Accessibility Pattern:** -```bash -# Comprehensive frontend development -@agent-frontend-architect "design component architecture" -/sc:implement "accessible React components" --magic -@agent-quality-engineer "review accessibility compliance" - -# Context layering: -# - Frontend patterns guide structure -# - Magic MCP may provide UI components (if configured) -# - Quality context ensures standards -``` - -### Manual vs Automatic Agent Selection - -**Explicit Control Pattern:** -```bash -# Manually control which contexts load -@agent-python-expert "implement data pipeline" -# Only Python context, no auto-activation - -# vs Automatic selection -/sc:implement "Python data pipeline" -# May activate multiple agents based on keywords -``` - -**Override Auto-Selection:** -```bash -# Prevent unwanted agent activation -/sc:implement "simple utility" --no-mcp -@agent-backend-architect "keep it simple" -# Limits context to specified agent only -``` - -## Command Sequencing Patterns - -### Progressive Refinement Pattern - -```bash -# Start broad, then focus -/sc:analyze project/ -# General analysis - -/sc:analyze project/core/ --focus architecture -# Focused on structure - -/sc:analyze project/core/auth/ --focus security --think-hard -# Deep security analysis - -# Each command builds on previous context within the conversation -``` - -### Discovery to Implementation Pattern - -```bash -# Complete feature development flow -/sc:brainstorm "feature idea" -# Explores requirements - -/sc:design "feature architecture" -# Creates structure - -@agent-backend-architect "review design" -# Expert review - -/sc:implement "feature based on design" -# Implementation follows design - -/sc:test --validate -# Verification approach -``` - -### Iterative Improvement Pattern - -```bash -# Multiple improvement passes -/sc:analyze code/ --focus quality -# Identify issues - -/sc:improve code/ --fix -# First improvement pass - -@agent-refactoring-expert "suggest further improvements" -# Expert suggestions - -/sc:improve code/ --fix --focus maintainability -# Refined improvements -``` - -## Flag Combination Strategies - -### Analysis Depth Control - -```bash -# Quick overview -/sc:analyze . --overview --uc -# Fast, compressed output - -# Standard analysis -/sc:analyze . --think -# Structured thinking - -# Deep analysis -/sc:analyze . --think-hard --verbose -# Comprehensive analysis - -# Maximum depth (use sparingly) -/sc:analyze . --ultrathink -# Exhaustive analysis -``` - -### MCP Server Selection - -```bash -# Selective MCP usage -/sc:implement "React component" --magic --c7 -# Only Magic and Context7 MCP - -# Disable all MCP -/sc:implement "simple function" --no-mcp -# Pure Claude context only - -# All available MCP -/sc:analyze complex-system/ --all-mcp -# Maximum tool availability (if configured) -``` - -## Complex Project Patterns - -### Large Codebase Analysis - -```bash -# Systematic exploration of large projects -# Step 1: Structure understanding -/sc:load project/ -/sc:analyze . --overview --focus architecture - -# Step 2: Identify problem areas -@agent-quality-engineer "identify high-risk modules" - -# Step 3: Deep dive into specific areas -/sc:analyze high-risk-module/ --think-hard --focus quality - -# Step 4: Implementation plan -/sc:workflow "improvement plan based on analysis" -``` - -### Multi-Module Development - -```bash -# Developing interconnected modules -# Frontend module -/sc:implement "user interface module" -@agent-frontend-architect "ensure consistency" - -# Backend module -/sc:implement "API module" -@agent-backend-architect "ensure compatibility" - -# Integration layer -/sc:implement "frontend-backend integration" -# Context from both previous implementations guides this -``` - -### Cross-Technology Projects - -```bash -# Projects with multiple technologies -# Python backend -@agent-python-expert "implement FastAPI backend" - -# React frontend -@agent-frontend-architect "implement React frontend" - -# DevOps setup -@agent-devops-architect "create deployment configuration" - -# Integration documentation -/sc:document --type integration -``` - -## Migration Patterns - -### Legacy System Analysis - -```bash -# Understanding legacy systems -/sc:load legacy-system/ -/sc:analyze . --focus architecture --verbose - -@agent-refactoring-expert "identify modernization opportunities" -@agent-system-architect "propose migration strategy" - -/sc:workflow "create migration plan" -``` - -### Incremental Migration - -```bash -# Step-by-step migration approach -# Phase 1: Analysis -/sc:analyze legacy-module/ --comprehensive - -# Phase 2: Design new architecture -@agent-system-architect "design modern replacement" - -# Phase 3: Implementation -/sc:implement "modern module with compatibility layer" - -# Phase 4: Validation -/sc:test --focus compatibility -``` - -## Review and Audit Patterns - -### Security Audit Pattern - -```bash -# Comprehensive security review -/sc:analyze . --focus security --think-hard -@agent-security "review authentication and authorization" -@agent-security "check for OWASP vulnerabilities" -/sc:document --type security-audit -``` - -### Code Quality Review - -```bash -# Multi-aspect quality review -/sc:analyze src/ --focus quality -@agent-quality-engineer "review test coverage" -@agent-refactoring-expert "identify code smells" -/sc:improve --fix --preview -``` - -### Architecture Review - -```bash -# System architecture assessment -@agent-system-architect "review current architecture" -/sc:analyze . --focus architecture --think-hard -@agent-performance-engineer "identify bottlenecks" -/sc:design "optimization recommendations" -``` - -## Important Clarifications - -### What These Patterns Actually Do - -- โœ… **Guide Claude's Thinking**: Provide structured approaches -- โœ… **Combine Contexts**: Layer multiple expertise areas -- โœ… **Improve Output Quality**: Better code generation through better context -- โœ… **Structure Workflows**: Organize complex tasks - -### What These Patterns Don't Do - -- โŒ **Execute in Parallel**: Everything is sequential context loading -- โŒ **Coordinate Processes**: No actual process coordination -- โŒ **Optimize Performance**: No code runs, so no performance impact -- โŒ **Persist Between Sessions**: Each conversation is independent - -## Best Practices for Advanced Usage - -### Context Management - -1. **Layer Deliberately**: Add contexts in logical order -2. **Avoid Overload**: Too many agents can dilute focus -3. **Use Manual Control**: Override auto-activation when needed -4. **Maintain Conversation Flow**: Keep related work in same conversation - -### Command Efficiency - -1. **Progress Logically**: Broad โ†’ Specific โ†’ Implementation -2. **Reuse Context**: Later commands benefit from earlier context -3. **Document Decisions**: Use `/sc:save` for important summaries -4. **Scope Appropriately**: Focus on manageable chunks - -### Flag Usage - -1. **Match Task Complexity**: Simple tasks don't need `--ultrathink` -2. **Control Output**: Use `--uc` for concise results -3. **Manage MCP**: Only activate needed servers -4. **Avoid Conflicts**: Don't use contradictory flags - -## Summary - -Advanced SuperClaude patterns are about sophisticated context management and command sequencing. They help Claude Code generate better outputs by providing richer, more structured context. Remember: all "coordination" and "optimization" happens in how Claude interprets the context, not in any actual execution or parallel processing. \ No newline at end of file diff --git a/docs/Reference/advanced-workflows.md b/docs/Reference/advanced-workflows.md deleted file mode 100644 index f8d7775..0000000 --- a/docs/Reference/advanced-workflows.md +++ /dev/null @@ -1,309 +0,0 @@ -# SuperClaude Advanced Workflows Collection - -**Status**: โœ… **Status: Current** - Complex command sequences and context combinations for sophisticated projects. - -**Advanced Usage Guide**: Patterns for complex projects using multiple commands, agents, and careful context management within Claude Code conversations. - -## Overview and Usage Guide - -**Purpose**: Advanced SuperClaude patterns for complex, multi-step projects that require careful sequencing of commands and context management. - -**Important**: These are conversation patterns, not executing workflows. All work happens within Claude Code based on context provided. - -**Key Concepts**: -- Command sequences within a conversation -- Context layering through multiple agents -- Progressive refinement approaches -- Project phase management (manual, not automated) - -## Multi-Context Project Patterns - -### Full-Stack Development Sequence - -```bash -# E-commerce platform using multiple contexts -# Step 1: Architecture context -@agent-system-architect "design e-commerce architecture" - -# Step 2: Security requirements -@agent-security "define security requirements for payments" - -# Step 3: Backend implementation -/sc:implement "API with authentication and payment processing" -# Claude uses accumulated context from previous steps - -# Step 4: Frontend implementation -@agent-frontend-architect "design responsive UI" -/sc:implement "React frontend with TypeScript" - -# Step 5: Review -/sc:analyze . --focus quality - -# Note: Each step builds context within the conversation -# No actual coordination or parallel execution occurs -``` - -### Problem-Solving Workflow - -```bash -# Complex troubleshooting approach -# Step 1: Problem understanding -/sc:troubleshoot "application performance issues" - -# Step 2: Expert analysis -@agent-performance-engineer "analyze potential bottlenecks" -@agent-backend-architect "review architecture for issues" - -# Step 3: Solution design -/sc:design "performance improvement plan" - -# Step 4: Implementation -/sc:implement "performance optimizations" - -# Context accumulates but doesn't execute -``` - -## Complex Project Phases - -### Project Initialization Pattern - -```bash -# Starting a new project -# Discovery phase -/sc:brainstorm "project concept" -# Claude explores requirements - -# Planning phase -/sc:design "system architecture" -@agent-system-architect "review and refine" - -# Documentation -/sc:document --type architecture -/sc:save "project-plan" -# Creates summary for your records (not persistent storage) -``` - -### Incremental Development Pattern - -```bash -# Building features incrementally -# Feature 1: Authentication -/sc:implement "user authentication" -/sc:test --focus security -/sc:document --type api - -# Feature 2: User Profiles (builds on auth context) -/sc:implement "user profile management" -/sc:test --focus functionality - -# Feature 3: Admin Dashboard (uses previous context) -/sc:implement "admin dashboard" -@agent-frontend-architect "ensure consistency" - -# Each feature builds on conversation context -``` - -### Migration Project Pattern - -```bash -# Legacy system migration -# Phase 1: Analysis -/sc:load legacy-system/ -/sc:analyze . --focus architecture --verbose -# Claude builds understanding - -# Phase 2: Planning -@agent-system-architect "design migration strategy" -/sc:workflow "create migration plan" - -# Phase 3: Implementation -/sc:implement "compatibility layer" -/sc:implement "new system components" - -# Phase 4: Validation -/sc:test --focus compatibility -/sc:document --type migration - -# Manual phases, not automated workflow -``` - -## Enterprise-Scale Patterns - -### Large Codebase Analysis - -```bash -# Systematic analysis of large projects -# Overview -/sc:analyze . --overview -# Get high-level understanding - -# Focused analysis by module -/sc:analyze auth-module/ --focus security -/sc:analyze api-module/ --focus quality -/sc:analyze frontend/ --focus performance - -# Synthesis -@agent-system-architect "synthesize findings" -/sc:workflow "improvement recommendations" - -# Note: Sequential analysis, not parallel -``` - -### Multi-Technology Projects - -```bash -# Projects with diverse tech stacks -# Backend (Python) -@agent-python-expert "implement FastAPI backend" -/sc:implement "Python API with async support" - -# Frontend (React) -@agent-frontend-architect "implement React frontend" -/sc:implement "TypeScript React application" - -# Mobile (React Native) -/sc:implement "React Native mobile app" - -# Infrastructure -@agent-devops-architect "design deployment" -/sc:implement "Docker configuration" - -# Each technology addressed sequentially -``` - -## Quality Assurance Workflows - -### Comprehensive Review Pattern - -```bash -# Multi-aspect code review -# Quality review -/sc:analyze . --focus quality -@agent-quality-engineer "identify improvements" - -# Security review -/sc:analyze . --focus security -@agent-security "check for vulnerabilities" - -# Architecture review -@agent-system-architect "evaluate design" - -# Performance review -@agent-performance-engineer "suggest optimizations" - -# Consolidated improvements -/sc:improve . --fix - -# Sequential reviews, not parallel analysis -``` - -### Testing Strategy Pattern - -```bash -# Comprehensive testing approach -# Test planning -/sc:design "testing strategy" - -# Unit tests -/sc:test --type unit -# Claude generates unit test code - -# Integration tests -/sc:test --type integration -# Claude generates integration test code - -# E2E tests -/sc:test --type e2e -# Claude suggests E2E test scenarios - -# Documentation -/sc:document --type testing - -# Test code generation, not execution -``` - -## Session Management Patterns - -### Long Project Sessions - -```bash -# Managing context in long conversations -# Start with context -/sc:load project/ - -# Work progressively -/sc:implement "feature A" -/sc:implement "feature B" -# Context accumulates - -# Create checkpoint -/sc:save "session-checkpoint" -# Creates summary for your notes - -# Continue work -/sc:implement "feature C" - -# Final summary -/sc:reflect -# Reviews conversation progress -``` - -### Context Refresh Pattern - -```bash -# When conversation gets too long -# Save current state -/sc:save "work-complete" -# Copy output for next conversation - -# In new conversation: -/sc:load project/ -"Previous work: [paste summary]" -# Manually restore context - -# Continue work -/sc:implement "next feature" -``` - -## Important Clarifications - -### What These Workflows ARE - -- โœ… **Conversation Patterns**: Sequences within a single Claude conversation -- โœ… **Context Building**: Progressive accumulation of understanding -- โœ… **Command Sequences**: Ordered use of commands for better results -- โœ… **Manual Phases**: User-controlled project progression - -### What These Workflows ARE NOT - -- โŒ **Automated Workflows**: No automatic execution or orchestration -- โŒ **Parallel Processing**: Everything is sequential -- โŒ **Persistent Sessions**: Context lost between conversations -- โŒ **Performance Optimization**: No code executes to optimize - -## Best Practices - -### Conversation Management - -1. **Keep Related Work Together**: Don't split related tasks across conversations -2. **Build Context Progressively**: Start broad, then focus -3. **Document Key Decisions**: Use `/sc:save` for important points -4. **Manage Conversation Length**: Start new conversation if too long - -### Command Sequencing - -1. **Logical Order**: Analysis โ†’ Design โ†’ Implementation โ†’ Testing -2. **Context Accumulation**: Later commands benefit from earlier context -3. **Appropriate Depth**: Match analysis depth to task complexity -4. **Clear Scope**: Focus commands on specific areas - -### Agent Usage - -1. **Strategic Activation**: Use agents for specific expertise -2. **Avoid Overload**: Too many agents can dilute focus -3. **Manual Control**: Use `@agent-` for precise control -4. **Context Layering**: Add agents in logical order - -## Summary - -Advanced workflows in SuperClaude are sophisticated conversation patterns that build context progressively within a single Claude Code session. They help generate better outputs through careful command sequencing and context management, but do not involve any actual workflow execution, parallel processing, or automation. Success comes from understanding how to layer context effectively within Claude's conversation scope. \ No newline at end of file diff --git a/docs/Reference/basic-examples.md b/docs/Reference/basic-examples.md deleted file mode 100644 index b6e10e8..0000000 --- a/docs/Reference/basic-examples.md +++ /dev/null @@ -1,553 +0,0 @@ -# SuperClaude Basic Examples Collection - -**Status**: โœ… **Status: Current** - Essential commands, single-agent workflows, and common development tasks. - -**Quick Reference Guide**: Copy-paste ready examples for beginners, focused on essential SuperClaude usage patterns and fundamental development workflows. - -> **๐Ÿ“ Context Note**: These examples show `/sc:` commands and `@agent-` invocations that trigger Claude Code to read specific context files and adopt the behaviors defined there. The sophistication comes from the behavioral instructions, not from executable software. - -## Overview and Usage Guide - -**Purpose**: Essential SuperClaude commands and patterns for everyday development tasks. Start here for your first SuperClaude experience. - -**Target Audience**: New users, developers learning SuperClaude fundamentals, immediate task application - -**Usage Pattern**: Copy โ†’ Adapt โ†’ Execute โ†’ Learn from results - -**Key Features**: -- Examples demonstrate core SuperClaude functionality -- Clear patterns for immediate application -- Single-focus examples for clear learning -- Progressive complexity within basic scope - -## Essential One-Liner Commands - -### Core Development Commands - -#### Command: /sc:brainstorm -**Purpose**: Interactive project discovery and requirements gathering -**Syntax**: `/sc:brainstorm "project description"` -**Example**: -```bash -/sc:brainstorm "mobile app for fitness tracking" -# Expected: Socratic dialogue, requirement elicitation, feasibility analysis -``` -**Behavior**: Triggers interactive discovery dialogue and requirements analysis - -#### Command: /sc:analyze -**Purpose**: Analyze existing codebase for issues and improvements -**Syntax**: `/sc:analyze [target] --focus [domain]` -**Example**: -```bash -/sc:analyze src/ --focus security -# Expected: Comprehensive security audit, vulnerability report, improvement suggestions -``` -**Behavior**: Provides comprehensive security analysis and improvement recommendations - -#### Command: /sc:implement -**Purpose**: Implement a complete feature with best practices -**Syntax**: `/sc:implement "feature description with requirements"` -**Example**: -```bash -/sc:implement "user authentication with JWT and rate limiting" -# Expected: Complete auth implementation, security validation, tests included -``` -**Behavior**: Delivers complete implementation following security and quality standards - -#### Command: /sc:troubleshoot -**Purpose**: Troubleshoot and fix a problem systematically -**Syntax**: `/sc:troubleshoot "problem description"` -**Example**: -```bash -/sc:troubleshoot "API returns 500 error on user login" -# Expected: Step-by-step diagnosis, root cause identification, solution ranking -``` -**Verification**: Activates root-cause-analyst + Sequential reasoning + systematic debugging - -#### Command: /sc:test -**Purpose**: Generate comprehensive tests for existing code -**Syntax**: `/sc:test [target] --focus [domain]` -**Example**: -```bash -/sc:test --focus quality -# Expected: Test suite, quality metrics, coverage reporting -``` -**Verification**: Activates quality-engineer + test automation - -### Quick Analysis Commands - -#### Command: /sc:analyze (Quality Focus) -**Purpose**: Project structure and quality overview -**Syntax**: `/sc:analyze [target] --focus quality` -**Example**: -```bash -/sc:analyze . --focus quality -``` -**Verification**: - -#### Command: /sc:analyze (Security Focus) -**Purpose**: Security-focused code review -**Syntax**: `/sc:analyze [target] --focus security [--think]` -**Example**: -```bash -/sc:analyze src/ --focus security --think -``` -**Verification**: - -#### Command: /sc:analyze (Performance Focus) -**Purpose**: Performance bottleneck identification -**Syntax**: `/sc:analyze [target] --focus performance` -**Example**: -```bash -/sc:analyze api/ --focus performance -``` -**Verification**: - -#### Command: /sc:analyze (Architecture Focus) -**Purpose**: Architecture assessment for refactoring -**Syntax**: `/sc:analyze [target] --focus architecture [--serena]` -**Example**: -```bash -/sc:analyze . --focus architecture --serena -``` -**Verification**: - -## Manual Agent Invocation Examples - -### Direct Specialist Activation - -#### Pattern: @agent-[specialist] -**Purpose**: Manually invoke specific domain experts instead of auto-activation -**Syntax**: `@agent-[specialist] "task or question"` - -#### Python Expert -```bash -@agent-python-expert "optimize this data processing pipeline for performance" -# Expected: Python-specific optimizations, async patterns, memory management -``` - -#### Security Engineer -```bash -@agent-security "review this authentication system for vulnerabilities" -# Expected: OWASP compliance check, vulnerability assessment, secure coding recommendations -``` - -#### Frontend Architect -```bash -@agent-frontend-architect "design a responsive component architecture" -# Expected: Component patterns, state management, accessibility considerations -``` - -#### Quality Engineer -```bash -@agent-quality-engineer "create comprehensive test coverage for payment module" -# Expected: Test strategy, unit/integration/e2e tests, edge cases -``` - -### Combining Auto and Manual Patterns - -#### Pattern: Command + Manual Override -```bash -# Step 1: Use command with auto-activation -/sc:implement "user profile management system" -# Auto-activates: backend-architect, possibly frontend - -# Step 2: Add specific expert review -@agent-security "review the profile system for data privacy compliance" -# Manual activation for targeted review - -# Step 3: Performance optimization -@agent-performance-engineer "optimize database queries for profile fetching" -# Manual activation for specific optimization -``` - -#### Pattern: Sequential Specialist Chain -```bash -# Design phase -@agent-system-architect "design microservices architecture for e-commerce" - -# Security review -@agent-security "review architecture for security boundaries" - -# Implementation guidance -@agent-backend-architect "implement service communication patterns" - -# DevOps setup -@agent-devops-architect "configure CI/CD for microservices" -``` - -## Basic Usage Patterns - -### Discovery โ†’ Implementation Pattern -```bash -# Step 1: Explore and understand requirements -/sc:brainstorm "web dashboard for project management" -# Expected: Requirements discovery, feature prioritization, technical scope - -# Step 2: Analyze technical approach -/sc:analyze "dashboard architecture patterns" --focus architecture --c7 -# Expected: Architecture patterns, technology recommendations, implementation strategy - -# Step 3: Implement core functionality -/sc:implement "React dashboard with task management and team collaboration" -# Expected: Complete dashboard implementation with modern React patterns -``` - -### Development โ†’ Quality Pattern -```bash -# Step 1: Build the feature -/sc:implement "user registration with email verification" -# Expected: Registration system with email integration - -# Step 2: Test thoroughly -/sc:test --focus quality -# Expected: Comprehensive test coverage and validation - -# Step 3: Review and improve -/sc:analyze . --focus quality && /sc:implement "quality improvements" -# Expected: Quality assessment and targeted improvements -``` - -### Problem โ†’ Solution Pattern -```bash -# Step 1: Understand the problem -/sc:troubleshoot "slow database queries on user dashboard" -# Expected: Systematic problem diagnosis and root cause analysis - -# Step 2: Analyze affected components -/sc:analyze db/ --focus performance -# Expected: Database performance analysis and optimization opportunities - -# Step 3: Implement solutions -/sc:implement "database query optimization and caching" -# Expected: Performance improvements with measurable impact -``` - -## Getting Started Examples - -### Your First Project Analysis -```bash -# Complete project understanding workflow -/sc:load . && /sc:analyze --focus quality - -# Expected Results: -# - Project structure analysis and documentation -# - Code quality assessment across all files -# - Architecture overview with component relationships -# - Security audit and performance recommendations - -# Activates: Serena (project loading) + analyzer + security-engineer + performance-engineer -# Output: Comprehensive project report with actionable insights - - -# Variations for different focuses: -/sc:analyze src/ --focus quality # Code quality only -/sc:analyze . --scope file # Quick file analysis -/sc:analyze backend/ --focus security # Backend security review -``` - -### Interactive Requirements Discovery -```bash -# Transform vague ideas into concrete requirements -/sc:brainstorm "productivity app for remote teams" - -# Expected Interaction: -# - Socratic questioning about user needs and pain points -# - Feature prioritization and scope definition -# - Technical feasibility assessment -# - Structured requirements document generation - -# Activates: Brainstorming mode + system-architect + requirements-analyst -# Output: Product Requirements Document (PRD) with clear specifications - -# Follow-up commands for progression: -/sc:analyze "team collaboration architecture" --focus architecture --c7 -/sc:implement "real-time messaging system with React and WebSocket" -``` - -### Simple Feature Implementation -```bash -# Complete authentication system -/sc:implement "user login with JWT tokens and password hashing" - -# Expected Implementation: -# - Secure password hashing with bcrypt -# - JWT token generation and validation -# - Login/logout endpoints with proper error handling -# - Frontend login form with validation - -# Activates: security-engineer + backend-architect + Context7 -# Output: Production-ready authentication system - - -# Variations for different auth needs: -/sc:implement "OAuth integration with Google and GitHub" -/sc:implement "password reset flow with email verification" -/sc:implement "two-factor authentication with TOTP" -``` - -## Common Development Tasks - -### API Development Basics -```bash -# REST API with CRUD operations -/sc:implement "Express.js REST API for blog posts with validation" -# Expected: Complete REST API with proper HTTP methods, validation, error handling - - -# API documentation generation -/sc:analyze api/ --focus architecture --c7 -# Expected: Comprehensive API documentation with usage examples - - -# API testing setup -/sc:test --focus api --type integration -# Expected: Integration test suite for API endpoints - -``` - -### Frontend Component Development -```bash -# React component with modern patterns -/sc:implement "React user profile component with form validation and image upload" -# Activates: frontend-architect + Magic MCP + accessibility patterns -# Expected: Modern React component with hooks, validation, accessibility - - -# Component testing -/sc:test src/components/ --focus quality -# Expected: Component tests with React Testing Library - - -# Responsive design implementation -/sc:implement "responsive navigation component with mobile menu" -# Expected: Mobile-first responsive navigation with accessibility - -``` - -### Database Integration -```bash -# Database setup with ORM -/sc:implement "PostgreSQL integration with Prisma ORM and migrations" -# Expected: Database schema, ORM setup, migration system - - -# Database query optimization -/sc:analyze db/ --focus performance -# Expected: Query performance analysis and optimization suggestions - - -# Data validation and security -/sc:implement "input validation and SQL injection prevention" -# Expected: Comprehensive input validation and security measures - -``` - -## Basic Troubleshooting Examples - -### Common API Issues -```bash -# Performance problems -/sc:troubleshoot "API response time increased from 200ms to 2 seconds" -# Activates: root-cause-analyst + performance-engineer + Sequential reasoning -# Expected: Systematic diagnosis, root cause identification, solution ranking - -# Authentication errors -/sc:troubleshoot "JWT token validation failing for valid users" -# Expected: Token validation analysis, security assessment, fix implementation - -# Database connection issues -/sc:troubleshoot "database connection pool exhausted under load" -# Expected: Connection analysis, configuration fixes, scaling recommendations -``` - -### Frontend Debugging -```bash -# React rendering issues -/sc:troubleshoot "React components not updating when data changes" -# Expected: State management analysis, re-rendering optimization, debugging guide - -# Performance problems -/sc:troubleshoot "React app loading slowly with large component tree" -# Expected: Performance analysis, optimization strategies, code splitting recommendations - -# Build failures -/sc:troubleshoot "webpack build failing with dependency conflicts" -# Expected: Dependency analysis, conflict resolution, build optimization -``` - -### Development Environment Issues -```bash -# Setup problems -/sc:troubleshoot "Node.js application not starting after npm install" -# Expected: Environment analysis, dependency troubleshooting, configuration fixes - -# Testing failures -/sc:troubleshoot "tests passing locally but failing in CI" -# Expected: Environment comparison, CI configuration analysis, fix recommendations - -# Deployment issues -/sc:troubleshoot "application crashes on production deployment" -# Expected: Production environment analysis, configuration validation, deployment fixes -``` - -## Copy-Paste Quick Solutions - -### Immediate Project Setup -```bash -# New React project with TypeScript -/sc:implement "React TypeScript project with routing, state management, and testing setup" -@agent-frontend-architect "review and optimize the project structure" - -# New Node.js API server -/sc:implement "Express.js REST API with JWT authentication and PostgreSQL integration" -@agent-backend-architect "ensure scalability and best practices" - -# Python web API -/sc:implement "FastAPI application with async PostgreSQL and authentication middleware" -@agent-python-expert "optimize async patterns and dependency injection" - -# Next.js full-stack app -/sc:implement "Next.js 14 application with App Router, TypeScript, and Tailwind CSS" -@agent-system-architect "design optimal data fetching strategy" -``` - -### Quick Quality Improvements -```bash -# Code quality enhancement -/sc:analyze . --focus quality && /sc:implement "code quality improvements" -@agent-quality-engineer "create quality metrics dashboard" - -# Security hardening -/sc:analyze . --focus security && /sc:implement "security improvements" - -# Test coverage improvement -/sc:test --focus quality && /sc:implement "additional test coverage" -``` - -### Common Feature Implementations -```bash -# User authentication system -/sc:implement "complete user authentication with registration, login, and password reset" - -# File upload functionality -/sc:implement "secure file upload with image resizing and cloud storage" - -# Real-time features -/sc:implement "real-time chat with WebSocket and message persistence" - -# Payment processing -/sc:implement "Stripe payment integration with subscription management" - -# Email functionality -/sc:implement "email service with templates and delivery tracking" -``` - -## Basic Flag Examples - -### Analysis Depth Control -```bash -# Quick analysis -/sc:analyze src/ --scope file - -# Standard analysis -/sc:analyze . --think - -# Deep analysis -/sc:analyze . --think-hard --focus architecture - -``` - -### Focus Area Selection -```bash -# Security-focused analysis -/sc:analyze . --focus security - - -# Implementation with specific focus -/sc:implement "API optimization" --focus architecture - - -# Quality-focused testing -/sc:test --focus quality - -``` - -### Tool Integration -```bash -# Use Context7 for official patterns -/sc:implement "React hooks implementation" --c7 - - -# Use Serena for project memory -/sc:analyze . --serena --focus architecture - - -# Efficient token usage -/sc:analyze large-project/ --uc - -``` - -## Learning Progression Workflow - -### Week 1: Foundation -```bash -# Day 1-2: Basic commands -/sc:analyze . --focus quality -/sc:implement "simple feature" -/sc:test --focus quality - -# Day 3-4: Troubleshooting -/sc:troubleshoot "specific problem" -/sc:analyze problem-area/ --focus relevant-domain - -# Day 5-7: Integration -/sc:brainstorm "project idea" -/sc:implement "core feature" -/sc:test --focus quality -``` - -### Week 2: Patterns -```bash -# Workflow patterns -/sc:brainstorm โ†’ /sc:analyze โ†’ /sc:implement โ†’ /sc:test - -# Problem-solving patterns -/sc:troubleshoot โ†’ /sc:analyze โ†’ /sc:implement - -# Quality patterns -/sc:analyze โ†’ /sc:implement โ†’ /sc:test โ†’ /sc:analyze -``` - -### Week 3-4: Integration -```bash -# Multi-step projects -/sc:brainstorm "larger project" -/sc:implement "phase 1" -/sc:test --focus quality -/sc:implement "phase 2" -/sc:test --focus integration -``` - -## Next Steps - -### Ready for Intermediate? -- Comfortable with all basic commands -- Can complete simple workflows independently -- Understanding of agent activation and tool selection -- Ready for multi-step projects - -### Continue Learning: -- **Advanced Workflows**: Complex orchestration and multi-agent coordination -- **Integration Patterns**: Framework integration and cross-tool coordination -- **Best Practices Guide**: Optimization strategies and expert techniques - -### Success Indicators: -- Can solve common development problems independently -- Understands when to use different flags and focuses -- Can adapt examples to specific project needs -- Ready to explore more complex SuperClaude capabilities - ---- - -**Remember**: Start simple, practice frequently, and gradually increase complexity. These basic examples form the foundation for all advanced SuperClaude usage. \ No newline at end of file diff --git a/docs/Reference/claude-code-history-management.md b/docs/Reference/claude-code-history-management.md deleted file mode 100644 index de25e16..0000000 --- a/docs/Reference/claude-code-history-management.md +++ /dev/null @@ -1,556 +0,0 @@ -# Claude Code Conversation History Management Research - -**Research Date**: 2025-10-09 -**Purpose**: Understand .jsonl file structure, performance impact, and establish rotation policy - ---- - -## 1. Official Documentation & Purpose - -### .jsonl File Structure -**Location**: `~/.claude/projects/{project-directory}/` - -**Data Structure** (from analysis of actual files): -```json -{ - "type": "summary|file-history-snapshot|user|assistant|system|tool_use|tool_result|message", - "timestamp": "ISO-8601 timestamp", - "cwd": "/absolute/path/to/working/directory", - "sessionId": "uuid", - "gitBranch": "branch-name", - "content": "message content or command", - "messageId": "uuid for message tracking" -} -``` - -**Key Message Types** (from 2.6MB conversation analysis): -- `message` (228): Container for conversation messages -- `assistant` (228): Claude's responses -- `user` (182): User inputs -- `tool_use` (137): Tool invocations -- `tool_result` (137): Tool execution results -- `text` (74): Text content blocks -- `file-history-snapshot` (39): File state tracking -- `thinking` (31): Claude's reasoning process -- `system` (12): System-level messages - -### File History Snapshot Purpose -```json -{ - "type": "file-history-snapshot", - "messageId": "uuid", - "snapshot": { - "messageId": "uuid", - "trackedFileBackups": {}, - "timestamp": "ISO-8601" - }, - "isSnapshotUpdate": false -} -``` - -**Purpose** (inferred from structure): -- Tracks file states at specific conversation points -- Enables undo/redo functionality for file changes -- Provides rollback capability for edits -- **Note**: No official documentation found on this feature - -### Conversation Loading Behavior -**Official Best Practices** ([source](https://www.anthropic.com/engineering/claude-code-best-practices)): -- "All conversations are automatically saved locally with their full message history" -- "When resuming, the entire message history is restored to maintain context" -- "Tool usage and results from previous conversations preserved" - -**Resume Commands**: -- `--continue`: Automatically continue most recent conversation -- `/resume`: Show list of recent sessions and choose one -- Session ID specification: Resume specific conversation - ---- - -## 2. Performance Impact - -### Known Issues from GitHub - -#### Issue #5024: History Accumulation Causing Performance Issues -**Status**: Open (Major Issue) -**URL**: https://github.com/anthropics/claude-code/issues/5024 - -**Reported Problems**: -- File sizes growing to "hundreds of MB or more" -- Slower application startup times -- System performance degradation -- No automatic cleanup mechanism -- One user reported file size of 968KB+ continuously growing - -**Current Workaround**: -- Manual editing of `.claude.json` (risky - can break configurations) -- `claude history clear` (removes ALL history across ALL projects) - -#### Issue #7985: Severe Memory Leak -**Status**: Critical -**URL**: https://github.com/anthropics/claude-code/issues/7985 - -**Reported Problems**: -- Context accumulation causing massive memory usage -- Memory leaks with objects not garbage collected -- One user reported ~570GB of virtual memory usage -- Long-running sessions become unusable - -#### Issue #8839: Conversation Compaction Failure -**Status**: Regression (after undo/redo feature) -**URL**: https://github.com/anthropics/claude-code/issues/8839 - -**Impact**: -- Claude Code can no longer automatically compact long conversations -- "Too long" errors after conversation history navigation feature added -- Conversations become unmanageable without manual intervention - -#### Issue #8755: /clear Command Not Working -**Status**: Bug -**URL**: https://github.com/anthropics/claude-code/issues/8755 - -**Impact**: -- `/clear` command stopped functioning for some users -- "Clear Conversations" menu option non-functional -- Users cannot reset context window as recommended - -### Actual Performance Data (Your Environment) - -**Current State** (as of 2025-10-09): -- **Total agiletec project**: 33MB (57 conversation files) -- **Largest file**: 2.6MB (462 lines) -- **Average file**: ~580KB -- **Files >1MB**: 3 files -- **Total across all projects**: ~62MB - -**Age Distribution**: -- Files older than 30 days: 0 -- Files older than 7 days: 4 -- Most files: <7 days old - -**Comparison to Other Projects**: -``` -33M agiletec (57 files) - Most active -14M SSD-2TB project -6.3M tokium -2.6M bunseki -``` - ---- - -## 3. Official Retention Policies - -### Standard Retention (Consumer) -**Source**: [Anthropic Privacy Center](https://privacy.claude.com/en/articles/10023548-how-long-do-you-store-my-data) - -- **Prompts/Responses**: Up to 30 days in back-end logs -- **Deleted chats**: Immediately removed from UI, purged within 30 days -- **API logs**: Reducing to 7 days starting September 15, 2025 (from 30 days) - -### Enterprise Controls -**Source**: [Custom Data Retention Controls](https://privacy.anthropic.com/en/articles/10440198-custom-data-retention-controls-for-claude-enterprise) - -- **Minimum retention**: 30 days -- **Retention start**: Last observed activity (last message or project update) -- **Custom periods**: Available for organizations - -### Local Storage (No Official Policy) -**Finding**: No official documentation found regarding: -- Recommended local .jsonl file retention periods -- Automatic cleanup of old conversations -- Performance thresholds for file sizes -- Safe deletion procedures - -**Current Tools**: -- `claude history clear`: Removes ALL history (all projects, destructive) -- No selective cleanup tools available -- No archive functionality - ---- - -## 4. Best Practices (Official & Community) - -### Official Recommendations - -#### Context Management -**Source**: [Claude Code Best Practices](https://www.anthropic.com/engineering/claude-code-best-practices) - -**Key Guidelines**: -1. **Use `/clear` frequently**: "Reset context window between tasks" -2. **Scope conversations**: "One project or feature per conversation" -3. **Clear before switching**: "/clear before fixing bugs to prevent context pollution" -4. **Don't rely on long context**: "Claude's context window can fill with irrelevant conversation" - -**Quote**: "During long sessions, Claude's context window can fill with irrelevant conversation, file contents, and commands which can reduce performance, so use the /clear command frequently between tasks to reset the context window." - -#### CLAUDE.md Strategy -- **Persistent context**: Use CLAUDE.md files for stable instructions -- **Auto-loaded**: "Claude automatically pulls into context when starting" -- **Hierarchy**: Global (`~/.claude/CLAUDE.md`) โ†’ Workspace โ†’ Project -- **Refinement**: "Take time to experiment and determine what produces best results" - -#### When to Restart vs /clear -**Source**: [Community Best Practices](https://claudelog.com/faqs/does-claude-code-store-my-data/) - -**Use `/clear` when**: -- Starting new task/feature -- Switching between features -- Context becomes polluted -- Before bug fixing - -**Restart session when**: -- Switching projects -- Updating CLAUDE.md files -- Experiencing session issues -- Memory usage high - -### Community Strategies - -#### Conversation Organization -**Pattern**: "Scope a chat to one project or feature" -- Start conversation for specific goal -- Use `/clear` when goal complete -- Don't mix unrelated tasks in same conversation - -#### Context Optimization -**Pattern**: "Avoid extensive, unrefined context" -- Iterate on CLAUDE.md effectiveness -- Remove ineffective instructions -- Test and refine periodically - -#### Incognito Mode for Sensitive Work -**Pattern**: "Ghost icon for temporary conversations" -- Not saved to chat history -- No contribution to context memory -- Useful for experimental or sensitive work - ---- - -## 5. Recommended Rotation Policy - -### Immediate Actions (No Risk) - -#### 1. Delete Very Old Conversations (>30 days) -```bash -# Backup first -mkdir -p ~/.claude/projects-archive/$(date +%Y-%m) - -# Find and archive -find ~/.claude/projects/ -name "*.jsonl" -mtime +30 -type f \ - -exec mv {} ~/.claude/projects-archive/$(date +%Y-%m)/ \; -``` - -**Rationale**: -- Aligns with Anthropic's 30-day back-end retention -- Minimal functionality loss (context rarely useful after 30 days) -- Significant space savings - -#### 2. Archive Project-Specific Old Conversations (>14 days) -```bash -# Per-project archive -mkdir -p ~/.claude/projects-archive/agiletec/$(date +%Y-%m) - -find ~/.claude/projects/-Users-kazuki-github-agiletec -name "*.jsonl" -mtime +14 -type f \ - -exec mv {} ~/.claude/projects-archive/agiletec/$(date +%Y-%m)/ \; -``` - -**Rationale**: -- 14 days provides buffer for resumed work -- Most development tasks complete within 2 weeks -- Easy to restore if needed - -### Periodic Maintenance (Weekly) - -#### 3. Identify Large Files for Manual Review -```bash -# Find files >1MB -find ~/.claude/projects/ -name "*.jsonl" -type f -size +1M -exec ls -lh {} \; - -# Review and archive if not actively used -``` - -**Criteria for Archival**: -- File >1MB and not modified in 7 days -- Completed feature/project conversations -- Debugging sessions that are resolved - -### Aggressive Cleanup (Monthly) - -#### 4. Archive All Inactive Conversations (>7 days) -```bash -# Monthly archive -mkdir -p ~/.claude/projects-archive/$(date +%Y-%m) - -find ~/.claude/projects/ -name "*.jsonl" -mtime +7 -type f \ - -exec mv {} ~/.claude/projects-archive/$(date +%Y-%m)/ \; -``` - -**When to Use**: -- Project directory >50MB -- Startup performance degraded -- Running low on disk space - -### Emergency Cleanup (Performance Issues) - -#### 5. Nuclear Option - Keep Only Recent Week -```bash -# BACKUP EVERYTHING FIRST -tar -czf ~/claude-history-backup-$(date +%Y%m%d).tar.gz ~/.claude/projects/ - -# Keep only last 7 days -find ~/.claude/projects/ -name "*.jsonl" -mtime +7 -type f -delete -``` - -**When to Use**: -- Claude Code startup >10 seconds -- Memory usage abnormally high -- Experiencing Issue #7985 symptoms - ---- - -## 6. Proposed Automated Solution - -### Shell Script: `claude-history-rotate.sh` -```bash -#!/usr/bin/env bash -# Claude Code Conversation History Rotation -# Usage: ./claude-history-rotate.sh [--dry-run] [--days N] - -set -euo pipefail - -DAYS=${DAYS:-30} -DRY_RUN=false -ARCHIVE_BASE=~/.claude/projects-archive - -# Parse arguments -while [[ $# -gt 0 ]]; do - case $1 in - --dry-run) DRY_RUN=true; shift ;; - --days) DAYS="$2"; shift 2 ;; - *) echo "Unknown option: $1"; exit 1 ;; - esac -done - -# Create archive directory -ARCHIVE_DIR="$ARCHIVE_BASE/$(date +%Y-%m)" -mkdir -p "$ARCHIVE_DIR" - -# Find old conversations -OLD_FILES=$(find ~/.claude/projects/ -name "*.jsonl" -mtime "+$DAYS" -type f) - -if [[ -z "$OLD_FILES" ]]; then - echo "No files older than $DAYS days found." - exit 0 -fi - -# Count and size -FILE_COUNT=$(echo "$OLD_FILES" | wc -l | tr -d ' ') -TOTAL_SIZE=$(echo "$OLD_FILES" | xargs du -ch | tail -1 | awk '{print $1}') - -echo "Found $FILE_COUNT files older than $DAYS days ($TOTAL_SIZE total)" - -if [[ "$DRY_RUN" == "true" ]]; then - echo "DRY RUN - Would archive:" - echo "$OLD_FILES" - exit 0 -fi - -# Archive files -echo "$OLD_FILES" | while read -r file; do - mv "$file" "$ARCHIVE_DIR/" - echo "Archived: $(basename "$file")" -done - -echo "โœ“ Archived $FILE_COUNT files to $ARCHIVE_DIR" -``` - -### Cron Job Setup (Optional) -```bash -# Add to crontab (monthly cleanup) -# 0 3 1 * * /Users/kazuki/.local/bin/claude-history-rotate.sh --days 30 - -# Or use launchd on macOS -cat > ~/Library/LaunchAgents/com.user.claude-history-rotate.plist <<'EOF' - - - - - Label - com.user.claude-history-rotate - ProgramArguments - - /Users/kazuki/.local/bin/claude-history-rotate.sh - --days - 30 - - StartCalendarInterval - - Day - 1 - Hour - 3 - - - -EOF - -launchctl load ~/Library/LaunchAgents/com.user.claude-history-rotate.plist -``` - ---- - -## 7. Monitoring & Alerts - -### Disk Usage Check Script -```bash -#!/usr/bin/env bash -# claude-history-check.sh - -THRESHOLD_MB=100 -PROJECTS_DIR=~/.claude/projects - -TOTAL_SIZE_MB=$(du -sm "$PROJECTS_DIR" | awk '{print $1}') - -echo "Claude Code conversation history: ${TOTAL_SIZE_MB}MB" - -if [[ $TOTAL_SIZE_MB -gt $THRESHOLD_MB ]]; then - echo "โš ๏ธ WARNING: History size exceeds ${THRESHOLD_MB}MB threshold" - echo "Consider running: claude-history-rotate.sh --days 30" - - # Find largest projects - echo "" - echo "Largest projects:" - du -sm "$PROJECTS_DIR"/*/ | sort -rn | head -5 -fi -``` - -### Performance Indicators to Watch -1. **Startup time**: >5 seconds = investigate -2. **File sizes**: >2MB per conversation = review -3. **Total size**: >100MB across all projects = cleanup -4. **Memory usage**: >2GB during session = Issue #7985 -5. **Conversation length**: >500 message pairs = use `/clear` - ---- - -## 8. Key Takeaways & Recommendations - -### Critical Findings - -โœ… **Safe to Delete**: -- Conversations >30 days old (aligns with Anthropic retention) -- Completed feature/project conversations -- Large files (>1MB) not accessed in 14+ days - -โš ๏ธ **Caution Required**: -- Active project conversations (<7 days) -- Files referenced in recent work -- Conversations with unfinished tasks - -โŒ **Known Issues**: -- No official cleanup tools (Issue #5024) -- Memory leaks in long sessions (Issue #7985) -- `/clear` command bugs (Issue #8755) -- Conversation compaction broken (Issue #8839) - -### Recommended Policy for Your Environment - -**Daily Practice**: -- Use `/clear` between major tasks -- Scope conversations to single features -- Restart session if >2 hours continuous work - -**Weekly Review** (Sunday): -```bash -# Check current state -du -sh ~/.claude/projects/*/ - -# Archive old conversations (>14 days) -claude-history-rotate.sh --days 14 --dry-run # Preview -claude-history-rotate.sh --days 14 # Execute -``` - -**Monthly Cleanup** (1st of month): -```bash -# Aggressive cleanup (>30 days) -claude-history-rotate.sh --days 30 - -# Review large files -find ~/.claude/projects/ -name "*.jsonl" -size +1M -mtime +7 -``` - -**Performance Threshold Actions**: -- Total size >50MB: Archive 30-day-old conversations -- Total size >100MB: Archive 14-day-old conversations -- Total size >200MB: Emergency cleanup (7-day retention) -- Startup >10s: Investigate memory leaks, consider Issue #7985 - -### Future-Proofing - -**Watch for Official Solutions**: -- `claude history prune` command (requested in #5024) -- Automatic history rotation feature -- Configurable retention settings -- Separate configuration from history storage - -**Community Tools**: -- [cclogviewer](https://github.com/hesreallyhim/awesome-claude-code): View .jsonl files -- Consider contributing to #5024 discussion -- Monitor anthropics/claude-code releases - ---- - -## 9. References - -### Official Documentation -- [Claude Code Best Practices](https://www.anthropic.com/engineering/claude-code-best-practices) -- [How Long Do You Store My Data?](https://privacy.claude.com/en/articles/10023548-how-long-do-you-store-my-data) -- [Custom Data Retention Controls](https://privacy.anthropic.com/en/articles/10440198-custom-data-retention-controls-for-claude-enterprise) - -### GitHub Issues -- [#5024: History accumulation causes performance issues](https://github.com/anthropics/claude-code/issues/5024) -- [#7985: Severe memory leak](https://github.com/anthropics/claude-code/issues/7985) -- [#8839: Conversation compaction failure](https://github.com/anthropics/claude-code/issues/8839) -- [#8755: /clear command not working](https://github.com/anthropics/claude-code/issues/8755) - -### Community Resources -- [Awesome Claude Code](https://github.com/hesreallyhim/awesome-claude-code) -- [Claude Code Context Guide](https://www.arsturn.com/blog/beyond-prompting-a-guide-to-managing-context-in-claude-code) -- [ClaudeLog Documentation](https://claudelog.com/) - ---- - -## Appendix: Current Environment Statistics - -**Generated**: 2025-10-09 04:24 JST - -### Project Size Breakdown -``` -33M -Users-kazuki-github-agiletec (57 files) -14M -Volumes-SSD-2TB (project count: N/A) -6.3M -Users-kazuki-github-tokium -2.6M -Users-kazuki-github-bunseki -1.9M -Users-kazuki -1.9M -Users-kazuki-github-superclaude ---- -Total: ~62MB across all projects -``` - -### agiletec Project Details -- **Total conversations**: 57 -- **Largest file**: 2.6MB (d4852655-b760-4311-8f67-26f593f2403f.jsonl) -- **Files >1MB**: 3 files -- **Avg file size**: ~580KB -- **Files >7 days**: 4 files -- **Files >30 days**: 0 files - -### Immediate Recommendation -**Status**: โœ… Healthy (no immediate action required) - -**Reasoning**: -- Total size (33MB) well below concern threshold (100MB) -- No files >30 days old -- Only 4 files >7 days old -- Largest file (2.6MB) within acceptable range - -**Next Review**: 2025-10-16 (weekly check) diff --git a/docs/Reference/common-issues.md b/docs/Reference/common-issues.md deleted file mode 100644 index a26cb2d..0000000 --- a/docs/Reference/common-issues.md +++ /dev/null @@ -1,79 +0,0 @@ -# SuperClaude Common Issues - Quick Reference ๐Ÿš€ - -**Problem Solving Guide**: Most frequent issues with practical solutions. - -## Top 5 Quick Fixes (90% of Issues) - -### 1. Commands Not Working in Claude Code โšก -``` -Problem: /sc:brainstorm doesn't work -Solution: Restart Claude Code completely -Test: /sc:brainstorm "test" should ask questions -``` - -### 2. Installation Verification -```bash -python3 -m SuperClaude --version # Should show 4.1.5 - -# If not working: -# For pipx users -pipx upgrade SuperClaude - -# For pip users -pip install --upgrade SuperClaude - -# Then reinstall -python3 -m SuperClaude install -``` - -### 3. Permission Issues -```bash -# Permission denied / PEP 668 errors: -# Option 1: Use pipx (recommended) -pipx install SuperClaude - -# Option 2: Use pip with --user -pip install --user SuperClaude - -# Option 3: Fix permissions -sudo chown -R $USER ~/.claude -``` - -### 4. MCP Server Issues -```bash -/sc:analyze . --no-mcp # Test without MCP servers -node --version # Check Node.js 16+ if needed -``` - -### 5. Component Missing -```bash -python3 -m SuperClaude install --components core commands agents modes --force -``` - -## Platform-Specific Issues - -**Windows:** -```cmd -set CLAUDE_CONFIG_DIR=%USERPROFILE%\.claude -python -m SuperClaude install --install-dir "%CLAUDE_CONFIG_DIR%" -``` - -**macOS:** -```bash -brew install python3 node -pip3 install SuperClaude -``` - -**Linux:** -```bash -sudo apt install python3 python3-pip nodejs -pip3 install SuperClaude -``` - -## Verification Checklist -- [ ] `python3 -m SuperClaude --version` returns 4.1.5 -- [ ] `/sc:brainstorm "test"` works in Claude Code -- [ ] `SuperClaude install --list-components` shows components - -## When Quick Fixes Don't Work -See [Troubleshooting Guide](troubleshooting.md) for advanced diagnostics. \ No newline at end of file diff --git a/docs/Reference/diagnostic-reference.md b/docs/Reference/diagnostic-reference.md deleted file mode 100644 index 943143b..0000000 --- a/docs/Reference/diagnostic-reference.md +++ /dev/null @@ -1,338 +0,0 @@ -# SuperClaude Diagnostic Reference Guide - -## Overview - -This guide provides procedures for diagnosing issues with SuperClaude context files and configurations. Since SuperClaude is a collection of text files (not running software), diagnostics focus on file verification and configuration checking. - -**Important**: There are no processes to monitor, no performance metrics to measure, and no system resources to analyze. SuperClaude is purely configuration files that Claude Code reads. - -## Quick Diagnostics - -### One-Line Health Check - -```bash -# Quick status check -ls ~/.claude/CLAUDE.md && echo "โœ… SuperClaude installed" || echo "โŒ Not installed" -``` - -### Basic Diagnostic Commands - -```bash -# Check if SuperClaude is installed -python3 -m SuperClaude --version - -# Count context files -find ~/.claude -name "*.md" -type f | wc -l -# Expected: 40+ files - -# Check file sizes (context files should have content) -find ~/.claude -name "*.md" -type f -size 0 -# Expected: No output (no empty files) - -# Verify directory structure -tree -L 2 ~/.claude/ -# Or without tree command: -ls -la ~/.claude/ -``` - -## File System Diagnostics - -### Context File Verification - -```bash -#!/bin/bash -# Comprehensive context file check - -echo "=== SuperClaude Context File Diagnostic ===" - -# Define expected counts -EXPECTED_AGENTS=14 -EXPECTED_COMMANDS=21 -EXPECTED_MODES=6 - -# Count actual files -ACTUAL_AGENTS=$(ls ~/.claude/agents/*.md 2>/dev/null | wc -l) -ACTUAL_COMMANDS=$(ls ~/.claude/commands/*.md 2>/dev/null | wc -l) -ACTUAL_MODES=$(ls ~/.claude/modes/*.md 2>/dev/null | wc -l) - -# Report findings -echo "Agents: $ACTUAL_AGENTS/$EXPECTED_AGENTS $([ $ACTUAL_AGENTS -ge $EXPECTED_AGENTS ] && echo โœ… || echo โš ๏ธ)" -echo "Commands: $ACTUAL_COMMANDS/$EXPECTED_COMMANDS $([ $ACTUAL_COMMANDS -ge $EXPECTED_COMMANDS ] && echo โœ… || echo โš ๏ธ)" -echo "Modes: $ACTUAL_MODES/$EXPECTED_MODES $([ $ACTUAL_MODES -ge $EXPECTED_MODES ] && echo โœ… || echo โš ๏ธ)" - -# Check core files -for file in CLAUDE.md FLAGS.md RULES.md PRINCIPLES.md; do - if [ -f ~/.claude/$file ]; then - SIZE=$(wc -c < ~/.claude/$file) - echo "$file: $SIZE bytes โœ…" - else - echo "$file: MISSING โŒ" - fi -done -``` - -### Import System Check - -```bash -# Verify import statements in CLAUDE.md -echo "=== Import System Check ===" -if [ -f ~/.claude/CLAUDE.md ]; then - echo "Imports found in CLAUDE.md:" - grep "^@import" ~/.claude/CLAUDE.md - - # Count import statements - IMPORT_COUNT=$(grep -c "^@import" ~/.claude/CLAUDE.md) - echo "Total imports: $IMPORT_COUNT" - - if [ $IMPORT_COUNT -ge 5 ]; then - echo "โœ… Import system configured correctly" - else - echo "โš ๏ธ Some imports may be missing" - fi -else - echo "โŒ CLAUDE.md not found" -fi -``` - -## Configuration Diagnostics - -### MCP Server Configuration Check - -```bash -# Check MCP configuration -echo "=== MCP Configuration Diagnostic ===" - -CONFIG_FILE=~/.claude.json - -if [ -f "$CONFIG_FILE" ]; then - echo "โœ… Configuration file exists" - - # Validate JSON syntax - if python3 -c "import json; json.load(open('$CONFIG_FILE'))" 2>/dev/null; then - echo "โœ… Valid JSON syntax" - - # List configured servers - echo "Configured MCP servers:" - python3 -c " -import json -with open('$HOME/.claude.json') as f: - config = json.load(f) - if 'mcpServers' in config: - for server in config['mcpServers']: - print(f' - {server}') - else: - print(' No servers configured') - " - else - echo "โŒ Invalid JSON syntax in $CONFIG_FILE" - fi -else - echo "โš ๏ธ No MCP configuration file found" - echo " This is OK if you don't use MCP servers" -fi -``` - -### Permission Diagnostics - -```bash -# Check file permissions -echo "=== File Permission Check ===" - -# Check if files are readable -UNREADABLE_COUNT=0 -for file in ~/.claude/**/*.md; do - if [ ! -r "$file" ]; then - echo "โŒ Cannot read: $file" - ((UNREADABLE_COUNT++)) - fi -done - -if [ $UNREADABLE_COUNT -eq 0 ]; then - echo "โœ… All context files are readable" -else - echo "โš ๏ธ Found $UNREADABLE_COUNT unreadable files" - echo "Fix with: chmod 644 ~/.claude/**/*.md" -fi - -# Check directory permissions -for dir in ~/.claude ~/.claude/agents ~/.claude/commands ~/.claude/modes; do - if [ -d "$dir" ]; then - if [ -x "$dir" ]; then - echo "โœ… $dir is accessible" - else - echo "โŒ $dir is not accessible" - fi - else - echo "โŒ $dir does not exist" - fi -done -``` - -## Common Issue Diagnostics - -### Issue: Commands Not Recognized - -```bash -# Diagnose command issues -COMMAND="implement" # Change to test different commands - -echo "=== Diagnosing command: $COMMAND ===" - -FILE=~/.claude/commands/$COMMAND.md - -if [ -f "$FILE" ]; then - echo "โœ… Command file exists" - - # Check file size - SIZE=$(wc -c < "$FILE") - if [ $SIZE -gt 100 ]; then - echo "โœ… File has content ($SIZE bytes)" - else - echo "โš ๏ธ File seems too small ($SIZE bytes)" - fi - - # Check for metadata - if head -10 "$FILE" | grep -q "^---"; then - echo "โœ… Has metadata header" - else - echo "โš ๏ธ Missing metadata header" - fi - - # Check for command pattern - if grep -q "/sc:$COMMAND" "$FILE"; then - echo "โœ… Contains command pattern" - else - echo "โš ๏ธ Missing command pattern" - fi -else - echo "โŒ Command file not found: $FILE" - echo "Available commands:" - ls ~/.claude/commands/ | sed 's/.md$//' -fi -``` - -### Issue: Agent Not Activating - -```bash -# Diagnose agent issues -AGENT="python-expert" # Change to test different agents - -echo "=== Diagnosing agent: $AGENT ===" - -FILE=~/.claude/agents/$AGENT.md - -if [ -f "$FILE" ]; then - echo "โœ… Agent file exists" - - # Check for trigger keywords - echo "Trigger keywords found:" - grep -A 5 "## Triggers" "$FILE" | tail -n +2 - - # Check for metadata - if head -10 "$FILE" | grep -q "^name:"; then - echo "โœ… Has metadata" - else - echo "โš ๏ธ Missing metadata" - fi -else - echo "โŒ Agent file not found: $FILE" - echo "Available agents:" - ls ~/.claude/agents/ | sed 's/.md$//' -fi -``` - -## Installation Repair - -### Quick Fix Script - -```bash -#!/bin/bash -# SuperClaude Quick Fix Script - -echo "=== SuperClaude Quick Fix ===" - -# Check for common issues and fix them -ISSUES_FOUND=0 - -# Fix permissions -echo "Fixing file permissions..." -chmod 644 ~/.claude/*.md 2>/dev/null -chmod 644 ~/.claude/**/*.md 2>/dev/null -chmod 755 ~/.claude ~/.claude/agents ~/.claude/commands ~/.claude/modes 2>/dev/null - -# Check for missing directories -for dir in agents commands modes; do - if [ ! -d ~/.claude/$dir ]; then - echo "โš ๏ธ Missing directory: $dir" - echo " Run: SuperClaude install --components $dir" - ((ISSUES_FOUND++)) - fi -done - -# Check for empty files -EMPTY_FILES=$(find ~/.claude -name "*.md" -type f -size 0 2>/dev/null) -if [ -n "$EMPTY_FILES" ]; then - echo "โš ๏ธ Found empty files:" - echo "$EMPTY_FILES" - echo " Run: SuperClaude install --force" - ((ISSUES_FOUND++)) -fi - -if [ $ISSUES_FOUND -eq 0 ]; then - echo "โœ… No issues found" -else - echo "Found $ISSUES_FOUND issues - see recommendations above" -fi -``` - -### Complete Reinstallation - -```bash -# Complete clean reinstall -echo "=== Clean Reinstall ===" - -# Backup current installation -BACKUP_DIR=~/.claude.backup.$(date +%Y%m%d_%H%M%S) -if [ -d ~/.claude ]; then - cp -r ~/.claude "$BACKUP_DIR" - echo "โœ… Backed up to $BACKUP_DIR" -fi - -# Remove current installation -rm -rf ~/.claude - -# Reinstall -SuperClaude install - -# Verify installation -if [ -f ~/.claude/CLAUDE.md ]; then - echo "โœ… Reinstallation successful" -else - echo "โŒ Reinstallation failed" - echo "Restoring backup..." - cp -r "$BACKUP_DIR" ~/.claude -fi -``` - -## What These Diagnostics DON'T Do - -### Not Applicable Concepts - -- **CPU/Memory Monitoring**: No processes to monitor -- **Performance Metrics**: No code execution to measure -- **Network Analysis**: No network operations (except MCP) -- **Process Management**: No running processes -- **Resource Optimization**: No resources consumed -- **Execution Timing**: No code executes - -### Focus on What Matters - -- **File Presence**: Are context files installed? -- **File Integrity**: Are files readable and complete? -- **Configuration Validity**: Is JSON syntax correct? -- **Directory Structure**: Is organization correct? -- **Permissions**: Can Claude Code read the files? - -## Summary - -SuperClaude diagnostics are simple: verify files exist, check they're readable, and ensure configurations are valid. Since it's just text files that Claude Code reads, there's no complex system monitoring or performance analysis needed. If files are present and readable, SuperClaude is working. \ No newline at end of file diff --git a/docs/Reference/examples-cookbook.md b/docs/Reference/examples-cookbook.md deleted file mode 100644 index 42a9d82..0000000 --- a/docs/Reference/examples-cookbook.md +++ /dev/null @@ -1,172 +0,0 @@ -# SuperClaude Examples Cookbook - -**Status**: โœ… **Status: Current** - Comprehensive collection of practical SuperClaude usage examples organized by complexity and domain. - -**Focused Recipe Collections**: The SuperClaude Examples Cookbook has been restructured into three focused collections for better usability and progressive learning. - -## Recipe Collections Overview - -### [Basic Examples Collection](./basic-examples.md) -**Essential commands and single-agent workflows** -- Copy-paste ready commands for immediate use -- Essential SuperClaude patterns and fundamentals -- Common development tasks and troubleshooting -- Perfect starting point for new users - -**Best for**: New users, quick task execution, learning fundamentals - -### [Advanced Workflows Collection](./advanced-workflows.md) -**Multi-agent coordination and complex orchestration** -- Multi-agent collaboration patterns -- Enterprise-scale project workflows -- Session management and persistence -- Complex system development patterns - -**Best for**: Experienced users, enterprise projects, complex coordination - -### [Integration Patterns Collection](./integration-patterns.md) -**Framework integration and cross-tool coordination** -- Framework-specific integration patterns -- Performance optimization recipes -- Cross-tool coordination strategies -- Monitoring and observability patterns - -**Best for**: Expert users, system architects, performance optimization - -## Quick Navigation Guide - -### By Experience Level -**Beginner** -โ†’ Start with [Basic Examples](./basic-examples.md) -- Essential commands and patterns -- Simple troubleshooting workflows -- Copy-paste solutions for common tasks - -**Intermediate** -โ†’ Progress to [Advanced Workflows](./advanced-workflows.md) -- Multi-agent coordination -- Complex project orchestration -- Session management patterns - -**Expert** -โ†’ Master [Integration Patterns](./integration-patterns.md) -- Framework integration strategies -- Performance optimization recipes -- Enterprise-scale architecture patterns - -### By Use Case -**Web Development** -- Frontend: [Basic Examples](./basic-examples.md#frontend-component-development) โ†’ [Integration Patterns](./integration-patterns.md#react-ecosystem-integration) -- Backend: [Basic Examples](./basic-examples.md#api-development-basics) โ†’ [Integration Patterns](./integration-patterns.md#nodejs-backend-integration) -- Full-Stack: [Advanced Workflows](./advanced-workflows.md#complete-e-commerce-platform-development) - -**Mobile Development** -- React Native: [Basic Examples](./basic-examples.md#copy-paste-quick-solutions) โ†’ [Integration Patterns](./integration-patterns.md#mobile-and-web-integration) -- Cross-Platform: [Integration Patterns](./integration-patterns.md#cross-platform-integration-patterns) - -**DevOps & Infrastructure** -- CI/CD: [Basic Examples](./basic-examples.md#copy-paste-quick-solutions) โ†’ [Integration Patterns](./integration-patterns.md#devops-and-infrastructure-integration) -- Monitoring: [Advanced Workflows](./advanced-workflows.md#advanced-monitoring-and-observability) โ†’ [Integration Patterns](./integration-patterns.md#monitoring-and-observability-patterns) - -**Performance & Security** -- Security: [Basic Examples](./basic-examples.md#basic-troubleshooting-examples) โ†’ [Advanced Workflows](./advanced-workflows.md#enterprise-scale-security-implementation) -- Performance: [Integration Patterns](./integration-patterns.md#performance-optimization-recipes) - -## Verified Commands Reference - -**Core Commands**: -- `/sc:brainstorm` - Interactive requirements discovery -- `/sc:analyze` - Codebase analysis and assessment -- `/sc:implement` - Feature implementation with best practices -- `/sc:troubleshoot` - Systematic problem diagnosis -- `/sc:test` - Comprehensive testing and validation -- `/sc:spawn` - Complex multi-agent coordination -- `/sc:load` / `/sc:save` - Session management -- `/sc:reflect` - Context analysis and optimization - -**Verified Flags**: -- `--think`, `--think-hard`, `--ultrathink` - Analysis depth control -- `--uc` - Ultra-compressed token-efficient mode -- `--orchestrate` - Intelligent coordination mode -- `--c7`, `--serena`, `--all-mcp` - MCP server integration -- `--focus [domain]` - Domain-specific optimization -- `--scope [level]` - Analysis scope control - -## Learning Progression Roadmap - -### Phase 1: Foundation (Week 1-2) -1. **Setup**: Complete [Installation Guide](../Getting-Started/installation.md) -2. **Basics**: Practice [Basic Examples](./basic-examples.md#essential-one-liner-commands) -3. **Patterns**: Learn [Basic Usage Patterns](./basic-examples.md#basic-usage-patterns) -4. **Success**: Can execute common development tasks independently - -### Phase 2: Coordination (Week 3-6) -1. **Agents**: Understand [Multi-Agent Patterns](./advanced-workflows.md#multi-agent-collaboration-patterns) -2. **Workflows**: Practice [Complex Project Workflows](./advanced-workflows.md#complex-project-workflows) -3. **Orchestration**: Master [Advanced Orchestration](./advanced-workflows.md#advanced-orchestration-patterns) -4. **Success**: Can coordinate complex multi-step projects - -### Phase 3: Integration (Month 2+) -1. **Frameworks**: Learn [Framework Integration](./integration-patterns.md#framework-integration-patterns) -2. **Performance**: Master [Optimization Recipes](./integration-patterns.md#performance-optimization-recipes) -3. **Troubleshooting**: Advanced [Debugging Workflows](./integration-patterns.md#advanced-troubleshooting-workflows) -4. **Success**: Can integrate SuperClaude with any development stack - -### Phase 4: Expertise (Month 3+) -1. **Architecture**: Design custom integration patterns -2. **Contribution**: Contribute to SuperClaude framework -3. **Leadership**: Mentor community and solve complex problems -4. **Success**: Framework development and community leadership - -## Quick Reference Matrix - -| Task Type | Beginner | Intermediate | Expert | -|-----------|----------|--------------|--------| -| **Analysis** | [Basic Analysis](./basic-examples.md#quick-analysis-commands) | [Multi-Agent Analysis](./advanced-workflows.md#performance-optimization-team) | [Integration Analysis](./integration-patterns.md#distributed-system-debugging) | -| **Implementation** | [Simple Features](./basic-examples.md#simple-feature-implementation) | [Complex Projects](./advanced-workflows.md#complex-project-workflows) | [Framework Integration](./integration-patterns.md#framework-integration-patterns) | -| **Testing** | [Basic Testing](./basic-examples.md#copy-paste-quick-solutions) | [Comprehensive Testing](./advanced-workflows.md#advanced-workflows) | [Testing Integration](./integration-patterns.md#advanced-testing-integration) | -| **Troubleshooting** | [Common Issues](./basic-examples.md#basic-troubleshooting-examples) | [System Debugging](./advanced-workflows.md#advanced-workflows) | [Distributed Debugging](./integration-patterns.md#advanced-troubleshooting-workflows) | -| **Performance** | [Basic Optimization](./basic-examples.md#quick-quality-improvements) | [System Optimization](./advanced-workflows.md#performance-optimization-strategies) | [Expert Optimization](./integration-patterns.md#performance-optimization-recipes) | - -## Success Milestones - -### โœ… Basic Proficiency -- [ ] Can install and configure SuperClaude -- [ ] Comfortable with 5-10 core commands -- [ ] Can complete simple workflows independently -- [ ] Understands basic flag usage - -### โœ… Intermediate Mastery -- [ ] Masters multi-agent coordination -- [ ] Can orchestrate complex workflows -- [ ] Understands session management -- [ ] Comfortable with advanced flag combinations - -### โœ… Expert Integration -- [ ] Can integrate any development framework -- [ ] Masters performance optimization -- [ ] Develops custom integration patterns -- [ ] Contributes to framework development - -## Support Resources - -**Documentation**: -- [Commands Reference](../User-Guide/commands.md) - Complete command documentation -- [Agents Guide](../User-Guide/agents.md) - Multi-agent coordination -- [MCP Servers](../User-Guide/mcp-servers.md) - Enhanced capabilities -- [Advanced Workflows](./advanced-workflows.md) - Complex coordination patterns - -**Community**: -- [GitHub Discussions](https://github.com/SuperClaude-Org/SuperClaude_Framework/discussions) - Community support -- [GitHub Issues](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues) - Bug reports and features -- [Contributing Guide](../CONTRIBUTING.md) - Framework contribution - -**Advanced**: -- [Technical Architecture](../Developer-Guide/technical-architecture.md) - Deep system understanding -- [Troubleshooting Guide](./troubleshooting.md) - Common issues and solutions - ---- - -**Your Journey**: Start with [Basic Examples](./basic-examples.md), progress through [Advanced Workflows](./advanced-workflows.md), and master [Integration Patterns](./integration-patterns.md). SuperClaude grows with you from simple commands to sophisticated development orchestration. - -**Remember**: Every expert was once a beginner. Focus on practical application, experiment with different approaches, and leverage the community for support and learning. \ No newline at end of file diff --git a/docs/Reference/integration-patterns.md b/docs/Reference/integration-patterns.md deleted file mode 100644 index 32fe89e..0000000 --- a/docs/Reference/integration-patterns.md +++ /dev/null @@ -1,319 +0,0 @@ -# SuperClaude Integration Patterns Collection - -**Status**: โœ… **Status: Current** - Context patterns for framework integration and tool coordination. - -**Context Integration Guide**: Patterns for using SuperClaude commands effectively with different frameworks and tools. Remember: SuperClaude provides context to Claude Code - all actual work is done by Claude. - -## Overview and Usage Guide - -**Purpose**: Effective patterns for using SuperClaude context with various development frameworks and tools. - -**What This Is**: Command combinations and flag patterns that work well for specific technologies -**What This Isn't**: Performance optimization or parallel execution (no code runs) - -**Key Principle**: SuperClaude tells Claude Code WHAT to do and HOW to think about it. Claude Code does the actual work. - -## Framework Context Patterns - -### React Development Patterns - -```bash -# React development with appropriate context -/sc:implement "React 18 application with TypeScript" --c7 -# Context7 MCP can provide React documentation if available -# Magic MCP can help with UI components if configured - -# What Actually Happens: -# 1. Claude reads implement.md for implementation patterns -# 2. --c7 flag suggests using Context7 MCP for documentation -# 3. Claude generates React code based on these contexts - -# Component development pattern -@agent-frontend-architect "design component architecture" -/sc:implement "reusable component library" - -# Testing pattern for React -/sc:test --focus react -# Claude will suggest React Testing Library patterns -``` - -### Node.js Backend Patterns - -```bash -# Node.js backend development patterns -/sc:implement "Express.js API with TypeScript" --c7 -# Claude will create Express API following Node.js patterns - -# What This Means: -# - Claude reads context about backend patterns -# - Suggests appropriate middleware and structure -# - NOT running or optimizing any code - -# Database integration pattern -/sc:implement "database models with Prisma" -@agent-backend-architect "review database schema" - -# API testing pattern -/sc:test --focus api -# Claude suggests API testing approaches -``` - -### Python Development Patterns - -```bash -# Python web development -/sc:implement "FastAPI application" --c7 -@agent-python-expert "review implementation" - -# What Happens: -# - Claude uses Python-specific context -# - Follows FastAPI patterns from context -# - Generates code (doesn't run it) - -# Data science context -/sc:implement "data analysis pipeline" -@agent-python-expert "optimize pandas operations" -# Claude provides optimization suggestions (not actual optimization) - -# Testing patterns -/sc:test --focus python -# Claude suggests pytest patterns -``` - -### Full-Stack Development Patterns - -```bash -# Full-stack application pattern -/sc:brainstorm "full-stack application architecture" -@agent-system-architect "design system components" - -# Frontend implementation -/sc:implement "React frontend with TypeScript" -@agent-frontend-architect "review component structure" - -# Backend implementation -/sc:implement "Node.js API with authentication" -@agent-backend-architect "review API design" - -# Integration -/sc:implement "connect frontend to backend API" -``` - -## Tool Coordination Patterns - -### Using MCP Servers Effectively - -```bash -# Context7 for documentation -/sc:explain "React hooks" --c7 -# If Context7 is configured, it may fetch React docs - -# Sequential for complex reasoning -/sc:troubleshoot "complex bug" --seq -# Sequential MCP helps with structured problem-solving - -# Magic for UI components -/sc:implement "UI components" --magic -# Magic MCP can help generate modern UI patterns - -# No MCP for simple tasks -/sc:implement "utility function" --no-mcp -# Uses only Claude's built-in knowledge -``` - -### Agent and Command Combinations - -```bash -# Security-focused development -@agent-security "review authentication requirements" -/sc:implement "secure authentication system" -/sc:analyze --focus security - -# Quality-focused workflow -/sc:implement "new feature" -@agent-quality-engineer "review code quality" -/sc:test --focus quality - -# Architecture-focused approach -@agent-system-architect "design microservices" -/sc:design "service boundaries" -/sc:implement "service communication" -``` - -## Common Integration Patterns - -### API Development Pattern - -```bash -# Step 1: Design -/sc:design "REST API structure" - -# Step 2: Implementation -/sc:implement "API endpoints with validation" - -# Step 3: Documentation -/sc:document --type api - -# Step 4: Testing -/sc:test --focus api -``` - -### Database Integration Pattern - -```bash -# Schema design -@agent-backend-architect "design database schema" - -# Model implementation -/sc:implement "database models" - -# Migration creation -/sc:implement "database migrations" - -# Query optimization suggestions -@agent-backend-architect "suggest query optimizations" -# Note: Claude suggests optimizations, doesn't actually optimize -``` - -### Testing Strategy Pattern - -```bash -# Test planning -/sc:design "testing strategy" - -# Unit tests -/sc:test --type unit - -# Integration tests -/sc:test --type integration - -# E2E test suggestions -/sc:test --type e2e -# Claude provides test code, not execution -``` - -## Technology-Specific Patterns - -### React + TypeScript Pattern - -```bash -# Project setup guidance -/sc:implement "React TypeScript project structure" - -# Component development -/sc:implement "TypeScript React components with props validation" - -# State management -@agent-frontend-architect "recommend state management approach" -/sc:implement "state management with Zustand/Redux" - -# Testing -/sc:test --focus react --type unit -``` - -### Python FastAPI Pattern - -```bash -# API structure -/sc:implement "FastAPI project structure" - -# Endpoint development -@agent-python-expert "implement async endpoints" - -# Database integration -/sc:implement "SQLAlchemy models with Alembic" - -# Testing -/sc:test --focus python --type integration -``` - -### Node.js Microservices Pattern - -```bash -# Architecture design -@agent-system-architect "design microservices architecture" - -# Service implementation -/sc:implement "user service with Express" -/sc:implement "auth service with JWT" - -# Inter-service communication -/sc:implement "service communication patterns" - -# Testing approach -/sc:test --focus microservices -``` - -## Troubleshooting Patterns - -### Debugging Workflow - -```bash -# Problem analysis -/sc:troubleshoot "describe the issue" - -# Root cause investigation -@agent-root-cause-analyst "analyze symptoms" - -# Solution implementation -/sc:implement "fix based on analysis" - -# Verification -/sc:test --validate -``` - -### Code Review Pattern - -```bash -# Code analysis -/sc:analyze code/ --focus quality - -# Security review -@agent-security "review for vulnerabilities" - -# Performance review -@agent-performance-engineer "suggest improvements" -# Note: Suggestions only, no actual performance measurement - -# Implementation of improvements -/sc:improve code/ --fix -``` - -## Important Clarifications - -### What These Patterns DO - -- โœ… Provide structured approaches to development tasks -- โœ… Combine commands and agents effectively -- โœ… Suggest appropriate tools and frameworks -- โœ… Guide Claude to generate better code - -### What These Patterns DON'T DO - -- โŒ Execute code or measure performance -- โŒ Run tests or deploy applications -- โŒ Optimize actual execution speed -- โŒ Provide real monitoring or metrics -- โŒ Coordinate parallel processes (everything is sequential text) - -## Best Practices - -### Effective Pattern Usage - -1. **Start with context**: Use `/sc:load` to establish project understanding -2. **Layer expertise**: Combine general commands with specific agents -3. **Focus appropriately**: Use `--focus` flags for targeted results -4. **Manage scope**: Work on specific modules rather than entire codebases -5. **Document decisions**: Use `/sc:save` to create summaries - -### Pattern Selection - -- **Simple tasks**: Use basic commands without MCP -- **Complex tasks**: Add appropriate agents and MCP servers -- **Security-critical**: Always include `@agent-security` -- **UI development**: Consider `--magic` flag if configured -- **Documentation needs**: Use `--c7` for framework docs - -## Summary - -These integration patterns show how to combine SuperClaude commands, agents, and flags effectively for different development scenarios. Remember that all patterns are about providing better context to Claude Code - the actual code generation, not execution, is what Claude does based on these contexts. \ No newline at end of file diff --git a/docs/Reference/mcp-server-guide.md b/docs/Reference/mcp-server-guide.md deleted file mode 100644 index 4e3b0e6..0000000 --- a/docs/Reference/mcp-server-guide.md +++ /dev/null @@ -1,755 +0,0 @@ -# MCP Server Troubleshooting Guide - -**MCP Server Focus**: Model Context Protocol (MCP) servers provide enhanced capabilities like documentation lookup (Context7), UI generation (Magic), and advanced reasoning (Sequential). This guide covers installation, configuration, and operational troubleshooting for all MCP servers. - -**Server-Specific Solutions**: Each MCP server has unique requirements and common failure patterns. This guide provides targeted solutions for each server type and general MCP troubleshooting strategies. - -## MCP Server Overview - -### Available MCP Servers - -**Core MCP Servers:** -- **Context7**: Official documentation lookup and framework patterns -- **Sequential**: Multi-step reasoning and complex analysis -- **Magic**: Modern UI component generation from 21st.dev patterns -- **Playwright**: Browser automation and E2E testing -- **Morphllm**: Pattern-based code editing with token optimization -- **Serena**: Semantic code understanding and project memory - -**Server Requirements:** -- Node.js 16.0.0 or higher -- npm or yarn package manager -- Stable network connection for some servers -- Sufficient system memory (2GB+ recommended) - -## Installation and Configuration Issues - -### Node.js and npm Problems - -#### Issue: Node.js Version Incompatibility -**Error Message**: `ERROR: MCP servers require Node.js 16+ but found Node.js 14.x` - -**Diagnosis**: -```bash -node --version -npm --version -``` - -**Solution 1**: Update Node.js (Linux/Ubuntu) -```bash -curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - -sudo apt-get install -y nodejs -``` - -**Solution 2**: Use Node Version Manager (nvm) -```bash -curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash -source ~/.bashrc -nvm install node -nvm use node -``` - -**Solution 3**: Manual Node.js installation -- Download from https://nodejs.org/ -- Follow platform-specific installation instructions - -**Verification**: -```bash -node --version # Should be 16.0.0+ -npm --version # Should be 8.0.0+ -``` - -**Issue: npm Permission Problems** -```bash -# Error message -ERROR: EACCES: permission denied, access '/usr/local/lib/node_modules' - -# Solution 1: Configure npm for user directory -mkdir ~/.npm-global -npm config set prefix '~/.npm-global' -echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.profile -source ~/.profile - -# Solution 2: Fix npm permissions -sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share} - -# Solution 3: Use npx for package execution -npx @context7/mcp-server --version - -# Verification -npm list -g --depth=0 -npm config get prefix -``` - -### MCP Server Installation Failures - -**Issue: Context7 MCP Server Installation Failed** -```bash -# Error message -ERROR: Failed to install @context7/mcp-server - -# Diagnosis -npm list -g @context7/mcp-server -node --version - -# Solution 1: Clean npm cache and reinstall -npm cache clean --force -npm install -g @context7/mcp-server - -# Solution 2: Use alternative registry -npm install -g @context7/mcp-server --registry https://registry.npmjs.org/ - -# Solution 3: Manual installation verification -npm info @context7/mcp-server -npm install -g @context7/mcp-server@latest - -# Verification -npm list -g @context7/mcp-server -node -e "console.log('Context7 installation test')" -``` - -**Issue: Sequential MCP Server Dependencies Missing** -```bash -# Error message -ERROR: Sequential MCP server missing required dependencies - -# Diagnosis -npm list -g @sequential/mcp-server -npm list -g | grep -E "typescript|@types" - -# Solution 1: Install dependencies explicitly -npm install -g typescript @types/node -npm install -g @sequential/mcp-server - -# Solution 2: Force reinstall with dependencies -npm uninstall -g @sequential/mcp-server -npm install -g @sequential/mcp-server --save-dev - -# Solution 3: Check package integrity -npm audit --global -npm update -g - -# Verification -npm list -g @sequential/mcp-server -``` - -**Issue: Magic UI Generator Installation Problems** -```bash -# Error message -ERROR: @magic/ui-generator installation failed - build dependencies missing - -# Diagnosis -npm list -g @magic/ui-generator -which gcc make # Check build tools - -# Solution 1: Install build dependencies (Linux) -sudo apt install build-essential python3-dev - -# Solution 2: Install build dependencies (macOS) -xcode-select --install - -# Solution 3: Use pre-built binaries -npm install -g @magic/ui-generator --ignore-scripts - -# Verification -npm list -g @magic/ui-generator -``` - -## Connection and Communication Issues - -### MCP Server Connection Failures - -**Issue: Context7 Server Not Connecting** -```bash -# Error message -ERROR: MCP server 'context7' failed to connect - -# Diagnosis -# Check Node.js installation -node --version # Should be 16.0.0 or higher -npm list -g @context7/mcp-server - -# Check server configuration -cat ~/.claude/CLAUDE.md | grep -i context7 - -# Solution 1: Restart Claude Code session -# MCP servers restart with Claude Code session restart - -# Solution 2: Reconfigure MCP servers -python3 -m SuperClaude install --components mcp --force - -# Solution 3: Manual server testing -node -e "console.log('Node.js working')" -npm test @context7/mcp-server - -# Solution 4: Check network connectivity -ping context7-server.example.com # If server requires network -curl -I https://context7-api.example.com/health # Health check - -# Verification -# Try Context7 functionality in Claude Code -# Should respond to documentation requests -``` - -**Issue: MCP Server Communication Timeout** -```bash -# Error message -ERROR: MCP server request timeout after 30 seconds - -# Diagnosis -# Check network connectivity and server health -ping 8.8.8.8 # Basic connectivity -curl -I https://api.example.com/health # API health - -# Check system resources -top -free -h - -# Solution 1: Reduce operation complexity -# Break complex tasks into smaller parts - -# Solution 2: Restart Claude Code session -# MCP servers restart with Claude Code session restart - -# Solution 3: Disable problematic server temporarily -# Use --no-mcp flag for operations - -# Solution 4: Increase timeout (if configurable) -# Check MCP server configuration files - -# Verification -# Test with simple operations first -# Gradually increase complexity -``` - -**Issue: Multiple MCP Servers Conflicting** -```bash -# Error message -ERROR: MCP server port conflicts detected - -# Diagnosis -netstat -tlnp | grep :8000 # Check port usage -ps aux | grep -E "context7|sequential|magic" - -# Solution 1: Sequential server restart -# Restart Claude Code to reset all MCP servers - -# Solution 2: Configure different ports -# Edit MCP server configuration files -# Usually in ~/.claude/ or server-specific directories - -# Solution 3: Use selective server activation -# Use specific server flags instead of --all-mcp - -# Verification -netstat -tlnp | grep -E "8000|8001|8002" # Check port assignments -``` - -## Server-Specific Troubleshooting - -### Context7 Documentation Server - -**Issue: Context7 Not Finding Documentation** -```bash -# Symptoms: Context7 activated but returns no documentation - -# Diagnosis -# Test Context7 connection -node -e "const c7 = require('@context7/mcp-server'); console.log('Context7 loaded');" - -# Solution 1: Update Context7 server -npm update -g @context7/mcp-server - -# Solution 2: Clear Context7 cache -rm -rf ~/.context7/cache/ # If cache directory exists - -# Solution 3: Use explicit library keywords -# Use specific framework names in requests - -# Solution 4: Verify internet connection -curl -I https://docs.react.dev/ # Example API test - -# Verification -# Try specific documentation requests -# Should return relevant framework information -``` - -**Issue: Context7 Returning Outdated Information** -```bash -# Symptoms: Context7 returns old documentation versions - -# Solution 1: Update Context7 server -npm uninstall -g @context7/mcp-server -npm install -g @context7/mcp-server@latest - -# Solution 2: Clear documentation cache -rm -rf ~/.context7/ # Clear cache if exists - -# Solution 3: Force documentation refresh -# Restart Claude Code session completely - -# Verification -# Check documentation dates in responses -# Should return current framework versions -``` - -### Sequential Reasoning Server - -**Issue: Sequential Server Internal Errors** -```bash -# Error message -ERROR: Sequential reasoning server encountered internal error - -# Diagnosis -# Check Sequential server logs -tail -f ~/.claude/logs/sequential-mcp.log # If logs exist - -# Check server installation -npm list -g @sequential/mcp-server - -# Solution 1: Restart Claude Code session -# This restarts all MCP servers including Sequential - -# Solution 2: Use alternative reasoning approach -# Use native Claude reasoning without MCP servers - -# Solution 3: Reinstall Sequential MCP -npm uninstall -g @sequential/mcp-server -npm install -g @sequential/mcp-server@latest - -# Solution 4: Check memory availability -free -h # Ensure sufficient memory for complex reasoning - -# Verification -# Test with simple analysis tasks first -# Should provide structured reasoning output -``` - -**Issue: Sequential Server Memory Overload** -```bash -# Symptoms: Sequential server crashes or becomes unresponsive - -# Diagnosis -top | grep -E "sequential|node" -free -h - -# Solution 1: Reduce analysis complexity -# Break complex problems into smaller parts - -# Solution 2: Increase system memory or swap -sudo swapon --show # Check swap status - -# Solution 3: Use scope limiting -# Focus analysis on specific components - -# Verification -ps aux | grep sequential # Check process status -``` - -### Magic UI Generator - -**Issue: Magic Not Generating UI Components** -```bash -# Symptoms: UI component requests not producing expected output - -# Diagnosis -# Check Magic server installation -npm list -g @magic/ui-generator -cat ~/.claude/CLAUDE.md | grep -i magic - -# Solution 1: Verify Magic server installation -npm list -g @magic/ui-generator -npm install -g @magic/ui-generator@latest - -# Solution 2: Use explicit Magic activation -# Include "component", "UI", or "interface" keywords - -# Solution 3: Check component request format -# Use descriptive requests for better Magic activation - -# Solution 4: Test Magic server directly -node -e "const magic = require('@magic/ui-generator'); console.log('Magic loaded');" - -# Verification -# Should produce complete UI components with modern patterns -``` - -**Issue: Magic Components Not Framework-Compliant** -```bash -# Symptoms: Generated components don't match framework patterns - -# Solution 1: Use framework-specific keywords -# Include "React", "Vue", "Angular" in requests - -# Solution 2: Combine with Context7 -# Use both Magic and Context7 for framework-compliant components - -# Solution 3: Update Magic server -npm update -g @magic/ui-generator - -# Verification -# Generated components should follow framework conventions -``` - -### Playwright Browser Automation - -**Issue: Playwright Browser Installation Failures** -```bash -# Error message -ERROR: Playwright browser automation failed - browser not installed - -# Diagnosis -npm list -g playwright -npx playwright --version - -# Solution 1: Install Playwright browsers -npx playwright install -npx playwright install-deps - -# Solution 2: Install specific browsers -npx playwright install chromium -npx playwright install firefox -npx playwright install webkit - -# Solution 3: Fix browser dependencies (Linux) -sudo apt-get install libnss3 libatk-bridge2.0-0 libdrm2 libgtk-3-0 - -# Verification -npx playwright --version -ls ~/.cache/ms-playwright/ # Check browser installations -``` - -**Issue: Playwright Browser Launch Failures** -```bash -# Error message -ERROR: Browser launch failed - display not available - -# Diagnosis -echo $DISPLAY # Check X11 display -ps aux | grep Xvfb # Check virtual display - -# Solution 1: Use headless mode -# Set headless: true in Playwright configuration - -# Solution 2: Install virtual display (Linux) -sudo apt-get install xvfb -export DISPLAY=:99 -Xvfb :99 -screen 0 1024x768x24 & - -# Solution 3: Use Docker for browser testing -docker run -it --rm playwright:latest - -# Verification -# Should successfully launch browsers in headless mode -``` - -### Morphllm Pattern Editor - -**Issue: Morphllm Pattern Application Failures** -```bash -# Symptoms: Pattern-based edits not applying correctly - -# Diagnosis -npm list -g @morphllm/mcp-server - -# Solution 1: Update Morphllm server -npm update -g @morphllm/mcp-server - -# Solution 2: Use more specific patterns -# Provide explicit pattern descriptions - -# Solution 3: Check file permissions -ls -la target-files/ # Ensure write permissions - -# Verification -# Pattern edits should be applied consistently across files -``` - -### Serena Project Memory - -**Issue: Serena Session Persistence Failures** -```bash -# Symptoms: Project context not persisting between sessions - -# Diagnosis -ls ~/.claude/sessions/ # Check session storage -ls ~/.serena/ # Check Serena-specific storage - -# Solution 1: Verify session save operations -# Ensure proper session saving before closing - -# Solution 2: Check storage permissions -ls -la ~/.claude/sessions/ -chmod 755 ~/.claude/sessions/ - -# Solution 3: Reinstall Serena server -# Remove existing Serena registration -claude mcp remove serena -# Reinstall using uvx -uvx --from git+https://github.com/oraios/serena serena --help -# Re-register with Claude -claude mcp add serena -- uvx --from git+https://github.com/oraios/serena serena start-mcp-server --context ide-assistant - -# Verification -# Session context should persist across Claude Code restarts -``` - -## Performance and Optimization - -### MCP Server Performance Issues - -**Issue: Slow MCP Server Response Times** -```bash -# Symptoms: MCP server operations causing delays - -# Diagnosis -# Check MCP server installation and health -npm list -g | grep -E "context7|sequential|magic|playwright" -top | grep node - -# Solution 1: Selective MCP server usage -# Use only needed servers for specific tasks - -# Solution 2: Restart Claude Code session -# This restarts all MCP servers fresh - -# Solution 3: Local fallback mode -# Use --no-mcp flag for pure native operations - -# Solution 4: Update all MCP servers -npm update -g - -# Verification -time node -e "console.log('Node.js speed test')" -# Should complete successfully -``` - -**Issue: MCP Server Memory Leaks** -```bash -# Symptoms: Increasing memory usage over time - -# Diagnosis -top | grep node # Monitor Node.js processes -ps aux --sort=-%mem | head -10 - -# Solution 1: Regular Claude Code session restarts -# Restart sessions periodically during heavy usage - -# Solution 2: Monitor specific servers -htop # Monitor individual MCP server processes - -# Solution 3: Use memory-efficient patterns -# Avoid keeping large data sets in MCP server memory - -# Verification -free -h # Monitor memory usage trends -``` - -### Resource Management - -**Issue: Multiple MCP Servers Competing for Resources** -```bash -# Symptoms: System slowdown when multiple servers active - -# Diagnosis -top | grep -E "node|mcp" -iostat 1 3 # Check I/O usage - -# Solution 1: Use targeted server activation -# Activate only needed servers per task - -# Solution 2: Increase system resources -# Add more RAM or CPU cores if possible - -# Solution 3: Queue MCP operations -# Avoid simultaneous heavy operations - -# Solution 4: Use MCP server priorities -# Configure resource allocation in MCP settings - -# Verification -top # Monitor resource usage during operations -``` - -## Advanced MCP Configuration - -### Custom MCP Server Configuration - -**Issue: Default MCP Configuration Not Optimal** -```bash -# Symptoms: MCP servers not performing optimally for specific use cases - -# Solution 1: Locate configuration files -find ~/.claude/ -name "*mcp*" -type f -find ~/.config/ -name "*mcp*" -type f - -# Solution 2: Customize server settings -# Edit server-specific configuration files -# Common locations: ~/.claude/mcp-config.json - -# Solution 3: Environment variable configuration -export MCP_CONTEXT7_TIMEOUT=60 -export MCP_SEQUENTIAL_MEMORY_LIMIT=2048 - -# Verification -# Test with custom configuration -# Should show improved performance for specific use cases -``` - -**Issue: MCP Server Load Balancing** -```bash -# Symptoms: Uneven load distribution across MCP servers - -# Solution 1: Configure server priorities -# Edit MCP configuration to balance loads - -# Solution 2: Use round-robin server selection -# Implement rotation logic in server calls - -# Solution 3: Monitor server performance -# Track response times and adjust accordingly - -# Verification -# Observe balanced resource usage across servers -``` - -## Debugging and Diagnostics - -### MCP Server Health Monitoring - -**Comprehensive MCP Health Check:** -```bash -# MCP Server System Diagnostics -echo "=== MCP Server Health Check ===" - -# Node.js environment -echo "Node.js version: $(node --version)" -echo "npm version: $(npm --version)" - -# Server installations -echo "=== Installed MCP Servers ===" -npm list -g | grep -E "context7|sequential|magic|playwright|morphllm|serena" - -# Process monitoring -echo "=== Running MCP Processes ===" -ps aux | grep -E "node.*mcp|mcp.*server" | head -5 - -# Resource usage -echo "=== Resource Usage ===" -echo "Memory: $(free -h | grep Mem | awk '{print $3 "/" $2}')" -echo "CPU Load: $(uptime | awk -F'load average:' '{print $2}')" - -# Network connectivity (if required) -echo "=== Network Status ===" -ping -c 1 8.8.8.8 > /dev/null && echo "โœ… Network OK" || echo "โŒ Network Issue" -``` - -**MCP Server Functionality Test:** -```bash -# Test each MCP server individually -echo "=== MCP Server Functionality Test ===" - -# Context7 test -if npm list -g @context7/mcp-server > /dev/null 2>&1; then - echo "โœ… Context7 installed" -else - echo "โŒ Context7 missing" -fi - -# Sequential test -if npm list -g @sequential/mcp-server > /dev/null 2>&1; then - echo "โœ… Sequential installed" -else - echo "โŒ Sequential missing" -fi - -# Magic test -if npm list -g @magic/ui-generator > /dev/null 2>&1; then - echo "โœ… Magic installed" -else - echo "โŒ Magic missing" -fi - -# Playwright test -if npx playwright --version > /dev/null 2>&1; then - echo "โœ… Playwright installed" -else - echo "โŒ Playwright missing" -fi -``` - -### MCP Server Log Analysis - -**Log Collection and Analysis:** -```bash -# Collect MCP server logs -echo "=== MCP Server Logs ===" - -# Check common log locations -find ~/.claude/ -name "*.log" -type f 2>/dev/null -find /tmp/ -name "*mcp*.log" -type f 2>/dev/null -find /var/log/ -name "*mcp*.log" -type f 2>/dev/null - -# Check npm logs -npm config get logs-max -ls ~/.npm/_logs/ 2>/dev/null | tail -5 - -# System logs for Node.js processes -journalctl -u node* --since "1 hour ago" 2>/dev/null | tail -10 -``` - -## Emergency Recovery - -### Complete MCP Reset - -**Full MCP Server Reset Procedure:** -```bash -# Emergency MCP Reset -echo "=== Emergency MCP Server Reset ===" - -# Step 1: Stop all Claude Code sessions -echo "Stop all Claude Code sessions and wait 30 seconds" - -# Step 2: Backup current state -cp -r ~/.claude ~/.claude.mcp.backup.$(date +%Y%m%d) - -# Step 3: Remove all MCP servers -npm list -g | grep -E "context7|sequential|magic|playwright|morphllm|serena" | awk '{print $2}' | xargs npm uninstall -g - -# Step 4: Clear npm cache -npm cache clean --force - -# Step 5: Reinstall MCP servers -python3 -m SuperClaude install --components mcp --force - -# Step 6: Verification -npm list -g | grep -E "context7|sequential|magic|playwright|morphllm|serena" - -# Step 7: Test functionality -echo "Test MCP servers in Claude Code after restart" -``` - -## Related Resources - -### MCP-Specific Documentation -- **Core SuperClaude Guide**: [../User-Guide/mcp-servers.md](../User-Guide/mcp-servers.md) - MCP server overview and usage -- **Common Issues**: [common-issues.md](./common-issues.md) - General troubleshooting procedures -- **Diagnostic Reference**: [diagnostic-reference.md](./diagnostic-reference.md) - Advanced diagnostic procedures - -### External Resources -- **Node.js Official**: [https://nodejs.org/](https://nodejs.org/) - Node.js installation and documentation -- **npm Documentation**: [https://docs.npmjs.com/](https://docs.npmjs.com/) - Package manager documentation -- **Playwright Guide**: [https://playwright.dev/](https://playwright.dev/) - Browser automation documentation - -### Support Channels -- **GitHub Issues**: [MCP-specific problems](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues) -- **GitHub Discussions**: [MCP server community support](https://github.com/SuperClaude-Org/SuperClaude_Framework/discussions) - ---- - -**MCP Server Priority**: When troubleshooting, address servers in order of dependency: Node.js โ†’ npm โ†’ individual servers โ†’ Claude Code integration. Most MCP issues resolve with proper Node.js setup and server reinstallation. - -**Verification Pattern**: After MCP solutions, always verify with: -- โœ… `node --version` - Should be 16.0.0+ -- โœ… `npm list -g | grep mcp` - Should show installed servers -- โœ… Test server functionality in Claude Code - Should respond without errors \ No newline at end of file diff --git a/docs/Reference/troubleshooting.md b/docs/Reference/troubleshooting.md deleted file mode 100644 index 267919a..0000000 --- a/docs/Reference/troubleshooting.md +++ /dev/null @@ -1,124 +0,0 @@ -# SuperClaude Troubleshooting Guide ๐Ÿ”ง - -Quick fixes to advanced diagnostics for SuperClaude Framework issues. - -## Quick Fixes (90% of problems) - -**Installation Verification:** -```bash -python3 -m SuperClaude --version # Should show 4.1.5 -SuperClaude install --list-components -``` - -**Command Issues:** -```bash -# Test in Claude Code: -/sc:brainstorm "test project" # Should ask discovery questions - -# If no response: Restart Claude Code session -``` - -**Resolution Checklist:** -- [ ] Version commands work and show 4.1.5 -- [ ] `/sc:` commands respond in Claude Code -- [ ] MCP servers listed: `SuperClaude install --list-components | grep mcp` - -## Common Issues - -### Installation Problems - -**Package Installation Fails:** -```bash -# For pipx users -pipx uninstall SuperClaude -pipx install SuperClaude - -# For pip users -pip uninstall SuperClaude -pip install --upgrade pip -pip install SuperClaude -``` - -**Permission Denied / PEP 668 Error:** -```bash -# Option 1: Use pipx (recommended) -pipx install SuperClaude - -# Option 2: Use pip with --user flag -pip install --user SuperClaude - -# Option 3: Fix permissions -sudo chown -R $USER ~/.claude - -# Option 4: Force installation (use with caution) -pip install --break-system-packages SuperClaude -``` - -**Component Missing:** -```bash -python3 -m SuperClaude install --components core commands agents modes --force -``` - -### Command Issues - -**Commands Not Recognized:** -1. Restart Claude Code completely -2. Verify: `python3 -m SuperClaude --version` -3. Test: `/sc:brainstorm "test"` - -**Agents Not Activating:** -- Use specific keywords: `/sc:implement "secure JWT authentication"` -- Manual activation: `@agent-security "review auth code"` - -**Slow Performance:** -```bash -/sc:analyze . --no-mcp # Test without MCP servers -/sc:analyze src/ --scope file # Limit scope -``` - -### MCP Server Issues - -**Server Connection Fails:** -```bash -ls ~/.claude/.claude.json # Check config exists -node --version # Verify Node.js 16+ -SuperClaude install --components mcp --force -``` - -**API Key Required (Magic/Morphllm):** -```bash -export TWENTYFIRST_API_KEY="your_key" -export MORPH_API_KEY="your_key" -# Or use: /sc:command --no-mcp -``` - -## Advanced Diagnostics - -**System Analysis:** -```bash -SuperClaude install --diagnose -cat ~/.claude/logs/superclaude.log | tail -50 -``` - -**Component Analysis:** -```bash -ls -la ~/.claude/ # Check installed files -grep -r "@" ~/.claude/CLAUDE.md # Verify imports -``` - -**Reset Installation:** -```bash -SuperClaude backup --create # Backup first -SuperClaude uninstall -SuperClaude install --fresh -``` - -## Get Help - -**Documentation:** -- [Installation Guide](../Getting-Started/installation.md) - Setup issues -- [Commands Guide](../User-Guide/commands.md) - Usage issues - -**Community:** -- [GitHub Issues](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues) -- Include: OS, Python version, error message, steps to reproduce \ No newline at end of file diff --git a/docs/User-Guide-jp/agents.md b/docs/User-Guide-jp/agents.md deleted file mode 100644 index 7b75e26..0000000 --- a/docs/User-Guide-jp/agents.md +++ /dev/null @@ -1,1029 +0,0 @@ -# SuperClaude ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใ‚ฌใ‚คใƒ‰ ๐Ÿค– - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#superclaude-agents-guide-) - -SuperClaude ใฏใ€Claude Code ใŒๅฐ‚้–€็Ÿฅ่ญ˜ใ‚’ๅพ—ใ‚‹ใŸใ‚ใซๅ‘ผใณๅ‡บใ™ใ“ใจใŒใงใใ‚‹ 14 ใฎใƒ‰ใƒกใ‚คใƒณ ใ‚นใƒšใ‚ทใƒฃใƒชใ‚นใƒˆ ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใ‚’ๆไพ›ใ—ใพใ™ใ€‚ - -## ๐Ÿงช ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ™ใƒผใ‚ทใƒงใƒณใฎใƒ†ใ‚นใƒˆ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#-testing-agent-activation) - -ใ“ใฎใ‚ฌใ‚คใƒ‰ใ‚’ไฝฟ็”จใ™ใ‚‹ๅ‰ใซใ€ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎ้ธๆŠžใŒๆฉŸ่ƒฝใ™ใ‚‹ใ“ใจใ‚’็ขบ่ชใ—ใฆใใ ใ•ใ„ใ€‚ - -```shell -# Test manual agent invocation -@agent-python-expert "explain decorators" -# Example behavior: Python expert responds with detailed explanation - -# Test security agent auto-activation -/sc:implement "JWT authentication" -# Example behavior: Security engineer should activate automatically - -# Test frontend agent auto-activation -/sc:implement "responsive navigation component" -# Example behavior: Frontend architect + Magic MCP should activate - -# Test systematic analysis -/sc:troubleshoot "slow API performance" -# Example behavior: Root-cause analyst + performance engineer activation - -# Test combining manual and auto -/sc:analyze src/ -@agent-refactoring-expert "suggest improvements" -# Example behavior: Analysis followed by refactoring suggestions -``` - -**ใƒ†ใ‚นใƒˆใŒๅคฑๆ•—ใ—ใŸๅ ดๅˆ**: ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใƒ•ใ‚กใ‚คใƒซใŒๅญ˜ๅœจใ™ใ‚‹`~/.claude/agents/`ใ‹ใ€Claude Codeใ‚ปใƒƒใ‚ทใƒงใƒณใ‚’ๅ†่ตทๅ‹•ใ—ใฆใใ ใ•ใ„ใ€‚ - -## ใ‚ณใ‚ขใ‚ณใƒณใ‚ปใƒ—ใƒˆ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#core-concepts) - -### SuperClaude ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใจใฏไฝ•ใงใ™ใ‹? - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#what-are-superclaude-agents) - -**ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฏ**ใ€Claude Codeใฎ่กŒๅ‹•ใ‚’ๅค‰ๆ›ดใ™ใ‚‹ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆๆŒ‡็คบใจใ—ใฆๅฎŸ่ฃ…ใ•ใ‚ŒใŸใ€ๅฐ‚้–€ๅˆ†้‡ŽใฎAIใƒ‰ใƒกใ‚คใƒณใ‚จใ‚ญใ‚นใƒ‘ใƒผใƒˆใงใ™ใ€‚ๅ„ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฏใ€ใƒ‰ใƒกใ‚คใƒณๅ›บๆœ‰ใฎๅฐ‚้–€็Ÿฅ่ญ˜ใ€่กŒๅ‹•ใƒ‘ใ‚ฟใƒผใƒณใ€ๅ•้กŒ่งฃๆฑบใ‚ขใƒ—ใƒญใƒผใƒใ‚’ๅซใ‚€ใ€ใƒ‡ใ‚ฃใƒฌใ‚ฏใƒˆใƒช`.md`ๅ†…ใซ็ถฟๅฏ†ใซไฝœๆˆใ•ใ‚ŒใŸใƒ•ใ‚กใ‚คใƒซใงใ™`superclaude/Agents/`ใ€‚ - -**้‡่ฆ**: ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฏๅˆฅๅ€‹ใฎ AI ใƒขใƒ‡ใƒซใ‚„ใ‚ฝใƒ•ใƒˆใ‚ฆใ‚งใ‚ขใงใฏใชใใ€Claude Code ใŒ่ชญใฟๅ–ใฃใฆ็‰นๆฎŠใชๅ‹•ไฝœใ‚’ๆŽก็”จใ™ใ‚‹ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆๆง‹ๆˆใงใ™ใ€‚ - -### ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎ2ใคใฎไฝฟ็”จๆ–นๆณ• - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#two-ways-to-use-agents) - -#### 1. @agent- ใƒ—ใƒฌใƒ•ใ‚ฃใƒƒใ‚ฏใ‚นใ‚’ไฝฟ็”จใ—ใŸๆ‰‹ๅ‹•ๅ‘ผใณๅ‡บใ— - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#1-manual-invocation-with-agent--prefix) - -```shell -# Directly invoke a specific agent -@agent-security "review authentication implementation" -@agent-frontend "design responsive navigation" -@agent-architect "plan microservices migration" -``` - -#### 2. ่‡ชๅ‹•ใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ™ใƒผใ‚ทใƒงใƒณ๏ผˆ่กŒๅ‹•ใƒซใƒผใƒ†ใ‚ฃใƒณใ‚ฐ๏ผ‰ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#2-auto-activation-behavioral-routing) - -ใ€Œ่‡ชๅ‹•ใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ™ใƒผใ‚ทใƒงใƒณใ€ใจใฏใ€Claude CodeใŒใƒชใ‚ฏใ‚จใ‚นใƒˆๅ†…ใฎใ‚ญใƒผใƒฏใƒผใƒ‰ใจใƒ‘ใ‚ฟใƒผใƒณใซๅŸบใฅใ„ใฆ้ฉๅˆ‡ใชใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆใงๅ‹•ไฝœๆŒ‡็คบใ‚’่ชญใฟๅ–ใ‚Šใ€ใ‚จใƒณใ‚ฒใƒผใ‚ธใ™ใ‚‹ใ“ใจใ‚’ๆ„ๅ‘ณใ—ใพใ™ใ€‚SuperClaudeใฏใ€ClaudeใŒๆœ€้ฉใชใ‚นใƒšใ‚ทใƒฃใƒชใ‚นใƒˆใซใƒซใƒผใƒ†ใ‚ฃใƒณใ‚ฐใ™ใ‚‹ใŸใ‚ใฎๅ‹•ไฝœใ‚ฌใ‚คใƒ‰ใƒฉใ‚คใƒณใ‚’ๆไพ›ใ—ใพใ™ใ€‚ - -> **๐Ÿ“ ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎใ€Œ่‡ชๅ‹•ใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ™ใƒผใ‚ทใƒงใƒณใ€ใฎไป•็ต„ใฟ**๏ผšใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ™ใƒผใ‚ทใƒงใƒณใฏ่‡ชๅ‹•ใ‚ทใ‚นใƒ†ใƒ ใƒญใ‚ธใƒƒใ‚ฏใงใฏใชใใ€ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆใƒ•ใ‚กใ‚คใƒซๅ†…ใฎๅ‹•ไฝœๆŒ‡็คบใงใ™ใ€‚ใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆใงใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใŒใ€Œ่‡ชๅ‹•ใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ™ใƒผใƒˆใ€ใจ่จ˜่ผ‰ใ•ใ‚Œใฆใ„ใ‚‹ๅ ดๅˆใ€ใใ‚ŒใฏClaude CodeใŒๆŒ‡็คบใ‚’่ชญใฟๅ–ใ‚Šใ€ใƒชใ‚ฏใ‚จใ‚นใƒˆๅ†…ใฎใ‚ญใƒผใƒฏใƒผใƒ‰ใจใƒ‘ใ‚ฟใƒผใƒณใซๅŸบใฅใ„ใฆ็‰นๅฎšใฎใƒ‰ใƒกใ‚คใƒณใฎๅฐ‚้–€็Ÿฅ่ญ˜ใ‚’ๆดป็”จใ™ใ‚‹ใ“ใจใ‚’ๆ„ๅ‘ณใ—ใพใ™ใ€‚ใ“ใ‚Œใซใ‚ˆใ‚Šใ€ๅŸบ็›คใจใชใ‚‹ใƒกใ‚ซใƒ‹ใ‚บใƒ ใ‚’้€ๆ˜ŽๅŒ–ใ—ใชใŒใ‚‰ใ€ใ‚คใƒณใƒ†ใƒชใ‚ธใ‚งใƒณใƒˆใชใƒซใƒผใƒ†ใ‚ฃใƒณใ‚ฐไฝ“้จ“ใ‚’ๅฎŸ็พใ—ใพใ™ใ€‚ - -```shell -# These commands auto-activate relevant agents -/sc:implement "JWT authentication" # โ†’ security-engineer auto-activates -/sc:design "React dashboard" # โ†’ frontend-architect auto-activates -/sc:troubleshoot "memory leak" # โ†’ performance-engineer auto-activates -``` - -**MCP ใ‚ตใƒผใƒใƒผใฏ**ใ€Context7 (ใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆไฝœๆˆ)ใ€Sequential (ๅˆ†ๆž)ใ€Magic (UI)ใ€Playwright (ใƒ†ใ‚นใƒˆ)ใ€Morphllm (ใ‚ณใƒผใƒ‰ๅค‰ๆ›) ใชใฉใฎๅฐ‚็”จใƒ„ใƒผใƒซใ‚’้€šใ˜ใฆๆ‹กๅผตๆฉŸ่ƒฝใ‚’ๆไพ›ใ—ใพใ™ใ€‚ - -**ใƒ‰ใƒกใ‚คใƒณ ใ‚นใƒšใ‚ทใƒฃใƒชใ‚นใƒˆใฏใ€**็‹ญใ„ๅฐ‚้–€ๅˆ†้‡Žใซ็„ฆ็‚นใ‚’็ตžใ‚Šใ€ใ‚ธใ‚งใƒใƒฉใƒชใ‚นใƒˆใฎใ‚ขใƒ—ใƒญใƒผใƒใ‚ˆใ‚Šใ‚‚ๆทฑใๆญฃ็ขบใชใ‚ฝใƒชใƒฅใƒผใ‚ทใƒงใƒณใ‚’ๆไพ›ใ—ใพใ™ใ€‚ - -### ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆ้ธๆŠžใƒซใƒผใƒซ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#agent-selection-rules) - -**ๅ„ชๅ…ˆ้ †ไฝใฎ้šŽๅฑค:** - -1. **ๆ‰‹ๅ‹•ใ‚ชใƒผใƒใƒผใƒฉใ‚คใƒ‰**- @agent-[name] ใฏ่‡ชๅ‹•ใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ™ใƒผใ‚ทใƒงใƒณใ‚ˆใ‚Šใ‚‚ๅ„ชๅ…ˆใ•ใ‚Œใพใ™ -2. **ใ‚ญใƒผใƒฏใƒผใƒ‰**- ็›ดๆŽฅ็š„ใชใƒ‰ใƒกใ‚คใƒณ็”จ่ชžใฏไธป่ฆใชใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใ‚’ใƒˆใƒชใ‚ฌใƒผใ—ใพใ™ -3. **ใƒ•ใ‚กใ‚คใƒซใ‚ฟใ‚คใƒ—**- ๆ‹กๅผตๅญใฏ่จ€่ชž/ใƒ•ใƒฌใƒผใƒ ใƒฏใƒผใ‚ฏใฎๅฐ‚้–€ๅฎถใ‚’ๆดปๆ€งๅŒ–ใ—ใพใ™ -4. **่ค‡้›‘ๆ€ง**- ่ค‡ๆ•ฐใ‚นใƒ†ใƒƒใƒ—ใฎใ‚ฟใ‚นใ‚ฏใซใฏ่ชฟๆ•ดใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใŒ้–ขไธŽใ™ใ‚‹ -5. **ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆ**- ้–ข้€ฃๆฆ‚ๅฟตใฏ่ฃœๅฎŒ็š„ใชใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใ‚’ใƒˆใƒชใ‚ฌใƒผใ—ใพใ™ - -**็ด›ไบ‰่งฃๆฑบ:** - -- ๆ‰‹ๅ‹•ๅ‘ผใณๅ‡บใ— โ†’ ๆŒ‡ๅฎšใ—ใŸใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใŒๅ„ชๅ…ˆใ•ใ‚Œใพใ™ -- ่ค‡ๆ•ฐใฎใƒžใƒƒใƒใƒณใ‚ฐ โ†’ ใƒžใƒซใƒใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใ‚ณใƒผใƒ‡ใ‚ฃใƒใƒผใ‚ทใƒงใƒณ -- ไธๆ˜Ž็žญใชใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆ โ†’ ่ฆไปถใ‚ขใƒŠใƒชใ‚นใƒˆใฎๆดปๆ€งๅŒ– -- ่ค‡้›‘ๆ€งใŒ้ซ˜ใ„ โ†’ ใ‚ทใ‚นใƒ†ใƒ ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆใฎ็›ฃ่ฆ– -- ๅ“่ณชใซ้–ขใ™ใ‚‹ๆ‡ธๅฟต โ†’ ่‡ชๅ‹•QAใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎ็ต„ใฟ่พผใฟ - -**้ธๆŠžๆฑบๅฎšใƒ„ใƒชใƒผ:** - -``` -Task Analysis โ†’ -โ”œโ”€ Manual @agent-? โ†’ Use specified agent -โ”œโ”€ Single Domain? โ†’ Activate primary agent -โ”œโ”€ Multi-Domain? โ†’ Coordinate specialist agents -โ”œโ”€ Complex System? โ†’ Add system-architect oversight -โ”œโ”€ Quality Critical? โ†’ Include security + performance + quality agents -โ””โ”€ Learning Focus? โ†’ Add learning-guide + technical-writer -``` - -## ใ‚ฏใ‚คใƒƒใ‚ฏใ‚นใ‚ฟใƒผใƒˆใฎไพ‹ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#quick-start-examples) - -### ๆ‰‹ๅ‹•ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆๅ‘ผใณๅ‡บใ— - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#manual-agent-invocation) - -```shell -# Explicitly call specific agents with @agent- prefix -@agent-python-expert "optimize this data processing pipeline" -@agent-quality-engineer "create comprehensive test suite" -@agent-technical-writer "document this API with examples" -@agent-socratic-mentor "explain this design pattern" -``` - -### ่‡ชๅ‹•ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆ่ชฟๆ•ด - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#automatic-agent-coordination) - -```shell -# Commands that trigger auto-activation -/sc:implement "JWT authentication with rate limiting" -# โ†’ Triggers: security-engineer + backend-architect + quality-engineer - -/sc:design "accessible React dashboard with documentation" -# โ†’ Triggers: frontend-architect + learning-guide + technical-writer - -/sc:troubleshoot "slow deployment pipeline with intermittent failures" -# โ†’ Triggers: devops-architect + performance-engineer + root-cause-analyst - -/sc:audit "payment processing security vulnerabilities" -# โ†’ Triggers: security-engineer + quality-engineer + refactoring-expert -``` - -### ๆ‰‹ๅ‹•ใจ่‡ชๅ‹•ใฎใ‚ขใƒ—ใƒญใƒผใƒใ‚’็ต„ใฟๅˆใ‚ใ›ใ‚‹ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#combining-manual-and-auto-approaches) - -```shell -# Start with command (auto-activation) -/sc:implement "user profile system" - -# Then explicitly add specialist review -@agent-security "review the profile system for OWASP compliance" -@agent-performance-engineer "optimize database queries" -``` - ---- - -## SuperClaude ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใƒใƒผใƒ  ๐Ÿ‘ฅ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#the-superclaude-agent-team-) - -### ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃใจใ‚ทใ‚นใƒ†ใƒ ่จญ่จˆใ‚จใƒผใ‚ธใ‚งใƒณใƒˆ ๐Ÿ—๏ธ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#architecture--system-design-agents-%EF%B8%8F) - -### ใ‚ทใ‚นใƒ†ใƒ ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆ ๐Ÿข - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#system-architect-) - -**ๅฐ‚้–€ๅˆ†้‡Ž**๏ผšใ‚นใ‚ฑใƒผใƒฉใƒ“ใƒชใƒ†ใ‚ฃใจใ‚ตใƒผใƒ“ใ‚นใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃใซ้‡็‚นใ‚’็ฝฎใ„ใŸๅคง่ฆๆจกๅˆ†ๆ•ฃใ‚ทใ‚นใƒ†ใƒ ่จญ่จˆ - -**่‡ชๅ‹•ใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ™ใƒผใ‚ทใƒงใƒณ**: - -- ใ‚ญใƒผใƒฏใƒผใƒ‰: ใ€Œใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃใ€ใ€ใ€Œใƒžใ‚คใ‚ฏใƒญใ‚ตใƒผใƒ“ใ‚นใ€ใ€ใ€Œใ‚นใ‚ฑใƒผใƒฉใƒ“ใƒชใƒ†ใ‚ฃใ€ใ€ใ€Œใ‚ทใ‚นใƒ†ใƒ ่จญ่จˆใ€ใ€ใ€Œๅˆ†ๆ•ฃใ€ -- ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆ: ใƒžใƒซใƒใ‚ตใƒผใƒ“ใ‚นใ‚ทใ‚นใƒ†ใƒ ใ€ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃไธŠใฎๆฑบๅฎšใ€ใƒ†ใ‚ฏใƒŽใƒญใ‚ธใƒผใฎ้ธๆŠž -- ่ค‡้›‘ใ•: 5 ใคไปฅไธŠใฎใ‚ณใƒณใƒใƒผใƒใƒณใƒˆใพใŸใฏใƒ‰ใƒกใ‚คใƒณ้–“็ตฑๅˆ่ฆไปถ - -**ๆฉŸ่ƒฝ**: - -- ใ‚ตใƒผใƒ“ใ‚นๅขƒ็•Œใฎๅฎš็พฉใจใƒžใ‚คใ‚ฏใƒญใ‚ตใƒผใƒ“ใ‚นใฎๅˆ†่งฃ -- ใƒ†ใ‚ฏใƒŽใƒญใ‚ธใƒผใ‚นใ‚ฟใƒƒใ‚ฏใฎ้ธๆŠžใจ็ตฑๅˆๆˆฆ็•ฅ -- ใ‚นใ‚ฑใƒผใƒฉใƒ“ใƒชใƒ†ใ‚ฃ่จˆ็”ปใจใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃ -- ใ‚คใƒ™ใƒณใƒˆ้ง†ๅ‹•ๅž‹ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃใจใƒกใƒƒใ‚ปใƒผใ‚ธใƒณใ‚ฐใƒ‘ใ‚ฟใƒผใƒณ -- ใƒ‡ใƒผใ‚ฟใƒ•ใƒญใƒผ่จญ่จˆใจใ‚ทใ‚นใƒ†ใƒ ็ตฑๅˆ - -**ไพ‹**: - -1. **Eใ‚ณใƒžใƒผใ‚นใƒ—ใƒฉใƒƒใƒˆใƒ•ใ‚ฉใƒผใƒ **๏ผšใ‚คใƒ™ใƒณใƒˆใ‚ฝใƒผใ‚ทใƒณใ‚ฐใ‚’ไฝฟ็”จใ—ใฆใ€ใƒฆใƒผใ‚ถใƒผใ€่ฃฝๅ“ใ€ๆ”ฏๆ‰•ใ„ใ€้€š็Ÿฅใ‚ตใƒผใƒ“ใ‚นใฎใƒžใ‚คใ‚ฏใƒญใ‚ตใƒผใƒ“ใ‚นใ‚’่จญ่จˆใ—ใพใ™ใ€‚ -2. **ใƒชใ‚ขใƒซใ‚ฟใ‚คใƒ ๅˆ†ๆž**๏ผšใ‚นใƒˆใƒชใƒผใƒ ๅ‡ฆ็†ใจๆ™‚็ณปๅˆ—ใ‚นใƒˆใƒฌใƒผใ‚ธใซใ‚ˆใ‚‹้ซ˜ใ‚นใƒซใƒผใƒ—ใƒƒใƒˆใƒ‡ใƒผใ‚ฟๅ–ใ‚Š่พผใฟใฎใŸใ‚ใฎใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃ -3. **ใƒžใƒซใƒใƒ†ใƒŠใƒณใƒˆ SaaS**ย : ใƒ†ใƒŠใƒณใƒˆๅˆ†้›ขใ€ๅ…ฑๆœ‰ใ‚คใƒณใƒ•ใƒฉใ‚นใƒˆใƒฉใ‚ฏใƒใƒฃใ€ๆฐดๅนณใ‚นใ‚ฑใƒผใƒชใƒณใ‚ฐๆˆฆ็•ฅใ‚’ๅ‚™ใˆใŸใ‚ทใ‚นใƒ†ใƒ ่จญ่จˆ - -### ๆˆๅŠŸๅŸบๆบ– - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#success-criteria) - -- [ ] ๅฟœ็ญ”ใซ่กจใ‚ŒใŸใ‚ทใ‚นใƒ†ใƒ ใƒฌใƒ™ใƒซใฎๆ€่€ƒ -- [ ] ใ‚ตใƒผใƒ“ใ‚นใฎๅขƒ็•Œใจ็ตฑๅˆใƒ‘ใ‚ฟใƒผใƒณใซใคใ„ใฆ่จ€ๅŠใ™ใ‚‹ -- [ ] ใ‚นใ‚ฑใƒผใƒฉใƒ“ใƒชใƒ†ใ‚ฃใจไฟก้ ผๆ€งใฎ่€ƒๆ…ฎใ‚’ๅซใ‚€ -- [ ] ใƒ†ใ‚ฏใƒŽใƒญใ‚ธใƒผใ‚นใ‚ฟใƒƒใ‚ฏใฎๆŽจๅฅจไบ‹้ …ใ‚’ๆไพ›ใ™ใ‚‹ - -**ๆคœ่จผ:**ย `/sc:design "microservices platform"`ใ‚ทใ‚นใƒ†ใƒ  ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆใ‚’ใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ–ๅŒ–ใ™ใ‚‹ๅฟ…่ฆใŒใ‚ใ‚Šใพใ™ใ€‚ -**ใƒ†ใ‚นใƒˆ:**ๅ‡บๅŠ›ใซใฏใ€ใ‚ตใƒผใƒ“ใ‚นใฎๅˆ†่งฃใจ็ตฑๅˆใƒ‘ใ‚ฟใƒผใƒณใŒๅซใพใ‚Œใฆใ„ใ‚‹ๅฟ…่ฆใŒใ‚ใ‚Šใพใ™ใ€‚ -**ใƒใ‚งใƒƒใ‚ฏ:**ใ‚คใƒณใƒ•ใƒฉใ‚นใƒˆใƒฉใ‚ฏใƒใƒฃใซ้–ขใ™ใ‚‹ๆ‡ธๅฟตไบ‹้ …ใซใคใ„ใฆใฏใ€DevOps ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆใจ่ชฟๆ•ดใ™ใ‚‹ๅฟ…่ฆใŒใ‚ใ‚Šใพใ™ใ€‚ - -**ๆœ€้ฉใช็ต„ใฟๅˆใ‚ใ›**: devops-architect (ใ‚คใƒณใƒ•ใƒฉใ‚นใƒˆใƒฉใ‚ฏใƒใƒฃ)ใ€performance-engineer (ๆœ€้ฉๅŒ–)ใ€security-engineer (ใ‚ณใƒณใƒ—ใƒฉใ‚คใ‚ขใƒณใ‚น) - ---- - -### ใƒใƒƒใ‚ฏใ‚จใƒณใƒ‰ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆ โš™๏ธ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#backend-architect-%EF%B8%8F) - -**ๅฐ‚้–€ๅˆ†้‡Ž**: APIใฎไฟก้ ผๆ€งใจใƒ‡ใƒผใ‚ฟใฎๆ•ดๅˆๆ€งใ‚’้‡่ฆ–ใ—ใŸๅ …็‰ขใชใ‚ตใƒผใƒใƒผใ‚ตใ‚คใƒ‰ใ‚ทใ‚นใƒ†ใƒ ่จญ่จˆ - -**่‡ชๅ‹•ใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ™ใƒผใ‚ทใƒงใƒณ**: - -- ใ‚ญใƒผใƒฏใƒผใƒ‰: ใ€ŒAPIใ€ใ€ใ€Œใƒใƒƒใ‚ฏใ‚จใƒณใƒ‰ใ€ใ€ใ€Œใ‚ตใƒผใƒใƒผใ€ใ€ใ€Œใƒ‡ใƒผใ‚ฟใƒ™ใƒผใ‚นใ€ใ€ใ€ŒRESTใ€ใ€ใ€ŒGraphQLใ€ใ€ใ€Œใ‚จใƒณใƒ‰ใƒใ‚คใƒณใƒˆใ€ -- ใƒ•ใ‚กใ‚คใƒซใ‚ฟใ‚คใƒ—: APIไป•ๆง˜ใ€ใ‚ตใƒผใƒใƒผๆง‹ๆˆใ€ใƒ‡ใƒผใ‚ฟใƒ™ใƒผใ‚นใ‚นใ‚ญใƒผใƒž -- ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆ: ใ‚ตใƒผใƒใƒผใ‚ตใ‚คใƒ‰ใƒญใ‚ธใƒƒใ‚ฏใ€ใƒ‡ใƒผใ‚ฟใฎๆฐธ็ถšๆ€งใ€API้–‹็™บ - -**ๆฉŸ่ƒฝ**: - -- RESTful ใŠใ‚ˆใณ GraphQL API ใฎใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃใจ่จญ่จˆใƒ‘ใ‚ฟใƒผใƒณ -- ใƒ‡ใƒผใ‚ฟใƒ™ใƒผใ‚นใ‚นใ‚ญใƒผใƒž่จญ่จˆใจใ‚ฏใ‚จใƒชๆœ€้ฉๅŒ–ๆˆฆ็•ฅ -- ่ช่จผใ€ๆ‰ฟ่ชใ€ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃใฎๅฎŸ่ฃ… -- ใ‚จใƒฉใƒผๅ‡ฆ็†ใ€ใƒญใ‚ฐ่จ˜้Œฒใ€็›ฃ่ฆ–ใฎ็ตฑๅˆ -- ใ‚ญใƒฃใƒƒใ‚ทใƒฅๆˆฆ็•ฅใจใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใฎๆœ€้ฉๅŒ– - -**ไพ‹**: - -1. **ใƒฆใƒผใ‚ถใƒผ็ฎก็† API**ย : ใƒญใƒผใƒซใƒ™ใƒผใ‚นใฎใ‚ขใ‚ฏใ‚ปใ‚นๅˆถๅพกใจใƒฌใƒผใƒˆๅˆถ้™ใ‚’ๅ‚™ใˆใŸ JWT ่ช่จผ -2. **ๆ”ฏๆ‰•ใ„ๅ‡ฆ็†**: ในใ็ญ‰ๆ€งใจ็›ฃๆŸป่จผ่ทกใ‚’ๅ‚™ใˆใŸ PCI ๆบ–ๆ‹ ใฎใƒˆใƒฉใƒณใ‚ถใ‚ฏใ‚ทใƒงใƒณๅ‡ฆ็† -3. **ใ‚ณใƒณใƒ†ใƒณใƒ„็ฎก็†**: ใ‚ญใƒฃใƒƒใ‚ทใƒฅใ€ใƒšใƒผใ‚ธใƒใƒผใ‚ทใƒงใƒณใ€ใƒชใ‚ขใƒซใ‚ฟใ‚คใƒ ้€š็Ÿฅใ‚’ๅ‚™ใˆใŸ RESTful API - -**ๆœ€้ฉใช็ต„ใฟๅˆใ‚ใ›**: security-engineer (่ช่จผ/ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃ)ใ€performance-engineer (ๆœ€้ฉๅŒ–)ใ€quality-engineer (ใƒ†ใ‚นใƒˆ) - ---- - -### ใƒ•ใƒญใƒณใƒˆใ‚จใƒณใƒ‰ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆ ๐ŸŽจ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#frontend-architect-) - -**ๅฐ‚้–€ๅˆ†้‡Ž**: ใ‚ขใ‚ฏใ‚ปใ‚ทใƒ“ใƒชใƒ†ใ‚ฃใจใƒฆใƒผใ‚ถใƒผใ‚จใ‚ฏใ‚นใƒšใƒชใ‚จใƒณใ‚นใ‚’้‡่ฆ–ใ—ใŸๆœ€ๆ–ฐใฎ Web ใ‚ขใƒ—ใƒชใ‚ฑใƒผใ‚ทใƒงใƒณ ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃ - -**่‡ชๅ‹•ใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ™ใƒผใ‚ทใƒงใƒณ**: - -- ใ‚ญใƒผใƒฏใƒผใƒ‰: ใ€ŒUIใ€ใ€ใ€Œใƒ•ใƒญใƒณใƒˆใ‚จใƒณใƒ‰ใ€ใ€ใ€ŒReactใ€ใ€ใ€ŒVueใ€ใ€ใ€ŒAngularใ€ใ€ใ€Œใ‚ณใƒณใƒใƒผใƒใƒณใƒˆใ€ใ€ใ€Œใ‚ขใ‚ฏใ‚ปใ‚ทใƒ“ใƒชใƒ†ใ‚ฃใ€ใ€ใ€Œใƒฌใ‚นใƒใƒณใ‚ทใƒ–ใ€ -- ใƒ•ใ‚กใ‚คใƒซใ‚ฟใ‚คใƒ—: .jsxใ€.vueใ€.ts (ใƒ•ใƒญใƒณใƒˆใ‚จใƒณใƒ‰)ใ€.cssใ€.scss -- ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆ: ใƒฆใƒผใ‚ถใƒผใ‚คใƒณใ‚ฟใƒผใƒ•ใ‚งใƒผใ‚น้–‹็™บใ€ใ‚ณใƒณใƒใƒผใƒใƒณใƒˆ่จญ่จˆใ€ใ‚ฏใƒฉใ‚คใ‚ขใƒณใƒˆๅดใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃ - -**ๆฉŸ่ƒฝ**: - -- ใ‚ณใƒณใƒใƒผใƒใƒณใƒˆใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃใจ่จญ่จˆใ‚ทใ‚นใƒ†ใƒ ใฎๅฎŸ่ฃ… -- ็Šถๆ…‹็ฎก็†ใƒ‘ใ‚ฟใƒผใƒณ (Reduxใ€Zustandใ€Pinia) -- ใ‚ขใ‚ฏใ‚ปใ‚ทใƒ“ใƒชใƒ†ใ‚ฃๆบ–ๆ‹ ๏ผˆWCAG 2.1๏ผ‰ใจใ‚คใƒณใ‚ฏใƒซใƒผใ‚ทใƒ–ใƒ‡ใ‚ถใ‚คใƒณ -- ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใฎๆœ€้ฉๅŒ–ใจใƒใƒณใƒ‰ใƒซๅˆ†ๆž -- ใƒ—ใƒญใ‚ฐใƒฌใƒƒใ‚ทใƒ–ใ‚ฆใ‚งใƒ–ใ‚ขใƒ—ใƒชใจใƒขใƒใ‚คใƒซใƒ•ใ‚กใƒผใ‚นใƒˆ้–‹็™บ - -**ไพ‹**: - -1. **ใƒ€ใƒƒใ‚ทใƒฅใƒœใƒผใƒ‰ใ‚คใƒณใ‚ฟใƒผใƒ•ใ‚งใƒผใ‚น**: ใƒชใ‚ขใƒซใ‚ฟใ‚คใƒ ๆ›ดๆ–ฐใจใƒฌใ‚นใƒใƒณใ‚ทใƒ–ใชใ‚ฐใƒชใƒƒใƒ‰ใƒฌใ‚คใ‚ขใ‚ฆใƒˆใซใ‚ˆใ‚‹ใ‚ขใ‚ฏใ‚ปใ‚นใ—ใ‚„ใ™ใ„ใƒ‡ใƒผใ‚ฟ่ฆ–่ฆšๅŒ– -2. **ใƒ•ใ‚ฉใƒผใƒ  ใ‚ทใ‚นใƒ†ใƒ **: ๆคœ่จผใ€ใ‚จใƒฉใƒผๅ‡ฆ็†ใ€ใ‚ขใ‚ฏใ‚ปใ‚ทใƒ“ใƒชใƒ†ใ‚ฃๆฉŸ่ƒฝใ‚’ๅ‚™ใˆใŸ่ค‡้›‘ใชใƒžใƒซใƒใ‚นใƒ†ใƒƒใƒ— ใƒ•ใ‚ฉใƒผใƒ  -3. **ใƒ‡ใ‚ถใ‚คใƒณใ‚ทใ‚นใƒ†ใƒ **: ไธ€่ฒซใ—ใŸใ‚นใ‚ฟใ‚คใƒซใจใ‚คใƒณใ‚ฟใƒฉใ‚ฏใ‚ทใƒงใƒณใƒ‘ใ‚ฟใƒผใƒณใ‚’ๅ‚™ใˆใŸๅ†ๅˆฉ็”จๅฏ่ƒฝใชใ‚ณใƒณใƒใƒผใƒใƒณใƒˆใƒฉใ‚คใƒ–ใƒฉใƒช - -**ๆœ€้ฉใช็ต„ใฟๅˆใ‚ใ›**: ๅญฆ็ฟ’ใ‚ฌใ‚คใƒ‰ (ใƒฆใƒผใ‚ถใƒผ ใ‚ฌใ‚คใƒ€ใƒณใ‚น)ใ€ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚น ใ‚จใƒณใ‚ธใƒ‹ใ‚ข (ๆœ€้ฉๅŒ–)ใ€ๅ“่ณชใ‚จใƒณใ‚ธใƒ‹ใ‚ข (ใƒ†ใ‚นใƒˆ) - ---- - -### DevOps ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆ ๐Ÿš€ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#devops-architect-) - -**ๅฐ‚้–€ๅˆ†้‡Ž**: ไฟก้ ผๆ€งใฎ้ซ˜ใ„ใ‚ฝใƒ•ใƒˆใ‚ฆใ‚งใ‚ข้…ไฟกใฎใŸใ‚ใฎใ‚คใƒณใƒ•ใƒฉใ‚นใƒˆใƒฉใ‚ฏใƒใƒฃ่‡ชๅ‹•ๅŒ–ใจๅฑ•้–‹ใƒ‘ใ‚คใƒ—ใƒฉใ‚คใƒณ่จญ่จˆ - -**่‡ชๅ‹•ใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ™ใƒผใ‚ทใƒงใƒณ**: - -- ใ‚ญใƒผใƒฏใƒผใƒ‰: ใ€Œใƒ‡ใƒ—ใƒญใ‚คใ€ใ€ใ€ŒCI/CDใ€ใ€ใ€ŒDockerใ€ใ€ใ€ŒKubernetesใ€ใ€ใ€Œใ‚คใƒณใƒ•ใƒฉใ‚นใƒˆใƒฉใ‚ฏใƒใƒฃใ€ใ€ใ€Œ็›ฃ่ฆ–ใ€ใ€ใ€Œใƒ‘ใ‚คใƒ—ใƒฉใ‚คใƒณใ€ -- ใƒ•ใ‚กใ‚คใƒซใ‚ฟใ‚คใƒ—: Dockerfileใ€docker-compose.ymlใ€k8s ใƒžใƒ‹ใƒ•ใ‚งใ‚นใƒˆใ€CI ๆง‹ๆˆ -- ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆ: ๅฐŽๅ…ฅใƒ—ใƒญใ‚ปใ‚นใ€ใ‚คใƒณใƒ•ใƒฉใ‚นใƒˆใƒฉใ‚ฏใƒใƒฃ็ฎก็†ใ€่‡ชๅ‹•ๅŒ– - -**ๆฉŸ่ƒฝ**: - -- ่‡ชๅ‹•ใƒ†ใ‚นใƒˆใจใƒ‡ใƒ—ใƒญใ‚คใƒกใƒณใƒˆใ‚’ๅ‚™ใˆใŸ CI/CD ใƒ‘ใ‚คใƒ—ใƒฉใ‚คใƒณ่จญ่จˆ -- ใ‚ณใƒณใƒ†ใƒŠใ‚ชใƒผใ‚ฑใ‚นใƒˆใƒฌใƒผใ‚ทใƒงใƒณใจKubernetesใ‚ฏใƒฉใ‚นใ‚ฟ็ฎก็† -- Terraform ใจใ‚ฏใƒฉใ‚ฆใƒ‰ ใƒ—ใƒฉใƒƒใƒˆใƒ•ใ‚ฉใƒผใƒ ใ‚’ไฝฟ็”จใ—ใŸ Infrastructure as Code -- ็›ฃ่ฆ–ใ€ใƒญใ‚ฐ่จ˜้Œฒใ€ใŠใ‚ˆใณๅฏ่ฆณๆธฌๆ€งใ‚นใ‚ฟใƒƒใ‚ฏใฎๅฎŸ่ฃ… -- ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃใ‚นใ‚ญใƒฃใƒณใจใ‚ณใƒณใƒ—ใƒฉใ‚คใ‚ขใƒณใ‚นใฎ่‡ชๅ‹•ๅŒ– - -**ไพ‹**: - -1. **ใƒžใ‚คใ‚ฏใƒญใ‚ตใƒผใƒ“ใ‚นใฎใƒ‡ใƒ—ใƒญใ‚คใƒกใƒณใƒˆ**: ใ‚ตใƒผใƒ“ใ‚นใƒกใƒƒใ‚ทใƒฅใ€่‡ชๅ‹•ใ‚นใ‚ฑใƒผใƒชใƒณใ‚ฐใ€ใƒ–ใƒซใƒผใ‚ฐใƒชใƒผใƒณใƒชใƒชใƒผใ‚นใ‚’ๅ‚™ใˆใŸ Kubernetes ใฎใƒ‡ใƒ—ใƒญใ‚คใƒกใƒณใƒˆ -2. **ใƒžใƒซใƒ็’ฐๅขƒใƒ‘ใ‚คใƒ—ใƒฉใ‚คใƒณ**: ่‡ชๅ‹•ใƒ†ใ‚นใƒˆใ€ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃใ‚นใ‚ญใƒฃใƒณใ€ๆฎต้šŽ็š„ใชใƒ‡ใƒ—ใƒญใ‚คใƒกใƒณใƒˆใ‚’ๅ‚™ใˆใŸ GitOps ใƒฏใƒผใ‚ฏใƒ•ใƒญใƒผ -3. **ใƒขใƒ‹ใ‚ฟใƒชใƒณใ‚ฐใ‚นใ‚ฟใƒƒใ‚ฏ**: ใƒกใƒˆใƒชใƒƒใ‚ฏใ€ใƒญใ‚ฐใ€ใƒˆใƒฌใƒผใ‚นใ€ใ‚ขใƒฉใƒผใƒˆใ‚ทใ‚นใƒ†ใƒ ใซใ‚ˆใ‚‹ๅŒ…ๆ‹ฌ็š„ใช็›ฃ่ฆ– - -**ๆœ€้ฉใช่ท็จฎ**: ใ‚ทใ‚นใƒ†ใƒ  ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆ (ใ‚คใƒณใƒ•ใƒฉใ‚นใƒˆใƒฉใ‚ฏใƒใƒฃ่จˆ็”ป)ใ€ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃ ใ‚จใƒณใ‚ธใƒ‹ใ‚ข (ใ‚ณใƒณใƒ—ใƒฉใ‚คใ‚ขใƒณใ‚น)ใ€ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚น ใ‚จใƒณใ‚ธใƒ‹ใ‚ข (็›ฃ่ฆ–) - -### ๅ“่ณชใƒปๅˆ†ๆžใ‚จใƒผใ‚ธใ‚งใƒณใƒˆ ๐Ÿ” - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#quality--analysis-agents-) - -### ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃใ‚จใƒณใ‚ธใƒ‹ใ‚ข ๐Ÿ”’ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#security-engineer-) - -**ๅฐ‚้–€ๅˆ†้‡Ž**: ่„…ๅจใƒขใƒ‡ใƒชใƒณใ‚ฐใจ่„†ๅผฑๆ€ง้˜ฒๆญขใซ้‡็‚นใ‚’็ฝฎใ„ใŸใ‚ขใƒ—ใƒชใ‚ฑใƒผใ‚ทใƒงใƒณ ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃ ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃ - -**่‡ชๅ‹•ใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ™ใƒผใ‚ทใƒงใƒณ**: - -- ใ‚ญใƒผใƒฏใƒผใƒ‰: ใ€Œใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃใ€ใ€ใ€Œ่ช่จผใ€ใ€ใ€Œ่„†ๅผฑๆ€งใ€ใ€ใ€Œๆš—ๅทๅŒ–ใ€ใ€ใ€Œใ‚ณใƒณใƒ—ใƒฉใ‚คใ‚ขใƒณใ‚นใ€ใ€ใ€ŒOWASPใ€ -- ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆ: ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃใƒฌใƒ“ใƒฅใƒผใ€่ช่จผใƒ•ใƒญใƒผใ€ใƒ‡ใƒผใ‚ฟไฟ่ญท่ฆไปถ -- ใƒชใ‚นใ‚ฏๆŒ‡ๆจ™: ๆ”ฏๆ‰•ใ„ๅ‡ฆ็†ใ€ใƒฆใƒผใ‚ถใƒผใƒ‡ใƒผใ‚ฟใ€API ใ‚ขใ‚ฏใ‚ปใ‚นใ€่ฆๅˆถ้ตๅฎˆใฎๅฟ…่ฆๆ€ง - -**ๆฉŸ่ƒฝ**: - -- ่„…ๅจใƒขใƒ‡ใƒซใจๆ”ปๆ’ƒๅฏพ่ฑก้ ˜ๅŸŸๅˆ†ๆž -- ๅฎ‰ๅ…จใช่ช่จผใจ่ชๅฏใฎ่จญ่จˆ (OAuthใ€JWTใ€SAML) -- ใƒ‡ใƒผใ‚ฟๆš—ๅทๅŒ–ๆˆฆ็•ฅใจ้ต็ฎก็† -- ่„†ๅผฑๆ€ง่ฉ•ไพกใจไพตๅ…ฅใƒ†ใ‚นใƒˆใฎใ‚ฌใ‚คใƒ€ใƒณใ‚น -- ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃใ‚ณใƒณใƒ—ใƒฉใ‚คใ‚ขใƒณใ‚น๏ผˆGDPRใ€HIPAAใ€PCI-DSS๏ผ‰ใฎๅฎŸ่ฃ… - -**ไพ‹**: - -1. **OAuth ๅฎŸ่ฃ…**: ใƒˆใƒผใ‚ฏใƒณใฎๆ›ดๆ–ฐใจใƒญใƒผใƒซใƒ™ใƒผใ‚นใฎใ‚ขใ‚ฏใ‚ปใ‚นใซใ‚ˆใ‚‹ๅฎ‰ๅ…จใชใƒžใƒซใƒใƒ†ใƒŠใƒณใƒˆ่ช่จผ -2. **API ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃ**: ใƒฌใƒผใƒˆๅˆถ้™ใ€ๅ…ฅๅŠ›ๆคœ่จผใ€SQL ใ‚คใƒณใ‚ธใ‚งใ‚ฏใ‚ทใƒงใƒณ้˜ฒๆญขใ€ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃ ใƒ˜ใƒƒใƒ€ใƒผ -3. **ใƒ‡ใƒผใ‚ฟไฟ่ญท**: ไฟๅญ˜ๆ™‚/่ปข้€ๆ™‚ใฎๆš—ๅทๅŒ–ใ€ใ‚ญใƒผใƒญใƒผใƒ†ใƒผใ‚ทใƒงใƒณใ€ใƒ—ใƒฉใ‚คใƒใ‚ทใƒผใƒใ‚คใƒ‡ใ‚ถใ‚คใƒณใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃ - -**ๆœ€้ฉใชไบบๆ**: ใƒใƒƒใ‚ฏใ‚จใƒณใƒ‰ ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆ (API ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃ)ใ€ๅ“่ณชใ‚จใƒณใ‚ธใƒ‹ใ‚ข (ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃ ใƒ†ใ‚นใƒˆ)ใ€ๆ นๆœฌๅŽŸๅ› ใ‚ขใƒŠใƒชใ‚นใƒˆ (ใ‚คใƒณใ‚ทใƒ‡ใƒณใƒˆๅฏพๅฟœ) - ---- - -### ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใ‚จใƒณใ‚ธใƒ‹ใ‚ข โšก - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#performance-engineer-) - -**ๅฐ‚้–€ๅˆ†้‡Ž**๏ผšใ‚นใ‚ฑใƒผใƒฉใƒ“ใƒชใƒ†ใ‚ฃใจใƒชใ‚ฝใƒผใ‚นๅŠน็Ž‡ใ‚’้‡่ฆ–ใ—ใŸใ‚ทใ‚นใƒ†ใƒ ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใฎๆœ€้ฉๅŒ– - -**่‡ชๅ‹•ใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ™ใƒผใ‚ทใƒงใƒณ**: - -- ใ‚ญใƒผใƒฏใƒผใƒ‰: ใ€Œใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใ€ใ€ใ€Œ้…ใ„ใ€ใ€ใ€Œๆœ€้ฉๅŒ–ใ€ใ€ใ€Œใƒœใƒˆใƒซใƒใƒƒใ‚ฏใ€ใ€ใ€Œใƒฌใ‚คใƒ†ใƒณใ‚ทใ€ใ€ใ€Œใƒกใƒขใƒชใ€ใ€ใ€ŒCPUใ€ -- ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆ: ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใฎๅ•้กŒใ€ใ‚นใ‚ฑใƒผใƒฉใƒ“ใƒชใƒ†ใ‚ฃใฎๆ‡ธๅฟตใ€ใƒชใ‚ฝใƒผใ‚นใฎๅˆถ็ด„ -- ใƒกใƒˆใƒชใ‚ฏใ‚น: ๅฟœ็ญ”ๆ™‚้–“ >500 ใƒŸใƒช็ง’ใ€ใƒกใƒขใƒชไฝฟ็”จ้‡ใŒๅคšใ„ใ€ใ‚นใƒซใƒผใƒ—ใƒƒใƒˆใŒไฝŽใ„ - -**ๆฉŸ่ƒฝ**: - -- ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใƒ—ใƒญใƒ•ใ‚กใ‚คใƒชใƒณใ‚ฐใจใƒœใƒˆใƒซใƒใƒƒใ‚ฏใฎ็‰นๅฎš -- ใƒ‡ใƒผใ‚ฟใƒ™ใƒผใ‚นใ‚ฏใ‚จใƒชใฎๆœ€้ฉๅŒ–ใจใ‚คใƒณใƒ‡ใƒƒใ‚ฏใ‚นๆˆฆ็•ฅ -- ใ‚ญใƒฃใƒƒใ‚ทใƒฅๅฎŸ่ฃ…๏ผˆRedisใ€CDNใ€ใ‚ขใƒ—ใƒชใ‚ฑใƒผใ‚ทใƒงใƒณใƒฌใƒ™ใƒซ๏ผ‰ -- ่ฒ ่ทใƒ†ใ‚นใƒˆใจๅฎน้‡่จˆ็”ป -- ใƒกใƒขใƒช็ฎก็†ใจใƒชใ‚ฝใƒผใ‚นใฎๆœ€้ฉๅŒ– - -**ไพ‹**: - -1. **APIๆœ€้ฉๅŒ–**: ใ‚ญใƒฃใƒƒใ‚ทใƒฅใจใ‚ฏใ‚จใƒชใฎๆœ€้ฉๅŒ–ใซใ‚ˆใ‚Šใ€ๅฟœ็ญ”ๆ™‚้–“ใ‚’2็ง’ใ‹ใ‚‰200ใƒŸใƒช็ง’ใซ็Ÿญ็ธฎ -2. **ใƒ‡ใƒผใ‚ฟใƒ™ใƒผใ‚นใฎใ‚นใ‚ฑใƒผใƒชใƒณใ‚ฐ**: ใƒชใƒผใƒ‰ใƒฌใƒ—ใƒชใ‚ซใ€ๆŽฅ็ถšใƒ—ใƒผใƒซใ€ใ‚ฏใ‚จใƒช็ตๆžœใฎใ‚ญใƒฃใƒƒใ‚ทใƒฅใ‚’ๅฎŸ่ฃ…ใ™ใ‚‹ -3. **ใƒ•ใƒญใƒณใƒˆใ‚จใƒณใƒ‰ใฎใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚น**: ใƒใƒณใƒ‰ใƒซใฎๆœ€้ฉๅŒ–ใ€้…ๅปถ่ชญใฟ่พผใฟใ€ใŠใ‚ˆใณ CDN ๅฎŸ่ฃ…ใซใ‚ˆใ‚Šใ€่ชญใฟ่พผใฟๆ™‚้–“ใŒ 3 ็ง’ๆœชๆบ€ใซ็Ÿญ็ธฎใ•ใ‚Œใพใ™ใ€‚ - -**ๆœ€้ฉใช็ต„ใฟๅˆใ‚ใ›**: ใ‚ทใ‚นใƒ†ใƒ  ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆ (ใ‚นใ‚ฑใƒผใƒฉใƒ“ใƒชใƒ†ใ‚ฃ)ใ€DevOps ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆ (ใ‚คใƒณใƒ•ใƒฉใ‚นใƒˆใƒฉใ‚ฏใƒใƒฃ)ใ€ใƒซใƒผใƒˆๅŽŸๅ› ใ‚ขใƒŠใƒชใ‚นใƒˆ (ใƒ‡ใƒใƒƒใ‚ฐ) - ---- - -### ๆ นๆœฌๅŽŸๅ› ๅˆ†ๆž่€… ๐Ÿ” - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#root-cause-analyst-) - -**ๅฐ‚้–€ๅˆ†้‡Ž**๏ผš่จผๆ‹ ใซๅŸบใฅใๅˆ†ๆžใจไปฎ่ชฌๆคœๅฎšใ‚’็”จใ„ใŸไฝ“็ณป็š„ใชๅ•้กŒ่ชฟๆŸป - -**่‡ชๅ‹•ใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ™ใƒผใ‚ทใƒงใƒณ**: - -- ใ‚ญใƒผใƒฏใƒผใƒ‰: ใ€Œใƒใ‚ฐใ€ใ€ใ€Œๅ•้กŒใ€ใ€ใ€Œๅ•้กŒใ€ใ€ใ€Œใƒ‡ใƒใƒƒใ‚ฐใ€ใ€ใ€Œ่ชฟๆŸปใ€ใ€ใ€Œใƒˆใƒฉใƒ–ใƒซใ‚ทใƒฅใƒผใƒ†ใ‚ฃใƒณใ‚ฐใ€ใ€ใ€Œใ‚จใƒฉใƒผใ€ -- ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆ: ใ‚ทใ‚นใƒ†ใƒ ้šœๅฎณใ€ไบˆๆœŸใ—ใชใ„ๅ‹•ไฝœใ€่ค‡้›‘ใช่ค‡ๆ•ฐใ‚ณใƒณใƒใƒผใƒใƒณใƒˆใฎๅ•้กŒ -- ่ค‡้›‘ๆ€ง: ไฝ“็ณป็š„ใช่ชฟๆŸปใ‚’ๅฟ…่ฆใจใ™ใ‚‹ใ‚ทใ‚นใƒ†ใƒ ้–“ๅ•้กŒ - -**ๆฉŸ่ƒฝ**: - -- ไฝ“็ณป็š„ใชใƒ‡ใƒใƒƒใ‚ฐๆ–นๆณ•่ซ–ใจๆ นๆœฌๅŽŸๅ› ๅˆ†ๆž -- ใ‚ทใ‚นใƒ†ใƒ ้–“ใฎใ‚จใƒฉใƒผ็›ธ้–ขใจไพๅญ˜้–ขไฟ‚ใฎใƒžใƒƒใƒ”ใƒณใ‚ฐ -- ้šœๅฎณ่ชฟๆŸปใฎใŸใ‚ใฎใƒญใ‚ฐๅˆ†ๆžใจใƒ‘ใ‚ฟใƒผใƒณ่ช่ญ˜ -- ่ค‡้›‘ใชๅ•้กŒใซๅฏพใ™ใ‚‹ไปฎ่ชฌๅฝขๆˆใจๆคœ่จผ -- ใ‚คใƒณใ‚ทใƒ‡ใƒณใƒˆๅฏพๅฟœใจไบ‹ๅพŒๅˆ†ๆžๆ‰‹้ † - -**ไพ‹**: - -1. **ใƒ‡ใƒผใ‚ฟใƒ™ใƒผใ‚นๆŽฅ็ถš้šœๅฎณ**: ๆŽฅ็ถšใƒ—ใƒผใƒซใ€ใƒใƒƒใƒˆใƒฏใƒผใ‚ฏ ใ‚ฟใ‚คใƒ ใ‚ขใ‚ฆใƒˆใ€ใƒชใ‚ฝใƒผใ‚นๅˆถ้™ใซใ‚ใŸใ‚‹ๆ–ญ็ถš็š„ใช้šœๅฎณใ‚’ใƒˆใƒฌใƒผใ‚นใ—ใพใ™ใ€‚ -2. **ๆ”ฏๆ‰•ใ„ๅ‡ฆ็†ใ‚จใƒฉใƒผ**: APIใƒญใ‚ฐใ€ใƒ‡ใƒผใ‚ฟใƒ™ใƒผใ‚นใฎ็Šถๆ…‹ใ€ๅค–้ƒจใ‚ตใƒผใƒ“ใ‚นใฎๅฟœ็ญ”ใ‚’้€šใ˜ใฆใƒˆใƒฉใƒณใ‚ถใ‚ฏใ‚ทใƒงใƒณใฎๅคฑๆ•—ใ‚’่ชฟๆŸปใ—ใพใ™ใ€‚ -3. **ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใฎไฝŽไธ‹**: ใƒกใƒˆใƒชใ‚ฏใ‚นใฎ็›ธ้–ข้–ขไฟ‚ใ€ใƒชใ‚ฝใƒผใ‚นใฎไฝฟ็”จ็Šถๆณใ€ใ‚ณใƒผใƒ‰ใฎๅค‰ๆ›ดใ‚’้€šใ˜ใฆใ€ๆฎต้šŽ็š„ใช้€ŸๅบฆไฝŽไธ‹ใ‚’ๅˆ†ๆžใ—ใพใ™ใ€‚ - -**ๆœ€้ฉใชๆ‹…ๅฝ“่€…**: ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚น ใ‚จใƒณใ‚ธใƒ‹ใ‚ข (ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใฎๅ•้กŒ)ใ€ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃ ใ‚จใƒณใ‚ธใƒ‹ใ‚ข (ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃ ใ‚คใƒณใ‚ทใƒ‡ใƒณใƒˆ)ใ€ๅ“่ณชใ‚จใƒณใ‚ธใƒ‹ใ‚ข (ใƒ†ใ‚นใƒˆใฎๅคฑๆ•—) - ---- - -### ๅ“่ณชใ‚จใƒณใ‚ธใƒ‹ใ‚ข โœ… - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#quality-engineer-) - -**ๅฐ‚้–€ๅˆ†้‡Ž**:่‡ชๅ‹•ๅŒ–ใจใ‚ซใƒใƒฌใƒƒใ‚ธใซ้‡็‚นใ‚’็ฝฎใ„ใŸๅŒ…ๆ‹ฌ็š„ใชใƒ†ใ‚นใƒˆๆˆฆ็•ฅใจๅ“่ณชไฟ่จผ - -**่‡ชๅ‹•ใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ™ใƒผใ‚ทใƒงใƒณ**: - -- ใ‚ญใƒผใƒฏใƒผใƒ‰: ใ€Œใƒ†ใ‚นใƒˆใ€ใ€ใ€Œใƒ†ใ‚นใƒˆใ€ใ€ใ€Œๅ“่ณชใ€ใ€ใ€ŒQAใ€ใ€ใ€Œๆคœ่จผใ€ใ€ใ€Œใ‚ซใƒใƒฌใƒƒใ‚ธใ€ใ€ใ€Œ่‡ชๅ‹•ๅŒ–ใ€ -- ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆ: ใƒ†ใ‚นใƒˆ่จˆ็”ปใ€ๅ“่ณชใ‚ฒใƒผใƒˆใ€ๆคœ่จผ่ฆไปถ -- ๅ“่ณชใซ้–ขใ™ใ‚‹ๆ‡ธๅฟต: ใ‚ณใƒผใƒ‰ใ‚ซใƒใƒฌใƒƒใ‚ธ <80%ใ€ใƒ†ใ‚นใƒˆ่‡ชๅ‹•ๅŒ–ใฎๆฌ ๅฆ‚ใ€ๅ“่ณชใฎๅ•้กŒ - -**ๆฉŸ่ƒฝ**: - -- ใƒ†ใ‚นใƒˆๆˆฆ็•ฅ่จญ่จˆ๏ผˆใƒฆใƒ‹ใƒƒใƒˆใ€็ตฑๅˆใ€E2Eใ€ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใƒ†ใ‚นใƒˆ๏ผ‰ -- ใƒ†ใ‚นใƒˆ่‡ชๅ‹•ๅŒ–ใƒ•ใƒฌใƒผใƒ ใƒฏใƒผใ‚ฏใฎๅฎŸ่ฃ…ใจCI/CD็ตฑๅˆ -- ๅ“่ณชๆŒ‡ๆจ™ใฎๅฎš็พฉใจ็›ฃ่ฆ–๏ผˆใ‚ซใƒใƒฌใƒƒใ‚ธใ€ๆฌ ้™ฅ็Ž‡๏ผ‰ -- ใ‚จใƒƒใ‚ธใ‚ฑใƒผใ‚นใฎ็‰นๅฎšใจๅขƒ็•Œใƒ†ใ‚นใƒˆใฎใ‚ทใƒŠใƒชใ‚ช -- ใ‚ขใ‚ฏใ‚ปใ‚ทใƒ“ใƒชใƒ†ใ‚ฃใƒ†ใ‚นใƒˆใจใ‚ณใƒณใƒ—ใƒฉใ‚คใ‚ขใƒณใ‚นๆคœ่จผ - -**ไพ‹**: - -1. **Eใ‚ณใƒžใƒผใ‚นใƒ†ใ‚นใƒˆ**: ใƒฆใƒผใ‚ถใƒผใƒ•ใƒญใƒผใ€ๆ”ฏๆ‰•ใ„ๅ‡ฆ็†ใ€ๅœจๅบซ็ฎก็†ใ‚’็ถฒ็พ…ใ—ใŸๅŒ…ๆ‹ฌ็š„ใชใƒ†ใ‚นใƒˆใ‚นใ‚คใƒผใƒˆ -2. **API ใƒ†ใ‚นใƒˆ**: REST/GraphQL API ใฎ่‡ชๅ‹•ๅฅ‘็ด„ใƒ†ใ‚นใƒˆใ€่ฒ ่ทใƒ†ใ‚นใƒˆใ€ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃ ใƒ†ใ‚นใƒˆ -3. **ใ‚ขใ‚ฏใ‚ปใ‚ทใƒ“ใƒชใƒ†ใ‚ฃๆคœ่จผ**๏ผš่‡ชๅ‹•ใŠใ‚ˆใณๆ‰‹ๅ‹•ใฎใ‚ขใ‚ฏใ‚ปใ‚ทใƒ“ใƒชใƒ†ใ‚ฃ็›ฃๆŸปใซใ‚ˆใ‚‹ WCAG 2.1 ๆบ–ๆ‹ ใƒ†ใ‚นใƒˆ - -**ๆœ€้ฉใช่ท็จฎ**: ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃ ใ‚จใƒณใ‚ธใƒ‹ใ‚ข (ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃ ใƒ†ใ‚นใƒˆ)ใ€ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚น ใ‚จใƒณใ‚ธใƒ‹ใ‚ข (่ฒ ่ทใƒ†ใ‚นใƒˆ)ใ€ใƒ•ใƒญใƒณใƒˆใ‚จใƒณใƒ‰ ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆ (UI ใƒ†ใ‚นใƒˆ) - ---- - -### ใƒชใƒ•ใ‚กใ‚ฏใ‚ฟใƒชใƒณใ‚ฐใฎๅฐ‚้–€ๅฎถ ๐Ÿ”ง - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#refactoring-expert-) - -**ๅฐ‚้–€ๅˆ†้‡Ž**๏ผšไฝ“็ณป็š„ใชใƒชใƒ•ใ‚กใ‚ฏใ‚ฟใƒชใƒณใ‚ฐใจๆŠ€่ก“็š„่ฒ ๅ‚ต็ฎก็†ใซใ‚ˆใ‚‹ใ‚ณใƒผใƒ‰ๅ“่ณชใฎๆ”นๅ–„ - -**่‡ชๅ‹•ใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ™ใƒผใ‚ทใƒงใƒณ**: - -- ใ‚ญใƒผใƒฏใƒผใƒ‰: ใ€Œใƒชใƒ•ใ‚กใ‚ฏใ‚ฟใƒชใƒณใ‚ฐใ€ใ€ใ€Œใ‚ฏใƒชใƒผใƒณใ‚ณใƒผใƒ‰ใ€ใ€ใ€ŒๆŠ€่ก“็š„่ฒ ๅ‚ตใ€ใ€ใ€ŒSOLIDใ€ใ€ใ€Œไฟๅฎˆๆ€งใ€ใ€ใ€Œใ‚ณใƒผใƒ‰่‡ญใ€ -- ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆ: ใƒฌใ‚ฌใ‚ทใƒผใ‚ณใƒผใƒ‰ใฎๆ”นๅ–„ใ€ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃใฎๆ›ดๆ–ฐใ€ใ‚ณใƒผใƒ‰ๅ“่ณชใฎๅ•้กŒ -- ๅ“่ณชๆŒ‡ๆจ™: ่ค‡้›‘ๆ€งใŒ้ซ˜ใ„ใ€ใ‚ณใƒผใƒ‰ใฎ้‡่ค‡ใŒใ‚ใ‚‹ใ€ใƒ†ใ‚นใƒˆ็ฏ„ๅ›ฒใŒ็‹ญใ„ - -**ๆฉŸ่ƒฝ**: - -- SOLIDๅŽŸๅ‰‡ใฎ้ฉ็”จใจ่จญ่จˆใƒ‘ใ‚ฟใƒผใƒณใฎๅฎŸ่ฃ… -- ใ‚ณใƒผใƒ‰ใฎ่‡ญใ„ใฎ็‰นๅฎšใจไฝ“็ณป็š„ใชๆŽ’้™ค -- ใƒฌใ‚ฌใ‚ทใƒผใ‚ณใƒผใƒ‰ใฎ่ฟ‘ไปฃๅŒ–ๆˆฆ็•ฅใจ็งป่กŒ่จˆ็”ป -- ๆŠ€่ก“็š„่ฒ ๅ‚ตใฎ่ฉ•ไพกใจๅ„ชๅ…ˆ้ †ไฝไป˜ใ‘ใฎใƒ•ใƒฌใƒผใƒ ใƒฏใƒผใ‚ฏ -- ใ‚ณใƒผใƒ‰ๆง‹้€ ใฎๆ”นๅ–„ใจใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃใฎใƒชใƒ•ใ‚กใ‚ฏใ‚ฟใƒชใƒณใ‚ฐ - -**ไพ‹**: - -1. **ใƒฌใ‚ฌใ‚ทใƒผใƒขใƒ€ใƒŠใ‚คใ‚ผใƒผใ‚ทใƒงใƒณ**: ใƒ†ใ‚นใƒˆๅฎนๆ˜“ๆ€งใ‚’ๅ‘ไธŠใ•ใ›ใŸใƒขใƒŽใƒชใ‚ทใƒƒใ‚ฏใ‚ขใƒ—ใƒชใ‚ฑใƒผใ‚ทใƒงใƒณใ‚’ใƒขใ‚ธใƒฅใƒผใƒซๅž‹ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃใซๅค‰ๆ›ใ™ใ‚‹ -2. **ใƒ‡ใ‚ถใ‚คใƒณใƒ‘ใ‚ฟใƒผใƒณ**: ๆ”ฏๆ‰•ใ„ๅ‡ฆ็†ใซๆˆฆ็•ฅใƒ‘ใ‚ฟใƒผใƒณใ‚’ๅฎŸ่ฃ…ใ—ใฆ็ตๅˆใ‚’ๆธ›ใ‚‰ใ—ใ€ๆ‹กๅผตๆ€งใ‚’ๅ‘ไธŠใ•ใ›ใ‚‹ -3. **ใ‚ณใƒผใƒ‰ใฎใ‚ฏใƒชใƒผใƒณใ‚ขใƒƒใƒ—**: ้‡่ค‡ใ—ใŸใ‚ณใƒผใƒ‰ใ‚’ๅ‰Š้™คใ—ใ€ๅ‘ฝๅ่ฆๅ‰‡ใ‚’ๆ”นๅ–„ใ—ใ€ๅ†ๅˆฉ็”จๅฏ่ƒฝใชใ‚ณใƒณใƒใƒผใƒใƒณใƒˆใ‚’ๆŠฝๅ‡บใ—ใพใ™ใ€‚ - -**ๆœ€้ฉใช็ต„ใฟๅˆใ‚ใ›**: system-architect (ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃใฎๆ”นๅ–„)ใ€quality-engineer (ใƒ†ใ‚นใƒˆๆˆฆ็•ฅ)ใ€python-expert (่จ€่ชžๅ›บๆœ‰ใฎใƒ‘ใ‚ฟใƒผใƒณ) - -### ๅฐ‚้–€้–‹็™บใ‚จใƒผใ‚ธใ‚งใƒณใƒˆ ๐ŸŽฏ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#specialized-development-agents-) - -### Python ใ‚จใ‚ญใ‚นใƒ‘ใƒผใƒˆ ๐Ÿ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#python-expert-) - -**ๅฐ‚้–€ๅˆ†้‡Ž**: ๆœ€ๆ–ฐใฎใƒ•ใƒฌใƒผใƒ ใƒฏใƒผใ‚ฏใจใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใ‚’้‡่ฆ–ใ—ใŸใ€ๆœฌ็•ช็’ฐๅขƒๅฏพๅฟœใฎ Python ้–‹็™บ - -**่‡ชๅ‹•ใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ™ใƒผใ‚ทใƒงใƒณ**: - -- ใ‚ญใƒผใƒฏใƒผใƒ‰: ใ€ŒPythonใ€ใ€ใ€ŒDjangoใ€ใ€ใ€ŒFastAPIใ€ใ€ใ€ŒFlaskใ€ใ€ใ€Œasyncioใ€ใ€ใ€Œpandasใ€ใ€ใ€Œpytestใ€ -- ใƒ•ใ‚กใ‚คใƒซใ‚ฟใ‚คใƒ—: .pyใ€requirements.txtใ€pyproject.tomlใ€Pipfile -- ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆ: Python ้–‹็™บใ‚ฟใ‚นใ‚ฏใ€API ้–‹็™บใ€ใƒ‡ใƒผใ‚ฟๅ‡ฆ็†ใ€ใƒ†ใ‚นใƒˆ - -**ๆฉŸ่ƒฝ**: - -- ๆœ€ๆ–ฐใฎPythonใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃใƒ‘ใ‚ฟใƒผใƒณใจใƒ•ใƒฌใƒผใƒ ใƒฏใƒผใ‚ฏใฎ้ธๆŠž -- asyncio ใจไธฆ่กŒๆœชๆฅใ‚’็”จใ„ใŸ้žๅŒๆœŸใƒ—ใƒญใ‚ฐใƒฉใƒŸใƒณใ‚ฐ -- ใƒ—ใƒญใƒ•ใ‚กใ‚คใƒชใƒณใ‚ฐใจใ‚ขใƒซใ‚ดใƒชใ‚บใƒ ใฎๆ”นๅ–„ใซใ‚ˆใ‚‹ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใฎๆœ€้ฉๅŒ– -- pytestใ€ใƒ•ใ‚ฃใ‚ฏใ‚นใƒใƒฃใ€ใƒ†ใ‚นใƒˆ่‡ชๅ‹•ๅŒ–ใซใ‚ˆใ‚‹ใƒ†ใ‚นใƒˆๆˆฆ็•ฅ -- pipใ€poetryใ€Docker ใ‚’ไฝฟ็”จใ—ใŸใƒ‘ใƒƒใ‚ฑใƒผใ‚ธ็ฎก็†ใจใƒ‡ใƒ—ใƒญใ‚คใƒกใƒณใƒˆ - -**ไพ‹**: - -1. **FastAPI ใƒžใ‚คใ‚ฏใƒญใ‚ตใƒผใƒ“ใ‚น**: Pydantic ๆคœ่จผใ€ไพๅญ˜ๆ€งๆณจๅ…ฅใ€OpenAPI ใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆใ‚’ๅ‚™ใˆใŸ้ซ˜ๆ€ง่ƒฝ้žๅŒๆœŸ API -2. **ใƒ‡ใƒผใ‚ฟ ใƒ‘ใ‚คใƒ—ใƒฉใ‚คใƒณ**: ใ‚จใƒฉใƒผๅ‡ฆ็†ใ€ใƒญใ‚ฐ่จ˜้Œฒใ€ๅคง่ฆๆจกใƒ‡ใƒผใ‚ฟใ‚ปใƒƒใƒˆใฎไธฆๅˆ—ๅ‡ฆ็†ใ‚’ๅ‚™ใˆใŸ Pandas ใƒ™ใƒผใ‚นใฎ ETL -3. **Django ใ‚ขใƒ—ใƒชใ‚ฑใƒผใ‚ทใƒงใƒณ**: ใ‚ซใ‚นใ‚ฟใƒ  ใƒฆใƒผใ‚ถใƒผ ใƒขใƒ‡ใƒซใ€API ใ‚จใƒณใƒ‰ใƒใ‚คใƒณใƒˆใ€ๅŒ…ๆ‹ฌ็š„ใชใƒ†ใ‚นใƒˆ ใ‚ซใƒใƒฌใƒƒใ‚ธใ‚’ๅ‚™ใˆใŸใƒ•ใƒซใ‚นใ‚ฟใƒƒใ‚ฏ Web ใ‚ขใƒ—ใƒช - -**ๆœ€้ฉใช่ท็จฎ**: ใƒใƒƒใ‚ฏใ‚จใƒณใƒ‰ ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆ (API ่จญ่จˆ)ใ€ๅ“่ณชใ‚จใƒณใ‚ธใƒ‹ใ‚ข (ใƒ†ใ‚นใƒˆ)ใ€ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚น ใ‚จใƒณใ‚ธใƒ‹ใ‚ข (ๆœ€้ฉๅŒ–) - ---- - -### ่ฆไปถใ‚ขใƒŠใƒชใ‚นใƒˆ ๐Ÿ“ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#requirements-analyst-) - -**ๅฐ‚้–€ๅˆ†้‡Ž**๏ผšไฝ“็ณป็š„ใชใ‚นใƒ†ใƒผใ‚ฏใƒ›ใƒซใƒ€ใƒผๅˆ†ๆžใซใ‚ˆใ‚‹่ฆไปถ็™บ่ฆ‹ใจไป•ๆง˜็ญ–ๅฎš - -**่‡ชๅ‹•ใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ™ใƒผใ‚ทใƒงใƒณ**: - -- ใ‚ญใƒผใƒฏใƒผใƒ‰: ใ€Œ่ฆไปถใ€ใ€ใ€Œไป•ๆง˜ใ€ใ€ใ€ŒPRDใ€ใ€ใ€Œใƒฆใƒผใ‚ถใƒผใ‚นใƒˆใƒผใƒชใƒผใ€ใ€ใ€ŒๆฉŸ่ƒฝใ€ใ€ใ€Œใ‚นใ‚ณใƒผใƒ—ใ€ใ€ใ€Œใ‚นใƒ†ใƒผใ‚ฏใƒ›ใƒซใƒ€ใƒผใ€ -- ่ƒŒๆ™ฏ: ใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใฎ้–‹ๅง‹ใ€ไธๆ˜Ž็ขบใช่ฆไปถใ€ใ‚นใ‚ณใƒผใƒ—ๅฎš็พฉใฎๅฟ…่ฆๆ€ง -- ่ค‡้›‘ใ•: ่ค‡ๆ•ฐใฎๅˆฉๅฎณ้–ขไฟ‚่€…ใŒ้–ขใ‚ใ‚‹ใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใ€ไธๆ˜Ž็ขบใช็›ฎๆจ™ใ€็›ธๅใ™ใ‚‹่ฆไปถ - -**ๆฉŸ่ƒฝ**: - -- ใ‚นใƒ†ใƒผใ‚ฏใƒ›ใƒซใƒ€ใƒผใธใฎใ‚คใƒณใ‚ฟใƒ“ใƒฅใƒผใ‚„ใƒฏใƒผใ‚ฏใ‚ทใƒงใƒƒใƒ—ใ‚’้€šใ˜ใŸ่ฆไปถๆŠฝๅ‡บ -- ๅ—ใ‘ๅ…ฅใ‚ŒๅŸบๆบ–ใจๅฎŒไบ†ใฎๅฎš็พฉใ‚’ๅซใ‚€ใƒฆใƒผใ‚ถใƒผใ‚นใƒˆใƒผใƒชใƒผใฎ่จ˜่ฟฐ -- ๆฉŸ่ƒฝไป•ๆง˜ใจ้žๆฉŸ่ƒฝไป•ๆง˜ใฎใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆ -- ใ‚นใƒ†ใƒผใ‚ฏใƒ›ใƒซใƒ€ใƒผๅˆ†ๆžใจ่ฆไปถๅ„ชๅ…ˆ้ †ไฝไป˜ใ‘ใƒ•ใƒฌใƒผใƒ ใƒฏใƒผใ‚ฏ -- ใ‚นใ‚ณใƒผใƒ—็ฎก็†ใจๅค‰ๆ›ด็ฎก็†ใƒ—ใƒญใ‚ปใ‚น - -**ไพ‹**: - -1. **่ฃฝๅ“่ฆไปถใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆ**: ใƒฆใƒผใ‚ถใƒผ ใƒšใƒซใ‚ฝใƒŠใ€ๆฉŸ่ƒฝไป•ๆง˜ใ€ๆˆๅŠŸๆŒ‡ๆจ™ใ‚’ๅซใ‚€ใ€ใƒ•ใ‚ฃใƒณใƒ†ใƒƒใ‚ฏ ใƒขใƒใ‚คใƒซ ใ‚ขใƒ—ใƒชใฎๅŒ…ๆ‹ฌ็š„ใช PRD -2. **APIไป•ๆง˜**: ใ‚จใƒฉใƒผๅ‡ฆ็†ใ€ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃใ€ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นๅŸบๆบ–ใ‚’ๅซใ‚€ๆ”ฏๆ‰•ใ„ๅ‡ฆ็†APIใฎ่ฉณ็ดฐใช่ฆไปถ -3. **็งป่กŒ่ฆไปถ**: ใƒ‡ใƒผใ‚ฟ็งป่กŒใ€ใƒฆใƒผใ‚ถใƒผใƒˆใƒฌใƒผใƒ‹ใƒณใ‚ฐใ€ใƒญใƒผใƒซใƒใƒƒใ‚ฏๆ‰‹้ †ใ‚’ๅซใ‚€ใƒฌใ‚ฌใ‚ทใƒผใ‚ทใ‚นใƒ†ใƒ ใฎ่ฟ‘ไปฃๅŒ–่ฆไปถ - -**ๆœ€้ฉใช็ต„ใฟๅˆใ‚ใ›**: ใ‚ทใ‚นใƒ†ใƒ ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆ (ๆŠ€่ก“็š„ๅฎŸ็พๅฏ่ƒฝๆ€ง)ใ€ใƒ†ใ‚ฏใƒ‹ใ‚ซใƒซใƒฉใ‚คใ‚ฟใƒผ (ใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆไฝœๆˆ)ใ€ๅญฆ็ฟ’ใ‚ฌใ‚คใƒ‰ (ใƒฆใƒผใ‚ถใƒผใ‚ฌใ‚คใƒ€ใƒณใ‚น) - -### ใ‚ณใƒŸใƒฅใƒ‹ใ‚ฑใƒผใ‚ทใƒงใƒณใจๅญฆ็ฟ’ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆ ๐Ÿ“š - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#communication--learning-agents-) - -### ใƒ†ใ‚ฏใƒ‹ใ‚ซใƒซใƒฉใ‚คใ‚ฟใƒผ ๐Ÿ“š - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#technical-writer-) - -**ๅฐ‚้–€ๅˆ†้‡Ž**: ่ฆ–่ด่€…ๅˆ†ๆžใจๆ˜Ž็ขบใ•ใ‚’้‡่ฆ–ใ—ใŸๆŠ€่ก“ๆ–‡ๆ›ธไฝœๆˆใจใ‚ณใƒŸใƒฅใƒ‹ใ‚ฑใƒผใ‚ทใƒงใƒณ - -**่‡ชๅ‹•ใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ™ใƒผใ‚ทใƒงใƒณ**: - -- ใ‚ญใƒผใƒฏใƒผใƒ‰: ใ€Œใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆใ€ใ€ใ€ŒReadmeใ€ใ€ใ€ŒAPI ใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆใ€ใ€ใ€Œใƒฆใƒผใ‚ถใƒผ ใ‚ฌใ‚คใƒ‰ใ€ใ€ใ€Œใƒ†ใ‚ฏใƒ‹ใ‚ซใƒซ ใƒฉใ‚คใƒ†ใ‚ฃใƒณใ‚ฐใ€ใ€ใ€Œใƒžใƒ‹ใƒฅใ‚ขใƒซใ€ -- ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆ: ใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆใฎใƒชใ‚ฏใ‚จใ‚นใƒˆใ€API ใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆใ€ใƒฆใƒผใ‚ถใƒผ ใ‚ฌใ‚คใƒ‰ใ€ๆŠ€่ก“็š„ใช่ชฌๆ˜Ž -- ใƒ•ใ‚กใ‚คใƒซใ‚ฟใ‚คใƒ—: .mdใ€.rstใ€API ไป•ๆง˜ใ€ใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆ ใƒ•ใ‚กใ‚คใƒซ - -**ๆฉŸ่ƒฝ**: - -- ๆŠ€่ก“ๆ–‡ๆ›ธใฎใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃใจๆƒ…ๅ ฑ่จญ่จˆ -- ใ•ใพใ–ใพใชใ‚นใ‚ญใƒซใƒฌใƒ™ใƒซใซๅˆใ‚ใ›ใŸใ‚ชใƒผใƒ‡ใ‚ฃใ‚จใƒณใ‚นๅˆ†ๆžใจใ‚ณใƒณใƒ†ใƒณใƒ„ใ‚ฟใƒผใ‚ฒใƒ†ใ‚ฃใƒณใ‚ฐ -- ๅ‹•ไฝœไพ‹ใจ็ตฑๅˆใ‚ฌใ‚คใƒ€ใƒณใ‚นใ‚’ๅซใ‚€ API ใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆ -- ใ‚นใƒ†ใƒƒใƒ—ใƒใ‚คใ‚นใƒ†ใƒƒใƒ—ใฎๆ‰‹้ †ใจใƒˆใƒฉใƒ–ใƒซใ‚ทใƒฅใƒผใƒ†ใ‚ฃใƒณใ‚ฐใ‚’่จ˜่ผ‰ใ—ใŸใƒฆใƒผใ‚ถใƒผใ‚ฌใ‚คใƒ‰ใฎไฝœๆˆ -- ใ‚ขใ‚ฏใ‚ปใ‚ทใƒ“ใƒชใƒ†ใ‚ฃๅŸบๆบ–ใฎ้ฉ็”จใจๅŒ…ๆ‹ฌ็š„ใช่จ€่ชžใฎไฝฟ็”จ - -**ไพ‹**: - -1. **APIใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆ**: ่ช่จผใ€ใ‚จใƒณใƒ‰ใƒใ‚คใƒณใƒˆใ€ไพ‹ใ€SDK็ตฑๅˆใ‚ฌใ‚คใƒ‰ใ‚’ๅซใ‚€ๅŒ…ๆ‹ฌ็š„ใชREST APIใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆ -2. **ใƒฆใƒผใ‚ถใƒผใƒžใƒ‹ใƒฅใ‚ขใƒซ**: ใ‚นใ‚ฏใƒชใƒผใƒณใ‚ทใƒงใƒƒใƒˆใ€ใƒˆใƒฉใƒ–ใƒซใ‚ทใƒฅใƒผใƒ†ใ‚ฃใƒณใ‚ฐใ€FAQใ‚ปใ‚ฏใ‚ทใƒงใƒณใ‚’ๅซใ‚€ใ‚นใƒ†ใƒƒใƒ—ใƒใ‚คใ‚นใƒ†ใƒƒใƒ—ใฎใ‚คใƒณใ‚นใƒˆใƒผใƒซใŠใ‚ˆใณๆง‹ๆˆใ‚ฌใ‚คใƒ‰ -3. **ๆŠ€่ก“ไป•ๆง˜**: ๅ›ณใ€ใƒ‡ใƒผใ‚ฟใƒ•ใƒญใƒผใ€ๅฎŸ่ฃ…ใฎ่ฉณ็ดฐใ‚’ๅซใ‚€ใ‚ทใ‚นใƒ†ใƒ ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆ - -**ๆœ€้ฉใช็ต„ใฟๅˆใ‚ใ›**: requirements-analyst (ไป•ๆง˜ใฎๆ˜Ž็ขบๅŒ–)ใ€learning-guide (ๆ•™่‚ฒใ‚ณใƒณใƒ†ใƒณใƒ„)ใ€frontend-architect (UI ใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆ) - ---- - -### ๅญฆ็ฟ’ใ‚ฌใ‚คใƒ‰ ๐ŸŽ“ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#learning-guide-) - -**ๅฐ‚้–€ๅˆ†้‡Ž**๏ผšใ‚นใ‚ญใƒซ้–‹็™บใจใƒกใƒณใ‚ฟใƒผใ‚ทใƒƒใƒ—ใซ้‡็‚นใ‚’็ฝฎใ„ใŸๆ•™่‚ฒใ‚ณใƒณใƒ†ใƒณใƒ„ใฎ่จญ่จˆใจๆผธ้€ฒ็š„ๅญฆ็ฟ’ - -**่‡ชๅ‹•ใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ™ใƒผใ‚ทใƒงใƒณ**: - -- ใ‚ญใƒผใƒฏใƒผใƒ‰: ใ€Œ่ชฌๆ˜Žใ€ใ€ใ€Œๅญฆ็ฟ’ใ€ใ€ใ€Œใƒใƒฅใƒผใƒˆใƒชใ‚ขใƒซใ€ใ€ใ€Œๅˆๅฟƒ่€…ใ€ใ€ใ€ŒๆŒ‡ๅฐŽใ€ใ€ใ€Œๆ•™่‚ฒใ€ใ€ใ€Œใƒˆใƒฌใƒผใƒ‹ใƒณใ‚ฐใ€ -- ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆ: ๆ•™่‚ฒ็š„ใชใƒชใ‚ฏใ‚จใ‚นใƒˆใ€ๆฆ‚ๅฟตใฎ่ชฌๆ˜Žใ€ใ‚นใ‚ญใƒซ้–‹็™บใ€ๅญฆ็ฟ’ใƒ‘ใ‚น -- ่ค‡้›‘ใ•: ๆฎต้šŽ็š„ใชๅˆ†่งฃใจๆฎต้šŽ็š„ใช็†่งฃใ‚’ๅฟ…่ฆใจใ™ใ‚‹่ค‡้›‘ใชใƒˆใƒ”ใƒƒใ‚ฏ - -**ๆฉŸ่ƒฝ**: - -- ๆฎต้šŽ็š„ใชใ‚นใ‚ญใƒซ้–‹็™บใ‚’ไผดใ†ๅญฆ็ฟ’ใƒ‘ใ‚นใฎ่จญ่จˆ -- ้กžๆŽจใจไพ‹ใซใ‚ˆใ‚‹่ค‡้›‘ใชๆฆ‚ๅฟตใฎ่ชฌๆ˜Ž -- ๅฎŸ่ทต็š„ใชๆผ”็ฟ’ใ‚’ๅซใ‚€ใ‚คใƒณใ‚ฟใƒฉใ‚ฏใƒ†ใ‚ฃใƒ–ใชใƒใƒฅใƒผใƒˆใƒชใ‚ขใƒซใฎไฝœๆˆ -- ใ‚นใ‚ญใƒซ่ฉ•ไพกใจ่ƒฝๅŠ›่ฉ•ไพกใฎใƒ•ใƒฌใƒผใƒ ใƒฏใƒผใ‚ฏ -- ใƒกใƒณใ‚ฟใƒผใ‚ทใƒƒใƒ—ๆˆฆ็•ฅใจๅ€‹ๅˆฅๅญฆ็ฟ’ใ‚ขใƒ—ใƒญใƒผใƒ - -**ไพ‹**: - -1. **ใƒ—ใƒญใ‚ฐใƒฉใƒŸใƒณใ‚ฐใƒใƒฅใƒผใƒˆใƒชใ‚ขใƒซ**: ๅฎŸ่ทต็š„ใชๆผ”็ฟ’ใ€ใ‚ณใƒผใƒ‰ไพ‹ใ€ๆฎต้šŽ็š„ใช่ค‡้›‘ใ•ใ‚’ๅ‚™ใˆใŸใ‚คใƒณใ‚ฟใƒฉใ‚ฏใƒ†ใ‚ฃใƒ–ใช React ใƒใƒฅใƒผใƒˆใƒชใ‚ขใƒซ -2. **ๆฆ‚ๅฟตใฎ่ชฌๆ˜Ž**: ่ฆ–่ฆš็š„ใชๅ›ณใจ็ทด็ฟ’ๅ•้กŒใ‚’ไฝฟใฃใŸๅฎŸ้š›ใฎไพ‹ใ‚’้€šใ—ใฆใƒ‡ใƒผใ‚ฟใƒ™ใƒผใ‚นใฎๆญฃ่ฆๅŒ–ใ‚’่ชฌๆ˜Žใ—ใพใ™ -3. **ใ‚นใ‚ญใƒซ่ฉ•ไพก**๏ผšๅฎŸ่ทต็š„ใชใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใจใƒ•ใ‚ฃใƒผใƒ‰ใƒใƒƒใ‚ฏใซใ‚ˆใ‚‹ใƒ•ใƒซใ‚นใ‚ฟใƒƒใ‚ฏ้–‹็™บใฎใŸใ‚ใฎๅŒ…ๆ‹ฌ็š„ใช่ฉ•ไพกใƒ•ใƒฌใƒผใƒ ใƒฏใƒผใ‚ฏ - -**ๆœ€้ฉใชๅฏพ่ฑก่€…**: ใƒ†ใ‚ฏใƒ‹ใ‚ซใƒซใƒฉใ‚คใ‚ฟใƒผ (ๆ•™่‚ฒใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆ)ใ€ใƒ•ใƒญใƒณใƒˆใ‚จใƒณใƒ‰ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆ (ใ‚คใƒณใ‚ฟใƒฉใ‚ฏใƒ†ใ‚ฃใƒ–ๅญฆ็ฟ’)ใ€่ฆไปถใ‚ขใƒŠใƒชใ‚นใƒˆ (ๅญฆ็ฟ’็›ฎๆจ™) - ---- - -## ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎ่ชฟๆ•ดใจ็ตฑๅˆ ๐Ÿค - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#agent-coordination--integration-) - -### ่ชฟๆ•ดใƒ‘ใ‚ฟใƒผใƒณ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#coordination-patterns) - -**ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃใƒใƒผใƒ **: - -- **ใƒ•ใƒซใ‚นใ‚ฟใƒƒใ‚ฏ้–‹็™บ**๏ผšใƒ•ใƒญใƒณใƒˆใ‚จใƒณใƒ‰ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆ + ใƒใƒƒใ‚ฏใ‚จใƒณใƒ‰ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆ + ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃใ‚จใƒณใ‚ธใƒ‹ใ‚ข + ๅ“่ณชใ‚จใƒณใ‚ธใƒ‹ใ‚ข -- **ใ‚ทใ‚นใƒ†ใƒ ่จญ่จˆ**: ใ‚ทใ‚นใƒ†ใƒ ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆ + DevOps ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆ + ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใ‚จใƒณใ‚ธใƒ‹ใ‚ข + ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃใ‚จใƒณใ‚ธใƒ‹ใ‚ข -- **ใƒฌใ‚ฌใ‚ทใƒผใƒขใƒ€ใƒŠใ‚คใ‚ผใƒผใ‚ทใƒงใƒณ**๏ผšใƒชใƒ•ใ‚กใ‚ฏใ‚ฟใƒชใƒณใ‚ฐๅฐ‚้–€ๅฎถ + ใ‚ทใ‚นใƒ†ใƒ ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆ + ๅ“่ณชใ‚จใƒณใ‚ธใƒ‹ใ‚ข + ใƒ†ใ‚ฏใƒ‹ใ‚ซใƒซใƒฉใ‚คใ‚ฟใƒผ - -**ๅ“่ณชใƒใƒผใƒ **: - -- **ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃ็›ฃๆŸป**: ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃใ‚จใƒณใ‚ธใƒ‹ใ‚ข + ๅ“่ณชใ‚จใƒณใ‚ธใƒ‹ใ‚ข + ๆ นๆœฌๅŽŸๅ› ใ‚ขใƒŠใƒชใ‚นใƒˆ + ่ฆไปถใ‚ขใƒŠใƒชใ‚นใƒˆ -- **ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นๆœ€้ฉๅŒ–**: ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใ‚จใƒณใ‚ธใƒ‹ใ‚ข + ใ‚ทใ‚นใƒ†ใƒ ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆ + DevOps ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆ + ๆ นๆœฌๅŽŸๅ› ใ‚ขใƒŠใƒชใ‚นใƒˆ -- **ใƒ†ใ‚นใƒˆๆˆฆ็•ฅ**: ๅ“่ณชใ‚จใƒณใ‚ธใƒ‹ใ‚ข + ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃใ‚จใƒณใ‚ธใƒ‹ใ‚ข + ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใ‚จใƒณใ‚ธใƒ‹ใ‚ข + ใƒ•ใƒญใƒณใƒˆใ‚จใƒณใƒ‰ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆ - -**ใ‚ณใƒŸใƒฅใƒ‹ใ‚ฑใƒผใ‚ทใƒงใƒณใƒใƒผใƒ **: - -- **ใƒ‰ใ‚ญใƒฅใƒกใƒณใƒ†ใƒผใ‚ทใƒงใƒณใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆ**: ใƒ†ใ‚ฏใƒ‹ใ‚ซใƒซใƒฉใ‚คใ‚ฟใƒผ + ่ฆไปถใ‚ขใƒŠใƒชใ‚นใƒˆ + ๅญฆ็ฟ’ใ‚ฌใ‚คใƒ‰ + ใƒ‰ใƒกใ‚คใƒณใ‚จใ‚ญใ‚นใƒ‘ใƒผใƒˆ -- **ๅญฆ็ฟ’ใƒ—ใƒฉใƒƒใƒˆใƒ•ใ‚ฉใƒผใƒ **: ๅญฆ็ฟ’ใ‚ฌใ‚คใƒ‰ + ใƒ•ใƒญใƒณใƒˆใ‚จใƒณใƒ‰ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆ + ใƒ†ใ‚ฏใƒ‹ใ‚ซใƒซใƒฉใ‚คใ‚ฟใƒผ + ๅ“่ณชใ‚จใƒณใ‚ธใƒ‹ใ‚ข -- **APIใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆ**: ใƒใƒƒใ‚ฏใ‚จใƒณใƒ‰ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆ + ใƒ†ใ‚ฏใƒ‹ใ‚ซใƒซใƒฉใ‚คใ‚ฟใƒผ + ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃใ‚จใƒณใ‚ธใƒ‹ใ‚ข + ๅ“่ณชใ‚จใƒณใ‚ธใƒ‹ใ‚ข - -### MCP ใ‚ตใƒผใƒใƒผ็ตฑๅˆ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#mcp-server-integration) - -**MCP ใ‚ตใƒผใƒใƒผใซใ‚ˆใ‚‹ๆ‹กๅผตๆฉŸ่ƒฝ**: - -- **ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆ7**ย : ใ™ในใฆใฎๅปบ็ฏ‰ๅฎถใจๅฐ‚้–€ๅฎถใฎใŸใ‚ใฎๅ…ฌๅผใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆใƒ‘ใ‚ฟใƒผใƒณ -- **ใ‚ทใƒผใ‚ฑใƒณใ‚ทใƒฃใƒซ**: ๆ นๆœฌๅŽŸๅ› ใ‚ขใƒŠใƒชใ‚นใƒˆใ€ใ‚ทใ‚นใƒ†ใƒ ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆใ€ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใ‚จใƒณใ‚ธใƒ‹ใ‚ขๅ‘ใ‘ใฎๅคšๆฎต้šŽๅˆ†ๆž -- **ใƒžใ‚ธใƒƒใ‚ฏ**๏ผšใƒ•ใƒญใƒณใƒˆใ‚จใƒณใƒ‰ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆใ€ๅญฆ็ฟ’ใ‚ฌใ‚คใƒ‰ใ‚คใƒณใ‚ฟใƒฉใ‚ฏใƒ†ใ‚ฃใƒ–ใ‚ณใƒณใƒ†ใƒณใƒ„ใฎใŸใ‚ใฎUI็”Ÿๆˆ -- **Playwright**ย : ๅ“่ณชใ‚จใƒณใ‚ธใƒ‹ใ‚ขๅ‘ใ‘ใฎใƒ–ใƒฉใ‚ฆใ‚ถใƒ†ใ‚นใƒˆใ€ใƒ•ใƒญใƒณใƒˆใ‚จใƒณใƒ‰ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆๅ‘ใ‘ใฎใ‚ขใ‚ฏใ‚ปใ‚ทใƒ“ใƒชใƒ†ใ‚ฃๆคœ่จผ -- **Morphllm**ย : refactoring-expert ใฎใ‚ณใƒผใƒ‰ๅค‰ๆ›ใ€python-expert ใฎไธ€ๆ‹ฌๅค‰ๆ›ด -- **Serena**ย : ใ™ในใฆใฎใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใƒกใƒขใƒชใ€ใ‚ปใƒƒใ‚ทใƒงใƒณ้–“ใฎใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆไฟๅญ˜ - -### ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ™ใƒผใ‚ทใƒงใƒณใฎใƒˆใƒฉใƒ–ใƒซใ‚ทใƒฅใƒผใƒ†ใ‚ฃใƒณใ‚ฐ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#troubleshooting-agent-activation) - -## ใƒˆใƒฉใƒ–ใƒซใ‚ทใƒฅใƒผใƒ†ใ‚ฃใƒณใ‚ฐ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#troubleshooting) - -ใƒˆใƒฉใƒ–ใƒซใ‚ทใƒฅใƒผใƒ†ใ‚ฃใƒณใ‚ฐใฎใƒ˜ใƒซใƒ—ใซใคใ„ใฆใฏใ€ไปฅไธ‹ใ‚’ๅ‚็…งใ—ใฆใใ ใ•ใ„ใ€‚ - -- [ใ‚ˆใใ‚ใ‚‹ๅ•้กŒ](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Reference/common-issues.md)- ใ‚ˆใใ‚ใ‚‹ๅ•้กŒใซๅฏพใ™ใ‚‹ใ‚ฏใ‚คใƒƒใ‚ฏไฟฎๆญฃ -- [ใƒˆใƒฉใƒ–ใƒซใ‚ทใƒฅใƒผใƒ†ใ‚ฃใƒณใ‚ฐใ‚ฌใ‚คใƒ‰](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Reference/troubleshooting.md)- ๅŒ…ๆ‹ฌ็š„ใชๅ•้กŒ่งฃๆฑบ - -### ใ‚ˆใใ‚ใ‚‹ๅ•้กŒ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#common-issues) - -- **ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ™ใƒผใ‚ทใƒงใƒณใชใ—**: ใƒ‰ใƒกใ‚คใƒณใ‚ญใƒผใƒฏใƒผใƒ‰ใ€Œใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃใ€ใ€ใ€Œใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใ€ใ€ใ€Œใƒ•ใƒญใƒณใƒˆใ‚จใƒณใƒ‰ใ€ใ‚’ไฝฟ็”จใ—ใพใ™ -- **้–“้•ใฃใŸใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใŒ้ธๆŠžใ•ใ‚Œใพใ—ใŸ**: ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆใงใƒˆใƒชใ‚ฌใƒผใ‚ญใƒผใƒฏใƒผใƒ‰ใ‚’็ขบ่ชใ—ใฆใใ ใ•ใ„ -- **ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใŒๅคšใ™ใŽใ‚‹ๅ ดๅˆ**๏ผšไธป่ฆใƒ‰ใƒกใ‚คใƒณใฎใ‚ญใƒผใƒฏใƒผใƒ‰ใซ็„ฆ็‚นใ‚’ๅฝ“ใฆใ‚‹ใ‹ใ€`/sc:focus [domain]` -- **ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใŒ้€ฃๆบใ—ใฆใ„ใชใ„**: ใ‚ฟใ‚นใ‚ฏใฎ่ค‡้›‘ใ•ใ‚’ๅข—ใ‚„ใ™ใ‹ใ€ใƒžใƒซใƒใƒ‰ใƒกใ‚คใƒณใ‚ญใƒผใƒฏใƒผใƒ‰ใ‚’ไฝฟ็”จใ™ใ‚‹ -- **ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎๅฐ‚้–€็Ÿฅ่ญ˜ใฎไธไธ€่‡ด**: ใ‚ˆใ‚Šๅ…ทไฝ“็š„ใชๆŠ€่ก“็”จ่ชžใ‚’ไฝฟ็”จใ™ใ‚‹ - -### ๅณๆ™‚ไฟฎๆญฃ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#immediate-fixes) - -- **ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎๅผทๅˆถใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ™ใƒผใ‚ทใƒงใƒณ**: ใƒชใ‚ฏใ‚จใ‚นใƒˆใงๆ˜Ž็คบ็š„ใชใƒ‰ใƒกใ‚คใƒณใ‚ญใƒผใƒฏใƒผใƒ‰ใ‚’ไฝฟ็”จใ™ใ‚‹ -- **ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎ้ธๆŠžใ‚’ใƒชใ‚ปใƒƒใƒˆ**: ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎ็Šถๆ…‹ใ‚’ใƒชใ‚ปใƒƒใƒˆใ™ใ‚‹ใซใฏใ€Claude Code ใ‚ปใƒƒใ‚ทใƒงใƒณใ‚’ๅ†่ตทๅ‹•ใ—ใพใ™ใ€‚ -- **ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎใƒ‘ใ‚ฟใƒผใƒณใ‚’็ขบ่ชใ™ใ‚‹**: ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆใงใƒˆใƒชใ‚ฌใƒผใ‚ญใƒผใƒฏใƒผใƒ‰ใ‚’็ขบ่ชใ™ใ‚‹ -- **ๅŸบๆœฌ็š„ใชใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ™ใƒผใ‚ทใƒงใƒณใ‚’ใƒ†ใ‚นใƒˆใ™ใ‚‹**:`/sc:implement "security auth"`ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃใ‚จใƒณใ‚ธใƒ‹ใ‚ขใฎใƒ†ใ‚นใƒˆใ‚’่ฉฆใฟใ‚‹ - -### ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆๅ›บๆœ‰ใฎใƒˆใƒฉใƒ–ใƒซใ‚ทใƒฅใƒผใƒ†ใ‚ฃใƒณใ‚ฐ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#agent-specific-troubleshooting) - -**ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใชใ—:** - -```shell -# Problem: Security concerns not triggering security-engineer -# Quick Fix: Use explicit security keywords -"implement authentication" # Generic - may not trigger -"implement JWT authentication security" # Explicit - triggers security-engineer -"secure user login with encryption" # Security focus - triggers security-engineer -``` - -**ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใชใ—:** - -```shell -# Problem: Performance issues not triggering performance-engineer -# Quick Fix: Use performance-specific terminology -"make it faster" # Vague - may not trigger -"optimize slow database queries" # Specific - triggers performance-engineer -"reduce API latency and bottlenecks" # Performance focus - triggers performance-engineer -``` - -**ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใชใ—:** - -```shell -# Problem: System design not triggering architecture agents -# Quick Fix: Use architectural keywords -"build an app" # Generic - triggers basic agents -"design microservices architecture" # Specific - triggers system-architect -"scalable distributed system design" # Architecture focus - triggers system-architect -``` - -**้–“้•ใฃใŸใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎ็ต„ใฟๅˆใ‚ใ›:** - -```shell -# Problem: Getting frontend agent for backend tasks -# Quick Fix: Use domain-specific terminology -"create user interface" # May trigger frontend-architect -"create REST API endpoints" # Specific - triggers backend-architect -"implement server-side authentication" # Backend focus - triggers backend-architect -``` - -### ใ‚ตใƒใƒผใƒˆใƒฌใƒ™ใƒซ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#support-levels) - -**ใ‚ฏใ‚คใƒƒใ‚ฏใƒ•ใ‚ฃใƒƒใ‚ฏใ‚น:** - -- ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใƒˆใƒชใ‚ฌใƒผใƒ†ใƒผใƒ–ใƒซใ‹ใ‚‰ๆ˜Ž็คบ็š„ใชใƒ‰ใƒกใ‚คใƒณใ‚ญใƒผใƒฏใƒผใƒ‰ใ‚’ไฝฟ็”จใ™ใ‚‹ -- Claude Codeใ‚ปใƒƒใ‚ทใƒงใƒณใ‚’ๅ†่ตทๅ‹•ใ—ใฆใฟใฆใใ ใ•ใ„ -- ๆททไนฑใ‚’้ฟใ‘ใ‚‹ใŸใ‚ใซๅ˜ไธ€ใฎใƒ‰ใƒกใ‚คใƒณใซ็„ฆ็‚นใ‚’ๅฝ“ใฆใ‚‹ - -**่ฉณ็ดฐใชใƒ˜ใƒซใƒ—:** - -- ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎใ‚คใƒณใ‚นใƒˆใƒผใƒซใซ้–ขใ™ใ‚‹ๅ•้กŒใซใคใ„ใฆใฏใ€[ไธ€่ˆฌ็š„ใชๅ•้กŒใ‚ฌใ‚คใƒ‰](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Reference/common-issues.md)ใ‚’ๅ‚็…งใ—ใฆใใ ใ•ใ„ใ€‚ -- ๅฏพ่ฑกใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎใƒˆใƒชใ‚ฌใƒผใ‚ญใƒผใƒฏใƒผใƒ‰ใ‚’็ขบ่ชใ™ใ‚‹ - -**ๅฐ‚้–€ๅฎถใซใ‚ˆใ‚‹ใ‚ตใƒใƒผใƒˆ:** - -- ไฝฟ็”จ`SuperClaude install --diagnose` -- ๅ”่ชฟๅˆ†ๆžใซใคใ„ใฆใฏ[่จบๆ–ญใƒชใƒ•ใ‚กใƒฌใƒณใ‚นใ‚ฌใ‚คใƒ‰](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Reference/diagnostic-reference.md)ใ‚’ๅ‚็…งใ—ใฆใใ ใ•ใ„ - -**ใ‚ณใƒŸใƒฅใƒ‹ใƒ†ใ‚ฃใ‚ตใƒใƒผใƒˆ:** - -- [GitHub Issues](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues)ใงๅ•้กŒใ‚’ๅ ฑๅ‘Šใ—ใฆใใ ใ•ใ„[](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues) -- ไบˆๆƒณใ•ใ‚Œใ‚‹ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ™ใƒผใ‚ทใƒงใƒณใจๅฎŸ้š›ใฎใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ™ใƒผใ‚ทใƒงใƒณใฎไพ‹ใ‚’ๅซใ‚ใ‚‹ - -### ๆˆๅŠŸใฎๆคœ่จผ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#success-validation) - -ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎไฟฎๆญฃใ‚’้ฉ็”จใ—ใŸๅพŒใ€ๆฌกใฎใ‚ˆใ†ใซใƒ†ใ‚นใƒˆใ—ใพใ™ใ€‚ - -- [ ] ใƒ‰ใƒกใ‚คใƒณๅ›บๆœ‰ใฎใƒชใ‚ฏใ‚จใ‚นใƒˆใฏ้ฉๅˆ‡ใชใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใ‚’ใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ–ๅŒ–ใ—ใพใ™๏ผˆใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃ โ†’ ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃ ใ‚จใƒณใ‚ธใƒ‹ใ‚ข๏ผ‰ -- [ ] ่ค‡้›‘ใชใ‚ฟใ‚นใ‚ฏใฏใƒžใƒซใƒใ‚จใƒผใ‚ธใ‚งใƒณใƒˆ่ชฟๆ•ด๏ผˆ3 ใคไปฅไธŠใฎใ‚จใƒผใ‚ธใ‚งใƒณใƒˆ๏ผ‰ใ‚’ใƒˆใƒชใ‚ฌใƒผใ—ใพใ™ -- [ ] ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎๅฐ‚้–€็Ÿฅ่ญ˜ใŒใ‚ฟใ‚นใ‚ฏ่ฆไปถใซไธ€่‡ดใ—ใฆใ„ใ‚‹๏ผˆAPI โ†’ ใƒใƒƒใ‚ฏใ‚จใƒณใƒ‰ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆ๏ผ‰ -- [ ] ้ฉๅˆ‡ใชๅ ดๅˆใซๅ“่ณชใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใŒ่‡ชๅ‹•็š„ใซๅซใ‚ใ‚‰ใ‚Œใพใ™๏ผˆใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃใ€ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใ€ใƒ†ใ‚นใƒˆ๏ผ‰ -- [ ] ๅ›ž็ญ”ใฏใƒ‰ใƒกใ‚คใƒณใฎๅฐ‚้–€็Ÿฅ่ญ˜ใจๅฐ‚้–€็Ÿฅ่ญ˜ใ‚’็คบใ™ - -## ใ‚ฏใ‚คใƒƒใ‚ฏใƒˆใƒฉใƒ–ใƒซใ‚ทใƒฅใƒผใƒ†ใ‚ฃใƒณใ‚ฐ๏ผˆใƒฌใ‚ฌใ‚ทใƒผ๏ผ‰ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#quick-troubleshooting-legacy) - -- **ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใŒๆœ‰ๅŠนๅŒ–ใ•ใ‚Œใฆใ„ใชใ„ๅ ดๅˆ**โ†’ ใƒ‰ใƒกใ‚คใƒณใ‚ญใƒผใƒฏใƒผใƒ‰ใ€Œใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃใ€ใ€ใ€Œใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใ€ใ€ใ€Œใƒ•ใƒญใƒณใƒˆใ‚จใƒณใƒ‰ใ€ใ‚’ไฝฟ็”จใ—ใพใ™ -- **ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใŒ้–“้•ใฃใฆใ„ใ‚‹**โ†’ ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆใงใƒˆใƒชใ‚ฌใƒผใ‚ญใƒผใƒฏใƒผใƒ‰ใ‚’็ขบ่ชใ—ใฆใใ ใ•ใ„ -- **ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใŒๅคšใ™ใŽใ‚‹**โ†’ ไธป่ฆใƒ‰ใƒกใ‚คใƒณใฎใ‚ญใƒผใƒฏใƒผใƒ‰ใซ็„ฆ็‚นใ‚’็ตžใ‚‹ -- **ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใŒ้€ฃๆบใ—ใฆใ„ใชใ„**โ†’ ใ‚ฟใ‚นใ‚ฏใฎ่ค‡้›‘ใ•ใ‚’ๅข—ใ‚„ใ™ใ‹ใ€ใƒžใƒซใƒใƒ‰ใƒกใ‚คใƒณใ‚ญใƒผใƒฏใƒผใƒ‰ใ‚’ไฝฟ็”จใ™ใ‚‹ - -**ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใŒใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ–ๅŒ–ใ•ใ‚Œใชใ„?** - -1. **ใ‚ญใƒผใƒฏใƒผใƒ‰ใ‚’็ขบ่ชใ™ใ‚‹**: ใƒ‰ใƒกใ‚คใƒณๅ›บๆœ‰ใฎ็”จ่ชžใ‚’ไฝฟ็”จใ™ใ‚‹ (ไพ‹: ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃ ใ‚จใƒณใ‚ธใƒ‹ใ‚ขใฎๅ ดๅˆใฏใ€Œใƒญใ‚ฐใ‚คใƒณใ€ใงใฏใชใใ€Œ่ช่จผใ€) -2. **ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆใ‚’่ฟฝๅŠ **: ใƒ•ใ‚กใ‚คใƒซใฎ็จฎ้กžใ€ใƒ•ใƒฌใƒผใƒ ใƒฏใƒผใ‚ฏใ€ใพใŸใฏ็‰นๅฎšใฎใƒ†ใ‚ฏใƒŽใƒญใ‚ธใƒผใ‚’ๅซใ‚ใ‚‹ -3. **่ค‡้›‘ใ•ใฎๅข—ๅคง**๏ผšใƒžใƒซใƒใƒ‰ใƒกใ‚คใƒณใฎๅ•้กŒใฏใ‚ˆใ‚Šๅคšใใฎใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใ‚’ใƒˆใƒชใ‚ฌใƒผใ—ใพใ™ -4. **ไฝฟ็”จไพ‹**: ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎๅฐ‚้–€็Ÿฅ่ญ˜ใซๅˆใฃใŸๅ…ทไฝ“็š„ใชใ‚ทใƒŠใƒชใ‚ชใ‚’ๅ‚็…งใ™ใ‚‹ - -**ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใŒๅคšใ™ใŽใพใ™ใ‹?** - -- ไธป่ฆใชใƒ‰ใƒกใ‚คใƒณใฎใƒ‹ใƒผใ‚บใซใ‚ญใƒผใƒฏใƒผใƒ‰ใ‚’้›†ไธญใ•ใ›ใ‚‹ -- `/sc:focus [domain]`็ฏ„ๅ›ฒใ‚’ๅˆถ้™ใ™ใ‚‹ใŸใ‚ใซไฝฟ็”จใ™ใ‚‹ -- ็‰นๅฎšใฎใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใ‹ใ‚‰ๅง‹ใ‚ใฆใ€ๅฟ…่ฆใซๅฟœใ˜ใฆๆ‹กๅผตใ—ใพใ™ - -**ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใŒ้–“้•ใฃใฆใ„ใพใ™ใ‹?** - -- ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆใงใƒˆใƒชใ‚ฌใƒผใ‚ญใƒผใƒฏใƒผใƒ‰ใ‚’็ขบ่ชใ™ใ‚‹ -- ๅฏพ่ฑกใƒ‰ใƒกใ‚คใƒณใซๅฏพใ—ใฆใ‚ˆใ‚Šๅ…ทไฝ“็š„ใช็”จ่ชžใ‚’ไฝฟ็”จใ™ใ‚‹ -- ๆ˜Ž็คบ็š„ใช่ฆไปถใพใŸใฏๅˆถ็ด„ใ‚’่ฟฝๅŠ ใ™ใ‚‹ - -## ใ‚ฏใ‚คใƒƒใ‚ฏใƒชใƒ•ใ‚กใƒฌใƒณใ‚น ๐Ÿ“‹ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#quick-reference-) - -### ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใƒˆใƒชใ‚ฌใƒผๆคœ็ดข - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#agent-trigger-lookup) - -|ใƒˆใƒชใ‚ฌใƒผใ‚ฟใ‚คใƒ—|ใ‚ญใƒผใƒฏใƒผใƒ‰/ใƒ‘ใ‚ฟใƒผใƒณ|ๆดปๆ€งๅŒ–ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆ| -|---|---|---| -|**ๅฎ‰ๅ…จ**|ใ€Œ่ช่จผใ€ใ€ใ€Œใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃใ€ใ€ใ€Œ่„†ๅผฑๆ€งใ€ใ€ใ€Œๆš—ๅทๅŒ–ใ€|ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃใ‚จใƒณใ‚ธใƒ‹ใ‚ข| -|**ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚น**|ใ€Œ้…ใ„ใ€ใ€ใ€Œๆœ€้ฉๅŒ–ใ€ใ€ใ€Œใƒœใƒˆใƒซใƒใƒƒใ‚ฏใ€ใ€ใ€Œใƒฌใ‚คใƒ†ใƒณใ‚ทใƒผใ€|ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใ‚จใƒณใ‚ธใƒ‹ใ‚ข| -|**ใƒ•ใƒญใƒณใƒˆใ‚จใƒณใƒ‰**|ใ€ŒUIใ€ใ€ใ€ŒReactใ€ใ€ใ€ŒVueใ€ใ€ใ€Œใ‚ณใƒณใƒใƒผใƒใƒณใƒˆใ€ใ€ใ€Œใƒฌใ‚นใƒใƒณใ‚ทใƒ–ใ€|ใƒ•ใƒญใƒณใƒˆใ‚จใƒณใƒ‰ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆ| -|**ใƒใƒƒใ‚ฏใ‚จใƒณใƒ‰**|ใ€ŒAPIใ€ใ€ใ€Œใ‚ตใƒผใƒใƒผใ€ใ€ใ€Œใƒ‡ใƒผใ‚ฟใƒ™ใƒผใ‚นใ€ใ€ใ€ŒRESTใ€ใ€ใ€ŒGraphQLใ€|ใƒใƒƒใ‚ฏใ‚จใƒณใƒ‰ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆ| -|**ใƒ†ใ‚นใƒˆ**|ใ€Œใƒ†ใ‚นใƒˆใ€ใ€ใ€ŒQAใ€ใ€ใ€Œๆคœ่จผใ€ใ€ใ€Œใ‚ซใƒใƒฌใƒƒใ‚ธใ€|ๅ“่ณชใ‚จใƒณใ‚ธใƒ‹ใ‚ข| -|**ใƒ‡ใƒ–ใ‚ชใƒ—ใ‚น**|ใ€Œใƒ‡ใƒ—ใƒญใ‚คใ€ใ€ใ€ŒCI/CDใ€ใ€ใ€ŒDockerใ€ใ€ใ€ŒKubernetesใ€|DevOpsใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆ| -|**ๅปบ็ฏ‰**|ใ€Œใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃใ€ใ€ใ€Œใƒžใ‚คใ‚ฏใƒญใ‚ตใƒผใƒ“ใ‚นใ€ใ€ใ€Œใ‚นใ‚ฑใƒผใƒฉใƒ“ใƒชใƒ†ใ‚ฃใ€|ใ‚ทใ‚นใƒ†ใƒ ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆ| -|**ใƒ‘ใ‚คใ‚ฝใƒณ**|ใ€Œ.pyใ€ใ€ใ€ŒDjangoใ€ใ€ใ€ŒFastAPIใ€ใ€ใ€Œasyncioใ€|Pythonใ‚จใ‚ญใ‚นใƒ‘ใƒผใƒˆ| -|**ๅ•้กŒ**|ใ€Œใƒใ‚ฐใ€ใ€ใ€Œๅ•้กŒใ€ใ€ใ€Œใƒ‡ใƒใƒƒใ‚ฐใ€ใ€ใ€Œใƒˆใƒฉใƒ–ใƒซใ‚ทใƒฅใƒผใƒ†ใ‚ฃใƒณใ‚ฐใ€|ๆ นๆœฌๅŽŸๅ› ๅˆ†ๆž่€…| -|**ใ‚ณใƒผใƒ‰ๅ“่ณช**|ใ€Œใƒชใƒ•ใ‚กใ‚ฏใ‚ฟใƒชใƒณใ‚ฐใ€ใ€ใ€Œใ‚ฏใƒชใƒผใƒณใ‚ณใƒผใƒ‰ใ€ใ€ใ€ŒๆŠ€่ก“็š„่ฒ ๅ‚ตใ€|ใƒชใƒ•ใ‚กใ‚ฏใ‚ฟใƒชใƒณใ‚ฐใฎๅฐ‚้–€ๅฎถ| -|**ใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆ**|ใ€Œใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆใ€ใ€ใ€ŒReadmeใ€ใ€ใ€ŒAPIใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆใ€|ใƒ†ใ‚ฏใƒ‹ใ‚ซใƒซใƒฉใ‚คใ‚ฟใƒผ| -|**ๅญฆใถ**|ใ€Œ่ชฌๆ˜Žใ™ใ‚‹ใ€ใ€ใ€Œใƒใƒฅใƒผใƒˆใƒชใ‚ขใƒซใ€ใ€ใ€Œๅˆๅฟƒ่€…ใ€ใ€ใ€Œๆ•™ใˆใ‚‹ใ€|ๅญฆ็ฟ’ใ‚ฌใ‚คใƒ‰| -|**่ฆไปถ**|ใ€Œ่ฆไปถใ€ใ€ใ€ŒPRDใ€ใ€ใ€Œไป•ๆง˜ใ€|่ฆไปถใ‚ขใƒŠใƒชใ‚นใƒˆ| - -### ใ‚ณใƒžใƒณใƒ‰ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใƒžใƒƒใƒ”ใƒณใ‚ฐ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#command-agent-mapping) - -|ๆŒ‡็คบ|ไธปใช่–ฌๅ‰ค|ใ‚ตใƒใƒผใƒˆใ‚จใƒผใ‚ธใ‚งใƒณใƒˆ| -|---|---|---| -|`/sc:implement`|ใƒ‰ใƒกใ‚คใƒณใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆ๏ผˆใƒ•ใƒญใƒณใƒˆใ‚จใƒณใƒ‰ใ€ใƒใƒƒใ‚ฏใ‚จใƒณใƒ‰๏ผ‰|ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃใ‚จใƒณใ‚ธใƒ‹ใ‚ขใ€ๅ“่ณชใ‚จใƒณใ‚ธใƒ‹ใ‚ข| -|`/sc:analyze`|ๅ“่ณชใ‚จใƒณใ‚ธใƒ‹ใ‚ขใ€ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃใ‚จใƒณใ‚ธใƒ‹ใ‚ข|ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใ‚จใƒณใ‚ธใƒ‹ใ‚ขใ€ๆ นๆœฌๅŽŸๅ› ใ‚ขใƒŠใƒชใ‚นใƒˆ| -|`/sc:troubleshoot`|ๆ นๆœฌๅŽŸๅ› ๅˆ†ๆž่€…|ใƒ‰ใƒกใ‚คใƒณใ‚นใƒšใ‚ทใƒฃใƒชใ‚นใƒˆใ€ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใ‚จใƒณใ‚ธใƒ‹ใ‚ข| -|`/sc:improve`|ใƒชใƒ•ใ‚กใ‚ฏใ‚ฟใƒชใƒณใ‚ฐใฎๅฐ‚้–€ๅฎถ|ๅ“่ณชใ‚จใƒณใ‚ธใƒ‹ใ‚ขใ€ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใ‚จใƒณใ‚ธใƒ‹ใ‚ข| -|`/sc:document`|ใƒ†ใ‚ฏใƒ‹ใ‚ซใƒซใƒฉใ‚คใ‚ฟใƒผ|ใƒ‰ใƒกใ‚คใƒณใ‚นใƒšใ‚ทใƒฃใƒชใ‚นใƒˆใ€ๅญฆ็ฟ’ใ‚ฌใ‚คใƒ‰| -|`/sc:design`|ใ‚ทใ‚นใƒ†ใƒ ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆ|ใƒ‰ใƒกใ‚คใƒณใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆใ€่ฆไปถใ‚ขใƒŠใƒชใ‚นใƒˆ| -|`/sc:test`|ๅ“่ณชใ‚จใƒณใ‚ธใƒ‹ใ‚ข|ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃใ‚จใƒณใ‚ธใƒ‹ใ‚ขใ€ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใ‚จใƒณใ‚ธใƒ‹ใ‚ข| -|`/sc:explain`|ๅญฆ็ฟ’ใ‚ฌใ‚คใƒ‰|ใƒ†ใ‚ฏใƒ‹ใ‚ซใƒซใƒฉใ‚คใ‚ฟใƒผใ€ใƒ‰ใƒกใ‚คใƒณใ‚นใƒšใ‚ทใƒฃใƒชใ‚นใƒˆ| - -### ๅŠนๆžœ็š„ใช่–ฌๅ‰คใฎ็ต„ใฟๅˆใ‚ใ› - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#effective-agent-combinations) - -**้–‹็™บใƒฏใƒผใ‚ฏใƒ•ใƒญใƒผ**: - -- Web ใ‚ขใƒ—ใƒชใ‚ฑใƒผใ‚ทใƒงใƒณ: ใƒ•ใƒญใƒณใƒˆใ‚จใƒณใƒ‰ ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆ + ใƒใƒƒใ‚ฏใ‚จใƒณใƒ‰ ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆ + ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃ ใ‚จใƒณใ‚ธใƒ‹ใ‚ข + ๅ“่ณชใ‚จใƒณใ‚ธใƒ‹ใ‚ข + DevOps ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆ -- API้–‹็™บ: ใƒใƒƒใ‚ฏใ‚จใƒณใƒ‰ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆ + ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃใ‚จใƒณใ‚ธใƒ‹ใ‚ข + ใƒ†ใ‚ฏใƒ‹ใ‚ซใƒซใƒฉใ‚คใ‚ฟใƒผ + ๅ“่ณชใ‚จใƒณใ‚ธใƒ‹ใ‚ข -- ใƒ‡ใƒผใ‚ฟ ใƒ—ใƒฉใƒƒใƒˆใƒ•ใ‚ฉใƒผใƒ : Python ใ‚จใ‚ญใ‚นใƒ‘ใƒผใƒˆ + ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚น ใ‚จใƒณใ‚ธใƒ‹ใ‚ข + ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃ ใ‚จใƒณใ‚ธใƒ‹ใ‚ข + ใ‚ทใ‚นใƒ†ใƒ  ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆ - -**ๅˆ†ๆžใƒฏใƒผใ‚ฏใƒ•ใƒญใƒผ**: - -- ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃ็›ฃๆŸป: ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃใ‚จใƒณใ‚ธใƒ‹ใ‚ข + ๅ“่ณชใ‚จใƒณใ‚ธใƒ‹ใ‚ข + ๆ นๆœฌๅŽŸๅ› ใ‚ขใƒŠใƒชใ‚นใƒˆ + ใƒ†ใ‚ฏใƒ‹ใ‚ซใƒซใƒฉใ‚คใ‚ฟใƒผ -- ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚น่ชฟๆŸป: ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใ‚จใƒณใ‚ธใƒ‹ใ‚ข + ๆ นๆœฌๅŽŸๅ› ใ‚ขใƒŠใƒชใ‚นใƒˆ + ใ‚ทใ‚นใƒ†ใƒ ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆ + DevOps ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆ -- ใƒฌใ‚ฌใ‚ทใƒผ่ฉ•ไพก: ใƒชใƒ•ใ‚กใ‚ฏใ‚ฟใƒชใƒณใ‚ฐๅฐ‚้–€ๅฎถ + ใ‚ทใ‚นใƒ†ใƒ ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆ + ๅ“่ณชใ‚จใƒณใ‚ธใƒ‹ใ‚ข + ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃใ‚จใƒณใ‚ธใƒ‹ใ‚ข + ใƒ†ใ‚ฏใƒ‹ใ‚ซใƒซใƒฉใ‚คใ‚ฟใƒผ - -**ใ‚ณใƒŸใƒฅใƒ‹ใ‚ฑใƒผใ‚ทใƒงใƒณใƒฏใƒผใ‚ฏใƒ•ใƒญใƒผ**: - -- ๆŠ€่ก“ใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆ: ใƒ†ใ‚ฏใƒ‹ใ‚ซใƒซใƒฉใ‚คใ‚ฟใƒผ + ่ฆไปถใ‚ขใƒŠใƒชใ‚นใƒˆ + ใƒ‰ใƒกใ‚คใƒณใ‚จใ‚ญใ‚นใƒ‘ใƒผใƒˆ + ๅญฆ็ฟ’ใ‚ฌใ‚คใƒ‰ -- ๆ•™่‚ฒใ‚ณใƒณใƒ†ใƒณใƒ„: ๅญฆ็ฟ’ใ‚ฌใ‚คใƒ‰ + ใƒ†ใ‚ฏใƒ‹ใ‚ซใƒซใƒฉใ‚คใ‚ฟใƒผ + ใƒ•ใƒญใƒณใƒˆใ‚จใƒณใƒ‰ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆ + ๅ“่ณชใ‚จใƒณใ‚ธใƒ‹ใ‚ข - -## ใƒ™ใ‚นใƒˆใƒ—ใƒฉใ‚ฏใƒ†ใ‚ฃใ‚น๐Ÿ’ก - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#best-practices-) - -### ใฏใ˜ใ‚ใซ๏ผˆใ‚ทใƒณใƒ—ใƒซใชใ‚ขใƒ—ใƒญใƒผใƒ๏ผ‰ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#getting-started-simple-approach) - -**่‡ช็„ถ่จ€่ชžใƒ•ใ‚กใƒผใ‚นใƒˆ:** - -1. **็›ฎๆจ™ใ‚’่จ˜่ฟฐใ™ใ‚‹**: ใƒ‰ใƒกใ‚คใƒณๅ›บๆœ‰ใฎใ‚ญใƒผใƒฏใƒผใƒ‰ใ‚’ๅซใ‚€่‡ช็„ถ่จ€่ชžใ‚’ไฝฟ็”จใ™ใ‚‹ -2. **ไฟก้ ผใฎ่‡ชๅ‹•ใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ™ใƒผใ‚ทใƒงใƒณ**: ใ‚ทใ‚นใƒ†ใƒ ใŒ้ฉๅˆ‡ใชใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใซ่‡ชๅ‹•็š„ใซใƒซใƒผใƒ†ใ‚ฃใƒณใ‚ฐใงใใ‚‹ใ‚ˆใ†ใซใ—ใพใ™ -3. **ใƒ‘ใ‚ฟใƒผใƒณใ‹ใ‚‰ๅญฆใถ**: ใ•ใพใ–ใพใชใƒชใ‚ฏใ‚จใ‚นใƒˆใ‚ฟใ‚คใƒ—ใซๅฏพใ—ใฆใฉใฎใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใŒใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ–ใซใชใ‚‹ใ‹ใ‚’่ฆณๅฏŸใ™ใ‚‹ -4. **ๅๅพฉใจๆ”น่‰ฏ**: ๅฐ‚้–€ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใ‚’่ฟฝๅŠ ใ™ใ‚‹ใŸใ‚ใซ่ฉณ็ดฐๅบฆใ‚’่ฟฝๅŠ ใ—ใพใ™ - -### ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎ้ธๆŠžใฎๆœ€้ฉๅŒ– - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#optimizing-agent-selection) - -**ๅŠนๆžœ็š„ใชใ‚ญใƒผใƒฏใƒผใƒ‰ใฎไฝฟ็”จๆณ•:** - -- **็‰นๅฎš > ๆฑŽ็”จ**: ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃใ‚จใƒณใ‚ธใƒ‹ใ‚ขใฎๅ ดๅˆใฏใ€Œใƒญใ‚ฐใ‚คใƒณใ€ใฎไปฃใ‚ใ‚Šใซใ€Œ่ช่จผใ€ใ‚’ไฝฟ็”จใ—ใพใ™ -- **ๆŠ€่ก“็”จ่ชž**: ใƒ•ใƒฌใƒผใƒ ใƒฏใƒผใ‚ฏๅใ€ใƒ†ใ‚ฏใƒŽใƒญใ‚ธใƒผใ€ๅ…ทไฝ“็š„ใช่ชฒ้กŒใชใฉ -- **ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆใƒ’ใƒณใƒˆ**: ใƒ•ใ‚กใ‚คใƒซใฎ็จฎ้กžใ€ใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใฎ็ฏ„ๅ›ฒใ€่ค‡้›‘ใ•ใฎๆŒ‡ๆจ™ใซใคใ„ใฆ่จ€ๅŠใ™ใ‚‹ -- **ๅ“่ณชใ‚ญใƒผใƒฏใƒผใƒ‰**: ๅŒ…ๆ‹ฌ็š„ใชใ‚ซใƒใƒฌใƒƒใ‚ธใฎใŸใ‚ใซใ€Œใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃใ€ใ€ใ€Œใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใ€ใ€ใ€Œใ‚ขใ‚ฏใ‚ปใ‚ทใƒ“ใƒชใƒ†ใ‚ฃใ€ใ‚’่ฟฝๅŠ ใ—ใพใ™ - -**ใƒชใ‚ฏใ‚จใ‚นใƒˆใฎๆœ€้ฉๅŒ–ใฎไพ‹:** - -```shell -# Generic (limited agent activation) -"Fix the login feature" - -# Optimized (multi-agent coordination) -"Implement secure JWT authentication with rate limiting and accessibility compliance" -# โ†’ Triggers: security-engineer + backend-architect + frontend-architect + quality-engineer -``` - -### ไธ€่ˆฌ็š„ใชไฝฟ็”จใƒ‘ใ‚ฟใƒผใƒณ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#common-usage-patterns) - -**้–‹็™บใƒฏใƒผใ‚ฏใƒ•ใƒญใƒผ:** - -```shell -# Full-stack feature development -/sc:implement "responsive user dashboard with real-time notifications" -# โ†’ frontend-architect + backend-architect + performance-engineer - -# API development with documentation -/sc:create "REST API for payment processing with comprehensive docs" -# โ†’ backend-architect + security-engineer + technical-writer + quality-engineer - -# Performance optimization investigation -/sc:troubleshoot "slow database queries affecting user experience" -# โ†’ performance-engineer + root-cause-analyst + backend-architect -``` - -**ๅˆ†ๆžใƒฏใƒผใ‚ฏใƒ•ใƒญใƒผ:** - -```shell -# Security assessment -/sc:analyze "authentication system for GDPR compliance vulnerabilities" -# โ†’ security-engineer + quality-engineer + requirements-analyst - -# Code quality review -/sc:review "legacy codebase for modernization opportunities" -# โ†’ refactoring-expert + system-architect + quality-engineer + technical-writer - -# Learning and explanation -/sc:explain "microservices patterns with hands-on examples" -# โ†’ system-architect + learning-guide + technical-writer -``` - -### ้ซ˜ๅบฆใชใ‚จใƒผใ‚ธใ‚งใƒณใƒˆ่ชฟๆ•ด - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#advanced-agent-coordination) - -**ใƒžใƒซใƒใƒ‰ใƒกใ‚คใƒณใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆ:** - -- **ๅน…ๅบƒใๅง‹ใ‚ใ‚‹**๏ผšใ‚ทใ‚นใƒ†ใƒ ใƒฌใƒ™ใƒซใฎใ‚ญใƒผใƒฏใƒผใƒ‰ใ‹ใ‚‰ๅง‹ใ‚ใฆใ€ๅปบ็ฏ‰ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎ้–ขๅฟƒใ‚’ๅผ•ใ -- **็‰น็•ฐๆ€งใฎ่ฟฝๅŠ **: ๅฐ‚้–€ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใ‚’ๆดปๆ€งๅŒ–ใ™ใ‚‹ใŸใ‚ใซใƒ‰ใƒกใ‚คใƒณๅ›บๆœ‰ใฎใƒ‹ใƒผใ‚บใ‚’ๅซใ‚ใ‚‹ -- **ๅ“่ณช็ตฑๅˆ**: ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃใ€ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใ€ใƒ†ใ‚นใƒˆใฎ่ฆณ็‚นใ‚’่‡ชๅ‹•็š„ใซๅซใ‚ใพใ™ -- **ใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆใฎๅŒ…ๅซ**: ๅŒ…ๆ‹ฌ็š„ใชใ‚ซใƒใƒฌใƒƒใ‚ธใฎใŸใ‚ใซๅญฆ็ฟ’ใพใŸใฏใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆใฎใƒ‹ใƒผใ‚บใ‚’่ฟฝๅŠ ใ—ใพใ™ - -**ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎ้ธๆŠžใซ้–ขใ™ใ‚‹ใƒˆใƒฉใƒ–ใƒซใ‚ทใƒฅใƒผใƒ†ใ‚ฃใƒณใ‚ฐ:** - -**ๅ•้กŒ: ้–“้•ใฃใŸใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใŒใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ–ๅŒ–ใ•ใ‚Œใ‚‹** - -- ่งฃๆฑบ็ญ–: ใ‚ˆใ‚Šๅ…ทไฝ“็š„ใชใƒ‰ใƒกใ‚คใƒณ็”จ่ชžใ‚’ไฝฟ็”จใ™ใ‚‹ -- ไพ‹:ใ€Œใƒ‡ใƒผใ‚ฟใƒ™ใƒผใ‚นๆœ€้ฉๅŒ–ใ€โ†’ ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใ‚จใƒณใ‚ธใƒ‹ใ‚ข + ใƒใƒƒใ‚ฏใ‚จใƒณใƒ‰ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒˆ - -**ๅ•้กŒ: ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใŒ่ถณใ‚Šใชใ„** - -- ่งฃๆฑบ็ญ–: ่ค‡้›‘ๆ€งๆŒ‡ๆจ™ใจใ‚ฏใƒญใ‚นใƒ‰ใƒกใ‚คใƒณใ‚ญใƒผใƒฏใƒผใƒ‰ใ‚’ๅข—ใ‚„ใ™ -- ไพ‹: ใƒชใ‚ฏใ‚จใ‚นใƒˆใซใ€Œใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃใ€ใ€ใ€Œใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใ€ใ€ใ€Œใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆใ€ใ‚’่ฟฝๅŠ ใ™ใ‚‹ - -**ๅ•้กŒ: ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใŒๅคšใ™ใŽใ‚‹** - -- ่งฃๆฑบ็ญ–: ็‰นๅฎšใฎๆŠ€่ก“็”จ่ชžใ‚’ๅซใ‚€ไธป่ฆใƒ‰ใƒกใ‚คใƒณใซ็„ฆ็‚นใ‚’ๅฝ“ใฆใ‚‹ -- ไพ‹: ใ‚นใ‚ณใƒผใƒ—ใ‚’ๅˆถ้™ใ™ใ‚‹ใซใฏใ€Œ/sc:focus backendใ€ใ‚’ไฝฟ็”จใ—ใพใ™ - -### ๅ“่ณช้‡่ฆ–ใฎ้–‹็™บ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#quality-driven-development) - -**ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃ็ฌฌไธ€ใฎใ‚ขใƒ—ใƒญใƒผใƒ:**ย ้–‹็™บใƒชใ‚ฏใ‚จใ‚นใƒˆใซใฏๅธธใซใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃใซ้–ขใ™ใ‚‹่€ƒๆ…ฎไบ‹้ …ใ‚’ๅซใ‚ใ€ใƒ‰ใƒกใ‚คใƒณใ‚นใƒšใ‚ทใƒฃใƒชใ‚นใƒˆใจใจใ‚‚ใซใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃใ‚จใƒณใ‚ธใƒ‹ใ‚ขใ‚’่‡ชๅ‹•็š„ใซ้–ขไธŽใ•ใ›ใพใ™ใ€‚ - -**ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚น็ตฑๅˆ:**ย ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚น ใ‚ญใƒผใƒฏใƒผใƒ‰ (ใ€Œ้ซ˜้€Ÿใ€ใ€ใ€ŒๅŠน็Ž‡็š„ใ€ใ€ใ€Œใ‚นใ‚ฑใƒผใƒฉใƒ–ใƒซใ€) ใ‚’ๅซใ‚ใฆใ€ๆœ€ๅˆใ‹ใ‚‰ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚น ใ‚จใƒณใ‚ธใƒ‹ใ‚ขใฎ่ชฟๆ•ดใ‚’็ขบๅฎŸใซใ—ใพใ™ใ€‚ - -**ใ‚ขใ‚ฏใ‚ปใ‚ทใƒ“ใƒชใƒ†ใ‚ฃ ใ‚ณใƒณใƒ—ใƒฉใ‚คใ‚ขใƒณใ‚น:**ย ใ€Œaccessibleใ€ใ€ใ€ŒWCAGใ€ใ€ใพใŸใฏใ€Œinclusiveใ€ใ‚’ไฝฟ็”จใ—ใฆใ€ใƒ•ใƒญใƒณใƒˆใ‚จใƒณใƒ‰้–‹็™บใซใ‚ขใ‚ฏใ‚ปใ‚ทใƒ“ใƒชใƒ†ใ‚ฃๆคœ่จผใ‚’่‡ชๅ‹•็š„ใซๅซใ‚ใพใ™ใ€‚ - -**ใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆๆ–‡ๅŒ–:**ย ใƒ†ใ‚ฏใƒ‹ใ‚ซใƒซใƒฉใ‚คใ‚ฟใƒผใฎ่‡ชๅ‹•็š„ใชๅ‚ๅŠ ใจ็Ÿฅ่ญ˜ใฎ็งป่ปขใฎใƒชใ‚ฏใ‚จใ‚นใƒˆใซใ€Œใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆๅŒ–ใ€ใ€ใ€Œ่ชฌๆ˜Žใ€ใ€ใพใŸใฏใ€Œใƒใƒฅใƒผใƒˆใƒชใ‚ขใƒซใ€ใ‚’่ฟฝๅŠ ใ—ใพใ™ใ€‚ - ---- - -## ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใ‚คใƒณใƒ†ใƒชใ‚ธใ‚งใƒณใ‚นใ‚’็†่งฃใ™ใ‚‹๐Ÿง  - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#understanding-agent-intelligence-) - -### ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใ‚’ๅŠนๆžœ็š„ใซใ™ใ‚‹่ฆ็ด  - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#what-makes-agents-effective) - -**ใƒ‰ใƒกใ‚คใƒณๅฐ‚้–€็Ÿฅ่ญ˜**: ๅ„ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฏใ€ใใ‚Œใžใ‚Œใฎใƒ‰ใƒกใ‚คใƒณใซ็‰นๆœ‰ใฎๅฐ‚้–€็š„ใช็Ÿฅ่ญ˜ใƒ‘ใ‚ฟใƒผใƒณใ€่กŒๅ‹•ใ‚ขใƒ—ใƒญใƒผใƒใ€ๅ•้กŒ่งฃๆฑบๆ–นๆณ•่ซ–ใ‚’ๅ‚™ใˆใฆใ„ใพใ™ใ€‚ - -**ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆ ใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ™ใƒผใ‚ทใƒงใƒณ**: ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฏใ€ใ‚ญใƒผใƒฏใƒผใƒ‰ใ ใ‘ใงใชใใƒชใ‚ฏใ‚จใ‚นใƒˆใฎใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆใ‚’ๅˆ†ๆžใ—ใฆใ€้–ข้€ฃๆ€งใจใ‚จใƒณใ‚ฒใƒผใ‚ธใƒกใƒณใƒˆ ใƒฌใƒ™ใƒซใ‚’ๅˆคๆ–ญใ—ใพใ™ใ€‚ - -**ๅ”่ชฟ็š„ใ‚คใƒณใƒ†ใƒชใ‚ธใ‚งใƒณใ‚น**: ่ค‡ๆ•ฐใฎใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎ่ชฟๆ•ดใซใ‚ˆใ‚Šใ€ๅ€‹ใ€…ใฎใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎ่ƒฝๅŠ›ใ‚’่ถ…ใˆใ‚‹็›ธไน—็š„ใช็ตๆžœใŒ็”Ÿใพใ‚Œใพใ™ใ€‚ - -**้ฉๅฟœๅญฆ็ฟ’**: ใƒชใ‚ฏใ‚จใ‚นใƒˆใƒ‘ใ‚ฟใƒผใƒณใจๆˆๅŠŸใ—ใŸ่ชฟๆ•ด็ตๆžœใซๅŸบใฅใ„ใฆใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎ้ธๆŠžใŒๆ”นๅ–„ใ•ใ‚Œใพใ™ใ€‚ - -### ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆ vs. ๅพ“ๆฅใฎAI - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#agent-vs-traditional-ai) - -**ๅพ“ๆฅใฎใ‚ขใƒ—ใƒญใƒผใƒ**: ๅ˜ไธ€ใฎAIใŒใ€ใ•ใพใ–ใพใชใƒฌใƒ™ใƒซใฎๅฐ‚้–€็Ÿฅ่ญ˜ใ‚’ๆŒใคใ™ในใฆใฎใƒ‰ใƒกใ‚คใƒณใ‚’ๅ‡ฆ็†ใ—ใพใ™ใ€‚ย **ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใ‚ขใƒ—ใƒญใƒผใƒ**: ๅฐ‚้–€ใฎใ‚จใ‚ญใ‚นใƒ‘ใƒผใƒˆใŒใ€ๆทฑใ„ใƒ‰ใƒกใ‚คใƒณ็Ÿฅ่ญ˜ใจ้›†ไธญ็š„ใชๅ•้กŒ่งฃๆฑบใงๅ”ๅŠ›ใ—ใพใ™ใ€‚ - -**ๅˆฉ็‚น**๏ผš - -- ใƒ‰ใƒกใ‚คใƒณๅ›บๆœ‰ใฎใ‚ฟใ‚นใ‚ฏใซใŠใ‘ใ‚‹้ซ˜ใ„็ฒพๅบฆ -- ใ‚ˆใ‚Šๆด—็ทดใ•ใ‚ŒใŸๅ•้กŒ่งฃๆฑบๆ–นๆณ•่ซ– -- ๅฐ‚้–€ๅฎถใซใ‚ˆใ‚‹ใƒฌใƒ“ใƒฅใƒผใซใ‚ˆใ‚‹ๅ“่ณชไฟ่จผใฎๅ‘ไธŠ -- ๅ”่ชฟ็š„ใชๅคš่ง’็š„ๅˆ†ๆž - -### ใ‚ทใ‚นใƒ†ใƒ ใ‚’ไฟก้ ผใ—ใ€ใƒ‘ใ‚ฟใƒผใƒณใ‚’็†่งฃใ™ใ‚‹ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#trust-the-system-understand-the-patterns) - -**ๆœŸๅพ…ใ™ใ‚‹ใ“ใจ**: - -- ้ฉๅˆ‡ใชใƒ‰ใƒกใ‚คใƒณๅฐ‚้–€ๅฎถใธใฎ่‡ชๅ‹•ใƒซใƒผใƒ†ใ‚ฃใƒณใ‚ฐ -- ่ค‡้›‘ใชใ‚ฟใ‚นใ‚ฏใฎใŸใ‚ใฎใƒžใƒซใƒใ‚จใƒผใ‚ธใ‚งใƒณใƒˆ่ชฟๆ•ด -- ่‡ชๅ‹•QAใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎ็ต„ใฟ่พผใฟใซใ‚ˆใ‚‹ๅ“่ณช็ตฑๅˆ -- ๆ•™่‚ฒใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎๆดปๆ€งๅŒ–ใซใ‚ˆใ‚‹ๅญฆ็ฟ’ๆฉŸไผš - -**ๅฟƒ้…ใ™ใ‚‹ๅฟ…่ฆใŒใชใ„ใ“ใจ**๏ผš - -- ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎๆ‰‹ๅ‹•้ธๆŠžใพใŸใฏๆง‹ๆˆ -- ่ค‡้›‘ใชใƒซใƒผใƒ†ใ‚ฃใƒณใ‚ฐใƒซใƒผใƒซใ‚„ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆ็ฎก็† -- ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎๆง‹ๆˆใพใŸใฏ่ชฟๆ•ด -- ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใจใฎใ‚„ใ‚Šๅ–ใ‚Šใ‚’็ดฐใ‹ใ็ฎก็†ใ™ใ‚‹ - ---- - -## ้–ข้€ฃใƒชใ‚ฝใƒผใ‚น ๐Ÿ“š - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#related-resources-) - -### ๅฟ…้ ˆใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#essential-documentation) - -- **[ใ‚ณใƒžใƒณใƒ‰ใ‚ฌใ‚คใƒ‰](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md)**- ๆœ€้ฉใชใ‚จใƒผใ‚ธใ‚งใƒณใƒˆ่ชฟๆ•ดใ‚’ใƒˆใƒชใ‚ฌใƒผใ™ใ‚‹SuperClaudeใ‚ณใƒžใƒณใƒ‰ใ‚’ใƒžใ‚นใ‚ฟใƒผใ™ใ‚‹ -- **[MCP ใ‚ตใƒผใƒใƒผ](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/mcp-servers.md)**- ๅฐ‚็”จใƒ„ใƒผใƒซใฎ็ตฑๅˆใซใ‚ˆใ‚‹ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆๆฉŸ่ƒฝใฎๅผทๅŒ– -- **[ใ‚ปใƒƒใ‚ทใƒงใƒณ็ฎก็†](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md)**- ๆฐธ็ถš็š„ใชใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆใซใ‚ˆใ‚‹้•ทๆœŸใƒฏใƒผใ‚ฏใƒ•ใƒญใƒผ - -### ้ซ˜ๅบฆใชไฝฟ็”จๆณ• - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#advanced-usage) - -- **[่กŒๅ‹•ใƒขใƒผใƒ‰](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md)**- ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎ่ชฟๆ•ดใ‚’ๅผทๅŒ–ใ™ใ‚‹ใŸใ‚ใฎใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆๆœ€้ฉๅŒ– -- **[ใฏใ˜ใ‚ใซ](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Getting-Started/quick-start.md)**- ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎๆœ€้ฉๅŒ–ใฎใŸใ‚ใฎๅฐ‚้–€ๅฎถใฎใƒ†ใ‚ฏใƒ‹ใƒƒใ‚ฏ -- **[ไพ‹ใฎใ‚ฏใƒƒใ‚ฏใƒ–ใƒƒใ‚ฏ](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Reference/examples-cookbook.md)**- ็พๅฎŸไธ–็•Œใฎใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎ่ชฟๆ•ดใƒ‘ใ‚ฟใƒผใƒณ - -### ้–‹็™บใƒชใ‚ฝใƒผใ‚น - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#development-resources) - -- **[ๆŠ€่ก“ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃ](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Developer-Guide/technical-architecture.md)**- SuperClaude ใฎใ‚จใƒผใ‚ธใ‚งใƒณใƒˆ ใ‚ทใ‚นใƒ†ใƒ ่จญ่จˆใ‚’็†่งฃใ™ใ‚‹ -- **[่ฒข็Œฎ](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Developer-Guide/contributing-code.md)**- ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎๆฉŸ่ƒฝใจ่ชฟๆ•ดใƒ‘ใ‚ฟใƒผใƒณใฎๆ‹กๅผต - ---- - -## ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใจใ—ใฆใฎ้“ใฎใ‚Š ๐Ÿš€ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#your-agent-journey-) - -**็ฌฌ1้€ฑ๏ผš่‡ช็„ถใชไฝฟ็”จๆณ•**ย ่‡ช็„ถใช่จ€่ชžใซใ‚ˆใ‚‹่ชฌๆ˜Žใ‹ใ‚‰ๅง‹ใ‚ใพใ—ใ‚‡ใ†ใ€‚ใฉใฎใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใŒใ€ใใ—ใฆใชใœใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ–ใซใชใ‚‹ใฎใ‹ใซๆณจ็›ฎใ—ใพใ—ใ‚‡ใ†ใ€‚ใƒ—ใƒญใ‚ปใ‚นใ‚’่€ƒใˆใ™ใŽใšใซใ€ใ‚ญใƒผใƒฏใƒผใƒ‰ใฎใƒ‘ใ‚ฟใƒผใƒณใซๅฏพใ™ใ‚‹็›ดๆ„Ÿใ‚’้คŠใ„ใพใ™ใ€‚ - -**็ฌฌ2๏ฝž3้€ฑ๏ผšใƒ‘ใ‚ฟใƒผใƒณ่ช่ญ˜** -ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎ้€ฃๆบใƒ‘ใ‚ฟใƒผใƒณใ‚’่ฆณๅฏŸใ—ใพใ™ใ€‚่ค‡้›‘ใ•ใจใƒ‰ใƒกใ‚คใƒณใ‚ญใƒผใƒฏใƒผใƒ‰ใŒใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎ้ธๆŠžใซใฉใฎใ‚ˆใ†ใชๅฝฑ้Ÿฟใ‚’ไธŽใˆใ‚‹ใ‹ใ‚’็†่งฃใ—ใพใ™ใ€‚้€ฃๆบใ‚’ๅ‘ไธŠใ•ใ›ใ‚‹ใŸใ‚ใซใ€ใƒชใ‚ฏใ‚จใ‚นใƒˆใฎ่กจ็พใ‚’ๆœ€้ฉๅŒ–ใ—ใพใ™ใ€‚ - -**2ใƒถๆœˆ็›ฎไปฅ้™๏ผšใ‚จใ‚ญใ‚นใƒ‘ใƒผใƒˆใ‚ณใƒผใƒ‡ใ‚ฃใƒใƒผใ‚ทใƒงใƒณ**ย ๆœ€้ฉใชใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎ็ต„ใฟๅˆใ‚ใ›ใ‚’ใƒˆใƒชใ‚ฌใƒผใ™ใ‚‹ใƒžใƒซใƒใƒ‰ใƒกใ‚คใƒณใƒชใ‚ฏใ‚จใ‚นใƒˆใ‚’ใƒžใ‚นใ‚ฟใƒผใ—ใพใ™ใ€‚ใƒˆใƒฉใƒ–ใƒซใ‚ทใƒฅใƒผใƒ†ใ‚ฃใƒณใ‚ฐๆ‰‹ๆณ•ใ‚’ๆดป็”จใ—ใฆๅŠนๆžœ็š„ใชใ‚จใƒผใ‚ธใ‚งใƒณใƒˆ้ธๅฎšใ‚’่กŒใ„ใพใ™ใ€‚่ค‡้›‘ใชใƒฏใƒผใ‚ฏใƒ•ใƒญใƒผใซใฏ้ซ˜ๅบฆใชใƒ‘ใ‚ฟใƒผใƒณใ‚’ไฝฟ็”จใ—ใพใ™ใ€‚ - -**SuperClaudeใฎใƒกใƒชใƒƒใƒˆ๏ผš**ย 14ๅใฎๅฐ‚้–€AIใ‚จใ‚ญใ‚นใƒ‘ใƒผใƒˆใŒใ€ใ‚ทใƒณใƒ—ใƒซใช่‡ช็„ถ่จ€่ชžใซใ‚ˆใ‚‹ใƒชใ‚ฏใ‚จใ‚นใƒˆใซ้€ฃๆบใ—ใฆๅฏพๅฟœใ—ใพใ™ใ€‚่จญๅฎšใ‚„็ฎก็†ใฏไธ่ฆใงใ€ใƒ‹ใƒผใ‚บใซๅˆใ‚ใ›ใฆๆ‹กๅผตใงใใ‚‹ใ‚คใƒณใƒ†ใƒชใ‚ธใ‚งใƒณใƒˆใช้€ฃๆบใ‚’ๅฎŸ็พใ—ใพใ™ใ€‚ - -๐ŸŽฏ**ใ‚คใƒณใƒ†ใƒชใ‚ธใ‚งใƒณใƒˆใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใ‚ณใƒผใƒ‡ใ‚ฃใƒใƒผใ‚ทใƒงใƒณใ‚’ไฝ“้จ“ใ™ใ‚‹ๆบ–ๅ‚™ใฏใงใใพใ—ใŸใ‹๏ผŸใพใšใฏ`/sc:implement`ใ€ๅฐ‚้–€็š„ใช AI ใ‚ณใƒฉใƒœใƒฌใƒผใ‚ทใƒงใƒณใฎ้ญ”ๆณ•ใ‚’็™บ่ฆ‹ใ—ใฆใใ ใ•ใ„ใ€‚** \ No newline at end of file diff --git a/docs/User-Guide-jp/commands.md b/docs/User-Guide-jp/commands.md deleted file mode 100644 index 05d2b7f..0000000 --- a/docs/User-Guide-jp/commands.md +++ /dev/null @@ -1,415 +0,0 @@ -# SuperClaude ใ‚ณใƒžใƒณใƒ‰ใ‚ฌใ‚คใƒ‰ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#superclaude-commands-guide) - -`/sc:*`SuperClaude ใฏใ€ใƒฏใƒผใ‚ฏใƒ•ใƒญใƒผ็”จใ‚ณใƒžใƒณใƒ‰ใจ`@agent-*`ใ‚นใƒšใ‚ทใƒฃใƒชใ‚นใƒˆ็”จใ‚ณใƒžใƒณใƒ‰ใฎ 21 ๅ€‹ใฎ Claude Code ใ‚ณใƒžใƒณใƒ‰ใ‚’ๆไพ›ใ—ใพใ™ใ€‚ - -## ใ‚ณใƒžใƒณใƒ‰ใฎ็จฎ้กž - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#command-types) - -|ใ‚ฟใ‚คใƒ—|ไฝฟ็”จๅ ดๆ‰€|ๅฝขๅผ|ไพ‹| -|---|---|---|---| -|**ใ‚นใƒฉใƒƒใ‚ทใƒฅใ‚ณใƒžใƒณใƒ‰**|ใ‚ฏใƒญใƒผใƒ‰ใƒปใ‚ณใƒผใƒ‰|`/sc:[command]`|`/sc:implement "feature"`| -|**ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆ**|ใ‚ฏใƒญใƒผใƒ‰ใƒปใ‚ณใƒผใƒ‰|`@agent-[name]`|`@agent-security "review"`| -|**ใ‚คใƒณใ‚นใƒˆใƒผใƒซ**|ใ‚ฟใƒผใƒŸใƒŠใƒซ|`SuperClaude [command]`|`SuperClaude install`| - -## ใ‚ฏใ‚คใƒƒใ‚ฏใƒ†ใ‚นใƒˆ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#quick-test) - -```shell -# Terminal: Verify installation -python3 -m SuperClaude --version -# Claude Code CLI verification: claude --version - -# Claude Code: Test commands -/sc:brainstorm "test project" # Should ask discovery questions -/sc:analyze README.md # Should provide analysis -``` - -**ใƒฏใƒผใ‚ฏใƒ•ใƒญใƒผ**๏ผš`/sc:brainstorm "idea"`โ†’โ†’`/sc:implement "feature"`โ€‹`/sc:test` - -## ๐ŸŽฏ SuperClaude ใ‚ณใƒžใƒณใƒ‰ใฎ็†่งฃ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#-understanding-superclaude-commands) - -## SuperClaudeใฎไป•็ต„ใฟ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#how-superclaude-works) - -SuperClaude ใฏใ€Claude Code ใŒ็‰นๆฎŠใชๅ‹•ไฝœใ‚’ๅฎŸ่กŒใ™ใ‚‹ใŸใ‚ใซ่ชญใฟ่พผใ‚€ๅ‹•ไฝœใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆใƒ•ใ‚กใ‚คใƒซใ‚’ๆไพ›ใ—ใพใ™ใ€‚ ใจๅ…ฅๅŠ›ใ™ใ‚‹ใจ`/sc:implement`ใ€Claude Code ใฏ`implement.md`ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆใƒ•ใ‚กใ‚คใƒซใ‚’่ชญใฟ่พผใฟใ€ใใฎๅ‹•ไฝœๆŒ‡็คบใซๅพ“ใ„ใพใ™ใ€‚ - -**SuperClaude ใ‚ณใƒžใƒณใƒ‰ใฏใ‚ฝใƒ•ใƒˆใ‚ฆใ‚งใ‚ขใซใ‚ˆใฃใฆๅฎŸ่กŒใ•ใ‚Œใ‚‹ใฎใงใฏใชใ**ใ€ใƒ•ใƒฌใƒผใƒ ใƒฏใƒผใ‚ฏใ‹ใ‚‰็‰นๆฎŠใชๅ‘ฝไปคใƒ•ใ‚กใ‚คใƒซใ‚’่ชญใฟๅ–ใ‚‹ใ“ใจใง Claude ใ‚ณใƒผใƒ‰ใฎๅ‹•ไฝœใ‚’ๅค‰ๆ›ดใ™ใ‚‹ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆ ใƒˆใƒชใ‚ฌใƒผใงใ™ใ€‚ - -### ใ‚ณใƒžใƒณใƒ‰ใฎ็จฎ้กž: - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#command-types-1) - -- **ใ‚นใƒฉใƒƒใ‚ทใƒฅใ‚ณใƒžใƒณใƒ‰**๏ผˆ`/sc:*`๏ผ‰๏ผšใƒฏใƒผใ‚ฏใƒ•ใƒญใƒผใƒ‘ใ‚ฟใƒผใƒณใจๅ‹•ไฝœโ€‹โ€‹ใƒขใƒผใƒ‰ใ‚’ใƒˆใƒชใ‚ฌใƒผใ™ใ‚‹ -- **ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎๅ‘ผใณๅ‡บใ—**๏ผˆ`@agent-*`๏ผ‰๏ผš็‰นๅฎšใฎใƒ‰ใƒกใ‚คใƒณใ‚นใƒšใ‚ทใƒฃใƒชใ‚นใƒˆใ‚’ๆ‰‹ๅ‹•ใง่ตทๅ‹•ใ™ใ‚‹ -- **ใƒ•ใƒฉใ‚ฐ**๏ผˆ`--think`ใ€`--safe-mode`๏ผ‰๏ผšใ‚ณใƒžใƒณใƒ‰ใฎๅ‹•ไฝœใจๆทฑใ•ใ‚’ๅค‰ๆ›ดใ™ใ‚‹ - -### ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆใƒกใ‚ซใƒ‹ใ‚บใƒ : - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#the-context-mechanism) - -1. **ใƒฆใƒผใ‚ถใƒผๅ…ฅๅŠ›**: ๅ…ฅๅŠ›ใ™ใ‚‹`/sc:implement "auth system"` -2. **ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆ่ชญใฟ่พผใฟ**: ใ‚ฏใƒญใƒผใƒ‰ใ‚ณใƒผใƒ‰่ชญใฟๅ–ใ‚Š`~/.claude/superclaude/Commands/implement.md` -3. **่กŒๅ‹•ใฎๆŽก็”จ**๏ผšใ‚ฏใƒญใƒผใƒ‰ใฏใƒ‰ใƒกใ‚คใƒณใฎๅฐ‚้–€็Ÿฅ่ญ˜ใ€ใƒ„ใƒผใƒซใฎ้ธๆŠžใ€ๆคœ่จผใƒ‘ใ‚ฟใƒผใƒณใ‚’้ฉ็”จใ—ใพใ™ -4. **ๅผทๅŒ–ใ•ใ‚ŒใŸๅ‡บๅŠ›**: ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃไธŠใฎ่€ƒๆ…ฎไบ‹้ …ใจใƒ™ใ‚นใƒˆใƒ—ใƒฉใ‚ฏใƒ†ใ‚ฃใ‚นใ‚’ๅ‚™ใˆใŸๆง‹้€ ๅŒ–ใ•ใ‚ŒใŸๅฎŸ่ฃ… - -**้‡่ฆใชใƒใ‚คใƒณใƒˆ**: ใ“ใ‚Œใซใ‚ˆใ‚Šใ€ๅพ“ๆฅใฎใ‚ฝใƒ•ใƒˆใ‚ฆใ‚งใ‚ขๅฎŸ่กŒใงใฏใชใใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆ็ฎก็†ใ‚’้€šใ˜ใฆๆด—็ทดใ•ใ‚ŒใŸ้–‹็™บใƒฏใƒผใ‚ฏใƒ•ใƒญใƒผใŒไฝœๆˆใ•ใ‚Œใพใ™ใ€‚ - -### ใ‚คใƒณใ‚นใƒˆใƒผใƒซใ‚ณใƒžใƒณใƒ‰ใจไฝฟ็”จใ‚ณใƒžใƒณใƒ‰ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#installation-vs-usage-commands) - -**๐Ÿ–ฅ๏ธ ใ‚ฟใƒผใƒŸใƒŠใƒซใ‚ณใƒžใƒณใƒ‰**๏ผˆๅฎŸ้š›ใฎ CLI ใ‚ฝใƒ•ใƒˆใ‚ฆใ‚งใ‚ข๏ผ‰๏ผš - -- `SuperClaude install`- ใƒ•ใƒฌใƒผใƒ ใƒฏใƒผใ‚ฏใ‚ณใƒณใƒใƒผใƒใƒณใƒˆใ‚’ใ‚คใƒณใ‚นใƒˆใƒผใƒซใ—ใพใ™ -- `SuperClaude update`- ๆ—ขๅญ˜ใฎใ‚คใƒณใ‚นใƒˆใƒผใƒซใ‚’ๆ›ดๆ–ฐใ—ใพใ™ -- `SuperClaude uninstall`- ใƒ•ใƒฌใƒผใƒ ใƒฏใƒผใ‚ฏใฎใ‚คใƒณใ‚นใƒˆใƒผใƒซใ‚’ๅ‰Š้™คใ—ใพใ™ -- `python3 -m SuperClaude --version`- ใ‚คใƒณใ‚นใƒˆใƒผใƒซ็Šถๆ…‹ใ‚’็ขบ่ชใ™ใ‚‹ - -**๐Ÿ’ฌ ใ‚ฏใƒญใƒผใƒ‰ ใ‚ณใƒผใƒ‰ ใ‚ณใƒžใƒณใƒ‰**(ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆ ใƒˆใƒชใ‚ฌใƒผ): - -- `/sc:brainstorm`- ่ฆไปถๆคœๅ‡บใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆใ‚’ใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ–ๅŒ–ใ—ใพใ™ -- `/sc:implement`- ๆฉŸ่ƒฝ้–‹็™บใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆใ‚’ใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ–ๅŒ–ใ—ใพใ™ -- `@agent-security`- ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃใ‚นใƒšใ‚ทใƒฃใƒชใ‚นใƒˆใฎใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆใ‚’ใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ–ๅŒ–ใ—ใพใ™ -- ใ™ในใฆใฎใ‚ณใƒžใƒณใƒ‰ใฏClaude Codeใƒใƒฃใƒƒใƒˆใ‚คใƒณใ‚ฟใƒผใƒ•ใ‚งใƒผใ‚นๅ†…ใงใฎใฟๆฉŸ่ƒฝใ—ใพใ™ - -> **ใ‚ฏใ‚คใƒƒใ‚ฏ ใ‚นใ‚ฟใƒผใƒˆ**:ย `/sc:brainstorm "your project idea"`โ†’ย `/sc:implement "feature name"`โ†’ใ‚’่ฉฆใ—ใฆ`/sc:test`ใ€ใ‚ณใ‚ข ใƒฏใƒผใ‚ฏใƒ•ใƒญใƒผใ‚’ไฝ“้จ“ใ—ใฆใใ ใ•ใ„ใ€‚ - -## ๐Ÿงช ใ‚ปใƒƒใƒˆใ‚ขใƒƒใƒ—ใฎใƒ†ใ‚นใƒˆ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#-testing-your-setup) - -### ๐Ÿ–ฅ๏ธ ใ‚ฟใƒผใƒŸใƒŠใƒซๆคœ่จผ๏ผˆใ‚ฟใƒผใƒŸใƒŠใƒซ/CMDใงๅฎŸ่กŒ๏ผ‰ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#%EF%B8%8F-terminal-verification-run-in-terminalcmd) - -```shell -# Verify SuperClaude is working (primary method) -python3 -m SuperClaude --version -# Example output: SuperClaude 4.1.5 - -# Claude Code CLI version check -claude --version - -# Check installed components -python3 -m SuperClaude install --list-components | grep mcp -# Example output: Shows installed MCP components -``` - -### ๐Ÿ’ฌ ใ‚ฏใƒญใƒผใƒ‰ใ‚ณใƒผใƒ‰ใƒ†ใ‚นใƒˆ๏ผˆใ‚ฏใƒญใƒผใƒ‰ใ‚ณใƒผใƒ‰ใƒใƒฃใƒƒใƒˆใซๅ…ฅๅŠ›๏ผ‰ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#-claude-code-testing-type-in-claude-code-chat) - -``` -# Test basic /sc: command -/sc:brainstorm "test project" -# Example behavior: Interactive requirements discovery starts - -# Test command help -/sc:help -# Example behavior: List of available commands -``` - -**ใƒ†ใ‚นใƒˆใŒๅคฑๆ•—ใ—ใŸๅ ดๅˆ**:[ใ‚คใƒณใ‚นใƒˆใƒผใƒซใ‚ฌใ‚คใƒ‰](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Getting-Started/installation.md)ใพใŸใฏ[ใƒˆใƒฉใƒ–ใƒซใ‚ทใƒฅใƒผใƒ†ใ‚ฃใƒณใ‚ฐใ‚’็ขบ่ชใ—ใฆใใ ใ•ใ„](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#troubleshooting) - -### ๐Ÿ“ ใ‚ณใƒžใƒณใƒ‰ใ‚ฏใ‚คใƒƒใ‚ฏใƒชใƒ•ใ‚กใƒฌใƒณใ‚น - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#-command-quick-reference) - -|ใ‚ณใƒžใƒณใƒ‰ใ‚ฟใ‚คใƒ—|่ตฐใ‚‹ๅ ดๆ‰€|ๅฝขๅผ|็›ฎ็š„|ไพ‹| -|---|---|---|---|---| -|**๐Ÿ–ฅ๏ธ ใ‚คใƒณใ‚นใƒˆใƒผใƒซ**|ใ‚ฟใƒผใƒŸใƒŠใƒซ/CMD|`SuperClaude [command]`|ใ‚ปใƒƒใƒˆใ‚ขใƒƒใƒ—ใจใƒกใƒณใƒ†ใƒŠใƒณใ‚น|`SuperClaude install`| -|**๐Ÿ”ง ๆง‹ๆˆ**|ใ‚ฟใƒผใƒŸใƒŠใƒซ/CMD|`python3 -m SuperClaude [command]`|้ซ˜ๅบฆใช่จญๅฎš|`python3 -m SuperClaude --version`| -|**๐Ÿ’ฌ ใ‚นใƒฉใƒƒใ‚ทใƒฅใ‚ณใƒžใƒณใƒ‰**|ใ‚ฏใƒญใƒผใƒ‰ใƒปใ‚ณใƒผใƒ‰|`/sc:[command]`|ใƒฏใƒผใ‚ฏใƒ•ใƒญใƒผ่‡ชๅ‹•ๅŒ–|`/sc:implement "feature"`| -|**๐Ÿค– ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎๅ‘ผใณๅ‡บใ—**|ใ‚ฏใƒญใƒผใƒ‰ใƒปใ‚ณใƒผใƒ‰|`@agent-[name]`|ๆ‰‹ๅ‹•ใ‚นใƒšใ‚ทใƒฃใƒชใ‚นใƒˆใฎๆœ‰ๅŠนๅŒ–|`@agent-security "review"`| -|**โšก ๅผทๅŒ–ใ•ใ‚ŒใŸใƒ•ใƒฉใ‚ฐ**|ใ‚ฏใƒญใƒผใƒ‰ใƒปใ‚ณใƒผใƒ‰|`/sc:[command] --flags`|่กŒๅ‹•ไฟฎๆญฃ|`/sc:analyze --think-hard`| - -> **ๆณจๆ„**๏ผšใ™ในใฆใฎ`/sc:`ใ‚ณใƒžใƒณใƒ‰ใจ`@agent-`ๅ‘ผใณๅ‡บใ—ใฏใ€ใ‚ฟใƒผใƒŸใƒŠใƒซใงใฏใชใClaude Codeใƒใƒฃใƒƒใƒˆๅ†…ใงๅ‹•ไฝœใ—ใพใ™ใ€‚ใ“ใ‚Œใ‚‰ใฎใ‚ณใƒžใƒณใƒ‰ใจๅ‘ผใณๅ‡บใ—ใฏใ€Claude CodeใŒSuperClaudeใƒ•ใƒฌใƒผใƒ ใƒฏใƒผใ‚ฏใ‹ใ‚‰็‰นๅฎšใฎใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆใƒ•ใ‚กใ‚คใƒซใ‚’่ชญใฟๅ–ใ‚‹ใ‚ˆใ†ใซใƒˆใƒชใ‚ฌใƒผใ—ใพใ™ใ€‚ - -## ็›ฎๆฌก - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#table-of-contents) - -- [ๅฟ…้ ˆใ‚ณใƒžใƒณใƒ‰](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#essential-commands)- ใ“ใ“ใ‹ใ‚‰ๅง‹ใ‚ใพใ—ใ‚‡ใ†๏ผˆ8ใคใฎใ‚ณใ‚ขใ‚ณใƒžใƒณใƒ‰๏ผ‰ -- [ไธ€่ˆฌ็š„ใชใƒฏใƒผใ‚ฏใƒ•ใƒญใƒผ](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#common-workflows)- ๆฉŸ่ƒฝใ™ใ‚‹ใ‚ณใƒžใƒณใƒ‰ใฎ็ต„ใฟๅˆใ‚ใ› -- [ๅฎŒๅ…จใชใ‚ณใƒžใƒณใƒ‰ใƒชใƒ•ใ‚กใƒฌใƒณใ‚น](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#full-command-reference)- ใ‚ซใƒ†ใ‚ดใƒชๅˆฅใซๆ•ด็†ใ•ใ‚ŒใŸๅ…จ21ๅ€‹ใฎใ‚ณใƒžใƒณใƒ‰ -- [ใƒˆใƒฉใƒ–ใƒซใ‚ทใƒฅใƒผใƒ†ใ‚ฃใƒณใ‚ฐ](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#troubleshooting)- ใ‚ˆใใ‚ใ‚‹ๅ•้กŒใจ่งฃๆฑบ็ญ– -- [ใ‚ณใƒžใƒณใƒ‰ใ‚คใƒณใƒ‡ใƒƒใ‚ฏใ‚น](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#command-index)- ใ‚ซใƒ†ใ‚ดใƒชๅˆฅใซใ‚ณใƒžใƒณใƒ‰ใ‚’ๆคœ็ดข - ---- - -## ๅฟ…้ ˆใ‚ณใƒžใƒณใƒ‰ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#essential-commands) - -**ๅณๆ™‚ใฎ็”Ÿ็”ฃๆ€งๅ‘ไธŠใฎใŸใ‚ใฎใ‚ณใ‚ขใƒฏใƒผใ‚ฏใƒ•ใƒญใƒผ ใ‚ณใƒžใƒณใƒ‰:** - -### `/sc:brainstorm`- ใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆ็™บ่ฆ‹ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#scbrainstorm---project-discovery) - -**็›ฎ็š„**: ๅฏพ่ฉฑๅž‹ใฎ่ฆไปถๆคœๅ‡บใจใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆ่จˆ็”ป -**ๆง‹ๆ–‡**:`/sc:brainstorm "your idea"`ย `[--strategy systematic|creative]` - -**ใƒฆใƒผใ‚นใ‚ฑใƒผใ‚น**: - -- ๆ–ฐใ—ใ„ใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใฎ่จˆ็”ป:`/sc:brainstorm "e-commerce platform"` -- ๆฉŸ่ƒฝใฎๆŽข็ดข:`/sc:brainstorm "user authentication system"` -- ๅ•้กŒ่งฃๆฑบ:`/sc:brainstorm "slow database queries"` - -### `/sc:implement`- ๆฉŸ่ƒฝ้–‹็™บ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#scimplement---feature-development) - -**็›ฎ็š„**: ใ‚คใƒณใƒ†ใƒชใ‚ธใ‚งใƒณใƒˆใชใ‚นใƒšใ‚ทใƒฃใƒชใ‚นใƒˆใƒซใƒผใƒ†ใ‚ฃใƒณใ‚ฐใซใ‚ˆใ‚‹ใƒ•ใƒซใ‚นใ‚ฟใƒƒใ‚ฏๆฉŸ่ƒฝใฎๅฎŸ่ฃ… -**ๆง‹ๆ–‡**:`/sc:implement "feature description"`ย `[--type frontend|backend|fullstack] [--focus security|performance]` - -**ใƒฆใƒผใ‚นใ‚ฑใƒผใ‚น**: - -- ่ช่จผ:`/sc:implement "JWT login system"` -- UI ใ‚ณใƒณใƒใƒผใƒใƒณใƒˆ:`/sc:implement "responsive dashboard"` -- API:`/sc:implement "REST user endpoints"` -- ใƒ‡ใƒผใ‚ฟใƒ™ใƒผใ‚น:`/sc:implement "user schema with relationships"` - -### `/sc:analyze`- ใ‚ณใƒผใƒ‰่ฉ•ไพก - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#scanalyze---code-assessment) - -**็›ฎ็š„**: ๅ“่ณชใ€ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃใ€ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใซใ‚ใŸใ‚‹ๅŒ…ๆ‹ฌ็š„ใชใ‚ณใƒผใƒ‰ๅˆ†ๆž -**ๆง‹ๆ–‡**:`/sc:analyze [path]`ย `[--focus quality|security|performance|architecture]` - -**ใƒฆใƒผใ‚นใ‚ฑใƒผใ‚น**: - -- ใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใฎๅฅๅ…จๆ€ง:`/sc:analyze .` -- ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃ็›ฃๆŸป:`/sc:analyze --focus security` -- ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใƒฌใƒ“ใƒฅใƒผ:`/sc:analyze --focus performance` - -### `/sc:troubleshoot`- ๅ•้กŒ่จบๆ–ญ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#sctroubleshoot---problem-diagnosis) - -**็›ฎ็š„**: ๆ นๆœฌๅŽŸๅ› ๅˆ†ๆžใซใ‚ˆใ‚‹ไฝ“็ณป็š„ใชๅ•้กŒ่จบๆ–ญ -**ๆง‹ๆ–‡**:`/sc:troubleshoot "issue description"`ย `[--type build|runtime|performance]` - -**ใƒฆใƒผใ‚นใ‚ฑใƒผใ‚น**: - -- ใƒฉใƒณใ‚ฟใ‚คใƒ ใ‚จใƒฉใƒผ:`/sc:troubleshoot "500 error on login"` -- ใƒ“ใƒซใƒ‰ใฎๅคฑๆ•—:`/sc:troubleshoot --type build` -- ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใฎๅ•้กŒ:`/sc:troubleshoot "slow page load"` - -### `/sc:test`- ๅ“่ณชไฟ่จผ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#sctest---quality-assurance) - -**็›ฎ็š„**: ใ‚ซใƒใƒฌใƒƒใ‚ธๅˆ†ๆžใซใ‚ˆใ‚‹ๅŒ…ๆ‹ฌ็š„ใชใƒ†ใ‚นใƒˆ -**ๆง‹ๆ–‡**:`/sc:test`ย `[--type unit|integration|e2e] [--coverage] [--fix]` - -**ใƒฆใƒผใ‚นใ‚ฑใƒผใ‚น**: - -- ๅฎŒๅ…จใชใƒ†ใ‚นใƒˆใ‚นใ‚คใƒผใƒˆ:`/sc:test --coverage` -- ใƒฆใƒ‹ใƒƒใƒˆใƒ†ใ‚นใƒˆ:`/sc:test --type unit --watch` -- E2Eๆคœ่จผ:`/sc:test --type e2e` - -### `/sc:improve`- ใ‚ณใƒผใƒ‰ๅผทๅŒ– - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#scimprove---code-enhancement) - -**็›ฎ็š„**: ไฝ“็ณป็š„ใชใ‚ณใƒผใƒ‰ใฎๆ”นๅ–„ใจๆœ€้ฉๅŒ–ใ‚’้ฉ็”จใ™ใ‚‹ -**ๆง‹ๆ–‡**:`/sc:improve [path]`ย `[--type performance|quality|security] [--preview]` - -**ใƒฆใƒผใ‚นใ‚ฑใƒผใ‚น**: - -- ไธ€่ˆฌ็š„ใชๆ”นๅ–„็‚น:`/sc:improve src/` -- ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใฎๆœ€้ฉๅŒ–:`/sc:improve --type performance` -- ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃๅผทๅŒ–:`/sc:improve --type security` - -### `/sc:document`- ใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆ็”Ÿๆˆ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#scdocument---documentation-generation) - -**็›ฎ็š„**: ใ‚ณใƒผใƒ‰ใจAPIใฎๅŒ…ๆ‹ฌ็š„ใชใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆใ‚’็”Ÿๆˆใ™ใ‚‹ -**ๆง‹ๆ–‡**:`/sc:document [path]`ย `[--type api|user-guide|technical] [--format markdown|html]` - -**ใƒฆใƒผใ‚นใ‚ฑใƒผใ‚น**: - -- APIใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆ:`/sc:document --type api` -- ใƒฆใƒผใ‚ถใƒผใ‚ฌใ‚คใƒ‰:`/sc:document --type user-guide` -- ๆŠ€่ก“ใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆ:`/sc:document --type technical` - -### `/sc:workflow`- ๅฎŸ่ฃ…่จˆ็”ป - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#scworkflow---implementation-planning) - -**็›ฎ็š„**: ่ฆไปถใ‹ใ‚‰ๆง‹้€ ๅŒ–ใ•ใ‚ŒใŸๅฎŸ่ฃ…่จˆ็”ปใ‚’็”Ÿๆˆใ™ใ‚‹ -**ๆง‹ๆ–‡**:`/sc:workflow "feature description"`ย `[--strategy agile|waterfall] [--format markdown]` - -**ใƒฆใƒผใ‚นใ‚ฑใƒผใ‚น**: - -- ๆฉŸ่ƒฝ่จˆ็”ป:`/sc:workflow "user authentication"` -- ใ‚นใƒ—ใƒชใƒณใƒˆ่จˆ็”ป:`/sc:workflow --strategy agile` -- ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃ่จˆ็”ป๏ผš`/sc:workflow "microservices migration"` - ---- - -## ไธ€่ˆฌ็š„ใชใƒฏใƒผใ‚ฏใƒ•ใƒญใƒผ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#common-workflows) - -**ๅฎŸ่จผๆธˆใฟใฎใ‚ณใƒžใƒณใƒ‰ใฎ็ต„ใฟๅˆใ‚ใ›:** - -### ๆ–ฐใ—ใ„ใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใฎใ‚ปใƒƒใƒˆใ‚ขใƒƒใƒ— - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#new-project-setup) - -```shell -/sc:brainstorm "project concept" # Define requirements -/sc:design "system architecture" # Create technical design -/sc:workflow "implementation plan" # Generate development roadmap -``` - -### ๆฉŸ่ƒฝ้–‹็™บ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#feature-development) - -```shell -/sc:implement "feature name" # Build the feature -/sc:test --coverage # Validate with tests -/sc:document --type api # Generate documentation -``` - -### ใ‚ณใƒผใƒ‰ๅ“่ณชใฎๆ”นๅ–„ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#code-quality-improvement) - -```shell -/sc:analyze --focus quality # Assess current state -/sc:improve --preview # Preview improvements -/sc:test --coverage # Validate changes -``` - -### ใƒใ‚ฐ่ชฟๆŸป - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#bug-investigation) - -```shell -/sc:troubleshoot "issue description" # Diagnose the problem -/sc:analyze --focus problem-area # Deep analysis -/sc:improve --fix --safe-mode # Apply targeted fixes -``` - -## ๅฎŒๅ…จใชใ‚ณใƒžใƒณใƒ‰ใƒชใƒ•ใ‚กใƒฌใƒณใ‚น - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#full-command-reference) - -### ้–‹็™บใ‚ณใƒžใƒณใƒ‰ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#development-commands) - -|ๆŒ‡็คบ|็›ฎ็š„|ๆœ€้ฉใช็”จ้€”| -|---|---|---| -|**ใƒฏใƒผใ‚ฏใƒ•ใƒญใƒผ**|ๅฎŸๆ–ฝ่จˆ็”ป|ใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใƒญใƒผใƒ‰ใƒžใƒƒใƒ—ใ€ใ‚นใƒ—ใƒชใƒณใƒˆ่จˆ็”ป| -|**ๅŸ‹ใ‚่พผใ‚€**|ๆฉŸ่ƒฝ้–‹็™บ|ใƒ•ใƒซใ‚นใ‚ฟใƒƒใ‚ฏๆฉŸ่ƒฝใ€API้–‹็™บ| -|**ๅปบใฆใ‚‹**|ใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใฎใ‚ณใƒณใƒ‘ใ‚คใƒซ|CI/CDใ€ใƒ—ใƒญใƒ€ใ‚ฏใ‚ทใƒงใƒณใƒ“ใƒซใƒ‰| -|**ใƒ‡ใ‚ถใ‚คใƒณ**|ใ‚ทใ‚นใƒ†ใƒ ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃ|APIไป•ๆง˜ใ€ใƒ‡ใƒผใ‚ฟใƒ™ใƒผใ‚นใ‚นใ‚ญใƒผใƒž| - -### ๅˆ†ๆžใ‚ณใƒžใƒณใƒ‰ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#analysis-commands) - -|ๆŒ‡็คบ|็›ฎ็š„|ๆœ€้ฉใช็”จ้€”| -|---|---|---| -|**ๅˆ†ๆžใ™ใ‚‹**|ใ‚ณใƒผใƒ‰่ฉ•ไพก|ๅ“่ณช็›ฃๆŸปใ€ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃใƒฌใƒ“ใƒฅใƒผ| -|**ใƒˆใƒฉใƒ–ใƒซใ‚ทใƒฅใƒผใƒ†ใ‚ฃใƒณใ‚ฐ**|ๅ•้กŒ่จบๆ–ญ|ใƒใ‚ฐ่ชฟๆŸปใ€ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใฎๅ•้กŒ| -|**่ชฌๆ˜Žใ™ใ‚‹**|ใ‚ณใƒผใƒ‰ใฎ่ชฌๆ˜Ž|ๅญฆ็ฟ’ใ€ใ‚ณใƒผใƒ‰ใƒฌใƒ“ใƒฅใƒผ| - -### ๅ“่ณชใ‚ณใƒžใƒณใƒ‰ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#quality-commands) - -|ๆŒ‡็คบ|็›ฎ็š„|ๆœ€้ฉใช็”จ้€”| -|---|---|---| -|**ๆ”นๅ–„ใ™ใ‚‹**|ใ‚ณใƒผใƒ‰ๅผทๅŒ–|ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใฎๆœ€้ฉๅŒ–ใ€ใƒชใƒ•ใ‚กใ‚ฏใ‚ฟใƒชใƒณใ‚ฐ| -|**ๆŽƒ้™ค**|ๆŠ€่ก“็š„่ฒ ๅ‚ต|ใƒ‡ใƒƒใƒ‰ใ‚ณใƒผใƒ‰ใฎๅ‰Š้™คใ€ๆ•ด็†| -|**ใƒ†ใ‚นใƒˆ**|ๅ“่ณชไฟ่จผ|ใƒ†ใ‚นใƒˆ่‡ชๅ‹•ๅŒ–ใ€ใ‚ซใƒใƒฌใƒƒใ‚ธๅˆ†ๆž| -|**ๆ›ธ้กž**|ใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆ|APIใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆใ€ใƒฆใƒผใ‚ถใƒผใ‚ฌใ‚คใƒ‰| - -### ใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆ็ฎก็† - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#project-management) - -|ๆŒ‡็คบ|็›ฎ็š„|ๆœ€้ฉใช็”จ้€”| -|---|---|---| -|**่ฆ‹็ฉใ‚‚ใ‚Š**|ใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆ่ฆ‹็ฉใ‚‚ใ‚Š|ใ‚ฟใ‚คใƒ ใƒฉใ‚คใƒณ่จˆ็”ปใ€ใƒชใ‚ฝใƒผใ‚นๅ‰ฒใ‚Šๅฝ“ใฆ| -|**ใ‚ฟใ‚นใ‚ฏ**|ใ‚ฟใ‚นใ‚ฏ็ฎก็†|่ค‡้›‘ใชใƒฏใƒผใ‚ฏใƒ•ใƒญใƒผใ€ใ‚ฟใ‚นใ‚ฏ่ฟฝ่ทก| -|**ใ‚นใƒใƒผใƒณ**|ใƒกใ‚ฟใ‚ชใƒผใ‚ฑใ‚นใƒˆใƒฌใƒผใ‚ทใƒงใƒณ|ๅคง่ฆๆจกใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใ€ไธฆๅˆ—ๅฎŸ่กŒ| - -### ใƒฆใƒผใƒ†ใ‚ฃใƒชใƒ†ใ‚ฃใ‚ณใƒžใƒณใƒ‰ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#utility-commands) - -|ๆŒ‡็คบ|็›ฎ็š„|ๆœ€้ฉใช็”จ้€”| -|---|---|---| -|**ใ‚ฎใƒƒใƒˆ**|ใƒใƒผใ‚ธใƒงใƒณ็ฎก็†|ใ‚ณใƒŸใƒƒใƒˆ็ฎก็†ใ€ใƒ–ใƒฉใƒณใƒๆˆฆ็•ฅ| -|**็ดขๅผ•**|ใ‚ณใƒžใƒณใƒ‰ๆคœๅ‡บ|ๆฉŸ่ƒฝใฎๆŽข็ดขใ€ใ‚ณใƒžใƒณใƒ‰ใฎๆคœ็ดข| - -### ใ‚ปใƒƒใ‚ทใƒงใƒณใ‚ณใƒžใƒณใƒ‰ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#session-commands) - -|ๆŒ‡็คบ|็›ฎ็š„|ๆœ€้ฉใช็”จ้€”| -|---|---|---| -|**่ฒ ่ท**|ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆใฎ่ชญใฟ่พผใฟ|ใ‚ปใƒƒใ‚ทใƒงใƒณใฎๅˆๆœŸๅŒ–ใ€ใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใฎใ‚ชใƒณใƒœใƒผใƒ‡ใ‚ฃใƒณใ‚ฐ| -|**ไฟๅญ˜**|ใ‚ปใƒƒใ‚ทใƒงใƒณใฎๆฐธ็ถšๆ€ง|ใƒใ‚งใƒƒใ‚ฏใƒใ‚คใƒณใƒˆใ€ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆไฟๅญ˜| -|**ๅๆ˜ ใ™ใ‚‹**|ใ‚ฟใ‚นใ‚ฏใฎๆคœ่จผ|้€ฒๆ—่ฉ•ไพกใ€ๅฎŒไบ†ๆคœ่จผ| -|**้ธๆŠžใƒ„ใƒผใƒซ**|ใƒ„ใƒผใƒซใฎๆœ€้ฉๅŒ–|ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใฎๆœ€้ฉๅŒ–ใ€ใƒ„ใƒผใƒซใฎ้ธๆŠž| - ---- - -## ใ‚ณใƒžใƒณใƒ‰ใ‚คใƒณใƒ‡ใƒƒใ‚ฏใ‚น - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#command-index) - -**ๆฉŸ่ƒฝๅˆฅ:** - -- **่จˆ็”ป**๏ผšใƒ–ใƒฌใ‚คใƒณใ‚นใƒˆใƒผใƒŸใƒณใ‚ฐใ€่จญ่จˆใ€ใƒฏใƒผใ‚ฏใƒ•ใƒญใƒผใ€่ฆ‹็ฉใ‚‚ใ‚Š -- **้–‹็™บ**๏ผšๅฎŸ่ฃ…ใ€ใƒ“ใƒซใƒ‰ใ€git -- **ๅˆ†ๆž**๏ผšๅˆ†ๆžใ€ใƒˆใƒฉใƒ–ใƒซใ‚ทใƒฅใƒผใƒ†ใ‚ฃใƒณใ‚ฐใ€่ชฌๆ˜Ž -- **ๅ“่ณช**: ๆ”นๅ–„ใ€ใ‚ฏใƒชใƒผใƒณใ‚ขใƒƒใƒ—ใ€ใƒ†ใ‚นใƒˆใ€ใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆๅŒ– -- **็ฎก็†**: ใ‚ฟใ‚นใ‚ฏใ€ใ‚นใƒใƒผใƒณใ€ใƒญใƒผใƒ‰ใ€ไฟๅญ˜ใ€ๅๆ˜  -- **ใƒฆใƒผใƒ†ใ‚ฃใƒชใƒ†ใ‚ฃ**: ใ‚คใƒณใƒ‡ใƒƒใ‚ฏใ‚นใ€้ธๆŠžใƒ„ใƒผใƒซ - -**่ค‡้›‘ใ•ๅˆฅ:** - -- **ๅˆๅฟƒ่€…**๏ผšใƒ–ใƒฌใ‚คใƒณใ‚นใƒˆใƒผใƒŸใƒณใ‚ฐใ€ๅฎŸ่ฃ…ใ€ๅˆ†ๆžใ€ใƒ†ใ‚นใƒˆ -- **ไธญ็ดš**๏ผšใƒฏใƒผใ‚ฏใƒ•ใƒญใƒผใ€่จญ่จˆใ€ๆ”นๅ–„ใ€ใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆ -- **ไธŠ็ดš**๏ผšใ‚นใƒใƒผใƒณใ€ใ‚ฟใ‚นใ‚ฏใ€้ธๆŠžใƒ„ใƒผใƒซใ€ใƒชใƒ•ใƒฌใ‚ฏใƒˆ - -## ใƒˆใƒฉใƒ–ใƒซใ‚ทใƒฅใƒผใƒ†ใ‚ฃใƒณใ‚ฐ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#troubleshooting) - -**ใ‚ณใƒžใƒณใƒ‰ใฎๅ•้กŒ:** - -- **ใ‚ณใƒžใƒณใƒ‰ใŒ่ฆ‹ใคใ‹ใ‚Šใพใ›ใ‚“**: ใ‚คใƒณใ‚นใƒˆใƒผใƒซใ‚’็ขบ่ชใ—ใฆใใ ใ•ใ„:`python3 -m SuperClaude --version` -- **ๅฟœ็ญ”ใชใ—**: Claude Codeใ‚ปใƒƒใ‚ทใƒงใƒณใ‚’ๅ†้–‹ใ™ใ‚‹ -- **ๅ‡ฆ็†้…ๅปถ**:ย `--no-mcp`MCPใ‚ตใƒผใƒใƒผใชใ—ใงใƒ†ใ‚นใƒˆใ™ใ‚‹ใŸใ‚ใซไฝฟ็”จใ—ใพใ™ - -**ใ‚ฏใ‚คใƒƒใ‚ฏใƒ•ใ‚ฃใƒƒใ‚ฏใ‚น:** - -- ใ‚ปใƒƒใ‚ทใƒงใƒณใ‚’ใƒชใ‚ปใƒƒใƒˆ:`/sc:load`ๅ†ๅˆๆœŸๅŒ–ใ™ใ‚‹ -- ใ‚นใƒ†ใƒผใ‚ฟใ‚นใ‚’็ขบ่ช:`SuperClaude install --list-components` -- ใƒ˜ใƒซใƒ—:[ใƒˆใƒฉใƒ–ใƒซใ‚ทใƒฅใƒผใƒ†ใ‚ฃใƒณใ‚ฐใ‚ฌใ‚คใƒ‰](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Reference/troubleshooting.md) - -## ๆฌกใฎใ‚นใƒ†ใƒƒใƒ— - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#next-steps) - -- [ใƒ•ใƒฉใ‚ฐใ‚ฌใ‚คใƒ‰](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md)- ใ‚ณใƒžใƒณใƒ‰ใฎๅ‹•ไฝœใ‚’ๅˆถๅพกใ™ใ‚‹ -- [ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใ‚ฌใ‚คใƒ‰](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md)- ใ‚นใƒšใ‚ทใƒฃใƒชใ‚นใƒˆใฎใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ™ใƒผใ‚ทใƒงใƒณ -- [ไพ‹ใฎใ‚ฏใƒƒใ‚ฏใƒ–ใƒƒใ‚ฏ](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Reference/examples-cookbook.md)- ๅฎŸ้š›ใฎไฝฟ็”จใƒ‘ใ‚ฟใƒผใƒณ \ No newline at end of file diff --git a/docs/User-Guide-jp/flags.md b/docs/User-Guide-jp/flags.md deleted file mode 100644 index 2233aec..0000000 --- a/docs/User-Guide-jp/flags.md +++ /dev/null @@ -1,388 +0,0 @@ -# SuperClaude ใƒ•ใƒฉใ‚ฐใ‚ฌใ‚คใƒ‰ ๐Ÿ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#superclaude-flags-guide-) - -**ใปใจใ‚“ใฉใฎใƒ•ใƒฉใ‚ฐใฏ่‡ชๅ‹•็š„ใซใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ–ใซใชใ‚Šใพใ™**ใ€‚Claude Code ใฏใ€ใƒชใ‚ฏใ‚จใ‚นใƒˆๅ†…ใฎใ‚ญใƒผใƒฏใƒผใƒ‰ใจใƒ‘ใ‚ฟใƒผใƒณใซๅŸบใฅใ„ใฆ้ฉๅˆ‡ใชใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆใ‚’ๅฎŸ่กŒใ™ใ‚‹ใŸใ‚ใฎๅ‹•ไฝœๆŒ‡็คบใ‚’่ชญใฟๅ–ใ‚Šใพใ™ใ€‚ - -## ๅฟ…้ ˆใฎ่‡ชๅ‹•ใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ™ใƒผใ‚ทใƒงใƒณใƒ•ใƒฉใ‚ฐ๏ผˆใƒฆใƒผใ‚นใ‚ฑใƒผใ‚นใฎ90%๏ผ‰ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#essential-auto-activation-flags-90-of-use-cases) - -### ใ‚ณใ‚ขๅˆ†ๆžใƒ•ใƒฉใ‚ฐ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#core-analysis-flags) - -|ใƒ•ใƒฉใ‚ฐ|่ตทๅ‹•ๆ™‚|ไฝ•ใ‚’ใ™ใ‚‹ใฎใ‹| -|---|---|---| -|`--think`|5ใคไปฅไธŠใฎใƒ•ใ‚กใ‚คใƒซใพใŸใฏ่ค‡้›‘ใชๅˆ†ๆž|ๆจ™ๆบ–็š„ใชๆง‹้€ ๅŒ–ๅˆ†ๆž๏ผˆ็ด„4Kใƒˆใƒผใ‚ฏใƒณ๏ผ‰| -|`--think-hard`|ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃๅˆ†ๆžใ€ใ‚ทใ‚นใƒ†ใƒ ไพๅญ˜้–ขไฟ‚|ๅผทๅŒ–ใ•ใ‚ŒใŸใƒ„ใƒผใƒซใซใ‚ˆใ‚‹่ฉณ็ดฐใชๅˆ†ๆž๏ผˆ็ด„1ไธ‡ใƒˆใƒผใ‚ฏใƒณ๏ผ‰| -|`--ultrathink`|้‡่ฆใชใ‚ทใ‚นใƒ†ใƒ ใฎๅ†่จญ่จˆใ€ใƒฌใ‚ฌใ‚ทใƒผใ‚ทใ‚นใƒ†ใƒ ใฎ่ฟ‘ไปฃๅŒ–|ใ™ในใฆใฎใƒ„ใƒผใƒซใงๆœ€ๅคงๆทฑๅบฆๅˆ†ๆž๏ผˆ็ด„32Kใƒˆใƒผใ‚ฏใƒณ๏ผ‰| - -### MCP ใ‚ตใƒผใƒใƒผใƒ•ใƒฉใ‚ฐ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#mcp-server-flags) - -|ใƒ•ใƒฉใ‚ฐ|ใ‚ตใƒผใƒ|็›ฎ็š„|่‡ชๅ‹•ใƒˆใƒชใ‚ฌใƒผ| -|---|---|---|---| -|`--c7`/`--context7`|ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆ7|ๅ…ฌๅผใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆใ€ใƒ•ใƒฌใƒผใƒ ใƒฏใƒผใ‚ฏใƒ‘ใ‚ฟใƒผใƒณ|ใƒฉใ‚คใƒ–ใƒฉใƒชใฎใ‚คใƒณใƒใƒผใƒˆใ€ใƒ•ใƒฌใƒผใƒ ใƒฏใƒผใ‚ฏใซ้–ขใ™ใ‚‹่ณชๅ•| -|`--seq`/`--sequential`|ไธ€้€ฃ|ๅคšๆฎต้šŽๆŽจ่ซ–ใ€ใƒ‡ใƒใƒƒใ‚ฐ|่ค‡้›‘ใชใƒ‡ใƒใƒƒใ‚ฐใ€ใ‚ทใ‚นใƒ†ใƒ ่จญ่จˆ| -|`--magic`|้ญ”ๆณ•|UIใ‚ณใƒณใƒใƒผใƒใƒณใƒˆ็”Ÿๆˆ|`/ui`ใ‚ณใƒžใƒณใƒ‰ใ€ใƒ•ใƒญใƒณใƒˆใ‚จใƒณใƒ‰ใ‚ญใƒผใƒฏใƒผใƒ‰| -|`--play`/`--playwright`|ๅŠ‡ไฝœๅฎถ|ใƒ–ใƒฉใ‚ฆใ‚ถใƒ†ใ‚นใƒˆใ€E2Eๆคœ่จผ|ใƒ†ใ‚นใƒˆ่ฆๆฑ‚ใ€่ฆ–่ฆš็š„ๆคœ่จผ| -|`--morph`/`--morphllm`|ใƒขใƒซใƒ•ใ‚ฃใƒ |ไธ€ๆ‹ฌๅค‰ๆ›ใ€ใƒ‘ใ‚ฟใƒผใƒณ็ทจ้›†|ไธ€ๆ‹ฌๆ“ไฝœใ€ใ‚นใ‚ฟใ‚คใƒซใฎๅผทๅˆถ| -|`--serena`|ใ‚ปใƒฌใƒŠ|ใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใƒกใƒขใƒชใ€ใ‚ทใƒณใƒœใƒซๆ“ไฝœ|ใ‚ทใƒณใƒœใƒซๆ“ไฝœใ€ๅคง่ฆๆจกใชใ‚ณใƒผใƒ‰ใƒ™ใƒผใ‚น| - -### ๅ‹•ไฝœใƒขใƒผใƒ‰ใƒ•ใƒฉใ‚ฐ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#behavioral-mode-flags) - -|ใƒ•ใƒฉใ‚ฐ|่ตทๅ‹•ๆ™‚|ไฝ•ใ‚’ใ™ใ‚‹ใฎใ‹| -|---|---|---| -|`--brainstorm`|ๆผ ็„ถใจใ—ใŸ่ฆๆœ›ใ€ๆŽข็ดขใ‚ญใƒผใƒฏใƒผใƒ‰|ๅ…ฑๅŒ็™บ่ฆ‹ใฎใƒžใ‚คใƒณใƒ‰ใ‚ปใƒƒใƒˆ| -|`--introspect`|่‡ชๅทฑๅˆ†ๆžใ€ใ‚จใƒฉใƒผๅ›žๅพฉ|ๆŽจ่ซ–ใƒ—ใƒญใ‚ปใ‚นใ‚’้€ๆ˜Žๆ€งใ‚’ๆŒใฃใฆๅ…ฌ้–‹ใ™ใ‚‹| -|`--task-manage`|>3ใ‚นใƒ†ใƒƒใƒ—ใ€่ค‡้›‘ใชใ‚นใ‚ณใƒผใƒ—|ๅง”ไปปใ‚’้€šใ˜ใฆ่ชฟๆ•ดใ™ใ‚‹| -|`--orchestrate`|ใƒžใƒซใƒใƒ„ใƒผใƒซๆ“ไฝœใ€ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใƒ‹ใƒผใ‚บ|ใƒ„ใƒผใƒซใฎ้ธๆŠžใจไธฆๅˆ—ๅฎŸ่กŒใฎๆœ€้ฉๅŒ–| -|`--token-efficient`/`--uc`|ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆ >75%ใ€ๅŠน็Ž‡ๆ€งใฎใƒ‹ใƒผใ‚บ|ใ‚ทใƒณใƒœใƒซๅผทๅŒ–้€šไฟกใ€30๏ฝž50%ๅ‰Šๆธ›| - -### ๅฎŸ่กŒๅˆถๅพกใƒ•ใƒฉใ‚ฐ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#execution-control-flags) - -|ใƒ•ใƒฉใ‚ฐ|่ตทๅ‹•ๆ™‚|ไฝ•ใ‚’ใ™ใ‚‹ใฎใ‹| -|---|---|---| -|`--loop`|ใ€Œๆ”นๅ–„ใ™ใ‚‹ใ€ใ€Œ็ฃจใใ€ใ€Œๆด—็ทดใ™ใ‚‹ใ€ใจใ„ใ†ใ‚ญใƒผใƒฏใƒผใƒ‰|ๅๅพฉ็š„ใชๅผทๅŒ–ใ‚ตใ‚คใ‚ฏใƒซ| -|`--safe-mode`|็”Ÿ็”ฃใ€ใƒชใ‚ฝใƒผใ‚นไฝฟ็”จ็Ž‡85%ไปฅไธŠ|ๆœ€ๅคง้™ใฎๆคœ่จผใ€ๆ…Ž้‡ใชๅฎŸ่กŒ| -|`--validate`|ใƒชใ‚นใ‚ฏ >0.7ใ€ๆœฌ็•ช็’ฐๅขƒ|ๅฎŸ่กŒๅ‰ใฎใƒชใ‚นใ‚ฏ่ฉ•ไพก| -|`--delegate`|>7 ใƒ‡ใ‚ฃใƒฌใ‚ฏใƒˆใƒชใพใŸใฏ >50 ใƒ•ใ‚กใ‚คใƒซ|ใ‚ตใƒ–ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆไธฆๅˆ—ๅ‡ฆ็†| - -## ใ‚ณใƒžใƒณใƒ‰ๅ›บๆœ‰ใฎใƒ•ใƒฉใ‚ฐ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#command-specific-flags) - -### ๅˆ†ๆžใ‚ณใƒžใƒณใƒ‰ใƒ•ใƒฉใ‚ฐ๏ผˆ`/sc:analyze`๏ผ‰ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#analysis-command-flags-scanalyze) - -|ใƒ•ใƒฉใ‚ฐ|็›ฎ็š„|ไพกๅ€ค่ฆณ| -|---|---|---| -|`--focus`|็‰นๅฎšใฎใƒ‰ใƒกใ‚คใƒณใ‚’ใ‚ฟใƒผใ‚ฒใƒƒใƒˆใจใ™ใ‚‹|`security`ใ€ใ€ใ€ใ€`performance`โ€‹`quality`โ€‹`architecture`| -|`--depth`|ๅˆ†ๆžใฎๅพนๅบ•ๆ€ง|`quick`ใ€`deep`| -|`--format`|ๅ‡บๅŠ›ๅฝขๅผ|`text`ใ€ใ€`json`โ€‹`report`| - -### ใƒ“ใƒซใƒ‰ใ‚ณใƒžใƒณใƒ‰ใƒ•ใƒฉใ‚ฐ๏ผˆ`/sc:build`๏ผ‰ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#build-command-flags-scbuild) - -|ใƒ•ใƒฉใ‚ฐ|็›ฎ็š„|ไพกๅ€ค่ฆณ| -|---|---|---| -|`--type`|ใƒ“ใƒซใƒ‰ๆง‹ๆˆ|`dev`ใ€ใ€`prod`โ€‹`test`| -|`--clean`|ใƒ“ใƒซใƒ‰ๅ‰ใซใ‚ฏใƒชใƒผใƒณใ‚ขใƒƒใƒ—|ใƒ–ใƒผใƒซๅ€ค| -|`--optimize`|ๆœ€้ฉๅŒ–ใ‚’ๆœ‰ๅŠนใซใ™ใ‚‹|ใƒ–ใƒผใƒซๅ€ค| -|`--verbose`|่ฉณ็ดฐใชๅ‡บๅŠ›|ใƒ–ใƒผใƒซๅ€ค| - -### ่จญ่จˆใ‚ณใƒžใƒณใƒ‰ใƒ•ใƒฉใ‚ฐ๏ผˆ`/sc:design`๏ผ‰ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#design-command-flags-scdesign) - -|ใƒ•ใƒฉใ‚ฐ|็›ฎ็š„|ไพกๅ€ค่ฆณ| -|---|---|---| -|`--type`|่จญ่จˆ็›ฎๆจ™|`architecture`ใ€ใ€ใ€ใ€`api`โ€‹`component`โ€‹`database`| -|`--format`|ๅ‡บๅŠ›ๅฝขๅผ|`diagram`ใ€ใ€`spec`โ€‹`code`| - -### ใ‚ณใƒžใƒณใƒ‰ใƒ•ใƒฉใ‚ฐใฎ่ชฌๆ˜Ž๏ผˆ`/sc:explain`๏ผ‰ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#explain-command-flags-scexplain) - -|ใƒ•ใƒฉใ‚ฐ|็›ฎ็š„|ไพกๅ€ค่ฆณ| -|---|---|---| -|`--level`|่ค‡้›‘ใ•ใฎใƒฌใƒ™ใƒซ|`basic`ใ€ใ€`intermediate`โ€‹`advanced`| -|`--format`|่ชฌๆ˜Žใ‚นใ‚ฟใ‚คใƒซ|`text`ใ€ใ€`examples`โ€‹`interactive`| -|`--context`|ใƒ‰ใƒกใ‚คใƒณใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆ|ไปปๆ„ใฎใƒ‰ใƒกใ‚คใƒณ๏ผˆไพ‹๏ผš`react`ใ€`security`๏ผ‰| - -### ใ‚ณใƒžใƒณใƒ‰ใƒ•ใƒฉใ‚ฐใฎๆ”นๅ–„๏ผˆ`/sc:improve`๏ผ‰ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#improve-command-flags-scimprove) - -|ใƒ•ใƒฉใ‚ฐ|็›ฎ็š„|ไพกๅ€ค่ฆณ| -|---|---|---| -|`--type`|ๆ”นๅ–„ใฎ็„ฆ็‚น|`quality`ใ€ใ€ใ€ใ€ใ€`performance`โ€‹`maintainability`โ€‹`style`โ€‹`security`| -|`--safe`|ไฟๅฎˆ็š„ใชใ‚ขใƒ—ใƒญใƒผใƒ|ใƒ–ใƒผใƒซๅ€ค| -|`--interactive`|ใƒฆใƒผใ‚ถใƒผใ‚ฌใ‚คใƒ€ใƒณใ‚น|ใƒ–ใƒผใƒซๅ€ค| -|`--preview`|ๅฎŸ่กŒใ›ใšใซ่กจ็คบใ™ใ‚‹|ใƒ–ใƒผใƒซๅ€ค| - -### ใ‚ฟใ‚นใ‚ฏใ‚ณใƒžใƒณใƒ‰ใƒ•ใƒฉใ‚ฐ๏ผˆ`/sc:task`๏ผ‰ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#task-command-flags-sctask) - -|ใƒ•ใƒฉใ‚ฐ|็›ฎ็š„|ไพกๅ€ค่ฆณ| -|---|---|---| -|`--strategy`|ใ‚ฟใ‚นใ‚ฏใ‚ขใƒ—ใƒญใƒผใƒ|`systematic`ใ€ใ€`agile`โ€‹`enterprise`| -|`--parallel`|ไธฆๅˆ—ๅฎŸ่กŒ|ใƒ–ใƒผใƒซๅ€ค| -|`--delegate`|ใ‚ตใƒ–ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฎ่ชฟๆ•ด|ใƒ–ใƒผใƒซๅ€ค| - -### ใƒฏใƒผใ‚ฏใƒ•ใƒญใƒผใ‚ณใƒžใƒณใƒ‰ใƒ•ใƒฉใ‚ฐ๏ผˆ`/sc:workflow`๏ผ‰ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#workflow-command-flags-scworkflow) - -|ใƒ•ใƒฉใ‚ฐ|็›ฎ็š„|ไพกๅ€ค่ฆณ| -|---|---|---| -|`--strategy`|ใƒฏใƒผใ‚ฏใƒ•ใƒญใƒผใ‚ขใƒ—ใƒญใƒผใƒ|`systematic`ใ€ใ€`agile`โ€‹`enterprise`| -|`--depth`|ๅˆ†ๆžใฎๆทฑใ•|`shallow`ใ€ใ€`normal`โ€‹`deep`| -|`--parallel`|ไธฆๅˆ—่ชฟๆ•ด|ใƒ–ใƒผใƒซๅ€ค| - -### ใ‚ณใƒžใƒณใƒ‰ใƒ•ใƒฉใ‚ฐใฎใƒˆใƒฉใƒ–ใƒซใ‚ทใƒฅใƒผใƒ†ใ‚ฃใƒณใ‚ฐ (ย `/sc:troubleshoot`) - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#troubleshoot-command-flags-sctroubleshoot) - -|ใƒ•ใƒฉใ‚ฐ|็›ฎ็š„|ไพกๅ€ค่ฆณ| -|---|---|---| -|`--type`|ๅ•้กŒใ‚ซใƒ†ใ‚ดใƒช|`bug`ใ€ใ€ใ€ใ€`build`โ€‹`performance`โ€‹`deployment`| -|`--trace`|ใƒˆใƒฌใƒผใ‚นๅˆ†ๆžใ‚’ๅซใ‚ใ‚‹|ใƒ–ใƒผใƒซๅ€ค| -|`--fix`|ไฟฎๆญฃใ‚’้ฉ็”จใ™ใ‚‹|ใƒ–ใƒผใƒซๅ€ค| - -### ใ‚ฏใƒชใƒผใƒณใ‚ขใƒƒใƒ—ใ‚ณใƒžใƒณใƒ‰ใƒ•ใƒฉใ‚ฐ๏ผˆ`/sc:cleanup`๏ผ‰ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#cleanup-command-flags-sccleanup) - -|ใƒ•ใƒฉใ‚ฐ|็›ฎ็š„|ไพกๅ€ค่ฆณ| -|---|---|---| -|`--type`|ใ‚ฏใƒชใƒผใƒณใ‚ขใƒƒใƒ—ๅฏพ่ฑก|`code`ใ€ใ€ใ€ใ€`imports`โ€‹`files`โ€‹`all`| -|`--safe`/`--aggressive`|ๆธ…ๆŽƒๅผทๅบฆ|ใƒ–ใƒผใƒซๅ€ค| -|`--interactive`|ใƒฆใƒผใ‚ถใƒผใ‚ฌใ‚คใƒ€ใƒณใ‚น|ใƒ–ใƒผใƒซๅ€ค| -|`--preview`|ๅฎŸ่กŒใ›ใšใซ่กจ็คบใ™ใ‚‹|ใƒ–ใƒผใƒซๅ€ค| - -### ใ‚ณใƒžใƒณใƒ‰ใƒ•ใƒฉใ‚ฐใฎๆŽจๅฎš๏ผˆ`/sc:estimate`๏ผ‰ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#estimate-command-flags-scestimate) - -|ใƒ•ใƒฉใ‚ฐ|็›ฎ็š„|ไพกๅ€ค่ฆณ| -|---|---|---| -|`--type`|็„ฆ็‚นใ‚’ๆŽจๅฎšใ™ใ‚‹|`time`ใ€ใ€`effort`โ€‹`complexity`| -|`--unit`|ๆ™‚้–“ๅ˜ไฝ|`hours`ใ€ใ€`days`โ€‹`weeks`| -|`--breakdown`|่ฉณ็ดฐใชๅ†…่จณ|ใƒ–ใƒผใƒซๅ€ค| - -### ใ‚คใƒณใƒ‡ใƒƒใ‚ฏใ‚นใ‚ณใƒžใƒณใƒ‰ใƒ•ใƒฉใ‚ฐ๏ผˆ`/sc:index`๏ผ‰ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#index-command-flags-scindex) - -|ใƒ•ใƒฉใ‚ฐ|็›ฎ็š„|ไพกๅ€ค่ฆณ| -|---|---|---| -|`--type`|ใ‚คใƒณใƒ‡ใƒƒใ‚ฏใ‚นใ‚ฟใƒผใ‚ฒใƒƒใƒˆ|`docs`ใ€ใ€ใ€ใ€`api`โ€‹`structure`โ€‹`readme`| -|`--format`|ๅ‡บๅŠ›ๅฝขๅผ|`md`ใ€ใ€`json`โ€‹`yaml`| - -### ใ‚ณใƒžใƒณใƒ‰ใƒ•ใƒฉใ‚ฐใ‚’ๅๆ˜ ใ™ใ‚‹ (ย `/sc:reflect`) - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#reflect-command-flags-screflect) - -|ใƒ•ใƒฉใ‚ฐ|็›ฎ็š„|ไพกๅ€ค่ฆณ| -|---|---|---| -|`--type`|ๅๅฐ„ใ‚นใ‚ณใƒผใƒ—|`task`ใ€ใ€`session`โ€‹`completion`| -|`--analyze`|ๅˆ†ๆžใ‚’ๅซใ‚ใ‚‹|ใƒ–ใƒผใƒซๅ€ค| -|`--validate`|ๅฎŒๅ…จๆ€งใ‚’ๆคœ่จผใ™ใ‚‹|ใƒ–ใƒผใƒซๅ€ค| - -### ใ‚นใƒใƒผใƒณใ‚ณใƒžใƒณใƒ‰ใƒ•ใƒฉใ‚ฐ๏ผˆ`/sc:spawn`๏ผ‰ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#spawn-command-flags-scspawn) - -|ใƒ•ใƒฉใ‚ฐ|็›ฎ็š„|ไพกๅ€ค่ฆณ| -|---|---|---| -|`--strategy`|่ชฟๆ•ดใ‚ขใƒ—ใƒญใƒผใƒ|`sequential`ใ€ใ€`parallel`โ€‹`adaptive`| -|`--depth`|ๅˆ†ๆžใฎๆทฑใ•|`normal`ใ€`deep`| - -### Gitใ‚ณใƒžใƒณใƒ‰ใƒ•ใƒฉใ‚ฐ๏ผˆ`/sc:git`๏ผ‰ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#git-command-flags-scgit) - -|ใƒ•ใƒฉใ‚ฐ|็›ฎ็š„|ไพกๅ€ค่ฆณ| -|---|---|---| -|`--smart-commit`|ใ‚ณใƒŸใƒƒใƒˆใƒกใƒƒใ‚ปใƒผใ‚ธใ‚’็”Ÿๆˆใ™ใ‚‹|ใƒ–ใƒผใƒซๅ€ค| -|`--interactive`|ใ‚ฌใ‚คใƒ‰ไป˜ใๆ“ไฝœ|ใƒ–ใƒผใƒซๅ€ค| - -### ้ธๆŠžใƒ„ใƒผใƒซใ‚ณใƒžใƒณใƒ‰ใƒ•ใƒฉใ‚ฐ (ย `/sc:select-tool`) - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#select-tool-command-flags-scselect-tool) - -|ใƒ•ใƒฉใ‚ฐ|็›ฎ็š„|ไพกๅ€ค่ฆณ| -|---|---|---| -|`--analyze`|ใƒ„ใƒผใƒซๅˆ†ๆž|ใƒ–ใƒผใƒซๅ€ค| -|`--explain`|้ธๆŠžใฎ่ชฌๆ˜Ž|ใƒ–ใƒผใƒซๅ€ค| - -### ใƒ†ใ‚นใƒˆใ‚ณใƒžใƒณใƒ‰ใƒ•ใƒฉใ‚ฐ๏ผˆ`/sc:test`๏ผ‰ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#test-command-flags-sctest) - -|ใƒ•ใƒฉใ‚ฐ|็›ฎ็š„|ไพกๅ€ค่ฆณ| -|---|---|---| -|`--coverage`|ใ‚ซใƒใƒผ็ฏ„ๅ›ฒใ‚’ๅซใ‚ใ‚‹|ใƒ–ใƒผใƒซๅ€ค| -|`--type`|ใƒ†ใ‚นใƒˆใฎ็จฎ้กž|`unit`ใ€ใ€`integration`โ€‹`e2e`| -|`--watch`|ใ‚ฆใ‚ฉใƒƒใƒใƒขใƒผใƒ‰|ใƒ–ใƒผใƒซๅ€ค| - -## ้ซ˜ๅบฆใชๅˆถๅพกใƒ•ใƒฉใ‚ฐ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#advanced-control-flags) - -### ็ฏ„ๅ›ฒใจ็„ฆ็‚น - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#scope-and-focus) - -|ใƒ•ใƒฉใ‚ฐ|็›ฎ็š„|ไพกๅ€ค่ฆณ| -|---|---|---| -|`--scope`|ๅˆ†ๆžๅขƒ็•Œ|`file`ใ€ใ€ใ€ใ€`module`โ€‹`project`โ€‹`system`| -|`--focus`|ใƒ‰ใƒกใ‚คใƒณใ‚ฟใƒผใ‚ฒใƒ†ใ‚ฃใƒณใ‚ฐ|`performance`ใ€ใ€ใ€ใ€ใ€ใ€`security`โ€‹`quality`โ€‹`architecture`โ€‹`accessibility`โ€‹`testing`| - -### ๅฎŸ่กŒๅˆถๅพก - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#execution-control) - -|ใƒ•ใƒฉใ‚ฐ|็›ฎ็š„|ไพกๅ€ค่ฆณ| -|---|---|---| -|`--concurrency [n]`|ไธฆๅˆ—ใ‚ชใƒšใƒฌใƒผใ‚ทใƒงใƒณใ‚’ๅˆถๅพกใ™ใ‚‹|1-15| -|`--iterations [n]`|ๆ”นๅ–„ใ‚ตใ‚คใ‚ฏใƒซ|1-10| -|`--all-mcp`|ใ™ในใฆใฎMCPใ‚ตใƒผใƒใƒผใ‚’ๆœ‰ๅŠนใซใ™ใ‚‹|ใƒ–ใƒผใƒซๅ€ค| -|`--no-mcp`|ใƒใ‚คใƒ†ใ‚ฃใƒ–ใƒ„ใƒผใƒซใฎใฟ|ใƒ–ใƒผใƒซๅ€ค| - -### ใ‚ทใ‚นใƒ†ใƒ ใƒ•ใƒฉใ‚ฐ๏ผˆSuperClaude ใ‚คใƒณใ‚นใƒˆใƒผใƒซ๏ผ‰ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#system-flags-superclaude-installation) - -|ใƒ•ใƒฉใ‚ฐ|็›ฎ็š„|ไพกๅ€ค่ฆณ| -|---|---|---| -|`--verbose`/`-v`|่ฉณ็ดฐใƒญใ‚ฐ|ใƒ–ใƒผใƒซๅ€ค| -|`--quiet`/`-q`|ๅ‡บๅŠ›ใ‚’ๆŠ‘ๅˆถใ™ใ‚‹|ใƒ–ใƒผใƒซๅ€ค| -|`--dry-run`|ๆ“ไฝœใ‚’ใ‚ทใƒŸใƒฅใƒฌใƒผใ‚ทใƒงใƒณใ™ใ‚‹|ใƒ–ใƒผใƒซๅ€ค| -|`--force`|ใƒใ‚งใƒƒใ‚ฏใ‚’ใ‚นใ‚ญใƒƒใƒ—ใ™ใ‚‹|ใƒ–ใƒผใƒซๅ€ค| -|`--yes`/`-y`|่‡ชๅ‹•็ขบ่ช|ใƒ–ใƒผใƒซๅ€ค| -|`--install-dir`|ใ‚ฟใƒผใ‚ฒใƒƒใƒˆใƒ‡ใ‚ฃใƒฌใ‚ฏใƒˆใƒช|ใƒ‘ใ‚น| -|`--legacy`|ใƒฌใ‚ฌใ‚ทใƒผใ‚นใ‚ฏใƒชใƒ—ใƒˆใ‚’ไฝฟ็”จใ™ใ‚‹|ใƒ–ใƒผใƒซๅ€ค| -|`--version`|ใƒใƒผใ‚ธใƒงใƒณใ‚’่กจ็คบ|ใƒ–ใƒผใƒซๅ€ค| -|`--help`|ใƒ˜ใƒซใƒ—ใ‚’่กจ็คบ|ใƒ–ใƒผใƒซๅ€ค| - -## ไธ€่ˆฌ็š„ใชไฝฟ็”จใƒ‘ใ‚ฟใƒผใƒณ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#common-usage-patterns) - -### ใƒ•ใƒญใƒณใƒˆใ‚จใƒณใƒ‰้–‹็™บ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#frontend-development) - -```shell -/sc:implement "responsive dashboard" --magic --c7 -/sc:design component-library --type component --format code -/sc:test ui-components/ --magic --play -/sc:improve legacy-ui/ --magic --morph --validate -``` - -### ใƒใƒƒใ‚ฏใ‚จใƒณใƒ‰้–‹็™บ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#backend-development) - -```shell -/sc:analyze api/ --focus performance --seq --think -/sc:design payment-api --type api --format spec -/sc:troubleshoot "API timeout" --type performance --trace -/sc:improve auth-service --type security --validate -``` - -### ๅคง่ฆๆจกใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#large-projects) - -```shell -/sc:analyze . --ultrathink --all-mcp --safe-mode -/sc:workflow enterprise-system --strategy enterprise --depth deep -/sc:cleanup . --type all --safe --interactive -/sc:estimate "migrate to microservices" --type complexity --breakdown -``` - -### ๅ“่ณชใจใƒกใƒณใƒ†ใƒŠใƒณใ‚น - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#quality--maintenance) - -```shell -/sc:improve src/ --type quality --safe --interactive -/sc:cleanup imports --type imports --preview -/sc:reflect --type completion --validate -/sc:git commit --smart-commit -``` - -## ใƒ•ใƒฉใ‚ฐใ‚คใƒณใ‚ฟใƒฉใ‚ฏใ‚ทใƒงใƒณ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#flag-interactions) - -### ไบ’ๆ›ๆ€งใฎใ‚ใ‚‹็ต„ใฟๅˆใ‚ใ› - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#compatible-combinations) - -- `--think`+ย `--c7`: ใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆไป˜ใๅˆ†ๆž -- `--magic`+ย `--play`: ใƒ†ใ‚นใƒˆไป˜ใใฎUI็”Ÿๆˆ -- `--serena`+ย `--morph`: ๅค‰ๆ›ใซใ‚ˆใ‚‹ใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใƒกใƒขใƒช -- `--safe-mode`+ย `--validate`: ๆœ€ๅคง้™ใฎๅฎ‰ๅ…จๆ€ง -- `--loop`+ย `--validate`: ๆคœ่จผใ‚’ไผดใ†ๅๅพฉ็š„ใชๆ”นๅ–„ - -### ็ซถๅˆใ™ใ‚‹ใƒ•ใƒฉใ‚ฐ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#conflicting-flags) - -- `--all-mcp`ๅ€‹ๅˆฅใฎMCPใƒ•ใƒฉใ‚ฐใจๆฏ”่ผƒ๏ผˆใฉใกใ‚‰ใ‹ไธ€ๆ–นใ‚’ไฝฟ็”จ๏ผ‰ -- `--no-mcp`ไปปๆ„ใฎMCPใƒ•ใƒฉใ‚ฐใจๆฏ”่ผƒ๏ผˆ--no-mcpใŒๅ„ชๅ…ˆ๏ผ‰ -- `--safe`vsย `--aggressive`๏ผˆใ‚ฏใƒชใƒผใƒณใ‚ขใƒƒใƒ—ๅผทๅบฆ๏ผ‰ -- `--quiet`vsย `--verbose`๏ผˆๅ‡บๅŠ›ใƒฌใƒ™ใƒซ๏ผ‰ - -### ้–ขไฟ‚ใฎ่‡ชๅ‹•ๆœ‰ๅŠนๅŒ– - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#auto-enabling-relationships) - -- `--safe-mode`่‡ชๅ‹•็š„`--uc`ใซๆœ‰ๅŠนใซใชใ‚Šใ€`--validate` -- `--ultrathink`ใ™ในใฆใฎMCPใ‚ตใƒผใƒใƒผใ‚’่‡ชๅ‹•็š„ใซๆœ‰ๅŠนใซใ™ใ‚‹ -- `--think-hard`่‡ชๅ‹•็š„ใซๆœ‰ๅŠนใซใชใ‚Šใพใ™`--seq`+`--c7` -- `--magic`UIใซ้‡็‚นใ‚’็ฝฎใ„ใŸใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใ‚’่ตทๅ‹•ใ™ใ‚‹ - -## ใƒˆใƒฉใƒ–ใƒซใ‚ทใƒฅใƒผใƒ†ใ‚ฃใƒณใ‚ฐใƒ•ใƒฉใ‚ฐ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#troubleshooting-flags) - -### ใ‚ˆใใ‚ใ‚‹ๅ•้กŒ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#common-issues) - -- **ใƒ„ใƒผใƒซใŒๅคšใ™ใŽใ‚‹**:`--no-mcp`ใƒใ‚คใƒ†ใ‚ฃใƒ–ใƒ„ใƒผใƒซใฎใฟใงใƒ†ใ‚นใƒˆใ™ใ‚‹ -- **ๆ“ไฝœใŒ้…ใ™ใŽใพใ™**:`--uc`ๅ‡บๅŠ›ใ‚’ๅœง็ธฎใ™ใ‚‹ใŸใ‚ใซ่ฟฝๅŠ ใ—ใพใ™ -- **ๆคœ่จผใƒ–ใƒญใƒƒใ‚ญใƒณใ‚ฐ**:้–‹็™บใง`--validate`ใฏไปฃใ‚ใ‚Šใซไฝฟ็”จใ—ใฆใใ ใ•ใ„`--safe-mode` -- **ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆๅœงๅŠ›**:`--token-efficient`ไฝฟ็”จ็Ž‡ใŒ75%ใ‚’่ถ…ใˆใ‚‹ใจ่‡ชๅ‹•็š„ใซใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ–ๅŒ–ใ•ใ‚Œใพใ™ - -### ใƒ‡ใƒใƒƒใ‚ฐใƒ•ใƒฉใ‚ฐ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#debug-flags) - -```shell -/sc:analyze . --verbose # Shows decision logic and flag activation -/sc:select-tool "operation" --explain # Explains tool selection process -/sc:reflect --type session --analyze # Reviews current session decisions -``` - -### ใ‚ฏใ‚คใƒƒใ‚ฏใƒ•ใ‚ฃใƒƒใ‚ฏใ‚น - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#quick-fixes) - -```shell -/sc:analyze . --help # Shows available flags for command -/sc:analyze . --no-mcp # Native execution only -/sc:cleanup . --preview # Shows what would be cleaned -``` - -## ใƒ•ใƒฉใ‚ฐใฎๅ„ชๅ…ˆใƒซใƒผใƒซ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#flag-priority-rules) - -1. **ๅฎ‰ๅ…จ็ฌฌไธ€**:ย `--safe-mode`>ย `--validate`> ๆœ€้ฉๅŒ–ใƒ•ใƒฉใ‚ฐ -2. **ๆ˜Ž็คบ็š„ใชใ‚ชใƒผใƒใƒผใƒฉใ‚คใƒ‰**: ใƒฆใƒผใ‚ถใƒผใƒ•ใƒฉใ‚ฐ > ่‡ชๅ‹•ๆคœๅ‡บ -3. **ๆทฑๅบฆ้šŽๅฑค**๏ผš`--ultrathink`>ย `--think-hard`>`--think` -4. **MCPๅˆถๅพก**:`--no-mcp`ใ™ในใฆใฎMCPใƒ•ใƒฉใ‚ฐใ‚’ไธŠๆ›ธใใ—ใพใ™ -5. **ใ‚นใ‚ณใƒผใƒ—ใฎๅ„ชๅ…ˆ้ †ไฝ**: ใ‚ทใ‚นใƒ†ใƒ  > ใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆ > ใƒขใ‚ธใƒฅใƒผใƒซ > ใƒ•ใ‚กใ‚คใƒซ - -## ้–ข้€ฃใƒชใ‚ฝใƒผใ‚น - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#related-resources) - -- [ใ‚ณใƒžใƒณใƒ‰ใ‚ฌใ‚คใƒ‰](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md)- ใ“ใ‚Œใ‚‰ใฎใƒ•ใƒฉใ‚ฐใ‚’ไฝฟ็”จใ™ใ‚‹ใ‚ณใƒžใƒณใƒ‰ -- [MCP ใ‚ตใƒผใƒใƒผใ‚ฌใ‚คใƒ‰](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/mcp-servers.md)- MCP ใƒ•ใƒฉใ‚ฐใฎใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ–ๅŒ–ใซใคใ„ใฆ -- [ใ‚ปใƒƒใ‚ทใƒงใƒณ็ฎก็†](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md)- ๆฐธ็ถšใ‚ปใƒƒใ‚ทใƒงใƒณใงใฎใƒ•ใƒฉใ‚ฐใฎไฝฟ็”จ \ No newline at end of file diff --git a/docs/User-Guide-jp/mcp-servers.md b/docs/User-Guide-jp/mcp-servers.md deleted file mode 100644 index 284a05f..0000000 --- a/docs/User-Guide-jp/mcp-servers.md +++ /dev/null @@ -1,319 +0,0 @@ -# SuperClaude MCP ใ‚ตใƒผใƒใƒผใ‚ฌใ‚คใƒ‰ ๐Ÿ”Œ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/mcp-servers.md#superclaude-mcp-servers-guide-) - -## ๆฆ‚่ฆ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/mcp-servers.md#overview) - -MCP๏ผˆใƒขใƒ‡ใƒซใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆใƒ—ใƒญใƒˆใ‚ณใƒซ๏ผ‰ใ‚ตใƒผใƒใƒผใฏใ€ๅฐ‚็”จใƒ„ใƒผใƒซใ‚’้€šใ˜ใฆClaude CodeใฎๆฉŸ่ƒฝใ‚’ๆ‹กๅผตใ—ใพใ™ใ€‚SuperClaudeใฏ6ใคใฎMCPใ‚ตใƒผใƒใƒผใ‚’็ตฑๅˆใ—ใ€ใ‚ฟใ‚นใ‚ฏใซๅฟœใ˜ใฆใ‚ตใƒผใƒใƒผใ‚’ใ„ใค่ตทๅ‹•ใ™ใ‚‹ใ‹ใ‚’ClaudeใซๆŒ‡็คบใ—ใพใ™ใ€‚ - -### ๐Ÿ” ็พๅฎŸใƒใ‚งใƒƒใ‚ฏ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/mcp-servers.md#-reality-check) - -- **MCPใ‚ตใƒผใƒใƒผใจใฏ**: ่ฟฝๅŠ ใƒ„ใƒผใƒซใ‚’ๆไพ›ใ™ใ‚‹ๅค–้ƒจNode.jsใƒ—ใƒญใ‚ปใ‚น -- **ๅซใพใ‚Œใฆใ„ใชใ„ใ‚‚ใฎ**๏ผšSuperClaude ๆฉŸ่ƒฝใŒ็ต„ใฟ่พผใพใ‚Œใฆใ„ใ‚‹ -- **ใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ™ใƒผใ‚ทใƒงใƒณใฎไป•็ต„ใฟ**: ใ‚ฏใƒญใƒผใƒ‰ใฏ็Šถๆณใซๅฟœใ˜ใฆ้ฉๅˆ‡ใชใ‚ตใƒผใƒใƒผใ‚’ไฝฟ็”จใ™ใ‚‹ใŸใ‚ใฎๆŒ‡็คบใ‚’่ชญใฟไธŠใ’ใพใ™ -- **ๆไพ›ใ•ใ‚Œใ‚‹ใ‚‚ใฎ**๏ผšClaude Codeใฎใƒใ‚คใƒ†ใ‚ฃใƒ–ๆฉŸ่ƒฝใ‚’ๆ‹กๅผตใ™ใ‚‹ๅฎŸ้š›ใฎใƒ„ใƒผใƒซ - -**ใ‚ณใ‚ขใ‚ตใƒผใƒใƒผ:** - -- **context7**ย : ๅ…ฌๅผใƒฉใ‚คใƒ–ใƒฉใƒชใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆใจใƒ‘ใ‚ฟใƒผใƒณ -- **ๆฎต้šŽ็š„ๆ€่€ƒ**๏ผšๅคšๆฎต้šŽใฎๆŽจ่ซ–ใจๅˆ†ๆž -- **ใƒžใ‚ธใƒƒใ‚ฏ**๏ผšใƒขใƒ€ใƒณใชUIใ‚ณใƒณใƒใƒผใƒใƒณใƒˆ็”Ÿๆˆ -- **ใƒ—ใƒฌใ‚คใƒฉใ‚คใƒˆ**๏ผšใƒ–ใƒฉใ‚ฆใ‚ถ่‡ชๅ‹•ๅŒ–ใจE2Eใƒ†ใ‚นใƒˆ -- **morphllm-fast-apply**ย : ใƒ‘ใ‚ฟใƒผใƒณใƒ™ใƒผใ‚นใฎใ‚ณใƒผใƒ‰ๅค‰ๆ› -- **serena**ย : ใ‚ปใƒžใƒณใƒ†ใ‚ฃใƒƒใ‚ฏใ‚ณใƒผใƒ‰็†่งฃใจใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใƒกใƒขใƒช - -## ใ‚ฏใ‚คใƒƒใ‚ฏใ‚นใ‚ฟใƒผใƒˆ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/mcp-servers.md#quick-start) - -**ใ‚ปใƒƒใƒˆใ‚ขใƒƒใƒ—ใฎ็ขบ่ช**๏ผšMCPใ‚ตใƒผใƒใƒผใฏ่‡ชๅ‹•็š„ใซ่ตทๅ‹•ใ—ใพใ™ใ€‚ใ‚คใƒณใ‚นใƒˆใƒผใƒซใจใƒˆใƒฉใƒ–ใƒซใ‚ทใƒฅใƒผใƒ†ใ‚ฃใƒณใ‚ฐใซใคใ„ใฆใฏใ€[ใ€Œใ‚คใƒณใ‚นใƒˆใƒผใƒซใ‚ฌใ‚คใƒ‰ใ€](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Getting-Started/installation.md)ใจ[ใ€Œใƒˆใƒฉใƒ–ใƒซใ‚ทใƒฅใƒผใƒ†ใ‚ฃใƒณใ‚ฐใ€](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Reference/troubleshooting.md)ใ‚’ๅ‚็…งใ—ใฆใใ ใ•ใ„ใ€‚ - -**่‡ชๅ‹•ใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ™ใƒผใ‚ทใƒงใƒณใƒญใ‚ธใƒƒใ‚ฏ:** - -|ใƒชใ‚ฏใ‚จใ‚นใƒˆใซๅซใพใ‚Œใ‚‹ใ‚‚ใฎ|ใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ–ๅŒ–ใ•ใ‚ŒใŸใ‚ตใƒผใƒใƒผ| -|---|---| -|ใƒฉใ‚คใƒ–ใƒฉใƒชใฎใ‚คใƒณใƒใƒผใƒˆใ€APIๅ|**ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆ7**| -|`--think`ใ€ใƒ‡ใƒใƒƒใ‚ฐ|**้€ฃ็ถšๆ€่€ƒ**| -|`component`ใ€`UI`ใ€ ใƒ•ใƒญใƒณใƒˆใ‚จใƒณใƒ‰|**้ญ”ๆณ•**| -|`test`ใ€ใ€`e2e`โ€‹`browser`|**ๅŠ‡ไฝœๅฎถ**| -|่ค‡ๆ•ฐใƒ•ใ‚กใ‚คใƒซใฎ็ทจ้›†ใ€ใƒชใƒ•ใ‚กใ‚ฏใ‚ฟใƒชใƒณใ‚ฐ|**morphllm-้ซ˜้€Ÿ้ฉ็”จ**| -|ๅคง่ฆๆจกใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใ€ใ‚ปใƒƒใ‚ทใƒงใƒณ|**ใ‚ปใƒฌใƒŠ**| - -## ใ‚ตใƒผใƒใƒผใฎ่ฉณ็ดฐ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/mcp-servers.md#server-details) - -### ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆ7 ๐Ÿ“š - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/mcp-servers.md#context7-) - -**็›ฎ็š„**: ๅ…ฌๅผใƒฉใ‚คใƒ–ใƒฉใƒชใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆใธใฎใ‚ขใ‚ฏใ‚ปใ‚นย **ใƒˆใƒชใ‚ฌใƒผ**: ใ‚คใƒณใƒใƒผใƒˆใ‚นใƒ†ใƒผใƒˆใƒกใƒณใƒˆใ€ใƒ•ใƒฌใƒผใƒ ใƒฏใƒผใ‚ฏใ‚ญใƒผใƒฏใƒผใƒ‰ใ€ใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆใƒชใ‚ฏใ‚จใ‚นใƒˆย **่ฆไปถ**: Node.js 16+ใ€APIใ‚ญใƒผใชใ— - -```shell -# Automatic activation -/sc:implement "React authentication system" -# โ†’ Provides official React patterns - -# Manual activation -/sc:analyze auth-system/ --c7 -``` - -### ้€ฃ็ถšๆ€่€ƒ ๐Ÿง  - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/mcp-servers.md#sequential-thinking-) - -**็›ฎ็š„**: ๆง‹้€ ๅŒ–ใ•ใ‚ŒใŸๅคšๆฎต้šŽใฎๆŽจ่ซ–ใจไฝ“็ณป็š„ใชๅˆ†ๆžย **ใƒˆใƒชใ‚ฌใƒผ**: ่ค‡้›‘ใชใƒ‡ใƒใƒƒใ‚ฐใ€`--think`ใƒ•ใƒฉใ‚ฐใ€ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃๅˆ†ๆžย **่ฆไปถ**: Node.js 16+ใ€APIใ‚ญใƒผใชใ— - -```shell -# Automatic activation -/sc:troubleshoot "API performance issues" -# โ†’ Enables systematic root cause analysis - -# Manual activation -/sc:analyze --think-hard architecture/ -``` - -### ้ญ”ๆณ•โœจ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/mcp-servers.md#magic-) - -**็›ฎ็š„**: 21st.dev ใƒ‘ใ‚ฟใƒผใƒณใ‹ใ‚‰ใฎใƒขใƒ€ใƒณ UI ใ‚ณใƒณใƒใƒผใƒใƒณใƒˆ็”Ÿๆˆย **ใƒˆใƒชใ‚ฌใƒผ**: UI ใƒชใ‚ฏใ‚จใ‚นใƒˆใ€`/ui`ใ‚ณใƒžใƒณใƒ‰ใ€ใ‚ณใƒณใƒใƒผใƒใƒณใƒˆ้–‹็™บย **่ฆไปถ**: Node.js 16+ใ€TWENTYFIRST_API_KEY() - -```shell -# Automatic activation -/sc:implement "responsive dashboard component" -# โ†’ Generates accessible UI with modern patterns - -# API key setup -export TWENTYFIRST_API_KEY="your_key_here" -``` - -### ๅŠ‡ไฝœๅฎถ๐ŸŽญ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/mcp-servers.md#playwright-) - -**็›ฎ็š„**: ๅฎŸ้š›ใฎใƒ–ใƒฉใ‚ฆใ‚ถ่‡ชๅ‹•ๅŒ–ใจE2Eใƒ†ใ‚นใƒˆย **ใƒˆใƒชใ‚ฌใƒผ**: ใƒ–ใƒฉใ‚ฆใ‚ถใƒ†ใ‚นใƒˆใ€E2Eใ‚ทใƒŠใƒชใ‚ชใ€่ฆ–่ฆš็š„ๆคœ่จผย **่ฆไปถ**: Node.js 16ไปฅไธŠใ€APIใ‚ญใƒผใชใ— - -```shell -# Automatic activation -/sc:test --type e2e "user login flow" -# โ†’ Enables browser automation testing - -# Manual activation -/sc:validate "accessibility compliance" --play -``` - -### morphllm-fast-apply ๐Ÿ”„ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/mcp-servers.md#morphllm-fast-apply-) - -**็›ฎ็š„**: ๅŠน็Ž‡็š„ใชใƒ‘ใ‚ฟใƒผใƒณใƒ™ใƒผใ‚นใฎใ‚ณใƒผใƒ‰ๅค‰ๆ›ย **ใƒˆใƒชใ‚ฌใƒผ**: ่ค‡ๆ•ฐใƒ•ใ‚กใ‚คใƒซใฎ็ทจ้›†ใ€ใƒชใƒ•ใ‚กใ‚ฏใ‚ฟใƒชใƒณใ‚ฐใ€ใƒ•ใƒฌใƒผใƒ ใƒฏใƒผใ‚ฏใฎ็งป่กŒย **่ฆไปถ**: Node.js 16+ใ€MORPH_API_KEY - -```shell -# Automatic activation -/sc:improve legacy-codebase/ --focus maintainability -# โ†’ Applies consistent patterns across files - -# API key setup -export MORPH_API_KEY="your_key_here" -``` - -### ใ‚ปใƒฌใƒŠ๐Ÿงญ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/mcp-servers.md#serena-) - -**็›ฎ็š„**: ใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใƒกใƒขใƒชใ‚’ไฝฟ็”จใ—ใŸใ‚ปใƒžใƒณใƒ†ใ‚ฃใƒƒใ‚ฏใ‚ณใƒผใƒ‰็†่งฃย **ใƒˆใƒชใ‚ฌใƒผ**: ใ‚ทใƒณใƒœใƒซๆ“ไฝœใ€ๅคง่ฆๆจกใ‚ณใƒผใƒ‰ใƒ™ใƒผใ‚นใ€ใ‚ปใƒƒใ‚ทใƒงใƒณ็ฎก็†ย **่ฆไปถ**: Python 3.9+ใ€UV ใƒ‘ใƒƒใ‚ฑใƒผใ‚ธใƒžใƒใƒผใ‚ธใƒฃใƒผใ€API ใ‚ญใƒผใชใ— - -```shell -# Automatic activation -/sc:load existing-project/ -# โ†’ Builds project understanding and memory - -# Manual activation -/sc:refactor "extract UserService" --serena -``` - -## ๆง‹ๆˆ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/mcp-servers.md#configuration) - -**MCP ๆง‹ๆˆใƒ•ใ‚กใ‚คใƒซ (ย `~/.claude.json`):** - -```json -{ - "mcpServers": { - "context7": { - "command": "npx", - "args": ["-y", "@upstash/context7-mcp@latest"] - }, - "sequential-thinking": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"] - }, - "magic": { - "command": "npx", - "args": ["@21st-dev/magic"], - "env": {"TWENTYFIRST_API_KEY": "${TWENTYFIRST_API_KEY}"} - }, - "playwright": { - "command": "npx", - "args": ["@playwright/mcp@latest"] - }, - "morphllm-fast-apply": { - "command": "npx", - "args": ["@morph-llm/morph-fast-apply"], - "env": {"MORPH_API_KEY": "${MORPH_API_KEY}"} - }, - "serena": { - "command": "uvx", - "args": ["--from", "git+https://github.com/oraios/serena", "serena", "start-mcp-server", "--context", "ide-assistant"] - } - } -} -``` - -## ไฝฟ็”จใƒ‘ใ‚ฟใƒผใƒณ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/mcp-servers.md#usage-patterns) - -**ใ‚ตใƒผใƒใƒผๅˆถๅพก:** - -```shell -# Enable specific servers -/sc:analyze codebase/ --c7 --seq - -# Disable all MCP servers -/sc:implement "simple function" --no-mcp - -# Enable all servers -/sc:design "complex architecture" --all-mcp -``` - -**ใƒžใƒซใƒใ‚ตใƒผใƒใƒผ่ชฟๆ•ด:** - -```shell -# Full-stack development -/sc:implement "e-commerce checkout" -# โ†’ Sequential: workflow analysis -# โ†’ Context7: payment patterns -# โ†’ Magic: UI components -# โ†’ Serena: code organization -# โ†’ Playwright: E2E testing -``` - -## ใƒˆใƒฉใƒ–ใƒซใ‚ทใƒฅใƒผใƒ†ใ‚ฃใƒณใ‚ฐ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/mcp-servers.md#troubleshooting) - -**ใ‚ˆใใ‚ใ‚‹ๅ•้กŒ:** - -- **ใ‚ตใƒผใƒใƒผใŒๆŽฅ็ถšใ•ใ‚Œใฆใ„ใพใ›ใ‚“**: Node.js ใ‚’็ขบ่ชใ—ใฆใใ ใ•ใ„:ย `node --version`(v16 ไปฅไธŠใŒๅฟ…่ฆ) -- **Context7 ใŒๅคฑๆ•—ใ—ใพใ—ใŸ**: ใ‚ญใƒฃใƒƒใ‚ทใƒฅใ‚’ใ‚ฏใƒชใ‚ขใ—ใฆใใ ใ•ใ„:`npm cache clean --force` -- **Magic/Morphllm ใ‚จใƒฉใƒผ**: API ใ‚ญใƒผใŒใชใ„ๅ ดๅˆใซ็™บ็”Ÿใ™ใ‚‹ๅฏ่ƒฝๆ€งใŒใ‚ใ‚Šใพใ™ (ๆœ‰ๆ–™ใ‚ตใƒผใƒ“ใ‚น) -- **ใ‚ตใƒผใƒใƒผใฎใ‚ฟใ‚คใƒ ใ‚ขใ‚ฆใƒˆ**: Claude Codeใ‚ปใƒƒใ‚ทใƒงใƒณใ‚’ๅ†่ตทๅ‹•ใ—ใพใ™ - -**ใ‚ฏใ‚คใƒƒใ‚ฏใƒ•ใ‚ฃใƒƒใ‚ฏใ‚น:** - -```shell -# Reset connections -# Restart Claude Code session - -# Check dependencies -node --version # Should show v16+ - -# Test without MCP -/sc:command --no-mcp - -# Check configuration -ls ~/.claude.json -``` - -**API ใ‚ญใƒผใฎ่จญๅฎš:** - -```shell -# For Magic server (required for UI generation) -export TWENTYFIRST_API_KEY="your_key_here" - -# For Morphllm server (required for bulk transformations) -export MORPH_API_KEY="your_key_here" - -# Add to shell profile for persistence -echo 'export TWENTYFIRST_API_KEY="your_key"' >> ~/.bashrc -echo 'export MORPH_API_KEY="your_key"' >> ~/.bashrc -``` - -**็’ฐๅขƒๅค‰ๆ•ฐใฎไฝฟ็”จๆณ•:** - -- โœ…ย `TWENTYFIRST_API_KEY`- Magic MCP ใ‚ตใƒผใƒใƒผๆฉŸ่ƒฝใซๅฟ…่ฆ -- โœ…ย `MORPH_API_KEY`- Morphllm MCP ใ‚ตใƒผใƒใƒผๆฉŸ่ƒฝใซๅฟ…่ฆ -- โŒ ใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆๅ†…ใฎใใฎไป–ใฎ็’ฐๅขƒๅค‰ๆ•ฐ - ไพ‹ใฎใฟใ€ใƒ•ใƒฌใƒผใƒ ใƒฏใƒผใ‚ฏใงใฏไฝฟ็”จใ•ใ‚Œใพใ›ใ‚“ -- ๐Ÿ“ ใฉใกใ‚‰ใ‚‚ๆœ‰ๆ–™ใฎใ‚ตใƒผใƒ“ใ‚นAPIใ‚ญใƒผใงใ™ใŒใ€ใƒ•ใƒฌใƒผใƒ ใƒฏใƒผใ‚ฏใฏใใ‚Œใ‚‰ใชใ—ใงใ‚‚ๅ‹•ไฝœใ—ใพใ™ - -## ใ‚ตใƒผใƒใƒผใฎ็ต„ใฟๅˆใ‚ใ› - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/mcp-servers.md#server-combinations) - -**APIใ‚ญใƒผใชใ—๏ผˆ็„กๆ–™๏ผ‰**ย : - -- ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆ7 + ใ‚ทใƒผใ‚ฑใƒณใ‚ทใƒฃใƒซใ‚ทใƒณใ‚ญใƒณใ‚ฐ + ๅŠ‡ไฝœๅฎถ + ใ‚ปใƒฌใƒŠ - -**1 APIใ‚ญใƒผ**: - -- ใƒ—ใƒญใƒ•ใ‚งใƒƒใ‚ทใƒงใƒŠใƒซใชUI้–‹็™บใซ้ญ”ๆณ•ใ‚’ๅŠ ใˆใ‚‹ - -**2ใคใฎAPIใ‚ญใƒผ**: - -- ๅคง่ฆๆจกใƒชใƒ•ใ‚กใ‚ฏใ‚ฟใƒชใƒณใ‚ฐใฎใŸใ‚ใซ morphllm-fast-apply ใ‚’่ฟฝๅŠ  - -**ไธ€่ˆฌ็š„ใชใƒฏใƒผใ‚ฏใƒ•ใƒญใƒผ:** - -- **ๅญฆ็ฟ’**๏ผšใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆ7 + ใ‚ทใƒผใ‚ฑใƒณใ‚ทใƒฃใƒซใ‚ทใƒณใ‚ญใƒณใ‚ฐ -- **Web้–‹็™บ**๏ผšใƒžใ‚ธใƒƒใ‚ฏ + context7 + ใƒ—ใƒฌใ‚คใƒฉใ‚คใƒˆ -- **ใ‚จใƒณใ‚ฟใƒผใƒ—ใƒฉใ‚คใ‚บใƒชใƒ•ใ‚กใ‚ฏใ‚ฟใƒชใƒณใ‚ฐ**๏ผšserena + morphllm + sequential-thinking -- **่ค‡้›‘ใชๅˆ†ๆž**๏ผšใ‚ทใƒผใ‚ฑใƒณใ‚ทใƒฃใƒซใ‚ทใƒณใ‚ญใƒณใ‚ฐ + ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆ7 + ใ‚ปใƒฌใƒŠ - -## ็ตฑๅˆ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/mcp-servers.md#integration) - -**SuperClaude ใ‚ณใƒžใƒณใƒ‰ใ‚’ไฝฟ็”จใ™ใ‚‹ๅ ดๅˆ:** - -- ๅˆ†ๆžใ‚ณใƒžใƒณใƒ‰ใฏ่‡ชๅ‹•็š„ใซSequential + Serenaใ‚’ไฝฟ็”จใ—ใพใ™ -- ๅฎŸ่ฃ…ใ‚ณใƒžใƒณใƒ‰ใฏMagic + Context7ใ‚’ไฝฟ็”จใ™ใ‚‹ -- ใƒ†ใ‚นใƒˆใ‚ณใƒžใƒณใƒ‰ใซใฏPlaywright + Sequentialใ‚’ไฝฟ็”จใ™ใ‚‹ - -**ๅ‹•ไฝœใƒขใƒผใƒ‰ใฎๅ ดๅˆ:** - -- ใƒ–ใƒฌใ‚คใƒณใ‚นใƒˆใƒผใƒŸใƒณใ‚ฐใƒขใƒผใƒ‰๏ผš็™บ่ฆ‹ใฎใŸใ‚ใฎใ‚ทใƒผใ‚ฑใƒณใ‚ทใƒฃใƒซ -- ใ‚ฟใ‚นใ‚ฏ็ฎก็†๏ผšๆฐธ็ถšๆ€งใฎใŸใ‚ใฎ Serena -- ใ‚ชใƒผใ‚ฑใ‚นใƒˆใƒฌใƒผใ‚ทใƒงใƒณใƒขใƒผใƒ‰: ๆœ€้ฉใชใ‚ตใƒผใƒใƒผใฎ้ธๆŠž - -**ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใ‚ณใƒณใƒˆใƒญใƒผใƒซ:** - -- ใ‚ทใ‚นใƒ†ใƒ ่ฒ ่ทใซๅŸบใฅใ่‡ชๅ‹•ใƒชใ‚ฝใƒผใ‚น็ฎก็† -- ๅŒๆ™‚ๅฎŸ่กŒๅˆถๅพก:ย `--concurrency N`(1-15) -- ๅˆถ็ด„ไธ‹ใงใฎๅ„ชๅ…ˆๅบฆใƒ™ใƒผใ‚นใฎใ‚ตใƒผใƒใƒผ้ธๆŠž - -## ้–ข้€ฃใƒชใ‚ฝใƒผใ‚น - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/mcp-servers.md#related-resources) - -**ๅฟ…่ชญ:** - -- [ใ‚ณใƒžใƒณใƒ‰ใ‚ฌใ‚คใƒ‰](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md)- MCPใ‚ตใƒผใƒใƒผใ‚’ใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ–ๅŒ–ใ™ใ‚‹ใ‚ณใƒžใƒณใƒ‰ -- [ใ‚ฏใ‚คใƒƒใ‚ฏใ‚นใ‚ฟใƒผใƒˆใ‚ฌใ‚คใƒ‰](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Getting-Started/quick-start.md)- MCP ใ‚ปใƒƒใƒˆใ‚ขใƒƒใƒ—ใ‚ฌใ‚คใƒ‰ - -**้ซ˜ๅบฆใชไฝฟ็”จๆณ•:** - -- [่กŒๅ‹•ใƒขใƒผใƒ‰](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md)- ใƒขใƒผใƒ‰-MCP่ชฟๆ•ด -- [ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใ‚ฌใ‚คใƒ‰](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md)- ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใจMCPใฎ็ตฑๅˆ -- [ใ‚ปใƒƒใ‚ทใƒงใƒณ็ฎก็†](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md)- Serena ใƒฏใƒผใ‚ฏใƒ•ใƒญใƒผ - -**ๆŠ€่ก“ใƒชใƒ•ใ‚กใƒฌใƒณใ‚น:** - -- [ไพ‹ใฎใ‚ฏใƒƒใ‚ฏใƒ–ใƒƒใ‚ฏ](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Reference/examples-cookbook.md)- MCP ใƒฏใƒผใ‚ฏใƒ•ใƒญใƒผใƒ‘ใ‚ฟใƒผใƒณ -- [ๆŠ€่ก“ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃ](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Developer-Guide/technical-architecture.md)- ็ตฑๅˆใฎ่ฉณ็ดฐ \ No newline at end of file diff --git a/docs/User-Guide-jp/modes.md b/docs/User-Guide-jp/modes.md deleted file mode 100644 index 6811ef1..0000000 --- a/docs/User-Guide-jp/modes.md +++ /dev/null @@ -1,726 +0,0 @@ -# SuperClaude ่กŒๅ‹•ใƒขใƒผใƒ‰ใ‚ฌใ‚คใƒ‰ ๐Ÿง  - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#superclaude-behavioral-modes-guide-) - -## โœ… ใ‚ฏใ‚คใƒƒใ‚ฏๆคœ่จผ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#-quick-verification) - -ใ‚ณใƒžใƒณใƒ‰ใ‚’ไฝฟ็”จใ—ใฆใƒขใƒผใƒ‰ใ‚’ใƒ†ใ‚นใƒˆใ—ใพใ™`/sc:`ใ€‚ใƒขใƒผใƒ‰ใฏใ‚ฟใ‚นใ‚ฏใฎ่ค‡้›‘ใ•ใซๅŸบใฅใ„ใฆ่‡ชๅ‹•็š„ใซใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ–ใซใชใ‚Šใพใ™ใ€‚ใ‚ณใƒžใƒณใƒ‰ใฎๅฎŒๅ…จใชใƒชใƒ•ใ‚กใƒฌใƒณใ‚นใซใคใ„ใฆใฏใ€[ใ‚ณใƒžใƒณใƒ‰ใ‚ฌใ‚คใƒ‰](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md)ใ‚’ใ”่ฆงใใ ใ•ใ„ใ€‚ - -## ใ‚ฏใ‚คใƒƒใ‚ฏใƒชใƒ•ใ‚กใƒฌใƒณใ‚นใƒ†ใƒผใƒ–ใƒซ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#quick-reference-table) - -|ใƒขใƒผใƒ‰|็›ฎ็š„|่‡ชๅ‹•ใƒˆใƒชใ‚ฌใƒผ|้‡่ฆใช่กŒๅ‹•|ๆœ€้ฉใช็”จ้€”| -|---|---|---|---|---| -|**๐Ÿง  ใƒ–ใƒฌใ‚คใƒณใ‚นใƒˆใƒผใƒŸใƒณใ‚ฐ**|ใ‚คใƒณใ‚ฟใƒฉใ‚ฏใƒ†ใ‚ฃใƒ–ใช็™บ่ฆ‹|ใ€Œใƒ–ใƒฌใ‚คใƒณใ‚นใƒˆใƒผใƒŸใƒณใ‚ฐใ€ใ€ใ€ŒใŸใถใ‚“ใ€ใ€ๆผ ็„ถใจใ—ใŸ่ฆๆœ›|ใ‚ฝใ‚ฏใƒฉใƒ†ใ‚นๅผใฎ่ณชๅ•ใ€่ฆไปถใฎๆŠฝๅ‡บ|ๆ–ฐใ—ใ„ใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใฎ่จˆ็”ปใ€ไธๆ˜Ž็ขบใช่ฆไปถ| -|**๐Ÿ” ๅ†…็œ**|ใƒกใ‚ฟ่ช็Ÿฅๅˆ†ๆž|ใ‚จใƒฉใƒผๅ›žๅพฉใ€ใ€ŒๆŽจ่ซ–ใฎๅˆ†ๆžใ€|้€ๆ˜Žใชๆ€่€ƒใƒžใƒผใ‚ซใƒผ๏ผˆ๐Ÿค”ใ€๐ŸŽฏใ€๐Ÿ’ก๏ผ‰|ใƒ‡ใƒใƒƒใ‚ฐใ€ๅญฆ็ฟ’ใ€ๆœ€้ฉๅŒ–| -|**๐Ÿ“‹ ใ‚ฟใ‚นใ‚ฏ็ฎก็†**|่ค‡้›‘ใช่ชฟๆ•ด|>3ใ‚นใƒ†ใƒƒใƒ—ใ€>2ใƒ‡ใ‚ฃใƒฌใ‚ฏใƒˆใƒช|็›ธใฎๅดฉๅฃŠใ€่จ˜ๆ†ถใฎๆŒ็ถš|ๅคšๆฎต้šŽๆ“ไฝœใ€ใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆ็ฎก็†| -|**๐ŸŽฏ ใ‚ชใƒผใ‚ฑใ‚นใƒˆใƒฌใƒผใ‚ทใƒงใƒณ**|ใ‚คใƒณใƒ†ใƒชใ‚ธใ‚งใƒณใƒˆใชใƒ„ใƒผใƒซ้ธๆŠž|่ค‡ๆ•ฐใฎใƒ„ใƒผใƒซใ‚’ไฝฟ็”จใ—ใŸๆ“ไฝœใ€้ซ˜ใ„ใƒชใ‚ฝใƒผใ‚นไฝฟ็”จ็Ž‡|ๆœ€้ฉใชใƒ„ใƒผใƒซใƒซใƒผใƒ†ใ‚ฃใƒณใ‚ฐใ€ไธฆๅˆ—ๅฎŸ่กŒ|่ค‡้›‘ใชๅˆ†ๆžใ€ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใฎๆœ€้ฉๅŒ–| -|**โšก ใƒˆใƒผใ‚ฏใƒณๅŠน็Ž‡**|ๅœง็ธฎ้€šไฟก|ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆไฝฟ็”จ็Ž‡ใŒ้ซ˜ใ„ใ€`--uc`ใƒ•ใƒฉใ‚ฐ|ใ‚ทใƒณใƒœใƒซใ‚ทใ‚นใƒ†ใƒ ใ€ๆŽจๅฎš30๏ฝž50%ใฎใƒˆใƒผใ‚ฏใƒณๅ‰Šๆธ›|ใƒชใ‚ฝใƒผใ‚นใฎๅˆถ็ด„ใ€ๅคง่ฆๆจกใชๆ“ไฝœ| - ---- - -## ใฏใ˜ใ‚ใซ๏ผˆ2ๅˆ†ใฎๆฆ‚่ฆ๏ผ‰ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#getting-started-2-minute-overview) - -**ใƒขใƒผใƒ‰ใฏๅ‹•ไฝœๆŒ‡็คบใ‚’้€šใ˜ใฆใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ–ๅŒ–ใ•ใ‚Œใพใ™**- Claude Code ใฏใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆ ใƒ•ใ‚กใ‚คใƒซใ‚’่ชญใฟๅ–ใ‚Šใ€ใ‚ฟใ‚นใ‚ฏใฎใƒ‘ใ‚ฟใƒผใƒณใจ่ค‡้›‘ใ•ใซๅŸบใฅใ„ใฆใฉใฎใƒขใƒผใƒ‰ๅ‹•ไฝœใ‚’ๆŽก็”จใ™ใ‚‹ใ‹ใ‚’ๆฑบๅฎšใ—ใพใ™ใ€‚ - -**็ฐกๅ˜ใชไพ‹:** - -```shell -# Automatic activation examples -/sc:brainstorm "mobile app" # โ†’ Socratic discovery questions -/sc:implement "auth system" # โ†’ Multi-phase coordination -"--uc analyze large-codebase/" # โ†’ Compressed symbol output -``` - -**ๆ‰‹ๅ‹•ใƒ•ใƒฉใ‚ฐใ‚’ไฝฟ็”จใ™ใ‚‹ๅ ดๅˆ:** - -- ็‰นๅฎšใฎๅ‹•ไฝœใŒๅฟ…่ฆ:ย `--brainstorm`ใ€ใ€`--introspect``--uc` -- ๅญฆ็ฟ’/ใƒ‡ใƒใƒƒใ‚ฐใฎใŸใ‚ใฎ่‡ชๅ‹•ๆคœๅ‡บใ‚’ใ‚ชใƒผใƒใƒผใƒฉใ‚คใƒ‰ใ™ใ‚‹ -- ็‰นๅฎšใฎๅˆถ็ด„๏ผˆใƒกใƒขใƒชใ€ๆ™‚้–“ใ€ๆ˜Ž็žญๆ€ง๏ผ‰ใซๅˆใ‚ใ›ใฆๆœ€้ฉๅŒ–ใ™ใ‚‹ - ---- - -## ใƒขใƒผใƒ‰ใฎ่ฉณ็ดฐ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#mode-details) - -### ๐Ÿง  ใƒ–ใƒฌใ‚คใƒณใ‚นใƒˆใƒผใƒŸใƒณใ‚ฐใƒขใƒผใƒ‰ - ใ‚คใƒณใ‚ฟใƒฉใ‚ฏใƒ†ใ‚ฃใƒ–ใช็™บ่ฆ‹ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#-brainstorming-mode---interactive-discovery) - -**็›ฎ็š„**: ๅ…ฑๅŒไฝœๆฅญใซใ‚ˆใ‚‹็™บ่ฆ‹ใ‚’้€šใ˜ใฆใ€ๆผ ็„ถใจใ—ใŸใ‚ขใ‚คใƒ‡ใ‚ขใ‚’ๆง‹้€ ๅŒ–ใ•ใ‚ŒใŸ่ฆไปถใซๅค‰ๆ›ใ—ใพใ™ใ€‚ - -**่‡ชๅ‹•ใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ™ใƒผใ‚ทใƒงใƒณใƒˆใƒชใ‚ฌใƒผ:** - -- ๆผ ็„ถใจใ—ใŸใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใƒชใ‚ฏใ‚จใ‚นใƒˆ:ใ€Œ...ใ‚’ๆง‹็ฏ‰ใ—ใŸใ„ใ€ใ€ใ€Œ...ใ‚’ไฝœๆˆใ—ใ‚ˆใ†ใจ่€ƒใˆใฆใ„ใ‚‹ใ€ -- ๆŽข็ดขใ‚ญใƒผใƒฏใƒผใƒ‰: ใƒ–ใƒฌใ‚คใƒณใ‚นใƒˆใƒผใƒŸใƒณใ‚ฐใ€ๆŽข็ดขใ€่ญฐ่ซ–ใ€็†่งฃใ€ไธๆ˜Ž -- ไธ็ขบๅฎŸๆ€งๆŒ‡ๆจ™๏ผšใ€ŒใŸใถใ‚“ใ€ใ€ใ€ŒใŠใใ‚‰ใใ€ใ€ใ€Œใงใใ‚‹ใ‹ใ‚‚ใ—ใ‚Œใชใ„ใ€ -- ๆ‰‹ๅ‹•ใƒ•ใƒฉใ‚ฐ:ย `--brainstorm`ใ€`--bs` - -**่กŒๅ‹•ใฎๅค‰ๅŒ–:** - -- **ใ‚ฝใ‚ฏใƒฉใƒ†ใ‚นๅผ่ณชๅ•**๏ผš้š ใ‚ŒใŸ่ฆไปถใ‚’ๆ˜Žใ‚‰ใ‹ใซใ™ใ‚‹ใŸใ‚ใซๆŽ˜ใ‚Šไธ‹ใ’ใŸ่ณชๅ•ใ‚’ใ™ใ‚‹ -- **้žๆŽจๅฎš็š„ใ‚ขใƒ—ใƒญใƒผใƒ**๏ผšๆŽจๅฎšใ‚’้ฟใ‘ใ€็™บ่ฆ‹ใฎๆ–นๅ‘ๆ€งใ‚’ๅฐŽใ -- **ๅ”ๅŠ›็š„ใชใƒ‘ใƒผใƒˆใƒŠใƒผใ‚ทใƒƒใƒ—**๏ผšๆŒ‡็คบ็š„ใช็›ธ่ซ‡ใงใฏใชใใ€ๆŽข็ดข็š„ใซๅ”ๅŠ›ใ—ใพใ™ -- **่ฆไปถ็ตฑๅˆ**๏ผšๆดžๅฏŸใ‚’ๆง‹้€ ๅŒ–ใ•ใ‚ŒใŸๆŠ€่ก“ๆฆ‚่ฆใซๅค‰ๆ›ใ—ใพใ™ -- **ใ‚ฏใƒญใ‚นใ‚ปใƒƒใ‚ทใƒงใƒณใƒกใƒขใƒช**๏ผšใƒ•ใ‚ฉใƒญใƒผใ‚ขใƒƒใƒ—ใฎ่ญฐ่ซ–ใฎใŸใ‚ใซ็™บ่ฆ‹ใฎใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆใ‚’็ถญๆŒใ™ใ‚‹ - -**็ตŒ้จ“ไพ‹:** - -``` -Standard Approach: "I'll build a user authentication system with JWT tokens..." -Brainstorming Approach: -"๐Ÿค” Let's explore this together: - - What specific user problems does auth solve for your app? - - Who are your users and what's their technical comfort level? - - Any existing systems or social logins to integrate with? - - What security/compliance requirements do you have? - ๐Ÿ“ Outcome: Detailed auth requirements brief ready for implementation" -``` - -#### ๆˆๅŠŸๅŸบๆบ– - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#success-criteria) - -- [ ] ใ™ใใซ่งฃๆฑบ็ญ–ใ‚’ๆ็คบใ™ใ‚‹ใฎใงใฏใชใใ€่ณชๅ•ใงๅฟœ็ญ”ใ™ใ‚‹ -- [ ] ่ณชๅ•ใฏใƒฆใƒผใ‚ถใƒผใฎใƒ‹ใƒผใ‚บใ€ๆŠ€่ก“็š„ๅˆถ็ด„ใ€ใƒ“ใ‚ธใƒใ‚น็›ฎๆจ™ใ‚’ๆŽขใ‚Šใพใ™ -- [ ] ็™บ่ฆ‹ใƒ—ใƒญใ‚ปใ‚นๅ…จไฝ“ใ‚’้€šใ˜ใฆๅ”ๅŠ›็š„ใชๅงฟๅ‹ขใ‚’็ถญๆŒใ™ใ‚‹ -- [ ] ็ตๆžœใจใ—ใฆๆง‹้€ ๅŒ–ใ•ใ‚ŒใŸ่ฆไปถใพใŸใฏๆŠ€่ก“ๆฆ‚่ฆใ‚’ไฝœๆˆใ—ใพใ™ - -**ๆคœ่จผ:**ย `/sc:brainstorm "web app"`ใƒฆใƒผใ‚ถใƒผใ€ๆฉŸ่ƒฝใ€ใƒ†ใ‚ฏใƒŽใƒญใ‚ธใƒผใซใคใ„ใฆ่ณชๅ•ใ™ใ‚‹ๅฟ…่ฆใŒใ‚ใ‚Šใพใ™ใ€‚ -**ใƒ†ใ‚นใƒˆ:**ๆผ ็„ถใจใ—ใŸใƒชใ‚ฏใ‚จใ‚นใƒˆใฏใ€ๆŽจๆธฌใงใฏใชใ็™บ่ฆ‹ใฎใŸใ‚ใฎ่ณชๅ•ใ‚’ๅผ•ใ่ตทใ“ใ™ๅฟ…่ฆใŒใ‚ใ‚Šใพใ™ใ€‚ -**ใƒใ‚งใƒƒใ‚ฏ:**ใƒขใƒผใƒ‰ใฏใ€ๅŒใ˜ไผš่ฉฑๅ†…ใฎใƒ•ใ‚ฉใƒญใƒผใ‚ขใƒƒใƒ—ใฎ่ณชๅ•ใงใ‚‚็ถญๆŒใ•ใ‚Œใ‚‹ๅฟ…่ฆใŒใ‚ใ‚Šใพใ™ใ€‚ - -**ๆœ€้ฉใช็ต„ใฟๅˆใ‚ใ›:** - -- **โ†’ ใ‚ฟใ‚นใ‚ฏ็ฎก็†**๏ผš่ฆไปถใฎ็™บ่ฆ‹ โ†’ ไฝ“็ณป็š„ใชๅฎŸ่ฃ…่จˆ็”ป -- **โ†’ ใ‚ชใƒผใ‚ฑใ‚นใƒˆใƒฌใƒผใ‚ทใƒงใƒณ**๏ผš่ฆไปถใฎๆ˜Ž็ขบๅŒ– โ†’ ๅฎŸ่ฃ…ใซๆœ€้ฉใชใƒ„ใƒผใƒซใฎ้ธๆŠž -- **ๆ‰‹ๅ‹•ใ‚ชใƒผใƒใƒผใƒฉใ‚คใƒ‰**:ย `--brainstorm`ใ€Œๆ˜Ž็ขบใชใ€่ฆไปถใงใ‚ใฃใฆใ‚‚ๅผทๅˆถ็š„ใซๆคœๅ‡บใ™ใ‚‹ใŸใ‚ใซไฝฟ็”จใ—ใพใ™ - ---- - -### ๐Ÿ” ๅ†…็œใƒขใƒผใƒ‰ - ใƒกใ‚ฟ่ช็Ÿฅๅˆ†ๆž - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#-introspection-mode---meta-cognitive-analysis) - -**็›ฎ็š„**: ๅญฆ็ฟ’ใฎๆœ€้ฉๅŒ–ใจ้€ๆ˜Žใชๆ„ๆ€ๆฑบๅฎšใฎใŸใ‚ใฎๆŽจ่ซ–ใƒ—ใƒญใ‚ปใ‚นใ‚’ๅ…ฌ้–‹ใ—ใพใ™ใ€‚ - -**่‡ชๅ‹•ใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ™ใƒผใ‚ทใƒงใƒณใƒˆใƒชใ‚ฌใƒผ:** - -- ่‡ชๅทฑๅˆ†ๆžใฎ่ฆๆฑ‚๏ผšใ€Œ่‡ชๅˆ†ใฎๆŽจ่ซ–ใ‚’ๅˆ†ๆžใ™ใ‚‹ใ€ใ€ใ€Œๆฑบๅฎšใ‚’ๆŒฏใ‚Š่ฟ”ใ‚‹ใ€ -- ใ‚จใƒฉใƒผๅ›žๅพฉใ‚ทใƒŠใƒชใ‚ชใจ่ชฟๆŸปใ‚’ๅฟ…่ฆใจใ™ใ‚‹ไบˆๆœŸใ—ใชใ„็ตๆžœ -- ่ค‡ๆ•ฐใฎๅฎŸ่กŒๅฏ่ƒฝใชใ‚ขใƒ—ใƒญใƒผใƒใซใ‚ˆใ‚‹่ค‡้›‘ใชๅ•้กŒ่งฃๆฑบ -- ๆœ€้ฉๅŒ–ใฎๆฉŸไผšใฎใŸใ‚ใฎใƒ‘ใ‚ฟใƒผใƒณ่ช่ญ˜ใฎๅฟ…่ฆๆ€ง -- ๆ‰‹ๅ‹•ใƒ•ใƒฉใ‚ฐ:`--introspect` - -**่กŒๅ‹•ใฎๅค‰ๅŒ–:** - -- **ๆŽจ่ซ–ใฎ้€ๆ˜Žๆ€ง**: ๆ€่€ƒใƒ—ใƒญใ‚ปใ‚นใ‚’ๆ˜Ž็ขบใชใƒžใƒผใ‚ซใƒผใงๅ…ฌ้–‹ใ—ใพใ™ (๐Ÿค”ใ€๐ŸŽฏใ€โšกใ€๐Ÿ“Šใ€๐Ÿ’ก) -- **ๆ„ๆ€ๆฑบๅฎšๅˆ†ๆž**๏ผš้ธๆŠžใƒญใ‚ธใƒƒใ‚ฏใ‚’่ฉ•ไพกใ—ใ€ไปฃๆ›ฟใ‚ขใƒ—ใƒญใƒผใƒใ‚’ๆคœ่จŽใ™ใ‚‹ -- **ใƒ‘ใ‚ฟใƒผใƒณ่ช่ญ˜**๏ผš็นฐใ‚Š่ฟ”ใ•ใ‚Œใ‚‹่กŒๅ‹•ใจๆ”นๅ–„ใฎๆฉŸไผšใ‚’็‰นๅฎšใ—ใพใ™ -- **ใƒกใ‚ฟๅญฆ็ฟ’**๏ผš็ถ™็ถš็š„ใชใƒ•ใƒฌใƒผใƒ ใƒฏใƒผใ‚ฏๆ”นๅ–„ใฎใŸใ‚ใฎๆดžๅฏŸใ‚’ๆŠฝๅ‡บ -- **ใƒ•ใƒฌใƒผใƒ ใƒฏใƒผใ‚ฏใ‚ณใƒณใƒ—ใƒฉใ‚คใ‚ขใƒณใ‚น**: SuperClaudeๅŽŸๅ‰‡ใจๅ“่ณชใ‚ฒใƒผใƒˆใซ็…งใ‚‰ใ—ใฆใ‚ขใ‚ฏใ‚ทใƒงใƒณใ‚’ๆคœ่จผใ—ใพใ™ - -**็ตŒ้จ“ไพ‹:** - -``` -Standard Approach: "I'll analyze this code structure and suggest improvements..." -Introspective Approach: -"๐Ÿง  Meta-Analysis: Why did I choose structural analysis over functional flow? - ๐ŸŽฏ Decision Logic: Saw class hierarchy โ†’ assumed OOP pattern dominance - ๐Ÿ”„ Alternative Considered: Data flow analysis might reveal hidden dependencies - ๐Ÿ“Š Evidence Check: File imports suggest functional composition, not OOP - ๐Ÿ’ก Learning: Need to analyze imports before choosing analysis strategy - โšก Correction: Switching to functional flow analysis approach" -``` - -**ๆœ€้ฉใช็ต„ใฟๅˆใ‚ใ›:** - -- **โ†’ ใ‚ฟใ‚นใ‚ฏ็ฎก็†**: ่ค‡้›‘ใชใƒ•ใ‚งใƒผใ‚บใฎๆฑบๅฎšใซ้€ๆ˜ŽใชๆŽจ่ซ–ใ‚’ๆไพ›ใ—ใพใ™ -- **ไปปๆ„ใฎใƒขใƒผใƒ‰**: ไป–ใฎใƒขใƒผใƒ‰ใฎๆ“ไฝœใซๆŽจ่ซ–ใฎ้€ๆ˜Žๆ€งใƒฌใ‚คใƒคใƒผใ‚’่ฟฝๅŠ ใ—ใพใ™ -- **ๆ‰‹ๅ‹•ใ‚ชใƒผใƒใƒผใƒฉใ‚คใƒ‰**:`--introspect`ๅญฆ็ฟ’ใ‚ปใƒƒใ‚ทใƒงใƒณใ‚„ใƒฏใƒผใ‚ฏใƒ•ใƒญใƒผใฎใƒ‡ใƒใƒƒใ‚ฐใซไฝฟ็”จใ—ใพใ™ - ---- - -### ๐Ÿ“‹ ใ‚ฟใ‚นใ‚ฏ็ฎก็†ใƒขใƒผใƒ‰ - ่ค‡้›‘ใช่ชฟๆ•ด - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#-task-management-mode---complex-coordination) - -**็›ฎ็š„**: ่ค‡ๆ•ฐใ‚นใƒ†ใƒƒใƒ—ใฎๆ“ไฝœใฎใŸใ‚ใฎใ‚ปใƒƒใ‚ทใƒงใƒณๆฐธ็ถšๆ€งใ‚’ๅ‚™ใˆใŸ้šŽๅฑค็š„ใชใ‚ฟใ‚นใ‚ฏๆง‹ๆˆใ€‚ - -**่‡ชๅ‹•ใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ™ใƒผใ‚ทใƒงใƒณใƒˆใƒชใ‚ฌใƒผ:** - -- 3 ใคไปฅไธŠใฎ่ชฟๆ•ดใ•ใ‚ŒใŸใ‚นใƒ†ใƒƒใƒ—ใ‚’ๅฟ…่ฆใจใ™ใ‚‹ๆ“ไฝœ -- ่ค‡ๆ•ฐใฎใƒ•ใ‚กใ‚คใƒซ/ใƒ‡ใ‚ฃใƒฌใ‚ฏใƒˆใƒช ใ‚นใ‚ณใƒผใƒ— (ใƒ‡ใ‚ฃใƒฌใ‚ฏใƒˆใƒชใŒ 2 ใคไปฅไธŠใ€ใพใŸใฏใƒ•ใ‚กใ‚คใƒซๆ•ฐใŒ 3 ใคไปฅไธŠ) -- ใƒ•ใ‚งใƒผใ‚บใจใƒใ‚งใƒƒใ‚ฏใƒใ‚คใƒณใƒˆใ‚’ๅฟ…่ฆใจใ™ใ‚‹่ค‡้›‘ใชไพๅญ˜้–ขไฟ‚ -- ๅ“่ณชๆ”นๅ–„ใฎ่ฆๆœ›๏ผš็ฃจใใ€ๆด—็ทดใ€ๅผทๅŒ– -- ๆ‰‹ๅ‹•ใƒ•ใƒฉใ‚ฐ:ย `--task-manage`ใ€`--delegate` - -**่กŒๅ‹•ใฎๅค‰ๅŒ–:** - -- **้šŽๅฑค็š„่จˆ็”ป**๏ผš่ค‡้›‘ใชไฝœๆฅญใ‚’่จˆ็”ปโ†’ใƒ•ใ‚งใƒผใ‚บโ†’ใ‚ฟใ‚นใ‚ฏโ†’ToDoๆง‹้€ ใซๅˆ†ๅ‰ฒใ—ใพใ™ -- **ใ‚ปใƒƒใ‚ทใƒงใƒณใฎๆฐธ็ถšๆ€ง**: ไธญๆ–ญใŒใ‚ใฃใฆใ‚‚ใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใฎใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆใจ้€ฒ่กŒ็Šถๆณใ‚’็ถญๆŒใ—ใพใ™ -- **ใƒกใƒขใƒช็ตฑๅˆ**: ็Šถๆ…‹ไฟๅญ˜ใฎใŸใ‚ใซ write_memory/read_memory ใ‚’ไฝฟ็”จใ™ใ‚‹ -- **้€ฒๆ—ใ‚ชใƒผใ‚ฑใ‚นใƒˆใƒฌใƒผใ‚ทใƒงใƒณ**: ่ฟฝ่ทกใฎใŸใ‚ใซใƒกใƒขใƒชๆ›ดๆ–ฐใจTodoWriteใ‚’่ชฟๆ•ดใ™ใ‚‹ -- **ๅ“่ณชใ‚ฒใƒผใƒˆ**:ใƒ•ใ‚งใƒผใ‚บ้–“ใฎไฝ“็ณป็š„ใชๆคœ่จผใƒใ‚งใƒƒใ‚ฏใƒใ‚คใƒณใƒˆใ‚’ๅฎŸ่ฃ…ใ—ใพใ™ - -**็ตŒ้จ“ไพ‹:** - -``` -Standard Approach: "I'll implement user authentication..." โ†’ Direct implementation -Task Management Approach: -"๐Ÿ“‹ Multi-Phase Implementation Plan: - ๐ŸŽฏ Phase 1: Security Requirements Analysis (Session 1) - ๐ŸŽฏ Phase 2: API Design & Documentation (Session 2) - ๐ŸŽฏ Phase 3: Implementation & Testing (Session 3-4) - ๐ŸŽฏ Phase 4: Integration & Validation (Session 5) - ๐Ÿ’พ Session persistence: Resume context automatically - โœ“ Quality gates: Validation before each phase transition" -``` - -**ๆœ€้ฉใช็ต„ใฟๅˆใ‚ใ›:** - -- **ใƒ–ใƒฌใ‚คใƒณใ‚นใƒˆใƒผใƒŸใƒณใ‚ฐโ†’**๏ผš่ฆไปถ็™บ่ฆ‹ใจไฝ“็ณป็š„ใชๅฎŸ่ฃ… -- **+ ใ‚ชใƒผใ‚ฑใ‚นใƒˆใƒฌใƒผใ‚ทใƒงใƒณ**: ๆœ€้ฉใชใƒ„ใƒผใƒซ้ธๆŠžใซใ‚ˆใ‚‹ใ‚ฟใ‚นใ‚ฏ่ชฟๆ•ด -- **+ ใ‚คใƒณใƒˆใƒญใ‚นใƒšใ‚ฏใ‚ทใƒงใƒณ**๏ผš่ค‡้›‘ใชใƒ•ใ‚งใƒผใ‚บใฎๆฑบๅฎšใฎใŸใ‚ใฎ้€้Ž็š„ใชๆŽจ่ซ– - ---- - -### ๐ŸŽฏ ใ‚ชใƒผใ‚ฑใ‚นใƒˆใƒฌใƒผใ‚ทใƒงใƒณใƒขใƒผใƒ‰ - ใ‚คใƒณใƒ†ใƒชใ‚ธใ‚งใƒณใƒˆใชใƒ„ใƒผใƒซ้ธๆŠž - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#-orchestration-mode---intelligent-tool-selection) - -**็›ฎ็š„**: ใ‚คใƒณใƒ†ใƒชใ‚ธใ‚งใƒณใƒˆใชใƒ„ใƒผใƒซใƒซใƒผใƒ†ใ‚ฃใƒณใ‚ฐใจไธฆๅˆ—่ชฟๆ•ดใ‚’้€šใ˜ใฆใ‚ฟใ‚นใ‚ฏใฎๅฎŸ่กŒใ‚’ๆœ€้ฉๅŒ–ใ—ใพใ™ใ€‚ - -**่‡ชๅ‹•ใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ™ใƒผใ‚ทใƒงใƒณใƒˆใƒชใ‚ฌใƒผ:** - -- ้ซ˜ๅบฆใช่ชฟๆ•ดใ‚’ๅฟ…่ฆใจใ™ใ‚‹ใƒžใƒซใƒใƒ„ใƒผใƒซๆ“ไฝœ -- ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นๅˆถ็ด„๏ผˆใƒชใ‚ฝใƒผใ‚นไฝฟ็”จ้‡ใŒๅคšใ„๏ผ‰ -- ไธฆๅˆ—ๅฎŸ่กŒใฎๆฉŸไผš๏ผˆ3ใคไปฅไธŠใฎ็‹ฌ็ซ‹ใ—ใŸใƒ•ใ‚กใ‚คใƒซ/ๆ“ไฝœ๏ผ‰ -- ่ค‡ๆ•ฐใฎๆœ‰ๅŠนใชใƒ„ใƒผใƒซใ‚ขใƒ—ใƒญใƒผใƒใซใ‚ˆใ‚‹่ค‡้›‘ใชใƒซใƒผใƒ†ใ‚ฃใƒณใ‚ฐๆฑบๅฎš - -**่กŒๅ‹•ใฎๅค‰ๅŒ–:** - -- **ใ‚คใƒณใƒ†ใƒชใ‚ธใ‚งใƒณใƒˆใƒ„ใƒผใƒซใƒซใƒผใƒ†ใ‚ฃใƒณใ‚ฐ**:ๅ„ใ‚ฟใ‚นใ‚ฏใ‚ฟใ‚คใƒ—ใซๆœ€้ฉใชMCPใ‚ตใƒผใƒใƒผใจใƒใ‚คใƒ†ใ‚ฃใƒ–ใƒ„ใƒผใƒซใ‚’้ธๆŠžใ—ใพใ™ใ€‚ -- **ใƒชใ‚ฝใƒผใ‚น่ช่ญ˜**: ใ‚ทใ‚นใƒ†ใƒ ใฎๅˆถ็ด„ใจๅฏ็”จๆ€งใซๅŸบใฅใ„ใฆใ‚ขใƒ—ใƒญใƒผใƒใ‚’้ฉๅฟœใ•ใ›ใพใ™ -- **ไธฆๅˆ—ๆœ€้ฉๅŒ–**: ๅŒๆ™‚ๅฎŸ่กŒใฎใŸใ‚ใฎ็‹ฌ็ซ‹ใ—ใŸๆ“ไฝœใ‚’่ญ˜ๅˆฅใ—ใพใ™ -- **่ชฟๆ•ดใฎ็„ฆ็‚น**๏ผš่ชฟๆ•ดใ•ใ‚ŒใŸๅฎŸ่กŒใ‚’้€šใ˜ใฆใƒ„ใƒผใƒซใฎ้ธๆŠžใจไฝฟ็”จใ‚’ๆœ€้ฉๅŒ–ใ—ใพใ™ -- **ใ‚ขใƒ€ใƒ—ใƒ†ใ‚ฃใƒ–ใƒ•ใ‚ฉใƒผใƒซใƒใƒƒใ‚ฏ**: ๅ„ชๅ…ˆใ‚ชใƒ—ใ‚ทใƒงใƒณใŒๅˆฉ็”จใงใใชใ„ๅ ดๅˆใซใƒ„ใƒผใƒซใ‚’้ฉๅˆ‡ใซๅˆ‡ใ‚Šๆ›ฟใˆใพใ™ - -**็ตŒ้จ“ไพ‹:** - -``` -Standard Approach: Sequential file-by-file analysis and editing -Orchestration Approach: -"๐ŸŽฏ Multi-Tool Coordination Strategy: - ๐Ÿ” Phase 1: Serena (semantic analysis) + Sequential (architecture review) - โšก Phase 2: Morphllm (pattern edits) + Magic (UI components) - ๐Ÿงช Phase 3: Playwright (testing) + Context7 (documentation patterns) - ๐Ÿ”„ Parallel execution: 3 tools working simultaneously -\" -``` - -**ๆœ€้ฉใช็ต„ใฟๅˆใ‚ใ›:** - -- **ใ‚ฟใ‚นใ‚ฏ็ฎก็† โ†’**ย : ่ค‡้›‘ใชๅคšๆฎต้šŽ่จˆ็”ปใฎใŸใ‚ใฎใƒ„ใƒผใƒซ่ชฟๆ•ดใ‚’ๆไพ›ใ—ใพใ™ -- **+ ใƒˆใƒผใ‚ฏใƒณๅŠน็Ž‡**: ๅœง็ธฎ้€šไฟกใซใ‚ˆใ‚‹ๆœ€้ฉใชใƒ„ใƒผใƒซ้ธๆŠž -- **่ค‡้›‘ใชใ‚ฟใ‚นใ‚ฏ**: ใ‚คใƒณใƒ†ใƒชใ‚ธใ‚งใƒณใƒˆใชใƒ„ใƒผใƒซใƒซใƒผใƒ†ใ‚ฃใƒณใ‚ฐใ‚’่ฟฝๅŠ ใ—ใฆๅฎŸ่กŒใ‚’ๅผทๅŒ– - ---- - -### โšก ใƒˆใƒผใ‚ฏใƒณๅŠน็Ž‡ใƒขใƒผใƒ‰ - ๅœง็ธฎ้€šไฟก - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#-token-efficiency-mode---compressed-communication) - -**็›ฎ็š„**: ๆƒ…ๅ ฑใฎๅ“่ณชใ‚’็ถญๆŒใ—ใชใŒใ‚‰ใ€ใ‚ทใƒณใƒœใƒซ ใ‚ทใ‚นใƒ†ใƒ ใ‚’้€šใ˜ใฆๆŽจๅฎš 30 ๏ฝž 50% ใฎใƒˆใƒผใ‚ฏใƒณๅ‰Šๆธ›ใ‚’ๅฎŸ็พใ—ใพใ™ใ€‚ - -**่‡ชๅ‹•ใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ™ใƒผใ‚ทใƒงใƒณใƒˆใƒชใ‚ฌใƒผ:** - -- ้ซ˜ใ„ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆใฎไฝฟ็”จใŒ้™็•Œใซ่ฟ‘ใฅใ„ใฆใ„ใพใ™ -- ่ณ‡ๆบๅŠน็Ž‡ใŒๆฑ‚ใ‚ใ‚‰ใ‚Œใ‚‹ๅคง่ฆๆจก้‹็”จ -- ใƒฆใƒผใ‚ถใƒผๆ˜Ž็คบใƒ•ใƒฉใ‚ฐ:ย `--uc`ใ€`--ultracompressed` -- ่ค‡ๆ•ฐใฎๅ‡บๅŠ›ใ‚’ๆŒใค่ค‡้›‘ใชๅˆ†ๆžใƒฏใƒผใ‚ฏใƒ•ใƒญใƒผ - -**่กŒๅ‹•ใฎๅค‰ๅŒ–:** - -- **ใ‚ทใƒณใƒœใƒซใ‚ณใƒŸใƒฅใƒ‹ใ‚ฑใƒผใ‚ทใƒงใƒณ**: ใƒญใ‚ธใƒƒใ‚ฏใƒ•ใƒญใƒผใ€ใ‚นใƒ†ใƒผใ‚ฟใ‚นใ€ๆŠ€่ก“ใƒ‰ใƒกใ‚คใƒณใซ่ฆ–่ฆš็š„ใชใ‚ทใƒณใƒœใƒซใ‚’ไฝฟ็”จใ—ใพใ™ -- **ๆŠ€่ก“็•ฅ่ชž**๏ผš็นฐใ‚Š่ฟ”ใ•ใ‚Œใ‚‹ๆŠ€่ก“็”จ่ชžใฎใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆ่ช่ญ˜ๅœง็ธฎ -- **ๆง‹้€ ๅŒ–ใ•ใ‚ŒใŸๅฏ†ๅบฆ**: ๅ†—้•ทใชๆฎต่ฝใ‚ˆใ‚Šใ‚‚็ฎ‡ๆกๆ›ธใใ€่กจใ€็ฐกๆฝ”ใชๆ›ธๅผ -- **ๆƒ…ๅ ฑไฟๅญ˜**: ๅœง็ธฎใ—ใฆใ‚‚95%ไปฅไธŠใฎๆƒ…ๅ ฑๅ“่ณชใ‚’็ถญๆŒ -- **ๆง‹้€ ๅŒ–ใ•ใ‚ŒใŸใƒ•ใ‚ฉใƒผใƒžใƒƒใƒˆ**: ๆ˜Ž็ขบใ•ใจใ‚ฟใ‚นใ‚ฏใฎๅฎŒไบ†ใฎใŸใ‚ใซๆ•ด็†ใ•ใ‚Œใฆใ„ใพใ™ - -**็ตŒ้จ“ไพ‹:** - -``` -Standard Approach: "The authentication system implementation shows a security vulnerability in the user validation function that needs immediate attention..." -Token Efficient Approach: -"๐Ÿ›ก๏ธ Security Alert: - auth.js:45 โ†’ user val() โ†’ critical vuln - ๐Ÿ“Š Impact: โŒ token bypass possible - โšก Action: fix validation + audit โˆต high sev - ๐Ÿ”ง Est: 2h impl + 1h test" -``` - -**ๆœ€้ฉใช็ต„ใฟๅˆใ‚ใ›:** - -- **ไปปๆ„ใฎใƒขใƒผใƒ‰**: ใƒขใƒผใƒ‰ๅ›บๆœ‰ใฎๅ‹•ไฝœใ‚’็ถญๆŒใ—ใชใŒใ‚‰ๅœง็ธฎใƒฌใ‚คใƒคใƒผใ‚’่ฟฝๅŠ ใ—ใพใ™ -- **ใ‚ชใƒผใ‚ฑใ‚นใƒˆใƒฌใƒผใ‚ทใƒงใƒณ โ†’**ย : ๅœง็ธฎใ•ใ‚ŒใŸใƒ„ใƒผใƒซ่ชฟๆ•ดใจใ‚นใƒ†ใƒผใ‚ฟใ‚นๆ›ดๆ–ฐ -- **ๆ‰‹ๅ‹•ใ‚ชใƒผใƒใƒผใƒฉใ‚คใƒ‰**:`--uc`ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆใฎใƒ—ใƒฌใƒƒใ‚ทใƒฃใƒผใ‚„ๅŠน็Ž‡ใŒๅ„ชๅ…ˆใ•ใ‚Œใ‚‹ๅ ดๅˆใซไฝฟ็”จใ—ใพใ™ - ---- - -### ๐ŸŽจ ๆจ™ๆบ–ใƒขใƒผใƒ‰ - ใƒใƒฉใƒณใ‚นใฎใจใ‚ŒใŸใƒ‡ใƒ•ใ‚ฉใƒซใƒˆ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#-standard-mode---balanced-default) - -**็›ฎ็š„**: ็ฐกๅ˜ใช้–‹็™บใ‚ฟใ‚นใ‚ฏใซๅฏพใ—ใฆๆ˜Ž็ขบใงใƒ—ใƒญใƒ•ใ‚งใƒƒใ‚ทใƒงใƒŠใƒซใชใ‚ณใƒŸใƒฅใƒ‹ใ‚ฑใƒผใ‚ทใƒงใƒณใ‚’ๆไพ›ใ—ใพใ™ใ€‚ - -**่‡ชๅ‹•ใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ™ใƒผใ‚ทใƒงใƒณใƒˆใƒชใ‚ฌใƒผ:** - -- ่ค‡้›‘ใ•ใฎๆŒ‡ๆจ™ใฎใชใ„ใ€ใ‚ทใƒณใƒ—ใƒซใงๆ˜Ž็ขบใซๅฎš็พฉใ•ใ‚ŒใŸใ‚ฟใ‚นใ‚ฏ -- ๆ˜Ž็ขบใช่ฆไปถใ‚’ๅ‚™ใˆใŸๅ˜ไธ€ใƒ•ใ‚กใ‚คใƒซๆ“ไฝœ -- ๅŸบๆœฌ็š„ใช่ชฌๆ˜Žใจๆจ™ๆบ–็š„ใช้–‹็™บใƒฏใƒผใ‚ฏใƒ•ใƒญใƒผ -- ไป–ใฎใƒขใƒผใƒ‰ใƒˆใƒชใ‚ฌใƒผใฏๆคœๅ‡บใ•ใ‚Œใพใ›ใ‚“๏ผˆใƒ‡ใƒ•ใ‚ฉใƒซใƒˆใฎใƒ•ใ‚ฉใƒผใƒซใƒใƒƒใ‚ฏ๏ผ‰ - -**่กŒๅ‹•ใฎๅค‰ๅŒ–:** - -- **ใƒ—ใƒญใƒ•ใ‚งใƒƒใ‚ทใƒงใƒŠใƒซใชใ‚ณใƒŸใƒฅใƒ‹ใ‚ฑใƒผใ‚ทใƒงใƒณ**๏ผšๆ˜Ž็ขบใง็ฐกๆฝ”ใชๆŠ€่ก“็”จ่ชž -- **ไธญ็จ‹ๅบฆใฎ่ฉณ็ดฐ**: ใปใจใ‚“ใฉใฎ้–‹็™บใ‚ฟใ‚นใ‚ฏใซ้ฉใ—ใŸใƒใƒฉใƒณใ‚นใฎๅ–ใ‚ŒใŸๆƒ…ๅ ฑใฎๆทฑใ• -- **ๆจ™ๆบ–ใƒ„ใƒผใƒซ้ธๆŠž**: ใƒใ‚คใƒ†ใ‚ฃใƒ–ใฎClaudeๆฉŸ่ƒฝใจๅŸบๆœฌใƒ„ใƒผใƒซใ‚’ไฝฟ็”จ -- **ๅ“่ณช้‡่ฆ–**: ่ค‡้›‘ใชใ‚ชใƒผใ‚ฑใ‚นใƒˆใƒฌใƒผใ‚ทใƒงใƒณใฎใ‚ชใƒผใƒใƒผใƒ˜ใƒƒใƒ‰ใชใ—ใงใ‚ณใƒผใƒ‰ใฎๅ“่ณชใ‚’็ถญๆŒ -- **ๅฟœ็ญ”็š„ใช้ฉๅฟœ**๏ผš่ค‡้›‘ใ•ใŒๅข—ใ™ใจใ€็‰นๅŒ–ใ—ใŸใƒขใƒผใƒ‰ใซๅˆ‡ใ‚Šๆ›ฟใˆใ‚‹ๆบ–ๅ‚™ใŒใงใใฆใ„ใพใ™ - -**็ตŒ้จ“ไพ‹:** - -``` -Standard Approach: Consistent, professional baseline for all tasks -"I'll implement the login function with proper error handling: - - 1. Validate user input (email format, password requirements) - 2. Authenticate against database with secure hashing - 3. Generate JWT token with appropriate expiration - 4. Return success response with user data - - The implementation will follow security best practices and include comprehensive error handling." -``` - -**ๆœ€้ฉใช็ต„ใฟๅˆใ‚ใ›:** - -- **โ†’ ไปปๆ„ใฎใƒขใƒผใƒ‰**: ไป–ใฎใƒขใƒผใƒ‰ใ‚’ๅผทๅŒ–ใ™ใ‚‹ๅŸบๆบ–ใจใ—ใฆๆฉŸ่ƒฝใ—ใพใ™ -- **ใƒขใƒผใƒ‰ๅˆ‡ใ‚Šๆ›ฟใˆ**: ๅฟ…่ฆใซๅฟœใ˜ใฆ่‡ชๅ‹•็š„ใซ็‰นๆฎŠใƒขใƒผใƒ‰ใซๅˆ‡ใ‚Šๆ›ฟใˆใพใ™ -- **ๆ˜Ž็ขบใ•ใฎๅ„ชๅ…ˆ**: ๆœ€้ฉๅŒ–ใ‚ˆใ‚Šใ‚‚ๅˆ†ใ‹ใ‚Šใ‚„ใ™ใ„ใ‚ณใƒŸใƒฅใƒ‹ใ‚ฑใƒผใ‚ทใƒงใƒณใŒ้‡่ฆใชๅ ดๅˆ - ---- - -## ้ซ˜ๅบฆใชไฝฟ็”จๆณ• - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#advanced-usage) - -### ใƒขใƒผใƒ‰ใฎ็ต„ใฟๅˆใ‚ใ› - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#mode-combinations) - -**ใƒžใƒซใƒใƒขใƒผใƒ‰ใƒฏใƒผใ‚ฏใƒ•ใƒญใƒผ:** - -```shell -# Discovery โ†’ Planning โ†’ Implementation -/sc:brainstorm "microservices architecture" --task-manage -# โ†’ Brainstorming: requirement discovery -# โ†’ Task Management: multi-phase coordination - -# Analysis with transparency and efficiency -/sc:analyze legacy-system/ --introspect --uc -# โ†’ Introspection: transparent reasoning -# โ†’ Token Efficiency: compressed output -``` - -### ๆ‰‹ๅ‹•ใƒขใƒผใƒ‰ๅˆถๅพก - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#manual-mode-control) - -**็‰นๅฎšใฎๅ‹•ไฝœใ‚’ๅผทๅˆถใ™ใ‚‹:** - -- `--brainstorm`: ใ‚ใ‚‰ใ‚†ใ‚‹ใ‚ฟใ‚นใ‚ฏใงๅ…ฑๅŒ็™บ่ฆ‹ใ‚’ๅผทๅˆถ -- `--introspect`: ใ‚ใ‚‰ใ‚†ใ‚‹ใƒขใƒผใƒ‰ใซๆŽจ่ซ–ใฎ้€ๆ˜Žๆ€งใ‚’่ฟฝๅŠ  -- `--task-manage`: ้šŽๅฑค็š„ใช่ชฟๆ•ดใ‚’ๅฏ่ƒฝใซใ™ใ‚‹ -- `--orchestrate`: ใƒ„ใƒผใƒซ้ธๆŠžใจไธฆๅˆ—ๅฎŸ่กŒใ‚’ๆœ€้ฉๅŒ– -- `--uc`: ๅŠน็Ž‡ๅŒ–ใฎใŸใ‚ใซ้€šไฟกใ‚’ๅœง็ธฎใ™ใ‚‹ - -**ใ‚ชใƒผใƒใƒผใƒฉใ‚คใƒ‰ใฎไพ‹:** - -```shell -# Force brainstorming on "clear" requirements -/sc:implement "user login" --brainstorm - -# Add reasoning transparency to debugging -# ่ช่จผๅ•้กŒใ‚’้€ๆ˜ŽใชๆŽจ็†ใงใƒ‡ใƒใƒƒใ‚ฐ - -# Enable task management for simple operations -# ใ‚ทใ‚นใƒ†ใƒžใƒใƒƒใ‚ฏใชใ‚ฟใ‚นใ‚ฏ็ฎก็†ใงใ‚นใ‚ฟใ‚คใƒซใƒ•ใ‚กใ‚คใƒซใ‚’ๆ›ดๆ–ฐ -``` - -### ใƒขใƒผใƒ‰ใฎๅขƒ็•Œใจๅ„ชๅ…ˆ้ †ไฝ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#mode-boundaries-and-priority) - -**ใƒขใƒผใƒ‰ใŒใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ–ใซใชใ‚‹ใจ:** - -1. **่ค‡้›‘ใ•ใฎ้–พๅ€ค**: >3ใƒ•ใ‚กใ‚คใƒซ โ†’ ใ‚ฟใ‚นใ‚ฏ็ฎก็† -2. **ใƒชใ‚ฝใƒผใ‚นใฎๅœงๅŠ›**๏ผšใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆไฝฟ็”จ็Ž‡ใŒ้ซ˜ใ„ โ†’ ใƒˆใƒผใ‚ฏใƒณๅŠน็Ž‡ -3. **่ค‡ๆ•ฐใฎใƒ„ใƒผใƒซใŒๅฟ…่ฆ**: ่ค‡้›‘ใชๅˆ†ๆž โ†’ ใ‚ชใƒผใ‚ฑใ‚นใƒˆใƒฌใƒผใ‚ทใƒงใƒณ -4. **ไธ็ขบๅฎŸๆ€ง**๏ผšๆผ ็„ถใจใ—ใŸ่ฆไปถ โ†’ ใƒ–ใƒฌใ‚คใƒณใ‚นใƒˆใƒผใƒŸใƒณใ‚ฐ -5. **ใ‚จใƒฉใƒผๅ›žๅพฉ**๏ผšๅ•้กŒ โ†’ ใ‚คใƒณใƒˆใƒญใ‚นใƒšใ‚ฏใ‚ทใƒงใƒณ - -**ๅ„ชๅ…ˆใƒซใƒผใƒซ:** - -- **ๅฎ‰ๅ…จ็ฌฌไธ€**๏ผšๅ“่ณชใจๆคœ่จผใฏๅธธใซๅŠน็Ž‡ใ‚ˆใ‚Šใ‚‚ๅ„ชๅ…ˆใ•ใ‚Œใพใ™ -- **ใƒฆใƒผใ‚ถใƒผใฎๆ„ๅ›ณ**: ๆ‰‹ๅ‹•ใƒ•ใƒฉใ‚ฐใฏ่‡ชๅ‹•ๆคœๅ‡บใ‚’ไธŠๆ›ธใใ—ใพใ™ -- **ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆ้ฉๅฟœ**: ่ค‡้›‘ใ•ใซๅŸบใฅใ„ใฆใƒขใƒผใƒ‰ใ‚’ใ‚นใ‚ฟใƒƒใ‚ฏ -- **ใƒชใ‚ฝใƒผใ‚น็ฎก็†**๏ผšใƒ—ใƒฌใƒƒใ‚ทใƒฃใƒผไธ‹ใงใฏๅŠน็Ž‡ใƒขใƒผใƒ‰ใŒๆดปๆ€งๅŒ–ใ™ใ‚‹ - ---- - -## ๅฎŸไธ–็•Œใฎไพ‹ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#real-world-examples) - -### ๅฎŒๅ…จใชใƒฏใƒผใ‚ฏใƒ•ใƒญใƒผใฎไพ‹ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#complete-workflow-examples) - -**ๆ–ฐ่ฆใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆ้–‹็™บ:** - -```shell -# Phase 1: Discovery (Brainstorming Mode auto-activates) -"I want to build a productivity app" -โ†’ ๐Ÿค” Socratic questions about users, features, platform choice -โ†’ ๐Ÿ“ Structured requirements brief - -# Phase 2: Planning (Task Management Mode auto-activates) -/sc:implement "core productivity features" -โ†’ ๐Ÿ“‹ Multi-phase breakdown with dependencies -โ†’ ๐ŸŽฏ Phase coordination with quality gates - -# Phase 3: Implementation (Orchestration Mode coordinates tools) -/sc:implement "frontend and backend systems" -โ†’ ๐ŸŽฏ Magic (UI) + Context7 (patterns) + Sequential (architecture) -โ†’ โšก Parallel execution optimization -``` - -**่ค‡้›‘ใชๅ•้กŒใฎใƒ‡ใƒใƒƒใ‚ฐ:** - -```shell -# Problem analysis (Introspection Mode auto-activates) -"Users getting intermittent auth failures" -โ†’ ๐Ÿค” Transparent reasoning about potential causes -โ†’ ๐ŸŽฏ Hypothesis formation and evidence gathering -โ†’ ๐Ÿ’ก Pattern recognition across similar issues - -# Systematic resolution (Task Management coordinates) -# ่ช่จผใ‚ทใ‚นใƒ†ใƒ ใ‚’ๅŒ…ๆ‹ฌ็š„ใซไฟฎๆญฃ -โ†’ ๐Ÿ“‹ Phase 1: Root cause analysis -โ†’ ๐Ÿ“‹ Phase 2: Solution implementation -โ†’ ๐Ÿ“‹ Phase 3: Testing and validation -``` - -### ใƒขใƒผใƒ‰ใฎ็ต„ใฟๅˆใ‚ใ›ใƒ‘ใ‚ฟใƒผใƒณ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#mode-combination-patterns) - -**้žๅธธใซ่ค‡้›‘ใชใ‚ทใƒŠใƒชใ‚ช:** - -```shell -# Large refactoring with multiple constraints -/sc:improve legacy-system/ --introspect --uc --orchestrate -โ†’ ๐Ÿ” Transparent reasoning (Introspection) -โ†’ โšก Compressed communication (Token Efficiency) -โ†’ ๐ŸŽฏ Optimal tool coordination (Orchestration) -โ†’ ๐Ÿ“‹ Systematic phases (Task Management auto-activates) -``` - ---- - -## ใ‚ฏใ‚คใƒƒใ‚ฏใƒชใƒ•ใ‚กใƒฌใƒณใ‚น - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#quick-reference) - -### ใƒขใƒผใƒ‰่ตทๅ‹•ใƒ‘ใ‚ฟใƒผใƒณ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#mode-activation-patterns) - -|ใƒˆใƒชใ‚ฌใƒผใ‚ฟใ‚คใƒ—|ๅ…ฅๅŠ›ไพ‹|ใƒขใƒผใƒ‰ใŒๆœ‰ๅŠน|ไธป่ฆใชๅ‹•ไฝœ| -|---|---|---|---| -|**ๆผ ็„ถใจใ—ใŸ่ฆๆฑ‚**|ใ€Œใ‚ขใƒ—ใƒชใ‚’ไฝœใ‚ŠใŸใ„ใ€|๐Ÿง  ใƒ–ใƒฌใ‚คใƒณใ‚นใƒˆใƒผใƒŸใƒณใ‚ฐ|ใ‚ฝใ‚ฏใƒฉใƒ†ใ‚นๅผใฎ็™บ่ฆ‹็š„่ณชๅ•| -|**่ค‡้›‘ใชใ‚นใ‚ณใƒผใƒ—**|>3 ใคใฎใƒ•ใ‚กใ‚คใƒซใพใŸใฏ >2 ใคใฎใƒ‡ใ‚ฃใƒฌใ‚ฏใƒˆใƒช|๐Ÿ“‹ ใ‚ฟใ‚นใ‚ฏ็ฎก็†|ไฝ็›ธ่ชฟๆ•ด| -|**ใƒžใƒซใƒใƒ„ใƒผใƒซใฎๅฟ…่ฆๆ€ง**|ๅˆ†ๆž + ๅฎŸ่ฃ…|๐ŸŽฏ ใ‚ชใƒผใ‚ฑใ‚นใƒˆใƒฌใƒผใ‚ทใƒงใƒณ|ใƒ„ใƒผใƒซใฎๆœ€้ฉๅŒ–| -|**ใ‚จใƒฉใƒผๅ›žๅพฉ**|ใ€ŒๆœŸๅพ…้€šใ‚Šใซๅ‹•ไฝœใ—ใฆใ„ใพใ›ใ‚“ใ€|๐Ÿ” ๅ†…็œ|้€ๆ˜ŽใชๆŽจ่ซ–| -|**ใƒชใ‚ฝใƒผใ‚นใฎๅœงๅŠ›**|้ซ˜ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆไฝฟ็”จ|โšก ใƒˆใƒผใ‚ฏใƒณๅŠน็Ž‡|ใ‚ทใƒณใƒœใƒซๅœง็ธฎ| -|**็ฐกๅ˜ใชใ‚ฟใ‚นใ‚ฏ**|ใ€Œใ“ใฎๆฉŸ่ƒฝใ‚’ไฟฎๆญฃใ™ใ‚‹ใ€|๐ŸŽจ ๆจ™ๆบ–|ๆ˜Ž็ขบใง็›ดๆŽฅ็š„ใชใ‚ขใƒ—ใƒญใƒผใƒ| - -### ๆ‰‹ๅ‹•ใ‚ชใƒผใƒใƒผใƒฉใ‚คใƒ‰ใ‚ณใƒžใƒณใƒ‰ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#manual-override-commands) - -```shell -# Force specific mode behaviors -/sc:command --brainstorm # Collaborative discovery -/sc:command --introspect # Reasoning transparency -/sc:command --task-manage # Hierarchical coordination -/sc:command --orchestrate # Tool optimization -/sc:command --uc # Token compression - -# Combine multiple modes -/sc:command --introspect --uc # Transparent + efficient -/sc:command --task-manage --orchestrate # Coordinated + optimized -``` - ---- - -## ใƒˆใƒฉใƒ–ใƒซใ‚ทใƒฅใƒผใƒ†ใ‚ฃใƒณใ‚ฐ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#troubleshooting) - -ใƒˆใƒฉใƒ–ใƒซใ‚ทใƒฅใƒผใƒ†ใ‚ฃใƒณใ‚ฐใฎใƒ˜ใƒซใƒ—ใซใคใ„ใฆใฏใ€ไปฅไธ‹ใ‚’ๅ‚็…งใ—ใฆใใ ใ•ใ„ใ€‚ - -- [ใ‚ˆใใ‚ใ‚‹ๅ•้กŒ](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Reference/common-issues.md)- ใ‚ˆใใ‚ใ‚‹ๅ•้กŒใซๅฏพใ™ใ‚‹ใ‚ฏใ‚คใƒƒใ‚ฏไฟฎๆญฃ -- [ใƒˆใƒฉใƒ–ใƒซใ‚ทใƒฅใƒผใƒ†ใ‚ฃใƒณใ‚ฐใ‚ฌใ‚คใƒ‰](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Reference/troubleshooting.md)- ๅŒ…ๆ‹ฌ็š„ใชๅ•้กŒ่งฃๆฑบ - -### ใ‚ˆใใ‚ใ‚‹ๅ•้กŒ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#common-issues) - -- **ใƒขใƒผใƒ‰ใŒใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ–ๅŒ–ใ•ใ‚Œใฆใ„ใพใ›ใ‚“**: ๆ‰‹ๅ‹•ใƒ•ใƒฉใ‚ฐใ‚’ไฝฟ็”จใ—ใฆใใ ใ•ใ„:ย `--brainstorm`ใ€ใ€`--introspect``--uc` -- **้–“้•ใฃใŸใƒขใƒผใƒ‰ใŒใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ–ใงใ™**: ใƒชใ‚ฏใ‚จใ‚นใƒˆๅ†…ใฎ่ค‡้›‘ใชใƒˆใƒชใ‚ฌใƒผใจใ‚ญใƒผใƒฏใƒผใƒ‰ใ‚’็ขบ่ชใ—ใฆใใ ใ•ใ„ -- **ไบˆๆœŸใ—ใชใ„ใƒขใƒผใƒ‰ๅˆ‡ใ‚Šๆ›ฟใˆ**๏ผšใ‚ฟใ‚นใ‚ฏใฎ้€ฒ่กŒใซๅŸบใฅใ้€šๅธธใฎๅ‹•ไฝœ -- **ๅฎŸ่กŒใธใฎๅฝฑ้Ÿฟ**: ใƒขใƒผใƒ‰ใฏใƒ„ใƒผใƒซใฎไฝฟ็”จใ‚’ๆœ€้ฉๅŒ–ใ™ใ‚‹ใ‚‚ใฎใงใ‚ใ‚Šใ€ๅฎŸ่กŒใซใฏๅฝฑ้Ÿฟใ—ใชใ„ใฏใšใงใ™ใ€‚ -- **ใƒขใƒผใƒ‰ใฎ็ซถๅˆ**:[ใƒ•ใƒฉใ‚ฐใ‚ฌใ‚คใƒ‰ใงใƒ•ใƒฉใ‚ฐใฎๅ„ชๅ…ˆ้ †ไฝใƒซใƒผใƒซใ‚’็ขบ่ชใ—ใฆใใ ใ•ใ„](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md) - -### ๅณๆ™‚ไฟฎๆญฃ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#immediate-fixes) - -- **็‰นๅฎšใฎใƒขใƒผใƒ‰ใ‚’ๅผทๅˆถ**:`--brainstorm`ใพใŸใฏใฎใ‚ˆใ†ใชๆ˜Ž็คบ็š„ใชใƒ•ใƒฉใ‚ฐใ‚’ไฝฟ็”จใ™ใ‚‹`--task-manage` -- **ใƒชใ‚ปใƒƒใƒˆใƒขใƒผใƒ‰ใฎๅ‹•ไฝœ**: ใƒขใƒผใƒ‰็Šถๆ…‹ใ‚’ใƒชใ‚ปใƒƒใƒˆใ™ใ‚‹ใซใฏใ€Claude Code ใ‚ปใƒƒใ‚ทใƒงใƒณใ‚’ๅ†่ตทๅ‹•ใ—ใพใ™ใ€‚ -- **ใƒขใƒผใƒ‰ใ‚คใƒณใ‚ธใ‚ฑใƒผใ‚ฟใƒผใ‚’็ขบ่ชใ™ใ‚‹**: ๅฟœ็ญ”ใซ๐Ÿค”ใ€๐ŸŽฏใ€๐Ÿ“‹ใฎ่จ˜ๅทใŒใ‚ใ‚‹ใ‹ใฉใ†ใ‹ใ‚’็ขบ่ชใ—ใพใ™ -- **่ค‡้›‘ใ•ใ‚’ๆคœ่จผ**: ๅ˜็ด”ใชใ‚ฟใ‚นใ‚ฏใฏๆจ™ๆบ–ใƒขใƒผใƒ‰ใ‚’ไฝฟ็”จใ—ใ€่ค‡้›‘ใชใ‚ฟใ‚นใ‚ฏใฏ่‡ชๅ‹•็š„ใซๅˆ‡ใ‚Šๆ›ฟใ‚ใ‚Šใพใ™ - -### ใƒขใƒผใƒ‰ๅ›บๆœ‰ใฎใƒˆใƒฉใƒ–ใƒซใ‚ทใƒฅใƒผใƒ†ใ‚ฃใƒณใ‚ฐ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#mode-specific-troubleshooting) - -**ใƒ–ใƒฌใ‚คใƒณใ‚นใƒˆใƒผใƒŸใƒณใ‚ฐใƒขใƒผใƒ‰ใฎๅ•้กŒ:** - -```shell -# Problem: Mode gives solutions instead of asking questions -# Quick Fix: Check request clarity and use explicit flag -/sc:brainstorm "web app" --brainstorm # Force discovery mode -"I have a vague idea about..." # Use uncertainty language -"Maybe we could build..." # Trigger exploration -``` - -**ใ‚ฟใ‚นใ‚ฏ็ฎก็†ใƒขใƒผใƒ‰ใฎๅ•้กŒ:** - -```shell -# Problem: Simple tasks getting complex coordination -# Quick Fix: Reduce scope or use simpler commands -/sc:implement "function" --no-task-manage # Disable coordination -/sc:troubleshoot bug.js # Use basic commands -# Check if task really is complex (>3 files, >2 directories) -``` - -**ใƒˆใƒผใ‚ฏใƒณๅŠน็Ž‡ใƒขใƒผใƒ‰ใฎๅ•้กŒ:** - -```shell -# Problem: Output too compressed or unclear -# Quick Fix: Disable compression for clarity -/sc:command --no-uc # Disable compression -/sc:command --verbose # Force detailed output -# Use when clarity is more important than efficiency -``` - -**ใ‚คใƒณใƒˆใƒญใ‚นใƒšใ‚ฏใ‚ทใƒงใƒณใƒขใƒผใƒ‰ใฎๅ•้กŒ:** - -```shell -# Problem: Too much meta-commentary, not enough action -# Quick Fix: Disable introspection for direct work -/sc:command --no-introspect # Direct execution -# Use introspection only for learning and debugging -``` - -**ใ‚ชใƒผใ‚ฑใ‚นใƒˆใƒฌใƒผใ‚ทใƒงใƒณ ใƒขใƒผใƒ‰ใฎๅ•้กŒ:** - -```shell -# Problem: Tool coordination causing confusion -# Quick Fix: Simplify tool usage -/sc:command --no-mcp # Native tools only -/sc:command --simple # Basic execution -# Check if task complexity justifies orchestration -``` - -### ใ‚จใƒฉใƒผใ‚ณใƒผใƒ‰ใƒชใƒ•ใ‚กใƒฌใƒณใ‚น - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#error-code-reference) - -|ใƒขใƒผใƒ‰ใ‚จใƒฉใƒผ|ๆ„ๅ‘ณ|ใ‚ฏใ‚คใƒƒใ‚ฏใƒ•ใ‚ฃใƒƒใ‚ฏใ‚น| -|---|---|---| -|**B001**|ใƒ–ใƒฌใ‚คใƒณใ‚นใƒˆใƒผใƒŸใƒณใ‚ฐใŒ่ตทๅ‹•ใงใใพใ›ใ‚“ใงใ—ใŸ|`--brainstorm`ๆ˜Ž็คบ็š„ใชใƒ•ใƒฉใ‚ฐใ‚’ไฝฟ็”จใ™ใ‚‹| -|**T001**|ใ‚ฟใ‚นใ‚ฏ็ฎก็†ใฎใ‚ชใƒผใƒใƒผใƒ˜ใƒƒใƒ‰|`--no-task-manage`็ฐกๅ˜ใชใ‚ฟใ‚นใ‚ฏใซไฝฟ็”จใ™ใ‚‹| -|**U001**|ใƒˆใƒผใ‚ฏใƒณๅŠน็Ž‡ใŒๅผทใ™ใŽใ‚‹|ไฝฟ็”จ`--verbose`ใพใŸใฏ`--no-uc`| -|**I001**|ใ‚คใƒณใƒˆใƒญใ‚นใƒšใ‚ฏใ‚ทใƒงใƒณใƒขใƒผใƒ‰ใŒๅœๆญขใ—ใพใ—ใŸ|`--no-introspect`็›ดๆŽฅ่กŒๅ‹•ใซไฝฟใ†| -|**O001**|ใ‚ชใƒผใ‚ฑใ‚นใƒˆใƒฌใƒผใ‚ทใƒงใƒณ่ชฟๆ•ดใซๅคฑๆ•—|ไฝฟ็”จ`--no-mcp`ใพใŸใฏ`--simple`| -|**M001**|ใƒขใƒผใƒ‰ใฎ็ซถๅˆใŒๆคœๅ‡บใ•ใ‚Œใพใ—ใŸ|ใƒ•ใƒฉใ‚ฐใฎๅ„ชๅ…ˆ้ †ไฝใฎใƒซใƒผใƒซใ‚’็ขบ่ชใ™ใ‚‹| -|**M002**|ใƒขใƒผใƒ‰ๅˆ‡ใ‚Šๆ›ฟใˆใƒซใƒผใƒ—|็Šถๆ…‹ใ‚’ใƒชใ‚ปใƒƒใƒˆใ™ใ‚‹ใซใฏใ‚ปใƒƒใ‚ทใƒงใƒณใ‚’ๅ†่ตทๅ‹•ใ—ใฆใใ ใ•ใ„| -|**M003**|ใƒขใƒผใƒ‰ใŒ่ช่ญ˜ใ•ใ‚Œใพใ›ใ‚“|SuperClaudeใ‚’ๆ›ดๆ–ฐใ™ใ‚‹ใ‹ใ‚นใƒšใƒซใ‚’ใƒใ‚งใƒƒใ‚ฏใ™ใ‚‹| - -### ใƒ—ใƒญใ‚ฐใƒฌใƒƒใ‚ทใƒ–ใ‚ตใƒใƒผใƒˆใƒฌใƒ™ใƒซ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#progressive-support-levels) - -**ใƒฌใƒ™ใƒซ 1: ใ‚ฏใ‚คใƒƒใ‚ฏใƒ•ใ‚ฃใƒƒใ‚ฏใ‚น (< 2 ๅˆ†)** - -- ่‡ชๅ‹•ใƒขใƒผใƒ‰้ธๆŠžใ‚’็„กๅŠนใซใ™ใ‚‹ใซใฏๆ‰‹ๅ‹•ใƒ•ใƒฉใ‚ฐใ‚’ไฝฟ็”จใ—ใพใ™ -- ใ‚ฟใ‚นใ‚ฏใฎ่ค‡้›‘ใ•ใŒๆœŸๅพ…ใ•ใ‚Œใ‚‹ใƒขใƒผใƒ‰ใฎๅ‹•ไฝœใจไธ€่‡ดใ—ใฆใ„ใ‚‹ใ‹ใฉใ†ใ‹ใ‚’็ขบ่ชใ™ใ‚‹ -- Claude Codeใ‚ปใƒƒใ‚ทใƒงใƒณใ‚’ๅ†่ตทๅ‹•ใ—ใฆใฟใฆใใ ใ•ใ„ - -**ใƒฌใƒ™ใƒซ2: ่ฉณ็ดฐใชใƒ˜ใƒซใƒ—๏ผˆ5๏ฝž15ๅˆ†๏ผ‰** - -```shell -# Mode-specific diagnostics -/sc:help modes # List all available modes -/sc:reflect --type mode-status # Check current mode state -# Review request complexity and triggers -``` - -- ใƒขใƒผใƒ‰ใฎใ‚คใƒณใ‚นใƒˆใƒผใƒซใซ้–ขใ™ใ‚‹ๅ•้กŒใซใคใ„ใฆใฏใ€[ไธ€่ˆฌ็š„ใชๅ•้กŒใ‚ฌใ‚คใƒ‰ใ‚’](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Reference/common-issues.md)ๅ‚็…งใ—ใฆใใ ใ•ใ„ใ€‚ - -**ใƒฌใƒ™ใƒซ3: ๅฐ‚้–€ๅฎถใซใ‚ˆใ‚‹ใ‚ตใƒใƒผใƒˆ๏ผˆ30ๅˆ†ไปฅไธŠ๏ผ‰** - -```shell -# Deep mode analysis -SuperClaude install --diagnose -# Check mode activation patterns -# Review behavioral triggers and thresholds -``` - -- ่กŒๅ‹•ใƒขใƒผใƒ‰ๅˆ†ๆžใซใคใ„ใฆใฏ[่จบๆ–ญใƒชใƒ•ใ‚กใƒฌใƒณใ‚นใ‚ฌใ‚คใƒ‰](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Reference/diagnostic-reference.md)ใ‚’ๅ‚็…งใ—ใฆใใ ใ•ใ„ - -**ใƒฌใƒ™ใƒซ4: ใ‚ณใƒŸใƒฅใƒ‹ใƒ†ใ‚ฃใ‚ตใƒใƒผใƒˆ** - -- [GitHub Issues](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues)ใงใฎใƒขใƒผใƒ‰ใฎๅ•้กŒใฎๅ ฑๅ‘Š[](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues) -- ไบˆๆœŸใ—ใชใ„ใƒขใƒผใƒ‰ๅ‹•ไฝœใฎไพ‹ใ‚’ๅซใ‚ใ‚‹ -- ๆœ›ใพใ—ใ„ใƒขใƒผใƒ‰ใจๅฎŸ้š›ใฎใƒขใƒผใƒ‰ใฎใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ™ใƒผใ‚ทใƒงใƒณใ‚’่ชฌๆ˜Žใ™ใ‚‹ - -### ๆˆๅŠŸใฎๆคœ่จผ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#success-validation) - -ใƒขใƒผใƒ‰ไฟฎๆญฃใ‚’้ฉ็”จใ—ใŸๅพŒใ€ๆฌกใฎใ‚ˆใ†ใซใƒ†ใ‚นใƒˆใ—ใพใ™ใ€‚ - -- [ ] ใ‚ทใƒณใƒ—ใƒซใชใƒชใ‚ฏใ‚จใ‚นใƒˆใซใฏๆจ™ๆบ–ใƒขใƒผใƒ‰๏ผˆๆ˜Ž็ขบใง็›ดๆŽฅ็š„ใชๅฟœ็ญ”๏ผ‰ใ‚’ไฝฟ็”จใ—ใพใ™ -- [ ] ่ค‡้›‘ใช่ฆๆฑ‚ใฏ้ฉๅˆ‡ใชใƒขใƒผใƒ‰๏ผˆ่ชฟๆ•ดใ€ๆŽจ่ซ–๏ผ‰ใ‚’่‡ชๅ‹•็š„ใซใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ–ๅŒ–ใ—ใพใ™ -- [ ] ๆ‰‹ๅ‹•ใƒ•ใƒฉใ‚ฐใฏ่‡ชๅ‹•ๆคœๅ‡บใ‚’ๆญฃใ—ใไธŠๆ›ธใใ—ใพใ™ -- [ ] ใƒขใƒผใƒ‰ใ‚คใƒณใ‚ธใ‚ฑใƒผใ‚ฟใƒผ๏ผˆ๐Ÿค”ใ€๐ŸŽฏใ€๐Ÿ“‹๏ผ‰ใฏไบˆๆƒณ้€šใ‚Šใซ่กจ็คบใ•ใ‚Œใพใ™ -- [ ] ใ•ใพใ–ใพใชใƒขใƒผใƒ‰ใงใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นใฏ่‰ฏๅฅฝใงใ™ - -## ใ‚ฏใ‚คใƒƒใ‚ฏใƒˆใƒฉใƒ–ใƒซใ‚ทใƒฅใƒผใƒ†ใ‚ฃใƒณใ‚ฐ๏ผˆใƒฌใ‚ฌใ‚ทใƒผ๏ผ‰ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#quick-troubleshooting-legacy) - -- **ใƒขใƒผใƒ‰ใŒใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ–ๅŒ–ใ•ใ‚Œใชใ„**โ†’ๆ‰‹ๅ‹•ใƒ•ใƒฉใ‚ฐใ‚’ไฝฟ็”จ:ย `--brainstorm`ใ€ใ€`--introspect``--uc` -- **้–“้•ใฃใŸใƒขใƒผใƒ‰ใŒใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ–ใงใ™**โ†’ ใƒชใ‚ฏใ‚จใ‚นใƒˆๅ†…ใฎ่ค‡้›‘ใชใƒˆใƒชใ‚ฌใƒผใจใ‚ญใƒผใƒฏใƒผใƒ‰ใ‚’็ขบ่ชใ—ใฆใใ ใ•ใ„ -- **ไบˆๆœŸใ›ใฌใƒขใƒผใƒ‰ๅˆ‡ใ‚Šๆ›ฟใˆ**โ†’ ใ‚ฟใ‚นใ‚ฏใฎ้€ฒ่กŒใซๅŸบใฅใ้€šๅธธใฎๅ‹•ไฝœ -- **ๅฎŸ่กŒใธใฎๅฝฑ้Ÿฟ**โ†’ ใƒขใƒผใƒ‰ใฏใƒ„ใƒผใƒซใฎไฝฟ็”จใ‚’ๆœ€้ฉๅŒ–ใ™ใ‚‹ใ‚‚ใฎใงใ‚ใ‚Šใ€ๅฎŸ่กŒใซใฏๅฝฑ้Ÿฟใ—ใชใ„ใฏใšใงใ™ -- **ใƒขใƒผใƒ‰ใฎ็ซถๅˆโ†’**[ใƒ•ใƒฉใ‚ฐใ‚ฌใ‚คใƒ‰](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md)ใงใƒ•ใƒฉใ‚ฐใฎๅ„ชๅ…ˆ้ †ไฝใƒซใƒผใƒซใ‚’็ขบ่ชใ—ใฆใใ ใ•ใ„[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md) - -## ใ‚ˆใใ‚ใ‚‹่ณชๅ• - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#frequently-asked-questions) - -**Q: ใฉใฎใƒขใƒผใƒ‰ใŒใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ–ใซใชใฃใฆใ„ใ‚‹ใ‹ใฏใฉใ†ใ™ใ‚Œใฐใ‚ใ‹ใ‚Šใพใ™ใ‹?**ย A: ้€šไฟกใƒ‘ใ‚ฟใƒผใƒณใงๆฌกใฎใ‚คใƒณใ‚ธใ‚ฑใƒผใ‚ฟใƒผใ‚’็ขบ่ชใ—ใฆใใ ใ•ใ„ใ€‚ - -- ๐Ÿค”็™บ่ฆ‹ใฎ่ณชๅ• โ†’ ใƒ–ใƒฌใ‚คใƒณใ‚นใƒˆใƒผใƒŸใƒณใ‚ฐ -- ๐ŸŽฏ ๆŽจ่ซ–ใฎ้€ๆ˜Žๆ€ง โ†’ ๅ†…็œ -- ใƒ•ใ‚งใƒผใ‚บใฎๅ†…่จณ โ†’ ใ‚ฟใ‚นใ‚ฏ็ฎก็† -- ใƒ„ใƒผใƒซ่ชฟๆ•ด โ†’ ใ‚ชใƒผใ‚ฑใ‚นใƒˆใƒฌใƒผใ‚ทใƒงใƒณ -- ใ‚ทใƒณใƒœใƒซๅœง็ธฎ โ†’ ใƒˆใƒผใ‚ฏใƒณๅŠน็Ž‡ - -**Q: ็‰นๅฎšใฎใƒขใƒผใƒ‰ใ‚’ๅผทๅˆถใงใใพใ™ใ‹?**ย A: ใฏใ„ใ€ๆ‰‹ๅ‹•ใƒ•ใƒฉใ‚ฐใ‚’ไฝฟ็”จใ—ใฆ่‡ชๅ‹•ๆคœๅ‡บใ‚’ใ‚ชใƒผใƒใƒผใƒฉใ‚คใƒ‰ใ—ใพใ™ใ€‚ - -```shell -/sc:command --brainstorm # Force discovery -/sc:command --introspect # Add transparency -/sc:command --task-manage # Enable coordination -/sc:command --uc # Compress output -``` - -**Q: ใƒขใƒผใƒ‰ใฏๅฎŸ่กŒใซๅฝฑ้Ÿฟใ—ใพใ™ใ‹?**ย A: ใƒขใƒผใƒ‰ใฏ่ชฟๆ•ดใ‚’้€šใ˜ใฆใƒ„ใƒผใƒซใฎไฝฟ็”จใ‚’ๆœ€้ฉๅŒ–ใ—ใพใ™ใ€‚ - -- **ใƒˆใƒผใ‚ฏใƒณๅŠน็Ž‡**: 30๏ฝž50%ใฎใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆๅ‰Šๆธ› -- **ใ‚ชใƒผใ‚ฑใ‚นใƒˆใƒฌใƒผใ‚ทใƒงใƒณ**๏ผšไธฆๅˆ—ๅ‡ฆ็† -- **ใ‚ฟใ‚นใ‚ฏ็ฎก็†**๏ผšไฝ“็ณป็š„ใช่จˆ็”ปใ‚’้€šใ˜ใฆๆ‰‹ๆˆปใ‚Šใ‚’้˜ฒๆญข - -**Q: ใƒขใƒผใƒ‰ใฏ้€ฃๆบใ—ใฆๅ‹•ไฝœใ—ใพใ™ใ‹?**ย A: ใฏใ„ใ€ใƒขใƒผใƒ‰ใฏไบ’ใ„ใซ่ฃœๅฎŒใ—ๅˆใ†ใ‚ˆใ†ใซ่จญ่จˆใ•ใ‚Œใฆใ„ใพใ™ใ€‚ - -- **ใ‚ฟใ‚นใ‚ฏ็ฎก็†ใฏ**ไป–ใฎใƒขใƒผใƒ‰ใ‚’่ชฟๆ•ดใ—ใพใ™ -- **ใƒˆใƒผใ‚ฏใƒณๅŠน็Ž‡ใฏ**ใ‚ใ‚‰ใ‚†ใ‚‹ใƒขใƒผใƒ‰ใฎๅ‡บๅŠ›ใ‚’ๅœง็ธฎใ™ใ‚‹ -- **ใ‚คใƒณใƒˆใƒญใ‚นใƒšใ‚ฏใ‚ทใƒงใƒณใฏ**ใ‚ใ‚‰ใ‚†ใ‚‹ใƒฏใƒผใ‚ฏใƒ•ใƒญใƒผใซ้€ๆ˜Žๆ€งใ‚’ใ‚‚ใŸใ‚‰ใ—ใพใ™ - ---- - -## ใพใจใ‚ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#summary) - -SuperClaude ใฎ 5 ใคใฎ่กŒๅ‹•ใƒขใƒผใƒ‰ใฏใ€ใƒฆใƒผใ‚ถใƒผใฎใƒ‹ใƒผใ‚บใซ่‡ชๅ‹•็š„ใซ้ฉๅˆใ™ใ‚‹**ใ‚คใƒณใƒ†ใƒชใ‚ธใ‚งใƒณใƒˆใช้ฉๅฟœใ‚ทใ‚นใƒ†ใƒ ใ‚’ไฝœๆˆใ—ใพใ™ใ€‚** - -- **๐Ÿง  ใƒ–ใƒฌใ‚คใƒณใ‚นใƒˆใƒผใƒŸใƒณใ‚ฐ**๏ผšๆผ ็„ถใจใ—ใŸใ‚ขใ‚คใƒ‡ใ‚ขใ‚’ๆ˜Ž็ขบใช่ฆไปถใซๅค‰ๆ›ใ™ใ‚‹ -- **๐Ÿ” ใ‚คใƒณใƒˆใƒญใ‚นใƒšใ‚ฏใ‚ทใƒงใƒณ**๏ผšๅญฆ็ฟ’ใจใƒ‡ใƒใƒƒใ‚ฐใฎใŸใ‚ใฎ้€้Ž็š„ใชๆŽจ่ซ–ใ‚’ๆไพ›ใ—ใพใ™ -- **๐Ÿ“‹ ใ‚ฟใ‚นใ‚ฏ็ฎก็†**๏ผš่ค‡้›‘ใช่ค‡ๆ•ฐใ‚นใƒ†ใƒƒใƒ—ใฎๆ“ไฝœใ‚’่ชฟๆ•ดใ—ใพใ™ -- **๐ŸŽฏ ใ‚ชใƒผใ‚ฑใ‚นใƒˆใƒฌใƒผใ‚ทใƒงใƒณ**: ใƒ„ใƒผใƒซใฎ้ธๆŠžใจไธฆๅˆ—ๅฎŸ่กŒใ‚’ๆœ€้ฉๅŒ–ใ—ใพใ™ -- **โšก ใƒˆใƒผใ‚ฏใƒณๅŠน็Ž‡**: ๆ˜Ž็žญใ•ใ‚’ไฟใกใชใŒใ‚‰ใ‚ณใƒŸใƒฅใƒ‹ใ‚ฑใƒผใ‚ทใƒงใƒณใ‚’ๅœง็ธฎใ™ใ‚‹ -- **๐ŸŽจ ๆจ™ๆบ–**: ๅ˜็ด”ใชใ‚ฟใ‚นใ‚ฏใซๅฏพใ—ใฆใƒ—ใƒญใƒ•ใ‚งใƒƒใ‚ทใƒงใƒŠใƒซใชๅŸบๆบ–ใ‚’็ถญๆŒใ—ใพใ™ - -**้‡่ฆใชๆดžๅฏŸ**๏ผšใƒขใƒผใƒ‰ใซใคใ„ใฆ่€ƒใˆใ‚‹ๅฟ…่ฆใฏใ‚ใ‚Šใพใ›ใ‚“ใ€‚ใƒขใƒผใƒ‰ใฏ้€้Ž็š„ใซๅ‹•ไฝœใ—ใ€้–‹็™บใ‚จใ‚ฏใ‚นใƒšใƒชใ‚จใƒณใ‚นใ‚’ๅ‘ไธŠใ•ใ›ใพใ™ใ€‚้”ๆˆใ—ใŸใ„ใ“ใจใ‚’่ชฌๆ˜Žใ™ใ‚‹ใ ใ‘ใงใ€SuperClaudeใฏใƒ‹ใƒผใ‚บใซๅˆใ‚ใ›ใฆใ‚ขใƒ—ใƒญใƒผใƒใ‚’่‡ชๅ‹•็š„ใซ่ชฟๆ•ดใ—ใพใ™ใ€‚ - ---- - -## ้–ข้€ฃใ‚ฌใ‚คใƒ‰ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#related-guides) - -**ๅญฆ็ฟ’ใฎ้€ฒๆ—:** - -**๐ŸŒฑ ใ‚จใƒƒใ‚ปใƒณใ‚ทใƒฃใƒซ๏ผˆ็ฌฌ1้€ฑ๏ผ‰** - -- [ใ‚ฏใ‚คใƒƒใ‚ฏใ‚นใ‚ฟใƒผใƒˆใ‚ฌใ‚คใƒ‰](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Getting-Started/quick-start.md)- ใƒขใƒผใƒ‰ใฎๆœ‰ๅŠนๅŒ–ไพ‹ -- [ใ‚ณใƒžใƒณใƒ‰ใƒชใƒ•ใ‚กใƒฌใƒณใ‚น](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md)- ใ‚ณใƒžใƒณใƒ‰ใฏ่‡ชๅ‹•็š„ใซใƒขใƒผใƒ‰ใ‚’ใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ–ๅŒ–ใ—ใพใ™ -- [ใ‚คใƒณใ‚นใƒˆใƒผใƒซใ‚ฌใ‚คใƒ‰](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Getting-Started/installation.md)- ๅ‹•ไฝœใƒขใƒผใƒ‰ใฎ่จญๅฎš - -**๐ŸŒฟไธญ็ดš๏ผˆ็ฌฌ2๏ฝž3้€ฑ๏ผ‰** - -- [ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใ‚ฌใ‚คใƒ‰](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md)- ใƒขใƒผใƒ‰ใจใ‚นใƒšใ‚ทใƒฃใƒชใ‚นใƒˆใฎ้€ฃๆบๆ–นๆณ• -- [ใƒ•ใƒฉใ‚ฐใ‚ฌใ‚คใƒ‰](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md)- ๆ‰‹ๅ‹•ใƒขใƒผใƒ‰ใฎๅˆถๅพกใจๆœ€้ฉๅŒ– -- [ไพ‹ๆ–‡้›†](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Reference/examples-cookbook.md)- ใƒขใƒผใƒ‰ใƒ‘ใ‚ฟใƒผใƒณใฎๅฎŸ่ทต - -**๐ŸŒฒ ไธŠ็ดš๏ผˆ2ใƒถๆœˆ็›ฎไปฅ้™๏ผ‰** - -- [MCP ใ‚ตใƒผใƒใƒผ](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/mcp-servers.md)- ๆ‹กๅผตๆฉŸ่ƒฝใ‚’ๅ‚™ใˆใŸใƒขใƒผใƒ‰็ตฑๅˆ -- [ใ‚ปใƒƒใ‚ทใƒงใƒณ็ฎก็†](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md)- ใ‚ฟใ‚นใ‚ฏ็ฎก็†ใƒขใƒผใƒ‰ใฎใƒฏใƒผใ‚ฏใƒ•ใƒญใƒผ -- [ใฏใ˜ใ‚ใซ](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Getting-Started/quick-start.md)- ใƒขใƒผใƒ‰ใฎไฝฟ็”จใƒ‘ใ‚ฟใƒผใƒณ - -**๐Ÿ”ง ใ‚จใ‚ญใ‚นใƒ‘ใƒผใƒˆ** - -- [ๆŠ€่ก“ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃ](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Developer-Guide/technical-architecture.md)- ใƒขใƒผใƒ‰ๅฎŸ่ฃ…ใฎ่ฉณ็ดฐ -- [ใ‚ณใƒผใƒ‰ใฎ่ฒข็Œฎ](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Developer-Guide/contributing-code.md)- ใƒขใƒผใƒ‰ใฎๆฉŸ่ƒฝใ‚’ๆ‹กๅผตใ™ใ‚‹ - -**ใƒขใƒผใƒ‰ๅ›บๆœ‰ใฎใ‚ฌใ‚คใƒ‰:** - -- **ใƒ–ใƒฌใ‚คใƒณใ‚นใƒˆใƒผใƒŸใƒณใ‚ฐ**๏ผš[่ฆไปถ็™บ่ฆ‹ใƒ‘ใ‚ฟใƒผใƒณ](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Reference/examples-cookbook.md#requirements) -- **ใ‚ฟใ‚นใ‚ฏ็ฎก็†**๏ผš[ใ‚ปใƒƒใ‚ทใƒงใƒณ็ฎก็†ใ‚ฌใ‚คใƒ‰](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md) -- **ใ‚ชใƒผใ‚ฑใ‚นใƒˆใƒฌใƒผใ‚ทใƒงใƒณ**:ย [MCP ใ‚ตใƒผใƒใƒผ ใ‚ฌใ‚คใƒ‰](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/mcp-servers.md) -- **ใƒˆใƒผใ‚ฏใƒณๅŠน็Ž‡**๏ผš[ใ‚ณใƒžใƒณใƒ‰ใฎๅŸบ็คŽ](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#token-efficiency) \ No newline at end of file diff --git a/docs/User-Guide-jp/session-management.md b/docs/User-Guide-jp/session-management.md deleted file mode 100644 index e9c9fe6..0000000 --- a/docs/User-Guide-jp/session-management.md +++ /dev/null @@ -1,414 +0,0 @@ -# ใ‚ปใƒƒใ‚ทใƒงใƒณ็ฎก็†ใ‚ฌใ‚คใƒ‰ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#session-management-guide) - -SuperClaude ใฏใ€Serena MCP ใ‚ตใƒผใƒใƒผใ‚’้€šใ˜ใฆๆฐธ็ถš็š„ใชใ‚ปใƒƒใ‚ทใƒงใƒณ็ฎก็†ใ‚’ๆไพ›ใ—ใ€Claude Code ใฎไผš่ฉฑๅ…จไฝ“ใซใ‚ใŸใ‚‹็œŸใฎใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆไฟๅญ˜ใจ้•ทๆœŸ็š„ใชใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆ็ถ™็ถšๆ€งใ‚’ๅฎŸ็พใ—ใพใ™ใ€‚ - -## ๆฐธ็ถšใƒกใƒขใƒชใ‚’ไฝฟ็”จใ—ใŸใ‚ณใ‚ขใ‚ปใƒƒใ‚ทใƒงใƒณใ‚ณใƒžใƒณใƒ‰ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#core-session-commands-with-persistent-memory) - -### `/sc:load`- ๆฐธ็ถšใƒกใƒขใƒชใซใ‚ˆใ‚‹ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆใฎ่ชญใฟ่พผใฟ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#scload---context-loading-with-persistent-memory) - -**็›ฎ็š„**: ไปฅๅ‰ใฎใ‚ปใƒƒใ‚ทใƒงใƒณใ‹ใ‚‰ใฎใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆใจๆฐธ็ถšใƒกใƒขใƒชใ‚’ไฝฟ็”จใ—ใฆใ‚ปใƒƒใ‚ทใƒงใƒณใ‚’ๅˆๆœŸๅŒ–ใ—ใพใ™ใ€‚MCP -**็ตฑๅˆ**: Serena MCP ใ‚’ใƒˆใƒชใ‚ฌใƒผใ—ใฆใ€ไฟๅญ˜ใ•ใ‚ŒใŸใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใƒกใƒขใƒชใ‚’่ชญใฟๅ–ใ‚Šใพใ™ใ€‚ -**ๆง‹ๆ–‡**:`/sc:load [project_path]` - -**ไฝ•ใŒ่ตทใ“ใ‚‹ใฎใงใ™ใ‹**๏ผš - -- Serena MCPใฏไปฅๅ‰ใฎใ‚ปใƒƒใ‚ทใƒงใƒณใ‹ใ‚‰ๆฐธ็ถšใƒกใƒขใƒชใƒ•ใ‚กใ‚คใƒซใ‚’่ชญใฟๅ–ใ‚Šใพใ™ -- ใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใฎใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆใฏไฟๅญ˜ใ•ใ‚ŒใŸใƒกใƒขใƒชใ‹ใ‚‰ๅพฉๅ…ƒใ•ใ‚Œใพใ™ -- ้ŽๅŽปใฎๆฑบๅฎšใ€ใƒ‘ใ‚ฟใƒผใƒณใ€้€ฒๆ—็ŠถๆณใŒ่ชญใฟ่พผใพใ‚Œใพใ™ -- ใ‚ปใƒƒใ‚ทใƒงใƒณ็Šถๆ…‹ใฏๅฑฅๆญดใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆใงๅˆๆœŸๅŒ–ใ•ใ‚Œใพใ™ - -**ใƒฆใƒผใ‚นใ‚ฑใƒผใ‚น**: - -```shell -# Load existing project context from persistent memory -/sc:load src/ - -# Resume specific project work with full history -/sc:load "authentication-system" - -# Initialize with codebase analysis and previous insights -/sc:load . --analyze -``` - -### `/sc:save`- ใƒกใƒขใƒชใธใฎใ‚ปใƒƒใ‚ทใƒงใƒณใฎๆฐธ็ถšๆ€ง - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#scsave---session-persistence-to-memory) - -**็›ฎ็š„**: ็พๅœจใฎใ‚ปใƒƒใ‚ทใƒงใƒณ็Šถๆ…‹ใจๆฑบๅฎšใ‚’ๆฐธ็ถšใƒกใƒขใƒช -**MCP ใซไฟๅญ˜ใ—ใพใ™ใ€‚็ตฑๅˆ**: Serena MCP ใ‚’ใƒˆใƒชใ‚ฌใƒผใ—ใฆใƒกใƒขใƒช ใƒ•ใ‚กใ‚คใƒซใซๆ›ธใ่พผใฟใพใ™ใ€‚ -**ๆง‹ๆ–‡**:`/sc:save "session_description"` - -**ไฝ•ใŒ่ตทใ“ใ‚‹ใฎใงใ™ใ‹**๏ผš - -- ็พๅœจใฎ็Šถๆณใจๆฑบๅฎšใฏใ‚ปใƒฌใƒŠใฎใƒกใƒขใƒชใซๆ›ธใ่พผใพใ‚Œใพใ™ -- ใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใฎ็Šถๆ…‹ใจ้€ฒๆ—ใฏไผš่ฉฑใ‚’้€šใ˜ใฆ็ถญๆŒใ•ใ‚Œใพใ™ -- ้‡่ฆใชๆดžๅฏŸใจใƒ‘ใ‚ฟใƒผใƒณใฏๅฐ†ๆฅใฎใ‚ปใƒƒใ‚ทใƒงใƒณใฎใŸใ‚ใซไฟๅญ˜ใ•ใ‚Œใพใ™ -- ใ‚ปใƒƒใ‚ทใƒงใƒณๆฆ‚่ฆใฏใ‚ฟใ‚คใƒ ใ‚นใ‚ฟใƒณใƒ—ไป˜ใใงไฝœๆˆใ•ใ‚Œใ€ๆคœ็ดขใซๅˆฉ็”จใงใใพใ™ - -**ใƒฆใƒผใ‚นใ‚ฑใƒผใ‚น**: - -```shell -# Save completed feature work for future reference -/sc:save "user authentication implemented with JWT" - -# Checkpoint during complex work -/sc:save "API design phase complete, ready for implementation" - -# Store architectural decisions permanently -/sc:save "microservices architecture decided, service boundaries defined" -``` - -### `/sc:reflect`- ใƒกใƒขใƒชใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆใซใ‚ˆใ‚‹้€ฒๆ—็Šถๆณใฎ่ฉ•ไพก - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#screflect---progress-assessment-with-memory-context) - -**็›ฎ็š„**: ไฟๅญ˜ใ•ใ‚ŒใŸใƒกใƒขใƒชใซๅฏพใ—ใฆ็พๅœจใฎ้€ฒ่กŒ็Šถๆณใ‚’ๅˆ†ๆžใ—ใ€ใ‚ปใƒƒใ‚ทใƒงใƒณใฎๅฎŒๅ…จๆ€งใ‚’ๆคœ่จผใ™ใ‚‹ -**MCP ็ตฑๅˆ**: Serena MCP ใ‚’ไฝฟ็”จใ—ใฆใ€ไฟๅญ˜ใ•ใ‚ŒใŸใƒกใƒขใƒชใจ็พๅœจใฎ็Šถๆ…‹ใ‚’ๆฏ”่ผƒใ™ใ‚‹ -**ๆง‹ๆ–‡**:`/sc:reflect [--scope project|session]` - -**ไฝ•ใŒ่ตทใ“ใ‚‹ใฎใงใ™ใ‹**๏ผš - -- ใ‚ปใƒฌใƒŠMCPใฏ้ŽๅŽปใฎ่จ˜ๆ†ถใจ็พๅœจใฎๆ–‡่„ˆใ‚’่ชญใฟๅ–ใ‚Šใพใ™ -- ้€ฒๆ—ใฏไฟๅญ˜ใ•ใ‚ŒใŸ็›ฎๆจ™ใจใƒžใ‚คใƒซใ‚นใƒˆใƒผใƒณใซๅฏพใ—ใฆ่ฉ•ไพกใ•ใ‚Œใพใ™ -- ๆญดๅฒ็š„่ƒŒๆ™ฏใซๅŸบใฅใ„ใฆใ‚ฎใƒฃใƒƒใƒ—ใจๆฌกใฎใ‚นใƒ†ใƒƒใƒ—ใŒ็‰นๅฎšใ•ใ‚Œใ‚‹ -- ใ‚ปใƒƒใ‚ทใƒงใƒณใฎๅฎŒๅ…จๆ€งใฏใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใƒกใƒขใƒชใซๅฏพใ—ใฆๆคœ่จผใ•ใ‚Œใพใ™ - -**ใƒฆใƒผใ‚นใ‚ฑใƒผใ‚น**: - -```shell -# Assess project progress against stored milestones -/sc:reflect --scope project - -# Validate current session completeness -/sc:reflect - -# Check if ready to move to next phase based on memory -/sc:reflect --scope session -``` - -## ๆฐธ็ถšใƒกใƒขใƒชใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#persistent-memory-architecture) - -### Serena MCP ใŒ็œŸใฎๆฐธ็ถšๆ€งใ‚’ๅฎŸ็พใ™ใ‚‹ๆ–นๆณ• - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#how-serena-mcp-enables-true-persistence) - -**ใƒกใƒขใƒชใ‚นใƒˆใƒฌใƒผใ‚ธ**: - -- ๆง‹้€ ๅŒ–ใƒกใƒขใƒชใƒ•ใ‚กใ‚คใƒซใจใ—ใฆไฟๅญ˜ใ•ใ‚Œใ‚‹ใ‚ปใƒƒใ‚ทใƒงใƒณใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆ -- ใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใฎๆฑบๅฎšใจใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃใƒ‘ใ‚ฟใƒผใƒณใฏๆฐธไน…ใซไฟๅญ˜ใ•ใ‚Œใพใ™ -- ใ‚ณใƒผใƒ‰ๅˆ†โ€‹โ€‹ๆžใฎ็ตๆžœใจๆดžๅฏŸใฏไผš่ฉฑใ‚’้€šใ˜ใฆไฟๆŒใ•ใ‚Œใพใ™ -- ้€ฒๆ—็Šถๆณใฎ่ฟฝ่ทกใจใƒžใ‚คใƒซใ‚นใƒˆใƒผใƒณใฎใƒ‡ใƒผใ‚ฟใฏ้•ทๆœŸใซใ‚ใŸใฃใฆ็ถญๆŒใ•ใ‚Œใพใ™ - -**ใ‚ปใƒƒใ‚ทใƒงใƒณ้–“ใฎ็ถ™็ถšๆ€ง**: - -- ไปฅๅ‰ใฎใ‚ปใƒƒใ‚ทใƒงใƒณใฎใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆใŒๆ–ฐใ—ใ„ไผš่ฉฑใง่‡ชๅ‹•็š„ใซๅˆฉ็”จๅฏ่ƒฝ -- ๆฑบๅฎšใจๆ นๆ‹ ใฏไผš่ฉฑใ‚’้€šใ˜ใฆไฟๅญ˜ใ•ใ‚Œใ€ใ‚ขใ‚ฏใ‚ปใ‚นๅฏ่ƒฝ -- ้ŽๅŽปใฎใƒ‘ใ‚ฟใƒผใƒณใจ่งฃๆฑบ็ญ–ใ‹ใ‚‰ใฎๅญฆ็ฟ’ใ‚’็ถญๆŒ -- ไธ€่ฒซใ—ใŸใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆ็†่งฃใŒๆฐธไน…ใซ็ถญๆŒใ•ใ‚Œใ‚‹ - -**ใƒกใƒขใƒชใ‚ฟใ‚คใƒ—**: - -- **ใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใฎๆ€ใ„ๅ‡บ**๏ผš้•ทๆœŸใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใฎๆ–‡่„ˆใจใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃ -- **ใ‚ปใƒƒใ‚ทใƒงใƒณใฎ่จ˜ๆ†ถ**๏ผšๅ…ทไฝ“็š„ใชไผš่ฉฑใฎ็ตๆžœใจๆฑบๅฎš -- **ใƒ‘ใ‚ฟใƒผใƒณใƒกใƒขใƒช**๏ผšๅ†ๅˆฉ็”จๅฏ่ƒฝใชใ‚ฝใƒชใƒฅใƒผใ‚ทใƒงใƒณใจใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃใƒ‘ใ‚ฟใƒผใƒณ -- **้€ฒๆ—ใฎๆ€ใ„ๅ‡บ**๏ผšใƒžใ‚คใƒซใ‚นใƒˆใƒผใƒณใฎ่ฟฝ่ทกใจๅฎŒไบ†ใ‚นใƒ†ใƒผใ‚ฟใ‚น - -## ๆฐธ็ถšๆ€งใ‚’ๅ‚™ใˆใŸใ‚ปใƒƒใ‚ทใƒงใƒณใƒฉใ‚คใƒ•ใ‚ตใ‚คใ‚ฏใƒซใƒ‘ใ‚ฟใƒผใƒณ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#session-lifecycle-patterns-with-persistence) - -### ๆ–ฐใ—ใ„ใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใฎๅˆๆœŸๅŒ– - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#new-project-initialization) - -```shell -# 1. Start fresh project -/sc:brainstorm "e-commerce platform requirements" - -# 2. Save initial decisions to persistent memory -/sc:save "project scope and requirements defined" - -# 3. Begin implementation planning -/sc:workflow "user authentication system" - -# 4. Save architectural decisions permanently -/sc:save "auth architecture: JWT + refresh tokens + rate limiting" -``` - -### ๆ—ขๅญ˜ใฎไฝœๆฅญใฎๅ†้–‹๏ผˆใ‚ฏใƒญใ‚นไผš่ฉฑ๏ผ‰ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#resuming-existing-work-cross-conversation) - -```shell -# 1. Load previous context from persistent memory -/sc:load "e-commerce-project" - -# 2. Assess current state against stored progress -/sc:reflect --scope project - -# 3. Continue with next phase using stored context -/sc:implement "payment processing integration" - -# 4. Save progress checkpoint to memory -/sc:save "payment system integrated with Stripe API" -``` - -### ้•ทๆœŸใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆ็ฎก็† - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#long-term-project-management) - -```shell -# Weekly checkpoint pattern with persistence -/sc:load project-name -/sc:reflect --scope project -# ... work on features ... -/sc:save "week N progress: features X, Y, Z completed" - -# Phase completion pattern with memory -/sc:reflect --scope project -/sc:save "Phase 1 complete: core authentication and user management" -/sc:workflow "Phase 2: payment and order processing" -``` - -## ใ‚ฏใƒญใ‚นไผš่ฉฑใฎ็ถ™็ถšๆ€ง - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#cross-conversation-continuity) - -### ็ฒ˜ใ‚Šๅผทใๆ–ฐใ—ใ„ไผš่ฉฑใ‚’ๅง‹ใ‚ใ‚‹ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#starting-new-conversations-with-persistence) - -ๆ–ฐใ—ใ„ Claude Code ไผš่ฉฑใ‚’้–‹ๅง‹ใ™ใ‚‹ใจใ€ๆฐธ็ถšใƒกใƒขใƒช ใ‚ทใ‚นใƒ†ใƒ ใซใ‚ˆใฃใฆๆฌกใฎใ“ใจใŒๅฏ่ƒฝใซใชใ‚Šใพใ™ใ€‚ - -1. **่‡ชๅ‹•ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆๅพฉๅ…ƒ** - - ```shell - /sc:load project-name - # Automatically restores all previous context, decisions, and progress - ``` - -2. **้€ฒๆญฉใฎ็ถ™็ถš** - - - ไปฅๅ‰ใฎใ‚ปใƒƒใ‚ทใƒงใƒณใฎๆฑบๅฎšใฏใ™ใใซๅˆฉ็”จๅฏ่ƒฝ - - ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃใƒ‘ใ‚ฟใƒผใƒณใจใ‚ณใƒผใƒ‰ใฎๆดžๅฏŸใฏไฟๅญ˜ใ•ใ‚Œใพใ™ - - ใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใฎๅฑฅๆญดใจๆ นๆ‹ ใŒ็ถญๆŒใ•ใ‚Œใ‚‹ -3. **ใ‚คใƒณใƒ†ใƒชใ‚ธใ‚งใƒณใƒˆใชใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆๆง‹็ฏ‰** - - - Serena MCPใฏใ€็พๅœจใฎไฝœๆฅญใซๅŸบใฅใ„ใฆ้–ข้€ฃใ™ใ‚‹ใƒกใƒขใƒชใ‚’ๆไพ›ใ—ใพใ™ - - ้ŽๅŽปใฎใ‚ฝใƒชใƒฅใƒผใ‚ทใƒงใƒณใจใƒ‘ใ‚ฟใƒผใƒณใŒๆ–ฐใ—ใ„ๅฎŸ่ฃ…ใซๅฝฑ้Ÿฟใ‚’ไธŽใˆใ‚‹ - - ใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใฎ้€ฒๆ—็ŠถๆณใŒ่ฟฝ่ทกใ•ใ‚Œใ€็†่งฃใ•ใ‚Œใ‚‹ - -### ใƒกใƒขใƒชๆœ€้ฉๅŒ– - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#memory-optimization) - -**ๆœ‰ๅŠนใชใƒกใƒขใƒชไฝฟ็”จ้‡**: - -- ่ชฌๆ˜Ž็š„ใ‹ใคๆคœ็ดขๅฏ่ƒฝใชใƒกใƒขใƒชๅใ‚’ไฝฟ็”จใ™ใ‚‹ -- ใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใฎใƒ•ใ‚งใƒผใ‚บใจใ‚ฟใ‚คใƒ ใ‚นใ‚ฟใƒณใƒ—ใฎใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆใ‚’ๅซใ‚ใ‚‹ -- ็‰นๅฎšใฎๆฉŸ่ƒฝใ‚„ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃไธŠใฎๆฑบๅฎšใ‚’ๅ‚็…งใ™ใ‚‹ -- ๅฐ†ๆฅใฎๆคœ็ดขใ‚’็›ดๆ„Ÿ็š„ใซใ™ใ‚‹ - -**่จ˜ๆ†ถๅ†…ๅฎนๆˆฆ็•ฅ**๏ผš - -- ็ตๆžœใ ใ‘ใงใชใใ€ๆ„ๆ€ๆฑบๅฎšใจๆ นๆ‹ ใ‚‚ไฟๅญ˜ใ™ใ‚‹ -- ๆคœ่จŽใ—ใŸไปฃๆ›ฟใ‚ขใƒ—ใƒญใƒผใƒใ‚’ๅซใ‚ใ‚‹ -- ็ตฑๅˆใƒ‘ใ‚ฟใƒผใƒณใจไพๅญ˜้–ขไฟ‚ใ‚’ๆ–‡ๆ›ธๅŒ–ใ™ใ‚‹ -- ๅญฆ็ฟ’ๅ†…ๅฎนใจๆดžๅฏŸใ‚’ๅฐ†ๆฅใฎๅ‚่€ƒใฎใŸใ‚ใซไฟๅญ˜ใ™ใ‚‹ - -**ใƒกใƒขใƒชใƒฉใ‚คใƒ•ใ‚ตใ‚คใ‚ฏใƒซ็ฎก็†**: - -- ๅคใใชใฃใŸใƒกใƒขใƒชใฎๅฎšๆœŸ็š„ใชใ‚ฏใƒชใƒผใƒณใ‚ขใƒƒใƒ— -- ้–ข้€ฃใ™ใ‚‹ใ‚ปใƒƒใ‚ทใƒงใƒณ่จ˜ๆ†ถใฎ็ตฑๅˆ -- ๅฎŒไบ†ใ—ใŸใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใƒ•ใ‚งใƒผใ‚บใฎใ‚ขใƒผใ‚ซใ‚คใƒ– -- ๆ™‚ไปฃ้…ใ‚Œใฎใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃไธŠใฎๆฑบๅฎšใฎๅ‰Šๆธ› - -## ๆฐธ็ถšใ‚ปใƒƒใ‚ทใƒงใƒณใฎใƒ™ใ‚นใƒˆใƒ—ใƒฉใ‚ฏใƒ†ใ‚ฃใ‚น - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#best-practices-for-persistent-sessions) - -### ใ‚ปใƒƒใ‚ทใƒงใƒณ้–‹ๅง‹ใƒ—ใƒญใƒˆใ‚ณใƒซ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#session-start-protocol) - -1. `/sc:load`ๆ—ขๅญ˜ใฎใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใฎๅ ดๅˆใฏๅธธใซ -2. `/sc:reflect`่จ˜ๆ†ถใ‹ใ‚‰็พๅœจใฎ็Šถๆ…‹ใ‚’็†่งฃใ™ใ‚‹ใŸใ‚ใซไฝฟ็”จใ™ใ‚‹ -3. ๆฐธ็ถš็š„ใชใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆใจไฟๅญ˜ใ•ใ‚ŒใŸใƒ‘ใ‚ฟใƒผใƒณใซๅŸบใฅใ„ใฆไฝœๆฅญใ‚’่จˆ็”ปใ™ใ‚‹ -4. ้ŽๅŽปใฎๆฑบๅฎšใจใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃใฎ้ธๆŠžใซๅŸบใฅใ„ใฆๆง‹็ฏ‰ใ™ใ‚‹ - -### ใ‚ปใƒƒใ‚ทใƒงใƒณ็ต‚ไบ†ใƒ—ใƒญใƒˆใ‚ณใƒซ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#session-end-protocol) - -1. `/sc:reflect`ไฟๅญ˜ใ•ใ‚ŒใŸ็›ฎๆจ™ใซๅฏพใ™ใ‚‹ๅฎŒๅ…จๆ€งใ‚’่ฉ•ไพกใ™ใ‚‹ใŸใ‚ใซไฝฟ็”จใ—ใพใ™ -2. ้‡่ฆใชๆฑบๅฎšใ‚’`/sc:save`ๅฐ†ๆฅใฎใ‚ปใƒƒใ‚ทใƒงใƒณใฎใŸใ‚ใซไฟๅญ˜ใ™ใ‚‹ -3. ๆฌกใฎใ‚นใƒ†ใƒƒใƒ—ใจๆœช่งฃๆฑบใฎ่ณชๅ•ใ‚’่จ˜ๆ†ถใซ่จ˜้Œฒใ™ใ‚‹ -4. ๅฐ†ๆฅใฎใ‚ทใƒผใƒ ใƒฌใ‚นใช็ถ™็ถšใฎใŸใ‚ใซใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆใ‚’ไฟๅญ˜ใ™ใ‚‹ - -### ่จ˜ๆ†ถๅ“่ณชใฎ็ถญๆŒ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#memory-quality-maintenance) - -- ็ฐกๅ˜ใซๆ€ใ„ๅ‡บใ›ใ‚‹ใ‚ˆใ†ใซใ€ๅˆ†ใ‹ใ‚Šใ‚„ใ™ใ่ชฌๆ˜Ž็š„ใชใƒกใƒขใƒชๅใ‚’ไฝฟ็”จใ™ใ‚‹ -- ๆฑบๅฎšไบ‹้ …ใจไปฃๆ›ฟใ‚ขใƒ—ใƒญใƒผใƒใซ้–ขใ™ใ‚‹่ƒŒๆ™ฏๆƒ…ๅ ฑใ‚’ๅซใ‚ใ‚‹ -- ็‰นๅฎšใฎใ‚ณใƒผใƒ‰ใฎๅ ดๆ‰€ใจใƒ‘ใ‚ฟใƒผใƒณใ‚’ๅ‚็…งใ™ใ‚‹ -- ใ‚ปใƒƒใ‚ทใƒงใƒณ้–“ใงใƒกใƒขใƒชๆง‹้€ ใฎไธ€่ฒซๆ€งใ‚’็ถญๆŒใ™ใ‚‹ - -## ไป–ใฎSuperClaudeๆฉŸ่ƒฝใจใฎ็ตฑๅˆ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#integration-with-other-superclaude-features) - -### MCP ใ‚ตใƒผใƒใƒผ่ชฟๆ•ด - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#mcp-server-coordination) - -- **Serena MCP**ย : ๆฐธ็ถšใƒกใƒขใƒชใ‚คใƒณใƒ•ใƒฉใ‚นใƒˆใƒฉใ‚ฏใƒใƒฃใ‚’ๆไพ›ใ—ใพใ™ -- **ใ‚ทใƒผใ‚ฑใƒณใ‚ทใƒฃใƒซMCP**ย : ไฟๅญ˜ใ•ใ‚ŒใŸใƒกใƒขใƒชใ‚’ไฝฟ็”จใ—ใฆ่ค‡้›‘ใชๅˆ†ๆžใ‚’ๅผทๅŒ–ใ—ใพใ™ -- **Context7 MCP**ย : ไฟๅญ˜ใ•ใ‚ŒใŸใƒ‘ใ‚ฟใƒผใƒณใจใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆๅŒ–ใฎใ‚ขใƒ—ใƒญใƒผใƒใ‚’ๅ‚็…งใ—ใพใ™ -- **Morphllm MCP**ย : ไฟๅญ˜ใ•ใ‚ŒใŸใƒชใƒ•ใ‚กใ‚ฏใ‚ฟใƒชใƒณใ‚ฐใƒ‘ใ‚ฟใƒผใƒณใ‚’ไธ€่ฒซใ—ใฆ้ฉ็”จใ—ใพใ™ - -### ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใจใƒกใƒขใƒชใฎ้€ฃๆบ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#agent-collaboration-with-memory) - -- ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใฏๅผทๅŒ–ใ•ใ‚ŒใŸใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆใฎใŸใ‚ใซๆฐธ็ถš็š„ใชใƒกใƒขใƒชใซใ‚ขใ‚ฏใ‚ปใ‚นใ—ใพใ™ -- ไปฅๅ‰ใฎๅฐ‚้–€ๅฎถใฎๆฑบๅฎšใฏไฟๅญ˜ใ•ใ‚Œใ€ๅ‚็…งใ•ใ‚Œใพใ™ -- ๅ…ฑๆœ‰ใƒกใƒขใƒชใ‚’ไป‹ใ—ใŸใ‚ปใƒƒใ‚ทใƒงใƒณ้–“ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆ่ชฟๆ•ด -- ใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใฎๅฑฅๆญดใซๅŸบใฅใ„ใŸไธ€่ฒซใ—ใŸๅฐ‚้–€ๅฎถใฎๆŽจๅฅจ - -### ๆฐธ็ถšๆ€งใ‚’ๅ‚™ใˆใŸใ‚ณใƒžใƒณใƒ‰็ตฑๅˆ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#command-integration-with-persistence) - -- ใ™ในใฆใฎ`/sc:`ใ‚ณใƒžใƒณใƒ‰ใฏๆฐธ็ถš็š„ใชใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆใ‚’ๅ‚็…งใ—ใ€ใใฎใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆใซๅŸบใฅใ„ใฆๆง‹็ฏ‰ใงใใพใ™ใ€‚ -- ไปฅๅ‰ใฎใ‚ณใƒžใƒณใƒ‰ๅ‡บๅŠ›ใจๆฑบๅฎšใฏใ‚ปใƒƒใ‚ทใƒงใƒณ้–“ใงๅˆฉ็”จๅฏ่ƒฝ -- ใƒฏใƒผใ‚ฏใƒ•ใƒญใƒผใƒ‘ใ‚ฟใƒผใƒณใฏไฟๅญ˜ใ•ใ‚Œใ€ๅ†ๅˆฉ็”จใงใใ‚‹ -- ๅฎŸ่ฃ…ๅฑฅๆญดใฏๅฐ†ๆฅใฎๆŒ‡ๆฎๆฑบๅฎšใ‚’ๅฐŽใ - -## ๆฐธ็ถšใ‚ปใƒƒใ‚ทใƒงใƒณใฎใƒˆใƒฉใƒ–ใƒซใ‚ทใƒฅใƒผใƒ†ใ‚ฃใƒณใ‚ฐ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#troubleshooting-persistent-sessions) - -### ใ‚ˆใใ‚ใ‚‹ๅ•้กŒ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#common-issues) - -**ใƒกใƒขใƒชใŒ่ชญใฟ่พผใพใ‚Œใพใ›ใ‚“**: - -- Serena MCP ใŒๆญฃใ—ใๆง‹ๆˆใ•ใ‚Œใ€ๅฎŸ่กŒใ•ใ‚Œใฆใ„ใ‚‹ใ“ใจใ‚’็ขบ่ชใ—ใพใ™ใ€‚ -- ใƒกใƒขใƒชใƒ•ใ‚กใ‚คใƒซใฎๆจฉ้™ใจใ‚ขใ‚ฏใ‚ปใ‚นๅฏ่ƒฝๆ€งใ‚’็ขบ่ชใ™ใ‚‹ -- ใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใฎๅ‘ฝๅ่ฆๅ‰‡ใฎไธ€่ฒซๆ€งใ‚’็ขบไฟใ™ใ‚‹ -- ใƒกใƒขใƒชใƒ•ใ‚กใ‚คใƒซใฎๆ•ดๅˆๆ€งใจใƒ•ใ‚ฉใƒผใƒžใƒƒใƒˆใ‚’ๆคœ่จผใ™ใ‚‹ - -**ใ‚ปใƒƒใ‚ทใƒงใƒณ้–“ใฎใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆๆๅคฑ**: - -- `/sc:save`ใ‚ปใƒƒใ‚ทใƒงใƒณใ‚’็ต‚ไบ†ใ™ใ‚‹ๅ‰ใซๅฟ…ใšไฝฟ็”จใ—ใฆใใ ใ•ใ„ -- ็ฐกๅ˜ใซๆคœ็ดขใงใใ‚‹ใ‚ˆใ†ใซใ€ใ‚ใ‹ใ‚Šใ‚„ใ™ใ„ใƒกใƒขใƒชๅใ‚’ไฝฟ็”จใ™ใ‚‹ -- ใƒกใƒขใƒชใฎๅฎŒๅ…จๆ€งใ‚’ๅฎšๆœŸ็š„`/sc:reflect`ใซๆคœ่จผใ™ใ‚‹ -- ้‡่ฆใชใƒกใƒขใƒชใƒ•ใ‚กใ‚คใƒซใ‚’ๅฎšๆœŸ็š„ใซใƒใƒƒใ‚ฏใ‚ขใƒƒใƒ—ใ™ใ‚‹ - -**ใƒกใƒขใƒชใฎ็ซถๅˆ**: - -- ใƒใƒผใ‚ธใƒงใƒณ็ฎก็†ใซใฏใ‚ฟใ‚คใƒ ใ‚นใ‚ฟใƒณใƒ—ไป˜ใใฎใƒกใƒขใƒชๅใ‚’ไฝฟ็”จใ™ใ‚‹ -- ๅคใใชใฃใŸ่จ˜ๆ†ถใฎๅฎšๆœŸ็š„ใชใ‚ฏใƒชใƒผใƒณใ‚ขใƒƒใƒ— -- ใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใจใ‚ปใƒƒใ‚ทใƒงใƒณใฎใƒกใƒขใƒชใ‚’ๆ˜Ž็ขบใซๅˆ†้›ข -- ใ‚ปใƒƒใ‚ทใƒงใƒณ้–“ใงไธ€่ฒซใ—ใŸใƒกใƒขใƒชๅ‘ฝๅ่ฆๅ‰‡ - -### ใ‚ฏใ‚คใƒƒใ‚ฏใƒ•ใ‚ฃใƒƒใ‚ฏใ‚น - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#quick-fixes) - -**ใ‚ปใƒƒใ‚ทใƒงใƒณ็Šถๆ…‹ใ‚’ใƒชใ‚ปใƒƒใƒˆ**: - -```shell -/sc:load --fresh # Start without previous context -/sc:reflect # Assess current state -``` - -**ใƒกใƒขใƒชใ‚ฏใƒชใƒผใƒณใ‚ขใƒƒใƒ—**: - -```shell -/sc:reflect --cleanup # Remove obsolete memories -/sc:save --consolidate # Merge related memories -``` - -**ใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆๅ›žๅพฉ**: - -```shell -/sc:load --recent # Load most recent memories -/sc:reflect --repair # Identify and fix context gaps -``` - -## ้ซ˜ๅบฆใชๆฐธ็ถšใ‚ปใƒƒใ‚ทใƒงใƒณใƒ‘ใ‚ฟใƒผใƒณ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#advanced-persistent-session-patterns) - -### ่ค‡ๆ•ฐใƒ•ใ‚งใƒผใ‚บใฎใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#multi-phase-projects) - -- ๆ•ด็†ใฎใŸใ‚ใซใƒ•ใ‚งใƒผใ‚บๅ›บๆœ‰ใฎใƒกใƒขใƒชๅ‘ฝๅใ‚’ไฝฟ็”จใ™ใ‚‹ -- ใƒ•ใ‚งใƒผใ‚บๅ…จไฝ“ใงใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃไธŠใฎๆฑบๅฎšใฎ็ถ™็ถšๆ€งใ‚’็ถญๆŒใ™ใ‚‹ -- ๆฐธ็ถšใƒกใƒขใƒชใซใ‚ˆใ‚‹ใ‚ฏใƒญใ‚นใƒ•ใ‚งใƒผใ‚บไพๅญ˜้–ขไฟ‚ใฎ่ฟฝ่ทก -- ๆญดๅฒ็š„่ƒŒๆ™ฏใ‚’่€ƒๆ…ฎใ—ใŸๆผธ้€ฒ็š„ใช่ค‡้›‘ๆ€ง็ฎก็† - -### ใƒใƒผใƒ ใ‚ณใƒฉใƒœใƒฌใƒผใ‚ทใƒงใƒณ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#team-collaboration) - -- ๅ…ฑๆœ‰ใƒกใƒขใƒชใฎ่ฆๅ‰‡ใจๅ‘ฝๅ่ฆๅ‰‡ -- ใƒใƒผใƒ ใฎใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆใซใŠใ‘ใ‚‹ๆ„ๆ€ๆฑบๅฎšๆ นๆ‹ ใฎไฟๅญ˜ -- ใ™ในใฆใฎใƒใƒผใƒ ใƒกใƒณใƒใƒผใŒใ‚ขใ‚ฏใ‚ปใ‚นใงใใ‚‹็ตฑๅˆใƒ‘ใ‚ฟใƒผใƒณใฎใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆ -- ใƒกใƒขใƒชใ‚’ไป‹ใ—ใŸไธ€่ฒซใ—ใŸใ‚ณใƒผใƒ‰ใ‚นใ‚ฟใ‚คใƒซใจใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃใฎ้ฉ็”จ - -### ้•ทๆœŸใƒกใƒณใƒ†ใƒŠใƒณใ‚น - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#long-term-maintenance) - -- ๅฎŒไบ†ใ—ใŸใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใฎใƒกใƒขใƒชใ‚ขใƒผใ‚ซใ‚คใƒ–ๆˆฆ็•ฅ -- ่“„็ฉใ•ใ‚ŒใŸ่จ˜ๆ†ถใซใ‚ˆใ‚‹ใƒ‘ใ‚ฟใƒผใƒณใƒฉใ‚คใƒ–ใƒฉใƒชใฎ้–‹็™บ -- ๆ™‚้–“ใ‚’ใ‹ใ‘ใฆๆง‹็ฏ‰ใ•ใ‚ŒใŸๅ†ๅˆฉ็”จๅฏ่ƒฝใชใ‚ฝใƒชใƒฅใƒผใ‚ทใƒงใƒณใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆ -- ๆฐธ็ถš็š„ใชใƒกใƒขใƒช่“„็ฉใซใ‚ˆใ‚‹็Ÿฅ่ญ˜ใƒ™ใƒผใ‚นใฎๆง‹็ฏ‰ - -## ๆฐธ็ถšใ‚ปใƒƒใ‚ทใƒงใƒณ็ฎก็†ใฎไธปใชๅˆฉ็‚น - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#key-benefits-of-persistent-session-management) - -### ใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใฎ็ถ™็ถšๆ€ง - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#project-continuity) - -- ่ค‡ๆ•ฐใฎไผš่ฉฑใซใ‚ใŸใ‚‹ใ‚ทใƒผใƒ ใƒฌใ‚นใชไฝœๆฅญ็ถ™็ถš -- Claude Codeใ‚ปใƒƒใ‚ทใƒงใƒณ้–“ใงใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆใŒๅคฑใ‚ใ‚Œใ‚‹ใ“ใจใฏใ‚ใ‚Šใพใ›ใ‚“ -- ไฟๅญ˜ใ•ใ‚ŒใŸใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃไธŠใฎๆฑบๅฎšใจๆŠ€่ก“็š„ๆ นๆ‹  -- ้•ทๆœŸ็š„ใชใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใฎ้€ฒๆ—่ฟฝ่ทก - -### ็”Ÿ็”ฃๆ€งใฎๅ‘ไธŠ - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#enhanced-productivity) - -- ใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใฎใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆใ‚’ๅ†ๅบฆ่ชฌๆ˜Žใ™ใ‚‹ๅฟ…่ฆๆ€งใŒๆธ›ๅฐ‘ -- ่ตทๅ‹•ๆ™‚้–“ใŒ้€Ÿใใ€ไฝœๆฅญใ‚’็ถ™็ถšใงใใ‚‹ -- ้ŽๅŽปใฎๆดžๅฏŸใจใƒ‘ใ‚ฟใƒผใƒณใซๅŸบใฅใ„ใฆ -- ็ดฏ็ฉ็š„ใชใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆ็Ÿฅ่ญ˜ใฎๆˆ้•ท - -### ๅ“่ณชใฎไธ€่ฒซๆ€ง - -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#quality-consistency) - -- ใ‚ปใƒƒใ‚ทใƒงใƒณ้–“ใงไธ€่ฒซใ—ใŸใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃใƒ‘ใ‚ฟใƒผใƒณ -- ใ‚ณใƒผใƒ‰ๅ“่ณชใฎๆฑบๅฎšใจๆจ™ๆบ–ใฎไฟๆŒ -- ๅ†ๅˆฉ็”จๅฏ่ƒฝใชใ‚ฝใƒชใƒฅใƒผใ‚ทใƒงใƒณใจใƒ™ใ‚นใƒˆใƒ—ใƒฉใ‚ฏใƒ†ใ‚ฃใ‚น -- ๆŠ€่ก“็š„่ฒ ๅ‚ตใฎ่ช่ญ˜ใ‚’็ถญๆŒ - ---- - -**้‡่ฆใชใƒใ‚คใƒณใƒˆ**: Serena MCP ใซใ‚ˆใ‚‹ใ‚ปใƒƒใ‚ทใƒงใƒณ็ฎก็†ใซใ‚ˆใ‚Šใ€SuperClaude ใฏๅ˜ไธ€ใฎไผš่ฉฑใฎๆ”ฏๆดใ‹ใ‚‰ๆฐธ็ถš็š„ใชใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆ ใƒ‘ใƒผใƒˆใƒŠใƒผใ‚ทใƒƒใƒ—ใธใจๅค‰ใ‚ใ‚Šใ€ใ™ในใฆใฎ้–‹็™บใƒ•ใ‚งใƒผใ‚บใจ Claude Code ใฎไผš่ฉฑใซใ‚ใŸใฃใฆใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆใ€ๆฑบๅฎšใ€ๅญฆ็ฟ’ใŒ็ถญๆŒใ•ใ‚Œใพใ™ใ€‚ \ No newline at end of file diff --git a/docs/User-Guide-kr/agents.md b/docs/User-Guide-kr/agents.md deleted file mode 100644 index 5186093..0000000 --- a/docs/User-Guide-kr/agents.md +++ /dev/null @@ -1,865 +0,0 @@ -# SuperClaude ์—์ด์ „ํŠธ ๊ฐ€์ด๋“œ ๐Ÿค– - -SuperClaude๋Š” Claude Code๊ฐ€ ์ „๋ฌธ ์ง€์‹์„ ์œ„ํ•ด ํ˜ธ์ถœํ•  ์ˆ˜ ์žˆ๋Š” 15๊ฐœ์˜ ๋„๋ฉ”์ธ ์ „๋ฌธ ์—์ด์ „ํŠธ๋ฅผ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค. - -## ๐Ÿงช ์—์ด์ „ํŠธ ํ™œ์„ฑํ™” ํ…Œ์ŠคํŠธ - -์ด ๊ฐ€์ด๋“œ๋ฅผ ์‚ฌ์šฉํ•˜๊ธฐ ์ „์— ์—์ด์ „ํŠธ ์„ ํƒ์ด ์ž‘๋™ํ•˜๋Š”์ง€ ํ™•์ธํ•˜์„ธ์š”: - -```bash -# ์ˆ˜๋™ ์—์ด์ „ํŠธ ํ˜ธ์ถœ ํ…Œ์ŠคํŠธ -@agent-python-expert "๋ฐ์ฝ”๋ ˆ์ดํ„ฐ ์„ค๋ช…ํ•ด์ค˜" -# ์˜ˆ์ƒ ๋™์ž‘: Python ์ „๋ฌธ๊ฐ€๊ฐ€ ์ž์„ธํ•œ ์„ค๋ช…์œผ๋กœ ์‘๋‹ต - -# ๋ณด์•ˆ ์—์ด์ „ํŠธ ์ž๋™ ํ™œ์„ฑํ™” ํ…Œ์ŠคํŠธ -/sc:implement "JWT ์ธ์ฆ" -# ์˜ˆ์ƒ ๋™์ž‘: ๋ณด์•ˆ ์—”์ง€๋‹ˆ์–ด๊ฐ€ ์ž๋™์œผ๋กœ ํ™œ์„ฑํ™”๋˜์–ด์•ผ ํ•จ - -# ํ”„๋ก ํŠธ์—”๋“œ ์—์ด์ „ํŠธ ์ž๋™ ํ™œ์„ฑํ™” ํ…Œ์ŠคํŠธ -/sc:implement "๋ฐ˜์‘ํ˜• ๋„ค๋น„๊ฒŒ์ด์…˜ ์ปดํฌ๋„ŒํŠธ" -# ์˜ˆ์ƒ ๋™์ž‘: ํ”„๋ก ํŠธ์—”๋“œ ์•„ํ‚คํ…ํŠธ + Magic MCP๊ฐ€ ํ™œ์„ฑํ™”๋˜์–ด์•ผ ํ•จ - -# ์ฒด๊ณ„์  ๋ถ„์„ ํ…Œ์ŠคํŠธ -/sc:troubleshoot "๋Š๋ฆฐ API ์„ฑ๋Šฅ" -# ์˜ˆ์ƒ ๋™์ž‘: ๊ทผ๋ณธ ์›์ธ ๋ถ„์„๊ฐ€ + ์„ฑ๋Šฅ ์—”์ง€๋‹ˆ์–ด ํ™œ์„ฑํ™” - -# ์ˆ˜๋™ ๋ฐ ์ž๋™ ๊ฒฐํ•ฉ ํ…Œ์ŠคํŠธ -/sc:analyze src/ -@agent-refactoring-expert "๊ฐœ์„  ์‚ฌํ•ญ ์ œ์•ˆํ•ด์ค˜" -# ์˜ˆ์ƒ ๋™์ž‘: ๋ถ„์„ ํ›„ ๋ฆฌํŒฉํ† ๋ง ์ œ์•ˆ -``` - -**ํ…Œ์ŠคํŠธ๊ฐ€ ์‹คํŒจํ•˜๋ฉด**: `~/.claude/agents/`์— ์—์ด์ „ํŠธ ํŒŒ์ผ์ด ์žˆ๋Š”์ง€ ํ™•์ธํ•˜๊ฑฐ๋‚˜ Claude Code ์„ธ์…˜์„ ์žฌ์‹œ์ž‘ํ•˜์„ธ์š” - -## ํ•ต์‹ฌ ๊ฐœ๋… - -### SuperClaude ์—์ด์ „ํŠธ๋ž€? - -**์—์ด์ „ํŠธ**๋Š” Claude Code์˜ ๋™์ž‘์„ ์ˆ˜์ •ํ•˜๋Š” ์ปจํ…์ŠคํŠธ ์ง€์‹œ๋ฌธ์œผ๋กœ ๊ตฌํ˜„๋œ ์ „๋ฌธ AI ๋„๋ฉ”์ธ ์ „๋ฌธ๊ฐ€์ž…๋‹ˆ๋‹ค. ๊ฐ ์—์ด์ „ํŠธ๋Š” `superclaude/Agents/` ๋””๋ ‰ํ† ๋ฆฌ์— ์žˆ๋Š” ์‹ ์ค‘ํ•˜๊ฒŒ ์ž‘์„ฑ๋œ `.md` ํŒŒ์ผ๋กœ, ๋„๋ฉ”์ธ๋ณ„ ์ „๋ฌธ ์ง€์‹, ํ–‰๋™ ํŒจํ„ด, ๋ฌธ์ œ ํ•ด๊ฒฐ ์ ‘๊ทผ ๋ฐฉ์‹์„ ํฌํ•จํ•ฉ๋‹ˆ๋‹ค. - -**์ค‘์š”**: ์—์ด์ „ํŠธ๋Š” ๋ณ„๋„์˜ AI ๋ชจ๋ธ์ด๋‚˜ ์†Œํ”„ํŠธ์›จ์–ด๊ฐ€ ์•„๋‹™๋‹ˆ๋‹ค - Claude Code๊ฐ€ ์ฝ์–ด ์ „๋ฌธํ™”๋œ ํ–‰๋™์„ ์ฑ„ํƒํ•˜๋Š” ์ปจํ…์ŠคํŠธ ๊ตฌ์„ฑ์ž…๋‹ˆ๋‹ค. - -### ์—์ด์ „ํŠธ ์‚ฌ์šฉ ๋ฐฉ๋ฒ• 2๊ฐ€์ง€ - -#### 1. @agent- ์ ‘๋‘์‚ฌ๋ฅผ ์‚ฌ์šฉํ•œ ์ˆ˜๋™ ํ˜ธ์ถœ -```bash -# ํŠน์ • ์—์ด์ „ํŠธ๋ฅผ ์ง์ ‘ ํ˜ธ์ถœ -@agent-security "์ธ์ฆ ๊ตฌํ˜„ ๊ฒ€ํ† ํ•ด์ค˜" -@agent-frontend "๋ฐ˜์‘ํ˜• ๋„ค๋น„๊ฒŒ์ด์…˜ ๋””์ž์ธํ•ด์ค˜" -@agent-architect "๋งˆ์ดํฌ๋กœ์„œ๋น„์Šค ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜ ๊ณ„ํšํ•ด์ค˜" -``` - -#### 2. ์ž๋™ ํ™œ์„ฑํ™” (ํ–‰๋™ ๋ผ์šฐํŒ…) -"์ž๋™ ํ™œ์„ฑํ™”"๋Š” Claude Code๊ฐ€ ์š”์ฒญ์˜ ํ‚ค์›Œ๋“œ์™€ ํŒจํ„ด์— ๋”ฐ๋ผ ์ ์ ˆํ•œ ์ปจํ…์ŠคํŠธ๋ฅผ ์ฐธ์—ฌ์‹œํ‚ค๊ธฐ ์œ„ํ•ด ํ–‰๋™ ์ง€์นจ์„ ์ฝ๋Š” ๊ฒƒ์„ ์˜๋ฏธํ•ฉ๋‹ˆ๋‹ค. SuperClaude๋Š” Claude๊ฐ€ ๊ฐ€์žฅ ์ ์ ˆํ•œ ์ „๋ฌธ๊ฐ€์—๊ฒŒ ๋ผ์šฐํŒ…ํ•˜๊ธฐ ์œ„ํ•ด ๋”ฐ๋ฅด๋Š” ํ–‰๋™ ๊ฐ€์ด๋“œ๋ผ์ธ์„ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค. - -> **๐Ÿ“ ์—์ด์ „ํŠธ "์ž๋™ ํ™œ์„ฑํ™”" ์ž‘๋™ ๋ฐฉ์‹**: -> ์—์ด์ „ํŠธ ํ™œ์„ฑํ™”๋Š” ์ž๋™ ์‹œ์Šคํ…œ ๋กœ์ง์ด ์•„๋‹™๋‹ˆ๋‹ค - ์ปจํ…์ŠคํŠธ ํŒŒ์ผ์˜ ํ–‰๋™ ์ง€์นจ์ž…๋‹ˆ๋‹ค. -> ๋ฌธ์„œ์—์„œ ์—์ด์ „ํŠธ๊ฐ€ "์ž๋™ ํ™œ์„ฑํ™”"๋œ๋‹ค๊ณ  ํ•  ๋•Œ, Claude Code๊ฐ€ ์š”์ฒญ์˜ ํ‚ค์›Œ๋“œ์™€ ํŒจํ„ด์„ ๊ธฐ๋ฐ˜์œผ๋กœ -> ํŠน์ • ๋„๋ฉ”์ธ ์ „๋ฌธ ์ง€์‹์„ ์ฐธ์—ฌ์‹œํ‚ค๋Š” ์ง€์นจ์„ ์ฝ๋Š”๋‹ค๋Š” ์˜๋ฏธ์ž…๋‹ˆ๋‹ค. ์ด๋Š” ๊ธฐ๋ณธ ๋ฉ”์ปค๋‹ˆ์ฆ˜์— ๋Œ€ํ•ด -> ํˆฌ๋ช…ํ•˜๋ฉด์„œ๋„ ์ง€๋Šฅ์ ์ธ ๋ผ์šฐํŒ… ๊ฒฝํ—˜์„ ๋งŒ๋“ญ๋‹ˆ๋‹ค. - -```bash -# ์ด๋Ÿฌํ•œ ๋ช…๋ น์€ ๊ด€๋ จ ์—์ด์ „ํŠธ๋ฅผ ์ž๋™ ํ™œ์„ฑํ™”ํ•ฉ๋‹ˆ๋‹ค -/sc:implement "JWT ์ธ์ฆ" # โ†’ security-engineer ์ž๋™ ํ™œ์„ฑํ™” -/sc:design "React ๋Œ€์‹œ๋ณด๋“œ" # โ†’ frontend-architect ์ž๋™ ํ™œ์„ฑํ™” -/sc:troubleshoot "๋ฉ”๋ชจ๋ฆฌ ๋ˆ„์ˆ˜" # โ†’ performance-engineer ์ž๋™ ํ™œ์„ฑํ™” -``` - -**MCP ์„œ๋ฒ„**๋Š” Context7(๋ฌธ์„œ), Sequential(๋ถ„์„), Magic(UI), Playwright(ํ…Œ์ŠคํŒ…), Morphllm(์ฝ”๋“œ ๋ณ€ํ™˜)๊ณผ ๊ฐ™์€ ์ „๋ฌธ ๋„๊ตฌ๋ฅผ ํ†ตํ•ด ํ–ฅ์ƒ๋œ ๊ธฐ๋Šฅ์„ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค. - -**๋„๋ฉ”์ธ ์ „๋ฌธ๊ฐ€**๋Š” ์ผ๋ฐ˜์ ์ธ ์ ‘๊ทผ ๋ฐฉ์‹๋ณด๋‹ค ๋” ๊นŠ๊ณ  ์ •ํ™•ํ•œ ์†”๋ฃจ์…˜์„ ์ œ๊ณตํ•˜๊ธฐ ์œ„ํ•ด ์ข์€ ์ „๋ฌธ ์˜์—ญ์— ์ง‘์ค‘ํ•ฉ๋‹ˆ๋‹ค. - -### ์—์ด์ „ํŠธ ์„ ํƒ ๊ทœ์น™ - -**์šฐ์„ ์ˆœ์œ„ ๊ณ„์ธต:** -1. **์ˆ˜๋™ ์žฌ์ •์˜** - @agent-[name]์ด ์ž๋™ ํ™œ์„ฑํ™”๋ณด๋‹ค ์šฐ์„ ํ•ฉ๋‹ˆ๋‹ค -2. **ํ‚ค์›Œ๋“œ** - ์ง์ ‘์ ์ธ ๋„๋ฉ”์ธ ์šฉ์–ด๊ฐ€ ์ฃผ์š” ์—์ด์ „ํŠธ๋ฅผ ํŠธ๋ฆฌ๊ฑฐํ•ฉ๋‹ˆ๋‹ค -3. **ํŒŒ์ผ ์œ ํ˜•** - ํ™•์žฅ์ž๊ฐ€ ์–ธ์–ด/ํ”„๋ ˆ์ž„์›Œํฌ ์ „๋ฌธ๊ฐ€๋ฅผ ํ™œ์„ฑํ™”ํ•ฉ๋‹ˆ๋‹ค -4. **๋ณต์žก์„ฑ** - ๋‹ค๋‹จ๊ณ„ ์ž‘์—…์ด ์กฐ์ • ์—์ด์ „ํŠธ๋ฅผ ์ฐธ์—ฌ์‹œํ‚ต๋‹ˆ๋‹ค -5. **์ปจํ…์ŠคํŠธ** - ๊ด€๋ จ ๊ฐœ๋…์ด ๋ณด์™„ ์—์ด์ „ํŠธ๋ฅผ ํŠธ๋ฆฌ๊ฑฐํ•ฉ๋‹ˆ๋‹ค - -**์ถฉ๋Œ ํ•ด๊ฒฐ:** -- ์ˆ˜๋™ ํ˜ธ์ถœ โ†’ ์ง€์ •๋œ ์—์ด์ „ํŠธ๊ฐ€ ์šฐ์„ ํ•ฉ๋‹ˆ๋‹ค -- ์—ฌ๋Ÿฌ ์ผ์น˜ โ†’ ๋‹ค์ค‘ ์—์ด์ „ํŠธ ์กฐ์ • -- ๋ถˆ๋ช…ํ™•ํ•œ ์ปจํ…์ŠคํŠธ โ†’ ์š”๊ตฌ์‚ฌํ•ญ ๋ถ„์„๊ฐ€ ํ™œ์„ฑํ™” -- ๋†’์€ ๋ณต์žก์„ฑ โ†’ ์‹œ์Šคํ…œ ์•„ํ‚คํ…ํŠธ ๊ฐ๋… -- ํ’ˆ์งˆ ์šฐ๋ ค โ†’ ์ž๋™ QA ์—์ด์ „ํŠธ ํฌํ•จ - -**์„ ํƒ ๊ฒฐ์ • ํŠธ๋ฆฌ:** -``` -์ž‘์—… ๋ถ„์„ โ†’ -โ”œโ”€ ์ˆ˜๋™ @agent-? โ†’ ์ง€์ •๋œ ์—์ด์ „ํŠธ ์‚ฌ์šฉ -โ”œโ”€ ๋‹จ์ผ ๋„๋ฉ”์ธ? โ†’ ์ฃผ์š” ์—์ด์ „ํŠธ ํ™œ์„ฑํ™” -โ”œโ”€ ๋‹ค์ค‘ ๋„๋ฉ”์ธ? โ†’ ์ „๋ฌธ ์—์ด์ „ํŠธ ์กฐ์ • -โ”œโ”€ ๋ณต์žกํ•œ ์‹œ์Šคํ…œ? โ†’ system-architect ๊ฐ๋… ์ถ”๊ฐ€ -โ”œโ”€ ํ’ˆ์งˆ ์ค‘์š”? โ†’ security + performance + quality ์—์ด์ „ํŠธ ํฌํ•จ -โ””โ”€ ํ•™์Šต ์ค‘์‹ฌ? โ†’ learning-guide + technical-writer ์ถ”๊ฐ€ -``` - -## ๋น ๋ฅธ ์‹œ์ž‘ ์˜ˆ์ œ - -### ์ˆ˜๋™ ์—์ด์ „ํŠธ ํ˜ธ์ถœ -```bash -# @agent- ์ ‘๋‘์‚ฌ๋กœ ํŠน์ • ์—์ด์ „ํŠธ๋ฅผ ๋ช…์‹œ์ ์œผ๋กœ ํ˜ธ์ถœ -@agent-python-expert "์ด ๋ฐ์ดํ„ฐ ์ฒ˜๋ฆฌ ํŒŒ์ดํ”„๋ผ์ธ ์ตœ์ ํ™”ํ•ด์ค˜" -@agent-quality-engineer "ํฌ๊ด„์ ์ธ ํ…Œ์ŠคํŠธ ์Šค์œ„ํŠธ ๋งŒ๋“ค์–ด์ค˜" -@agent-technical-writer "์ด API๋ฅผ ์˜ˆ์ œ์™€ ํ•จ๊ป˜ ๋ฌธ์„œํ™”ํ•ด์ค˜" -@agent-socratic-mentor "์ด ๋””์ž์ธ ํŒจํ„ด ์„ค๋ช…ํ•ด์ค˜" -``` - -### ์ž๋™ ์—์ด์ „ํŠธ ์กฐ์ • -```bash -# ์ž๋™ ํ™œ์„ฑํ™”๋ฅผ ํŠธ๋ฆฌ๊ฑฐํ•˜๋Š” ๋ช…๋ น -/sc:implement "์†๋„ ์ œํ•œ์ด ์žˆ๋Š” JWT ์ธ์ฆ" -# โ†’ ํŠธ๋ฆฌ๊ฑฐ: security-engineer + backend-architect + quality-engineer - -/sc:design "์ ‘๊ทผ ๊ฐ€๋Šฅํ•œ React ๋Œ€์‹œ๋ณด๋“œ์™€ ๋ฌธ์„œ" -# โ†’ ํŠธ๋ฆฌ๊ฑฐ: frontend-architect + learning-guide + technical-writer - -/sc:troubleshoot "๊ฐ„ํ—์  ์‹คํŒจ๊ฐ€ ์žˆ๋Š” ๋Š๋ฆฐ ๋ฐฐํฌ ํŒŒ์ดํ”„๋ผ์ธ" -# โ†’ ํŠธ๋ฆฌ๊ฑฐ: devops-architect + performance-engineer + root-cause-analyst - -/sc:audit "๊ฒฐ์ œ ์ฒ˜๋ฆฌ ๋ณด์•ˆ ์ทจ์•ฝ์ " -# โ†’ ํŠธ๋ฆฌ๊ฑฐ: security-engineer + quality-engineer + refactoring-expert -``` - -### ์ˆ˜๋™ ๋ฐ ์ž๋™ ์ ‘๊ทผ ๋ฐฉ์‹ ๊ฒฐํ•ฉ -```bash -# ๋ช…๋ น์œผ๋กœ ์‹œ์ž‘ (์ž๋™ ํ™œ์„ฑํ™”) -/sc:implement "์‚ฌ์šฉ์ž ํ”„๋กœํ•„ ์‹œ์Šคํ…œ" - -# ๊ทธ๋Ÿฐ ๋‹ค์Œ ์ „๋ฌธ๊ฐ€ ๊ฒ€ํ† ๋ฅผ ๋ช…์‹œ์ ์œผ๋กœ ์ถ”๊ฐ€ -@agent-security "ํ”„๋กœํ•„ ์‹œ์Šคํ…œ์˜ OWASP ๊ทœ์ • ์ค€์ˆ˜ ๊ฒ€ํ† ํ•ด์ค˜" -@agent-performance-engineer "๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์ฟผ๋ฆฌ ์ตœ์ ํ™”ํ•ด์ค˜" -``` - ---- - -## SuperClaude ์—์ด์ „ํŠธ ํŒ€ ๐Ÿ‘ฅ - -### ์•„ํ‚คํ…์ฒ˜ ๋ฐ ์‹œ์Šคํ…œ ์„ค๊ณ„ ์—์ด์ „ํŠธ ๐Ÿ—๏ธ - -### system-architect ๐Ÿข -**์ „๋ฌธ ๋ถ„์•ผ**: ํ™•์žฅ์„ฑ๊ณผ ์„œ๋น„์Šค ์•„ํ‚คํ…์ฒ˜์— ์ค‘์ ์„ ๋‘” ๋Œ€๊ทœ๋ชจ ๋ถ„์‚ฐ ์‹œ์Šคํ…œ ์„ค๊ณ„ - -**์ž๋™ ํ™œ์„ฑํ™”**: -- ํ‚ค์›Œ๋“œ: "architecture", "microservices", "scalability", "system design", "distributed" -- ์ปจํ…์ŠคํŠธ: ๋‹ค์ค‘ ์„œ๋น„์Šค ์‹œ์Šคํ…œ, ์•„ํ‚คํ…์ฒ˜ ๊ฒฐ์ •, ๊ธฐ์ˆ  ์„ ํƒ -- ๋ณต์žก์„ฑ: >5๊ฐœ ์ปดํฌ๋„ŒํŠธ ๋˜๋Š” ๊ต์ฐจ ๋„๋ฉ”์ธ ํ†ตํ•ฉ ์š”๊ตฌ์‚ฌํ•ญ - -**์—ญ๋Ÿ‰**: -- ์„œ๋น„์Šค ๊ฒฝ๊ณ„ ์ •์˜ ๋ฐ ๋งˆ์ดํฌ๋กœ์„œ๋น„์Šค ๋ถ„ํ•ด -- ๊ธฐ์ˆ  ์Šคํƒ ์„ ํƒ ๋ฐ ํ†ตํ•ฉ ์ „๋žต -- ํ™•์žฅ์„ฑ ๊ณ„ํš ๋ฐ ์„ฑ๋Šฅ ์•„ํ‚คํ…์ฒ˜ -- ์ด๋ฒคํŠธ ๊ธฐ๋ฐ˜ ์•„ํ‚คํ…์ฒ˜ ๋ฐ ๋ฉ”์‹œ์ง• ํŒจํ„ด -- ๋ฐ์ดํ„ฐ ํ๋ฆ„ ์„ค๊ณ„ ๋ฐ ์‹œ์Šคํ…œ ํ†ตํ•ฉ - -**์˜ˆ์ œ**: -1. **์ „์ž์ƒ๊ฑฐ๋ž˜ ํ”Œ๋žซํผ**: ์ด๋ฒคํŠธ ์†Œ์‹ฑ์„ ์‚ฌ์šฉํ•œ ์‚ฌ์šฉ์ž, ์ œํ’ˆ, ๊ฒฐ์ œ, ์•Œ๋ฆผ ์„œ๋น„์Šค๋ฅผ ์œ„ํ•œ ๋งˆ์ดํฌ๋กœ์„œ๋น„์Šค ์„ค๊ณ„ -2. **์‹ค์‹œ๊ฐ„ ๋ถ„์„**: ์ŠคํŠธ๋ฆผ ์ฒ˜๋ฆฌ ๋ฐ ์‹œ๊ณ„์—ด ์ €์žฅ์†Œ๋ฅผ ๊ฐ–์ถ˜ ๊ณ ์ฒ˜๋ฆฌ๋Ÿ‰ ๋ฐ์ดํ„ฐ ์ˆ˜์ง‘ ์•„ํ‚คํ…์ฒ˜ -3. **๋‹ค์ค‘ ํ…Œ๋„ŒํŠธ SaaS**: ํ…Œ๋„ŒํŠธ ๊ฒฉ๋ฆฌ, ๊ณต์œ  ์ธํ”„๋ผ, ์ˆ˜ํ‰ ํ™•์žฅ ์ „๋žต์„ ๊ฐ–์ถ˜ ์‹œ์Šคํ…œ ์„ค๊ณ„ - -### ์„ฑ๊ณต ๊ธฐ์ค€ -- [ ] ์‘๋‹ต์—์„œ ์‹œ์Šคํ…œ ์ˆ˜์ค€ ์‚ฌ๊ณ ๊ฐ€ ๋ช…ํ™•ํ•จ -- [ ] ์„œ๋น„์Šค ๊ฒฝ๊ณ„ ๋ฐ ํ†ตํ•ฉ ํŒจํ„ด ์–ธ๊ธ‰ -- [ ] ํ™•์žฅ์„ฑ ๋ฐ ์‹ ๋ขฐ์„ฑ ๊ณ ๋ ค์‚ฌํ•ญ ํฌํ•จ -- [ ] ๊ธฐ์ˆ  ์Šคํƒ ๊ถŒ์žฅ์‚ฌํ•ญ ์ œ๊ณต - -**๊ฒ€์ฆ:** `/sc:design "๋งˆ์ดํฌ๋กœ์„œ๋น„์Šค ํ”Œ๋žซํผ"`์€ system-architect๋ฅผ ํ™œ์„ฑํ™”ํ•ด์•ผ ํ•จ -**ํ…Œ์ŠคํŠธ:** ์ถœ๋ ฅ์— ์„œ๋น„์Šค ๋ถ„ํ•ด ๋ฐ ํ†ตํ•ฉ ํŒจํ„ด์ด ํฌํ•จ๋˜์–ด์•ผ ํ•จ -**ํ™•์ธ:** ์ธํ”„๋ผ ๋ฌธ์ œ์— ๋Œ€ํ•ด devops-architect์™€ ์กฐ์ •ํ•ด์•ผ ํ•จ - -**์ตœ์ ์˜ ํ˜‘์—… ๋Œ€์ƒ**: devops-architect(์ธํ”„๋ผ), performance-engineer(์ตœ์ ํ™”), security-engineer(๊ทœ์ • ์ค€์ˆ˜) - ---- - -### backend-architect โš™๏ธ -**์ „๋ฌธ ๋ถ„์•ผ**: API ์‹ ๋ขฐ์„ฑ๊ณผ ๋ฐ์ดํ„ฐ ๋ฌด๊ฒฐ์„ฑ์„ ๊ฐ•์กฐํ•˜๋Š” ๊ฒฌ๊ณ ํ•œ ์„œ๋ฒ„ ์ธก ์‹œ์Šคํ…œ ์„ค๊ณ„ - -**์ž๋™ ํ™œ์„ฑํ™”**: -- ํ‚ค์›Œ๋“œ: "API", "backend", "server", "database", "REST", "GraphQL", "endpoint" -- ํŒŒ์ผ ์œ ํ˜•: API ์ŠคํŽ™, ์„œ๋ฒ„ ์„ค์ •, ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์Šคํ‚ค๋งˆ -- ์ปจํ…์ŠคํŠธ: ์„œ๋ฒ„ ์ธก ๋กœ์ง, ๋ฐ์ดํ„ฐ ์ง€์†์„ฑ, API ๊ฐœ๋ฐœ - -**์—ญ๋Ÿ‰**: -- RESTful ๋ฐ GraphQL API ์•„ํ‚คํ…์ฒ˜ ๋ฐ ๋””์ž์ธ ํŒจํ„ด -- ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์Šคํ‚ค๋งˆ ์„ค๊ณ„ ๋ฐ ์ฟผ๋ฆฌ ์ตœ์ ํ™” ์ „๋žต -- ์ธ์ฆ, ๊ถŒํ•œ ๋ถ€์—ฌ ๋ฐ ๋ณด์•ˆ ๊ตฌํ˜„ -- ์˜ค๋ฅ˜ ์ฒ˜๋ฆฌ, ๋กœ๊น… ๋ฐ ๋ชจ๋‹ˆํ„ฐ๋ง ํ†ตํ•ฉ -- ์บ์‹ฑ ์ „๋žต ๋ฐ ์„ฑ๋Šฅ ์ตœ์ ํ™” - -**์˜ˆ์ œ**: -1. **์‚ฌ์šฉ์ž ๊ด€๋ฆฌ API**: JWT ์ธ์ฆ, ์—ญํ•  ๊ธฐ๋ฐ˜ ์•ก์„ธ์Šค ์ œ์–ด ๋ฐ ์†๋„ ์ œํ•œ -2. **๊ฒฐ์ œ ์ฒ˜๋ฆฌ**: PCI ๊ทœ์ • ์ค€์ˆ˜ ํŠธ๋žœ์žญ์…˜ ์ฒ˜๋ฆฌ, ๋ฉฑ๋“ฑ์„ฑ ๋ฐ ๊ฐ์‚ฌ ์ถ”์  -3. **์ฝ˜ํ…์ธ  ๊ด€๋ฆฌ**: ์บ์‹ฑ, ํŽ˜์ด์ง€๋„ค์ด์…˜, ์‹ค์‹œ๊ฐ„ ์•Œ๋ฆผ์„ ๊ฐ–์ถ˜ RESTful API - -**์ตœ์ ์˜ ํ˜‘์—… ๋Œ€์ƒ**: security-engineer(์ธ์ฆ/๋ณด์•ˆ), performance-engineer(์ตœ์ ํ™”), quality-engineer(ํ…Œ์ŠคํŒ…) - ---- - -### frontend-architect ๐ŸŽจ -**์ „๋ฌธ ๋ถ„์•ผ**: ์ ‘๊ทผ์„ฑ๊ณผ ์‚ฌ์šฉ์ž ๊ฒฝํ—˜์— ์ค‘์ ์„ ๋‘” ํ˜„๋Œ€์ ์ธ ์›น ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ์•„ํ‚คํ…์ฒ˜ - -**์ž๋™ ํ™œ์„ฑํ™”**: -- ํ‚ค์›Œ๋“œ: "UI", "frontend", "React", "Vue", "Angular", "component", "accessibility", "responsive" -- ํŒŒ์ผ ์œ ํ˜•: .jsx, .vue, .ts(ํ”„๋ก ํŠธ์—”๋“œ), .css, .scss -- ์ปจํ…์ŠคํŠธ: ์‚ฌ์šฉ์ž ์ธํ„ฐํŽ˜์ด์Šค ๊ฐœ๋ฐœ, ์ปดํฌ๋„ŒํŠธ ์„ค๊ณ„, ํด๋ผ์ด์–ธํŠธ ์ธก ์•„ํ‚คํ…์ฒ˜ - -**์—ญ๋Ÿ‰**: -- ์ปดํฌ๋„ŒํŠธ ์•„ํ‚คํ…์ฒ˜ ๋ฐ ๋””์ž์ธ ์‹œ์Šคํ…œ ๊ตฌํ˜„ -- ์ƒํƒœ ๊ด€๋ฆฌ ํŒจํ„ด(Redux, Zustand, Pinia) -- ์ ‘๊ทผ์„ฑ ๊ทœ์ • ์ค€์ˆ˜(WCAG 2.1) ๋ฐ ํฌ์šฉ์  ๋””์ž์ธ -- ์„ฑ๋Šฅ ์ตœ์ ํ™” ๋ฐ ๋ฒˆ๋“ค ๋ถ„์„ -- ํ”„๋กœ๊ทธ๋ ˆ์‹œ๋ธŒ ์›น ์•ฑ ๋ฐ ๋ชจ๋ฐ”์ผ ์šฐ์„  ๊ฐœ๋ฐœ - -**์˜ˆ์ œ**: -1. **๋Œ€์‹œ๋ณด๋“œ ์ธํ„ฐํŽ˜์ด์Šค**: ์‹ค์‹œ๊ฐ„ ์—…๋ฐ์ดํŠธ ๋ฐ ๋ฐ˜์‘ํ˜• ๊ทธ๋ฆฌ๋“œ ๋ ˆ์ด์•„์›ƒ์„ ๊ฐ–์ถ˜ ์ ‘๊ทผ ๊ฐ€๋Šฅํ•œ ๋ฐ์ดํ„ฐ ์‹œ๊ฐํ™” -2. **ํผ ์‹œ์Šคํ…œ**: ๊ฒ€์ฆ, ์˜ค๋ฅ˜ ์ฒ˜๋ฆฌ, ์ ‘๊ทผ์„ฑ ๊ธฐ๋Šฅ์„ ๊ฐ–์ถ˜ ๋ณต์žกํ•œ ๋‹ค๋‹จ๊ณ„ ํผ -3. **๋””์ž์ธ ์‹œ์Šคํ…œ**: ์ผ๊ด€๋œ ์Šคํƒ€์ผ๋ง ๋ฐ ์ƒํ˜ธ์ž‘์šฉ ํŒจํ„ด์„ ๊ฐ–์ถ˜ ์žฌ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ ์ปดํฌ๋„ŒํŠธ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ - -**์ตœ์ ์˜ ํ˜‘์—… ๋Œ€์ƒ**: learning-guide(์‚ฌ์šฉ์ž ์•ˆ๋‚ด), performance-engineer(์ตœ์ ํ™”), quality-engineer(ํ…Œ์ŠคํŒ…) - ---- - -### devops-architect ๐Ÿš€ -**์ „๋ฌธ ๋ถ„์•ผ**: ์•ˆ์ •์ ์ธ ์†Œํ”„ํŠธ์›จ์–ด ์ „๋‹ฌ์„ ์œ„ํ•œ ์ธํ”„๋ผ ์ž๋™ํ™” ๋ฐ ๋ฐฐํฌ ํŒŒ์ดํ”„๋ผ์ธ ์„ค๊ณ„ - -**์ž๋™ ํ™œ์„ฑํ™”**: -- ํ‚ค์›Œ๋“œ: "deploy", "CI/CD", "Docker", "Kubernetes", "infrastructure", "monitoring", "pipeline" -- ํŒŒ์ผ ์œ ํ˜•: Dockerfile, docker-compose.yml, k8s ๋งค๋‹ˆํŽ˜์ŠคํŠธ, CI ์„ค์ • -- ์ปจํ…์ŠคํŠธ: ๋ฐฐํฌ ํ”„๋กœ์„ธ์Šค, ์ธํ”„๋ผ ๊ด€๋ฆฌ, ์ž๋™ํ™” - -**์—ญ๋Ÿ‰**: -- ์ž๋™ํ™”๋œ ํ…Œ์ŠคํŒ… ๋ฐ ๋ฐฐํฌ๋ฅผ ๊ฐ–์ถ˜ CI/CD ํŒŒ์ดํ”„๋ผ์ธ ์„ค๊ณ„ -- ์ปจํ…Œ์ด๋„ˆ ์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜ ๋ฐ Kubernetes ํด๋Ÿฌ์Šคํ„ฐ ๊ด€๋ฆฌ -- Terraform ๋ฐ ํด๋ผ์šฐ๋“œ ํ”Œ๋žซํผ์„ ์‚ฌ์šฉํ•œ Infrastructure as Code -- ๋ฉ”ํŠธ๋ฆญ, ๋กœ๊ทธ, ์ถ”์ ์„ ์œ„ํ•œ ๋ชจ๋‹ˆํ„ฐ๋ง, ๋กœ๊น…, ๊ด€์ฐฐ์„ฑ ์Šคํƒ ๊ตฌํ˜„ -- ๋ณด์•ˆ ์Šค์บ” ๋ฐ ๊ทœ์ • ์ค€์ˆ˜ ์ž๋™ํ™” - -**์˜ˆ์ œ**: -1. **๋งˆ์ดํฌ๋กœ์„œ๋น„์Šค ๋ฐฐํฌ**: ์„œ๋น„์Šค ๋ฉ”์‹œ, ์ž๋™ ํ™•์žฅ, blue-green ๋ฆด๋ฆฌ์Šค๋ฅผ ๊ฐ–์ถ˜ Kubernetes ๋ฐฐํฌ -2. **๋‹ค์ค‘ ํ™˜๊ฒฝ ํŒŒ์ดํ”„๋ผ์ธ**: ์ž๋™ํ™”๋œ ํ…Œ์ŠคํŒ…, ๋ณด์•ˆ ์Šค์บ”, ๋‹จ๊ณ„๋ณ„ ๋ฐฐํฌ๋ฅผ ๊ฐ–์ถ˜ GitOps ์›Œํฌํ”Œ๋กœ์šฐ -3. **๋ชจ๋‹ˆํ„ฐ๋ง ์Šคํƒ**: ๋ฉ”ํŠธ๋ฆญ, ๋กœ๊ทธ, ์ถ”์ , ์•Œ๋ฆผ ์‹œ์Šคํ…œ์„ ๊ฐ–์ถ˜ ํฌ๊ด„์ ์ธ ๊ด€์ฐฐ์„ฑ - -**์ตœ์ ์˜ ํ˜‘์—… ๋Œ€์ƒ**: system-architect(์ธํ”„๋ผ ๊ณ„ํš), security-engineer(๊ทœ์ • ์ค€์ˆ˜), performance-engineer(๋ชจ๋‹ˆํ„ฐ๋ง) - ---- - -### deep-research-agent ๐Ÿ”ฌ -**์ „๋ฌธ ๋ถ„์•ผ**: ์ ์‘ํ˜• ์ „๋žต๊ณผ ๋‹ค์ค‘ ํ™‰ ์ถ”๋ก ์„ ์‚ฌ์šฉํ•œ ํฌ๊ด„์ ์ธ ์—ฐ๊ตฌ - -**์ž๋™ ํ™œ์„ฑํ™”**: -- ํ‚ค์›Œ๋“œ: "research", "investigate", "discover", "explore", "find out", "search for", "latest", "current" -- ๋ช…๋ น์–ด: `/sc:research`๊ฐ€ ์ž๋™์œผ๋กœ ์ด ์—์ด์ „ํŠธ๋ฅผ ํ™œ์„ฑํ™” -- ์ปจํ…์ŠคํŠธ: ์ฒ ์ €ํ•œ ์กฐ์‚ฌ๊ฐ€ ํ•„์š”ํ•œ ๋ณต์žกํ•œ ์ฟผ๋ฆฌ, ์ตœ์‹  ์ •๋ณด ํ•„์š”, ์‚ฌ์‹ค ํ™•์ธ -- ๋ณต์žก์„ฑ: ์—ฌ๋Ÿฌ ๋„๋ฉ”์ธ์— ๊ฑธ์ณ ์žˆ๊ฑฐ๋‚˜ ๋ฐ˜๋ณต์  ํƒ์ƒ‰์ด ํ•„์š”ํ•œ ์งˆ๋ฌธ - -**์—ญ๋Ÿ‰**: -- **์ ์‘ํ˜• ๊ณ„ํš ์ „๋žต**: Planning(์ง์ ‘), Intent(๋จผ์ € ๋ช…ํ™•ํ™”), Unified(ํ˜‘์—…) -- **๋‹ค์ค‘ ํ™‰ ์ถ”๋ก **: ์ตœ๋Œ€ 5๋‹จ๊ณ„ - ์—”ํ‹ฐํ‹ฐ ํ™•์žฅ, ์‹œ๊ฐ„์  ์ง„ํ–‰, ๊ฐœ๋…์  ์‹ฌํ™”, ์ธ๊ณผ ๊ด€๊ณ„ ์ฒด์ธ -- **์ž๊ธฐ ์„ฑ์ฐฐ ๋ฉ”์ปค๋‹ˆ์ฆ˜**: ๊ฐ ์ฃผ์š” ๋‹จ๊ณ„ ํ›„ ์ง„ํ–‰ ์ƒํ™ฉ ํ‰๊ฐ€ ๋ฐ ์žฌ๊ณ„ํš ํŠธ๋ฆฌ๊ฑฐ -- **์ฆ๊ฑฐ ๊ด€๋ฆฌ**: ๋ช…ํ™•ํ•œ ์ธ์šฉ, ๊ด€๋ จ์„ฑ ์ ์ˆ˜, ๋ถˆํ™•์‹ค์„ฑ ์ธ์ • -- **๋„๊ตฌ ์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜**: Tavily(๊ฒ€์ƒ‰), Playwright(JavaScript ์ฝ˜ํ…์ธ ), Sequential(์ถ”๋ก )์„ ์‚ฌ์šฉํ•œ ๋ณ‘๋ ฌ ์šฐ์„  ์‹คํ–‰ -- **ํ•™์Šต ํ†ตํ•ฉ**: Serena ๋ฉ”๋ชจ๋ฆฌ๋ฅผ ํ†ตํ•œ ํŒจํ„ด ์ธ์‹ ๋ฐ ์ „๋žต ์žฌ์‚ฌ์šฉ - -**์—ฐ๊ตฌ ๊นŠ์ด ์ˆ˜์ค€**: -- **Quick**: ๊ธฐ๋ณธ ๊ฒ€์ƒ‰, 1ํ™‰, ์š”์•ฝ ์ถœ๋ ฅ -- **Standard**: ํ™•์žฅ ๊ฒ€์ƒ‰, 2-3ํ™‰, ๊ตฌ์กฐํ™”๋œ ๋ณด๊ณ ์„œ(๊ธฐ๋ณธ๊ฐ’) -- **Deep**: ํฌ๊ด„์  ๊ฒ€์ƒ‰, 3-4ํ™‰, ์ƒ์„ธ ๋ถ„์„ -- **Exhaustive**: ์ตœ๋Œ€ ๊นŠ์ด, 5ํ™‰, ์™„์ „ํ•œ ์กฐ์‚ฌ - -**์˜ˆ์ œ**: -1. **๊ธฐ์ˆ  ์—ฐ๊ตฌ**: `/sc:research "์ตœ์‹  React Server Components ํŒจํ„ด"` โ†’ ๊ตฌํ˜„ ์˜ˆ์ œ๋ฅผ ํฌํ•จํ•œ ํฌ๊ด„์ ์ธ ๊ธฐ์ˆ  ์—ฐ๊ตฌ -2. **์‹œ์žฅ ๋ถ„์„**: `/sc:research "2024๋…„ AI ์ฝ”๋”ฉ ์–ด์‹œ์Šคํ„ดํŠธ ํ˜„ํ™ฉ" --strategy unified` โ†’ ์‚ฌ์šฉ์ž ์ž…๋ ฅ์„ ํฌํ•จํ•œ ํ˜‘์—… ๋ถ„์„ -3. **ํ•™์ˆ  ์กฐ์‚ฌ**: `/sc:research "์–‘์ž ์ปดํ“จํŒ… ๋ŒํŒŒ๊ตฌ" --depth exhaustive` โ†’ ์ฆ๊ฑฐ ์ฒด์ธ์„ ํฌํ•จํ•œ ํฌ๊ด„์ ์ธ ๋ฌธํ—Œ ๊ฒ€ํ†  - -**์›Œํฌํ”Œ๋กœ์šฐ ํŒจํ„ด** (6๋‹จ๊ณ„): -1. **์ดํ•ด** (5-10%): ์ฟผ๋ฆฌ ๋ณต์žก์„ฑ ํ‰๊ฐ€ -2. **๊ณ„ํš** (10-15%): ์ „๋žต ์„ ํƒ ๋ฐ ๋ณ‘๋ ฌ ๊ธฐํšŒ ์‹๋ณ„ -3. **TodoWrite** (5%): ์ ์‘ํ˜• ์ž‘์—… ๊ณ„์ธต ๊ตฌ์กฐ ์ƒ์„ฑ(3-15๊ฐœ ์ž‘์—…) -4. **์‹คํ–‰** (50-60%): ๋ณ‘๋ ฌ ๊ฒ€์ƒ‰ ๋ฐ ์ถ”์ถœ -5. **์ถ”์ ** (์ง€์†์ ): ์ง„ํ–‰ ์ƒํ™ฉ ๋ฐ ์‹ ๋ขฐ๋„ ๋ชจ๋‹ˆํ„ฐ๋ง -6. **๊ฒ€์ฆ** (10-15%): ์ฆ๊ฑฐ ์ฒด์ธ ํ™•์ธ - -**์ถœ๋ ฅ**: ๋ณด๊ณ ์„œ๋Š” `claudedocs/research_[topic]_[timestamp].md`์— ์ €์žฅ๋จ - -**์ตœ์ ์˜ ํ˜‘์—… ๋Œ€์ƒ**: system-architect(๊ธฐ์ˆ  ์—ฐ๊ตฌ), learning-guide(๊ต์œก ์—ฐ๊ตฌ), requirements-analyst(์‹œ์žฅ ์—ฐ๊ตฌ) - -### ํ’ˆ์งˆ ๋ฐ ๋ถ„์„ ์—์ด์ „ํŠธ ๐Ÿ” - -### security-engineer ๐Ÿ”’ -**์ „๋ฌธ ๋ถ„์•ผ**: ์œ„ํ˜‘ ๋ชจ๋ธ๋ง ๋ฐ ์ทจ์•ฝ์  ์˜ˆ๋ฐฉ์— ์ค‘์ ์„ ๋‘” ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ๋ณด์•ˆ ์•„ํ‚คํ…์ฒ˜ - -**์ž๋™ ํ™œ์„ฑํ™”**: -- ํ‚ค์›Œ๋“œ: "security", "auth", "authentication", "vulnerability", "encryption", "compliance", "OWASP" -- ์ปจํ…์ŠคํŠธ: ๋ณด์•ˆ ๊ฒ€ํ† , ์ธ์ฆ ํ๋ฆ„, ๋ฐ์ดํ„ฐ ๋ณดํ˜ธ ์š”๊ตฌ์‚ฌํ•ญ -- ์œ„ํ—˜ ์ง€ํ‘œ: ๊ฒฐ์ œ ์ฒ˜๋ฆฌ, ์‚ฌ์šฉ์ž ๋ฐ์ดํ„ฐ, API ์•ก์„ธ์Šค, ๊ทœ์ • ์ค€์ˆ˜ ํ•„์š” - -**์—ญ๋Ÿ‰**: -- ์œ„ํ˜‘ ๋ชจ๋ธ๋ง ๋ฐ ๊ณต๊ฒฉ ํ‘œ๋ฉด ๋ถ„์„ -- ์•ˆ์ „ํ•œ ์ธ์ฆ ๋ฐ ๊ถŒํ•œ ๋ถ€์—ฌ ์„ค๊ณ„(OAuth, JWT, SAML) -- ๋ฐ์ดํ„ฐ ์•”ํ˜ธํ™” ์ „๋žต ๋ฐ ํ‚ค ๊ด€๋ฆฌ -- ์ทจ์•ฝ์  ํ‰๊ฐ€ ๋ฐ ์นจํˆฌ ํ…Œ์ŠคํŠธ ์ง€์นจ -- ๋ณด์•ˆ ๊ทœ์ • ์ค€์ˆ˜(GDPR, HIPAA, PCI-DSS) ๊ตฌํ˜„ - -**์˜ˆ์ œ**: -1. **OAuth ๊ตฌํ˜„**: ํ† ํฐ ์ƒˆ๋กœ ๊ณ ์นจ ๋ฐ ์—ญํ•  ๊ธฐ๋ฐ˜ ์•ก์„ธ์Šค๋ฅผ ๊ฐ–์ถ˜ ์•ˆ์ „ํ•œ ๋‹ค์ค‘ ํ…Œ๋„ŒํŠธ ์ธ์ฆ -2. **API ๋ณด์•ˆ**: ์†๋„ ์ œํ•œ, ์ž…๋ ฅ ๊ฒ€์ฆ, SQL ์ธ์ ์…˜ ๋ฐฉ์ง€, ๋ณด์•ˆ ํ—ค๋” -3. **๋ฐ์ดํ„ฐ ๋ณดํ˜ธ**: ์ €์žฅ/์ „์†ก ์ค‘ ์•”ํ˜ธํ™”, ํ‚ค ์ˆœํ™˜, ํ”„๋ผ์ด๋ฒ„์‹œ ๋ฐ”์ด ๋””์ž์ธ ์•„ํ‚คํ…์ฒ˜ - -**์ตœ์ ์˜ ํ˜‘์—… ๋Œ€์ƒ**: backend-architect(API ๋ณด์•ˆ), quality-engineer(๋ณด์•ˆ ํ…Œ์ŠคํŒ…), root-cause-analyst(์‚ฌ๊ณ  ๋Œ€์‘) - ---- - -### performance-engineer โšก -**์ „๋ฌธ ๋ถ„์•ผ**: ํ™•์žฅ์„ฑ๊ณผ ๋ฆฌ์†Œ์Šค ํšจ์œจ์„ฑ์— ์ค‘์ ์„ ๋‘” ์‹œ์Šคํ…œ ์„ฑ๋Šฅ ์ตœ์ ํ™” - -**์ž๋™ ํ™œ์„ฑํ™”**: -- ํ‚ค์›Œ๋“œ: "performance", "slow", "optimization", "bottleneck", "latency", "memory", "CPU" -- ์ปจํ…์ŠคํŠธ: ์„ฑ๋Šฅ ๋ฌธ์ œ, ํ™•์žฅ์„ฑ ์šฐ๋ ค, ๋ฆฌ์†Œ์Šค ์ œ์•ฝ -- ๋ฉ”ํŠธ๋ฆญ: ์‘๋‹ต ์‹œ๊ฐ„ >500ms, ๋†’์€ ๋ฉ”๋ชจ๋ฆฌ ์‚ฌ์šฉ๋Ÿ‰, ๋‚ฎ์€ ์ฒ˜๋ฆฌ๋Ÿ‰ - -**์—ญ๋Ÿ‰**: -- ์„ฑ๋Šฅ ํ”„๋กœํŒŒ์ผ๋ง ๋ฐ ๋ณ‘๋ชฉ ํ˜„์ƒ ์‹๋ณ„ -- ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์ฟผ๋ฆฌ ์ตœ์ ํ™” ๋ฐ ์ธ๋ฑ์‹ฑ ์ „๋žต -- ์บ์‹ฑ ๊ตฌํ˜„(Redis, CDN, ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ๋ ˆ๋ฒจ) -- ๋ถ€ํ•˜ ํ…Œ์ŠคํŠธ ๋ฐ ์šฉ๋Ÿ‰ ๊ณ„ํš -- ๋ฉ”๋ชจ๋ฆฌ ๊ด€๋ฆฌ ๋ฐ ๋ฆฌ์†Œ์Šค ์ตœ์ ํ™” - -**์˜ˆ์ œ**: -1. **API ์ตœ์ ํ™”**: ์บ์‹ฑ ๋ฐ ์ฟผ๋ฆฌ ์ตœ์ ํ™”๋ฅผ ํ†ตํ•ด ์‘๋‹ต ์‹œ๊ฐ„์„ 2์ดˆ์—์„œ 200ms๋กœ ๋‹จ์ถ• -2. **๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํ™•์žฅ**: ์ฝ๊ธฐ ๋ณต์ œ๋ณธ, ์—ฐ๊ฒฐ ํ’€๋ง, ์ฟผ๋ฆฌ ๊ฒฐ๊ณผ ์บ์‹ฑ ๊ตฌํ˜„ -3. **ํ”„๋ก ํŠธ์—”๋“œ ์„ฑ๋Šฅ**: ๋ฒˆ๋“ค ์ตœ์ ํ™”, ์ง€์—ฐ ๋กœ๋”ฉ, CDN ๊ตฌํ˜„์œผ๋กœ <3์ดˆ ๋กœ๋“œ ์‹œ๊ฐ„ ๋‹ฌ์„ฑ - -**์ตœ์ ์˜ ํ˜‘์—… ๋Œ€์ƒ**: system-architect(ํ™•์žฅ์„ฑ), devops-architect(์ธํ”„๋ผ), root-cause-analyst(๋””๋ฒ„๊น…) - ---- - -### root-cause-analyst ๐Ÿ” -**์ „๋ฌธ ๋ถ„์•ผ**: ์ฆ๊ฑฐ ๊ธฐ๋ฐ˜ ๋ถ„์„ ๋ฐ ๊ฐ€์„ค ํ…Œ์ŠคํŠธ๋ฅผ ์‚ฌ์šฉํ•œ ์ฒด๊ณ„์ ์ธ ๋ฌธ์ œ ์กฐ์‚ฌ - -**์ž๋™ ํ™œ์„ฑํ™”**: -- ํ‚ค์›Œ๋“œ: "bug", "issue", "problem", "debugging", "investigation", "troubleshoot", "error" -- ์ปจํ…์ŠคํŠธ: ์‹œ์Šคํ…œ ์žฅ์• , ์˜ˆ์ƒ์น˜ ๋ชปํ•œ ๋™์ž‘, ๋ณต์žกํ•œ ๋‹ค์ค‘ ์ปดํฌ๋„ŒํŠธ ๋ฌธ์ œ -- ๋ณต์žก์„ฑ: ์ฒด๊ณ„์ ์ธ ์กฐ์‚ฌ๊ฐ€ ํ•„์š”ํ•œ ๊ต์ฐจ ์‹œ์Šคํ…œ ๋ฌธ์ œ - -**์—ญ๋Ÿ‰**: -- ์ฒด๊ณ„์ ์ธ ๋””๋ฒ„๊น… ๋ฐฉ๋ฒ•๋ก  ๋ฐ ๊ทผ๋ณธ ์›์ธ ๋ถ„์„ -- ์‹œ์Šคํ…œ ์ „๋ฐ˜์˜ ์˜ค๋ฅ˜ ์ƒ๊ด€ ๊ด€๊ณ„ ๋ฐ ์ข…์†์„ฑ ๋งคํ•‘ -- ์‹คํŒจ ์กฐ์‚ฌ๋ฅผ ์œ„ํ•œ ๋กœ๊ทธ ๋ถ„์„ ๋ฐ ํŒจํ„ด ์ธ์‹ -- ๋ณต์žกํ•œ ๋ฌธ์ œ์— ๋Œ€ํ•œ ๊ฐ€์„ค ํ˜•์„ฑ ๋ฐ ํ…Œ์ŠคํŠธ -- ์‚ฌ๊ณ  ๋Œ€์‘ ๋ฐ ์‚ฌํ›„ ๋ถ„์„ ์ ˆ์ฐจ - -**์˜ˆ์ œ**: -1. **๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์—ฐ๊ฒฐ ์‹คํŒจ**: ์—ฐ๊ฒฐ ํ’€, ๋„คํŠธ์›Œํฌ ํƒ€์ž„์•„์›ƒ, ๋ฆฌ์†Œ์Šค ์ œํ•œ ์ „๋ฐ˜์˜ ๊ฐ„ํ—์  ์‹คํŒจ ์ถ”์  -2. **๊ฒฐ์ œ ์ฒ˜๋ฆฌ ์˜ค๋ฅ˜**: API ๋กœ๊ทธ, ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์ƒํƒœ, ์™ธ๋ถ€ ์„œ๋น„์Šค ์‘๋‹ต์„ ํ†ตํ•œ ํŠธ๋žœ์žญ์…˜ ์‹คํŒจ ์กฐ์‚ฌ -3. **์„ฑ๋Šฅ ์ €ํ•˜**: ๋ฉ”ํŠธ๋ฆญ ์ƒ๊ด€ ๊ด€๊ณ„, ๋ฆฌ์†Œ์Šค ์‚ฌ์šฉ๋Ÿ‰, ์ฝ”๋“œ ๋ณ€๊ฒฝ์„ ํ†ตํ•œ ์ ์ง„์ ์ธ ๋‘”ํ™” ๋ถ„์„ - -**์ตœ์ ์˜ ํ˜‘์—… ๋Œ€์ƒ**: performance-engineer(์„ฑ๋Šฅ ๋ฌธ์ œ), security-engineer(๋ณด์•ˆ ์‚ฌ๊ณ ), quality-engineer(ํ…Œ์ŠคํŠธ ์‹คํŒจ) - ---- - -### quality-engineer โœ… -**์ „๋ฌธ ๋ถ„์•ผ**: ์ž๋™ํ™” ๋ฐ ์ปค๋ฒ„๋ฆฌ์ง€์— ์ค‘์ ์„ ๋‘” ํฌ๊ด„์ ์ธ ํ…Œ์ŠคํŒ… ์ „๋žต ๋ฐ ํ’ˆ์งˆ ๋ณด์ฆ - -**์ž๋™ ํ™œ์„ฑํ™”**: -- ํ‚ค์›Œ๋“œ: "test", "testing", "quality", "QA", "validation", "coverage", "automation" -- ์ปจํ…์ŠคํŠธ: ํ…Œ์ŠคํŠธ ๊ณ„ํš, ํ’ˆ์งˆ ๊ฒŒ์ดํŠธ, ๊ฒ€์ฆ ์š”๊ตฌ์‚ฌํ•ญ -- ํ’ˆ์งˆ ์šฐ๋ ค: ์ฝ”๋“œ ์ปค๋ฒ„๋ฆฌ์ง€ <80%, ํ…Œ์ŠคํŠธ ์ž๋™ํ™” ๋ถ€์กฑ, ํ’ˆ์งˆ ๋ฌธ์ œ - -**์—ญ๋Ÿ‰**: -- ํ…Œ์ŠคํŠธ ์ „๋žต ์„ค๊ณ„(๋‹จ์œ„, ํ†ตํ•ฉ, e2e, ์„ฑ๋Šฅ ํ…Œ์ŠคํŒ…) -- ํ…Œ์ŠคํŠธ ์ž๋™ํ™” ํ”„๋ ˆ์ž„์›Œํฌ ๊ตฌํ˜„ ๋ฐ CI/CD ํ†ตํ•ฉ -- ํ’ˆ์งˆ ๋ฉ”ํŠธ๋ฆญ ์ •์˜ ๋ฐ ๋ชจ๋‹ˆํ„ฐ๋ง(์ปค๋ฒ„๋ฆฌ์ง€, ๊ฒฐํ•จ๋ฅ ) -- ์—ฃ์ง€ ์ผ€์ด์Šค ์‹๋ณ„ ๋ฐ ๊ฒฝ๊ณ„ ํ…Œ์ŠคํŒ… ์‹œ๋‚˜๋ฆฌ์˜ค -- ์ ‘๊ทผ์„ฑ ํ…Œ์ŠคํŒ… ๋ฐ ๊ทœ์ • ์ค€์ˆ˜ ๊ฒ€์ฆ - -**์˜ˆ์ œ**: -1. **์ „์ž์ƒ๊ฑฐ๋ž˜ ํ…Œ์ŠคํŒ…**: ์‚ฌ์šฉ์ž ํ๋ฆ„, ๊ฒฐ์ œ ์ฒ˜๋ฆฌ, ์žฌ๊ณ  ๊ด€๋ฆฌ๋ฅผ ๋‹ค๋ฃจ๋Š” ํฌ๊ด„์ ์ธ ํ…Œ์ŠคํŠธ ์Šค์œ„ํŠธ -2. **API ํ…Œ์ŠคํŒ…**: REST/GraphQL API์— ๋Œ€ํ•œ ์ž๋™ํ™”๋œ ๊ณ„์•ฝ ํ…Œ์ŠคํŒ…, ๋ถ€ํ•˜ ํ…Œ์ŠคํŒ…, ๋ณด์•ˆ ํ…Œ์ŠคํŒ… -3. **์ ‘๊ทผ์„ฑ ๊ฒ€์ฆ**: ์ž๋™ํ™” ๋ฐ ์ˆ˜๋™ ์ ‘๊ทผ์„ฑ ๊ฐ์‚ฌ๋ฅผ ํ†ตํ•œ WCAG 2.1 ๊ทœ์ • ์ค€์ˆ˜ ํ…Œ์ŠคํŒ… - -**์ตœ์ ์˜ ํ˜‘์—… ๋Œ€์ƒ**: security-engineer(๋ณด์•ˆ ํ…Œ์ŠคํŒ…), performance-engineer(๋ถ€ํ•˜ ํ…Œ์ŠคํŒ…), frontend-architect(UI ํ…Œ์ŠคํŒ…) - ---- - -### refactoring-expert ๐Ÿ”ง -**์ „๋ฌธ ๋ถ„์•ผ**: ์ฒด๊ณ„์ ์ธ ๋ฆฌํŒฉํ† ๋ง ๋ฐ ๊ธฐ์ˆ  ๋ถ€์ฑ„ ๊ด€๋ฆฌ๋ฅผ ํ†ตํ•œ ์ฝ”๋“œ ํ’ˆ์งˆ ๊ฐœ์„  - -**์ž๋™ ํ™œ์„ฑํ™”**: -- ํ‚ค์›Œ๋“œ: "refactor", "clean code", "technical debt", "SOLID", "maintainability", "code smell" -- ์ปจํ…์ŠคํŠธ: ๋ ˆ๊ฑฐ์‹œ ์ฝ”๋“œ ๊ฐœ์„ , ์•„ํ‚คํ…์ฒ˜ ์—…๋ฐ์ดํŠธ, ์ฝ”๋“œ ํ’ˆ์งˆ ๋ฌธ์ œ -- ํ’ˆ์งˆ ์ง€ํ‘œ: ๋†’์€ ๋ณต์žก์„ฑ, ์ค‘๋ณต ์ฝ”๋“œ, ๋‚ฎ์€ ํ…Œ์ŠคํŠธ ์ปค๋ฒ„๋ฆฌ์ง€ - -**์—ญ๋Ÿ‰**: -- SOLID ์›์น™ ์ ์šฉ ๋ฐ ๋””์ž์ธ ํŒจํ„ด ๊ตฌํ˜„ -- ์ฝ”๋“œ ๋ƒ„์ƒˆ ์‹๋ณ„ ๋ฐ ์ฒด๊ณ„์ ์ธ ์ œ๊ฑฐ -- ๋ ˆ๊ฑฐ์‹œ ์ฝ”๋“œ ํ˜„๋Œ€ํ™” ์ „๋žต ๋ฐ ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜ ๊ณ„ํš -- ๊ธฐ์ˆ  ๋ถ€์ฑ„ ํ‰๊ฐ€ ๋ฐ ์šฐ์„ ์ˆœ์œ„ ํ”„๋ ˆ์ž„์›Œํฌ -- ์ฝ”๋“œ ๊ตฌ์กฐ ๊ฐœ์„  ๋ฐ ์•„ํ‚คํ…์ฒ˜ ๋ฆฌํŒฉํ† ๋ง - -**์˜ˆ์ œ**: -1. **๋ ˆ๊ฑฐ์‹œ ํ˜„๋Œ€ํ™”**: ๋ชจ๋†€๋ฆฌ์‹ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ํ…Œ์ŠคํŠธ ๊ฐ€๋Šฅ์„ฑ์ด ํ–ฅ์ƒ๋œ ๋ชจ๋“ˆํ˜• ์•„ํ‚คํ…์ฒ˜๋กœ ๋ณ€ํ™˜ -2. **๋””์ž์ธ ํŒจํ„ด**: ๊ฒฐ์ œ ์ฒ˜๋ฆฌ์— Strategy ํŒจํ„ด ๊ตฌํ˜„์œผ๋กœ ๊ฒฐํ•ฉ๋„ ๊ฐ์†Œ ๋ฐ ํ™•์žฅ์„ฑ ํ–ฅ์ƒ -3. **์ฝ”๋“œ ์ •๋ฆฌ**: ์ค‘๋ณต ์ฝ”๋“œ ์ œ๊ฑฐ, ๋ช…๋ช… ๊ทœ์น™ ๊ฐœ์„ , ์žฌ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ ์ปดํฌ๋„ŒํŠธ ์ถ”์ถœ - -**์ตœ์ ์˜ ํ˜‘์—… ๋Œ€์ƒ**: system-architect(์•„ํ‚คํ…์ฒ˜ ๊ฐœ์„ ), quality-engineer(ํ…Œ์ŠคํŒ… ์ „๋žต), python-expert(์–ธ์–ด๋ณ„ ํŒจํ„ด) - -### ์ „๋ฌธ ๊ฐœ๋ฐœ ์—์ด์ „ํŠธ ๐ŸŽฏ - -### python-expert ๐Ÿ -**์ „๋ฌธ ๋ถ„์•ผ**: ํ˜„๋Œ€์ ์ธ ํ”„๋ ˆ์ž„์›Œํฌ์™€ ์„ฑ๋Šฅ์„ ๊ฐ•์กฐํ•˜๋Š” ํ”„๋กœ๋•์…˜๊ธ‰ Python ๊ฐœ๋ฐœ - -**์ž๋™ ํ™œ์„ฑํ™”**: -- ํ‚ค์›Œ๋“œ: "Python", "Django", "FastAPI", "Flask", "asyncio", "pandas", "pytest" -- ํŒŒ์ผ ์œ ํ˜•: .py, requirements.txt, pyproject.toml, Pipfile -- ์ปจํ…์ŠคํŠธ: Python ๊ฐœ๋ฐœ ์ž‘์—…, API ๊ฐœ๋ฐœ, ๋ฐ์ดํ„ฐ ์ฒ˜๋ฆฌ, ํ…Œ์ŠคํŒ… - -**์—ญ๋Ÿ‰**: -- ํ˜„๋Œ€์ ์ธ Python ์•„ํ‚คํ…์ฒ˜ ํŒจํ„ด ๋ฐ ํ”„๋ ˆ์ž„์›Œํฌ ์„ ํƒ -- asyncio ๋ฐ concurrent futures๋ฅผ ์‚ฌ์šฉํ•œ ๋น„๋™๊ธฐ ํ”„๋กœ๊ทธ๋ž˜๋ฐ -- ํ”„๋กœํŒŒ์ผ๋ง ๋ฐ ์•Œ๊ณ ๋ฆฌ์ฆ˜ ๊ฐœ์„ ์„ ํ†ตํ•œ ์„ฑ๋Šฅ ์ตœ์ ํ™” -- pytest, ํ”ฝ์Šค์ฒ˜, ํ…Œ์ŠคํŠธ ์ž๋™ํ™”๋ฅผ ์‚ฌ์šฉํ•œ ํ…Œ์ŠคํŒ… ์ „๋žต -- pip, poetry, Docker๋ฅผ ์‚ฌ์šฉํ•œ ํŒจํ‚ค์ง€ ๊ด€๋ฆฌ ๋ฐ ๋ฐฐํฌ - -**์˜ˆ์ œ**: -1. **FastAPI ๋งˆ์ดํฌ๋กœ์„œ๋น„์Šค**: Pydantic ๊ฒ€์ฆ, ์˜์กด์„ฑ ์ฃผ์ž…, OpenAPI ๋ฌธ์„œ๋ฅผ ๊ฐ–์ถ˜ ๊ณ ์„ฑ๋Šฅ ๋น„๋™๊ธฐ API -2. **๋ฐ์ดํ„ฐ ํŒŒ์ดํ”„๋ผ์ธ**: ๋Œ€๊ทœ๋ชจ ๋ฐ์ดํ„ฐ์…‹์— ๋Œ€ํ•œ ์˜ค๋ฅ˜ ์ฒ˜๋ฆฌ, ๋กœ๊น…, ๋ณ‘๋ ฌ ์ฒ˜๋ฆฌ๋ฅผ ๊ฐ–์ถ˜ Pandas ๊ธฐ๋ฐ˜ ETL -3. **Django ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜**: ์‚ฌ์šฉ์ž ์ •์˜ ์‚ฌ์šฉ์ž ๋ชจ๋ธ, API ์—”๋“œํฌ์ธํŠธ, ํฌ๊ด„์ ์ธ ํ…Œ์ŠคํŠธ ์ปค๋ฒ„๋ฆฌ์ง€๋ฅผ ๊ฐ–์ถ˜ ํ’€์Šคํƒ ์›น ์•ฑ - -**์ตœ์ ์˜ ํ˜‘์—… ๋Œ€์ƒ**: backend-architect(API ์„ค๊ณ„), quality-engineer(ํ…Œ์ŠคํŒ…), performance-engineer(์ตœ์ ํ™”) - ---- - -### requirements-analyst ๐Ÿ“ -**์ „๋ฌธ ๋ถ„์•ผ**: ์ฒด๊ณ„์ ์ธ ์ดํ•ด๊ด€๊ณ„์ž ๋ถ„์„์„ ํ†ตํ•œ ์š”๊ตฌ์‚ฌํ•ญ ๋ฐœ๊ฒฌ ๋ฐ ์‚ฌ์–‘ ๊ฐœ๋ฐœ - -**์ž๋™ ํ™œ์„ฑํ™”**: -- ํ‚ค์›Œ๋“œ: "requirements", "specification", "PRD", "user story", "functional", "scope", "stakeholder" -- ์ปจํ…์ŠคํŠธ: ํ”„๋กœ์ ํŠธ ์‹œ์ž‘, ๋ถˆ๋ช…ํ™•ํ•œ ์š”๊ตฌ์‚ฌํ•ญ, ๋ฒ”์œ„ ์ •์˜ ํ•„์š” -- ๋ณต์žก์„ฑ: ๋‹ค์ค‘ ์ดํ•ด๊ด€๊ณ„์ž ํ”„๋กœ์ ํŠธ, ๋ถˆ๋ช…ํ™•ํ•œ ๋ชฉํ‘œ, ์ƒ์ถฉํ•˜๋Š” ์š”๊ตฌ์‚ฌํ•ญ - -**์—ญ๋Ÿ‰**: -- ์ดํ•ด๊ด€๊ณ„์ž ์ธํ„ฐ๋ทฐ ๋ฐ ์›Œํฌ์ˆ์„ ํ†ตํ•œ ์š”๊ตฌ์‚ฌํ•ญ ๋„์ถœ -- ์Šน์ธ ๊ธฐ์ค€ ๋ฐ ์™„๋ฃŒ ์ •์˜๋ฅผ ๊ฐ–์ถ˜ ์‚ฌ์šฉ์ž ์Šคํ† ๋ฆฌ ์ž‘์„ฑ -- ๊ธฐ๋Šฅ ๋ฐ ๋น„๊ธฐ๋Šฅ ์‚ฌ์–‘ ๋ฌธ์„œํ™” -- ์ดํ•ด๊ด€๊ณ„์ž ๋ถ„์„ ๋ฐ ์š”๊ตฌ์‚ฌํ•ญ ์šฐ์„ ์ˆœ์œ„ ํ”„๋ ˆ์ž„์›Œํฌ -- ๋ฒ”์œ„ ๊ด€๋ฆฌ ๋ฐ ๋ณ€๊ฒฝ ์ œ์–ด ํ”„๋กœ์„ธ์Šค - -**์˜ˆ์ œ**: -1. **์ œํ’ˆ ์š”๊ตฌ์‚ฌํ•ญ ๋ฌธ์„œ**: ์‚ฌ์šฉ์ž ํŽ˜๋ฅด์†Œ๋‚˜, ๊ธฐ๋Šฅ ์‚ฌ์–‘, ์„ฑ๊ณต ๋ฉ”ํŠธ๋ฆญ์„ ํฌํ•จํ•œ ํ•€ํ…Œํฌ ๋ชจ๋ฐ”์ผ ์•ฑ ํฌ๊ด„์  PRD -2. **API ์‚ฌ์–‘**: ์˜ค๋ฅ˜ ์ฒ˜๋ฆฌ, ๋ณด์•ˆ, ์„ฑ๋Šฅ ๊ธฐ์ค€์„ ๊ฐ–์ถ˜ ๊ฒฐ์ œ ์ฒ˜๋ฆฌ API์— ๋Œ€ํ•œ ์ƒ์„ธ ์š”๊ตฌ์‚ฌํ•ญ -3. **๋งˆ์ด๊ทธ๋ ˆ์ด์…˜ ์š”๊ตฌ์‚ฌํ•ญ**: ๋ฐ์ดํ„ฐ ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜, ์‚ฌ์šฉ์ž ๊ต์œก, ๋กค๋ฐฑ ์ ˆ์ฐจ๋ฅผ ๊ฐ–์ถ˜ ๋ ˆ๊ฑฐ์‹œ ์‹œ์Šคํ…œ ํ˜„๋Œ€ํ™” ์š”๊ตฌ์‚ฌํ•ญ - -**์ตœ์ ์˜ ํ˜‘์—… ๋Œ€์ƒ**: system-architect(๊ธฐ์ˆ ์  ์‹คํ˜„ ๊ฐ€๋Šฅ์„ฑ), technical-writer(๋ฌธ์„œํ™”), learning-guide(์‚ฌ์šฉ์ž ์•ˆ๋‚ด) - -### ์ปค๋ฎค๋‹ˆ์ผ€์ด์…˜ ๋ฐ ํ•™์Šต ์—์ด์ „ํŠธ ๐Ÿ“š - -### technical-writer ๐Ÿ“š -**์ „๋ฌธ ๋ถ„์•ผ**: ๋Œ€์ƒ ๋ถ„์„ ๋ฐ ๋ช…ํ™•์„ฑ์— ์ค‘์ ์„ ๋‘” ๊ธฐ์ˆ  ๋ฌธ์„œํ™” ๋ฐ ์ปค๋ฎค๋‹ˆ์ผ€์ด์…˜ - -**์ž๋™ ํ™œ์„ฑํ™”**: -- ํ‚ค์›Œ๋“œ: "documentation", "readme", "API docs", "user guide", "technical writing", "manual" -- ์ปจํ…์ŠคํŠธ: ๋ฌธ์„œํ™” ์š”์ฒญ, API ๋ฌธ์„œํ™”, ์‚ฌ์šฉ์ž ๊ฐ€์ด๋“œ, ๊ธฐ์ˆ  ์„ค๋ช… -- ํŒŒ์ผ ์œ ํ˜•: .md, .rst, API ์ŠคํŽ™, ๋ฌธ์„œ ํŒŒ์ผ - -**์—ญ๋Ÿ‰**: -- ๊ธฐ์ˆ  ๋ฌธ์„œํ™” ์•„ํ‚คํ…์ฒ˜ ๋ฐ ์ •๋ณด ์„ค๊ณ„ -- ๋‹ค์–‘ํ•œ ๊ธฐ์ˆ  ์ˆ˜์ค€์— ๋Œ€ํ•œ ๋Œ€์ƒ ๋ถ„์„ ๋ฐ ์ฝ˜ํ…์ธ  ํƒ€๊ฒŸํŒ… -- ์ž‘๋™ ์˜ˆ์ œ ๋ฐ ํ†ตํ•ฉ ์ง€์นจ์„ ํฌํ•จํ•œ API ๋ฌธ์„œํ™” -- ๋‹จ๊ณ„๋ณ„ ์ ˆ์ฐจ ๋ฐ ๋ฌธ์ œ ํ•ด๊ฒฐ์„ ํฌํ•จํ•œ ์‚ฌ์šฉ์ž ๊ฐ€์ด๋“œ ์ž‘์„ฑ -- ์ ‘๊ทผ์„ฑ ํ‘œ์ค€ ์ ์šฉ ๋ฐ ํฌ์šฉ์  ์–ธ์–ด ์‚ฌ์šฉ - -**์˜ˆ์ œ**: -1. **API ๋ฌธ์„œํ™”**: ์ธ์ฆ, ์—”๋“œํฌ์ธํŠธ, ์˜ˆ์ œ, SDK ํ†ตํ•ฉ ๊ฐ€์ด๋“œ๋ฅผ ํฌํ•จํ•œ ํฌ๊ด„์ ์ธ REST API ๋ฌธ์„œ -2. **์‚ฌ์šฉ์ž ๋งค๋‰ด์–ผ**: ์Šคํฌ๋ฆฐ์ƒท, ๋ฌธ์ œ ํ•ด๊ฒฐ, FAQ ์„น์…˜์„ ํฌํ•จํ•œ ๋‹จ๊ณ„๋ณ„ ์„ค์น˜ ๋ฐ ๊ตฌ์„ฑ ๊ฐ€์ด๋“œ -3. **๊ธฐ์ˆ  ์‚ฌ์–‘**: ๋‹ค์ด์–ด๊ทธ๋žจ, ๋ฐ์ดํ„ฐ ํ๋ฆ„, ๊ตฌํ˜„ ์„ธ๋ถ€์‚ฌํ•ญ์„ ํฌํ•จํ•œ ์‹œ์Šคํ…œ ์•„ํ‚คํ…์ฒ˜ ๋ฌธ์„œ - -**์ตœ์ ์˜ ํ˜‘์—… ๋Œ€์ƒ**: requirements-analyst(์‚ฌ์–‘ ๋ช…ํ™•์„ฑ), learning-guide(๊ต์œก ์ฝ˜ํ…์ธ ), frontend-architect(UI ๋ฌธ์„œํ™”) - ---- - -### learning-guide ๐ŸŽ“ -**์ „๋ฌธ ๋ถ„์•ผ**: ๊ธฐ์ˆ  ๊ฐœ๋ฐœ ๋ฐ ๋ฉ˜ํ† ์‹ญ์— ์ค‘์ ์„ ๋‘” ๊ต์œก ์ฝ˜ํ…์ธ  ์„ค๊ณ„ ๋ฐ ์ ์ง„์  ํ•™์Šต - -**์ž๋™ ํ™œ์„ฑํ™”**: -- ํ‚ค์›Œ๋“œ: "explain", "learn", "tutorial", "beginner", "teaching", "education", "training" -- ์ปจํ…์ŠคํŠธ: ๊ต์œก ์š”์ฒญ, ๊ฐœ๋… ์„ค๋ช…, ๊ธฐ์ˆ  ๊ฐœ๋ฐœ, ํ•™์Šต ๊ฒฝ๋กœ -- ๋ณต์žก์„ฑ: ๋‹จ๊ณ„๋ณ„ ๋ถ„ํ•ด ๋ฐ ์ ์ง„์  ์ดํ•ด๊ฐ€ ํ•„์š”ํ•œ ๋ณต์žกํ•œ ์ฃผ์ œ - -**์—ญ๋Ÿ‰**: -- ์ ์ง„์  ๊ธฐ์ˆ  ๊ฐœ๋ฐœ์„ ๊ฐ–์ถ˜ ํ•™์Šต ๊ฒฝ๋กœ ์„ค๊ณ„ -- ์œ ์ถ” ๋ฐ ์˜ˆ์ œ๋ฅผ ํ†ตํ•œ ๋ณต์žกํ•œ ๊ฐœ๋… ์„ค๋ช… -- ์‹ค์Šต ์—ฐ์Šต์„ ํฌํ•จํ•œ ๋Œ€ํ™”ํ˜• ํŠœํ† ๋ฆฌ์–ผ ์ƒ์„ฑ -- ๊ธฐ์ˆ  ํ‰๊ฐ€ ๋ฐ ์—ญ๋Ÿ‰ ํ‰๊ฐ€ ํ”„๋ ˆ์ž„์›Œํฌ -- ๋ฉ˜ํ† ์‹ญ ์ „๋žต ๋ฐ ๊ฐœ์ธํ™”๋œ ํ•™์Šต ์ ‘๊ทผ๋ฒ• - -**์˜ˆ์ œ**: -1. **ํ”„๋กœ๊ทธ๋ž˜๋ฐ ํŠœํ† ๋ฆฌ์–ผ**: ์‹ค์Šต ์—ฐ์Šต, ์ฝ”๋“œ ์˜ˆ์ œ, ์ ์ง„์  ๋ณต์žก์„ฑ์„ ํฌํ•จํ•œ ๋Œ€ํ™”ํ˜• React ํŠœํ† ๋ฆฌ์–ผ -2. **๊ฐœ๋… ์„ค๋ช…**: ์‹œ๊ฐ์  ๋‹ค์ด์–ด๊ทธ๋žจ ๋ฐ ์—ฐ์Šต ๋ฌธ์ œ๋ฅผ ํฌํ•จํ•œ ์‹ค์ œ ์˜ˆ์ œ๋ฅผ ํ†ตํ•œ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์ •๊ทœํ™” ์„ค๋ช… -3. **๊ธฐ์ˆ  ํ‰๊ฐ€**: ์‹ค์ œ ํ”„๋กœ์ ํŠธ ๋ฐ ํ”ผ๋“œ๋ฐฑ์„ ํฌํ•จํ•œ ํ’€์Šคํƒ ๊ฐœ๋ฐœ์„ ์œ„ํ•œ ํฌ๊ด„์ ์ธ ํ‰๊ฐ€ ํ”„๋ ˆ์ž„์›Œํฌ - -**์ตœ์ ์˜ ํ˜‘์—… ๋Œ€์ƒ**: technical-writer(๊ต์œก ๋ฌธ์„œํ™”), frontend-architect(๋Œ€ํ™”ํ˜• ํ•™์Šต), requirements-analyst(ํ•™์Šต ๋ชฉํ‘œ) - ---- - -## ์—์ด์ „ํŠธ ์กฐ์ • ๋ฐ ํ†ตํ•ฉ ๐Ÿค - -### ์กฐ์ • ํŒจํ„ด - -**์•„ํ‚คํ…์ฒ˜ ํŒ€**: -- **ํ’€์Šคํƒ ๊ฐœ๋ฐœ**: frontend-architect + backend-architect + security-engineer + quality-engineer -- **์‹œ์Šคํ…œ ์„ค๊ณ„**: system-architect + devops-architect + performance-engineer + security-engineer -- **๋ ˆ๊ฑฐ์‹œ ํ˜„๋Œ€ํ™”**: refactoring-expert + system-architect + quality-engineer + technical-writer - -**ํ’ˆ์งˆ ํŒ€**: -- **๋ณด์•ˆ ๊ฐ์‚ฌ**: security-engineer + quality-engineer + root-cause-analyst + requirements-analyst -- **์„ฑ๋Šฅ ์ตœ์ ํ™”**: performance-engineer + system-architect + devops-architect + root-cause-analyst -- **ํ…Œ์ŠคํŒ… ์ „๋žต**: quality-engineer + security-engineer + performance-engineer + frontend-architect - -**์ปค๋ฎค๋‹ˆ์ผ€์ด์…˜ ํŒ€**: -- **๋ฌธ์„œํ™” ํ”„๋กœ์ ํŠธ**: technical-writer + requirements-analyst + learning-guide + ๋„๋ฉ”์ธ ์ „๋ฌธ๊ฐ€ -- **ํ•™์Šต ํ”Œ๋žซํผ**: learning-guide + frontend-architect + technical-writer + quality-engineer -- **API ๋ฌธ์„œํ™”**: backend-architect + technical-writer + security-engineer + quality-engineer - -### MCP ์„œ๋ฒ„ ํ†ตํ•ฉ - -**MCP ์„œ๋ฒ„๋ฅผ ํ†ตํ•œ ํ–ฅ์ƒ๋œ ๊ธฐ๋Šฅ**: -- **Context7**: ๋ชจ๋“  ์•„ํ‚คํ…ํŠธ ๋ฐ ์ „๋ฌธ๊ฐ€๋ฅผ ์œ„ํ•œ ๊ณต์‹ ๋ฌธ์„œํ™” ํŒจํ„ด -- **Sequential**: root-cause-analyst, system-architect, performance-engineer๋ฅผ ์œ„ํ•œ ๋‹ค๋‹จ๊ณ„ ๋ถ„์„ -- **Magic**: frontend-architect, learning-guide ๋Œ€ํ™”ํ˜• ์ฝ˜ํ…์ธ ๋ฅผ ์œ„ํ•œ UI ์ƒ์„ฑ -- **Playwright**: quality-engineer๋ฅผ ์œ„ํ•œ ๋ธŒ๋ผ์šฐ์ € ํ…Œ์ŠคํŒ…, frontend-architect๋ฅผ ์œ„ํ•œ ์ ‘๊ทผ์„ฑ ๊ฒ€์ฆ -- **Morphllm**: refactoring-expert๋ฅผ ์œ„ํ•œ ์ฝ”๋“œ ๋ณ€ํ™˜, python-expert๋ฅผ ์œ„ํ•œ ๋Œ€๋Ÿ‰ ๋ณ€๊ฒฝ -- **Serena**: ๋ชจ๋“  ์—์ด์ „ํŠธ๋ฅผ ์œ„ํ•œ ํ”„๋กœ์ ํŠธ ๋ฉ”๋ชจ๋ฆฌ, ์„ธ์…˜ ์ „๋ฐ˜์˜ ์ปจํ…์ŠคํŠธ ๋ณด์กด - -### ์—์ด์ „ํŠธ ํ™œ์„ฑํ™” ๋ฌธ์ œ ํ•ด๊ฒฐ - -## ๋ฌธ์ œ ํ•ด๊ฒฐ - -๋ฌธ์ œ ํ•ด๊ฒฐ ๋„์›€๋ง์€ ๋‹ค์Œ์„ ์ฐธ์กฐํ•˜์„ธ์š”: -- [์ผ๋ฐ˜์ ์ธ ๋ฌธ์ œ](../Reference/common-issues.md) - ์ž์ฃผ ๋ฐœ์ƒํ•˜๋Š” ๋ฌธ์ œ์— ๋Œ€ํ•œ ๋น ๋ฅธ ์ˆ˜์ • -- [๋ฌธ์ œ ํ•ด๊ฒฐ ๊ฐ€์ด๋“œ](../Reference/troubleshooting.md) - ํฌ๊ด„์ ์ธ ๋ฌธ์ œ ํ•ด๊ฒฐ - -### ์ผ๋ฐ˜์ ์ธ ๋ฌธ์ œ -- **์—์ด์ „ํŠธ ํ™œ์„ฑํ™” ์—†์Œ**: ๋„๋ฉ”์ธ ํ‚ค์›Œ๋“œ ์‚ฌ์šฉ: "security", "performance", "frontend" -- **์ž˜๋ชป๋œ ์—์ด์ „ํŠธ ์„ ํƒ**: ์—์ด์ „ํŠธ ๋ฌธ์„œ์˜ ํŠธ๋ฆฌ๊ฑฐ ํ‚ค์›Œ๋“œ ํ™•์ธ -- **๋„ˆ๋ฌด ๋งŽ์€ ์—์ด์ „ํŠธ**: ์ฃผ์š” ๋„๋ฉ”์ธ์— ํ‚ค์›Œ๋“œ ์ง‘์ค‘ ๋˜๋Š” `/sc:focus [domain]` ์‚ฌ์šฉ -- **์—์ด์ „ํŠธ๊ฐ€ ์กฐ์ •ํ•˜์ง€ ์•Š์Œ**: ์ž‘์—… ๋ณต์žก์„ฑ ์ฆ๊ฐ€ ๋˜๋Š” ๋‹ค์ค‘ ๋„๋ฉ”์ธ ํ‚ค์›Œ๋“œ ์‚ฌ์šฉ -- **์—์ด์ „ํŠธ ์ „๋ฌธ ์ง€์‹ ๋ถˆ์ผ์น˜**: ๋” ๊ตฌ์ฒด์ ์ธ ๊ธฐ์ˆ  ์šฉ์–ด ์‚ฌ์šฉ - -### ์ฆ‰๊ฐ์ ์ธ ์ˆ˜์ • -- **์—์ด์ „ํŠธ ํ™œ์„ฑํ™” ๊ฐ•์ œ**: ์š”์ฒญ์— ๋ช…์‹œ์  ๋„๋ฉ”์ธ ํ‚ค์›Œ๋“œ ์‚ฌ์šฉ -- **์—์ด์ „ํŠธ ์„ ํƒ ์žฌ์„ค์ •**: Claude Code ์„ธ์…˜์„ ์žฌ์‹œ์ž‘ํ•˜์—ฌ ์—์ด์ „ํŠธ ์ƒํƒœ ์žฌ์„ค์ • -- **์—์ด์ „ํŠธ ํŒจํ„ด ํ™•์ธ**: ์—์ด์ „ํŠธ ๋ฌธ์„œ์˜ ํŠธ๋ฆฌ๊ฑฐ ํ‚ค์›Œ๋“œ ๊ฒ€ํ†  -- **๊ธฐ๋ณธ ํ™œ์„ฑํ™” ํ…Œ์ŠคํŠธ**: `/sc:implement "security auth"`๋กœ security-engineer ํ…Œ์ŠคํŠธ - -### ์—์ด์ „ํŠธ๋ณ„ ๋ฌธ์ œ ํ•ด๊ฒฐ - -**๋ณด์•ˆ ์—์ด์ „ํŠธ ์—†์Œ:** -```bash -# ๋ฌธ์ œ: ๋ณด์•ˆ ์šฐ๋ ค๊ฐ€ security-engineer๋ฅผ ํŠธ๋ฆฌ๊ฑฐํ•˜์ง€ ์•Š์Œ -# ๋น ๋ฅธ ์ˆ˜์ •: ๋ช…์‹œ์  ๋ณด์•ˆ ํ‚ค์›Œ๋“œ ์‚ฌ์šฉ -"implement authentication" # ์ผ๋ฐ˜์  - ํŠธ๋ฆฌ๊ฑฐํ•˜์ง€ ์•Š์„ ์ˆ˜ ์žˆ์Œ -"implement JWT authentication security" # ๋ช…์‹œ์  - security-engineer ํŠธ๋ฆฌ๊ฑฐ -"secure user login with encryption" # ๋ณด์•ˆ ์ค‘์‹ฌ - security-engineer ํŠธ๋ฆฌ๊ฑฐ -``` - -**์„ฑ๋Šฅ ์—์ด์ „ํŠธ ์—†์Œ:** -```bash -# ๋ฌธ์ œ: ์„ฑ๋Šฅ ๋ฌธ์ œ๊ฐ€ performance-engineer๋ฅผ ํŠธ๋ฆฌ๊ฑฐํ•˜์ง€ ์•Š์Œ -# ๋น ๋ฅธ ์ˆ˜์ •: ์„ฑ๋Šฅ๋ณ„ ์šฉ์–ด ์‚ฌ์šฉ -"make it faster" # ๋ชจํ˜ธํ•จ - ํŠธ๋ฆฌ๊ฑฐํ•˜์ง€ ์•Š์„ ์ˆ˜ ์žˆ์Œ -"optimize slow database queries" # ๊ตฌ์ฒด์  - performance-engineer ํŠธ๋ฆฌ๊ฑฐ -"reduce API latency and bottlenecks" # ์„ฑ๋Šฅ ์ค‘์‹ฌ - performance-engineer ํŠธ๋ฆฌ๊ฑฐ -``` - -**์•„ํ‚คํ…์ฒ˜ ์—์ด์ „ํŠธ ์—†์Œ:** -```bash -# ๋ฌธ์ œ: ์‹œ์Šคํ…œ ์„ค๊ณ„๊ฐ€ ์•„ํ‚คํ…์ฒ˜ ์—์ด์ „ํŠธ๋ฅผ ํŠธ๋ฆฌ๊ฑฐํ•˜์ง€ ์•Š์Œ -# ๋น ๋ฅธ ์ˆ˜์ •: ์•„ํ‚คํ…์ฒ˜ ํ‚ค์›Œ๋“œ ์‚ฌ์šฉ -"build an app" # ์ผ๋ฐ˜์  - ๊ธฐ๋ณธ ์—์ด์ „ํŠธ ํŠธ๋ฆฌ๊ฑฐ -"design microservices architecture" # ๊ตฌ์ฒด์  - system-architect ํŠธ๋ฆฌ๊ฑฐ -"scalable distributed system design" # ์•„ํ‚คํ…์ฒ˜ ์ค‘์‹ฌ - system-architect ํŠธ๋ฆฌ๊ฑฐ -``` - -**์ž˜๋ชป๋œ ์—์ด์ „ํŠธ ์กฐํ•ฉ:** -```bash -# ๋ฌธ์ œ: ๋ฐฑ์—”๋“œ ์ž‘์—…์— ํ”„๋ก ํŠธ์—”๋“œ ์—์ด์ „ํŠธ ํ™œ์„ฑํ™” -# ๋น ๋ฅธ ์ˆ˜์ •: ๋„๋ฉ”์ธ๋ณ„ ์šฉ์–ด ์‚ฌ์šฉ -"create user interface" # frontend-architect๋ฅผ ํŠธ๋ฆฌ๊ฑฐํ•  ์ˆ˜ ์žˆ์Œ -"create REST API endpoints" # ๊ตฌ์ฒด์  - backend-architect ํŠธ๋ฆฌ๊ฑฐ -"implement server-side authentication" # ๋ฐฑ์—”๋“œ ์ค‘์‹ฌ - backend-architect ํŠธ๋ฆฌ๊ฑฐ -``` - -### ์ง€์› ์ˆ˜์ค€ - -**๋น ๋ฅธ ์ˆ˜์ •:** -- ์—์ด์ „ํŠธ ํŠธ๋ฆฌ๊ฑฐ ํ…Œ์ด๋ธ”์˜ ๋ช…์‹œ์  ๋„๋ฉ”์ธ ํ‚ค์›Œ๋“œ ์‚ฌ์šฉ -- Claude Code ์„ธ์…˜ ์žฌ์‹œ์ž‘ ์‹œ๋„ -- ํ˜ผ๋ž€์„ ํ”ผํ•˜๊ธฐ ์œ„ํ•ด ๋‹จ์ผ ๋„๋ฉ”์ธ์— ์ง‘์ค‘ - -**์ƒ์„ธ ๋„์›€๋ง:** -- ์—์ด์ „ํŠธ ์„ค์น˜ ๋ฌธ์ œ๋Š” [์ผ๋ฐ˜์ ์ธ ๋ฌธ์ œ ๊ฐ€์ด๋“œ](../Reference/common-issues.md) ์ฐธ์กฐ -- ๋Œ€์ƒ ์—์ด์ „ํŠธ์˜ ํŠธ๋ฆฌ๊ฑฐ ํ‚ค์›Œ๋“œ ๊ฒ€ํ†  - -**์ „๋ฌธ๊ฐ€ ์ง€์›:** -- `SuperClaude install --diagnose` ์‚ฌ์šฉ -- ์กฐ์ • ๋ถ„์„์€ [์ง„๋‹จ ์ฐธ์กฐ ๊ฐ€์ด๋“œ](../Reference/diagnostic-reference.md) ์ฐธ์กฐ - -**์ปค๋ฎค๋‹ˆํ‹ฐ ์ง€์›:** -- [GitHub Issues](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues)์—์„œ ๋ฌธ์ œ ๋ณด๊ณ  -- ์˜ˆ์ƒ ๋Œ€๋น„ ์‹ค์ œ ์—์ด์ „ํŠธ ํ™œ์„ฑํ™” ์˜ˆ์ œ ํฌํ•จ - -### ์„ฑ๊ณต ๊ฒ€์ฆ - -์—์ด์ „ํŠธ ์ˆ˜์ • ์ ์šฉ ํ›„ ํ…Œ์ŠคํŠธ: -- [ ] ๋„๋ฉ”์ธ๋ณ„ ์š”์ฒญ์ด ์˜ฌ๋ฐ”๋ฅธ ์—์ด์ „ํŠธ ํ™œ์„ฑํ™” (security โ†’ security-engineer) -- [ ] ๋ณต์žกํ•œ ์ž‘์—…์ด ๋‹ค์ค‘ ์—์ด์ „ํŠธ ์กฐ์ • ํŠธ๋ฆฌ๊ฑฐ (3๊ฐœ ์ด์ƒ ์—์ด์ „ํŠธ) -- [ ] ์—์ด์ „ํŠธ ์ „๋ฌธ ์ง€์‹์ด ์ž‘์—… ์š”๊ตฌ์‚ฌํ•ญ๊ณผ ์ผ์น˜ (API โ†’ backend-architect) -- [ ] ์ ์ ˆํ•œ ๊ฒฝ์šฐ ํ’ˆ์งˆ ์—์ด์ „ํŠธ ์ž๋™ ํฌํ•จ (security, performance, testing) -- [ ] ์‘๋‹ต์— ๋„๋ฉ”์ธ ์ „๋ฌธ ์ง€์‹ ๋ฐ ์ „๋ฌธ ์ง€์‹ ํ‘œ์‹œ - -## ๋น ๋ฅธ ๋ฌธ์ œ ํ•ด๊ฒฐ (๋ ˆ๊ฑฐ์‹œ) -- **์—์ด์ „ํŠธ ํ™œ์„ฑํ™” ์—†์Œ** โ†’ ๋„๋ฉ”์ธ ํ‚ค์›Œ๋“œ ์‚ฌ์šฉ: "security", "performance", "frontend" -- **์ž˜๋ชป๋œ ์—์ด์ „ํŠธ** โ†’ ์—์ด์ „ํŠธ ๋ฌธ์„œ์˜ ํŠธ๋ฆฌ๊ฑฐ ํ‚ค์›Œ๋“œ ํ™•์ธ -- **๋„ˆ๋ฌด ๋งŽ์€ ์—์ด์ „ํŠธ** โ†’ ์ฃผ์š” ๋„๋ฉ”์ธ์— ํ‚ค์›Œ๋“œ ์ง‘์ค‘ -- **์—์ด์ „ํŠธ๊ฐ€ ์กฐ์ •ํ•˜์ง€ ์•Š์Œ** โ†’ ์ž‘์—… ๋ณต์žก์„ฑ ์ฆ๊ฐ€ ๋˜๋Š” ๋‹ค์ค‘ ๋„๋ฉ”์ธ ํ‚ค์›Œ๋“œ ์‚ฌ์šฉ - -**์—์ด์ „ํŠธ๊ฐ€ ํ™œ์„ฑํ™”๋˜์ง€ ์•Š๋‚˜์š”?** -1. **ํ‚ค์›Œ๋“œ ํ™•์ธ**: ๋„๋ฉ”์ธ๋ณ„ ์šฉ์–ด ์‚ฌ์šฉ (์˜ˆ: security-engineer์˜ ๊ฒฝ์šฐ "login"์ด ์•„๋‹Œ "authentication") -2. **์ปจํ…์ŠคํŠธ ์ถ”๊ฐ€**: ํŒŒ์ผ ์œ ํ˜•, ํ”„๋ ˆ์ž„์›Œํฌ ๋˜๋Š” ํŠน์ • ๊ธฐ์ˆ  ํฌํ•จ -3. **๋ณต์žก์„ฑ ์ฆ๊ฐ€**: ๋‹ค์ค‘ ๋„๋ฉ”์ธ ๋ฌธ์ œ๊ฐ€ ๋” ๋งŽ์€ ์—์ด์ „ํŠธ ํŠธ๋ฆฌ๊ฑฐ -4. **์˜ˆ์ œ ์‚ฌ์šฉ**: ์—์ด์ „ํŠธ ์ „๋ฌธ ์ง€์‹๊ณผ ์ผ์น˜ํ•˜๋Š” ๊ตฌ์ฒด์ ์ธ ์‹œ๋‚˜๋ฆฌ์˜ค ์ฐธ์กฐ - -**๋„ˆ๋ฌด ๋งŽ์€ ์—์ด์ „ํŠธ?** -- ์ฃผ์š” ๋„๋ฉ”์ธ ํ•„์š”์— ํ‚ค์›Œ๋“œ ์ง‘์ค‘ -- `/sc:focus [domain]`์„ ์‚ฌ์šฉํ•˜์—ฌ ๋ฒ”์œ„ ์ œํ•œ -- ํŠน์ • ์—์ด์ „ํŠธ๋กœ ์‹œ์ž‘ํ•˜๊ณ  ํ•„์š”์— ๋”ฐ๋ผ ํ™•์žฅ - -**์ž˜๋ชป๋œ ์—์ด์ „ํŠธ?** -- ์—์ด์ „ํŠธ ๋ฌธ์„œ์˜ ํŠธ๋ฆฌ๊ฑฐ ํ‚ค์›Œ๋“œ ๊ฒ€ํ†  -- ๋Œ€์ƒ ๋„๋ฉ”์ธ์— ๋” ๊ตฌ์ฒด์ ์ธ ์šฉ์–ด ์‚ฌ์šฉ -- ๋ช…์‹œ์  ์š”๊ตฌ์‚ฌํ•ญ ๋˜๋Š” ์ œ์•ฝ์กฐ๊ฑด ์ถ”๊ฐ€ - -## ๋น ๋ฅธ ์ฐธ์กฐ ๐Ÿ“‹ - -### ์—์ด์ „ํŠธ ํŠธ๋ฆฌ๊ฑฐ ์กฐํšŒ - -| ํŠธ๋ฆฌ๊ฑฐ ์œ ํ˜• | ํ‚ค์›Œ๋“œ/ํŒจํ„ด | ํ™œ์„ฑํ™”๋œ ์—์ด์ „ํŠธ | -|-------------|-------------------|------------------| -| **๋ณด์•ˆ** | "auth", "security", "vulnerability", "encryption" | security-engineer | -| **์„ฑ๋Šฅ** | "slow", "optimization", "bottleneck", "latency" | performance-engineer | -| **ํ”„๋ก ํŠธ์—”๋“œ** | "UI", "React", "Vue", "component", "responsive" | frontend-architect | -| **๋ฐฑ์—”๋“œ** | "API", "server", "database", "REST", "GraphQL" | backend-architect | -| **ํ…Œ์ŠคํŒ…** | "test", "QA", "validation", "coverage" | quality-engineer | -| **DevOps** | "deploy", "CI/CD", "Docker", "Kubernetes" | devops-architect | -| **์•„ํ‚คํ…์ฒ˜** | "architecture", "microservices", "scalability" | system-architect | -| **Python** | ".py", "Django", "FastAPI", "asyncio" | python-expert | -| **๋ฌธ์ œ** | "bug", "issue", "debugging", "troubleshoot" | root-cause-analyst | -| **์ฝ”๋“œ ํ’ˆ์งˆ** | "refactor", "clean code", "technical debt" | refactoring-expert | -| **๋ฌธ์„œํ™”** | "documentation", "readme", "API docs" | technical-writer | -| **ํ•™์Šต** | "explain", "tutorial", "beginner", "teaching" | learning-guide | -| **์š”๊ตฌ์‚ฌํ•ญ** | "requirements", "PRD", "specification" | requirements-analyst | -| **์—ฐ๊ตฌ** | "research", "investigate", "latest", "current" | deep-research-agent | - -### ๋ช…๋ น์–ด-์—์ด์ „ํŠธ ๋งคํ•‘ - -| ๋ช…๋ น์–ด | ์ฃผ์š” ์—์ด์ „ํŠธ | ์ง€์› ์—์ด์ „ํŠธ | -|---------|----------------|-------------------| -| `/sc:implement` | ๋„๋ฉ”์ธ ์•„ํ‚คํ…ํŠธ (frontend, backend) | security-engineer, quality-engineer | -| `/sc:analyze` | quality-engineer, security-engineer | performance-engineer, root-cause-analyst | -| `/sc:troubleshoot` | root-cause-analyst | ๋„๋ฉ”์ธ ์ „๋ฌธ๊ฐ€, performance-engineer | -| `/sc:improve` | refactoring-expert | quality-engineer, performance-engineer | -| `/sc:document` | technical-writer | ๋„๋ฉ”์ธ ์ „๋ฌธ๊ฐ€, learning-guide | -| `/sc:design` | system-architect | ๋„๋ฉ”์ธ ์•„ํ‚คํ…ํŠธ, requirements-analyst | -| `/sc:test` | quality-engineer | security-engineer, performance-engineer | -| `/sc:explain` | learning-guide | technical-writer, ๋„๋ฉ”์ธ ์ „๋ฌธ๊ฐ€ | -| `/sc:research` | deep-research-agent | ๊ธฐ์ˆ  ์ „๋ฌธ๊ฐ€, learning-guide | - -### ํšจ๊ณผ์ ์ธ ์—์ด์ „ํŠธ ์กฐํ•ฉ - -**๊ฐœ๋ฐœ ์›Œํฌํ”Œ๋กœ์šฐ**: -- ์›น ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜: frontend-architect + backend-architect + security-engineer + quality-engineer + devops-architect -- API ๊ฐœ๋ฐœ: backend-architect + security-engineer + technical-writer + quality-engineer -- ๋ฐ์ดํ„ฐ ํ”Œ๋žซํผ: python-expert + performance-engineer + security-engineer + system-architect - -**๋ถ„์„ ์›Œํฌํ”Œ๋กœ์šฐ**: -- ๋ณด์•ˆ ๊ฐ์‚ฌ: security-engineer + quality-engineer + root-cause-analyst + technical-writer -- ์„ฑ๋Šฅ ์กฐ์‚ฌ: performance-engineer + root-cause-analyst + system-architect + devops-architect -- ๋ ˆ๊ฑฐ์‹œ ํ‰๊ฐ€: refactoring-expert + system-architect + quality-engineer + security-engineer + technical-writer - -**์ปค๋ฎค๋‹ˆ์ผ€์ด์…˜ ์›Œํฌํ”Œ๋กœ์šฐ**: -- ๊ธฐ์ˆ  ๋ฌธ์„œํ™”: technical-writer + requirements-analyst + ๋„๋ฉ”์ธ ์ „๋ฌธ๊ฐ€ + learning-guide -- ๊ต์œก ์ฝ˜ํ…์ธ : learning-guide + technical-writer + frontend-architect + quality-engineer - -## ๋ชจ๋ฒ” ์‚ฌ๋ก€ ๐Ÿ’ก - -### ์‹œ์ž‘ํ•˜๊ธฐ (๊ฐ„๋‹จํ•œ ์ ‘๊ทผ๋ฒ•) - -**์ž์—ฐ์–ด ์šฐ์„ :** -1. **๋ชฉํ‘œ ์„ค๋ช…**: ๋„๋ฉ”์ธ๋ณ„ ํ‚ค์›Œ๋“œ๋ฅผ ์‚ฌ์šฉํ•œ ์ž์—ฐ์–ด ์‚ฌ์šฉ -2. **์ž๋™ ํ™œ์„ฑํ™” ์‹ ๋ขฐ**: ์‹œ์Šคํ…œ์ด ์ž๋™์œผ๋กœ ์ ์ ˆํ•œ ์—์ด์ „ํŠธ๋กœ ๋ผ์šฐํŒ…ํ•˜๋„๋ก ํ—ˆ์šฉ -3. **ํŒจํ„ด์—์„œ ํ•™์Šต**: ๋‹ค์–‘ํ•œ ์š”์ฒญ ์œ ํ˜•์— ๋Œ€ํ•ด ์–ด๋–ค ์—์ด์ „ํŠธ๊ฐ€ ํ™œ์„ฑํ™”๋˜๋Š”์ง€ ๊ด€์ฐฐ -4. **๋ฐ˜๋ณต ๋ฐ ๊ฐœ์„ **: ์ถ”๊ฐ€ ์ „๋ฌธ ์—์ด์ „ํŠธ๋ฅผ ์ฐธ์—ฌ์‹œํ‚ค๊ธฐ ์œ„ํ•ด ๊ตฌ์ฒด์„ฑ ์ถ”๊ฐ€ - -### ์—์ด์ „ํŠธ ์„ ํƒ ์ตœ์ ํ™” - -**ํšจ๊ณผ์ ์ธ ํ‚ค์›Œ๋“œ ์‚ฌ์šฉ:** -- **๊ตฌ์ฒด์  > ์ผ๋ฐ˜์ **: security-engineer๋ฅผ ์œ„ํ•ด "login" ๋Œ€์‹  "authentication" ์‚ฌ์šฉ -- **๊ธฐ์ˆ  ์šฉ์–ด**: ํ”„๋ ˆ์ž„์›Œํฌ ์ด๋ฆ„, ๊ธฐ์ˆ , ํŠน์ • ๊ณผ์ œ ํฌํ•จ -- **์ปจํ…์ŠคํŠธ ๋‹จ์„œ**: ํŒŒ์ผ ์œ ํ˜•, ํ”„๋กœ์ ํŠธ ๋ฒ”์œ„, ๋ณต์žก์„ฑ ์ง€ํ‘œ ์–ธ๊ธ‰ -- **ํ’ˆ์งˆ ํ‚ค์›Œ๋“œ**: ํฌ๊ด„์ ์ธ ์ปค๋ฒ„๋ฆฌ์ง€๋ฅผ ์œ„ํ•ด "security", "performance", "accessibility" ์ถ”๊ฐ€ - -**์š”์ฒญ ์ตœ์ ํ™” ์˜ˆ์ œ:** -```bash -# ์ผ๋ฐ˜์  (์ œํ•œ๋œ ์—์ด์ „ํŠธ ํ™œ์„ฑํ™”) -"๋กœ๊ทธ์ธ ๊ธฐ๋Šฅ ์ˆ˜์ •" - -# ์ตœ์ ํ™”๋จ (๋‹ค์ค‘ ์—์ด์ „ํŠธ ์กฐ์ •) -"์†๋„ ์ œํ•œ ๋ฐ ์ ‘๊ทผ์„ฑ ๊ทœ์ • ์ค€์ˆ˜๋ฅผ ๊ฐ–์ถ˜ ์•ˆ์ „ํ•œ JWT ์ธ์ฆ ๊ตฌํ˜„" -# โ†’ ํŠธ๋ฆฌ๊ฑฐ: security-engineer + backend-architect + frontend-architect + quality-engineer -``` - -### ์ผ๋ฐ˜์ ์ธ ์‚ฌ์šฉ ํŒจํ„ด - -**๊ฐœ๋ฐœ ์›Œํฌํ”Œ๋กœ์šฐ:** -```bash -# ํ’€์Šคํƒ ๊ธฐ๋Šฅ ๊ฐœ๋ฐœ -/sc:implement "์‹ค์‹œ๊ฐ„ ์•Œ๋ฆผ์ด ์žˆ๋Š” ๋ฐ˜์‘ํ˜• ์‚ฌ์šฉ์ž ๋Œ€์‹œ๋ณด๋“œ" -# โ†’ frontend-architect + backend-architect + performance-engineer - -# ๋ฌธ์„œํ™”๋ฅผ ํฌํ•จํ•œ API ๊ฐœ๋ฐœ -/sc:create "ํฌ๊ด„์ ์ธ ๋ฌธ์„œ๊ฐ€ ์žˆ๋Š” ๊ฒฐ์ œ ์ฒ˜๋ฆฌ๋ฅผ ์œ„ํ•œ REST API" -# โ†’ backend-architect + security-engineer + technical-writer + quality-engineer - -# ์„ฑ๋Šฅ ์ตœ์ ํ™” ์กฐ์‚ฌ -/sc:troubleshoot "์‚ฌ์šฉ์ž ๊ฒฝํ—˜์— ์˜ํ–ฅ์„ ๋ฏธ์น˜๋Š” ๋Š๋ฆฐ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์ฟผ๋ฆฌ" -# โ†’ performance-engineer + root-cause-analyst + backend-architect -``` - -**๋ถ„์„ ์›Œํฌํ”Œ๋กœ์šฐ:** -```bash -# ๋ณด์•ˆ ํ‰๊ฐ€ -/sc:analyze "GDPR ๊ทœ์ • ์ค€์ˆ˜ ์ทจ์•ฝ์ ์— ๋Œ€ํ•œ ์ธ์ฆ ์‹œ์Šคํ…œ" -# โ†’ security-engineer + quality-engineer + requirements-analyst - -# ์ฝ”๋“œ ํ’ˆ์งˆ ๊ฒ€ํ†  -/sc:review "ํ˜„๋Œ€ํ™” ๊ธฐํšŒ๋ฅผ ์œ„ํ•œ ๋ ˆ๊ฑฐ์‹œ ์ฝ”๋“œ๋ฒ ์ด์Šค" -# โ†’ refactoring-expert + system-architect + quality-engineer + technical-writer - -# ํ•™์Šต ๋ฐ ์„ค๋ช… -/sc:explain "์‹ค์Šต ์˜ˆ์ œ๊ฐ€ ์žˆ๋Š” ๋งˆ์ดํฌ๋กœ์„œ๋น„์Šค ํŒจํ„ด" -# โ†’ system-architect + learning-guide + technical-writer -``` - -### ๊ณ ๊ธ‰ ์—์ด์ „ํŠธ ์กฐ์ • - -**๋‹ค์ค‘ ๋„๋ฉ”์ธ ํ”„๋กœ์ ํŠธ:** -- **๊ด‘๋ฒ”์œ„ํ•˜๊ฒŒ ์‹œ์ž‘**: ์•„ํ‚คํ…์ฒ˜ ์—์ด์ „ํŠธ๋ฅผ ์ฐธ์—ฌ์‹œํ‚ค๊ธฐ ์œ„ํ•ด ์‹œ์Šคํ…œ ์ˆ˜์ค€ ํ‚ค์›Œ๋“œ๋กœ ์‹œ์ž‘ -- **๊ตฌ์ฒด์„ฑ ์ถ”๊ฐ€**: ์ „๋ฌธ ์—์ด์ „ํŠธ๋ฅผ ํ™œ์„ฑํ™”ํ•˜๊ธฐ ์œ„ํ•ด ๋„๋ฉ”์ธ๋ณ„ ํ•„์š” ํฌํ•จ -- **ํ’ˆ์งˆ ํ†ตํ•ฉ**: ๋ณด์•ˆ, ์„ฑ๋Šฅ, ํ…Œ์ŠคํŒ… ๊ด€์  ์ž๋™ ํฌํ•จ -- **๋ฌธ์„œํ™” ํฌํ•จ**: ํฌ๊ด„์ ์ธ ์ปค๋ฒ„๋ฆฌ์ง€๋ฅผ ์œ„ํ•ด ํ•™์Šต ๋˜๋Š” ๋ฌธ์„œํ™” ํ•„์š” ์ถ”๊ฐ€ - -**์—์ด์ „ํŠธ ์„ ํƒ ๋ฌธ์ œ ํ•ด๊ฒฐ:** - -**๋ฌธ์ œ: ์ž˜๋ชป๋œ ์—์ด์ „ํŠธ ํ™œ์„ฑํ™”** -- ํ•ด๊ฒฐ์ฑ…: ๋” ๊ตฌ์ฒด์ ์ธ ๋„๋ฉ”์ธ ์šฉ์–ด ์‚ฌ์šฉ -- ์˜ˆ์ œ: "database optimization" โ†’ performance-engineer + backend-architect - -**๋ฌธ์ œ: ์—์ด์ „ํŠธ๊ฐ€ ์ถฉ๋ถ„ํ•˜์ง€ ์•Š์Œ** -- ํ•ด๊ฒฐ์ฑ…: ๋ณต์žก์„ฑ ์ง€ํ‘œ ๋ฐ ๊ต์ฐจ ๋„๋ฉ”์ธ ํ‚ค์›Œ๋“œ ์ฆ๊ฐ€ -- ์˜ˆ์ œ: ์š”์ฒญ์— "security", "performance", "documentation" ์ถ”๊ฐ€ - -**๋ฌธ์ œ: ์—์ด์ „ํŠธ๊ฐ€ ๋„ˆ๋ฌด ๋งŽ์Œ** -- ํ•ด๊ฒฐ์ฑ…: ๊ตฌ์ฒด์ ์ธ ๊ธฐ์ˆ  ์šฉ์–ด๋กœ ์ฃผ์š” ๋„๋ฉ”์ธ์— ์ง‘์ค‘ -- ์˜ˆ์ œ: ๋ฒ”์œ„๋ฅผ ์ œํ•œํ•˜๊ธฐ ์œ„ํ•ด "/sc:focus backend" ์‚ฌ์šฉ - -### ํ’ˆ์งˆ ์ค‘์‹ฌ ๊ฐœ๋ฐœ - -**๋ณด์•ˆ ์šฐ์„  ์ ‘๊ทผ๋ฒ•:** -๋„๋ฉ”์ธ ์ „๋ฌธ๊ฐ€์™€ ํ•จ๊ป˜ security-engineer๋ฅผ ์ž๋™์œผ๋กœ ์ฐธ์—ฌ์‹œํ‚ค๊ธฐ ์œ„ํ•ด ๊ฐœ๋ฐœ ์š”์ฒญ์— ํ•ญ์ƒ ๋ณด์•ˆ ๊ณ ๋ ค์‚ฌํ•ญ์„ ํฌํ•จํ•˜์„ธ์š”. - -**์„ฑ๋Šฅ ํ†ตํ•ฉ:** -์ฒ˜์Œ๋ถ€ํ„ฐ performance-engineer ์กฐ์ •์„ ๋ณด์žฅํ•˜๊ธฐ ์œ„ํ•ด ์„ฑ๋Šฅ ํ‚ค์›Œ๋“œ("๋น ๋ฅธ", "ํšจ์œจ์ ", "ํ™•์žฅ ๊ฐ€๋Šฅ")๋ฅผ ํฌํ•จํ•˜์„ธ์š”. - -**์ ‘๊ทผ์„ฑ ๊ทœ์ • ์ค€์ˆ˜:** -ํ”„๋ก ํŠธ์—”๋“œ ๊ฐœ๋ฐœ์—์„œ ์ ‘๊ทผ์„ฑ ๊ฒ€์ฆ์„ ์ž๋™์œผ๋กœ ํฌํ•จํ•˜๊ธฐ ์œ„ํ•ด "accessible", "WCAG" ๋˜๋Š” "inclusive"๋ฅผ ์‚ฌ์šฉํ•˜์„ธ์š”. - -**๋ฌธ์„œํ™” ๋ฌธํ™”:** -์ž๋™ technical-writer ํฌํ•จ ๋ฐ ์ง€์‹ ์ „๋‹ฌ์„ ์œ„ํ•ด ์š”์ฒญ์— "documented", "explained" ๋˜๋Š” "tutorial"์„ ์ถ”๊ฐ€ํ•˜์„ธ์š”. - ---- - -## ์—์ด์ „ํŠธ ์ง€๋Šฅ ์ดํ•ด ๐Ÿง  - -### ์—์ด์ „ํŠธ๋ฅผ ํšจ๊ณผ์ ์œผ๋กœ ๋งŒ๋“œ๋Š” ๊ฒƒ - -**๋„๋ฉ”์ธ ์ „๋ฌธ ์ง€์‹**: ๊ฐ ์—์ด์ „ํŠธ๋Š” ๋„๋ฉ”์ธ๋ณ„ ์ „๋ฌธ ์ง€์‹ ํŒจํ„ด, ํ–‰๋™ ์ ‘๊ทผ๋ฒ•, ๋ฌธ์ œ ํ•ด๊ฒฐ ๋ฐฉ๋ฒ•๋ก ์„ ๊ฐ€์ง€๊ณ  ์žˆ์Šต๋‹ˆ๋‹ค. - -**์ปจํ…์ŠคํŠธ ํ™œ์„ฑํ™”**: ์—์ด์ „ํŠธ๋Š” ํ‚ค์›Œ๋“œ๋ฟ๋งŒ ์•„๋‹ˆ๋ผ ์š”์ฒญ ์ปจํ…์ŠคํŠธ๋ฅผ ๋ถ„์„ํ•˜์—ฌ ๊ด€๋ จ์„ฑ ๋ฐ ์ฐธ์—ฌ ์ˆ˜์ค€์„ ๊ฒฐ์ •ํ•ฉ๋‹ˆ๋‹ค. - -**ํ˜‘์—… ์ง€๋Šฅ**: ๋‹ค์ค‘ ์—์ด์ „ํŠธ ์กฐ์ •์€ ๊ฐœ๋ณ„ ์—์ด์ „ํŠธ ๋Šฅ๋ ฅ์„ ์ดˆ๊ณผํ•˜๋Š” ์‹œ๋„ˆ์ง€ ํšจ๊ณผ๋ฅผ ์ƒ์„ฑํ•ฉ๋‹ˆ๋‹ค. - -**์ ์‘ํ˜• ํ•™์Šต**: ์—์ด์ „ํŠธ ์„ ํƒ์€ ์š”์ฒญ ํŒจํ„ด ๋ฐ ์„ฑ๊ณต์ ์ธ ์กฐ์ • ๊ฒฐ๊ณผ๋ฅผ ๊ธฐ๋ฐ˜์œผ๋กœ ํ–ฅ์ƒ๋ฉ๋‹ˆ๋‹ค. - -### ์—์ด์ „ํŠธ vs. ์ „ํ†ต์ ์ธ AI - -**์ „ํ†ต์ ์ธ ์ ‘๊ทผ๋ฒ•**: ๋‹จ์ผ AI๊ฐ€ ๋‹ค์–‘ํ•œ ์ˆ˜์ค€์˜ ์ „๋ฌธ ์ง€์‹์œผ๋กœ ๋ชจ๋“  ๋„๋ฉ”์ธ์„ ์ฒ˜๋ฆฌ -**์—์ด์ „ํŠธ ์ ‘๊ทผ๋ฒ•**: ์ „๋ฌธ๊ฐ€๋“ค์ด ๊นŠ์€ ๋„๋ฉ”์ธ ์ง€์‹๊ณผ ์ง‘์ค‘๋œ ๋ฌธ์ œ ํ•ด๊ฒฐ๋กœ ํ˜‘์—… - -**์ด์ **: -- ๋„๋ฉ”์ธ๋ณ„ ์ž‘์—…์—์„œ ๋” ๋†’์€ ์ •ํ™•๋„ -- ๋” ์ •๊ตํ•œ ๋ฌธ์ œ ํ•ด๊ฒฐ ๋ฐฉ๋ฒ•๋ก  -- ์ „๋ฌธ๊ฐ€ ๊ฒ€ํ† ๋ฅผ ํ†ตํ•œ ๋” ๋‚˜์€ ํ’ˆ์งˆ ๋ณด์ฆ -- ์กฐ์ •๋œ ๋‹ค์ค‘ ๊ด€์  ๋ถ„์„ - -### ์‹œ์Šคํ…œ์„ ์‹ ๋ขฐํ•˜๊ณ  ํŒจํ„ด์„ ์ดํ•ดํ•˜์„ธ์š” - -**๊ธฐ๋Œ€ํ•  ์ˆ˜ ์žˆ๋Š” ๊ฒƒ**: -- ์ ์ ˆํ•œ ๋„๋ฉ”์ธ ์ „๋ฌธ๊ฐ€์—๊ฒŒ ์ž๋™ ๋ผ์šฐํŒ… -- ๋ณต์žกํ•œ ์ž‘์—…์— ๋Œ€ํ•œ ๋‹ค์ค‘ ์—์ด์ „ํŠธ ์กฐ์ • -- ์ž๋™ QA ์—์ด์ „ํŠธ ํฌํ•จ์„ ํ†ตํ•œ ํ’ˆ์งˆ ํ†ตํ•ฉ -- ๊ต์œก ์—์ด์ „ํŠธ ํ™œ์„ฑํ™”๋ฅผ ํ†ตํ•œ ํ•™์Šต ๊ธฐํšŒ - -**๊ฑฑ์ •ํ•˜์ง€ ์•Š์•„๋„ ๋˜๋Š” ๊ฒƒ**: -- ์ˆ˜๋™ ์—์ด์ „ํŠธ ์„ ํƒ ๋˜๋Š” ๊ตฌ์„ฑ -- ๋ณต์žกํ•œ ๋ผ์šฐํŒ… ๊ทœ์น™ ๋˜๋Š” ์—์ด์ „ํŠธ ๊ด€๋ฆฌ -- ์—์ด์ „ํŠธ ๊ตฌ์„ฑ ๋˜๋Š” ์กฐ์ • -- ์—์ด์ „ํŠธ ์ƒํ˜ธ์ž‘์šฉ ๋งˆ์ดํฌ๋กœ ๊ด€๋ฆฌ - ---- - -## ๊ด€๋ จ ๋ฆฌ์†Œ์Šค ๐Ÿ“š - -### ํ•„์ˆ˜ ๋ฌธ์„œ -- **[๋ช…๋ น์–ด ๊ฐ€์ด๋“œ](commands.md)** - ์ตœ์ ์˜ ์—์ด์ „ํŠธ ์กฐ์ •์„ ํŠธ๋ฆฌ๊ฑฐํ•˜๋Š” SuperClaude ๋ช…๋ น์–ด ๋งˆ์Šคํ„ฐ -- **[MCP ์„œ๋ฒ„](mcp-servers.md)** - ์ „๋ฌธ ๋„๊ตฌ ํ†ตํ•ฉ์„ ํ†ตํ•œ ํ–ฅ์ƒ๋œ ์—์ด์ „ํŠธ ๊ธฐ๋Šฅ -- **[์„ธ์…˜ ๊ด€๋ฆฌ](session-management.md)** - ์˜๊ตฌ ์—์ด์ „ํŠธ ์ปจํ…์ŠคํŠธ๋ฅผ ์‚ฌ์šฉํ•œ ์žฅ๊ธฐ ์›Œํฌํ”Œ๋กœ์šฐ - -### ๊ณ ๊ธ‰ ์‚ฌ์šฉ -- **[ํ–‰๋™ ๋ชจ๋“œ](modes.md)** - ํ–ฅ์ƒ๋œ ์—์ด์ „ํŠธ ์กฐ์ •์„ ์œ„ํ•œ ์ปจํ…์ŠคํŠธ ์ตœ์ ํ™” -- **[์‹œ์ž‘ํ•˜๊ธฐ](../Getting-Started/quick-start.md)** - ์—์ด์ „ํŠธ ์ตœ์ ํ™”๋ฅผ ์œ„ํ•œ ์ „๋ฌธ๊ฐ€ ๊ธฐ๋ฒ• -- **[์˜ˆ์ œ ๋ชจ์Œ](../Reference/examples-cookbook.md)** - ์‹ค์ œ ์—์ด์ „ํŠธ ์กฐ์ • ํŒจํ„ด - -### ๊ฐœ๋ฐœ ๋ฆฌ์†Œ์Šค -- **[๊ธฐ์ˆ  ์•„ํ‚คํ…์ฒ˜](../Developer-Guide/technical-architecture.md)** - SuperClaude์˜ ์—์ด์ „ํŠธ ์‹œ์Šคํ…œ ์„ค๊ณ„ ์ดํ•ด -- **[๊ธฐ์—ฌํ•˜๊ธฐ](../Developer-Guide/contributing-code.md)** - ์—์ด์ „ํŠธ ๊ธฐ๋Šฅ ๋ฐ ์กฐ์ • ํŒจํ„ด ํ™•์žฅ - ---- - -## ์—์ด์ „ํŠธ ์—ฌ์ • ๐Ÿš€ - -**1์ฃผ์ฐจ: ์ž์—ฐ์Šค๋Ÿฌ์šด ์‚ฌ์šฉ** -์ž์—ฐ์–ด ์„ค๋ช…์œผ๋กœ ์‹œ์ž‘ํ•˜์„ธ์š”. ์–ด๋–ค ์—์ด์ „ํŠธ๊ฐ€ ํ™œ์„ฑํ™”๋˜๋Š”์ง€, ๊ทธ๋ฆฌ๊ณ  ๊ทธ ์ด์œ ๋ฅผ ์ฃผ๋ชฉํ•˜์„ธ์š”. ํ”„๋กœ์„ธ์Šค๋ฅผ ๊ณผ๋„ํ•˜๊ฒŒ ์ƒ๊ฐํ•˜์ง€ ์•Š๊ณ  ํ‚ค์›Œ๋“œ ํŒจํ„ด์— ๋Œ€ํ•œ ์ง๊ด€์„ ๊ตฌ์ถ•ํ•˜์„ธ์š”. - -**2-3์ฃผ์ฐจ: ํŒจํ„ด ์ธ์‹** -์—์ด์ „ํŠธ ์กฐ์ • ํŒจํ„ด์„ ๊ด€์ฐฐํ•˜์„ธ์š”. ๋ณต์žก์„ฑ๊ณผ ๋„๋ฉ”์ธ ํ‚ค์›Œ๋“œ๊ฐ€ ์—์ด์ „ํŠธ ์„ ํƒ์— ์–ด๋–ป๊ฒŒ ์˜ํ–ฅ์„ ๋ฏธ์น˜๋Š”์ง€ ์ดํ•ดํ•˜์„ธ์š”. ๋” ๋‚˜์€ ์กฐ์ •์„ ์œ„ํ•ด ์š”์ฒญ ๋ฌธ๊ตฌ๋ฅผ ์ตœ์ ํ™”ํ•˜๊ธฐ ์‹œ์ž‘ํ•˜์„ธ์š”. - -**2๊ฐœ์›” ์ด์ƒ: ์ „๋ฌธ๊ฐ€ ์กฐ์ •** -์ตœ์ ์˜ ์—์ด์ „ํŠธ ์กฐํ•ฉ์„ ํŠธ๋ฆฌ๊ฑฐํ•˜๋Š” ๋‹ค์ค‘ ๋„๋ฉ”์ธ ์š”์ฒญ์„ ๋งˆ์Šคํ„ฐํ•˜์„ธ์š”. ํšจ๊ณผ์ ์ธ ์—์ด์ „ํŠธ ์„ ํƒ์„ ์œ„ํ•œ ๋ฌธ์ œ ํ•ด๊ฒฐ ๊ธฐ๋ฒ•์„ ํ™œ์šฉํ•˜์„ธ์š”. ๋ณต์žกํ•œ ์›Œํฌํ”Œ๋กœ์šฐ๋ฅผ ์œ„ํ•œ ๊ณ ๊ธ‰ ํŒจํ„ด์„ ์‚ฌ์šฉํ•˜์„ธ์š”. - -**SuperClaude ์ด์ :** -๊ฐ„๋‹จํ•˜๊ณ  ์ž์—ฐ์Šค๋Ÿฌ์šด ์–ธ์–ด ์š”์ฒญ์„ ํ†ตํ•ด ์กฐ์ •๋œ ์‘๋‹ต์œผ๋กœ ์ž‘๋™ํ•˜๋Š” 14๋ช…์˜ ์ „๋ฌธ AI ์ „๋ฌธ๊ฐ€์˜ ํž˜์„ ๊ฒฝํ—˜ํ•˜์„ธ์š”. ๊ตฌ์„ฑ๋„, ๊ด€๋ฆฌ๋„ ํ•„์š” ์—†์ด, ํ•„์š”์— ๋”ฐ๋ผ ํ™•์žฅ๋˜๋Š” ์ง€๋Šฅ์ ์ธ ํ˜‘์—…๋งŒ ์žˆ์Šต๋‹ˆ๋‹ค. - -๐ŸŽฏ **์ง€๋Šฅ์ ์ธ ์—์ด์ „ํŠธ ์กฐ์ •์„ ๊ฒฝํ—˜ํ•  ์ค€๋น„๊ฐ€ ๋˜์…จ๋‚˜์š”? `/sc:implement`๋กœ ์‹œ์ž‘ํ•˜์—ฌ ์ „๋ฌธ AI ํ˜‘์—…์˜ ๋งˆ๋ฒ•์„ ๋ฐœ๊ฒฌํ•˜์„ธ์š”.** - diff --git a/docs/User-Guide-kr/commands.md b/docs/User-Guide-kr/commands.md deleted file mode 100644 index c383a5c..0000000 --- a/docs/User-Guide-kr/commands.md +++ /dev/null @@ -1,367 +0,0 @@ -# SuperClaude ๋ช…๋ น์–ด ๊ฐ€์ด๋“œ - -SuperClaude๋Š” Claude Code๋ฅผ ์œ„ํ•œ 25๊ฐœ์˜ ๋ช…๋ น์–ด๋ฅผ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค: ์›Œํฌํ”Œ๋กœ์šฐ๋ฅผ ์œ„ํ•œ `/sc:*` ๋ช…๋ น์–ด์™€ ์ „๋ฌธ๊ฐ€๋ฅผ ์œ„ํ•œ `@agent-*`. - -## ๋ช…๋ น์–ด ์œ ํ˜• - -| ์œ ํ˜• | ์‚ฌ์šฉ ์œ„์น˜ | ํ˜•์‹ | ์˜ˆ์ œ | -|------|------------|--------|---------| -| **์Šฌ๋ž˜์‹œ ๋ช…๋ น์–ด** | Claude Code | `/sc:[๋ช…๋ น์–ด]` | `/sc:implement "๊ธฐ๋Šฅ"` | -| **์—์ด์ „ํŠธ** | Claude Code | `@agent-[์ด๋ฆ„]` | `@agent-security "๊ฒ€ํ† "` | -| **์„ค์น˜** | ํ„ฐ๋ฏธ๋„ | `SuperClaude [๋ช…๋ น์–ด]` | `SuperClaude install` | - -## ๋น ๋ฅธ ํ…Œ์ŠคํŠธ -```bash -# ํ„ฐ๋ฏธ๋„: ์„ค์น˜ ํ™•์ธ -python3 -m SuperClaude --version -# Claude Code CLI ํ™•์ธ: claude --version - -# Claude Code: ๋ช…๋ น์–ด ํ…Œ์ŠคํŠธ -/sc:brainstorm "ํ…Œ์ŠคํŠธ ํ”„๋กœ์ ํŠธ" # ๋ฐœ๊ฒฌ ์งˆ๋ฌธ์„ ํ•ด์•ผ ํ•จ -/sc:analyze README.md # ๋ถ„์„์„ ์ œ๊ณตํ•ด์•ผ ํ•จ -``` - -**์›Œํฌํ”Œ๋กœ์šฐ**: `/sc:brainstorm "์•„์ด๋””์–ด"` โ†’ `/sc:implement "๊ธฐ๋Šฅ"` โ†’ `/sc:test` - -## ๐ŸŽฏ SuperClaude ๋ช…๋ น์–ด ์ดํ•ดํ•˜๊ธฐ - -## SuperClaude ์ž‘๋™ ๋ฐฉ์‹ - -SuperClaude๋Š” Claude Code๊ฐ€ ์ฝ์–ด ์ „๋ฌธํ™”๋œ ๋™์ž‘์„ ์ฑ„ํƒํ•˜๋Š” ํ–‰๋™ ์ปจํ…์ŠคํŠธ ํŒŒ์ผ์„ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค. `/sc:implement`๋ฅผ ์ž…๋ ฅํ•˜๋ฉด Claude Code๋Š” `implement.md` ์ปจํ…์ŠคํŠธ ํŒŒ์ผ์„ ์ฝ๊ณ  ํ–‰๋™ ์ง€์นจ์„ ๋”ฐ๋ฆ…๋‹ˆ๋‹ค. - -**SuperClaude ๋ช…๋ น์–ด๋Š” ์†Œํ”„ํŠธ์›จ์–ด๋กœ ์‹คํ–‰๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค** - ํ”„๋ ˆ์ž„์›Œํฌ์˜ ์ „๋ฌธ ์ง€์นจ ํŒŒ์ผ์„ ์ฝ์–ด Claude Code์˜ ๋™์ž‘์„ ์ˆ˜์ •ํ•˜๋Š” ์ปจํ…์ŠคํŠธ ํŠธ๋ฆฌ๊ฑฐ์ž…๋‹ˆ๋‹ค. - -### ๋ช…๋ น์–ด ์œ ํ˜•: -- **์Šฌ๋ž˜์‹œ ๋ช…๋ น์–ด** (`/sc:*`): ์›Œํฌํ”Œ๋กœ์šฐ ํŒจํ„ด ๋ฐ ํ–‰๋™ ๋ชจ๋“œ ํŠธ๋ฆฌ๊ฑฐ -- **์—์ด์ „ํŠธ ํ˜ธ์ถœ** (`@agent-*`): ํŠน์ • ๋„๋ฉ”์ธ ์ „๋ฌธ๊ฐ€๋ฅผ ์ˆ˜๋™์œผ๋กœ ํ™œ์„ฑํ™” -- **ํ”Œ๋ž˜๊ทธ** (`--think`, `--safe-mode`): ๋ช…๋ น์–ด ๋™์ž‘ ๋ฐ ๊นŠ์ด ์ˆ˜์ • - -### ์ปจํ…์ŠคํŠธ ๋ฉ”์ปค๋‹ˆ์ฆ˜: -1. **์‚ฌ์šฉ์ž ์ž…๋ ฅ**: `/sc:implement "์ธ์ฆ ์‹œ์Šคํ…œ"` ์ž…๋ ฅ -2. **์ปจํ…์ŠคํŠธ ๋กœ๋”ฉ**: Claude Code๊ฐ€ `~/.claude/superclaude/Commands/implement.md` ์ฝ์Œ -3. **๋™์ž‘ ์ฑ„ํƒ**: Claude๊ฐ€ ๋„๋ฉ”์ธ ์ „๋ฌธ ์ง€์‹, ๋„๊ตฌ ์„ ํƒ, ๊ฒ€์ฆ ํŒจํ„ด ์ ์šฉ -4. **ํ–ฅ์ƒ๋œ ์ถœ๋ ฅ**: ๋ณด์•ˆ ๊ณ ๋ ค์‚ฌํ•ญ ๋ฐ ๋ชจ๋ฒ” ์‚ฌ๋ก€๋ฅผ ๊ฐ–์ถ˜ ๊ตฌ์กฐํ™”๋œ ๊ตฌํ˜„ - -**ํ•ต์‹ฌ ํฌ์ธํŠธ**: ์ด๋Š” ์ „ํ†ต์ ์ธ ์†Œํ”„ํŠธ์›จ์–ด ์‹คํ–‰์ด ์•„๋‹Œ ์ปจํ…์ŠคํŠธ ๊ด€๋ฆฌ๋ฅผ ํ†ตํ•ด ์ •๊ตํ•œ ๊ฐœ๋ฐœ ์›Œํฌํ”Œ๋กœ์šฐ๋ฅผ ๋งŒ๋“ญ๋‹ˆ๋‹ค. - -### ์„ค์น˜ vs ์‚ฌ์šฉ ๋ช…๋ น์–ด - -**๐Ÿ–ฅ๏ธ ํ„ฐ๋ฏธ๋„ ๋ช…๋ น์–ด** (์‹ค์ œ CLI ์†Œํ”„ํŠธ์›จ์–ด): -- `SuperClaude install` - ํ”„๋ ˆ์ž„์›Œํฌ ์ปดํฌ๋„ŒํŠธ ์„ค์น˜ -- `SuperClaude update` - ๊ธฐ์กด ์„ค์น˜ ์—…๋ฐ์ดํŠธ -- `SuperClaude uninstall` - ํ”„๋ ˆ์ž„์›Œํฌ ์„ค์น˜ ์ œ๊ฑฐ -- `python3 -m SuperClaude --version` - ์„ค์น˜ ์ƒํƒœ ํ™•์ธ - -**๐Ÿ’ฌ Claude Code ๋ช…๋ น์–ด** (์ปจํ…์ŠคํŠธ ํŠธ๋ฆฌ๊ฑฐ): -- `/sc:brainstorm` - ์š”๊ตฌ์‚ฌํ•ญ ๋ฐœ๊ฒฌ ์ปจํ…์ŠคํŠธ ํ™œ์„ฑํ™” -- `/sc:implement` - ๊ธฐ๋Šฅ ๊ฐœ๋ฐœ ์ปจํ…์ŠคํŠธ ํ™œ์„ฑํ™” -- `@agent-security` - ๋ณด์•ˆ ์ „๋ฌธ๊ฐ€ ์ปจํ…์ŠคํŠธ ํ™œ์„ฑํ™” -- ๋ชจ๋“  ๋ช…๋ น์–ด๋Š” Claude Code ์ฑ„ํŒ… ์ธํ„ฐํŽ˜์ด์Šค ๋‚ด์—์„œ๋งŒ ์ž‘๋™ - -> **๋น ๋ฅธ ์‹œ์ž‘**: ํ•ต์‹ฌ ์›Œํฌํ”Œ๋กœ์šฐ๋ฅผ ๊ฒฝํ—˜ํ•˜๋ ค๋ฉด `/sc:brainstorm "ํ”„๋กœ์ ํŠธ ์•„์ด๋””์–ด"` โ†’ `/sc:implement "๊ธฐ๋Šฅ ์ด๋ฆ„"` โ†’ `/sc:test`๋ฅผ ์‹œ๋„ํ•ด๋ณด์„ธ์š”. - -## ๐Ÿงช ์„ค์ • ํ…Œ์ŠคํŠธ - -### ๐Ÿ–ฅ๏ธ ํ„ฐ๋ฏธ๋„ ํ™•์ธ (ํ„ฐ๋ฏธ๋„/CMD์—์„œ ์‹คํ–‰) -```bash -# SuperClaude ์ž‘๋™ ํ™•์ธ (์ฃผ์š” ๋ฐฉ๋ฒ•) -python3 -m SuperClaude --version -# ์˜ˆ์ƒ ์ถœ๋ ฅ: SuperClaude 4.1.5 - -# Claude Code CLI ๋ฒ„์ „ ํ™•์ธ -claude --version - -# ์„ค์น˜๋œ ์ปดํฌ๋„ŒํŠธ ํ™•์ธ -python3 -m SuperClaude install --list-components | grep mcp -# ์˜ˆ์ƒ ์ถœ๋ ฅ: ์„ค์น˜๋œ MCP ์ปดํฌ๋„ŒํŠธ ํ‘œ์‹œ -``` - -### ๐Ÿ’ฌ Claude Code ํ…Œ์ŠคํŠธ (Claude Code ์ฑ„ํŒ…์— ์ž…๋ ฅ) -``` -# ๊ธฐ๋ณธ /sc: ๋ช…๋ น์–ด ํ…Œ์ŠคํŠธ -/sc:brainstorm "ํ…Œ์ŠคํŠธ ํ”„๋กœ์ ํŠธ" -# ์˜ˆ์ƒ ๋™์ž‘: ๋Œ€ํ™”ํ˜• ์š”๊ตฌ์‚ฌํ•ญ ๋ฐœ๊ฒฌ ์‹œ์ž‘ - -# ๋ช…๋ น์–ด ๋„์›€๋ง ํ…Œ์ŠคํŠธ -/sc:help -# ์˜ˆ์ƒ ๋™์ž‘: ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ ๋ช…๋ น์–ด ๋ชฉ๋ก -``` - -**ํ…Œ์ŠคํŠธ๊ฐ€ ์‹คํŒจํ•˜๋ฉด**: [์„ค์น˜ ๊ฐ€์ด๋“œ](../Getting-Started/installation.md) ๋˜๋Š” [๋ฌธ์ œ ํ•ด๊ฒฐ](#troubleshooting) ํ™•์ธ - -### ๐Ÿ“ ๋ช…๋ น์–ด ๋น ๋ฅธ ์ฐธ์กฐ - -| ๋ช…๋ น์–ด ์œ ํ˜• | ์‹คํ–‰ ์œ„์น˜ | ํ˜•์‹ | ๋ชฉ์  | ์˜ˆ์ œ | -|-------------|--------------|--------|---------|----------| -| **๐Ÿ–ฅ๏ธ ์„ค์น˜** | ํ„ฐ๋ฏธ๋„/CMD | `SuperClaude [๋ช…๋ น์–ด]` | ์„ค์ • ๋ฐ ์œ ์ง€๋ณด์ˆ˜ | `SuperClaude install` | -| **๐Ÿ”ง ๊ตฌ์„ฑ** | ํ„ฐ๋ฏธ๋„/CMD | `python3 -m SuperClaude [๋ช…๋ น์–ด]` | ๊ณ ๊ธ‰ ๊ตฌ์„ฑ | `python3 -m SuperClaude --version` | -| **๐Ÿ’ฌ ์Šฌ๋ž˜์‹œ ๋ช…๋ น์–ด** | Claude Code | `/sc:[๋ช…๋ น์–ด]` | ์›Œํฌํ”Œ๋กœ์šฐ ์ž๋™ํ™” | `/sc:implement "๊ธฐ๋Šฅ"` | -| **๐Ÿค– ์—์ด์ „ํŠธ ํ˜ธ์ถœ** | Claude Code | `@agent-[์ด๋ฆ„]` | ์ˆ˜๋™ ์ „๋ฌธ๊ฐ€ ํ™œ์„ฑํ™” | `@agent-security "๊ฒ€ํ† "` | -| **โšก ํ–ฅ์ƒ๋œ ํ”Œ๋ž˜๊ทธ** | Claude Code | `/sc:[๋ช…๋ น์–ด] --ํ”Œ๋ž˜๊ทธ` | ๋™์ž‘ ์ˆ˜์ • | `/sc:analyze --think-hard` | - -> **๊ธฐ์–ตํ•˜์„ธ์š”**: ๋ชจ๋“  `/sc:` ๋ช…๋ น์–ด์™€ `@agent-` ํ˜ธ์ถœ์€ ํ„ฐ๋ฏธ๋„์ด ์•„๋‹Œ Claude Code ์ฑ„ํŒ… ๋‚ด์—์„œ ์ž‘๋™ํ•ฉ๋‹ˆ๋‹ค. ์ด๋“ค์€ Claude Code๊ฐ€ SuperClaude ํ”„๋ ˆ์ž„์›Œํฌ์—์„œ ํŠน์ • ์ปจํ…์ŠคํŠธ ํŒŒ์ผ์„ ์ฝ๋„๋ก ํŠธ๋ฆฌ๊ฑฐํ•ฉ๋‹ˆ๋‹ค. - -## ๋ชฉ์ฐจ - -- [ํ•„์ˆ˜ ๋ช…๋ น์–ด](#ํ•„์ˆ˜-๋ช…๋ น์–ด) - ์—ฌ๊ธฐ์„œ ์‹œ์ž‘ํ•˜์„ธ์š” (8๊ฐœ ํ•ต์‹ฌ ๋ช…๋ น์–ด) -- [์ผ๋ฐ˜์ ์ธ ์›Œํฌํ”Œ๋กœ์šฐ](#์ผ๋ฐ˜์ ์ธ-์›Œํฌํ”Œ๋กœ์šฐ) - ์ž‘๋™ํ•˜๋Š” ๋ช…๋ น์–ด ์กฐํ•ฉ -- [์ „์ฒด ๋ช…๋ น์–ด ์ฐธ์กฐ](#์ „์ฒด-๋ช…๋ น์–ด-์ฐธ์กฐ) - ์นดํ…Œ๊ณ ๋ฆฌ๋ณ„๋กœ ์ •๋ฆฌ๋œ 25๊ฐœ ๋ช…๋ น์–ด -- [๋ฌธ์ œ ํ•ด๊ฒฐ](#๋ฌธ์ œ-ํ•ด๊ฒฐ) - ์ผ๋ฐ˜์ ์ธ ๋ฌธ์ œ ๋ฐ ํ•ด๊ฒฐ์ฑ… -- [๋ช…๋ น์–ด ์ธ๋ฑ์Šค](#๋ช…๋ น์–ด-์ธ๋ฑ์Šค) - ์นดํ…Œ๊ณ ๋ฆฌ๋ณ„๋กœ ๋ช…๋ น์–ด ์ฐพ๊ธฐ - ---- - -## ํ•„์ˆ˜ ๋ช…๋ น์–ด - -**์ฆ‰๊ฐ์ ์ธ ์ƒ์‚ฐ์„ฑ์„ ์œ„ํ•œ ํ•ต์‹ฌ ์›Œํฌํ”Œ๋กœ์šฐ ๋ช…๋ น์–ด:** - -### `/sc:brainstorm` - ํ”„๋กœ์ ํŠธ ๋ฐœ๊ฒฌ -**๋ชฉ์ **: ๋Œ€ํ™”ํ˜• ์š”๊ตฌ์‚ฌํ•ญ ๋ฐœ๊ฒฌ ๋ฐ ํ”„๋กœ์ ํŠธ ๊ณ„ํš -**๊ตฌ๋ฌธ**: `/sc:brainstorm "์•„์ด๋””์–ด"` `[--strategy systematic|creative]` - -**์‚ฌ์šฉ ์‚ฌ๋ก€**: -- ์ƒˆ ํ”„๋กœ์ ํŠธ ๊ณ„ํš: `/sc:brainstorm "์ „์ž์ƒ๊ฑฐ๋ž˜ ํ”Œ๋žซํผ"` -- ๊ธฐ๋Šฅ ํƒ์ƒ‰: `/sc:brainstorm "์‚ฌ์šฉ์ž ์ธ์ฆ ์‹œ์Šคํ…œ"` -- ๋ฌธ์ œ ํ•ด๊ฒฐ: `/sc:brainstorm "๋Š๋ฆฐ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์ฟผ๋ฆฌ"` - -### `/sc:help` - ๋ช…๋ น์–ด ์ฐธ์กฐ -**๋ชฉ์ **: ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ ๋ชจ๋“  `/sc` ๋ช…๋ น์–ด์™€ ์„ค๋ช… ๋ชฉ๋ก ํ‘œ์‹œ -**๊ตฌ๋ฌธ**: `/sc:help` - -**์‚ฌ์šฉ ์‚ฌ๋ก€**: -- ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ ๋ช…๋ น์–ด ๋ฐœ๊ฒฌ: `/sc:help` -- ๋ช…๋ น์–ด ์ด๋ฆ„ ๋น ๋ฅธ ํ™•์ธ: `/sc:help` - -### `/sc:research` - ์‹ฌ์ธต ์—ฐ๊ตฌ ๋ช…๋ น์–ด -**๋ชฉ์ **: ์ ์‘ํ˜• ๊ณ„ํš ๋ฐ ์ง€๋Šฅํ˜• ๊ฒ€์ƒ‰์„ ํ†ตํ•œ ํฌ๊ด„์ ์ธ ์›น ์—ฐ๊ตฌ -**๊ตฌ๋ฌธ**: `/sc:research "[์ฟผ๋ฆฌ]"` `[--depth quick|standard|deep|exhaustive] [--strategy planning|intent|unified]` - -**์‚ฌ์šฉ ์‚ฌ๋ก€**: -- ๊ธฐ์ˆ  ์—ฐ๊ตฌ: `/sc:research "์ตœ์‹  React 19 ๊ธฐ๋Šฅ" --depth deep` -- ์‹œ์žฅ ๋ถ„์„: `/sc:research "2024๋…„ AI ์ฝ”๋”ฉ ์–ด์‹œ์Šคํ„ดํŠธ ํ˜„ํ™ฉ" --strategy unified` -- ํ•™์ˆ  ์กฐ์‚ฌ: `/sc:research "์–‘์ž ์ปดํ“จํŒ… ๋ŒํŒŒ๊ตฌ" --depth exhaustive` -- ์ตœ์‹  ์ •๋ณด: `/sc:research "2024๋…„ ์ตœ์‹  AI ๊ฐœ๋ฐœ"` - -**ํ•ต์‹ฌ ๊ธฐ๋Šฅ**: -- **6๋‹จ๊ณ„ ์›Œํฌํ”Œ๋กœ์šฐ**: ์ดํ•ด โ†’ ๊ณ„ํš โ†’ TodoWrite โ†’ ์‹คํ–‰ โ†’ ์ถ”์  โ†’ ๊ฒ€์ฆ -- **์ ์‘ํ˜• ๊นŠ์ด**: Quick(๊ธฐ๋ณธ ๊ฒ€์ƒ‰), Standard(ํ™•์žฅ), Deep(ํฌ๊ด„์ ), Exhaustive(์ตœ๋Œ€ ๊นŠ์ด) -- **๊ณ„ํš ์ „๋žต**: Planning(์ง์ ‘), Intent(๋จผ์ € ๋ช…ํ™•ํ™”), Unified(ํ˜‘์—…) -- **๋ณ‘๋ ฌ ์‹คํ–‰**: ๊ธฐ๋ณธ ๋ณ‘๋ ฌ ๊ฒ€์ƒ‰ ๋ฐ ์ถ”์ถœ -- **์ฆ๊ฑฐ ๊ด€๋ฆฌ**: ๊ด€๋ จ์„ฑ ์ ์ˆ˜๊ฐ€ ์žˆ๋Š” ๋ช…ํ™•ํ•œ ์ธ์šฉ -- **์ถœ๋ ฅ ํ‘œ์ค€**: ๋ณด๊ณ ์„œ๊ฐ€ `claudedocs/research_[์ฃผ์ œ]_[ํƒ€์ž„์Šคํƒฌํ”„].md`์— ์ €์žฅ๋จ - -### `/sc:implement` - ๊ธฐ๋Šฅ ๊ฐœ๋ฐœ -**๋ชฉ์ **: ์ง€๋Šฅํ˜• ์ „๋ฌธ๊ฐ€ ๋ผ์šฐํŒ…์„ ํ†ตํ•œ ํ’€์Šคํƒ ๊ธฐ๋Šฅ ๊ตฌํ˜„ -**๊ตฌ๋ฌธ**: `/sc:implement "๊ธฐ๋Šฅ ์„ค๋ช…"` `[--type frontend|backend|fullstack] [--focus security|performance]` - -**์‚ฌ์šฉ ์‚ฌ๋ก€**: -- ์ธ์ฆ: `/sc:implement "JWT ๋กœ๊ทธ์ธ ์‹œ์Šคํ…œ"` -- UI ์ปดํฌ๋„ŒํŠธ: `/sc:implement "๋ฐ˜์‘ํ˜• ๋Œ€์‹œ๋ณด๋“œ"` -- API: `/sc:implement "REST ์‚ฌ์šฉ์ž ์—”๋“œํฌ์ธํŠธ"` -- ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค: `/sc:implement "๊ด€๊ณ„๋ฅผ ๊ฐ€์ง„ ์‚ฌ์šฉ์ž ์Šคํ‚ค๋งˆ"` - -### `/sc:analyze` - ์ฝ”๋“œ ํ‰๊ฐ€ -**๋ชฉ์ **: ํ’ˆ์งˆ, ๋ณด์•ˆ, ์„ฑ๋Šฅ์— ๊ฑธ์นœ ํฌ๊ด„์ ์ธ ์ฝ”๋“œ ๋ถ„์„ -**๊ตฌ๋ฌธ**: `/sc:analyze [๊ฒฝ๋กœ]` `[--focus quality|security|performance|architecture]` - -**์‚ฌ์šฉ ์‚ฌ๋ก€**: -- ํ”„๋กœ์ ํŠธ ์ƒํƒœ: `/sc:analyze .` -- ๋ณด์•ˆ ๊ฐ์‚ฌ: `/sc:analyze --focus security` -- ์„ฑ๋Šฅ ๊ฒ€ํ† : `/sc:analyze --focus performance` - -### `/sc:business-panel` - ์ „๋žต์  ๋น„์ฆˆ๋‹ˆ์Šค ๋ถ„์„ -**๋ชฉ์ **: 9๋ช…์˜ ์ €๋ช…ํ•œ ์‚ฌ์ƒ๊ฐ€์™€ ํ•จ๊ป˜ํ•˜๋Š” ๋‹ค์ค‘ ์ „๋ฌธ๊ฐ€ ๋น„์ฆˆ๋‹ˆ์Šค ์ „๋žต ๋ถ„์„ -**๊ตฌ๋ฌธ**: `/sc:business-panel "๋‚ด์šฉ"` `[--mode discussion|debate|socratic] [--experts "name1,name2"]` - -**์‚ฌ์šฉ ์‚ฌ๋ก€**: -- ์ „๋žต ํ‰๊ฐ€: `/sc:business-panel "์šฐ๋ฆฌ์˜ ์‹œ์žฅ ์ง„์ถœ ์ „๋žต"` -- ๊ฒฝ์Ÿ ๋ถ„์„: `/sc:business-panel @competitor_analysis.pdf --mode debate` -- ํ˜์‹  ํ‰๊ฐ€: `/sc:business-panel "AI ์ œํ’ˆ ์•„์ด๋””์–ด" --experts "christensen,drucker"` -- ์ „๋žต์  ํ•™์Šต: `/sc:business-panel "๊ฒฝ์Ÿ ์ „๋žต" --mode socratic` - -**์ „๋ฌธ๊ฐ€ ํŒจ๋„**: Christensen, Porter, Drucker, Godin, Kim/Mauborgne, Collins, Taleb, Meadows, Doumont - -### `/sc:spec-panel` - ์ „๋ฌธ๊ฐ€ ์‚ฌ์–‘ ๊ฒ€ํ†  -**๋ชฉ์ **: ์ €๋ช…ํ•œ ์‚ฌ์–‘ ๋ฐ ์†Œํ”„ํŠธ์›จ์–ด ์—”์ง€๋‹ˆ์–ด๋ง ์ „๋ฌธ๊ฐ€๋ฅผ ์‚ฌ์šฉํ•œ ๋‹ค์ค‘ ์ „๋ฌธ๊ฐ€ ์‚ฌ์–‘ ๊ฒ€ํ†  ๋ฐ ๊ฐœ์„  -**๊ตฌ๋ฌธ**: `/sc:spec-panel [๋‚ด์šฉ|@ํŒŒ์ผ]` `[--mode discussion|critique|socratic] [--focus requirements|architecture|testing|compliance]` - -**์‚ฌ์šฉ ์‚ฌ๋ก€**: -- ์‚ฌ์–‘ ๊ฒ€ํ† : `/sc:spec-panel @api_spec.yml --mode critique --focus requirements,architecture` -- ์š”๊ตฌ์‚ฌํ•ญ ์›Œํฌ์ˆ: `/sc:spec-panel "์‚ฌ์šฉ์ž ์Šคํ† ๋ฆฌ ๋‚ด์šฉ" --mode discussion` -- ์•„ํ‚คํ…์ฒ˜ ๊ฒ€์ฆ: `/sc:spec-panel @microservice.spec.yml --mode socratic --focus architecture` -- ๊ทœ์ • ์ค€์ˆ˜ ๊ฒ€ํ† : `/sc:spec-panel @security_requirements.yml --focus compliance` -- ๋ฐ˜๋ณต์  ๊ฐœ์„ : `/sc:spec-panel @complex_system.spec.yml --iterations 3` - -**์ „๋ฌธ๊ฐ€ ํŒจ๋„**: Wiegers, Adzic, Cockburn, Fowler, Nygard, Newman, Hohpe, Crispin, Gregory, Hightower - -### `/sc:troubleshoot` - ๋ฌธ์ œ ์ง„๋‹จ -**๋ชฉ์ **: ๊ทผ๋ณธ ์›์ธ ๋ถ„์„์„ ํ†ตํ•œ ์ฒด๊ณ„์ ์ธ ๋ฌธ์ œ ์ง„๋‹จ -**๊ตฌ๋ฌธ**: `/sc:troubleshoot "๋ฌธ์ œ ์„ค๋ช…"` `[--type build|runtime|performance]` - -**์‚ฌ์šฉ ์‚ฌ๋ก€**: -- ๋Ÿฐํƒ€์ž„ ์˜ค๋ฅ˜: `/sc:troubleshoot "๋กœ๊ทธ์ธ ์‹œ 500 ์˜ค๋ฅ˜"` -- ๋นŒ๋“œ ์‹คํŒจ: `/sc:troubleshoot --type build` -- ์„ฑ๋Šฅ ๋ฌธ์ œ: `/sc:troubleshoot "๋Š๋ฆฐ ํŽ˜์ด์ง€ ๋กœ๋“œ"` - -### `/sc:test` - ํ’ˆ์งˆ ๋ณด์ฆ -**๋ชฉ์ **: ์ปค๋ฒ„๋ฆฌ์ง€ ๋ถ„์„์„ ํ†ตํ•œ ํฌ๊ด„์ ์ธ ํ…Œ์ŠคํŒ… -**๊ตฌ๋ฌธ**: `/sc:test` `[--type unit|integration|e2e] [--coverage] [--fix]` - -**์‚ฌ์šฉ ์‚ฌ๋ก€**: -- ์ „์ฒด ํ…Œ์ŠคํŠธ ์Šค์œ„ํŠธ: `/sc:test --coverage` -- ๋‹จ์œ„ ํ…Œ์ŠคํŒ…: `/sc:test --type unit --watch` -- E2E ๊ฒ€์ฆ: `/sc:test --type e2e` - -### `/sc:improve` - ์ฝ”๋“œ ํ–ฅ์ƒ -**๋ชฉ์ **: ์ฒด๊ณ„์ ์ธ ์ฝ”๋“œ ๊ฐœ์„  ๋ฐ ์ตœ์ ํ™” ์ ์šฉ -**๊ตฌ๋ฌธ**: `/sc:improve [๊ฒฝ๋กœ]` `[--type performance|quality|security] [--preview]` - -**์‚ฌ์šฉ ์‚ฌ๋ก€**: -- ์ผ๋ฐ˜์ ์ธ ๊ฐœ์„ : `/sc:improve src/` -- ์„ฑ๋Šฅ ์ตœ์ ํ™”: `/sc:improve --type performance` -- ๋ณด์•ˆ ๊ฐ•ํ™”: `/sc:improve --type security` - -### `/sc:document` - ๋ฌธ์„œ ์ƒ์„ฑ -**๋ชฉ์ **: ์ฝ”๋“œ ๋ฐ API์— ๋Œ€ํ•œ ํฌ๊ด„์ ์ธ ๋ฌธ์„œ ์ƒ์„ฑ -**๊ตฌ๋ฌธ**: `/sc:document [๊ฒฝ๋กœ]` `[--type api|user-guide|technical] [--format markdown|html]` - -**์‚ฌ์šฉ ์‚ฌ๋ก€**: -- API ๋ฌธ์„œ: `/sc:document --type api` -- ์‚ฌ์šฉ์ž ๊ฐ€์ด๋“œ: `/sc:document --type user-guide` -- ๊ธฐ์ˆ  ๋ฌธ์„œ: `/sc:document --type technical` - -### `/sc:workflow` - ๊ตฌํ˜„ ๊ณ„ํš -**๋ชฉ์ **: ์š”๊ตฌ์‚ฌํ•ญ์—์„œ ๊ตฌ์กฐํ™”๋œ ๊ตฌํ˜„ ๊ณ„ํš ์ƒ์„ฑ -**๊ตฌ๋ฌธ**: `/sc:workflow "๊ธฐ๋Šฅ ์„ค๋ช…"` `[--strategy agile|waterfall] [--format markdown]` - -**์‚ฌ์šฉ ์‚ฌ๋ก€**: -- ๊ธฐ๋Šฅ ๊ณ„ํš: `/sc:workflow "์‚ฌ์šฉ์ž ์ธ์ฆ"` -- ์Šคํ”„๋ฆฐํŠธ ๊ณ„ํš: `/sc:workflow --strategy agile` -- ์•„ํ‚คํ…์ฒ˜ ๊ณ„ํš: `/sc:workflow "๋งˆ์ดํฌ๋กœ์„œ๋น„์Šค ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜"` - ---- - -## ์ผ๋ฐ˜์ ์ธ ์›Œํฌํ”Œ๋กœ์šฐ - -**๊ฒ€์ฆ๋œ ๋ช…๋ น์–ด ์กฐํ•ฉ:** - -### ์ƒˆ ํ”„๋กœ์ ํŠธ ์„ค์ • -```bash -/sc:brainstorm "ํ”„๋กœ์ ํŠธ ๊ฐœ๋…" # ์š”๊ตฌ์‚ฌํ•ญ ์ •์˜ -/sc:design "์‹œ์Šคํ…œ ์•„ํ‚คํ…์ฒ˜" # ๊ธฐ์ˆ  ์„ค๊ณ„ ์ƒ์„ฑ -/sc:workflow "๊ตฌํ˜„ ๊ณ„ํš" # ๊ฐœ๋ฐœ ๋กœ๋“œ๋งต ์ƒ์„ฑ -``` - -### ๊ธฐ๋Šฅ ๊ฐœ๋ฐœ -```bash -/sc:implement "๊ธฐ๋Šฅ ์ด๋ฆ„" # ๊ธฐ๋Šฅ ๊ตฌ์ถ• -/sc:test --coverage # ํ…Œ์ŠคํŠธ๋กœ ๊ฒ€์ฆ -/sc:document --type api # ๋ฌธ์„œ ์ƒ์„ฑ -``` - -### ์ฝ”๋“œ ํ’ˆ์งˆ ๊ฐœ์„  -```bash -/sc:analyze --focus quality # ํ˜„์žฌ ์ƒํƒœ ํ‰๊ฐ€ -/sc:improve --preview # ๊ฐœ์„  ์‚ฌํ•ญ ๋ฏธ๋ฆฌ๋ณด๊ธฐ -/sc:test --coverage # ๋ณ€๊ฒฝ ์‚ฌํ•ญ ๊ฒ€์ฆ -``` - -### ๋ฒ„๊ทธ ์กฐ์‚ฌ -```bash -/sc:troubleshoot "๋ฌธ์ œ ์„ค๋ช…" # ๋ฌธ์ œ ์ง„๋‹จ -/sc:analyze --focus problem-area # ์‹ฌ์ธต ๋ถ„์„ -/sc:improve --fix --safe-mode # ๋Œ€์ƒ ์ˆ˜์ • ์ ์šฉ -``` - -### ์‚ฌ์–‘ ๊ฐœ๋ฐœ -```bash -/sc:spec-panel @existing_spec.yml --mode critique # ์ „๋ฌธ๊ฐ€ ๊ฒ€ํ†  -/sc:spec-panel @improved_spec.yml --iterations 2 # ๋ฐ˜๋ณต์  ๊ฐœ์„  -/sc:document --type technical # ๋ฌธ์„œ ์ƒ์„ฑ -``` - -## ์ „์ฒด ๋ช…๋ น์–ด ์ฐธ์กฐ - -### ๊ฐœ๋ฐœ ๋ช…๋ น์–ด -| ๋ช…๋ น์–ด | ๋ชฉ์  | ์ตœ์  ์‚ฌ์šฉ์ฒ˜ | -|---------|---------|----------| -| **workflow** | ๊ตฌํ˜„ ๊ณ„ํš | ํ”„๋กœ์ ํŠธ ๋กœ๋“œ๋งต, ์Šคํ”„๋ฆฐํŠธ ๊ณ„ํš | -| **implement** | ๊ธฐ๋Šฅ ๊ฐœ๋ฐœ | ํ’€์Šคํƒ ๊ธฐ๋Šฅ, API ๊ฐœ๋ฐœ | -| **build** | ํ”„๋กœ์ ํŠธ ์ปดํŒŒ์ผ | CI/CD, ํ”„๋กœ๋•์…˜ ๋นŒ๋“œ | -| **design** | ์‹œ์Šคํ…œ ์•„ํ‚คํ…์ฒ˜ | API ์ŠคํŽ™, ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์Šคํ‚ค๋งˆ | - -### ๋ถ„์„ ๋ช…๋ น์–ด -| ๋ช…๋ น์–ด | ๋ชฉ์  | ์ตœ์  ์‚ฌ์šฉ์ฒ˜ | -|---------|---------|----------| -| **analyze** | ์ฝ”๋“œ ํ‰๊ฐ€ | ํ’ˆ์งˆ ๊ฐ์‚ฌ, ๋ณด์•ˆ ๊ฒ€ํ†  | -| **research** | ์ง€๋Šฅํ˜• ๊ฒ€์ƒ‰์„ ํ†ตํ•œ ์›น ์—ฐ๊ตฌ | ๊ธฐ์ˆ  ์—ฐ๊ตฌ, ์ตœ์‹  ์ •๋ณด, ์‹œ์žฅ ๋ถ„์„ | -| **business-panel** | ์ „๋žต์  ๋ถ„์„ | ๋น„์ฆˆ๋‹ˆ์Šค ๊ฒฐ์ •, ๊ฒฝ์Ÿ ํ‰๊ฐ€ | -| **spec-panel** | ์‚ฌ์–‘ ๊ฒ€ํ†  | ์š”๊ตฌ์‚ฌํ•ญ ๊ฒ€์ฆ, ์•„ํ‚คํ…์ฒ˜ ๋ถ„์„ | -| **troubleshoot** | ๋ฌธ์ œ ์ง„๋‹จ | ๋ฒ„๊ทธ ์กฐ์‚ฌ, ์„ฑ๋Šฅ ๋ฌธ์ œ | -| **explain** | ์ฝ”๋“œ ์„ค๋ช… | ํ•™์Šต, ์ฝ”๋“œ ๊ฒ€ํ†  | - -### ํ’ˆ์งˆ ๋ช…๋ น์–ด -| ๋ช…๋ น์–ด | ๋ชฉ์  | ์ตœ์  ์‚ฌ์šฉ์ฒ˜ | -|---------|---------|----------| -| **improve** | ์ฝ”๋“œ ํ–ฅ์ƒ | ์„ฑ๋Šฅ ์ตœ์ ํ™”, ๋ฆฌํŒฉํ† ๋ง | -| **cleanup** | ๊ธฐ์ˆ  ๋ถ€์ฑ„ | ๋ฐ๋“œ ์ฝ”๋“œ ์ œ๊ฑฐ, ์ •๋ฆฌ | -| **test** | ํ’ˆ์งˆ ๋ณด์ฆ | ํ…Œ์ŠคํŠธ ์ž๋™ํ™”, ์ปค๋ฒ„๋ฆฌ์ง€ ๋ถ„์„ | -| **document** | ๋ฌธ์„œํ™” | API ๋ฌธ์„œ, ์‚ฌ์šฉ์ž ๊ฐ€์ด๋“œ | - -### ํ”„๋กœ์ ํŠธ ๊ด€๋ฆฌ -| ๋ช…๋ น์–ด | ๋ชฉ์  | ์ตœ์  ์‚ฌ์šฉ์ฒ˜ | -|---------|---------|----------| -| **estimate** | ํ”„๋กœ์ ํŠธ ์ถ”์ • | ํƒ€์ž„๋ผ์ธ ๊ณ„ํš, ๋ฆฌ์†Œ์Šค ํ• ๋‹น | -| **task** | ์ž‘์—… ๊ด€๋ฆฌ | ๋ณต์žกํ•œ ์›Œํฌํ”Œ๋กœ์šฐ, ์ž‘์—… ์ถ”์  | -| **spawn** | ๋ฉ”ํƒ€ ์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜ | ๋Œ€๊ทœ๋ชจ ํ”„๋กœ์ ํŠธ, ๋ณ‘๋ ฌ ์‹คํ–‰ | - -### ์œ ํ‹ธ๋ฆฌํ‹ฐ ๋ช…๋ น์–ด -| ๋ช…๋ น์–ด | ๋ชฉ์  | ์ตœ์  ์‚ฌ์šฉ์ฒ˜ | -|---------|---------|----------| -| **help** | ๋ชจ๋“  ๋ช…๋ น์–ด ๋‚˜์—ด | ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ ๋ช…๋ น์–ด ๋ฐœ๊ฒฌ | -| **git** | ๋ฒ„์ „ ์ œ์–ด | ์ปค๋ฐ‹ ๊ด€๋ฆฌ, ๋ธŒ๋žœ์น˜ ์ „๋žต | -| **index** | ๋ช…๋ น์–ด ๋ฐœ๊ฒฌ | ๊ธฐ๋Šฅ ํƒ์ƒ‰, ๋ช…๋ น์–ด ์ฐพ๊ธฐ | - -### ์„ธ์…˜ ๋ช…๋ น์–ด -| ๋ช…๋ น์–ด | ๋ชฉ์  | ์ตœ์  ์‚ฌ์šฉ์ฒ˜ | -|---------|---------|----------| -| **load** | ์ปจํ…์ŠคํŠธ ๋กœ๋”ฉ | ์„ธ์…˜ ์ดˆ๊ธฐํ™”, ํ”„๋กœ์ ํŠธ ์˜จ๋ณด๋”ฉ | -| **save** | ์„ธ์…˜ ์ง€์†์„ฑ | ์ฒดํฌํฌ์ธํŒ…, ์ปจํ…์ŠคํŠธ ๋ณด์กด | -| **reflect** | ์ž‘์—… ๊ฒ€์ฆ | ์ง„ํ–‰ ์ƒํ™ฉ ํ‰๊ฐ€, ์™„๋ฃŒ ๊ฒ€์ฆ | -| **select-tool** | ๋„๊ตฌ ์ตœ์ ํ™” | ์„ฑ๋Šฅ ์ตœ์ ํ™”, ๋„๊ตฌ ์„ ํƒ | - ---- - -## ๋ช…๋ น์–ด ์ธ๋ฑ์Šค - -**๊ธฐ๋Šฅ๋ณ„:** -- **๊ณ„ํš**: brainstorm, design, workflow, estimate -- **๊ฐœ๋ฐœ**: implement, build, git -- **๋ถ„์„**: analyze, business-panel, spec-panel, troubleshoot, explain -- **ํ’ˆ์งˆ**: improve, cleanup, test, document -- **๊ด€๋ฆฌ**: task, spawn, load, save, reflect -- **์œ ํ‹ธ๋ฆฌํ‹ฐ**: help, index, select-tool - -**๋ณต์žก์„ฑ๋ณ„:** -- **์ดˆ๊ธ‰**: brainstorm, implement, analyze, test, help -- **์ค‘๊ธ‰**: workflow, design, business-panel, spec-panel, improve, document -- **๊ณ ๊ธ‰**: spawn, task, select-tool, reflect - -## ๋ฌธ์ œ ํ•ด๊ฒฐ - -**๋ช…๋ น์–ด ๋ฌธ์ œ:** -- **๋ช…๋ น์–ด๋ฅผ ์ฐพ์„ ์ˆ˜ ์—†์Œ**: ์„ค์น˜ ํ™•์ธ: `python3 -m SuperClaude --version` -- **์‘๋‹ต ์—†์Œ**: Claude Code ์„ธ์…˜ ์žฌ์‹œ์ž‘ -- **์ฒ˜๋ฆฌ ์ง€์—ฐ**: MCP ์„œ๋ฒ„ ์—†์ด ํ…Œ์ŠคํŠธํ•˜๋ ค๋ฉด `--no-mcp` ์‚ฌ์šฉ - -**๋น ๋ฅธ ์ˆ˜์ •:** -- ์„ธ์…˜ ์žฌ์„ค์ •: `/sc:load`๋กœ ๋‹ค์‹œ ์ดˆ๊ธฐํ™” -- ์ƒํƒœ ํ™•์ธ: `SuperClaude install --list-components` -- ๋„์›€๋ง ๋ฐ›๊ธฐ: [๋ฌธ์ œ ํ•ด๊ฒฐ ๊ฐ€์ด๋“œ](../Reference/troubleshooting.md) - -## ๋‹ค์Œ ๋‹จ๊ณ„ - -- [ํ”Œ๋ž˜๊ทธ ๊ฐ€์ด๋“œ](flags.md) - ๋ช…๋ น์–ด ๋™์ž‘ ์ œ์–ด -- [์—์ด์ „ํŠธ ๊ฐ€์ด๋“œ](agents.md) - ์ „๋ฌธ๊ฐ€ ํ™œ์„ฑํ™” -- [์˜ˆ์ œ ๋ชจ์Œ](../Reference/examples-cookbook.md) - ์‹ค์ œ ์‚ฌ์šฉ ํŒจํ„ด - diff --git a/docs/User-Guide-kr/flags.md b/docs/User-Guide-kr/flags.md deleted file mode 100644 index 5689edd..0000000 --- a/docs/User-Guide-kr/flags.md +++ /dev/null @@ -1,271 +0,0 @@ -# SuperClaude ํ”Œ๋ž˜๊ทธ ๊ฐ€์ด๋“œ ๐Ÿ - -**๋Œ€๋ถ€๋ถ„์˜ ํ”Œ๋ž˜๊ทธ๋Š” ์ž๋™์œผ๋กœ ํ™œ์„ฑํ™”๋ฉ๋‹ˆ๋‹ค** - Claude Code๊ฐ€ ์š”์ฒญ์˜ ํ‚ค์›Œ๋“œ์™€ ํŒจํ„ด์„ ๊ธฐ๋ฐ˜์œผ๋กœ ์ ์ ˆํ•œ ์ปจํ…์ŠคํŠธ๋ฅผ ์ฐธ์—ฌ์‹œํ‚ค๋Š” ํ–‰๋™ ์ง€์นจ์„ ์ฝ์Šต๋‹ˆ๋‹ค. - -## ํ•„์ˆ˜ ์ž๋™ ํ™œ์„ฑํ™” ํ”Œ๋ž˜๊ทธ (์‚ฌ์šฉ ์‚ฌ๋ก€์˜ 90%) - -### ํ•ต์‹ฌ ๋ถ„์„ ํ”Œ๋ž˜๊ทธ -| ํ”Œ๋ž˜๊ทธ | ํ™œ์„ฑํ™” ์‹œ์  | ์ˆ˜ํ–‰ ์ž‘์—… | -|------|---------------|--------------| -| `--think` | 5๊ฐœ ์ด์ƒ ํŒŒ์ผ ๋˜๋Š” ๋ณต์žกํ•œ ๋ถ„์„ | ํ‘œ์ค€ ๊ตฌ์กฐํ™”๋œ ๋ถ„์„ (~4K ํ† ํฐ) | -| `--think-hard` | ์•„ํ‚คํ…์ฒ˜ ๋ถ„์„, ์‹œ์Šคํ…œ ์ข…์†์„ฑ | ํ–ฅ์ƒ๋œ ๋„๊ตฌ๋ฅผ ์‚ฌ์šฉํ•œ ์‹ฌ์ธต ๋ถ„์„ (~10K ํ† ํฐ) | -| `--ultrathink` | ์ค‘์š”ํ•œ ์‹œ์Šคํ…œ ์žฌ์„ค๊ณ„, ๋ ˆ๊ฑฐ์‹œ ํ˜„๋Œ€ํ™” | ๋ชจ๋“  ๋„๊ตฌ๋ฅผ ์‚ฌ์šฉํ•œ ์ตœ๋Œ€ ๊นŠ์ด ๋ถ„์„ (~32K ํ† ํฐ) | - -### MCP ์„œ๋ฒ„ ํ”Œ๋ž˜๊ทธ -| ํ”Œ๋ž˜๊ทธ | ์„œ๋ฒ„ | ๋ชฉ์  | ์ž๋™ ํŠธ๋ฆฌ๊ฑฐ | -|------|---------|---------|---------------| -| `--c7` / `--context7` | Context7 | ๊ณต์‹ ๋ฌธ์„œ, ํ”„๋ ˆ์ž„์›Œํฌ ํŒจํ„ด | ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ์ž„ํฌํŠธ, ํ”„๋ ˆ์ž„์›Œํฌ ์งˆ๋ฌธ | -| `--seq` / `--sequential` | Sequential | ๋‹ค๋‹จ๊ณ„ ์ถ”๋ก , ๋””๋ฒ„๊น… | ๋ณต์žกํ•œ ๋””๋ฒ„๊น…, ์‹œ์Šคํ…œ ์„ค๊ณ„ | -| `--magic` | Magic | UI ์ปดํฌ๋„ŒํŠธ ์ƒ์„ฑ | `/ui` ๋ช…๋ น์–ด, ํ”„๋ก ํŠธ์—”๋“œ ํ‚ค์›Œ๋“œ | -| `--play` / `--playwright` | Playwright | ๋ธŒ๋ผ์šฐ์ € ํ…Œ์ŠคํŒ…, E2E ๊ฒ€์ฆ | ํ…Œ์ŠคํŒ… ์š”์ฒญ, ์‹œ๊ฐ์  ๊ฒ€์ฆ | -| `--morph` / `--morphllm` | Morphllm | ๋Œ€๋Ÿ‰ ๋ณ€ํ™˜, ํŒจํ„ด ํŽธ์ง‘ | ๋Œ€๋Ÿ‰ ์ž‘์—…, ์Šคํƒ€์ผ ๊ฐ•์ œ | -| `--serena` | Serena | ํ”„๋กœ์ ํŠธ ๋ฉ”๋ชจ๋ฆฌ, ์‹ฌ๋ณผ ์ž‘์—… | ์‹ฌ๋ณผ ์ž‘์—…, ๋Œ€๊ทœ๋ชจ ์ฝ”๋“œ๋ฒ ์ด์Šค | - -### ํ–‰๋™ ๋ชจ๋“œ ํ”Œ๋ž˜๊ทธ -| ํ”Œ๋ž˜๊ทธ | ํ™œ์„ฑํ™” ์‹œ์  | ์ˆ˜ํ–‰ ์ž‘์—… | -|------|---------------|--------------| -| `--brainstorm` | ๋ชจํ˜ธํ•œ ์š”์ฒญ, ํƒ์ƒ‰ ํ‚ค์›Œ๋“œ | ํ˜‘์—… ๋ฐœ๊ฒฌ ๋งˆ์ธ๋“œ์…‹ | -| `--introspect` | ์ž๊ธฐ ๋ถ„์„, ์˜ค๋ฅ˜ ๋ณต๊ตฌ | ํˆฌ๋ช…์„ฑ์„ ๊ฐ–์ถ˜ ์ถ”๋ก  ๊ณผ์ • ๋…ธ์ถœ | -| `--task-manage` | >3๋‹จ๊ณ„, ๋ณต์žกํ•œ ๋ฒ”์œ„ | ์œ„์ž„์„ ํ†ตํ•œ ์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜ | -| `--orchestrate` | ๋‹ค์ค‘ ๋„๊ตฌ ์ž‘์—…, ์„ฑ๋Šฅ ํ•„์š” | ๋„๊ตฌ ์„ ํƒ ๋ฐ ๋ณ‘๋ ฌ ์‹คํ–‰ ์ตœ์ ํ™” | -| `--token-efficient` / `--uc` | ์ปจํ…์ŠคํŠธ >75%, ํšจ์œจ์„ฑ ํ•„์š” | ์‹ฌ๋ณผ ๊ฐ•ํ™” ์ปค๋ฎค๋‹ˆ์ผ€์ด์…˜, 30-50% ๊ฐ์†Œ | - -### ์‹คํ–‰ ์ œ์–ด ํ”Œ๋ž˜๊ทธ -| ํ”Œ๋ž˜๊ทธ | ํ™œ์„ฑํ™” ์‹œ์  | ์ˆ˜ํ–‰ ์ž‘์—… | -|------|---------------|--------------| -| `--loop` | "๊ฐœ์„ ", "๋‹ค๋“ฌ๊ธฐ", "์ •์ œ" ํ‚ค์›Œ๋“œ | ๋ฐ˜๋ณต์  ํ–ฅ์ƒ ์‚ฌ์ดํด | -| `--safe-mode` | ํ”„๋กœ๋•์…˜, >85% ๋ฆฌ์†Œ์Šค ์‚ฌ์šฉ | ์ตœ๋Œ€ ๊ฒ€์ฆ, ๋ณด์ˆ˜์  ์‹คํ–‰ | -| `--validate` | ์œ„ํ—˜ >0.7, ํ”„๋กœ๋•์…˜ ํ™˜๊ฒฝ | ์‹คํ–‰ ์ „ ์œ„ํ—˜ ํ‰๊ฐ€ | -| `--delegate` | >7๊ฐœ ๋””๋ ‰ํ† ๋ฆฌ ๋˜๋Š” >50๊ฐœ ํŒŒ์ผ | ํ•˜์œ„ ์—์ด์ „ํŠธ ๋ณ‘๋ ฌ ์ฒ˜๋ฆฌ | - -## ๋ช…๋ น์–ด๋ณ„ ํ”Œ๋ž˜๊ทธ - -### ๋ถ„์„ ๋ช…๋ น์–ด ํ”Œ๋ž˜๊ทธ (`/sc:analyze`) -| ํ”Œ๋ž˜๊ทธ | ๋ชฉ์  | ๊ฐ’ | -|------|---------|--------| -| `--focus` | ํŠน์ • ๋„๋ฉ”์ธ ๋Œ€์ƒ | `security`, `performance`, `quality`, `architecture` | -| `--depth` | ๋ถ„์„ ์ฒ ์ €ํ•จ | `quick`, `deep` | -| `--format` | ์ถœ๋ ฅ ํ˜•์‹ | `text`, `json`, `report` | - -### ๋นŒ๋“œ ๋ช…๋ น์–ด ํ”Œ๋ž˜๊ทธ (`/sc:build`) -| ํ”Œ๋ž˜๊ทธ | ๋ชฉ์  | ๊ฐ’ | -|------|---------|--------| -| `--type` | ๋นŒ๋“œ ๊ตฌ์„ฑ | `dev`, `prod`, `test` | -| `--clean` | ๋นŒ๋“œ ์ „ ์ •๋ฆฌ | ๋ถˆ๋ฆฐ | -| `--optimize` | ์ตœ์ ํ™” ํ™œ์„ฑํ™” | ๋ถˆ๋ฆฐ | -| `--verbose` | ์ƒ์„ธ ์ถœ๋ ฅ | ๋ถˆ๋ฆฐ | - -### ๋””์ž์ธ ๋ช…๋ น์–ด ํ”Œ๋ž˜๊ทธ (`/sc:design`) -| ํ”Œ๋ž˜๊ทธ | ๋ชฉ์  | ๊ฐ’ | -|------|---------|--------| -| `--type` | ๋””์ž์ธ ๋Œ€์ƒ | `architecture`, `api`, `component`, `database` | -| `--format` | ์ถœ๋ ฅ ํ˜•์‹ | `diagram`, `spec`, `code` | - -### ์„ค๋ช… ๋ช…๋ น์–ด ํ”Œ๋ž˜๊ทธ (`/sc:explain`) -| ํ”Œ๋ž˜๊ทธ | ๋ชฉ์  | ๊ฐ’ | -|------|---------|--------| -| `--level` | ๋ณต์žก์„ฑ ์ˆ˜์ค€ | `basic`, `intermediate`, `advanced` | -| `--format` | ์„ค๋ช… ์Šคํƒ€์ผ | `text`, `examples`, `interactive` | -| `--context` | ๋„๋ฉ”์ธ ์ปจํ…์ŠคํŠธ | ๋ชจ๋“  ๋„๋ฉ”์ธ (์˜ˆ: `react`, `security`) | - -### ๊ฐœ์„  ๋ช…๋ น์–ด ํ”Œ๋ž˜๊ทธ (`/sc:improve`) -| ํ”Œ๋ž˜๊ทธ | ๋ชฉ์  | ๊ฐ’ | -|------|---------|--------| -| `--type` | ๊ฐœ์„  ์ดˆ์  | `quality`, `performance`, `maintainability`, `style`, `security` | -| `--safe` | ๋ณด์ˆ˜์  ์ ‘๊ทผ | ๋ถˆ๋ฆฐ | -| `--interactive` | ์‚ฌ์šฉ์ž ์•ˆ๋‚ด | ๋ถˆ๋ฆฐ | -| `--preview` | ์‹คํ–‰ ์—†์ด ํ‘œ์‹œ | ๋ถˆ๋ฆฐ | - -### ์ž‘์—… ๋ช…๋ น์–ด ํ”Œ๋ž˜๊ทธ (`/sc:task`) -| ํ”Œ๋ž˜๊ทธ | ๋ชฉ์  | ๊ฐ’ | -|------|---------|--------| -| `--strategy` | ์ž‘์—… ์ ‘๊ทผ๋ฒ• | `systematic`, `agile`, `enterprise` | -| `--parallel` | ๋ณ‘๋ ฌ ์‹คํ–‰ | ๋ถˆ๋ฆฐ | -| `--delegate` | ํ•˜์œ„ ์—์ด์ „ํŠธ ์กฐ์ • | ๋ถˆ๋ฆฐ | - -### ์›Œํฌํ”Œ๋กœ์šฐ ๋ช…๋ น์–ด ํ”Œ๋ž˜๊ทธ (`/sc:workflow`) -| ํ”Œ๋ž˜๊ทธ | ๋ชฉ์  | ๊ฐ’ | -|------|---------|--------| -| `--strategy` | ์›Œํฌํ”Œ๋กœ์šฐ ์ ‘๊ทผ๋ฒ• | `systematic`, `agile`, `enterprise` | -| `--depth` | ๋ถ„์„ ๊นŠ์ด | `shallow`, `normal`, `deep` | -| `--parallel` | ๋ณ‘๋ ฌ ์กฐ์ • | ๋ถˆ๋ฆฐ | - -### ๋ฌธ์ œ ํ•ด๊ฒฐ ๋ช…๋ น์–ด ํ”Œ๋ž˜๊ทธ (`/sc:troubleshoot`) -| ํ”Œ๋ž˜๊ทธ | ๋ชฉ์  | ๊ฐ’ | -|------|---------|--------| -| `--type` | ๋ฌธ์ œ ์นดํ…Œ๊ณ ๋ฆฌ | `bug`, `build`, `performance`, `deployment` | -| `--trace` | ์ถ”์  ๋ถ„์„ ํฌํ•จ | ๋ถˆ๋ฆฐ | -| `--fix` | ์ˆ˜์ • ์ ์šฉ | ๋ถˆ๋ฆฐ | - -### ์ •๋ฆฌ ๋ช…๋ น์–ด ํ”Œ๋ž˜๊ทธ (`/sc:cleanup`) -| ํ”Œ๋ž˜๊ทธ | ๋ชฉ์  | ๊ฐ’ | -|------|---------|--------| -| `--type` | ์ •๋ฆฌ ๋Œ€์ƒ | `code`, `imports`, `files`, `all` | -| `--safe` / `--aggressive` | ์ •๋ฆฌ ๊ฐ•๋„ | ๋ถˆ๋ฆฐ | -| `--interactive` | ์‚ฌ์šฉ์ž ์•ˆ๋‚ด | ๋ถˆ๋ฆฐ | -| `--preview` | ์‹คํ–‰ ์—†์ด ํ‘œ์‹œ | ๋ถˆ๋ฆฐ | - -### ์ถ”์ • ๋ช…๋ น์–ด ํ”Œ๋ž˜๊ทธ (`/sc:estimate`) -| ํ”Œ๋ž˜๊ทธ | ๋ชฉ์  | ๊ฐ’ | -|------|---------|--------| -| `--type` | ์ถ”์ • ์ดˆ์  | `time`, `effort`, `complexity` | -| `--unit` | ์‹œ๊ฐ„ ๋‹จ์œ„ | `hours`, `days`, `weeks` | -| `--breakdown` | ์ƒ์„ธ ๋ถ„ํ•ด | ๋ถˆ๋ฆฐ | - -### ์ธ๋ฑ์Šค ๋ช…๋ น์–ด ํ”Œ๋ž˜๊ทธ (`/sc:index`) -| ํ”Œ๋ž˜๊ทธ | ๋ชฉ์  | ๊ฐ’ | -|------|---------|--------| -| `--type` | ์ธ๋ฑ์Šค ๋Œ€์ƒ | `docs`, `api`, `structure`, `readme` | -| `--format` | ์ถœ๋ ฅ ํ˜•์‹ | `md`, `json`, `yaml` | - -### ์„ฑ์ฐฐ ๋ช…๋ น์–ด ํ”Œ๋ž˜๊ทธ (`/sc:reflect`) -| ํ”Œ๋ž˜๊ทธ | ๋ชฉ์  | ๊ฐ’ | -|------|---------|--------| -| `--type` | ์„ฑ์ฐฐ ๋ฒ”์œ„ | `task`, `session`, `completion` | -| `--analyze` | ๋ถ„์„ ํฌํ•จ | ๋ถˆ๋ฆฐ | -| `--validate` | ์™„์ „์„ฑ ๊ฒ€์ฆ | ๋ถˆ๋ฆฐ | - -### ์Šคํฐ ๋ช…๋ น์–ด ํ”Œ๋ž˜๊ทธ (`/sc:spawn`) -| ํ”Œ๋ž˜๊ทธ | ๋ชฉ์  | ๊ฐ’ | -|------|---------|--------| -| `--strategy` | ์กฐ์ • ์ ‘๊ทผ๋ฒ• | `sequential`, `parallel`, `adaptive` | -| `--depth` | ๋ถ„์„ ๊นŠ์ด | `normal`, `deep` | - -### Git ๋ช…๋ น์–ด ํ”Œ๋ž˜๊ทธ (`/sc:git`) -| ํ”Œ๋ž˜๊ทธ | ๋ชฉ์  | ๊ฐ’ | -|------|---------|--------| -| `--smart-commit` | ์ปค๋ฐ‹ ๋ฉ”์‹œ์ง€ ์ƒ์„ฑ | ๋ถˆ๋ฆฐ | -| `--interactive` | ์•ˆ๋‚ด ์ž‘์—… | ๋ถˆ๋ฆฐ | - -### ๋„๊ตฌ ์„ ํƒ ๋ช…๋ น์–ด ํ”Œ๋ž˜๊ทธ (`/sc:select-tool`) -| ํ”Œ๋ž˜๊ทธ | ๋ชฉ์  | ๊ฐ’ | -|------|---------|--------| -| `--analyze` | ๋„๊ตฌ ๋ถ„์„ | ๋ถˆ๋ฆฐ | -| `--explain` | ์„ ํƒ ์„ค๋ช… | ๋ถˆ๋ฆฐ | - -### ํ…Œ์ŠคํŠธ ๋ช…๋ น์–ด ํ”Œ๋ž˜๊ทธ (`/sc:test`) -| ํ”Œ๋ž˜๊ทธ | ๋ชฉ์  | ๊ฐ’ | -|------|---------|--------| -| `--coverage` | ์ปค๋ฒ„๋ฆฌ์ง€ ํฌํ•จ | ๋ถˆ๋ฆฐ | -| `--type` | ํ…Œ์ŠคํŠธ ์œ ํ˜• | `unit`, `integration`, `e2e` | -| `--watch` | ๊ฐ์‹œ ๋ชจ๋“œ | ๋ถˆ๋ฆฐ | - -## ๊ณ ๊ธ‰ ์ œ์–ด ํ”Œ๋ž˜๊ทธ - -### ๋ฒ”์œ„ ๋ฐ ์ดˆ์  -| ํ”Œ๋ž˜๊ทธ | ๋ชฉ์  | ๊ฐ’ | -|------|---------|--------| -| `--scope` | ๋ถ„์„ ๊ฒฝ๊ณ„ | `file`, `module`, `project`, `system` | -| `--focus` | ๋„๋ฉ”์ธ ํƒ€๊ฒŸํŒ… | `performance`, `security`, `quality`, `architecture`, `accessibility`, `testing` | - -### ์‹คํ–‰ ์ œ์–ด -| ํ”Œ๋ž˜๊ทธ | ๋ชฉ์  | ๊ฐ’ | -|------|---------|--------| -| `--concurrency [n]` | ๋ณ‘๋ ฌ ์ž‘์—… ์ œ์–ด | 1-15 | -| `--iterations [n]` | ๊ฐœ์„  ์‚ฌ์ดํด | 1-10 | -| `--all-mcp` | ๋ชจ๋“  MCP ์„œ๋ฒ„ ํ™œ์„ฑํ™” | ๋ถˆ๋ฆฐ | -| `--no-mcp` | ๋„ค์ดํ‹ฐ๋ธŒ ๋„๊ตฌ๋งŒ | ๋ถˆ๋ฆฐ | - -### ์‹œ์Šคํ…œ ํ”Œ๋ž˜๊ทธ (SuperClaude ์„ค์น˜) -| ํ”Œ๋ž˜๊ทธ | ๋ชฉ์  | ๊ฐ’ | -|------|---------|--------| -| `--verbose` / `-v` | ์ƒ์„ธ ๋กœ๊น… | ๋ถˆ๋ฆฐ | -| `--quiet` / `-q` | ์ถœ๋ ฅ ์–ต์ œ | ๋ถˆ๋ฆฐ | -| `--dry-run` | ์ž‘์—… ์‹œ๋ฎฌ๋ ˆ์ด์…˜ | ๋ถˆ๋ฆฐ | -| `--force` | ๊ฒ€์‚ฌ ๊ฑด๋„ˆ๋›ฐ๊ธฐ | ๋ถˆ๋ฆฐ | -| `--yes` / `-y` | ์ž๋™ ํ™•์ธ | ๋ถˆ๋ฆฐ | -| `--install-dir` | ๋Œ€์ƒ ๋””๋ ‰ํ† ๋ฆฌ | ๊ฒฝ๋กœ | -| `--legacy` | ๋ ˆ๊ฑฐ์‹œ ์Šคํฌ๋ฆฝํŠธ ์‚ฌ์šฉ | ๋ถˆ๋ฆฐ | -| `--version` | ๋ฒ„์ „ ํ‘œ์‹œ | ๋ถˆ๋ฆฐ | -| `--help` | ๋„์›€๋ง ํ‘œ์‹œ | ๋ถˆ๋ฆฐ | - -## ์ผ๋ฐ˜์ ์ธ ์‚ฌ์šฉ ํŒจํ„ด - -### ํ”„๋ก ํŠธ์—”๋“œ ๊ฐœ๋ฐœ -```bash -/sc:implement "๋ฐ˜์‘ํ˜• ๋Œ€์‹œ๋ณด๋“œ" --magic --c7 -/sc:design component-library --type component --format code -/sc:test ui-components/ --magic --play -/sc:improve legacy-ui/ --magic --morph --validate -``` - -### ๋ฐฑ์—”๋“œ ๊ฐœ๋ฐœ -```bash -/sc:analyze api/ --focus performance --seq --think -/sc:design payment-api --type api --format spec -/sc:troubleshoot "API ํƒ€์ž„์•„์›ƒ" --type performance --trace -/sc:improve auth-service --type security --validate -``` - -### ๋Œ€๊ทœ๋ชจ ํ”„๋กœ์ ํŠธ -```bash -/sc:analyze . --ultrathink --all-mcp --safe-mode -/sc:workflow enterprise-system --strategy enterprise --depth deep -/sc:cleanup . --type all --safe --interactive -/sc:estimate "๋งˆ์ดํฌ๋กœ์„œ๋น„์Šค๋กœ ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜" --type complexity --breakdown -``` - -### ํ’ˆ์งˆ ๋ฐ ์œ ์ง€๋ณด์ˆ˜ -```bash -/sc:improve src/ --type quality --safe --interactive -/sc:cleanup imports --type imports --preview -/sc:reflect --type completion --validate -/sc:git commit --smart-commit -``` - -## ํ”Œ๋ž˜๊ทธ ์ƒํ˜ธ์ž‘์šฉ - -### ํ˜ธํ™˜ ๊ฐ€๋Šฅํ•œ ์กฐํ•ฉ -- `--think` + `--c7`: ๋ฌธ์„œ๋ฅผ ์‚ฌ์šฉํ•œ ๋ถ„์„ -- `--magic` + `--play`: ํ…Œ์ŠคํŒ…์„ ์‚ฌ์šฉํ•œ UI ์ƒ์„ฑ -- `--serena` + `--morph`: ๋ณ€ํ™˜์„ ์‚ฌ์šฉํ•œ ํ”„๋กœ์ ํŠธ ๋ฉ”๋ชจ๋ฆฌ -- `--safe-mode` + `--validate`: ์ตœ๋Œ€ ์•ˆ์ „์„ฑ -- `--loop` + `--validate`: ๊ฒ€์ฆ์„ ํ†ตํ•œ ๋ฐ˜๋ณต์  ๊ฐœ์„  - -### ์ถฉ๋Œํ•˜๋Š” ํ”Œ๋ž˜๊ทธ -- `--all-mcp` vs ๊ฐœ๋ณ„ MCP ํ”Œ๋ž˜๊ทธ (ํ•˜๋‚˜๋งŒ ์‚ฌ์šฉ) -- `--no-mcp` vs ๋ชจ๋“  MCP ํ”Œ๋ž˜๊ทธ (--no-mcp ์šฐ์„ ) -- `--safe` vs `--aggressive` (์ •๋ฆฌ ๊ฐ•๋„) -- `--quiet` vs `--verbose` (์ถœ๋ ฅ ์ˆ˜์ค€) - -### ์ž๋™ ํ™œ์„ฑํ™” ๊ด€๊ณ„ -- `--safe-mode`๋Š” `--uc` ๋ฐ `--validate` ์ž๋™ ํ™œ์„ฑํ™” -- `--ultrathink`๋Š” ๋ชจ๋“  MCP ์„œ๋ฒ„ ์ž๋™ ํ™œ์„ฑํ™” -- `--think-hard`๋Š” `--seq` + `--c7` ์ž๋™ ํ™œ์„ฑํ™” -- `--magic`๋Š” UI ์ค‘์‹ฌ ์—์ด์ „ํŠธ ํŠธ๋ฆฌ๊ฑฐ - -## ํ”Œ๋ž˜๊ทธ ๋ฌธ์ œ ํ•ด๊ฒฐ - -### ์ผ๋ฐ˜์ ์ธ ๋ฌธ์ œ -- **๋„ˆ๋ฌด ๋งŽ์€ ๋„๊ตฌ**: ๋„ค์ดํ‹ฐ๋ธŒ ๋„๊ตฌ๋งŒ ํ…Œ์ŠคํŠธํ•˜๋ ค๋ฉด `--no-mcp` ์‚ฌ์šฉ -- **์ž‘์—…์ด ๋„ˆ๋ฌด ๋Š๋ฆผ**: ์ถœ๋ ฅ ์••์ถ•์„ ์œ„ํ•ด `--uc` ์ถ”๊ฐ€ -- **๊ฒ€์ฆ ์ฐจ๋‹จ**: ๊ฐœ๋ฐœ ์ค‘์—๋Š” `--safe-mode` ๋Œ€์‹  `--validate` ์‚ฌ์šฉ -- **์ปจํ…์ŠคํŠธ ์••๋ฐ•**: >75% ์‚ฌ์šฉ ์‹œ `--token-efficient` ์ž๋™ ํ™œ์„ฑํ™” - -### ๋””๋ฒ„๊ทธ ํ”Œ๋ž˜๊ทธ -```bash -/sc:analyze . --verbose # ๊ฒฐ์ • ๋กœ์ง ๋ฐ ํ”Œ๋ž˜๊ทธ ํ™œ์„ฑํ™” ํ‘œ์‹œ -/sc:select-tool "์ž‘์—…" --explain # ๋„๊ตฌ ์„ ํƒ ๊ณผ์ • ์„ค๋ช… -/sc:reflect --type session --analyze # ํ˜„์žฌ ์„ธ์…˜ ๊ฒฐ์ • ๊ฒ€ํ†  -``` - -### ๋น ๋ฅธ ์ˆ˜์ • -```bash -/sc:analyze . --help # ๋ช…๋ น์–ด์— ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ ํ”Œ๋ž˜๊ทธ ํ‘œ์‹œ -/sc:analyze . --no-mcp # ๋„ค์ดํ‹ฐ๋ธŒ ์‹คํ–‰๋งŒ -/sc:cleanup . --preview # ์ •๋ฆฌ๋  ๋‚ด์šฉ ํ‘œ์‹œ -``` - -## ํ”Œ๋ž˜๊ทธ ์šฐ์„ ์ˆœ์œ„ ๊ทœ์น™ - -1. **์•ˆ์ „ ์šฐ์„ **: `--safe-mode` > `--validate` > ์ตœ์ ํ™” ํ”Œ๋ž˜๊ทธ -2. **๋ช…์‹œ์  ์žฌ์ •์˜**: ์‚ฌ์šฉ์ž ํ”Œ๋ž˜๊ทธ > ์ž๋™ ๊ฐ์ง€ -3. **๊นŠ์ด ๊ณ„์ธต**: `--ultrathink` > `--think-hard` > `--think` -4. **MCP ์ œ์–ด**: `--no-mcp`๊ฐ€ ๋ชจ๋“  ๊ฐœ๋ณ„ MCP ํ”Œ๋ž˜๊ทธ ์žฌ์ •์˜ -5. **๋ฒ”์œ„ ์šฐ์„ ์ˆœ์œ„**: system > project > module > file - -## ๊ด€๋ จ ๋ฆฌ์†Œ์Šค -- [๋ช…๋ น์–ด ๊ฐ€์ด๋“œ](commands.md) - ์ด๋Ÿฌํ•œ ํ”Œ๋ž˜๊ทธ๋ฅผ ์‚ฌ์šฉํ•˜๋Š” ๋ช…๋ น์–ด -- [MCP ์„œ๋ฒ„ ๊ฐ€์ด๋“œ](mcp-servers.md) - MCP ํ”Œ๋ž˜๊ทธ ํ™œ์„ฑํ™” ์ดํ•ด -- [์„ธ์…˜ ๊ด€๋ฆฌ](session-management.md) - ์˜๊ตฌ ์„ธ์…˜์—์„œ ํ”Œ๋ž˜๊ทธ ์‚ฌ์šฉ - diff --git a/docs/User-Guide-kr/mcp-servers.md b/docs/User-Guide-kr/mcp-servers.md deleted file mode 100644 index 0f38de0..0000000 --- a/docs/User-Guide-kr/mcp-servers.md +++ /dev/null @@ -1,340 +0,0 @@ -# SuperClaude MCP ์„œ๋ฒ„ ๊ฐ€์ด๋“œ ๐Ÿ”Œ - -## ๊ฐœ์š” - -MCP (Model Context Protocol) ์„œ๋ฒ„๋Š” ์ „๋ฌธ ๋„๊ตฌ๋ฅผ ํ†ตํ•ด Claude Code์˜ ๊ธฐ๋Šฅ์„ ํ™•์žฅํ•ฉ๋‹ˆ๋‹ค. SuperClaude๋Š” 8๊ฐœ์˜ MCP ์„œ๋ฒ„๋ฅผ ํ†ตํ•ฉํ•˜๊ณ  ์ž‘์—…์— ๋”ฐ๋ผ ์–ธ์ œ ํ™œ์„ฑํ™”ํ• ์ง€์— ๋Œ€ํ•œ ์ง€์นจ์„ Claude์— ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค. - -### ๐Ÿ” ํ˜„์‹ค ํ™•์ธ -- **MCP ์„œ๋ฒ„๋ž€**: ์ถ”๊ฐ€ ๋„๊ตฌ๋ฅผ ์ œ๊ณตํ•˜๋Š” ์™ธ๋ถ€ Node.js ํ”„๋กœ์„ธ์Šค -- **MCP ์„œ๋ฒ„๊ฐ€ ์•„๋‹Œ ๊ฒƒ**: ๋‚ด์žฅ๋œ SuperClaude ๊ธฐ๋Šฅ -- **ํ™œ์„ฑํ™” ๋ฐฉ์‹**: Claude๊ฐ€ ์ปจํ…์ŠคํŠธ์— ๋”ฐ๋ผ ์ ์ ˆํ•œ ์„œ๋ฒ„๋ฅผ ์‚ฌ์šฉํ•˜๋„๋ก ์ง€์นจ์„ ์ฝ์Œ -- **์ œ๊ณตํ•˜๋Š” ๊ฒƒ**: Claude Code์˜ ๋„ค์ดํ‹ฐ๋ธŒ ๊ธฐ๋Šฅ์„ ํ™•์žฅํ•˜๋Š” ์‹ค์ œ ๋„๊ตฌ - -**ํ•ต์‹ฌ ์„œ๋ฒ„:** -- **context7**: ๊ณต์‹ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ๋ฌธ์„œ ๋ฐ ํŒจํ„ด -- **sequential-thinking**: ๋‹ค๋‹จ๊ณ„ ์ถ”๋ก  ๋ฐ ๋ถ„์„ -- **magic**: ํ˜„๋Œ€์ ์ธ UI ์ปดํฌ๋„ŒํŠธ ์ƒ์„ฑ -- **playwright**: ๋ธŒ๋ผ์šฐ์ € ์ž๋™ํ™” ๋ฐ E2E ํ…Œ์ŠคํŒ… -- **morphllm-fast-apply**: ํŒจํ„ด ๊ธฐ๋ฐ˜ ์ฝ”๋“œ ๋ณ€ํ™˜ -- **serena**: ์˜๋ฏธ๋ก ์  ์ฝ”๋“œ ์ดํ•ด ๋ฐ ํ”„๋กœ์ ํŠธ ๋ฉ”๋ชจ๋ฆฌ -- **tavily**: ์›น ๊ฒ€์ƒ‰ ๋ฐ ์‹ค์‹œ๊ฐ„ ์ •๋ณด ๊ฒ€์ƒ‰ -- **chrome-devtools**: ์„ฑ๋Šฅ ๋ถ„์„ ๋ฐ ๋””๋ฒ„๊น… - -## ๋น ๋ฅธ ์‹œ์ž‘ - -**์„ค์ • ํ™•์ธ**: MCP ์„œ๋ฒ„๋Š” ์ž๋™์œผ๋กœ ํ™œ์„ฑํ™”๋ฉ๋‹ˆ๋‹ค. ์„ค์น˜ ๋ฐ ๋ฌธ์ œ ํ•ด๊ฒฐ์€ [์„ค์น˜ ๊ฐ€์ด๋“œ](../Getting-Started/installation.md) ๋ฐ [๋ฌธ์ œ ํ•ด๊ฒฐ](../Reference/troubleshooting.md)์„ ์ฐธ์กฐํ•˜์„ธ์š”. - -**์ž๋™ ํ™œ์„ฑํ™” ๋กœ์ง:** - -| ์š”์ฒญ ํฌํ•จ | ํ™œ์„ฑํ™”๋˜๋Š” ์„œ๋ฒ„ | -|-----------------|------------------| -| ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ์ž„ํฌํŠธ, API ์ด๋ฆ„ | **context7** | -| `--think`, ๋””๋ฒ„๊น… | **sequential-thinking** | -| `component`, `UI`, frontend | **magic** | -| `test`, `e2e`, `browser` | **playwright** | -| ๋‹ค์ค‘ ํŒŒ์ผ ํŽธ์ง‘, ๋ฆฌํŒฉํ† ๋ง | **morphllm-fast-apply** | -| ๋Œ€๊ทœ๋ชจ ํ”„๋กœ์ ํŠธ, ์„ธ์…˜ | **serena** | -| `/sc:research`, `latest`, `current` | **tavily** | -| `performance`, `debug`, `LCP` | **chrome-devtools** | - -## ์„œ๋ฒ„ ์„ธ๋ถ€์ •๋ณด - -### context7 ๐Ÿ“š -**๋ชฉ์ **: ๊ณต์‹ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ๋ฌธ์„œ ์•ก์„ธ์Šค -**ํŠธ๋ฆฌ๊ฑฐ**: Import ๋ฌธ, ํ”„๋ ˆ์ž„์›Œํฌ ํ‚ค์›Œ๋“œ, ๋ฌธ์„œ ์š”์ฒญ -**์š”๊ตฌ์‚ฌํ•ญ**: Node.js 16+, API ํ‚ค ๋ถˆํ•„์š” - -```bash -# ์ž๋™ ํ™œ์„ฑํ™” -/sc:implement "React ์ธ์ฆ ์‹œ์Šคํ…œ" -# โ†’ ๊ณต์‹ React ํŒจํ„ด ์ œ๊ณต - -# ์ˆ˜๋™ ํ™œ์„ฑํ™” -/sc:analyze auth-system/ --c7 -``` - -### sequential-thinking ๐Ÿง  -**๋ชฉ์ **: ๊ตฌ์กฐํ™”๋œ ๋‹ค๋‹จ๊ณ„ ์ถ”๋ก  ๋ฐ ์ฒด๊ณ„์  ๋ถ„์„ -**ํŠธ๋ฆฌ๊ฑฐ**: ๋ณต์žกํ•œ ๋””๋ฒ„๊น…, `--think` ํ”Œ๋ž˜๊ทธ, ์•„ํ‚คํ…์ฒ˜ ๋ถ„์„ -**์š”๊ตฌ์‚ฌํ•ญ**: Node.js 16+, API ํ‚ค ๋ถˆํ•„์š” - -```bash -# ์ž๋™ ํ™œ์„ฑํ™” -/sc:troubleshoot "API ์„ฑ๋Šฅ ๋ฌธ์ œ" -# โ†’ ์ฒด๊ณ„์ ์ธ ๊ทผ๋ณธ ์›์ธ ๋ถ„์„ ํ™œ์„ฑํ™” - -# ์ˆ˜๋™ ํ™œ์„ฑํ™” -/sc:analyze --think-hard architecture/ -``` - -### magic โœจ -**๋ชฉ์ **: 21st.dev ํŒจํ„ด์—์„œ ํ˜„๋Œ€์ ์ธ UI ์ปดํฌ๋„ŒํŠธ ์ƒ์„ฑ -**ํŠธ๋ฆฌ๊ฑฐ**: UI ์š”์ฒญ, `/ui` ๋ช…๋ น์–ด, ์ปดํฌ๋„ŒํŠธ ๊ฐœ๋ฐœ -**์š”๊ตฌ์‚ฌํ•ญ**: Node.js 16+, TWENTYFIRST_API_KEY () - -```bash -# ์ž๋™ ํ™œ์„ฑํ™” -/sc:implement "๋ฐ˜์‘ํ˜• ๋Œ€์‹œ๋ณด๋“œ ์ปดํฌ๋„ŒํŠธ" -# โ†’ ํ˜„๋Œ€์ ์ธ ํŒจํ„ด์œผ๋กœ ์ ‘๊ทผ ๊ฐ€๋Šฅํ•œ UI ์ƒ์„ฑ - -# API ํ‚ค ์„ค์ • -export TWENTYFIRST_API_KEY="your_key_here" -``` - -### playwright ๐ŸŽญ -**๋ชฉ์ **: ์‹ค์ œ ๋ธŒ๋ผ์šฐ์ € ์ž๋™ํ™” ๋ฐ E2E ํ…Œ์ŠคํŒ… -**ํŠธ๋ฆฌ๊ฑฐ**: ๋ธŒ๋ผ์šฐ์ € ํ…Œ์ŠคํŒ…, E2E ์‹œ๋‚˜๋ฆฌ์˜ค, ์‹œ๊ฐ์  ๊ฒ€์ฆ -**์š”๊ตฌ์‚ฌํ•ญ**: Node.js 16+, API ํ‚ค ๋ถˆํ•„์š” - -```bash -# ์ž๋™ ํ™œ์„ฑํ™” -/sc:test --type e2e "์‚ฌ์šฉ์ž ๋กœ๊ทธ์ธ ํ๋ฆ„" -# โ†’ ๋ธŒ๋ผ์šฐ์ € ์ž๋™ํ™” ํ…Œ์ŠคํŒ… ํ™œ์„ฑํ™” - -# ์ˆ˜๋™ ํ™œ์„ฑํ™” -/sc:validate "์ ‘๊ทผ์„ฑ ๊ทœ์ • ์ค€์ˆ˜" --play -``` - -### morphllm-fast-apply ๐Ÿ”„ -**๋ชฉ์ **: ํšจ์œจ์ ์ธ ํŒจํ„ด ๊ธฐ๋ฐ˜ ์ฝ”๋“œ ๋ณ€ํ™˜ -**ํŠธ๋ฆฌ๊ฑฐ**: ๋‹ค์ค‘ ํŒŒ์ผ ํŽธ์ง‘, ๋ฆฌํŒฉํ† ๋ง, ํ”„๋ ˆ์ž„์›Œํฌ ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜ -**์š”๊ตฌ์‚ฌํ•ญ**: Node.js 16+, MORPH_API_KEY - -```bash -# ์ž๋™ ํ™œ์„ฑํ™” -/sc:improve legacy-codebase/ --focus maintainability -# โ†’ ํŒŒ์ผ ์ „๋ฐ˜์— ์ผ๊ด€๋œ ํŒจํ„ด ์ ์šฉ - -# API ํ‚ค ์„ค์ • -export MORPH_API_KEY="your_key_here" -``` - -### serena ๐Ÿงญ -**๋ชฉ์ **: ํ”„๋กœ์ ํŠธ ๋ฉ”๋ชจ๋ฆฌ๋ฅผ ๊ฐ–์ถ˜ ์˜๋ฏธ๋ก ์  ์ฝ”๋“œ ์ดํ•ด -**ํŠธ๋ฆฌ๊ฑฐ**: ์‹ฌ๋ณผ ์ž‘์—…, ๋Œ€๊ทœ๋ชจ ์ฝ”๋“œ๋ฒ ์ด์Šค, ์„ธ์…˜ ๊ด€๋ฆฌ -**์š”๊ตฌ์‚ฌํ•ญ**: Python 3.9+, uv ํŒจํ‚ค์ง€ ๋งค๋‹ˆ์ €, API ํ‚ค ๋ถˆํ•„์š” - -```bash -# ์ž๋™ ํ™œ์„ฑํ™” -/sc:load existing-project/ -# โ†’ ํ”„๋กœ์ ํŠธ ์ดํ•ด ๋ฐ ๋ฉ”๋ชจ๋ฆฌ ๊ตฌ์ถ• - -# ์ˆ˜๋™ ํ™œ์„ฑํ™” -/sc:refactor "UserService ์ถ”์ถœ" --serena -``` - -### tavily ๐Ÿ” -**๋ชฉ์ **: ์—ฐ๊ตฌ๋ฅผ ์œ„ํ•œ ์›น ๊ฒ€์ƒ‰ ๋ฐ ์‹ค์‹œ๊ฐ„ ์ •๋ณด ๊ฒ€์ƒ‰ -**ํŠธ๋ฆฌ๊ฑฐ**: `/sc:research` ๋ช…๋ น์–ด, "์ตœ์‹ " ์ •๋ณด ์š”์ฒญ, ์ตœ์‹  ์ด๋ฒคํŠธ, ์‚ฌ์‹ค ํ™•์ธ -**์š”๊ตฌ์‚ฌํ•ญ**: Node.js 16+, TAVILY_API_KEY (https://app.tavily.com์—์„œ ๋ฌด๋ฃŒ ํ‹ฐ์–ด ์‚ฌ์šฉ ๊ฐ€๋Šฅ) - -```bash -# ์ž๋™ ํ™œ์„ฑํ™” -/sc:research "2024๋…„ ์ตœ์‹  AI ๊ฐœ๋ฐœ" -# โ†’ ์ง€๋Šฅํ˜• ์›น ์—ฐ๊ตฌ ์ˆ˜ํ–‰ - -# ์ˆ˜๋™ ํ™œ์„ฑํ™” -/sc:analyze "์‹œ์žฅ ํŠธ๋ Œ๋“œ" --tavily - -# API ํ‚ค ์„ค์ • (https://app.tavily.com์—์„œ ๋ฌด๋ฃŒ ํ‚ค ๋ฐ›๊ธฐ) -export TAVILY_API_KEY="tvly-your_api_key_here" -``` - -### chrome-devtools ๐Ÿ“Š -**๋ชฉ์ **: ์„ฑ๋Šฅ ๋ถ„์„, ๋””๋ฒ„๊น…, ์‹ค์‹œ๊ฐ„ ๋ธŒ๋ผ์šฐ์ € ๊ฒ€์‚ฌ -**ํŠธ๋ฆฌ๊ฑฐ**: ์„ฑ๋Šฅ ๊ฐ์‚ฌ, ๋ ˆ์ด์•„์›ƒ ๋ฌธ์ œ ๋””๋ฒ„๊น… (์˜ˆ: CLS), ๋Š๋ฆฐ ๋กœ๋”ฉ ์‹œ๊ฐ„ (LCP), ์ฝ˜์†” ์˜ค๋ฅ˜, ๋„คํŠธ์›Œํฌ ์š”์ฒญ -**์š”๊ตฌ์‚ฌํ•ญ**: Node.js 16+, API ํ‚ค ๋ถˆํ•„์š” - -```bash -# ์ž๋™ ํ™œ์„ฑํ™” -/sc:debug "ํŽ˜์ด์ง€ ๋กœ๋”ฉ์ด ๋Š๋ฆผ" -# โ†’ Chrome DevTools๋กœ ์„ฑ๋Šฅ ๋ถ„์„ ํ™œ์„ฑํ™” - -# ์ˆ˜๋™ ํ™œ์„ฑํ™” -/sc:analyze --performance "ํ™ˆํŽ˜์ด์ง€" -``` - -**๊ธฐ๋Šฅ:** -- **์›น ๊ฒ€์ƒ‰**: ๋žญํ‚น ๋ฐ ํ•„ํ„ฐ๋ง์„ ํ†ตํ•œ ํฌ๊ด„์ ์ธ ๊ฒ€์ƒ‰ -- **๋‰ด์Šค ๊ฒ€์ƒ‰**: ์‹œ๊ฐ„ ํ•„ํ„ฐ๋ง๋œ ์ตœ์‹  ์ด๋ฒคํŠธ ๋ฐ ์—…๋ฐ์ดํŠธ -- **์ฝ˜ํ…์ธ  ์ถ”์ถœ**: ๊ฒ€์ƒ‰ ๊ฒฐ๊ณผ์—์„œ ์ „์ฒด ํ…์ŠคํŠธ ์ถ”์ถœ -- **๋„๋ฉ”์ธ ํ•„ํ„ฐ๋ง**: ํŠน์ • ๋„๋ฉ”์ธ ํฌํ•จ/์ œ์™ธ -- **๋‹ค์ค‘ ํ™‰ ์—ฐ๊ตฌ**: ๋ฐœ๊ฒฌ์— ๊ธฐ๋ฐ˜ํ•œ ๋ฐ˜๋ณต์  ๊ฒ€์ƒ‰ (์ตœ๋Œ€ 5ํ™‰) - -**์—ฐ๊ตฌ ๊นŠ์ด ์ œ์–ด:** -- `--depth quick`: 5-10๊ฐœ ์†Œ์Šค, ๊ธฐ๋ณธ ์ข…ํ•ฉ -- `--depth standard`: 10-20๊ฐœ ์†Œ์Šค, ๊ตฌ์กฐํ™”๋œ ๋ณด๊ณ ์„œ (๊ธฐ๋ณธ๊ฐ’) -- `--depth deep`: 20-40๊ฐœ ์†Œ์Šค, ํฌ๊ด„์  ๋ถ„์„ -- `--depth exhaustive`: 40๊ฐœ ์ด์ƒ ์†Œ์Šค, ํ•™์ˆ  ์ˆ˜์ค€ ์—ฐ๊ตฌ - -## ๊ตฌ์„ฑ - -**MCP ๊ตฌ์„ฑ ํŒŒ์ผ (`~/.claude.json`):** -```json -{ - "mcpServers": { - "context7": { - "command": "npx", - "args": ["-y", "@upstash/context7-mcp@latest"] - }, - "sequential-thinking": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"] - }, - "magic": { - "command": "npx", - "args": ["@21st-dev/magic"], - "env": {"TWENTYFIRST_API_KEY": "${TWENTYFIRST_API_KEY}"} - }, - "playwright": { - "command": "npx", - "args": ["@playwright/mcp@latest"] - }, - "morphllm-fast-apply": { - "command": "npx", - "args": ["@morph-llm/morph-fast-apply"], - "env": {"MORPH_API_KEY": "${MORPH_API_KEY}"} - }, - "serena": { - "command": "uvx", - "args": ["--from", "git+https://github.com/oraios/serena", "serena", "start-mcp-server", "--context", "ide-assistant"] - }, - "tavily": { - "command": "npx", - "args": ["-y", "tavily-mcp@latest"], - "env": {"TAVILY_API_KEY": "${TAVILY_API_KEY}"} - }, - "chrome-devtools": { - "command": "npx", - "args": ["-y", "chrome-devtools-mcp@latest"] - } - } -} -``` - -## ์‚ฌ์šฉ ํŒจํ„ด - -**์„œ๋ฒ„ ์ œ์–ด:** -```bash -# ํŠน์ • ์„œ๋ฒ„ ํ™œ์„ฑํ™” -/sc:analyze codebase/ --c7 --seq - -# ๋ชจ๋“  MCP ์„œ๋ฒ„ ๋น„ํ™œ์„ฑํ™” -/sc:implement "๊ฐ„๋‹จํ•œ ํ•จ์ˆ˜" --no-mcp - -# ๋ชจ๋“  ์„œ๋ฒ„ ํ™œ์„ฑํ™” -/sc:design "๋ณต์žกํ•œ ์•„ํ‚คํ…์ฒ˜" --all-mcp -``` - -**๋‹ค์ค‘ ์„œ๋ฒ„ ์กฐ์ •:** -```bash -# ํ’€์Šคํƒ ๊ฐœ๋ฐœ -/sc:implement "์ „์ž์ƒ๊ฑฐ๋ž˜ ์ฒดํฌ์•„์›ƒ" -# โ†’ Sequential: ์›Œํฌํ”Œ๋กœ์šฐ ๋ถ„์„ -# โ†’ Context7: ๊ฒฐ์ œ ํŒจํ„ด -# โ†’ Magic: UI ์ปดํฌ๋„ŒํŠธ -# โ†’ Serena: ์ฝ”๋“œ ์กฐ์ง -# โ†’ Playwright: E2E ํ…Œ์ŠคํŒ… -``` - -## ๋ฌธ์ œ ํ•ด๊ฒฐ - -**์ผ๋ฐ˜์ ์ธ ๋ฌธ์ œ:** -- **์„œ๋ฒ„ ์—ฐ๊ฒฐ ์—†์Œ**: Node.js ํ™•์ธ: `node --version` (v16+ ํ•„์š”) -- **Context7 ์‹คํŒจ**: ์บ์‹œ ์ •๋ฆฌ: `npm cache clean --force` -- **Magic/Morphllm ์˜ค๋ฅ˜**: API ํ‚ค ์—†์ด ์˜ˆ์ƒ๋จ (์œ ๋ฃŒ ์„œ๋น„์Šค) -- **์„œ๋ฒ„ ํƒ€์ž„์•„์›ƒ**: Claude Code ์„ธ์…˜ ์žฌ์‹œ์ž‘ - -**๋น ๋ฅธ ์ˆ˜์ •:** -```bash -# ์—ฐ๊ฒฐ ์žฌ์„ค์ • -# Claude Code ์„ธ์…˜ ์žฌ์‹œ์ž‘ - -# ์ข…์†์„ฑ ํ™•์ธ -node --version # v16+ ํ‘œ์‹œ๋˜์–ด์•ผ ํ•จ - -# MCP ์—†์ด ํ…Œ์ŠคํŠธ -/sc:command --no-mcp - -# ๊ตฌ์„ฑ ํ™•์ธ -ls ~/.claude.json -``` - -**API ํ‚ค ๊ตฌ์„ฑ:** -```bash -# Magic ์„œ๋ฒ„์šฉ (UI ์ƒ์„ฑ์— ํ•„์š”) -export TWENTYFIRST_API_KEY="your_key_here" - -# Morphllm ์„œ๋ฒ„์šฉ (๋Œ€๋Ÿ‰ ๋ณ€ํ™˜์— ํ•„์š”) -export MORPH_API_KEY="your_key_here" - -# Tavily ์„œ๋ฒ„์šฉ (์›น ๊ฒ€์ƒ‰์— ํ•„์š” - ๋ฌด๋ฃŒ ํ‹ฐ์–ด ์‚ฌ์šฉ ๊ฐ€๋Šฅ) -export TAVILY_API_KEY="tvly-your_key_here" - -# ์ง€์†์„ฑ์„ ์œ„ํ•ด ์…ธ ํ”„๋กœํ•„์— ์ถ”๊ฐ€ -echo 'export TWENTYFIRST_API_KEY="your_key"' >> ~/.bashrc -echo 'export MORPH_API_KEY="your_key"' >> ~/.bashrc -echo 'export TAVILY_API_KEY="your_key"' >> ~/.bashrc -``` - -**ํ™˜๊ฒฝ ๋ณ€์ˆ˜ ์‚ฌ์šฉ:** -- โœ… `TWENTYFIRST_API_KEY` - Magic MCP ์„œ๋ฒ„ ๊ธฐ๋Šฅ์— ํ•„์š” -- โœ… `MORPH_API_KEY` - Morphllm MCP ์„œ๋ฒ„ ๊ธฐ๋Šฅ์— ํ•„์š” -- โœ… `TAVILY_API_KEY` - Tavily MCP ์„œ๋ฒ„ ๊ธฐ๋Šฅ์— ํ•„์š” (๋ฌด๋ฃŒ ํ‹ฐ์–ด ์‚ฌ์šฉ ๊ฐ€๋Šฅ) -- โŒ ๋ฌธ์„œ์˜ ๋‹ค๋ฅธ ํ™˜๊ฒฝ ๋ณ€์ˆ˜ - ์˜ˆ์ œ์šฉ, ํ”„๋ ˆ์ž„์›Œํฌ์—์„œ ์‚ฌ์šฉํ•˜์ง€ ์•Š์Œ -- ๐Ÿ“ Magic๊ณผ Morphllm์€ ์œ ๋ฃŒ ์„œ๋น„์Šค, Tavily๋Š” ๋ฌด๋ฃŒ ํ‹ฐ์–ด ์žˆ์Œ, ํ”„๋ ˆ์ž„์›Œํฌ๋Š” ์ด๋“ค ์—†์ด๋„ ์ž‘๋™ - -## ์„œ๋ฒ„ ์กฐํ•ฉ - -**API ํ‚ค ์—†์Œ (๋ฌด๋ฃŒ)**: -- context7 + sequential-thinking + playwright + serena - -**API ํ‚ค 1๊ฐœ**: -- ์ „๋ฌธ UI ๊ฐœ๋ฐœ์„ ์œ„ํ•ด magic ์ถ”๊ฐ€ - -**API ํ‚ค 2๊ฐœ**: -- ๋Œ€๊ทœ๋ชจ ๋ฆฌํŒฉํ† ๋ง์„ ์œ„ํ•ด morphllm-fast-apply ์ถ”๊ฐ€ - -**์ผ๋ฐ˜์ ์ธ ์›Œํฌํ”Œ๋กœ์šฐ:** -- **ํ•™์Šต**: context7 + sequential-thinking -- **์›น ๊ฐœ๋ฐœ**: magic + context7 + playwright -- **์—”ํ„ฐํ”„๋ผ์ด์ฆˆ ๋ฆฌํŒฉํ† ๋ง**: serena + morphllm + sequential-thinking -- **๋ณต์žกํ•œ ๋ถ„์„**: sequential-thinking + context7 + serena -- **์‹ฌ์ธต ์—ฐ๊ตฌ**: tavily + sequential-thinking + serena + playwright -- **์ตœ์‹  ์ด๋ฒคํŠธ**: tavily + context7 + sequential-thinking -- **์„ฑ๋Šฅ ํŠœ๋‹**: chrome-devtools + sequential-thinking + playwright - -## ํ†ตํ•ฉ - -**SuperClaude ๋ช…๋ น์–ด์™€ ํ•จ๊ป˜:** -- ๋ถ„์„ ๋ช…๋ น์–ด๋Š” ์ž๋™์œผ๋กœ Sequential + Serena ์‚ฌ์šฉ -- ๊ตฌํ˜„ ๋ช…๋ น์–ด๋Š” Magic + Context7 ์‚ฌ์šฉ -- ํ…Œ์ŠคํŒ… ๋ช…๋ น์–ด๋Š” Playwright + Sequential ์‚ฌ์šฉ -- ์—ฐ๊ตฌ ๋ช…๋ น์–ด๋Š” Tavily + Sequential + Playwright ์‚ฌ์šฉ - -**ํ–‰๋™ ๋ชจ๋“œ์™€ ํ•จ๊ป˜:** -- ๋ธŒ๋ ˆ์ธ์Šคํ† ๋ฐ ๋ชจ๋“œ: ๋ฐœ๊ฒฌ์„ ์œ„ํ•œ Sequential -- ์ž‘์—… ๊ด€๋ฆฌ: ์ง€์†์„ฑ์„ ์œ„ํ•œ Serena -- ์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜ ๋ชจ๋“œ: ์ตœ์ ์˜ ์„œ๋ฒ„ ์„ ํƒ -- ์‹ฌ์ธต ์—ฐ๊ตฌ ๋ชจ๋“œ: Tavily + Sequential + Playwright ์กฐ์ • - -**์„ฑ๋Šฅ ์ œ์–ด:** -- ์‹œ์Šคํ…œ ๋ถ€ํ•˜์— ๋”ฐ๋ฅธ ์ž๋™ ๋ฆฌ์†Œ์Šค ๊ด€๋ฆฌ -- ๋™์‹œ์„ฑ ์ œ์–ด: `--concurrency N` (1-15) -- ์ œ์•ฝ ์กฐ๊ฑด ํ•˜์—์„œ ์šฐ์„ ์ˆœ์œ„ ๊ธฐ๋ฐ˜ ์„œ๋ฒ„ ์„ ํƒ - -## ๊ด€๋ จ ๋ฆฌ์†Œ์Šค - -**ํ•„์ˆ˜ ์ฝ๊ธฐ:** -- [๋ช…๋ น์–ด ๊ฐ€์ด๋“œ](commands.md) - MCP ์„œ๋ฒ„๋ฅผ ํ™œ์„ฑํ™”ํ•˜๋Š” ๋ช…๋ น์–ด -- [๋น ๋ฅธ ์‹œ์ž‘ ๊ฐ€์ด๋“œ](../Getting-Started/quick-start.md) - MCP ์„ค์ • ๊ฐ€์ด๋“œ - -**๊ณ ๊ธ‰ ์‚ฌ์šฉ:** -- [ํ–‰๋™ ๋ชจ๋“œ](modes.md) - ๋ชจ๋“œ-MCP ์กฐ์ • -- [์—์ด์ „ํŠธ ๊ฐ€์ด๋“œ](agents.md) - ์—์ด์ „ํŠธ-MCP ํ†ตํ•ฉ -- [์„ธ์…˜ ๊ด€๋ฆฌ](session-management.md) - Serena ์›Œํฌํ”Œ๋กœ์šฐ - -**๊ธฐ์ˆ  ์ฐธ์กฐ:** -- [์˜ˆ์ œ ๋ชจ์Œ](../Reference/examples-cookbook.md) - MCP ์›Œํฌํ”Œ๋กœ์šฐ ํŒจํ„ด -- [๊ธฐ์ˆ  ์•„ํ‚คํ…์ฒ˜](../Developer-Guide/technical-architecture.md) - ํ†ตํ•ฉ ์„ธ๋ถ€์‚ฌํ•ญ - diff --git a/docs/User-Guide-kr/modes.md b/docs/User-Guide-kr/modes.md deleted file mode 100644 index ddb8750..0000000 --- a/docs/User-Guide-kr/modes.md +++ /dev/null @@ -1,658 +0,0 @@ -# SuperClaude ํ–‰๋™ ๋ชจ๋“œ ๊ฐ€์ด๋“œ ๐Ÿง  - -## โœ… ๋น ๋ฅธ ํ™•์ธ -`/sc:` ๋ช…๋ น์–ด๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ๋ชจ๋“œ๋ฅผ ํ…Œ์ŠคํŠธํ•˜์„ธ์š” - ์ž‘์—… ๋ณต์žก์„ฑ์— ๋”ฐ๋ผ ์ž๋™์œผ๋กœ ํ™œ์„ฑํ™”๋ฉ๋‹ˆ๋‹ค. ์ „์ฒด ๋ช…๋ น์–ด ์ฐธ์กฐ๋Š” [๋ช…๋ น์–ด ๊ฐ€์ด๋“œ](commands.md)๋ฅผ ์ฐธ์กฐํ•˜์„ธ์š”. - -## ๋น ๋ฅธ ์ฐธ์กฐ ํ‘œ - -| ๋ชจ๋“œ | ๋ชฉ์  | ์ž๋™ ํŠธ๋ฆฌ๊ฑฐ | ์ฃผ์š” ๋™์ž‘ | ์ตœ์  ์‚ฌ์šฉ์ฒ˜ | -|------|---------|---------------|---------------|---------------| -| **๐Ÿง  ๋ธŒ๋ ˆ์ธ์Šคํ† ๋ฐ** | ๋Œ€ํ™”ํ˜• ๋ฐœ๊ฒฌ | "brainstorm", "maybe", ๋ชจํ˜ธํ•œ ์š”์ฒญ | ์†Œํฌ๋ผํ…Œ์Šค์‹ ์งˆ๋ฌธ, ์š”๊ตฌ์‚ฌํ•ญ ๋„์ถœ | ์ƒˆ ํ”„๋กœ์ ํŠธ ๊ณ„ํš, ๋ถˆ๋ช…ํ™•ํ•œ ์š”๊ตฌ์‚ฌํ•ญ | -| **๐Ÿ” ๋‚ด์„ฑ** | ๋ฉ”ํƒ€์ธ์ง€ ๋ถ„์„ | ์˜ค๋ฅ˜ ๋ณต๊ตฌ, "์ถ”๋ก  ๋ถ„์„" | ํˆฌ๋ช…ํ•œ ์‚ฌ๊ณ  ๋งˆ์ปค (๐Ÿค”, ๐ŸŽฏ, ๐Ÿ’ก) | ๋””๋ฒ„๊น…, ํ•™์Šต, ์ตœ์ ํ™” | -| **๐Ÿ”ฌ ์‹ฌ์ธต ์—ฐ๊ตฌ** | ์ฒด๊ณ„์  ์กฐ์‚ฌ ๋งˆ์ธ๋“œ์…‹ | `/sc:research`, ์กฐ์‚ฌ ํ‚ค์›Œ๋“œ | 6๋‹จ๊ณ„ ์›Œํฌํ”Œ๋กœ์šฐ, ์ฆ๊ฑฐ ๊ธฐ๋ฐ˜ ์ถ”๋ก  | ๊ธฐ์ˆ  ์—ฐ๊ตฌ, ์ตœ์‹  ์ด๋ฒคํŠธ, ์‹œ์žฅ ๋ถ„์„ | -| **๐Ÿ“‹ ์ž‘์—… ๊ด€๋ฆฌ** | ๋ณต์žกํ•œ ์กฐ์ • | >3๋‹จ๊ณ„, >2๊ฐœ ๋””๋ ‰ํ† ๋ฆฌ | ๋‹จ๊ณ„ ๋ถ„ํ•ด, ๋ฉ”๋ชจ๋ฆฌ ์ง€์†์„ฑ | ๋‹ค๋‹จ๊ณ„ ์ž‘์—…, ํ”„๋กœ์ ํŠธ ๊ด€๋ฆฌ | -| **๐ŸŽฏ ์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜** | ์ง€๋Šฅํ˜• ๋„๊ตฌ ์„ ํƒ | ๋‹ค์ค‘ ๋„๊ตฌ ์ž‘์—…, ๋†’์€ ๋ฆฌ์†Œ์Šค ์‚ฌ์šฉ | ์ตœ์ ์˜ ๋„๊ตฌ ๋ผ์šฐํŒ…, ๋ณ‘๋ ฌ ์‹คํ–‰ | ๋ณต์žกํ•œ ๋ถ„์„, ์„ฑ๋Šฅ ์ตœ์ ํ™” | -| **โšก ํ† ํฐ ํšจ์œจ์„ฑ** | ์••์ถ• ์ปค๋ฎค๋‹ˆ์ผ€์ด์…˜ | ๋†’์€ ์ปจํ…์ŠคํŠธ ์‚ฌ์šฉ, `--uc` ํ”Œ๋ž˜๊ทธ | ์‹ฌ๋ณผ ์‹œ์Šคํ…œ, ์˜ˆ์ƒ 30-50% ํ† ํฐ ๊ฐ์†Œ | ๋ฆฌ์†Œ์Šค ์ œ์•ฝ, ๋Œ€๊ทœ๋ชจ ์ž‘์—… | - ---- - -## ์‹œ์ž‘ํ•˜๊ธฐ (2๋ถ„ ๊ฐœ์š”) - -**๋ชจ๋“œ๋Š” ํ–‰๋™ ์ง€์นจ์„ ํ†ตํ•ด ํ™œ์„ฑํ™”๋ฉ๋‹ˆ๋‹ค** - Claude Code๊ฐ€ ์ปจํ…์ŠคํŠธ ํŒŒ์ผ์„ ์ฝ์–ด ์ž‘์—… ํŒจํ„ด๊ณผ ๋ณต์žก์„ฑ์— ๋”ฐ๋ผ ์ฑ„ํƒํ•  ๋ชจ๋“œ ๋™์ž‘์„ ๊ฒฐ์ •ํ•ฉ๋‹ˆ๋‹ค. - -**๋น ๋ฅธ ์˜ˆ์ œ:** -```bash -# ์ž๋™ ํ™œ์„ฑํ™” ์˜ˆ์ œ -/sc:brainstorm "๋ชจ๋ฐ”์ผ ์•ฑ" # โ†’ ์†Œํฌ๋ผํ…Œ์Šค์‹ ๋ฐœ๊ฒฌ ์งˆ๋ฌธ -/sc:implement "์ธ์ฆ ์‹œ์Šคํ…œ" # โ†’ ๋‹ค๋‹จ๊ณ„ ์กฐ์ • -"--uc analyze large-codebase/" # โ†’ ์••์ถ•๋œ ์‹ฌ๋ณผ ์ถœ๋ ฅ -``` - -**์ˆ˜๋™ ํ”Œ๋ž˜๊ทธ๋ฅผ ์‚ฌ์šฉํ•  ๋•Œ:** -- ํŠน์ • ๋™์ž‘ ํ•„์š”: `--brainstorm`, `--introspect`, `--uc` -- ํ•™์Šต/๋””๋ฒ„๊น…์„ ์œ„ํ•œ ์ž๋™ ๊ฐ์ง€ ์žฌ์ •์˜ -- ํŠน์ • ์ œ์•ฝ(๋ฉ”๋ชจ๋ฆฌ, ์‹œ๊ฐ„, ๋ช…ํ™•์„ฑ)์— ์ตœ์ ํ™” - ---- - -## ๋ชจ๋“œ ์„ธ๋ถ€์ •๋ณด - -### ๐Ÿง  ๋ธŒ๋ ˆ์ธ์Šคํ† ๋ฐ ๋ชจ๋“œ - ๋Œ€ํ™”ํ˜• ๋ฐœ๊ฒฌ - -**๋ชฉ์ **: ํ˜‘์—… ๋ฐœ๊ฒฌ์„ ํ†ตํ•ด ๋ชจํ˜ธํ•œ ์•„์ด๋””์–ด๋ฅผ ๊ตฌ์กฐํ™”๋œ ์š”๊ตฌ์‚ฌํ•ญ์œผ๋กœ ๋ณ€ํ™˜ํ•ฉ๋‹ˆ๋‹ค. - -**์ž๋™ ํ™œ์„ฑํ™” ํŠธ๋ฆฌ๊ฑฐ:** -- ๋ชจํ˜ธํ•œ ํ”„๋กœ์ ํŠธ ์š”์ฒญ: "๋งŒ๋“ค๊ณ  ์‹ถ์–ด...", "์ƒ๊ฐํ•˜๊ณ  ์žˆ๋Š”๋ฐ..." -- ํƒ์ƒ‰ ํ‚ค์›Œ๋“œ: brainstorm, explore, discuss, figure out, not sure -- ๋ถˆํ™•์‹ค์„ฑ ์ง€ํ‘œ: "maybe", "possibly", "could we" -- ์ˆ˜๋™ ํ”Œ๋ž˜๊ทธ: `--brainstorm`, `--bs` - -**ํ–‰๋™ ๋ณ€ํ™”:** -- **์†Œํฌ๋ผํ…Œ์Šค์‹ ์งˆ๋ฌธ**: ์ˆจ๊ฒจ์ง„ ์š”๊ตฌ์‚ฌํ•ญ์„ ์ฐพ๊ธฐ ์œ„ํ•œ ํƒ์ƒ‰ ์งˆ๋ฌธ -- **๋น„๊ฐ€์ •์  ์ ‘๊ทผ**: ๊ฐ€์ •์„ ํ”ผํ•˜๊ณ  ๋ฐœ๊ฒฌ ๋ฐฉํ–ฅ์„ ์•ˆ๋‚ดํ•˜๋„๋ก ํ•จ -- **ํ˜‘์—… ํŒŒํŠธ๋„ˆ์‹ญ**: ์ง€์‹œ์  ์ปจ์„คํŒ…์ด ์•„๋‹Œ ํƒ์ƒ‰์—์„œ ํ•จ๊ป˜ ์ž‘์—… -- **์š”๊ตฌ์‚ฌํ•ญ ์ข…ํ•ฉ**: ํ†ต์ฐฐ๋ ฅ์„ ๊ตฌ์กฐํ™”๋œ ๊ธฐ์ˆ  ๋ธŒ๋ฆฌํ”„๋กœ ๋ณ€ํ™˜ -- **๊ต์ฐจ ์„ธ์…˜ ๋ฉ”๋ชจ๋ฆฌ**: ํ›„์† ํ† ๋ก ์„ ์œ„ํ•œ ๋ฐœ๊ฒฌ ์ปจํ…์ŠคํŠธ ์œ ์ง€ - -**์˜ˆ์ œ ๊ฒฝํ—˜:** -``` -ํ‘œ์ค€ ์ ‘๊ทผ๋ฒ•: "JWT ํ† ํฐ์œผ๋กœ ์‚ฌ์šฉ์ž ์ธ์ฆ ์‹œ์Šคํ…œ์„ ๊ตฌ์ถ•ํ•˜๊ฒ ์Šต๋‹ˆ๋‹ค..." -๋ธŒ๋ ˆ์ธ์Šคํ† ๋ฐ ์ ‘๊ทผ๋ฒ•: -"๐Ÿค” ํ•จ๊ป˜ ํƒ์ƒ‰ํ•ด๋ด…์‹œ๋‹ค: - - ์ธ์ฆ์ด ์•ฑ์—์„œ ํ•ด๊ฒฐํ•˜๋Š” ํŠน์ • ์‚ฌ์šฉ์ž ๋ฌธ์ œ๋Š” ๋ฌด์—‡์ธ๊ฐ€์š”? - - ์‚ฌ์šฉ์ž๋Š” ๋ˆ„๊ตฌ์ด๋ฉฐ ๊ธฐ์ˆ ์  ํŽธ์•ˆํ•จ ์ˆ˜์ค€์€ ์–ด๋–ค๊ฐ€์š”? - - ํ†ตํ•ฉํ•  ๊ธฐ์กด ์‹œ์Šคํ…œ์ด๋‚˜ ์†Œ์…œ ๋กœ๊ทธ์ธ์ด ์žˆ๋‚˜์š”? - - ์–ด๋–ค ๋ณด์•ˆ/๊ทœ์ • ์ค€์ˆ˜ ์š”๊ตฌ์‚ฌํ•ญ์ด ์žˆ๋‚˜์š”? - ๐Ÿ“ ๊ฒฐ๊ณผ: ๊ตฌํ˜„ ์ค€๋น„๊ฐ€ ๋œ ์ƒ์„ธํ•œ ์ธ์ฆ ์š”๊ตฌ์‚ฌํ•ญ ๋ธŒ๋ฆฌํ”„" -``` - -#### ์„ฑ๊ณต ๊ธฐ์ค€ -- [ ] ์ฆ‰๊ฐ์ ์ธ ์†”๋ฃจ์…˜ ๋Œ€์‹  ์งˆ๋ฌธ์œผ๋กœ ์‘๋‹ต -- [ ] ์งˆ๋ฌธ์ด ์‚ฌ์šฉ์ž ์š”๊ตฌ, ๊ธฐ์ˆ  ์ œ์•ฝ, ๋น„์ฆˆ๋‹ˆ์Šค ๋ชฉํ‘œ ํƒ์ƒ‰ -- [ ] ๋ฐœ๊ฒฌ ๊ณผ์ • ์ „๋ฐ˜์— ๊ฑธ์ณ ํ˜‘์—…์  ์–ด์กฐ ์œ ์ง€ -- [ ] ๊ฒฐ๊ณผ๋กœ ๊ตฌ์กฐํ™”๋œ ์š”๊ตฌ์‚ฌํ•ญ ๋˜๋Š” ๊ธฐ์ˆ  ๋ธŒ๋ฆฌํ”„ ์ƒ์„ฑ - -**๊ฒ€์ฆ:** `/sc:brainstorm "์›น ์•ฑ"`์€ ์‚ฌ์šฉ์ž, ๊ธฐ๋Šฅ, ๊ธฐ์ˆ ์— ๋Œ€ํ•ด ์งˆ๋ฌธํ•ด์•ผ ํ•จ -**ํ…Œ์ŠคํŠธ:** ๋ชจํ˜ธํ•œ ์š”์ฒญ์€ ๊ฐ€์ •์ด ์•„๋‹Œ ๋ฐœ๊ฒฌ ์งˆ๋ฌธ์„ ํŠธ๋ฆฌ๊ฑฐํ•ด์•ผ ํ•จ -**ํ™•์ธ:** ๋™์ผํ•œ ๋Œ€ํ™”์—์„œ ํ›„์† ์งˆ๋ฌธ ์ „๋ฐ˜์— ๊ฑธ์ณ ๋ชจ๋“œ๊ฐ€ ์ง€์†๋˜์–ด์•ผ ํ•จ - -**์ตœ์ ์˜ ํ˜‘์—… ๋Œ€์ƒ:** -- **โ†’ ์ž‘์—… ๊ด€๋ฆฌ**: ์š”๊ตฌ์‚ฌํ•ญ ๋ฐœ๊ฒฌ โ†’ ์ฒด๊ณ„์ ์ธ ๊ตฌํ˜„ ๊ณ„ํš -- **โ†’ ์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜**: ์š”๊ตฌ์‚ฌํ•ญ ๋ช…ํ™•์„ฑ โ†’ ๊ตฌํ˜„์„ ์œ„ํ•œ ์ตœ์ ์˜ ๋„๊ตฌ ์„ ํƒ -- **์ˆ˜๋™ ์žฌ์ •์˜**: "๋ช…ํ™•ํ•œ" ์š”๊ตฌ์‚ฌํ•ญ์—๋„ ๋ฐœ๊ฒฌ์„ ๊ฐ•์ œํ•˜๋ ค๋ฉด `--brainstorm` ์‚ฌ์šฉ - ---- - -### ๐Ÿ” ๋‚ด์„ฑ ๋ชจ๋“œ - ๋ฉ”ํƒ€์ธ์ง€ ๋ถ„์„ - -**๋ชฉ์ **: ํ•™์Šต ์ตœ์ ํ™” ๋ฐ ํˆฌ๋ช…ํ•œ ์˜์‚ฌ๊ฒฐ์ •์„ ์œ„ํ•œ ์ถ”๋ก  ๊ณผ์ • ๋…ธ์ถœ - -**์ž๋™ ํ™œ์„ฑํ™” ํŠธ๋ฆฌ๊ฑฐ:** -- ์ž๊ธฐ ๋ถ„์„ ์š”์ฒญ: "๋‚ด ์ถ”๋ก  ๋ถ„์„", "๊ฒฐ์ • ์„ฑ์ฐฐ" -- ์กฐ์‚ฌ๊ฐ€ ํ•„์š”ํ•œ ์˜ค๋ฅ˜ ๋ณต๊ตฌ ์‹œ๋‚˜๋ฆฌ์˜ค ๋ฐ ์˜ˆ์ƒ์น˜ ๋ชปํ•œ ๊ฒฐ๊ณผ -- ์—ฌ๋Ÿฌ ๊ฐ€๋Šฅํ•œ ์ ‘๊ทผ๋ฒ•์ด ์žˆ๋Š” ๋ณต์žกํ•œ ๋ฌธ์ œ ํ•ด๊ฒฐ -- ์ตœ์ ํ™” ๊ธฐํšŒ๋ฅผ ์œ„ํ•œ ํŒจํ„ด ์ธ์‹ ํ•„์š” -- ์ˆ˜๋™ ํ”Œ๋ž˜๊ทธ: `--introspect` - -**ํ–‰๋™ ๋ณ€ํ™”:** -- **์ถ”๋ก  ํˆฌ๋ช…์„ฑ**: ๋ช…ํ™•ํ•œ ๋งˆ์ปค๋กœ ์‚ฌ๊ณ  ๊ณผ์ • ๋…ธ์ถœ (๐Ÿค”, ๐ŸŽฏ, โšก, ๐Ÿ“Š, ๐Ÿ’ก) -- **๊ฒฐ์ • ๋ถ„์„**: ์„ ํƒ ๋…ผ๋ฆฌ ํ‰๊ฐ€ ๋ฐ ๋Œ€์•ˆ ์ ‘๊ทผ๋ฒ• ๊ณ ๋ ค -- **ํŒจํ„ด ์ธ์‹**: ๋ฐ˜๋ณต๋˜๋Š” ํ–‰๋™ ๋ฐ ๊ฐœ์„  ๊ธฐํšŒ ์‹๋ณ„ -- **๋ฉ”ํƒ€ ํ•™์Šต**: ์ง€์†์ ์ธ ํ”„๋ ˆ์ž„์›Œํฌ ๊ฐœ์„ ์„ ์œ„ํ•œ ํ†ต์ฐฐ๋ ฅ ์ถ”์ถœ -- **ํ”„๋ ˆ์ž„์›Œํฌ ๊ทœ์ • ์ค€์ˆ˜**: SuperClaude ์›์น™ ๋ฐ ํ’ˆ์งˆ ๊ฒŒ์ดํŠธ์— ๋Œ€ํ•œ ํ–‰๋™ ๊ฒ€์ฆ - -**์˜ˆ์ œ ๊ฒฝํ—˜:** -``` -ํ‘œ์ค€ ์ ‘๊ทผ๋ฒ•: "์ด ์ฝ”๋“œ ๊ตฌ์กฐ๋ฅผ ๋ถ„์„ํ•˜๊ณ  ๊ฐœ์„  ์‚ฌํ•ญ์„ ์ œ์•ˆํ•˜๊ฒ ์Šต๋‹ˆ๋‹ค..." -๋‚ด์„ฑ์  ์ ‘๊ทผ๋ฒ•: -"๐Ÿง  ๋ฉ”ํƒ€ ๋ถ„์„: ์™œ ๊ธฐ๋Šฅ ํ๋ฆ„๋ณด๋‹ค ๊ตฌ์กฐ์  ๋ถ„์„์„ ์„ ํƒํ–ˆ์„๊นŒ? - ๐ŸŽฏ ๊ฒฐ์ • ๋…ผ๋ฆฌ: ํด๋ž˜์Šค ๊ณ„์ธต ๊ตฌ์กฐ ํ™•์ธ โ†’ OOP ํŒจํ„ด ์šฐ์„ธ ๊ฐ€์ • - ๐Ÿ”„ ๊ณ ๋ ค๋œ ๋Œ€์•ˆ: ๋ฐ์ดํ„ฐ ํ๋ฆ„ ๋ถ„์„์ด ์ˆจ๊ฒจ์ง„ ์ข…์†์„ฑ ๋“œ๋Ÿฌ๋‚ผ ์ˆ˜ ์žˆ์Œ - ๐Ÿ“Š ์ฆ๊ฑฐ ํ™•์ธ: ํŒŒ์ผ ์ž„ํฌํŠธ๊ฐ€ OOP๊ฐ€ ์•„๋‹Œ ํ•จ์ˆ˜ํ˜• ๊ตฌ์„ฑ ์‹œ์‚ฌ - ๐Ÿ’ก ํ•™์Šต: ๋ถ„์„ ์ „๋žต ์„ ํƒ ์ „์— ์ž„ํฌํŠธ ๋ถ„์„ ํ•„์š” - โšก ์ˆ˜์ •: ํ•จ์ˆ˜ํ˜• ํ๋ฆ„ ๋ถ„์„ ์ ‘๊ทผ๋ฒ•์œผ๋กœ ์ „ํ™˜" -``` - -**์ตœ์ ์˜ ํ˜‘์—… ๋Œ€์ƒ:** -- **โ†’ ์ž‘์—… ๊ด€๋ฆฌ**: ๋ณต์žกํ•œ ๋‹จ๊ณ„ ๊ฒฐ์ •์— ๋Œ€ํ•œ ํˆฌ๋ช…ํ•œ ์ถ”๋ก  ์ œ๊ณต -- **๋ชจ๋“  ๋ชจ๋“œ**: ๋‹ค๋ฅธ ๋ชจ๋“œ์˜ ์ž‘์—…์— ์ถ”๋ก  ํˆฌ๋ช…์„ฑ ๋ ˆ์ด์–ด ์ถ”๊ฐ€ -- **์ˆ˜๋™ ์žฌ์ •์˜**: ํ•™์Šต ์„ธ์…˜ ๋ฐ ๋””๋ฒ„๊น… ์›Œํฌํ”Œ๋กœ์šฐ์— `--introspect` ์‚ฌ์šฉ - ---- - -### ๐Ÿ”ฌ ์‹ฌ์ธต ์—ฐ๊ตฌ ๋ชจ๋“œ - ์ฒด๊ณ„์  ์กฐ์‚ฌ ๋งˆ์ธ๋“œ์…‹ - -**๋ชฉ์ **: ์ฒด๊ณ„์  ์กฐ์‚ฌ ๋ฐ ์ฆ๊ฑฐ ๊ธฐ๋ฐ˜ ์ถ”๋ก ์„ ์œ„ํ•œ ์—ฐ๊ตฌ ๋งˆ์ธ๋“œ์…‹ - -**์ž๋™ ํ™œ์„ฑํ™” ํŠธ๋ฆฌ๊ฑฐ:** -- `/sc:research` ๋ช…๋ น์–ด ํ˜ธ์ถœ -- ์—ฐ๊ตฌ ๊ด€๋ จ ํ‚ค์›Œ๋“œ: investigate, explore, discover, analyze -- ์ง€์‹ ์ปท์˜คํ”„๋ฅผ ๋„˜์–ด์„  ์ตœ์‹  ์ •๋ณด๊ฐ€ ํ•„์š”ํ•œ ์งˆ๋ฌธ -- ๋ณต์žกํ•œ ์—ฐ๊ตฌ ์š”๊ตฌ์‚ฌํ•ญ -- ์ˆ˜๋™ ํ”Œ๋ž˜๊ทธ: `--research` - -**ํ–‰๋™ ์ˆ˜์ •:** -- **์‚ฌ๊ณ  ์Šคํƒ€์ผ**: ์บ์ฃผ์–ผ๋ณด๋‹ค ์ฒด๊ณ„์ , ๊ฐ€์ •๋ณด๋‹ค ์ฆ๊ฑฐ, ์ ์ง„์  ๊นŠ์ด ํƒ์ƒ‰ -- **์ปค๋ฎค๋‹ˆ์ผ€์ด์…˜**: ์‹ ๋ขฐ ์ˆ˜์ค€์œผ๋กœ ์‹œ์ž‘, ์ธ๋ผ์ธ ์ธ์šฉ ์ œ๊ณต, ๋ถˆํ™•์‹ค์„ฑ ์ธ์ • -- **์šฐ์„ ์ˆœ์œ„ ์ „ํ™˜**: ์†๋„๋ณด๋‹ค ์™„์ „์„ฑ, ์ถ”์ธก๋ณด๋‹ค ์ •ํ™•์„ฑ, ๊ฐ€์ •๋ณด๋‹ค ๊ฒ€์ฆ -- **ํ”„๋กœ์„ธ์Šค ์ ์‘**: ํ•ญ์ƒ ์กฐ์‚ฌ ๊ณ„ํš ์ƒ์„ฑ, ๋ณ‘๋ ฌ ์ž‘์—… ๊ธฐ๋ณธ๊ฐ’, ์ฆ๊ฑฐ ์ฒด์ธ ์œ ์ง€ - -**6๋‹จ๊ณ„ ์—ฐ๊ตฌ ์›Œํฌํ”Œ๋กœ์šฐ:** -- ๐Ÿ“‹ **์ดํ•ด** (5-10%): ์ฟผ๋ฆฌ ๋ณต์žก์„ฑ ๋ฐ ์š”๊ตฌ์‚ฌํ•ญ ํ‰๊ฐ€ -- ๐Ÿ“ **๊ณ„ํš** (10-15%): ์ „๋žต ์„ ํƒ (planning/intent/unified) ๋ฐ ๋ณ‘๋ ฌํ™” ์‹๋ณ„ -- โœ… **TodoWrite** (5%): ๋ณต์žก์„ฑ์— ๋”ฐ๋ผ ์ ์‘ํ˜• ์ž‘์—… ๊ณ„์ธต ๊ตฌ์กฐ ์ƒ์„ฑ (3-15๊ฐœ ์ž‘์—…) -- ๐Ÿ”„ **์‹คํ–‰** (50-60%): ๋ณ‘๋ ฌ ์šฐ์„  ๊ฒ€์ƒ‰ ๋ฐ ์Šค๋งˆํŠธ ์ถ”์ถœ ๋ผ์šฐํŒ… -- ๐Ÿ“Š **์ถ”์ ** (์ง€์†์ ): ์ง„ํ–‰ ์ƒํ™ฉ ๋ชจ๋‹ˆํ„ฐ๋ง ๋ฐ ์‹ ๋ขฐ๋„ ์ ์ˆ˜ ์—…๋ฐ์ดํŠธ -- โœ“ **๊ฒ€์ฆ** (10-15%): ์ฆ๊ฑฐ ์ฒด์ธ ํ™•์ธ ๋ฐ ์™„์ „์„ฑ ๋ณด์žฅ - -**์˜ˆ์ œ ๊ฒฝํ—˜:** -``` -ํ‘œ์ค€ ๋ชจ๋“œ: "์–‘์ž ์ปดํ“จํŒ…์— ๋Œ€ํ•œ ๊ฒ€์ƒ‰ ๊ฒฐ๊ณผ์ž…๋‹ˆ๋‹ค..." -์‹ฌ์ธต ์—ฐ๊ตฌ ๋ชจ๋“œ: -"๐Ÿ“Š ์—ฐ๊ตฌ ๊ณ„ํš: ์–‘์ž ์ปดํ“จํŒ… ๋ŒํŒŒ๊ตฌ - โœ“ TodoWrite: 8๊ฐœ ์—ฐ๊ตฌ ์ž‘์—… ์ƒ์„ฑ - ๐Ÿ”„ ๋„๋ฉ”์ธ ์ „๋ฐ˜์— ๊ฑธ์ณ ๋ณ‘๋ ฌ ๊ฒ€์ƒ‰ ์‹คํ–‰ - ๐Ÿ“ˆ ์‹ ๋ขฐ๋„: 15๊ฐœ ๊ฒ€์ฆ๋œ ์†Œ์Šค์—์„œ 0.82 - ๐Ÿ“ ๋ณด๊ณ ์„œ ์ €์žฅ๋จ: claudedocs/research_quantum_[timestamp].md" -``` - -#### ํ’ˆ์งˆ ํ‘œ์ค€ -- [ ] ์ธ๋ผ์ธ ์ธ์šฉ์ด ์žˆ๋Š” ์ฃผ์žฅ๋‹น ์ตœ์†Œ 2๊ฐœ ์†Œ์Šค -- [ ] ๋ชจ๋“  ๋ฐœ๊ฒฌ์— ๋Œ€ํ•œ ์‹ ๋ขฐ๋„ ์ ์ˆ˜ (0.0-1.0) -- [ ] ๋…๋ฆฝ์ ์ธ ์ž‘์—…์— ๋Œ€ํ•œ ๋ณ‘๋ ฌ ์‹คํ–‰ ๊ธฐ๋ณธ๊ฐ’ -- [ ] ์ ์ ˆํ•œ ๊ตฌ์กฐ๋กœ claudedocs/์— ๋ณด๊ณ ์„œ ์ €์žฅ -- [ ] ๋ช…ํ™•ํ•œ ๋ฐฉ๋ฒ•๋ก  ๋ฐ ์ฆ๊ฑฐ ์ œ์‹œ - -**๊ฒ€์ฆ:** `/sc:research "ํ…Œ์ŠคํŠธ ์ฃผ์ œ"`๋Š” TodoWrite๋ฅผ ์ƒ์„ฑํ•˜๊ณ  ์ฒด๊ณ„์ ์œผ๋กœ ์‹คํ–‰ํ•ด์•ผ ํ•จ -**ํ…Œ์ŠคํŠธ:** ๋ชจ๋“  ์—ฐ๊ตฌ์— ์‹ ๋ขฐ๋„ ์ ์ˆ˜ ๋ฐ ์ธ์šฉ์ด ํฌํ•จ๋˜์–ด์•ผ ํ•จ -**ํ™•์ธ:** ๋ณด๊ณ ์„œ๊ฐ€ ์ž๋™์œผ๋กœ claudedocs/์— ์ €์žฅ๋˜์–ด์•ผ ํ•จ - -**์ตœ์ ์˜ ํ˜‘์—… ๋Œ€์ƒ:** -- **โ†’ ์ž‘์—… ๊ด€๋ฆฌ**: TodoWrite ํ†ตํ•ฉ์„ ํ†ตํ•œ ์—ฐ๊ตฌ ๊ณ„ํš -- **โ†’ ์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜**: ๋ณ‘๋ ฌ Tavily/Playwright ์กฐ์ • -- **์ˆ˜๋™ ์žฌ์ •์˜**: ์„ธ๋ฐ€ํ•œ ์ œ์–ด๋ฅผ ์œ„ํ•ด `--depth` ๋ฐ `--strategy` ์‚ฌ์šฉ - ---- - -### ๐Ÿ“‹ ์ž‘์—… ๊ด€๋ฆฌ ๋ชจ๋“œ - ๋ณต์žกํ•œ ์กฐ์ • - -**๋ชฉ์ **: ๋‹ค๋‹จ๊ณ„ ์ž‘์—…์„ ์œ„ํ•œ ์„ธ์…˜ ์ง€์†์„ฑ์„ ๊ฐ–์ถ˜ ๊ณ„์ธต์  ์ž‘์—… ์กฐ์ง - -**์ž๋™ ํ™œ์„ฑํ™” ํŠธ๋ฆฌ๊ฑฐ:** -- >3๊ฐœ์˜ ์กฐ์ •๋œ ๋‹จ๊ณ„๊ฐ€ ํ•„์š”ํ•œ ์ž‘์—… -- ๋‹ค์ค‘ ํŒŒ์ผ/๋””๋ ‰ํ† ๋ฆฌ ๋ฒ”์œ„ (>2๊ฐœ ๋””๋ ‰ํ† ๋ฆฌ ๋˜๋Š” >3๊ฐœ ํŒŒ์ผ) -- ๋‹จ๊ณ„ ๋ฐ ์ฒดํฌํฌ์ธํŠธ๊ฐ€ ํ•„์š”ํ•œ ๋ณต์žกํ•œ ์ข…์†์„ฑ -- ํ’ˆ์งˆ ๊ฐœ์„  ์š”์ฒญ: polish, refine, enhance -- ์ˆ˜๋™ ํ”Œ๋ž˜๊ทธ: `--task-manage`, `--delegate` - -**ํ–‰๋™ ๋ณ€ํ™”:** -- **๊ณ„์ธต์  ๊ณ„ํš**: ๋ณต์žกํ•œ ์ž‘์—…์„ Plan โ†’ Phase โ†’ Task โ†’ Todo ๊ตฌ์กฐ๋กœ ๋ถ„ํ•ด -- **์„ธ์…˜ ์ง€์†์„ฑ**: ์ค‘๋‹จ ์ „๋ฐ˜์— ๊ฑธ์ณ ํ”„๋กœ์ ํŠธ ์ปจํ…์ŠคํŠธ ๋ฐ ์ง„ํ–‰ ์ƒํ™ฉ ์œ ์ง€ -- **๋ฉ”๋ชจ๋ฆฌ ํ†ตํ•ฉ**: ์ƒํƒœ ๋ณด์กด์„ ์œ„ํ•ด write_memory/read_memory ์‚ฌ์šฉ -- **์ง„ํ–‰ ์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜**: ์ถ”์ ์„ ์œ„ํ•ด TodoWrite์™€ ๋ฉ”๋ชจ๋ฆฌ ์—…๋ฐ์ดํŠธ ์กฐ์ • -- **ํ’ˆ์งˆ ๊ฒŒ์ดํŠธ**: ๋‹จ๊ณ„ ๊ฐ„ ์ฒด๊ณ„์ ์ธ ๊ฒ€์ฆ ์ฒดํฌํฌ์ธํŠธ ๊ตฌํ˜„ - -**์˜ˆ์ œ ๊ฒฝํ—˜:** -``` -ํ‘œ์ค€ ์ ‘๊ทผ๋ฒ•: "์‚ฌ์šฉ์ž ์ธ์ฆ์„ ๊ตฌํ˜„ํ•˜๊ฒ ์Šต๋‹ˆ๋‹ค..." โ†’ ์ง์ ‘ ๊ตฌํ˜„ -์ž‘์—… ๊ด€๋ฆฌ ์ ‘๊ทผ๋ฒ•: -"๐Ÿ“‹ ๋‹ค๋‹จ๊ณ„ ๊ตฌํ˜„ ๊ณ„ํš: - ๐ŸŽฏ 1๋‹จ๊ณ„: ๋ณด์•ˆ ์š”๊ตฌ์‚ฌํ•ญ ๋ถ„์„ (์„ธ์…˜ 1) - ๐ŸŽฏ 2๋‹จ๊ณ„: API ์„ค๊ณ„ ๋ฐ ๋ฌธ์„œํ™” (์„ธ์…˜ 2) - ๐ŸŽฏ 3๋‹จ๊ณ„: ๊ตฌํ˜„ ๋ฐ ํ…Œ์ŠคํŒ… (์„ธ์…˜ 3-4) - ๐ŸŽฏ 4๋‹จ๊ณ„: ํ†ตํ•ฉ ๋ฐ ๊ฒ€์ฆ (์„ธ์…˜ 5) - ๐Ÿ’พ ์„ธ์…˜ ์ง€์†์„ฑ: ์ž๋™์œผ๋กœ ์ปจํ…์ŠคํŠธ ์žฌ๊ฐœ - โœ“ ํ’ˆ์งˆ ๊ฒŒ์ดํŠธ: ๊ฐ ๋‹จ๊ณ„ ์ „ํ™˜ ์ „ ๊ฒ€์ฆ" -``` - -**์ตœ์ ์˜ ํ˜‘์—… ๋Œ€์ƒ:** -- **๋ธŒ๋ ˆ์ธ์Šคํ† ๋ฐ โ†’**: ์š”๊ตฌ์‚ฌํ•ญ ๋ฐœ๊ฒฌ ํ›„ ์ฒด๊ณ„์ ์ธ ๊ตฌํ˜„ -- **+ ์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜**: ์ตœ์ ์˜ ๋„๊ตฌ ์„ ํƒ์„ ํ†ตํ•œ ์ž‘์—… ์กฐ์ • -- **+ ๋‚ด์„ฑ**: ๋ณต์žกํ•œ ๋‹จ๊ณ„ ๊ฒฐ์ •์— ๋Œ€ํ•œ ํˆฌ๋ช…ํ•œ ์ถ”๋ก  - ---- - -### ๐ŸŽฏ ์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜ ๋ชจ๋“œ - ์ง€๋Šฅํ˜• ๋„๊ตฌ ์„ ํƒ - -**๋ชฉ์ **: ์ง€๋Šฅํ˜• ๋„๊ตฌ ๋ผ์šฐํŒ… ๋ฐ ๋ณ‘๋ ฌ ์กฐ์ •์„ ํ†ตํ•œ ์ž‘์—… ์‹คํ–‰ ์ตœ์ ํ™” - -**์ž๋™ ํ™œ์„ฑํ™” ํŠธ๋ฆฌ๊ฑฐ:** -- ์ •๊ตํ•œ ์กฐ์ •์ด ํ•„์š”ํ•œ ๋‹ค์ค‘ ๋„๊ตฌ ์ž‘์—… -- ์„ฑ๋Šฅ ์ œ์•ฝ (๋†’์€ ๋ฆฌ์†Œ์Šค ์‚ฌ์šฉ) -- ๋ณ‘๋ ฌ ์‹คํ–‰ ๊ธฐํšŒ (>3๊ฐœ ๋…๋ฆฝ์  ํŒŒ์ผ/์ž‘์—…) -- ์—ฌ๋Ÿฌ ์œ ํšจํ•œ ๋„๊ตฌ ์ ‘๊ทผ๋ฒ•์ด ์žˆ๋Š” ๋ณต์žกํ•œ ๋ผ์šฐํŒ… ๊ฒฐ์ • - -**ํ–‰๋™ ๋ณ€ํ™”:** -- **์ง€๋Šฅํ˜• ๋„๊ตฌ ๋ผ์šฐํŒ…**: ๊ฐ ์ž‘์—… ์œ ํ˜•์— ์ตœ์ ์˜ MCP ์„œ๋ฒ„ ๋ฐ ๋„ค์ดํ‹ฐ๋ธŒ ๋„๊ตฌ ์„ ํƒ -- **๋ฆฌ์†Œ์Šค ์ธ์‹**: ์‹œ์Šคํ…œ ์ œ์•ฝ ๋ฐ ๊ฐ€์šฉ์„ฑ์— ๋”ฐ๋ผ ์ ‘๊ทผ๋ฒ• ์กฐ์ • -- **๋ณ‘๋ ฌ ์ตœ์ ํ™”**: ๋™์‹œ ์‹คํ–‰์„ ์œ„ํ•œ ๋…๋ฆฝ์ ์ธ ์ž‘์—… ์‹๋ณ„ -- **์กฐ์ • ์ดˆ์ **: ์กฐ์ •๋œ ์‹คํ–‰์„ ํ†ตํ•œ ๋„๊ตฌ ์„ ํƒ ๋ฐ ์‚ฌ์šฉ ์ตœ์ ํ™” -- **์ ์‘ํ˜• ํด๋ฐฑ**: ์„ ํ˜ธํ•˜๋Š” ์˜ต์…˜์„ ์‚ฌ์šฉํ•  ์ˆ˜ ์—†์„ ๋•Œ ๋„๊ตฌ๋ฅผ ์šฐ์•„ํ•˜๊ฒŒ ์ „ํ™˜ - -**์˜ˆ์ œ ๊ฒฝํ—˜:** -``` -ํ‘œ์ค€ ์ ‘๊ทผ๋ฒ•: ์ˆœ์ฐจ์  ํŒŒ์ผ๋ณ„ ๋ถ„์„ ๋ฐ ํŽธ์ง‘ -์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜ ์ ‘๊ทผ๋ฒ•: -"๐ŸŽฏ ๋‹ค์ค‘ ๋„๊ตฌ ์กฐ์ • ์ „๋žต: - ๐Ÿ” 1๋‹จ๊ณ„: Serena (์˜๋ฏธ๋ก ์  ๋ถ„์„) + Sequential (์•„ํ‚คํ…์ฒ˜ ๊ฒ€ํ† ) - โšก 2๋‹จ๊ณ„: Morphllm (ํŒจํ„ด ํŽธ์ง‘) + Magic (UI ์ปดํฌ๋„ŒํŠธ) - ๐Ÿงช 3๋‹จ๊ณ„: Playwright (ํ…Œ์ŠคํŒ…) + Context7 (๋ฌธ์„œ ํŒจํ„ด) - ๐Ÿ”„ ๋ณ‘๋ ฌ ์‹คํ–‰: 3๊ฐœ ๋„๊ตฌ ๋™์‹œ ์ž‘์—…" -``` - -**์ตœ์ ์˜ ํ˜‘์—… ๋Œ€์ƒ:** -- **์ž‘์—… ๊ด€๋ฆฌ โ†’**: ๋ณต์žกํ•œ ๋‹ค๋‹จ๊ณ„ ๊ณ„ํš์„ ์œ„ํ•œ ๋„๊ตฌ ์กฐ์ • ์ œ๊ณต -- **+ ํ† ํฐ ํšจ์œจ์„ฑ**: ์••์ถ• ์ปค๋ฎค๋‹ˆ์ผ€์ด์…˜์„ ํ†ตํ•œ ์ตœ์ ์˜ ๋„๊ตฌ ์„ ํƒ -- **๋ชจ๋“  ๋ณต์žกํ•œ ์ž‘์—…**: ์‹คํ–‰์„ ํ–ฅ์ƒ์‹œํ‚ค๊ธฐ ์œ„ํ•œ ์ง€๋Šฅํ˜• ๋„๊ตฌ ๋ผ์šฐํŒ… ์ถ”๊ฐ€ - ---- - -### โšก ํ† ํฐ ํšจ์œจ์„ฑ ๋ชจ๋“œ - ์••์ถ• ์ปค๋ฎค๋‹ˆ์ผ€์ด์…˜ - -**๋ชฉ์ **: ์ •๋ณด ํ’ˆ์งˆ์„ ์œ ์ง€ํ•˜๋ฉด์„œ ์‹ฌ๋ณผ ์‹œ์Šคํ…œ์„ ํ†ตํ•ด ์˜ˆ์ƒ 30-50% ํ† ํฐ ๊ฐ์†Œ ๋‹ฌ์„ฑ - -**์ž๋™ ํ™œ์„ฑํ™” ํŠธ๋ฆฌ๊ฑฐ:** -- ์ œํ•œ์— ๊ทผ์ ‘ํ•œ ๋†’์€ ์ปจํ…์ŠคํŠธ ์‚ฌ์šฉ -- ๋ฆฌ์†Œ์Šค ํšจ์œจ์„ฑ์ด ํ•„์š”ํ•œ ๋Œ€๊ทœ๋ชจ ์ž‘์—… -- ์‚ฌ์šฉ์ž ๋ช…์‹œ์  ํ”Œ๋ž˜๊ทธ: `--uc`, `--ultracompressed` -- ์—ฌ๋Ÿฌ ์ถœ๋ ฅ์ด ์žˆ๋Š” ๋ณต์žกํ•œ ๋ถ„์„ ์›Œํฌํ”Œ๋กœ์šฐ - -**ํ–‰๋™ ๋ณ€ํ™”:** -- **์‹ฌ๋ณผ ์ปค๋ฎค๋‹ˆ์ผ€์ด์…˜**: ๋…ผ๋ฆฌ ํ๋ฆ„, ์ƒํƒœ, ๊ธฐ์ˆ  ๋„๋ฉ”์ธ์„ ์œ„ํ•œ ์‹œ๊ฐ์  ์‹ฌ๋ณผ ์‚ฌ์šฉ -- **๊ธฐ์ˆ  ์•ฝ์–ด**: ๋ฐ˜๋ณต๋˜๋Š” ๊ธฐ์ˆ  ์šฉ์–ด์— ๋Œ€ํ•œ ์ปจํ…์ŠคํŠธ ์ธ์‹ ์••์ถ• -- **๊ตฌ์กฐํ™”๋œ ๋ฐ€๋„**: ์žฅํ™ฉํ•œ ๋‹จ๋ฝ๋ณด๋‹ค ๊ธ€๋จธ๋ฆฌ ๊ธฐํ˜ธ, ํ‘œ, ๊ฐ„๊ฒฐํ•œ ํ˜•์‹ -- **์ •๋ณด ๋ณด์กด**: ์••์ถ•์—๋„ ๋ถˆ๊ตฌํ•˜๊ณ  โ‰ฅ95% ์ •๋ณด ํ’ˆ์งˆ ์œ ์ง€ -- **๊ตฌ์กฐํ™”๋œ ํ˜•์‹**: ๋ช…ํ™•์„ฑ ๋ฐ ์ž‘์—… ์™„๋ฃŒ๋ฅผ ์œ„ํ•ด ์กฐ์งํ™” - -**์˜ˆ์ œ ๊ฒฝํ—˜:** -``` -ํ‘œ์ค€ ์ ‘๊ทผ๋ฒ•: "์ธ์ฆ ์‹œ์Šคํ…œ ๊ตฌํ˜„์€ ์ฆ‰๊ฐ์ ์ธ ์ฃผ์˜๊ฐ€ ํ•„์š”ํ•œ ์‚ฌ์šฉ์ž ๊ฒ€์ฆ ํ•จ์ˆ˜์˜ ๋ณด์•ˆ ์ทจ์•ฝ์ ์„ ๋ณด์—ฌ์ค๋‹ˆ๋‹ค..." -ํ† ํฐ ํšจ์œจ์  ์ ‘๊ทผ๋ฒ•: -"๐Ÿ›ก๏ธ ๋ณด์•ˆ ๊ฒฝ๊ณ : - auth.js:45 โ†’ user val() โ†’ ์ค‘์š”ํ•œ ์ทจ์•ฝ์  - ๐Ÿ“Š ์˜ํ–ฅ: โŒ ํ† ํฐ ์šฐํšŒ ๊ฐ€๋Šฅ - โšก ์กฐ์น˜: ๊ฒ€์ฆ ์ˆ˜์ • + ๊ฐ์‚ฌ โˆต ๋†’์€ ์‹ฌ๊ฐ๋„ - ๐Ÿ”ง ์˜ˆ์ƒ: 2์‹œ๊ฐ„ ๊ตฌํ˜„ + 1์‹œ๊ฐ„ ํ…Œ์ŠคํŠธ" -``` - -**์ตœ์ ์˜ ํ˜‘์—… ๋Œ€์ƒ:** -- **๋ชจ๋“  ๋ชจ๋“œ**: ๋ชจ๋“œ๋ณ„ ๋™์ž‘์„ ์œ ์ง€ํ•˜๋ฉด์„œ ์••์ถ• ๋ ˆ์ด์–ด ์ถ”๊ฐ€ -- **์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜ โ†’**: ์••์ถ•๋œ ๋„๊ตฌ ์กฐ์ • ๋ฐ ์ƒํƒœ ์—…๋ฐ์ดํŠธ -- **์ˆ˜๋™ ์žฌ์ •์˜**: ์ปจํ…์ŠคํŠธ ์••๋ฐ• ๋˜๋Š” ํšจ์œจ์„ฑ์ด ์šฐ์„ ์ˆœ์œ„์ผ ๋•Œ `--uc` ์‚ฌ์šฉ - ---- - -### ๐ŸŽจ ํ‘œ์ค€ ๋ชจ๋“œ - ๊ท ํ˜• ์žกํžŒ ๊ธฐ๋ณธ๊ฐ’ - -**๋ชฉ์ **: ๊ฐ„๋‹จํ•œ ๊ฐœ๋ฐœ ์ž‘์—…์„ ์œ„ํ•œ ๋ช…ํ™•ํ•˜๊ณ  ์ „๋ฌธ์ ์ธ ์ปค๋ฎค๋‹ˆ์ผ€์ด์…˜ ์ œ๊ณต - -**์ž๋™ ํ™œ์„ฑํ™” ํŠธ๋ฆฌ๊ฑฐ:** -- ๋ณต์žก์„ฑ ์ง€ํ‘œ๊ฐ€ ์—†๋Š” ๊ฐ„๋‹จํ•˜๊ณ  ์ž˜ ์ •์˜๋œ ์ž‘์—… -- ๋ช…ํ™•ํ•œ ์š”๊ตฌ์‚ฌํ•ญ์ด ์žˆ๋Š” ๋‹จ์ผ ํŒŒ์ผ ์ž‘์—… -- ๊ธฐ๋ณธ ์„ค๋ช… ๋ฐ ํ‘œ์ค€ ๊ฐœ๋ฐœ ์›Œํฌํ”Œ๋กœ์šฐ -- ๋‹ค๋ฅธ ๋ชจ๋“œ ํŠธ๋ฆฌ๊ฑฐ๊ฐ€ ๊ฐ์ง€๋˜์ง€ ์•Š์Œ (๊ธฐ๋ณธ ํด๋ฐฑ) - -**ํ–‰๋™ ๋ณ€ํ™”:** -- **์ „๋ฌธ์  ์ปค๋ฎค๋‹ˆ์ผ€์ด์…˜**: ์••์ถ• ์—†์ด ๋ช…ํ™•ํ•˜๊ณ  ๊ฐ„๊ฒฐํ•œ ๊ธฐ์ˆ  ์–ธ์–ด -- **์ ๋‹นํ•œ ์„ธ๋ถ€์‚ฌํ•ญ**: ๋Œ€๋ถ€๋ถ„์˜ ๊ฐœ๋ฐœ ์ž‘์—…์— ์ ํ•ฉํ•œ ๊ท ํ˜• ์žกํžŒ ์ •๋ณด ๊นŠ์ด -- **ํ‘œ์ค€ ๋„๊ตฌ ์„ ํƒ**: ๋„ค์ดํ‹ฐ๋ธŒ Claude ๊ธฐ๋Šฅ ๋ฐ ๊ธฐ๋ณธ ๋„๊ตฌ ์‚ฌ์šฉ -- **ํ’ˆ์งˆ ์ดˆ์ **: ๋ณต์žกํ•œ ์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜ ์˜ค๋ฒ„ํ—ค๋“œ ์—†์ด ์ฝ”๋“œ ํ’ˆ์งˆ ์œ ์ง€ -- **๋ฐ˜์‘ํ˜• ์ ์‘**: ๋ณต์žก์„ฑ์ด ์ฆ๊ฐ€ํ•  ๋•Œ ์ „๋ฌธ ๋ชจ๋“œ๋กœ ์ „ํ™˜ํ•  ์ค€๋น„ - -**์˜ˆ์ œ ๊ฒฝํ—˜:** -``` -ํ‘œ์ค€ ์ ‘๊ทผ๋ฒ•: ๋ชจ๋“  ์ž‘์—…์— ๋Œ€ํ•œ ์ผ๊ด€๋˜๊ณ  ์ „๋ฌธ์ ์ธ ๊ธฐ์ค€์„  -"์ ์ ˆํ•œ ์˜ค๋ฅ˜ ์ฒ˜๋ฆฌ์™€ ํ•จ๊ป˜ ๋กœ๊ทธ์ธ ํ•จ์ˆ˜๋ฅผ ๊ตฌํ˜„ํ•˜๊ฒ ์Šต๋‹ˆ๋‹ค: - - 1. ์‚ฌ์šฉ์ž ์ž…๋ ฅ ๊ฒ€์ฆ (์ด๋ฉ”์ผ ํ˜•์‹, ๋น„๋ฐ€๋ฒˆํ˜ธ ์š”๊ตฌ์‚ฌํ•ญ) - 2. ์•ˆ์ „ํ•œ ํ•ด์‹ฑ์œผ๋กœ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค์— ๋Œ€ํ•ด ์ธ์ฆ - 3. ์ ์ ˆํ•œ ๋งŒ๋ฃŒ๋ฅผ ๊ฐ–์ถ˜ JWT ํ† ํฐ ์ƒ์„ฑ - 4. ์‚ฌ์šฉ์ž ๋ฐ์ดํ„ฐ์™€ ํ•จ๊ป˜ ์„ฑ๊ณต ์‘๋‹ต ๋ฐ˜ํ™˜ - - ๊ตฌํ˜„์€ ๋ณด์•ˆ ๋ชจ๋ฒ” ์‚ฌ๋ก€๋ฅผ ๋”ฐ๋ฅด๊ณ  ํฌ๊ด„์ ์ธ ์˜ค๋ฅ˜ ์ฒ˜๋ฆฌ๋ฅผ ํฌํ•จํ•  ๊ฒƒ์ž…๋‹ˆ๋‹ค." -``` - -**์ตœ์ ์˜ ํ˜‘์—… ๋Œ€์ƒ:** -- **โ†’ ๋ชจ๋“  ๋ชจ๋“œ**: ๋‹ค๋ฅธ ๋ชจ๋“œ๊ฐ€ ํ–ฅ์ƒ์‹œํ‚ค๋Š” ๊ธฐ์ค€์„  ์—ญํ•  -- **๋ชจ๋“œ ์ „ํ™˜**: ํ•„์š”ํ•  ๋•Œ ์ž๋™์œผ๋กœ ์ „๋ฌธ ๋ชจ๋“œ๋กœ ํ™•์žฅ -- **๋ช…ํ™•์„ฑ ์šฐ์„ ์ˆœ์œ„**: ๊ฐ„๋‹จํ•œ ์ปค๋ฎค๋‹ˆ์ผ€์ด์…˜์ด ์ตœ์ ํ™”๋ณด๋‹ค ์ค‘์š”ํ•  ๋•Œ - ---- - -## ๊ณ ๊ธ‰ ์‚ฌ์šฉ - -### ๋ชจ๋“œ ์กฐํ•ฉ - -**๋‹ค์ค‘ ๋ชจ๋“œ ์›Œํฌํ”Œ๋กœ์šฐ:** -```bash -# ๋ฐœ๊ฒฌ โ†’ ๊ณ„ํš โ†’ ๊ตฌํ˜„ -/sc:brainstorm "๋งˆ์ดํฌ๋กœ์„œ๋น„์Šค ์•„ํ‚คํ…์ฒ˜" --task-manage -# โ†’ ๋ธŒ๋ ˆ์ธ์Šคํ† ๋ฐ: ์š”๊ตฌ์‚ฌํ•ญ ๋ฐœ๊ฒฌ -# โ†’ ์ž‘์—… ๊ด€๋ฆฌ: ๋‹ค๋‹จ๊ณ„ ์กฐ์ • - -# ํˆฌ๋ช…์„ฑ ๋ฐ ํšจ์œจ์„ฑ์„ ๊ฐ–์ถ˜ ๋ถ„์„ -/sc:analyze legacy-system/ --introspect --uc -# โ†’ ๋‚ด์„ฑ: ํˆฌ๋ช…ํ•œ ์ถ”๋ก  -# โ†’ ํ† ํฐ ํšจ์œจ์„ฑ: ์••์ถ•๋œ ์ถœ๋ ฅ -``` - -### ์ˆ˜๋™ ๋ชจ๋“œ ์ œ์–ด - -**ํŠน์ • ๋™์ž‘ ๊ฐ•์ œ:** -- `--brainstorm`: ๋ชจ๋“  ์ž‘์—…์— ๋Œ€ํ•œ ํ˜‘์—… ๋ฐœ๊ฒฌ ๊ฐ•์ œ -- `--introspect`: ๋ชจ๋“  ๋ชจ๋“œ์— ์ถ”๋ก  ํˆฌ๋ช…์„ฑ ์ถ”๊ฐ€ -- `--task-manage`: ๊ณ„์ธต์  ์กฐ์ • ํ™œ์„ฑํ™” -- `--orchestrate`: ๋„๊ตฌ ์„ ํƒ ๋ฐ ๋ณ‘๋ ฌ ์‹คํ–‰ ์ตœ์ ํ™” -- `--uc`: ํšจ์œจ์„ฑ์„ ์œ„ํ•ด ์ปค๋ฎค๋‹ˆ์ผ€์ด์…˜ ์••์ถ• - -**์žฌ์ •์˜ ์˜ˆ์ œ:** -```bash -# "๋ช…ํ™•ํ•œ" ์š”๊ตฌ์‚ฌํ•ญ์— ๋ธŒ๋ ˆ์ธ์Šคํ† ๋ฐ ๊ฐ•์ œ -/sc:implement "์‚ฌ์šฉ์ž ๋กœ๊ทธ์ธ" --brainstorm - -# ๋””๋ฒ„๊น…์— ์ถ”๋ก  ํˆฌ๋ช…์„ฑ ์ถ”๊ฐ€ -# ํˆฌ๋ช…ํ•œ ์ถ”๋ก ์œผ๋กœ ์ธ์ฆ ๋ฌธ์ œ ๋””๋ฒ„๊ทธ - -# ๊ฐ„๋‹จํ•œ ์ž‘์—…์— ์ž‘์—… ๊ด€๋ฆฌ ํ™œ์„ฑํ™” -# ์ฒด๊ณ„์ ์ธ ์ž‘์—… ๊ด€๋ฆฌ๋กœ styles.css ์—…๋ฐ์ดํŠธ -``` - -### ๋ชจ๋“œ ๊ฒฝ๊ณ„ ๋ฐ ์šฐ์„ ์ˆœ์œ„ - -**๋ชจ๋“œ๊ฐ€ ํ™œ์„ฑํ™”๋˜๋Š” ์‹œ์ :** -1. **๋ณต์žก์„ฑ ์ž„๊ณ„๊ฐ’**: >3๊ฐœ ํŒŒ์ผ โ†’ ์ž‘์—… ๊ด€๋ฆฌ -2. **๋ฆฌ์†Œ์Šค ์••๋ฐ•**: ๋†’์€ ์ปจํ…์ŠคํŠธ ์‚ฌ์šฉ โ†’ ํ† ํฐ ํšจ์œจ์„ฑ -3. **๋‹ค์ค‘ ๋„๊ตฌ ํ•„์š”**: ๋ณต์žกํ•œ ๋ถ„์„ โ†’ ์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜ -4. **๋ถˆํ™•์‹ค์„ฑ**: ๋ชจํ˜ธํ•œ ์š”๊ตฌ์‚ฌํ•ญ โ†’ ๋ธŒ๋ ˆ์ธ์Šคํ† ๋ฐ -5. **์˜ค๋ฅ˜ ๋ณต๊ตฌ**: ๋ฌธ์ œ โ†’ ๋‚ด์„ฑ - -**์šฐ์„ ์ˆœ์œ„ ๊ทœ์น™:** -- **์•ˆ์ „ ์šฐ์„ **: ํ’ˆ์งˆ ๋ฐ ๊ฒ€์ฆ์ด ํ•ญ์ƒ ํšจ์œจ์„ฑ ์žฌ์ •์˜ -- **์‚ฌ์šฉ์ž ์˜๋„**: ์ˆ˜๋™ ํ”Œ๋ž˜๊ทธ๊ฐ€ ์ž๋™ ๊ฐ์ง€ ์žฌ์ •์˜ -- **์ปจํ…์ŠคํŠธ ์ ์‘**: ๋ชจ๋“œ๊ฐ€ ๋ณต์žก์„ฑ์— ๋”ฐ๋ผ ์Šคํƒ๋จ -- **๋ฆฌ์†Œ์Šค ๊ด€๋ฆฌ**: ์••๋ฐ• ํ•˜์—์„œ ํšจ์œจ์„ฑ ๋ชจ๋“œ ํ™œ์„ฑํ™” - ---- - -## ์‹ค์ œ ์˜ˆ์ œ - -### ์™„์ „ํ•œ ์›Œํฌํ”Œ๋กœ์šฐ ์˜ˆ์ œ - -**์ƒˆ ํ”„๋กœ์ ํŠธ ๊ฐœ๋ฐœ:** -```bash -# 1๋‹จ๊ณ„: ๋ฐœ๊ฒฌ (๋ธŒ๋ ˆ์ธ์Šคํ† ๋ฐ ๋ชจ๋“œ ์ž๋™ ํ™œ์„ฑํ™”) -"์ƒ์‚ฐ์„ฑ ์•ฑ์„ ๋งŒ๋“ค๊ณ  ์‹ถ์–ด์š”" -โ†’ ๐Ÿค” ์‚ฌ์šฉ์ž, ๊ธฐ๋Šฅ, ํ”Œ๋žซํผ ์„ ํƒ์— ๋Œ€ํ•œ ์†Œํฌ๋ผํ…Œ์Šค์‹ ์งˆ๋ฌธ -โ†’ ๐Ÿ“ ๊ตฌ์กฐํ™”๋œ ์š”๊ตฌ์‚ฌํ•ญ ๋ธŒ๋ฆฌํ”„ - -# 2๋‹จ๊ณ„: ๊ณ„ํš (์ž‘์—… ๊ด€๋ฆฌ ๋ชจ๋“œ ์ž๋™ ํ™œ์„ฑํ™”) -/sc:implement "ํ•ต์‹ฌ ์ƒ์‚ฐ์„ฑ ๊ธฐ๋Šฅ" -โ†’ ๐Ÿ“‹ ์ข…์†์„ฑ์ด ์žˆ๋Š” ๋‹ค๋‹จ๊ณ„ ๋ถ„ํ•ด -โ†’ ๐ŸŽฏ ํ’ˆ์งˆ ๊ฒŒ์ดํŠธ๋ฅผ ๊ฐ–์ถ˜ ๋‹จ๊ณ„ ์กฐ์ • - -# 3๋‹จ๊ณ„: ๊ตฌํ˜„ (์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜ ๋ชจ๋“œ๊ฐ€ ๋„๊ตฌ ์กฐ์ •) -/sc:implement "ํ”„๋ก ํŠธ์—”๋“œ ๋ฐ ๋ฐฑ์—”๋“œ ์‹œ์Šคํ…œ" -โ†’ ๐ŸŽฏ Magic (UI) + Context7 (ํŒจํ„ด) + Sequential (์•„ํ‚คํ…์ฒ˜) -โ†’ โšก ๋ณ‘๋ ฌ ์‹คํ–‰ ์ตœ์ ํ™” -``` - -**๋ณต์žกํ•œ ๋ฌธ์ œ ๋””๋ฒ„๊น…:** -```bash -# ๋ฌธ์ œ ๋ถ„์„ (๋‚ด์„ฑ ๋ชจ๋“œ ์ž๋™ ํ™œ์„ฑํ™”) -"์‚ฌ์šฉ์ž๊ฐ€ ๊ฐ„ํ—์ ์ธ ์ธ์ฆ ์‹คํŒจ๋ฅผ ๊ฒช๊ณ  ์žˆ์–ด์š”" -โ†’ ๐Ÿค” ์ž ์žฌ์  ์›์ธ์— ๋Œ€ํ•œ ํˆฌ๋ช…ํ•œ ์ถ”๋ก  -โ†’ ๐ŸŽฏ ๊ฐ€์„ค ํ˜•์„ฑ ๋ฐ ์ฆ๊ฑฐ ์ˆ˜์ง‘ -โ†’ ๐Ÿ’ก ์œ ์‚ฌํ•œ ๋ฌธ์ œ ์ „๋ฐ˜์˜ ํŒจํ„ด ์ธ์‹ - -# ์ฒด๊ณ„์  ํ•ด๊ฒฐ (์ž‘์—… ๊ด€๋ฆฌ๊ฐ€ ์กฐ์ •) -# ์ธ์ฆ ์‹œ์Šคํ…œ ํฌ๊ด„์ ์œผ๋กœ ์ˆ˜์ • -โ†’ ๐Ÿ“‹ 1๋‹จ๊ณ„: ๊ทผ๋ณธ ์›์ธ ๋ถ„์„ -โ†’ ๐Ÿ“‹ 2๋‹จ๊ณ„: ์†”๋ฃจ์…˜ ๊ตฌํ˜„ -โ†’ ๐Ÿ“‹ 3๋‹จ๊ณ„: ํ…Œ์ŠคํŒ… ๋ฐ ๊ฒ€์ฆ -``` - -### ๋ชจ๋“œ ์กฐํ•ฉ ํŒจํ„ด - -**๋†’์€ ๋ณต์žก์„ฑ ์‹œ๋‚˜๋ฆฌ์˜ค:** -```bash -# ์—ฌ๋Ÿฌ ์ œ์•ฝ์ด ์žˆ๋Š” ๋Œ€๊ทœ๋ชจ ๋ฆฌํŒฉํ† ๋ง -/sc:improve legacy-system/ --introspect --uc --orchestrate -โ†’ ๐Ÿ” ํˆฌ๋ช…ํ•œ ์ถ”๋ก  (๋‚ด์„ฑ) -โ†’ โšก ์••์ถ• ์ปค๋ฎค๋‹ˆ์ผ€์ด์…˜ (ํ† ํฐ ํšจ์œจ์„ฑ) -โ†’ ๐ŸŽฏ ์ตœ์ ์˜ ๋„๊ตฌ ์กฐ์ • (์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜) -โ†’ ๐Ÿ“‹ ์ฒด๊ณ„์  ๋‹จ๊ณ„ (์ž‘์—… ๊ด€๋ฆฌ ์ž๋™ ํ™œ์„ฑํ™”) -``` - ---- - -## ๋น ๋ฅธ ์ฐธ์กฐ - -### ๋ชจ๋“œ ํ™œ์„ฑํ™” ํŒจํ„ด - -| ํŠธ๋ฆฌ๊ฑฐ ์œ ํ˜• | ์˜ˆ์ œ ์ž…๋ ฅ | ํ™œ์„ฑํ™”๋œ ๋ชจ๋“œ | ์ฃผ์š” ๋™์ž‘ | -|--------------|---------------|----------------|--------------| -| **๋ชจํ˜ธํ•œ ์š”์ฒญ** | "์•ฑ์„ ๋งŒ๋“ค๊ณ  ์‹ถ์–ด์š”" | ๐Ÿง  ๋ธŒ๋ ˆ์ธ์Šคํ† ๋ฐ | ์†Œํฌ๋ผํ…Œ์Šค์‹ ๋ฐœ๊ฒฌ ์งˆ๋ฌธ | -| **๋ณต์žกํ•œ ๋ฒ”์œ„** | >3๊ฐœ ํŒŒ์ผ ๋˜๋Š” >2๊ฐœ ๋””๋ ‰ํ† ๋ฆฌ | ๐Ÿ“‹ ์ž‘์—… ๊ด€๋ฆฌ | ๋‹จ๊ณ„ ์กฐ์ • | -| **๋‹ค์ค‘ ๋„๊ตฌ ํ•„์š”** | ๋ถ„์„ + ๊ตฌํ˜„ | ๐ŸŽฏ ์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜ | ๋„๊ตฌ ์ตœ์ ํ™” | -| **์˜ค๋ฅ˜ ๋ณต๊ตฌ** | "์˜ˆ์ƒ๋Œ€๋กœ ์ž‘๋™ํ•˜์ง€ ์•Š์•„์š”" | ๐Ÿ” ๋‚ด์„ฑ | ํˆฌ๋ช…ํ•œ ์ถ”๋ก  | -| **๋ฆฌ์†Œ์Šค ์••๋ฐ•** | ๋†’์€ ์ปจํ…์ŠคํŠธ ์‚ฌ์šฉ | โšก ํ† ํฐ ํšจ์œจ์„ฑ | ์‹ฌ๋ณผ ์••์ถ• | -| **๊ฐ„๋‹จํ•œ ์ž‘์—…** | "์ด ํ•จ์ˆ˜ ์ˆ˜์ •" | ๐ŸŽจ ํ‘œ์ค€ | ๋ช…ํ™•ํ•˜๊ณ  ์ง์ ‘์ ์ธ ์ ‘๊ทผ | - -### ์ˆ˜๋™ ์žฌ์ •์˜ ๋ช…๋ น์–ด - -```bash -# ํŠน์ • ๋ชจ๋“œ ๋™์ž‘ ๊ฐ•์ œ -/sc:command --brainstorm # ํ˜‘์—… ๋ฐœ๊ฒฌ -/sc:command --introspect # ์ถ”๋ก  ํˆฌ๋ช…์„ฑ -/sc:command --task-manage # ๊ณ„์ธต์  ์กฐ์ • -/sc:command --orchestrate # ๋„๊ตฌ ์ตœ์ ํ™” -/sc:command --uc # ํ† ํฐ ์••์ถ• - -# ์—ฌ๋Ÿฌ ๋ชจ๋“œ ๊ฒฐํ•ฉ -/sc:command --introspect --uc # ํˆฌ๋ช… + ํšจ์œจ์  -/sc:command --task-manage --orchestrate # ์กฐ์ • + ์ตœ์ ํ™” -``` - ---- - -## ๋ฌธ์ œ ํ•ด๊ฒฐ - -๋ฌธ์ œ ํ•ด๊ฒฐ ๋„์›€๋ง์€ ๋‹ค์Œ์„ ์ฐธ์กฐํ•˜์„ธ์š”: -- [์ผ๋ฐ˜์ ์ธ ๋ฌธ์ œ](../Reference/common-issues.md) - ์ž์ฃผ ๋ฐœ์ƒํ•˜๋Š” ๋ฌธ์ œ์— ๋Œ€ํ•œ ๋น ๋ฅธ ์ˆ˜์ • -- [๋ฌธ์ œ ํ•ด๊ฒฐ ๊ฐ€์ด๋“œ](../Reference/troubleshooting.md) - ํฌ๊ด„์ ์ธ ๋ฌธ์ œ ํ•ด๊ฒฐ - -### ์ผ๋ฐ˜์ ์ธ ๋ฌธ์ œ -- **๋ชจ๋“œ๊ฐ€ ํ™œ์„ฑํ™”๋˜์ง€ ์•Š์Œ**: ์ˆ˜๋™ ํ”Œ๋ž˜๊ทธ ์‚ฌ์šฉ: `--brainstorm`, `--introspect`, `--uc` -- **์ž˜๋ชป๋œ ๋ชจ๋“œ ํ™œ์„ฑํ™”**: ์š”์ฒญ์˜ ๋ณต์žก์„ฑ ํŠธ๋ฆฌ๊ฑฐ ๋ฐ ํ‚ค์›Œ๋“œ ํ™•์ธ -- **๋ชจ๋“œ๊ฐ€ ์˜ˆ๊ธฐ์น˜ ์•Š๊ฒŒ ์ „ํ™˜๋จ**: ์ž‘์—… ์ง„ํ™”์— ๋”ฐ๋ฅธ ์ •์ƒ์ ์ธ ๋™์ž‘ -- **์‹คํ–‰ ์˜ํ–ฅ**: ๋ชจ๋“œ๋Š” ๋„๊ตฌ ์‚ฌ์šฉ ์ตœ์ ํ™”, ์‹คํ–‰์— ์˜ํ–ฅ์„ ์ฃผ์ง€ ์•Š์•„์•ผ ํ•จ -- **๋ชจ๋“œ ์ถฉ๋Œ**: [ํ”Œ๋ž˜๊ทธ ๊ฐ€์ด๋“œ](flags.md)์˜ ํ”Œ๋ž˜๊ทธ ์šฐ์„ ์ˆœ์œ„ ๊ทœ์น™ ํ™•์ธ - -### ์ฆ‰๊ฐ์ ์ธ ์ˆ˜์ • -- **ํŠน์ • ๋ชจ๋“œ ๊ฐ•์ œ**: `--brainstorm` ๋˜๋Š” `--task-manage`์™€ ๊ฐ™์€ ๋ช…์‹œ์  ํ”Œ๋ž˜๊ทธ ์‚ฌ์šฉ -- **๋ชจ๋“œ ๋™์ž‘ ์žฌ์„ค์ •**: ๋ชจ๋“œ ์ƒํƒœ๋ฅผ ์žฌ์„ค์ •ํ•˜๋ ค๋ฉด Claude Code ์„ธ์…˜ ์žฌ์‹œ์ž‘ -- **๋ชจ๋“œ ์ง€ํ‘œ ํ™•์ธ**: ์‘๋‹ต์—์„œ ๐Ÿค”, ๐ŸŽฏ, ๐Ÿ“‹ ์‹ฌ๋ณผ ์ฐพ๊ธฐ -- **๋ณต์žก์„ฑ ํ™•์ธ**: ๊ฐ„๋‹จํ•œ ์ž‘์—…์€ ํ‘œ์ค€ ๋ชจ๋“œ ์‚ฌ์šฉ, ๋ณต์žกํ•œ ์ž‘์—…์€ ์ž๋™ ์ „ํ™˜ - -### ๋ชจ๋“œ๋ณ„ ๋ฌธ์ œ ํ•ด๊ฒฐ - -**๋ธŒ๋ ˆ์ธ์Šคํ† ๋ฐ ๋ชจ๋“œ ๋ฌธ์ œ:** -```bash -# ๋ฌธ์ œ: ๋ชจ๋“œ๊ฐ€ ์งˆ๋ฌธ ๋Œ€์‹  ์†”๋ฃจ์…˜ ์ œ๊ณต -# ๋น ๋ฅธ ์ˆ˜์ •: ์š”์ฒญ ๋ช…ํ™•์„ฑ ํ™•์ธ ๋ฐ ๋ช…์‹œ์  ํ”Œ๋ž˜๊ทธ ์‚ฌ์šฉ -/sc:brainstorm "์›น ์•ฑ" --brainstorm # ๋ฐœ๊ฒฌ ๋ชจ๋“œ ๊ฐ•์ œ -"...์— ๋Œ€ํ•œ ๋ชจํ˜ธํ•œ ์•„์ด๋””์–ด๊ฐ€ ์žˆ์–ด์š”" # ๋ถˆํ™•์‹ค์„ฑ ์–ธ์–ด ์‚ฌ์šฉ -"...๋ฅผ ๊ตฌ์ถ•ํ•  ์ˆ˜ ์žˆ์„๊นŒ์š”" # ํƒ์ƒ‰ ํŠธ๋ฆฌ๊ฑฐ -``` - -**์ž‘์—… ๊ด€๋ฆฌ ๋ชจ๋“œ ๋ฌธ์ œ:** -```bash -# ๋ฌธ์ œ: ๊ฐ„๋‹จํ•œ ์ž‘์—…์ด ๋ณต์žกํ•œ ์กฐ์ •์„ ๋ฐ›์Œ -# ๋น ๋ฅธ ์ˆ˜์ •: ๋ฒ”์œ„ ์ค„์ด๊ธฐ ๋˜๋Š” ๋” ๊ฐ„๋‹จํ•œ ๋ช…๋ น์–ด ์‚ฌ์šฉ -/sc:implement "ํ•จ์ˆ˜" --no-task-manage # ์กฐ์ • ๋น„ํ™œ์„ฑํ™” -/sc:troubleshoot bug.js # ๊ธฐ๋ณธ ๋ช…๋ น์–ด ์‚ฌ์šฉ -# ์ž‘์—…์ด ์ •๋ง ๋ณต์žกํ•œ์ง€ ํ™•์ธ (>3๊ฐœ ํŒŒ์ผ, >2๊ฐœ ๋””๋ ‰ํ† ๋ฆฌ) -``` - -**ํ† ํฐ ํšจ์œจ์„ฑ ๋ชจ๋“œ ๋ฌธ์ œ:** -```bash -# ๋ฌธ์ œ: ์ถœ๋ ฅ์ด ๋„ˆ๋ฌด ์••์ถ•๋˜๊ฑฐ๋‚˜ ๋ถˆ๋ช…ํ™•ํ•จ -# ๋น ๋ฅธ ์ˆ˜์ •: ๋ช…ํ™•์„ฑ์„ ์œ„ํ•ด ์••์ถ• ๋น„ํ™œ์„ฑํ™” -/sc:command --no-uc # ์••์ถ• ๋น„ํ™œ์„ฑํ™” -/sc:command --verbose # ์ƒ์„ธ ์ถœ๋ ฅ ๊ฐ•์ œ -# ๋ช…ํ™•์„ฑ์ด ํšจ์œจ์„ฑ๋ณด๋‹ค ์ค‘์š”ํ•  ๋•Œ ์‚ฌ์šฉ -``` - -**๋‚ด์„ฑ ๋ชจ๋“œ ๋ฌธ์ œ:** -```bash -# ๋ฌธ์ œ: ๋„ˆ๋ฌด ๋งŽ์€ ๋ฉ”ํƒ€ ์ฃผ์„, ์ถฉ๋ถ„ํ•œ ํ–‰๋™ ์—†์Œ -# ๋น ๋ฅธ ์ˆ˜์ •: ์ง์ ‘ ์ž‘์—…์„ ์œ„ํ•ด ๋‚ด์„ฑ ๋น„ํ™œ์„ฑํ™” -/sc:command --no-introspect # ์ง์ ‘ ์‹คํ–‰ -# ํ•™์Šต ๋ฐ ๋””๋ฒ„๊น…์—๋งŒ ๋‚ด์„ฑ ์‚ฌ์šฉ -``` - -**์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜ ๋ชจ๋“œ ๋ฌธ์ œ:** -```bash -# ๋ฌธ์ œ: ๋„๊ตฌ ์กฐ์ •์ด ํ˜ผ๋ž€ ์•ผ๊ธฐ -# ๋น ๋ฅธ ์ˆ˜์ •: ๋„๊ตฌ ์‚ฌ์šฉ ๋‹จ์ˆœํ™” -/sc:command --no-mcp # ๋„ค์ดํ‹ฐ๋ธŒ ๋„๊ตฌ๋งŒ -/sc:command --simple # ๊ธฐ๋ณธ ์‹คํ–‰ -# ์ž‘์—… ๋ณต์žก์„ฑ์ด ์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜์„ ์ •๋‹นํ™”ํ•˜๋Š”์ง€ ํ™•์ธ -``` - -### ์˜ค๋ฅ˜ ์ฝ”๋“œ ์ฐธ์กฐ - -| ๋ชจ๋“œ ์˜ค๋ฅ˜ | ์˜๋ฏธ | ๋น ๋ฅธ ์ˆ˜์ • | -|------------|---------|-----------| -| **B001** | ๋ธŒ๋ ˆ์ธ์Šคํ† ๋ฐ ํ™œ์„ฑํ™” ์‹คํŒจ | ๋ช…์‹œ์  `--brainstorm` ํ”Œ๋ž˜๊ทธ ์‚ฌ์šฉ | -| **T001** | ์ž‘์—… ๊ด€๋ฆฌ ์˜ค๋ฒ„ํ—ค๋“œ | ๊ฐ„๋‹จํ•œ ์ž‘์—…์— `--no-task-manage` ์‚ฌ์šฉ | -| **U001** | ํ† ํฐ ํšจ์œจ์„ฑ์ด ๋„ˆ๋ฌด ๊ณต๊ฒฉ์  | `--verbose` ๋˜๋Š” `--no-uc` ์‚ฌ์šฉ | -| **I001** | ๋‚ด์„ฑ ๋ชจ๋“œ ์ •์ฒด | ์ง์ ‘ ํ–‰๋™์„ ์œ„ํ•ด `--no-introspect` ์‚ฌ์šฉ | -| **O001** | ์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜ ์กฐ์ • ์‹คํŒจ | `--no-mcp` ๋˜๋Š” `--simple` ์‚ฌ์šฉ | -| **M001** | ๋ชจ๋“œ ์ถฉ๋Œ ๊ฐ์ง€ | ํ”Œ๋ž˜๊ทธ ์šฐ์„ ์ˆœ์œ„ ๊ทœ์น™ ํ™•์ธ | -| **M002** | ๋ชจ๋“œ ์ „ํ™˜ ๋ฃจํ”„ | ์ƒํƒœ๋ฅผ ์žฌ์„ค์ •ํ•˜๋ ค๋ฉด ์„ธ์…˜ ์žฌ์‹œ์ž‘ | -| **M003** | ๋ชจ๋“œ๋ฅผ ์ธ์‹ํ•  ์ˆ˜ ์—†์Œ | SuperClaude ์—…๋ฐ์ดํŠธ ๋˜๋Š” ์ฒ ์ž ํ™•์ธ | - -### ์ ์ง„์  ์ง€์› ์ˆ˜์ค€ - -**์ˆ˜์ค€ 1: ๋น ๋ฅธ ์ˆ˜์ • (< 2๋ถ„)** -- ์ž๋™ ๋ชจ๋“œ ์„ ํƒ์„ ์žฌ์ •์˜ํ•˜๋ ค๋ฉด ์ˆ˜๋™ ํ”Œ๋ž˜๊ทธ ์‚ฌ์šฉ -- ์ž‘์—… ๋ณต์žก์„ฑ์ด ์˜ˆ์ƒ ๋ชจ๋“œ ๋™์ž‘๊ณผ ์ผ์น˜ํ•˜๋Š”์ง€ ํ™•์ธ -- Claude Code ์„ธ์…˜ ์žฌ์‹œ์ž‘ ์‹œ๋„ - -**์ˆ˜์ค€ 2: ์ƒ์„ธ ๋„์›€๋ง (5-15๋ถ„)** -```bash -# ๋ชจ๋“œ๋ณ„ ์ง„๋‹จ -/sc:help modes # ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ ๋ชจ๋“  ๋ชจ๋“œ ๋‚˜์—ด -/sc:reflect --type mode-status # ํ˜„์žฌ ๋ชจ๋“œ ์ƒํƒœ ํ™•์ธ -# ์š”์ฒญ ๋ณต์žก์„ฑ ๋ฐ ํŠธ๋ฆฌ๊ฑฐ ๊ฒ€ํ†  -``` -- ๋ชจ๋“œ ์„ค์น˜ ๋ฌธ์ œ๋Š” [์ผ๋ฐ˜์ ์ธ ๋ฌธ์ œ ๊ฐ€์ด๋“œ](../Reference/common-issues.md) ์ฐธ์กฐ - -**์ˆ˜์ค€ 3: ์ „๋ฌธ๊ฐ€ ์ง€์› (30๋ถ„ ์ด์ƒ)** -```bash -# ์‹ฌ์ธต ๋ชจ๋“œ ๋ถ„์„ -SuperClaude install --diagnose -# ๋ชจ๋“œ ํ™œ์„ฑํ™” ํŒจํ„ด ํ™•์ธ -# ํ–‰๋™ ํŠธ๋ฆฌ๊ฑฐ ๋ฐ ์ž„๊ณ„๊ฐ’ ๊ฒ€ํ†  -``` -- ํ–‰๋™ ๋ชจ๋“œ ๋ถ„์„์€ [์ง„๋‹จ ์ฐธ์กฐ ๊ฐ€์ด๋“œ](../Reference/diagnostic-reference.md) ์ฐธ์กฐ - -**์ˆ˜์ค€ 4: ์ปค๋ฎค๋‹ˆํ‹ฐ ์ง€์›** -- [GitHub Issues](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues)์—์„œ ๋ชจ๋“œ ๋ฌธ์ œ ๋ณด๊ณ  -- ์˜ˆ์ƒ์น˜ ๋ชปํ•œ ๋ชจ๋“œ ๋™์ž‘ ์˜ˆ์ œ ํฌํ•จ -- ์›ํ•˜๋Š” ๋ชจ๋“œ ํ™œ์„ฑํ™” vs ์‹ค์ œ ๋ชจ๋“œ ํ™œ์„ฑํ™” ์„ค๋ช… - -### ์„ฑ๊ณต ๊ฒ€์ฆ - -๋ชจ๋“œ ์ˆ˜์ • ์ ์šฉ ํ›„ ๋‹ค์Œ์œผ๋กœ ํ…Œ์ŠคํŠธ: -- [ ] ๊ฐ„๋‹จํ•œ ์š”์ฒญ์€ ํ‘œ์ค€ ๋ชจ๋“œ ์‚ฌ์šฉ (๋ช…ํ™•ํ•˜๊ณ  ์ง์ ‘์ ์ธ ์‘๋‹ต) -- [ ] ๋ณต์žกํ•œ ์š”์ฒญ์€ ์ ์ ˆํ•œ ๋ชจ๋“œ ์ž๋™ ํ™œ์„ฑํ™” (์กฐ์ •, ์ถ”๋ก ) -- [ ] ์ˆ˜๋™ ํ”Œ๋ž˜๊ทธ๊ฐ€ ์ž๋™ ๊ฐ์ง€๋ฅผ ์˜ฌ๋ฐ”๋ฅด๊ฒŒ ์žฌ์ •์˜ -- [ ] ์˜ˆ์ƒ๋  ๋•Œ ๋ชจ๋“œ ์ง€ํ‘œ (๐Ÿค”, ๐ŸŽฏ, ๐Ÿ“‹) ๋‚˜ํƒ€๋‚จ -- [ ] ๋‹ค์–‘ํ•œ ๋ชจ๋“œ ์ „๋ฐ˜์— ๊ฑธ์ณ ์„ฑ๋Šฅ์ด ์–‘ํ˜ธํ•˜๊ฒŒ ์œ ์ง€๋จ - -## ๋น ๋ฅธ ๋ฌธ์ œ ํ•ด๊ฒฐ (๋ ˆ๊ฑฐ์‹œ) -- **๋ชจ๋“œ๊ฐ€ ํ™œ์„ฑํ™”๋˜์ง€ ์•Š์Œ** โ†’ ์ˆ˜๋™ ํ”Œ๋ž˜๊ทธ ์‚ฌ์šฉ: `--brainstorm`, `--introspect`, `--uc` -- **์ž˜๋ชป๋œ ๋ชจ๋“œ ํ™œ์„ฑํ™”** โ†’ ์š”์ฒญ์˜ ๋ณต์žก์„ฑ ํŠธ๋ฆฌ๊ฑฐ ๋ฐ ํ‚ค์›Œ๋“œ ํ™•์ธ -- **๋ชจ๋“œ๊ฐ€ ์˜ˆ๊ธฐ์น˜ ์•Š๊ฒŒ ์ „ํ™˜๋จ** โ†’ ์ž‘์—… ์ง„ํ™”์— ๋”ฐ๋ฅธ ์ •์ƒ์ ์ธ ๋™์ž‘ -- **์‹คํ–‰ ์˜ํ–ฅ** โ†’ ๋ชจ๋“œ๋Š” ๋„๊ตฌ ์‚ฌ์šฉ ์ตœ์ ํ™”, ์‹คํ–‰์— ์˜ํ–ฅ์„ ์ฃผ์ง€ ์•Š์•„์•ผ ํ•จ -- **๋ชจ๋“œ ์ถฉ๋Œ** โ†’ [ํ”Œ๋ž˜๊ทธ ๊ฐ€์ด๋“œ](flags.md)์˜ ํ”Œ๋ž˜๊ทธ ์šฐ์„ ์ˆœ์œ„ ๊ทœ์น™ ํ™•์ธ - -## ์ž์ฃผ ๋ฌป๋Š” ์งˆ๋ฌธ - -**Q: ์–ด๋–ค ๋ชจ๋“œ๊ฐ€ ํ™œ์„ฑํ™”๋˜์–ด ์žˆ๋Š”์ง€ ์–ด๋–ป๊ฒŒ ์•Œ ์ˆ˜ ์žˆ๋‚˜์š”?** -A: ์ปค๋ฎค๋‹ˆ์ผ€์ด์…˜ ํŒจํ„ด์—์„œ ์ด๋Ÿฌํ•œ ์ง€ํ‘œ๋ฅผ ์ฐพ์œผ์„ธ์š”: -- ๐Ÿค” ๋ฐœ๊ฒฌ ์งˆ๋ฌธ โ†’ ๋ธŒ๋ ˆ์ธ์Šคํ† ๋ฐ -- ๐ŸŽฏ ์ถ”๋ก  ํˆฌ๋ช…์„ฑ โ†’ ๋‚ด์„ฑ -- ๋‹จ๊ณ„ ๋ถ„ํ•ด โ†’ ์ž‘์—… ๊ด€๋ฆฌ -- ๋„๊ตฌ ์กฐ์ • โ†’ ์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜ -- ์‹ฌ๋ณผ ์••์ถ• โ†’ ํ† ํฐ ํšจ์œจ์„ฑ - -**Q: ํŠน์ • ๋ชจ๋“œ๋ฅผ ๊ฐ•์ œํ•  ์ˆ˜ ์žˆ๋‚˜์š”?** -A: ์˜ˆ, ์ž๋™ ๊ฐ์ง€๋ฅผ ์žฌ์ •์˜ํ•˜๋ ค๋ฉด ์ˆ˜๋™ ํ”Œ๋ž˜๊ทธ ์‚ฌ์šฉ: -```bash -/sc:command --brainstorm # ๋ฐœ๊ฒฌ ๊ฐ•์ œ -/sc:command --introspect # ํˆฌ๋ช…์„ฑ ์ถ”๊ฐ€ -/sc:command --task-manage # ์กฐ์ • ํ™œ์„ฑํ™” -/sc:command --uc # ์ถœ๋ ฅ ์••์ถ• -``` - -**Q: ๋ชจ๋“œ๊ฐ€ ์‹คํ–‰์— ์˜ํ–ฅ์„ ๋ฏธ์น˜๋‚˜์š”?** -A: ๋ชจ๋“œ๋Š” ์กฐ์ •์„ ํ†ตํ•ด ๋„๊ตฌ ์‚ฌ์šฉ ์ตœ์ ํ™”: -- **ํ† ํฐ ํšจ์œจ์„ฑ**: 30-50% ์ปจํ…์ŠคํŠธ ๊ฐ์†Œ -- **์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜**: ๋ณ‘๋ ฌ ์ฒ˜๋ฆฌ -- **์ž‘์—… ๊ด€๋ฆฌ**: ์ฒด๊ณ„์ ์ธ ๊ณ„ํš์„ ํ†ตํ•œ ์žฌ์ž‘์—… ๋ฐฉ์ง€ - -**Q: ๋ชจ๋“œ๊ฐ€ ํ•จ๊ป˜ ์ž‘๋™ํ•  ์ˆ˜ ์žˆ๋‚˜์š”?** -A: ์˜ˆ, ๋ชจ๋“œ๋Š” ์„œ๋กœ๋ฅผ ๋ณด์™„ํ•˜๋„๋ก ์„ค๊ณ„๋จ: -- **์ž‘์—… ๊ด€๋ฆฌ**๊ฐ€ ๋‹ค๋ฅธ ๋ชจ๋“œ ์กฐ์ • -- **ํ† ํฐ ํšจ์œจ์„ฑ**์ด ๋ชจ๋“  ๋ชจ๋“œ์˜ ์ถœ๋ ฅ ์••์ถ• -- **๋‚ด์„ฑ**์ด ๋ชจ๋“  ์›Œํฌํ”Œ๋กœ์šฐ์— ํˆฌ๋ช…์„ฑ ์ถ”๊ฐ€ - ---- - -## ์š”์•ฝ - -SuperClaude์˜ 5๊ฐ€์ง€ ํ–‰๋™ ๋ชจ๋“œ๋Š” ํ•„์š”์— ๋”ฐ๋ผ ์ž๋™์œผ๋กœ ์ผ์น˜ํ•˜๋Š” **์ง€๋Šฅํ˜• ์ ์‘ ์‹œ์Šคํ…œ**์„ ๋งŒ๋“ญ๋‹ˆ๋‹ค: - -- **๐Ÿง  ๋ธŒ๋ ˆ์ธ์Šคํ† ๋ฐ**: ๋ชจํ˜ธํ•œ ์•„์ด๋””์–ด๋ฅผ ๋ช…ํ™•ํ•œ ์š”๊ตฌ์‚ฌํ•ญ์œผ๋กœ ๋ณ€ํ™˜ -- **๐Ÿ” ๋‚ด์„ฑ**: ํ•™์Šต ๋ฐ ๋””๋ฒ„๊น…์„ ์œ„ํ•œ ํˆฌ๋ช…ํ•œ ์ถ”๋ก  ์ œ๊ณต -- **๐Ÿ“‹ ์ž‘์—… ๊ด€๋ฆฌ**: ๋ณต์žกํ•œ ๋‹ค๋‹จ๊ณ„ ์ž‘์—… ์กฐ์ • -- **๐ŸŽฏ ์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜**: ๋„๊ตฌ ์„ ํƒ ๋ฐ ๋ณ‘๋ ฌ ์‹คํ–‰ ์ตœ์ ํ™” -- **โšก ํ† ํฐ ํšจ์œจ์„ฑ**: ๋ช…ํ™•์„ฑ์„ ์œ ์ง€ํ•˜๋ฉด์„œ ์ปค๋ฎค๋‹ˆ์ผ€์ด์…˜ ์••์ถ• -- **๐ŸŽจ ํ‘œ์ค€**: ๊ฐ„๋‹จํ•œ ์ž‘์—…์„ ์œ„ํ•œ ์ „๋ฌธ์  ๊ธฐ์ค€์„  ์œ ์ง€ - -**ํ•ต์‹ฌ ์ธ์‚ฌ์ดํŠธ**: ๋ชจ๋“œ์— ๋Œ€ํ•ด ์ƒ๊ฐํ•  ํ•„์š”๊ฐ€ ์—†์Šต๋‹ˆ๋‹ค - ๊ฐœ๋ฐœ ๊ฒฝํ—˜์„ ํ–ฅ์ƒ์‹œํ‚ค๊ธฐ ์œ„ํ•ด ํˆฌ๋ช…ํ•˜๊ฒŒ ์ž‘๋™ํ•ฉ๋‹ˆ๋‹ค. ๋‹ฌ์„ฑํ•˜๊ณ ์ž ํ•˜๋Š” ๊ฒƒ์„ ์„ค๋ช…ํ•˜๋ฉด SuperClaude๊ฐ€ ์ž๋™์œผ๋กœ ํ•„์š”์— ๋งž๊ฒŒ ์ ‘๊ทผ ๋ฐฉ์‹์„ ์กฐ์ •ํ•ฉ๋‹ˆ๋‹ค. - ---- - -## ๊ด€๋ จ ๊ฐ€์ด๋“œ - -**ํ•™์Šต ์ง„ํ–‰:** - -**๐ŸŒฑ ํ•„์ˆ˜ (1์ฃผ์ฐจ)** -- [๋น ๋ฅธ ์‹œ์ž‘ ๊ฐ€์ด๋“œ](../Getting-Started/quick-start.md) - ๋ชจ๋“œ ํ™œ์„ฑํ™” ์˜ˆ์ œ -- [๋ช…๋ น์–ด ์ฐธ์กฐ](commands.md) - ๋ช…๋ น์–ด๊ฐ€ ์ž๋™์œผ๋กœ ๋ชจ๋“œ ํ™œ์„ฑํ™” -- [์„ค์น˜ ๊ฐ€์ด๋“œ](../Getting-Started/installation.md) - ํ–‰๋™ ๋ชจ๋“œ ์„ค์ • - -**๐ŸŒฟ ์ค‘๊ธ‰ (2-3์ฃผ์ฐจ)** -- [์—์ด์ „ํŠธ ๊ฐ€์ด๋“œ](agents.md) - ๋ชจ๋“œ๊ฐ€ ์ „๋ฌธ๊ฐ€์™€ ์กฐ์ •ํ•˜๋Š” ๋ฐฉ๋ฒ• -- [ํ”Œ๋ž˜๊ทธ ๊ฐ€์ด๋“œ](flags.md) - ์ˆ˜๋™ ๋ชจ๋“œ ์ œ์–ด ๋ฐ ์ตœ์ ํ™” -- [์˜ˆ์ œ ๋ชจ์Œ](../Reference/examples-cookbook.md) - ์‹ค์ œ ๋ชจ๋“œ ํŒจํ„ด - -**๐ŸŒฒ ๊ณ ๊ธ‰ (2๊ฐœ์›” ์ด์ƒ)** -- [MCP ์„œ๋ฒ„](mcp-servers.md) - ํ–ฅ์ƒ๋œ ๊ธฐ๋Šฅ๊ณผ์˜ ๋ชจ๋“œ ํ†ตํ•ฉ -- [์„ธ์…˜ ๊ด€๋ฆฌ](session-management.md) - ์ž‘์—… ๊ด€๋ฆฌ ๋ชจ๋“œ ์›Œํฌํ”Œ๋กœ์šฐ -- [์‹œ์ž‘ํ•˜๊ธฐ](../Getting-Started/quick-start.md) - ๋ชจ๋“œ ์‚ฌ์šฉ ํŒจํ„ด - -**๐Ÿ”ง ์ „๋ฌธ๊ฐ€** -- [๊ธฐ์ˆ  ์•„ํ‚คํ…์ฒ˜](../Developer-Guide/technical-architecture.md) - ๋ชจ๋“œ ๊ตฌํ˜„ ์„ธ๋ถ€์‚ฌํ•ญ -- [์ฝ”๋“œ ๊ธฐ์—ฌ](../Developer-Guide/contributing-code.md) - ๋ชจ๋“œ ๊ธฐ๋Šฅ ํ™•์žฅ - -**๋ชจ๋“œ๋ณ„ ๊ฐ€์ด๋“œ:** -- **๋ธŒ๋ ˆ์ธ์Šคํ† ๋ฐ**: [์š”๊ตฌ์‚ฌํ•ญ ๋ฐœ๊ฒฌ ํŒจํ„ด](../Reference/examples-cookbook.md#requirements) -- **์ž‘์—… ๊ด€๋ฆฌ**: [์„ธ์…˜ ๊ด€๋ฆฌ ๊ฐ€์ด๋“œ](session-management.md) -- **์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜**: [MCP ์„œ๋ฒ„ ๊ฐ€์ด๋“œ](mcp-servers.md) -- **ํ† ํฐ ํšจ์œจ์„ฑ**: [๋ช…๋ น์–ด ๊ธฐ๋ณธ์‚ฌํ•ญ](commands.md#token-efficiency) - diff --git a/docs/User-Guide-kr/session-management.md b/docs/User-Guide-kr/session-management.md deleted file mode 100644 index 6ebdb81..0000000 --- a/docs/User-Guide-kr/session-management.md +++ /dev/null @@ -1,311 +0,0 @@ -# ์„ธ์…˜ ๊ด€๋ฆฌ ๊ฐ€์ด๋“œ - -SuperClaude๋Š” Serena MCP ์„œ๋ฒ„๋ฅผ ํ†ตํ•ด ์˜๊ตฌ ์„ธ์…˜ ๊ด€๋ฆฌ๋ฅผ ์ œ๊ณตํ•˜์—ฌ Claude Code ๋Œ€ํ™” ์ „๋ฐ˜์— ๊ฑธ์ณ ์ง„์ •ํ•œ ์ปจํ…์ŠคํŠธ ๋ณด์กด๊ณผ ์žฅ๊ธฐ ํ”„๋กœ์ ํŠธ ์—ฐ์†์„ฑ์„ ๊ฐ€๋Šฅํ•˜๊ฒŒ ํ•ฉ๋‹ˆ๋‹ค. - -## ์˜๊ตฌ ๋ฉ”๋ชจ๋ฆฌ๋ฅผ ์‚ฌ์šฉํ•œ ํ•ต์‹ฌ ์„ธ์…˜ ๋ช…๋ น์–ด - -### `/sc:load` - ์˜๊ตฌ ๋ฉ”๋ชจ๋ฆฌ๋ฅผ ์‚ฌ์šฉํ•œ ์ปจํ…์ŠคํŠธ ๋กœ๋”ฉ -**๋ชฉ์ **: ์ด์ „ ์„ธ์…˜์˜ ํ”„๋กœ์ ํŠธ ์ปจํ…์ŠคํŠธ ๋ฐ ์˜๊ตฌ ๋ฉ”๋ชจ๋ฆฌ๋กœ ์„ธ์…˜ ์ดˆ๊ธฐํ™” -**MCP ํ†ตํ•ฉ**: Serena MCP๊ฐ€ ์ €์žฅ๋œ ํ”„๋กœ์ ํŠธ ๋ฉ”๋ชจ๋ฆฌ๋ฅผ ์ฝ๋„๋ก ํŠธ๋ฆฌ๊ฑฐ -**๊ตฌ๋ฌธ**: `/sc:load [ํ”„๋กœ์ ํŠธ_๊ฒฝ๋กœ]` - -**๋ฐœ์ƒํ•˜๋Š” ์ผ**: -- Serena MCP๊ฐ€ ์ด์ „ ์„ธ์…˜์˜ ์˜๊ตฌ ๋ฉ”๋ชจ๋ฆฌ ํŒŒ์ผ ์ฝ๊ธฐ -- ์ €์žฅ๋œ ๋ฉ”๋ชจ๋ฆฌ์—์„œ ํ”„๋กœ์ ํŠธ ์ปจํ…์ŠคํŠธ ๋ณต์› -- ์ด์ „ ๊ฒฐ์ •, ํŒจํ„ด, ์ง„ํ–‰ ์ƒํ™ฉ ๋กœ๋“œ -- ๊ณผ๊ฑฐ ์ปจํ…์ŠคํŠธ๋กœ ์„ธ์…˜ ์ƒํƒœ ์ดˆ๊ธฐํ™” - -**์‚ฌ์šฉ ์‚ฌ๋ก€**: -```bash -# ์˜๊ตฌ ๋ฉ”๋ชจ๋ฆฌ์—์„œ ๊ธฐ์กด ํ”„๋กœ์ ํŠธ ์ปจํ…์ŠคํŠธ ๋กœ๋“œ -/sc:load src/ - -# ์ „์ฒด ๊ธฐ๋ก๊ณผ ํ•จ๊ป˜ ํŠน์ • ํ”„๋กœ์ ํŠธ ์ž‘์—… ์žฌ๊ฐœ -/sc:load "authentication-system" - -# ์ฝ”๋“œ๋ฒ ์ด์Šค ๋ถ„์„ ๋ฐ ์ด์ „ ํ†ต์ฐฐ๋ ฅ์œผ๋กœ ์ดˆ๊ธฐํ™” -/sc:load . --analyze -``` - -### `/sc:save` - ๋ฉ”๋ชจ๋ฆฌ์— ์„ธ์…˜ ์ง€์†์„ฑ -**๋ชฉ์ **: ํ˜„์žฌ ์„ธ์…˜ ์ƒํƒœ ๋ฐ ๊ฒฐ์ •์„ ์˜๊ตฌ ๋ฉ”๋ชจ๋ฆฌ์— ์ €์žฅ -**MCP ํ†ตํ•ฉ**: Serena MCP๊ฐ€ ๋ฉ”๋ชจ๋ฆฌ ํŒŒ์ผ์„ ์ž‘์„ฑํ•˜๋„๋ก ํŠธ๋ฆฌ๊ฑฐ -**๊ตฌ๋ฌธ**: `/sc:save "์„ธ์…˜_์„ค๋ช…"` - -**๋ฐœ์ƒํ•˜๋Š” ์ผ**: -- ํ˜„์žฌ ์ปจํ…์ŠคํŠธ ๋ฐ ๊ฒฐ์ •์ด Serena ๋ฉ”๋ชจ๋ฆฌ์— ์ž‘์„ฑ๋จ -- ํ”„๋กœ์ ํŠธ ์ƒํƒœ ๋ฐ ์ง„ํ–‰ ์ƒํ™ฉ์ด ๋Œ€ํ™” ์ „๋ฐ˜์— ๊ฑธ์ณ ์ง€์†๋จ -- ์ฃผ์š” ํ†ต์ฐฐ๋ ฅ ๋ฐ ํŒจํ„ด์ด ํ–ฅํ›„ ์„ธ์…˜์„ ์œ„ํ•ด ์ €์žฅ๋จ -- ๊ฒ€์ƒ‰์„ ์œ„ํ•œ ํƒ€์ž„์Šคํƒฌํ”„์™€ ํ•จ๊ป˜ ์„ธ์…˜ ์š”์•ฝ ์ƒ์„ฑ - -**์‚ฌ์šฉ ์‚ฌ๋ก€**: -```bash -# ํ–ฅํ›„ ์ฐธ์กฐ๋ฅผ ์œ„ํ•ด ์™„๋ฃŒ๋œ ๊ธฐ๋Šฅ ์ž‘์—… ์ €์žฅ -/sc:save "JWT๋กœ ์‚ฌ์šฉ์ž ์ธ์ฆ ๊ตฌํ˜„๋จ" - -# ๋ณต์žกํ•œ ์ž‘์—… ์ค‘ ์ฒดํฌํฌ์ธํŠธ -/sc:save "API ์„ค๊ณ„ ๋‹จ๊ณ„ ์™„๋ฃŒ, ๊ตฌํ˜„ ์ค€๋น„" - -# ์•„ํ‚คํ…์ฒ˜ ๊ฒฐ์ •์„ ์˜๊ตฌ์ ์œผ๋กœ ์ €์žฅ -/sc:save "๋งˆ์ดํฌ๋กœ์„œ๋น„์Šค ์•„ํ‚คํ…์ฒ˜ ๊ฒฐ์ •, ์„œ๋น„์Šค ๊ฒฝ๊ณ„ ์ •์˜๋จ" -``` - -### `/sc:reflect` - ๋ฉ”๋ชจ๋ฆฌ ์ปจํ…์ŠคํŠธ๋ฅผ ์‚ฌ์šฉํ•œ ์ง„ํ–‰ ์ƒํ™ฉ ํ‰๊ฐ€ -**๋ชฉ์ **: ์ €์žฅ๋œ ๋ฉ”๋ชจ๋ฆฌ์— ๋Œ€ํ•œ ํ˜„์žฌ ์ง„ํ–‰ ์ƒํ™ฉ ๋ถ„์„ ๋ฐ ์„ธ์…˜ ์™„์ „์„ฑ ๊ฒ€์ฆ -**MCP ํ†ตํ•ฉ**: Serena MCP๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ์ €์žฅ๋œ ๋ฉ”๋ชจ๋ฆฌ์— ๋Œ€ํ•œ ํ˜„์žฌ ์ƒํƒœ ๋น„๊ต -**๊ตฌ๋ฌธ**: `/sc:reflect [--scope project|session]` - -**๋ฐœ์ƒํ•˜๋Š” ์ผ**: -- Serena MCP๊ฐ€ ์ด์ „ ๋ฉ”๋ชจ๋ฆฌ ๋ฐ ํ˜„์žฌ ์ปจํ…์ŠคํŠธ ์ฝ๊ธฐ -- ์ €์žฅ๋œ ๋ชฉํ‘œ ๋ฐ ๋งˆ์ผ์Šคํ†ค์— ๋Œ€ํ•œ ์ง„ํ–‰ ์ƒํ™ฉ ํ‰๊ฐ€ -- ๊ณผ๊ฑฐ ์ปจํ…์ŠคํŠธ๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ๊ฒฉ์ฐจ ๋ฐ ๋‹ค์Œ ๋‹จ๊ณ„ ์‹๋ณ„ -- ํ”„๋กœ์ ํŠธ ๋ฉ”๋ชจ๋ฆฌ์— ๋Œ€ํ•œ ์„ธ์…˜ ์™„์ „์„ฑ ๊ฒ€์ฆ - -**์‚ฌ์šฉ ์‚ฌ๋ก€**: -```bash -# ์ €์žฅ๋œ ๋งˆ์ผ์Šคํ†ค์— ๋Œ€ํ•œ ํ”„๋กœ์ ํŠธ ์ง„ํ–‰ ์ƒํ™ฉ ํ‰๊ฐ€ -/sc:reflect --scope project - -# ํ˜„์žฌ ์„ธ์…˜ ์™„์ „์„ฑ ๊ฒ€์ฆ -/sc:reflect - -# ๋ฉ”๋ชจ๋ฆฌ๋ฅผ ๊ธฐ๋ฐ˜์œผ๋กœ ๋‹ค์Œ ๋‹จ๊ณ„๋กœ ์ด๋™ํ•  ์ค€๋น„๊ฐ€ ๋˜์—ˆ๋Š”์ง€ ํ™•์ธ -/sc:reflect --scope session -``` - -## ์˜๊ตฌ ๋ฉ”๋ชจ๋ฆฌ ์•„ํ‚คํ…์ฒ˜ - -### Serena MCP๊ฐ€ ์ง„์ •ํ•œ ์ง€์†์„ฑ์„ ๊ฐ€๋Šฅํ•˜๊ฒŒ ํ•˜๋Š” ๋ฐฉ๋ฒ• - -**๋ฉ”๋ชจ๋ฆฌ ์ €์žฅ**: -- ๊ตฌ์กฐํ™”๋œ ๋ฉ”๋ชจ๋ฆฌ ํŒŒ์ผ๋กœ ์ €์žฅ๋œ ์„ธ์…˜ ์ปจํ…์ŠคํŠธ -- ์˜๊ตฌ์ ์œผ๋กœ ๋ณด์กด๋œ ํ”„๋กœ์ ํŠธ ๊ฒฐ์ • ๋ฐ ์•„ํ‚คํ…์ฒ˜ ํŒจํ„ด -- ๋Œ€ํ™” ์ „๋ฐ˜์— ๊ฑธ์ณ ์œ ์ง€๋˜๋Š” ์ฝ”๋“œ ๋ถ„์„ ๊ฒฐ๊ณผ ๋ฐ ํ†ต์ฐฐ๋ ฅ -- ์žฅ๊ธฐ์ ์œผ๋กœ ์œ ์ง€๋˜๋Š” ์ง„ํ–‰ ์ƒํ™ฉ ์ถ”์  ๋ฐ ๋งˆ์ผ์Šคํ†ค ๋ฐ์ดํ„ฐ - -**๊ต์ฐจ ์„ธ์…˜ ์—ฐ์†์„ฑ**: -- ์ƒˆ ๋Œ€ํ™”์—์„œ ์ž๋™์œผ๋กœ ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ ์ด์ „ ์„ธ์…˜ ์ปจํ…์ŠคํŠธ -- ๋Œ€ํ™” ์ „๋ฐ˜์— ๊ฑธ์ณ ๋ณด์กด๋˜๊ณ  ์•ก์„ธ์Šค ๊ฐ€๋Šฅํ•œ ๊ฒฐ์ • ๋ฐ ๊ทผ๊ฑฐ -- ๊ณผ๊ฑฐ ํŒจํ„ด ๋ฐ ์†”๋ฃจ์…˜์œผ๋กœ๋ถ€ํ„ฐ์˜ ํ•™์Šต ์œ ์ง€ -- ๋ฌด๊ธฐํ•œ ์œ ์ง€๋˜๋Š” ์ผ๊ด€๋œ ํ”„๋กœ์ ํŠธ ์ดํ•ด - -**๋ฉ”๋ชจ๋ฆฌ ์œ ํ˜•**: -- **ํ”„๋กœ์ ํŠธ ๋ฉ”๋ชจ๋ฆฌ**: ์žฅ๊ธฐ ํ”„๋กœ์ ํŠธ ์ปจํ…์ŠคํŠธ ๋ฐ ์•„ํ‚คํ…์ฒ˜ -- **์„ธ์…˜ ๋ฉ”๋ชจ๋ฆฌ**: ํŠน์ • ๋Œ€ํ™” ๊ฒฐ๊ณผ ๋ฐ ๊ฒฐ์ • -- **ํŒจํ„ด ๋ฉ”๋ชจ๋ฆฌ**: ์žฌ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ ์†”๋ฃจ์…˜ ๋ฐ ์•„ํ‚คํ…์ฒ˜ ํŒจํ„ด -- **์ง„ํ–‰ ๋ฉ”๋ชจ๋ฆฌ**: ๋งˆ์ผ์Šคํ†ค ์ถ”์  ๋ฐ ์™„๋ฃŒ ์ƒํƒœ - -## ์ง€์†์„ฑ์„ ๊ฐ–์ถ˜ ์„ธ์…˜ ๋ผ์ดํ”„์‚ฌ์ดํด ํŒจํ„ด - -### ์ƒˆ ํ”„๋กœ์ ํŠธ ์ดˆ๊ธฐํ™” -```bash -# 1. ์ƒˆ ํ”„๋กœ์ ํŠธ ์‹œ์ž‘ -/sc:brainstorm "์ „์ž์ƒ๊ฑฐ๋ž˜ ํ”Œ๋žซํผ ์š”๊ตฌ์‚ฌํ•ญ" - -# 2. ์ดˆ๊ธฐ ๊ฒฐ์ •์„ ์˜๊ตฌ ๋ฉ”๋ชจ๋ฆฌ์— ์ €์žฅ -/sc:save "ํ”„๋กœ์ ํŠธ ๋ฒ”์œ„ ๋ฐ ์š”๊ตฌ์‚ฌํ•ญ ์ •์˜๋จ" - -# 3. ๊ตฌํ˜„ ๊ณ„ํš ์‹œ์ž‘ -/sc:workflow "์‚ฌ์šฉ์ž ์ธ์ฆ ์‹œ์Šคํ…œ" - -# 4. ์•„ํ‚คํ…์ฒ˜ ๊ฒฐ์ •์„ ์˜๊ตฌ์ ์œผ๋กœ ์ €์žฅ -/sc:save "์ธ์ฆ ์•„ํ‚คํ…์ฒ˜: JWT + ๋ฆฌํ”„๋ ˆ์‹œ ํ† ํฐ + ์†๋„ ์ œํ•œ" -``` - -### ๊ธฐ์กด ์ž‘์—… ์žฌ๊ฐœ (๊ต์ฐจ ๋Œ€ํ™”) -```bash -# 1. ์˜๊ตฌ ๋ฉ”๋ชจ๋ฆฌ์—์„œ ์ด์ „ ์ปจํ…์ŠคํŠธ ๋กœ๋“œ -/sc:load "e-commerce-project" - -# 2. ์ €์žฅ๋œ ์ง„ํ–‰ ์ƒํ™ฉ์— ๋Œ€ํ•œ ํ˜„์žฌ ์ƒํƒœ ํ‰๊ฐ€ -/sc:reflect --scope project - -# 3. ์ €์žฅ๋œ ์ปจํ…์ŠคํŠธ๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ๋‹ค์Œ ๋‹จ๊ณ„ ๊ณ„์† -/sc:implement "๊ฒฐ์ œ ์ฒ˜๋ฆฌ ํ†ตํ•ฉ" - -# 4. ์ง„ํ–‰ ์ƒํ™ฉ ์ฒดํฌํฌ์ธํŠธ๋ฅผ ๋ฉ”๋ชจ๋ฆฌ์— ์ €์žฅ -/sc:save "Stripe API์™€ ๊ฒฐ์ œ ์‹œ์Šคํ…œ ํ†ตํ•ฉ๋จ" -``` - -### ์žฅ๊ธฐ ํ”„๋กœ์ ํŠธ ๊ด€๋ฆฌ -```bash -# ์ง€์†์„ฑ์„ ๊ฐ–์ถ˜ ์ฃผ๊ฐ„ ์ฒดํฌํฌ์ธํŠธ ํŒจํ„ด -/sc:load project-name -/sc:reflect --scope project -# ... ๊ธฐ๋Šฅ ์ž‘์—… ... -/sc:save "N์ฃผ์ฐจ ์ง„ํ–‰: ๊ธฐ๋Šฅ X, Y, Z ์™„๋ฃŒ" - -# ๋ฉ”๋ชจ๋ฆฌ๋ฅผ ์‚ฌ์šฉํ•œ ๋‹จ๊ณ„ ์™„๋ฃŒ ํŒจํ„ด -/sc:reflect --scope project -/sc:save "1๋‹จ๊ณ„ ์™„๋ฃŒ: ํ•ต์‹ฌ ์ธ์ฆ ๋ฐ ์‚ฌ์šฉ์ž ๊ด€๋ฆฌ" -/sc:workflow "2๋‹จ๊ณ„: ๊ฒฐ์ œ ๋ฐ ์ฃผ๋ฌธ ์ฒ˜๋ฆฌ" -``` - -## ๊ต์ฐจ ๋Œ€ํ™” ์—ฐ์†์„ฑ - -### ์ง€์†์„ฑ์„ ๊ฐ–์ถ˜ ์ƒˆ ๋Œ€ํ™” ์‹œ์ž‘ - -์ƒˆ Claude Code ๋Œ€ํ™”๋ฅผ ์‹œ์ž‘ํ•  ๋•Œ ์˜๊ตฌ ๋ฉ”๋ชจ๋ฆฌ ์‹œ์Šคํ…œ์ด ๋‹ค์Œ์„ ํ—ˆ์šฉํ•ฉ๋‹ˆ๋‹ค: - -1. **์ž๋™ ์ปจํ…์ŠคํŠธ ๋ณต์›** - ```bash - /sc:load project-name - # ๋ชจ๋“  ์ด์ „ ์ปจํ…์ŠคํŠธ, ๊ฒฐ์ •, ์ง„ํ–‰ ์ƒํ™ฉ์„ ์ž๋™์œผ๋กœ ๋ณต์› - ``` - -2. **์ง„ํ–‰ ๊ณ„์†** - - ์ด์ „ ์„ธ์…˜ ๊ฒฐ์ •์„ ์ฆ‰์‹œ ์‚ฌ์šฉ ๊ฐ€๋Šฅ - - ์•„ํ‚คํ…์ฒ˜ ํŒจํ„ด ๋ฐ ์ฝ”๋“œ ํ†ต์ฐฐ๋ ฅ ๋ณด์กด - - ํ”„๋กœ์ ํŠธ ๊ธฐ๋ก ๋ฐ ๊ทผ๊ฑฐ ์œ ์ง€ - -3. **์ง€๋Šฅํ˜• ์ปจํ…์ŠคํŠธ ๊ตฌ์ถ•** - - Serena MCP๊ฐ€ ํ˜„์žฌ ์ž‘์—…์— ๊ธฐ๋ฐ˜ํ•˜์—ฌ ๊ด€๋ จ ๋ฉ”๋ชจ๋ฆฌ ์ œ๊ณต - - ๊ณผ๊ฑฐ ์†”๋ฃจ์…˜ ๋ฐ ํŒจํ„ด์ด ์ƒˆ ๊ตฌํ˜„ ์ •๋ณด ์ œ๊ณต - - ํ”„๋กœ์ ํŠธ ์ง„ํ™” ์ถ”์  ๋ฐ ์ดํ•ด - -### ๋ฉ”๋ชจ๋ฆฌ ์ตœ์ ํ™” - -**ํšจ๊ณผ์ ์ธ ๋ฉ”๋ชจ๋ฆฌ ์‚ฌ์šฉ**: -- ์„ค๋ช…์ ์ด๊ณ  ๊ฒ€์ƒ‰ ๊ฐ€๋Šฅํ•œ ๋ฉ”๋ชจ๋ฆฌ ์ด๋ฆ„ ์‚ฌ์šฉ -- ํ”„๋กœ์ ํŠธ ๋‹จ๊ณ„ ๋ฐ ํƒ€์ž„์Šคํƒฌํ”„ ์ปจํ…์ŠคํŠธ ํฌํ•จ -- ํŠน์ • ๊ธฐ๋Šฅ ๋˜๋Š” ์•„ํ‚คํ…์ฒ˜ ๊ฒฐ์ • ์ฐธ์กฐ -- ํ–ฅํ›„ ๊ฒ€์ƒ‰์„ ์ง๊ด€์ ์œผ๋กœ ๋งŒ๋“ค๊ธฐ - -**๋ฉ”๋ชจ๋ฆฌ ์ฝ˜ํ…์ธ  ์ „๋žต**: -- ๊ฒฐ๊ณผ๋ฟ๋งŒ ์•„๋‹ˆ๋ผ ๊ฒฐ์ • ๋ฐ ๊ทผ๊ฑฐ ์ €์žฅ -- ๊ณ ๋ ค๋œ ๋Œ€์•ˆ ์ ‘๊ทผ๋ฒ• ํฌํ•จ -- ํ†ตํ•ฉ ํŒจํ„ด ๋ฐ ์ข…์†์„ฑ ๋ฌธ์„œํ™” -- ํ–ฅํ›„ ์ฐธ์กฐ๋ฅผ ์œ„ํ•œ ํ•™์Šต ๋ฐ ํ†ต์ฐฐ๋ ฅ ๋ณด์กด - -**๋ฉ”๋ชจ๋ฆฌ ๋ผ์ดํ”„์‚ฌ์ดํด ๊ด€๋ฆฌ**: -- ์˜ค๋ž˜๋œ ๋ฉ”๋ชจ๋ฆฌ์˜ ์ •๊ธฐ์ ์ธ ์ •๋ฆฌ -- ๊ด€๋ จ ์„ธ์…˜ ๋ฉ”๋ชจ๋ฆฌ ํ†ตํ•ฉ -- ์™„๋ฃŒ๋œ ํ”„๋กœ์ ํŠธ ๋‹จ๊ณ„ ์•„์นด์ด๋น™ -- ์“ธ๋ชจ์—†๋Š” ์•„ํ‚คํ…์ฒ˜ ๊ฒฐ์ • ์ •๋ฆฌ - -## ์˜๊ตฌ ์„ธ์…˜ ๋ชจ๋ฒ” ์‚ฌ๋ก€ - -### ์„ธ์…˜ ์‹œ์ž‘ ํ”„๋กœํ† ์ฝœ -1. ๊ธฐ์กด ํ”„๋กœ์ ํŠธ์˜ ๊ฒฝ์šฐ ํ•ญ์ƒ `/sc:load`๋กœ ์‹œ์ž‘ -2. `/sc:reflect`๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ๋ฉ”๋ชจ๋ฆฌ์—์„œ ํ˜„์žฌ ์ƒํƒœ ์ดํ•ด -3. ์˜๊ตฌ ์ปจํ…์ŠคํŠธ ๋ฐ ์ €์žฅ๋œ ํŒจํ„ด์„ ๊ธฐ๋ฐ˜์œผ๋กœ ์ž‘์—… ๊ณ„ํš -4. ์ด์ „ ๊ฒฐ์ • ๋ฐ ์•„ํ‚คํ…์ฒ˜ ์„ ํƒ ๊ธฐ๋ฐ˜ ๊ตฌ์ถ• - -### ์„ธ์…˜ ์ข…๋ฃŒ ํ”„๋กœํ† ์ฝœ -1. `/sc:reflect`๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ์ €์žฅ๋œ ๋ชฉํ‘œ์— ๋Œ€ํ•œ ์™„์ „์„ฑ ํ‰๊ฐ€ -2. ํ–ฅํ›„ ์„ธ์…˜์„ ์œ„ํ•ด `/sc:save`๋กœ ์ฃผ์š” ๊ฒฐ์ • ์ €์žฅ -3. ๋ฉ”๋ชจ๋ฆฌ์— ๋‹ค์Œ ๋‹จ๊ณ„ ๋ฐ ๋ฏธํ•ด๊ฒฐ ์งˆ๋ฌธ ๋ฌธ์„œํ™” -4. ์›ํ™œํ•œ ํ–ฅํ›„ ๊ณ„์†์„ ์œ„ํ•œ ์ปจํ…์ŠคํŠธ ๋ณด์กด - -### ๋ฉ”๋ชจ๋ฆฌ ํ’ˆ์งˆ ์œ ์ง€ -- ์‰ฌ์šด ๊ฒ€์ƒ‰์„ ์œ„ํ•ด ๋ช…ํ™•ํ•˜๊ณ  ์„ค๋ช…์ ์ธ ๋ฉ”๋ชจ๋ฆฌ ์ด๋ฆ„ ์‚ฌ์šฉ -- ๊ฒฐ์ • ๋ฐ ๋Œ€์•ˆ ์ ‘๊ทผ๋ฒ•์— ๋Œ€ํ•œ ์ปจํ…์ŠคํŠธ ํฌํ•จ -- ํŠน์ • ์ฝ”๋“œ ์œ„์น˜ ๋ฐ ํŒจํ„ด ์ฐธ์กฐ -- ์„ธ์…˜ ์ „๋ฐ˜์— ๊ฑธ์ณ ๋ฉ”๋ชจ๋ฆฌ ๊ตฌ์กฐ์˜ ์ผ๊ด€์„ฑ ์œ ์ง€ - -## ๋‹ค๋ฅธ SuperClaude ๊ธฐ๋Šฅ๊ณผ์˜ ํ†ตํ•ฉ - -### MCP ์„œ๋ฒ„ ์กฐ์ • -- **Serena MCP**: ์˜๊ตฌ ๋ฉ”๋ชจ๋ฆฌ ์ธํ”„๋ผ ์ œ๊ณต -- **Sequential MCP**: ํ–ฅ์ƒ๋œ ๋ณต์žกํ•œ ๋ถ„์„์„ ์œ„ํ•ด ์ €์žฅ๋œ ๋ฉ”๋ชจ๋ฆฌ ์‚ฌ์šฉ -- **Context7 MCP**: ์ €์žฅ๋œ ํŒจํ„ด ๋ฐ ๋ฌธ์„œํ™” ์ ‘๊ทผ๋ฒ• ์ฐธ์กฐ -- **Morphllm MCP**: ์ €์žฅ๋œ ๋ฆฌํŒฉํ† ๋ง ํŒจํ„ด์„ ์ผ๊ด€๋˜๊ฒŒ ์ ์šฉ - -### ๋ฉ”๋ชจ๋ฆฌ๋ฅผ ์‚ฌ์šฉํ•œ ์—์ด์ „ํŠธ ํ˜‘์—… -- ์—์ด์ „ํŠธ๊ฐ€ ํ–ฅ์ƒ๋œ ์ปจํ…์ŠคํŠธ๋ฅผ ์œ„ํ•ด ์˜๊ตฌ ๋ฉ”๋ชจ๋ฆฌ ์•ก์„ธ์Šค -- ์ด์ „ ์ „๋ฌธ๊ฐ€ ๊ฒฐ์ •์ด ๋ณด์กด๋˜๊ณ  ์ฐธ์กฐ๋จ -- ๊ณต์œ  ๋ฉ”๋ชจ๋ฆฌ๋ฅผ ํ†ตํ•œ ๊ต์ฐจ ์„ธ์…˜ ์—์ด์ „ํŠธ ์กฐ์ • -- ํ”„๋กœ์ ํŠธ ๊ธฐ๋ก์„ ๊ธฐ๋ฐ˜์œผ๋กœ ํ•œ ์ผ๊ด€๋œ ์ „๋ฌธ๊ฐ€ ๊ถŒ์žฅ์‚ฌํ•ญ - -### ์ง€์†์„ฑ์„ ๊ฐ–์ถ˜ ๋ช…๋ น์–ด ํ†ตํ•ฉ -- ๋ชจ๋“  `/sc:` ๋ช…๋ น์–ด๊ฐ€ ์˜๊ตฌ ์ปจํ…์ŠคํŠธ๋ฅผ ์ฐธ์กฐํ•˜๊ณ  ๊ตฌ์ถ• ๊ฐ€๋Šฅ -- ์ด์ „ ๋ช…๋ น์–ด ์ถœ๋ ฅ ๋ฐ ๊ฒฐ์ •์ด ์„ธ์…˜ ์ „๋ฐ˜์— ๊ฑธ์ณ ์‚ฌ์šฉ ๊ฐ€๋Šฅ -- ์›Œํฌํ”Œ๋กœ์šฐ ํŒจํ„ด์ด ์ €์žฅ๋˜๊ณ  ์žฌ์‚ฌ์šฉ ๊ฐ€๋Šฅ -- ๊ตฌํ˜„ ๊ธฐ๋ก์ด ํ–ฅํ›„ ๋ช…๋ น์–ด ๊ฒฐ์ • ์•ˆ๋‚ด - -## ์˜๊ตฌ ์„ธ์…˜ ๋ฌธ์ œ ํ•ด๊ฒฐ - -### ์ผ๋ฐ˜์ ์ธ ๋ฌธ์ œ - -**๋ฉ”๋ชจ๋ฆฌ ๋กœ๋”ฉ ์•ˆ ๋จ**: -- Serena MCP๊ฐ€ ์˜ฌ๋ฐ”๋ฅด๊ฒŒ ๊ตฌ์„ฑ๋˜๊ณ  ์‹คํ–‰ ์ค‘์ธ์ง€ ํ™•์ธ -- ๋ฉ”๋ชจ๋ฆฌ ํŒŒ์ผ ๊ถŒํ•œ ๋ฐ ์ ‘๊ทผ์„ฑ ํ™•์ธ -- ์ผ๊ด€๋œ ํ”„๋กœ์ ํŠธ ๋ช…๋ช… ๊ทœ์น™ ๋ณด์žฅ -- ๋ฉ”๋ชจ๋ฆฌ ํŒŒ์ผ ๋ฌด๊ฒฐ์„ฑ ๋ฐ ํ˜•์‹ ๊ฒ€์ฆ - -**์„ธ์…˜ ๊ฐ„ ์ปจํ…์ŠคํŠธ ์†์‹ค**: -- ์„ธ์…˜์„ ์ข…๋ฃŒํ•˜๊ธฐ ์ „์— ํ•ญ์ƒ `/sc:save` ์‚ฌ์šฉ -- ์‰ฌ์šด ๊ฒ€์ƒ‰์„ ์œ„ํ•ด ์„ค๋ช…์ ์ธ ๋ฉ”๋ชจ๋ฆฌ ์ด๋ฆ„ ์‚ฌ์šฉ -- ๋ฉ”๋ชจ๋ฆฌ ์™„์ „์„ฑ์„ ๊ฒ€์ฆํ•˜๊ธฐ ์œ„ํ•œ ์ •๊ธฐ์ ์ธ `/sc:reflect` -- ์ค‘์š”ํ•œ ๋ฉ”๋ชจ๋ฆฌ ํŒŒ์ผ์„ ์ฃผ๊ธฐ์ ์œผ๋กœ ๋ฐฑ์—… - -**๋ฉ”๋ชจ๋ฆฌ ์ถฉ๋Œ**: -- ๋ฒ„์ „ ์ œ์–ด๋ฅผ ์œ„ํ•ด ํƒ€์ž„์Šคํƒฌํ”„๊ฐ€ ์žˆ๋Š” ๋ฉ”๋ชจ๋ฆฌ ์ด๋ฆ„ ์‚ฌ์šฉ -- ์˜ค๋ž˜๋œ ๋ฉ”๋ชจ๋ฆฌ์˜ ์ •๊ธฐ์ ์ธ ์ •๋ฆฌ -- ํ”„๋กœ์ ํŠธ ๋ฐ ์„ธ์…˜ ๋ฉ”๋ชจ๋ฆฌ ๊ฐ„์˜ ๋ช…ํ™•ํ•œ ๋ถ„๋ฆฌ -- ์„ธ์…˜ ์ „๋ฐ˜์— ๊ฑธ์ณ ์ผ๊ด€๋œ ๋ฉ”๋ชจ๋ฆฌ ๋ช…๋ช… ๊ทœ์น™ - -### ๋น ๋ฅธ ์ˆ˜์ • - -**์„ธ์…˜ ์ƒํƒœ ์žฌ์„ค์ •**: -```bash -/sc:load --fresh # ์ด์ „ ์ปจํ…์ŠคํŠธ ์—†์ด ์‹œ์ž‘ -/sc:reflect # ํ˜„์žฌ ์ƒํƒœ ํ‰๊ฐ€ -``` - -**๋ฉ”๋ชจ๋ฆฌ ์ •๋ฆฌ**: -```bash -/sc:reflect --cleanup # ์˜ค๋ž˜๋œ ๋ฉ”๋ชจ๋ฆฌ ์ œ๊ฑฐ -/sc:save --consolidate # ๊ด€๋ จ ๋ฉ”๋ชจ๋ฆฌ ๋ณ‘ํ•ฉ -``` - -**์ปจํ…์ŠคํŠธ ๋ณต๊ตฌ**: -```bash -/sc:load --recent # ์ตœ๊ทผ ๋ฉ”๋ชจ๋ฆฌ ๋กœ๋“œ -/sc:reflect --repair # ์ปจํ…์ŠคํŠธ ๊ฒฉ์ฐจ ์‹๋ณ„ ๋ฐ ์ˆ˜์ • -``` - -## ๊ณ ๊ธ‰ ์˜๊ตฌ ์„ธ์…˜ ํŒจํ„ด - -### ๋‹ค๋‹จ๊ณ„ ํ”„๋กœ์ ํŠธ -- ์กฐ์ง์„ ์œ„ํ•œ ๋‹จ๊ณ„๋ณ„ ๋ฉ”๋ชจ๋ฆฌ ๋ช…๋ช… ์‚ฌ์šฉ -- ๋‹จ๊ณ„ ์ „๋ฐ˜์— ๊ฑธ์ณ ์•„ํ‚คํ…์ฒ˜ ๊ฒฐ์ • ์—ฐ์†์„ฑ ์œ ์ง€ -- ์˜๊ตฌ ๋ฉ”๋ชจ๋ฆฌ๋ฅผ ํ†ตํ•œ ๊ต์ฐจ ๋‹จ๊ณ„ ์ข…์†์„ฑ ์ถ”์  -- ๊ณผ๊ฑฐ ์ปจํ…์ŠคํŠธ๋ฅผ ์‚ฌ์šฉํ•œ ์ ์ง„์  ๋ณต์žก์„ฑ ๊ด€๋ฆฌ - -### ํŒ€ ํ˜‘์—… -- ๊ณต์œ  ๋ฉ”๋ชจ๋ฆฌ ๊ทœ์น™ ๋ฐ ๋ช…๋ช… ํ‘œ์ค€ -- ํŒ€ ์ปจํ…์ŠคํŠธ๋ฅผ ์œ„ํ•œ ๊ฒฐ์ • ๊ทผ๊ฑฐ ๋ณด์กด -- ๋ชจ๋“  ํŒ€์›์ด ์•ก์„ธ์Šค ๊ฐ€๋Šฅํ•œ ํ†ตํ•ฉ ํŒจํ„ด ๋ฌธ์„œ -- ๋ฉ”๋ชจ๋ฆฌ๋ฅผ ํ†ตํ•œ ์ผ๊ด€๋œ ์ฝ”๋“œ ์Šคํƒ€์ผ ๋ฐ ์•„ํ‚คํ…์ฒ˜ ๊ฐ•์ œ - -### ์žฅ๊ธฐ ์œ ์ง€๋ณด์ˆ˜ -- ์™„๋ฃŒ๋œ ํ”„๋กœ์ ํŠธ๋ฅผ ์œ„ํ•œ ๋ฉ”๋ชจ๋ฆฌ ์•„์นด์ด๋น™ ์ „๋žต -- ๋ˆ„์ ๋œ ๋ฉ”๋ชจ๋ฆฌ๋ฅผ ํ†ตํ•œ ํŒจํ„ด ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ๊ฐœ๋ฐœ -- ์‹œ๊ฐ„์ด ์ง€๋‚จ์— ๋”ฐ๋ผ ๊ตฌ์ถ•๋œ ์žฌ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ ์†”๋ฃจ์…˜ ๋ฌธ์„œ -- ์˜๊ตฌ ๋ฉ”๋ชจ๋ฆฌ ์ถ•์ ์„ ํ†ตํ•œ ์ง€์‹ ๋ฒ ์ด์Šค ๊ตฌ์ถ• - -## ์˜๊ตฌ ์„ธ์…˜ ๊ด€๋ฆฌ์˜ ์ฃผ์š” ์ด์  - -### ํ”„๋กœ์ ํŠธ ์—ฐ์†์„ฑ -- ์—ฌ๋Ÿฌ ๋Œ€ํ™”์— ๊ฑธ์ณ ์›ํ™œํ•œ ์ž‘์—… ๊ณ„์† -- Claude Code ์„ธ์…˜ ๊ฐ„ ์ปจํ…์ŠคํŠธ ์†์‹ค ์—†์Œ -- ๋ณด์กด๋œ ์•„ํ‚คํ…์ฒ˜ ๊ฒฐ์ • ๋ฐ ๊ธฐ์ˆ  ๊ทผ๊ฑฐ -- ์žฅ๊ธฐ ํ”„๋กœ์ ํŠธ ์ง„ํ™” ์ถ”์  - -### ํ–ฅ์ƒ๋œ ์ƒ์‚ฐ์„ฑ -- ํ”„๋กœ์ ํŠธ ์ปจํ…์ŠคํŠธ๋ฅผ ๋‹ค์‹œ ์„ค๋ช…ํ•  ํ•„์š” ๊ฐ์†Œ -- ๊ณ„์† ์ž‘์—…์„ ์œ„ํ•œ ๋” ๋น ๋ฅธ ์‹œ์ž‘ ์‹œ๊ฐ„ -- ์ด์ „ ํ†ต์ฐฐ๋ ฅ ๋ฐ ํŒจํ„ด ๊ธฐ๋ฐ˜ ๊ตฌ์ถ• -- ๋ˆ„์  ํ”„๋กœ์ ํŠธ ์ง€์‹ ์„ฑ์žฅ - -### ํ’ˆ์งˆ ์ผ๊ด€์„ฑ -- ์„ธ์…˜ ์ „๋ฐ˜์— ๊ฑธ์ณ ์ผ๊ด€๋œ ์•„ํ‚คํ…์ฒ˜ ํŒจํ„ด -- ๋ณด์กด๋œ ์ฝ”๋“œ ํ’ˆ์งˆ ๊ฒฐ์ • ๋ฐ ํ‘œ์ค€ -- ์žฌ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ ์†”๋ฃจ์…˜ ๋ฐ ๋ชจ๋ฒ” ์‚ฌ๋ก€ -- ์œ ์ง€๋œ ๊ธฐ์ˆ  ๋ถ€์ฑ„ ์ธ์‹ - ---- - -**ํ•ต์‹ฌ ์š”์ **: Serena MCP๋ฅผ ํ†ตํ•œ ์„ธ์…˜ ๊ด€๋ฆฌ๋Š” SuperClaude๋ฅผ ๋‹จ์ผ ๋Œ€ํ™” ์ง€์›์—์„œ ์˜๊ตฌ ํ”„๋กœ์ ํŠธ ํŒŒํŠธ๋„ˆ์‹ญ์œผ๋กœ ๋ณ€ํ™˜ํ•˜์—ฌ ๋ชจ๋“  ๊ฐœ๋ฐœ ๋‹จ๊ณ„ ๋ฐ Claude Code ๋Œ€ํ™” ์ „๋ฐ˜์— ๊ฑธ์ณ ์ปจํ…์ŠคํŠธ, ๊ฒฐ์ •, ํ•™์Šต์„ ์œ ์ง€ํ•ฉ๋‹ˆ๋‹ค. - diff --git a/docs/User-Guide-zh/agents.md b/docs/User-Guide-zh/agents.md deleted file mode 100644 index cdaa908..0000000 --- a/docs/User-Guide-zh/agents.md +++ /dev/null @@ -1,819 +0,0 @@ -# SuperClaude ๆ™บ่ƒฝไฝ“ๆŒ‡ๅ— ๐Ÿค– - -SuperClaude ๆไพ›ไบ† 14 ไธช้ข†ๅŸŸไธ“ไธšๆ™บ่ƒฝไฝ“๏ผŒClaude Code ๅฏไปฅ่ฐƒ็”จๅฎƒไปฌ่Žทๅพ—ไธ“ไธš็Ÿฅ่ฏ†ใ€‚ - - -## ๐Ÿงช ๆต‹่ฏ•ๆ™บ่ƒฝไฝ“ๆฟ€ๆดป - -ไฝฟ็”จๆœฌๆŒ‡ๅ—ไน‹ๅ‰๏ผŒ่ฏท้ชŒ่ฏๆ™บ่ƒฝไฝ“้€‰ๆ‹ฉๅŠŸ่ƒฝๆ˜ฏๅฆๆญฃๅธธ๏ผš - -```bash -# ๆต‹่ฏ•ๆ‰‹ๅŠจๆ™บ่ƒฝไฝ“่ฐƒ็”จ -@agent-python-expert "explain decorators" -# ๆœŸๆœ›่กŒไธบ๏ผšPython ไธ“ๅฎถๆไพ›่ฏฆ็ป†่งฃ้‡Š - -# ๆต‹่ฏ•ๅฎ‰ๅ…จๆ™บ่ƒฝไฝ“่‡ชๅŠจๆฟ€ๆดป -/sc:implement "JWT authentication" -# ๆœŸๆœ›่กŒไธบ๏ผšๅฎ‰ๅ…จๅทฅ็จ‹ๅธˆๅบ”่‡ชๅŠจๆฟ€ๆดป - -# ๆต‹่ฏ•ๅ‰็ซฏๆ™บ่ƒฝไฝ“่‡ชๅŠจๆฟ€ๆดป -/sc:implement "responsive navigation component" -# ๆœŸๆœ›่กŒไธบ๏ผšๅ‰็ซฏๆžถๆž„ๅธˆ + Magic MCP ๅบ”ๆฟ€ๆดป - -# ๆต‹่ฏ•็ณป็ปŸๅˆ†ๆž -/sc:troubleshoot "slow API performance" -# ๆœŸๆœ›่กŒไธบ๏ผšๆ นๅ› ๅˆ†ๆžๅธˆ + ๆ€ง่ƒฝๅทฅ็จ‹ๅธˆๆฟ€ๆดป - -# ๆต‹่ฏ•ๆ‰‹ๅŠจๅ’Œ่‡ชๅŠจ็ป“ๅˆ -/sc:analyze src/ -@agent-refactoring-expert "suggest improvements" -# ๆœŸๆœ›่กŒไธบ๏ผšๅˆ†ๆžๅŽ่ทŸ้š้‡ๆž„ๅปบ่ฎฎ -``` - -**ๅฆ‚ๆžœๆต‹่ฏ•ๅคฑ่ดฅ**๏ผšๆฃ€ๆŸฅ `~/.claude/agents/` ไธญๆ˜ฏๅฆๅญ˜ๅœจๆ™บ่ƒฝไฝ“ๆ–‡ไปถ๏ผŒๆˆ–้‡ๅฏ Claude Code ไผš่ฏ - -## ๆ ธๅฟƒๆฆ‚ๅฟต - -### ไป€ไนˆๆ˜ฏ SuperClaude ๆ™บ่ƒฝไฝ“๏ผŸ -**ๆ™บ่ƒฝไฝ“**ๆ˜ฏไธ“ไธš็š„ AI ้ข†ๅŸŸไธ“ๅฎถ๏ผŒไปฅไธŠไธ‹ๆ–‡ๆŒ‡ไปค็š„ๅฝขๅผๅฎž็Žฐ๏ผŒ็”จไบŽไฟฎๆ”น Claude Code ็š„่กŒไธบใ€‚ๆฏไธชๆ™บ่ƒฝไฝ“้ƒฝๆ˜ฏ `superclaude/Agents/` ็›ฎๅฝ•ไธญ็ฒพๅฟƒๅˆถไฝœ็š„ `.md` ๆ–‡ไปถ๏ผŒๅŒ…ๅซ้ข†ๅŸŸ็‰นๅฎš็š„ไธ“ไธš็Ÿฅ่ฏ†ใ€่กŒไธบๆจกๅผๅ’Œ้—ฎ้ข˜่งฃๅ†ณๆ–นๆณ•ใ€‚ - -**้‡่ฆๆ็คบ**๏ผšๆ™บ่ƒฝไฝ“ไธๆ˜ฏ็‹ฌ็ซ‹็š„ AI ๆจกๅž‹ๆˆ–่ฝฏไปถ - ๅฎƒไปฌๆ˜ฏ Claude Code ่ฏปๅ–็š„ไธŠไธ‹ๆ–‡้…็ฝฎ๏ผŒ็”จไบŽ้‡‡็”จไธ“้—จ็š„่กŒไธบใ€‚ - -### ไธค็งไฝฟ็”จๆ™บ่ƒฝไฝ“็š„ๆ–นๅผ - -#### 1. ไฝฟ็”จ @agent- ๅ‰็ผ€ๆ‰‹ๅŠจ่ฐƒ็”จ -```bash -# ็›ดๆŽฅ่ฐƒ็”จ็‰นๅฎšๆ™บ่ƒฝไฝ“ -@agent-security "review authentication implementation" -@agent-frontend "design responsive navigation" -@agent-architect "plan microservices migration" -``` - -#### 2. ่‡ชๅŠจๆฟ€ๆดปAuto-Activation๏ผˆ่กŒไธบ่ทฏ็”ฑ๏ผ‰ -"่‡ชๅŠจๆฟ€ๆดป"ๆ„ๅ‘ณ็€ Claude Code ่ฏปๅ–่กŒไธบๆŒ‡ไปค๏ผŒๆ นๆฎๆ‚จ่ฏทๆฑ‚ไธญ็š„ๅ…ณ้”ฎ่ฏๅ’Œๆจกๅผๆฅ่ฐƒ็”จ็›ธๅบ”็š„ไธŠไธ‹ๆ–‡ใ€‚SuperClaude ๆไพ›่กŒไธบๆŒ‡ๅฏผๅŽŸๅˆ™๏ผŒClaude ้ตๅพช่ฟ™ไบ›ๅŽŸๅˆ™่ทฏ็”ฑๅˆฐๆœ€ๅˆ้€‚็š„ไธ“ไธšไบบๅ‘˜ใ€‚ - -> **๐Ÿ“ ๆ™บ่ƒฝไฝ“"่‡ชๅŠจๆฟ€ๆดป"ๅทฅไฝœๅŽŸ็†**: -> ๆ™บ่ƒฝไฝ“ๆฟ€ๆดปๅนถ้ž่‡ชๅŠจ็š„็ณป็ปŸ้€ป่พ‘โ€”โ€”ๅฎƒๆ˜ฏไธŠไธ‹ๆ–‡ๆ–‡ไปถไธญ็š„่กŒไธบๆŒ‡ไปคใ€‚ -> ๅฝ“ๆ–‡ๆกฃ่ฏดๆ™บ่ƒฝไฝ“"่‡ชๅŠจๆฟ€ๆดป"ๆ—ถ๏ผŒๆ„ๅ‘ณ็€ Claude Code ่ฏปๅ–ๆŒ‡ไปค๏ผŒๆ นๆฎๆ‚จ่ฏทๆฑ‚ไธญ็š„ๅ…ณ้”ฎ่ฏๅ’Œๆจกๅผ -> ่ฐƒ็”จ็‰นๅฎš็š„้ข†ๅŸŸไธ“ไธš็Ÿฅ่ฏ†ใ€‚่ฟ™ๅˆ›้€ ไบ†ๆ™บ่ƒฝ่ทฏ็”ฑ็š„ไฝ“้ชŒ๏ผŒๅŒๆ—ถไฟๆŒๅบ•ๅฑ‚ๆœบๅˆถ็š„้€ๆ˜Žๆ€งใ€‚ - -```bash -# ่ฟ™ไบ›ๅ‘ฝไปค่‡ชๅŠจๆฟ€ๆดป็›ธๅ…ณๆ™บ่ƒฝไฝ“ -/sc:implement "JWT authentication" # โ†’ security-engineer ่‡ชๅŠจๆฟ€ๆดป -/sc:design "React dashboard" # โ†’ frontend-architect ่‡ชๅŠจๆฟ€ๆดป -/sc:troubleshoot "memory leak" # โ†’ performance-engineer ่‡ชๅŠจๆฟ€ๆดป -``` - -**MCP ๆœๅŠกๅ™จ** ้€š่ฟ‡ไธ“ไธšๅทฅๅ…ทๆไพ›ๅขžๅผบๅŠŸ่ƒฝ๏ผŒๅฆ‚ Context7๏ผˆๆ–‡ๆกฃ๏ผ‰ใ€Sequential๏ผˆๅˆ†ๆž๏ผ‰ใ€Magic๏ผˆUI๏ผ‰ใ€Playwright๏ผˆๆต‹่ฏ•๏ผ‰ๅ’Œ Morphllm๏ผˆไปฃ็ ่ฝฌๆข๏ผ‰ใ€‚ - -**้ข†ๅŸŸไธ“ๅฎถ** ไธ“ๆณจไบŽ็‹ญ็ช„็š„ไธ“ไธš้ข†ๅŸŸ๏ผŒๆไพ›ๆฏ”้€š็”จๆ–นๆณ•ๆ›ดๆทฑๅ…ฅใ€ๆ›ดๅ‡†็กฎ็š„่งฃๅ†ณๆ–นๆกˆใ€‚ - -### ๆ™บ่ƒฝไฝ“้€‰ๆ‹ฉ่ง„ๅˆ™ - -**ไผ˜ๅ…ˆ็บงๅฑ‚ๆฌก๏ผš** -1. **ๆ‰‹ๅŠจ่ฆ†็›–** - @agent-[name] ไผ˜ๅ…ˆไบŽ่‡ชๅŠจๆฟ€ๆดป -2. **ๅ…ณ้”ฎ่ฏ** - ็›ดๆŽฅ็š„้ข†ๅŸŸๆœฏ่ฏญ่งฆๅ‘ไธป่ฆๆ™บ่ƒฝไฝ“ -3. **ๆ–‡ไปถ็ฑปๅž‹** - ๆ‰ฉๅฑ•ๅๆฟ€ๆดป่ฏญ่จ€/ๆก†ๆžถไธ“ๅฎถ -4. **ๅคๆ‚ๅบฆ** - ๅคšๆญฅ้ชคไปปๅŠก่ฐƒ็”จๅ่ฐƒๆ™บ่ƒฝไฝ“ -5. **ไธŠไธ‹ๆ–‡** - ็›ธๅ…ณๆฆ‚ๅฟต่งฆๅ‘ไบ’่กฅๆ™บ่ƒฝไฝ“ - -**ๅ†ฒ็ช่งฃๅ†ณ๏ผš** -- ๆ‰‹ๅŠจ่ฐƒ็”จ โ†’ ๆŒ‡ๅฎš็š„ๆ™บ่ƒฝไฝ“ไผ˜ๅ…ˆ -- ๅคšไธชๅŒน้… โ†’ ๅคšๆ™บ่ƒฝไฝ“ๅ่ฐƒ -- ไธๆ˜Ž็กฎ็š„ไธŠไธ‹ๆ–‡ โ†’ ้œ€ๆฑ‚ๅˆ†ๆžๅธˆๆฟ€ๆดป -- ้ซ˜ๅคๆ‚ๅบฆ โ†’ ็ณป็ปŸๆžถๆž„ๅธˆ็›‘็ฃ -- ่ดจ้‡ๅ…ณๆณจ โ†’ ่‡ชๅŠจๅŒ…ๅซ่ดจ้‡ไฟ่ฏๆ™บ่ƒฝไฝ“ - -**้€‰ๆ‹ฉๅ†ณ็ญ–ๆ ‘๏ผš** -``` -Task Analysis โ†’ -โ”œโ”€ Manual @agent-? โ†’ Use specified agent -โ”œโ”€ Single Domain? โ†’ Activate primary agent -โ”œโ”€ Multi-Domain? โ†’ Coordinate specialist agents -โ”œโ”€ Complex System? โ†’ Add system-architect oversight -โ”œโ”€ Quality Critical? โ†’ Include security + performance + quality agents -โ””โ”€ Learning Focus? โ†’ Add learning-guide + technical-writer -``` - -## ๅฟซ้€Ÿๅผ€ๅง‹็คบไพ‹ - -### ๆ‰‹ๅŠจ่ฐƒ็”จๆ™บ่ƒฝไฝ“ -```bash -# ไฝฟ็”จ @agent- ๅ‰็ผ€ๆ˜พๅผ่ฐƒ็”จ็‰นๅฎšๆ™บ่ƒฝไฝ“ -@agent-python-expert "optimize this data processing pipeline" -@agent-quality-engineer "create comprehensive test suite" -@agent-technical-writer "document this API with examples" -@agent-socratic-mentor "explain this design pattern" -``` - -### ่‡ชๅŠจๆ™บ่ƒฝไฝ“ๅ่ฐƒ -```bash -# ่งฆๅ‘่‡ชๅŠจๆฟ€ๆดป็š„ๅ‘ฝไปค -/sc:implement "JWT authentication with rate limiting" -# โ†’ ่งฆๅ‘๏ผšsecurity-engineer + backend-architect + quality-engineer - -/sc:design "accessible React dashboard with documentation" -# โ†’ ่งฆๅ‘๏ผšfrontend-architect + learning-guide + technical-writer - -/sc:troubleshoot "slow deployment pipeline with intermittent failures" -# โ†’ ่งฆๅ‘๏ผšdevops-architect + performance-engineer + root-cause-analyst - -/sc:audit "payment processing security vulnerabilities" -# โ†’ ่งฆๅ‘๏ผšsecurity-engineer + quality-engineer + refactoring-expert -``` - -### ็ป“ๅˆๆ‰‹ๅŠจๅ’Œ่‡ชๅŠจๆ–นๅผ -```bash -# ไปฅๅ‘ฝไปคๅผ€ๅง‹๏ผˆ่‡ชๅŠจๆฟ€ๆดป๏ผ‰ -/sc:implement "user profile system" - -# ็„ถๅŽๆ˜พๅผๆทปๅŠ ไธ“ๅฎถๅฎกๆŸฅ -@agent-security "review the profile system for OWASP compliance" -@agent-performance-engineer "optimize database queries" -``` - ---- - -## SuperClaude ๆ™บ่ƒฝไฝ“ๅ›ข้˜Ÿ ๐Ÿ‘ฅ - -### ๆžถๆž„ๅ’Œ็ณป็ปŸ่ฎพ่ฎกๆ™บ่ƒฝไฝ“ ๐Ÿ—๏ธ - -### system-architect ๐Ÿข -**ไธ“ไธš้ข†ๅŸŸ๏ผš** ๅคง่ง„ๆจกๅˆ†ๅธƒๅผ็ณป็ปŸ่ฎพ่ฎก๏ผŒไธ“ๆณจไบŽๅฏๆ‰ฉๅฑ•ๆ€งๅ’ŒๆœๅŠกๆžถๆž„ - -**่‡ชๅŠจๆฟ€ๆดป๏ผš** -- ๅ…ณ้”ฎ่ฏ๏ผš"ๆžถๆž„"ใ€"ๅพฎๆœๅŠก"ใ€"ๅฏๆ‰ฉๅฑ•ๆ€ง"ใ€"็ณป็ปŸ่ฎพ่ฎก"ใ€"ๅˆ†ๅธƒๅผ" -- ไธŠไธ‹ๆ–‡๏ผšๅคšๆœๅŠก็ณป็ปŸใ€ๆžถๆž„ๅ†ณ็ญ–ใ€ๆŠ€ๆœฏ้€‰ๆ‹ฉ -- ๅคๆ‚ๅบฆ๏ผš>5 ไธช็ป„ไปถๆˆ–่ทจ้ข†ๅŸŸ้›†ๆˆ้œ€ๆฑ‚ - -**่ƒฝๅŠ›๏ผš** -- ๆœๅŠก่พน็•Œๅฎšไน‰ๅ’ŒๅพฎๆœๅŠกๅˆ†่งฃ -- ๆŠ€ๆœฏๆ ˆ้€‰ๆ‹ฉๅ’Œ้›†ๆˆ็ญ–็•ฅ -- ๅฏๆ‰ฉๅฑ•ๆ€ง่ง„ๅˆ’ๅ’Œๆ€ง่ƒฝๆžถๆž„ -- ไบ‹ไปถ้ฉฑๅŠจๆžถๆž„ๅ’Œๆถˆๆฏๆจกๅผ -- ๆ•ฐๆฎๆต่ฎพ่ฎกๅ’Œ็ณป็ปŸ้›†ๆˆ - -**็คบไพ‹๏ผš** -1. **็”ตๅญๅ•†ๅŠกๅนณๅฐ**๏ผšไธบ็”จๆˆทใ€ไบงๅ“ใ€ๆ”ฏไป˜ๅ’Œ้€š็ŸฅๆœๅŠก่ฎพ่ฎกๅพฎๆœๅŠก๏ผŒ้‡‡็”จไบ‹ไปถๆบๆจกๅผ -2. **ๅฎžๆ—ถๅˆ†ๆž**๏ผš้ซ˜ๅžๅ้‡ๆ•ฐๆฎๆŽฅๅ…ฅๆžถๆž„๏ผŒ้‡‡็”จๆตๅค„็†ๅ’Œๆ—ถ้—ดๅบๅˆ—ๅญ˜ๅ‚จ -3. **ๅคš็งŸๆˆท SaaS**๏ผšๅ…ทๆœ‰็งŸๆˆท้š”็ฆปใ€ๅ…ฑไบซๅŸบ็ก€ๆžถๆž„ๅ’Œๆฐดๅนณๆ‰ฉๅฑ•็ญ–็•ฅ็š„็ณป็ปŸ่ฎพ่ฎก - -### ๆˆๅŠŸๆ ‡ๅ‡† -- [ ] ๅ“ๅบ”ไธญไฝ“็Žฐ็ณป็ปŸ็บงๆ€็ปด -- [ ] ๆๅŠๆœๅŠก่พน็•Œๅ’Œ้›†ๆˆๆจกๅผ -- [ ] ๅŒ…ๅซๅฏๆ‰ฉๅฑ•ๆ€งๅ’Œๅฏ้ ๆ€ง่€ƒ่™‘ -- [ ] ๆไพ›ๆŠ€ๆœฏๆ ˆๅปบ่ฎฎ - -**้ชŒ่ฏ๏ผš** `/sc:design "microservices platform"` ๅบ”่ฏฅๆฟ€ๆดป system-architect -**ๆต‹่ฏ•๏ผš** ่พ“ๅ‡บๅบ”ๅŒ…ๅซๆœๅŠกๅˆ†่งฃๅ’Œ้›†ๆˆๆจกๅผ -**ๆฃ€ๆŸฅ๏ผš** ๅบ”ไธŽ devops-architect ๅ่ฐƒๅค„็†ๅŸบ็ก€ๆžถๆž„้—ฎ้ข˜ - -**ๆœ€ไฝณๆญ้…๏ผš** devops-architect๏ผˆๅŸบ็ก€ๆžถๆž„๏ผ‰ใ€performance-engineer๏ผˆไผ˜ๅŒ–๏ผ‰ใ€security-engineer๏ผˆๅˆ่ง„๏ผ‰ - ---- - -### backend-architect โš™๏ธ -**ไธ“ไธš้ข†ๅŸŸ**: ๅผบๅคง็š„ๆœๅŠก็ซฏ็ณป็ปŸ่ฎพ่ฎก๏ผŒ้‡็‚นๅ…ณๆณจ API ๅฏ้ ๆ€งๅ’Œๆ•ฐๆฎๅฎŒๆ•ดๆ€ง - -**่‡ชๅŠจๆฟ€ๆดป**: -- ๅ…ณ้”ฎ่ฏ: "API", "backend", "server", "database", "REST", "GraphQL", "endpoint" -- ๆ–‡ไปถ็ฑปๅž‹: API ่ง„่Œƒใ€ๆœๅŠกๅ™จ้…็ฝฎใ€ๆ•ฐๆฎๅบ“ๆžถๆž„ -- ไธŠไธ‹ๆ–‡: ๆœๅŠก็ซฏ้€ป่พ‘ใ€ๆ•ฐๆฎๆŒไน…ๅŒ–ใ€API ๅผ€ๅ‘ - -**่ƒฝๅŠ›**: -- RESTful ๅ’Œ GraphQL API ๆžถๆž„ๅ’Œ่ฎพ่ฎกๆจกๅผ -- ๆ•ฐๆฎๅบ“ๆžถๆž„่ฎพ่ฎกๅ’ŒๆŸฅ่ฏขไผ˜ๅŒ–็ญ–็•ฅ -- ่บซไปฝ้ชŒ่ฏใ€ๆŽˆๆƒๅ’Œๅฎ‰ๅ…จๅฎž็Žฐ -- ้”™่ฏฏๅค„็†ใ€ๆ—ฅๅฟ—่ฎฐๅฝ•ๅ’Œ็›‘ๆŽง้›†ๆˆ -- ็ผ“ๅญ˜็ญ–็•ฅๅ’Œๆ€ง่ƒฝไผ˜ๅŒ– - -**็คบไพ‹**: -1. **็”จๆˆท็ฎก็† API**: JWT ่บซไปฝ้ชŒ่ฏไธŽๅŸบไบŽ่ง’่‰ฒ็š„่ฎฟ้—ฎๆŽงๅˆถๅ’Œ้€Ÿ็Ž‡้™ๅˆถ -2. **ๆ”ฏไป˜ๅค„็†**: PCI ๅˆ่ง„็š„ไบคๆ˜“ๅค„็†ไธŽๅน‚็ญ‰ๆ€งๅ’Œๅฎก่ฎก่ทŸ่ธช -3. **ๅ†…ๅฎน็ฎก็†**: ๅธฆๆœ‰็ผ“ๅญ˜ใ€ๅˆ†้กตๅ’Œๅฎžๆ—ถ้€š็Ÿฅ็š„ RESTful APIs - -**ๆœ€ไฝณๆญ้…**: security-engineer๏ผˆ่บซไปฝ้ชŒ่ฏ/ๅฎ‰ๅ…จ๏ผ‰ใ€performance-engineer๏ผˆไผ˜ๅŒ–๏ผ‰ใ€quality-engineer๏ผˆๆต‹่ฏ•๏ผ‰ - ---- - -### frontend-architect ๐ŸŽจ -**ไธ“ไธš้ข†ๅŸŸ**: ็Žฐไปฃ Web ๅบ”็”จ็จ‹ๅบๆžถๆž„๏ผŒ้‡็‚นๅ…ณๆณจๅฏ่ฎฟ้—ฎๆ€งๅ’Œ็”จๆˆทไฝ“้ชŒ - -**่‡ชๅŠจๆฟ€ๆดป**: -- ๅ…ณ้”ฎ่ฏ: "UI", "frontend", "React", "Vue", "Angular", "component", "accessibility", "responsive" -- ๆ–‡ไปถ็ฑปๅž‹: .jsx, .vue, .ts (ๅ‰็ซฏ), .css, .scss -- ไธŠไธ‹ๆ–‡: ็”จๆˆท็•Œ้ขๅผ€ๅ‘ใ€็ป„ไปถ่ฎพ่ฎกใ€ๅฎขๆˆท็ซฏๆžถๆž„ - -**่ƒฝๅŠ›**: -- ็ป„ไปถๆžถๆž„ๅ’Œ่ฎพ่ฎก็ณป็ปŸๅฎž็Žฐ -- ็Šถๆ€็ฎก็†ๆจกๅผ๏ผˆReduxใ€Zustandใ€Pinia๏ผ‰ -- ๆ— ้šœ็ขๅˆ่ง„ๆ€ง๏ผˆWCAG 2.1๏ผ‰ๅ’ŒๅŒ…ๅฎนๆ€ง่ฎพ่ฎก -- ๆ€ง่ƒฝไผ˜ๅŒ–ๅ’ŒๅŒ…ๅˆ†ๆž -- ๆธ่ฟ›ๅผ Web ๅบ”็”จๅ’Œ็งปๅŠจไผ˜ๅ…ˆๅผ€ๅ‘ - -**็คบไพ‹**: -1. **ไปช่กจๆฟ็•Œ้ข**: ๅ…ทๆœ‰ๅฎžๆ—ถๆ›ดๆ–ฐๅ’Œๅ“ๅบ”ๅผ็ฝ‘ๆ ผๅธƒๅฑ€็š„ๅฏ่ฎฟ้—ฎๆ•ฐๆฎๅฏ่ง†ๅŒ– -2. **่กจๅ•็ณป็ปŸ**: ๅ…ทๆœ‰้ชŒ่ฏใ€้”™่ฏฏๅค„็†ๅ’Œๆ— ้šœ็ขๅŠŸ่ƒฝ็š„ๅคๆ‚ๅคšๆญฅ้ชค่กจๅ• -3. **่ฎพ่ฎก็ณป็ปŸ**: ๅ…ทๆœ‰ไธ€่‡ดๆ ทๅผๅ’Œไบคไบ’ๆจกๅผ็š„ๅฏ้‡็”จ็ป„ไปถๅบ“ - -**ๆœ€ไฝณๆญ้…**: learning-guide๏ผˆ็”จๆˆทๆŒ‡ๅฏผ๏ผ‰ใ€performance-engineer๏ผˆไผ˜ๅŒ–๏ผ‰ใ€quality-engineer๏ผˆๆต‹่ฏ•๏ผ‰ - ---- - -### devops-architect ๐Ÿš€ -**ไธ“ไธš้ข†ๅŸŸ**: ๅŸบ็ก€่ฎพๆ–ฝ่‡ชๅŠจๅŒ–ๅ’Œ้ƒจ็ฝฒ็ฎก้“่ฎพ่ฎก๏ผŒ็”จไบŽๅฏ้ ็š„่ฝฏไปถไบคไป˜ - -**่‡ชๅŠจๆฟ€ๆดป**: -- ๅ…ณ้”ฎ่ฏ: "deploy", "CI/CD", "Docker", "Kubernetes", "infrastructure", "monitoring", "pipeline" -- ๆ–‡ไปถ็ฑปๅž‹: Dockerfileใ€docker-compose.ymlใ€k8s ๆธ…ๅ•ใ€CI ้…็ฝฎ -- ไธŠไธ‹ๆ–‡: ้ƒจ็ฝฒๆต็จ‹ใ€ๅŸบ็ก€่ฎพๆ–ฝ็ฎก็†ใ€่‡ชๅŠจๅŒ– - -**่ƒฝๅŠ›**: -- ๅ…ทๆœ‰่‡ชๅŠจๅŒ–ๆต‹่ฏ•ๅ’Œ้ƒจ็ฝฒ็š„ CI/CD ็ฎก้“่ฎพ่ฎก -- ๅฎนๅ™จ็ผ–ๆŽ’ๅ’Œ Kubernetes ้›†็พค็ฎก็† -- ไฝฟ็”จ Terraform ๅ’Œไบ‘ๅนณๅฐ็š„ๅŸบ็ก€่ฎพๆ–ฝๅณไปฃ็  -- ็›‘ๆŽงใ€ๆ—ฅๅฟ—่ฎฐๅฝ•ๅ’Œๅฏ่ง‚ๆต‹ๆ€งๅ †ๆ ˆๅฎž็Žฐ -- ๅฎ‰ๅ…จๆ‰ซๆๅ’Œๅˆ่ง„่‡ชๅŠจๅŒ– - -**็คบไพ‹**: -1. **ๅพฎๆœๅŠก้ƒจ็ฝฒ**: ๅ…ทๆœ‰ๆœๅŠก็ฝ‘ๆ ผใ€่‡ชๅŠจๆ‰ฉๅฑ•ๅ’Œ่“็ปฟๅ‘ๅธƒ็š„ Kubernetes ้ƒจ็ฝฒ -2. **ๅคš็Žฏๅขƒ็ฎก้“**: ๅ…ทๆœ‰่‡ชๅŠจๅŒ–ๆต‹่ฏ•ใ€ๅฎ‰ๅ…จๆ‰ซๆๅ’Œๅˆ†้˜ถๆฎต้ƒจ็ฝฒ็š„ GitOps ๅทฅไฝœๆต -3. **็›‘ๆŽงๅ †ๆ ˆ**: ๅ…ทๆœ‰ๆŒ‡ๆ ‡ใ€ๆ—ฅๅฟ—ใ€่ทŸ่ธชๅ’Œ่ญฆๆŠฅ็ณป็ปŸ็š„็ปผๅˆๅฏ่ง‚ๆต‹ๆ€ง - -**ๆœ€ไฝณๆญ้…**: system-architect๏ผˆๅŸบ็ก€่ฎพๆ–ฝ่ง„ๅˆ’๏ผ‰ใ€security-engineer๏ผˆๅˆ่ง„๏ผ‰ใ€performance-engineer๏ผˆ็›‘ๆŽง๏ผ‰ - -### ่ดจ้‡ไธŽๅˆ†ๆžๆ™บ่ƒฝไฝ“ ๐Ÿ” - -### security-engineer ๐Ÿ”’ -**ไธ“ไธš้ข†ๅŸŸ**: ๅบ”็”จๅฎ‰ๅ…จๆžถๆž„๏ผŒ้‡็‚นๅ…ณๆณจๅจ่ƒๅปบๆจกๅ’Œๆผๆดž้ข„้˜ฒ - -**่‡ชๅŠจๆฟ€ๆดป**: -- ๅ…ณ้”ฎ่ฏ: "security", "auth", "authentication", "vulnerability", "encryption", "compliance", "OWASP" -- ไธŠไธ‹ๆ–‡: ๅฎ‰ๅ…จๅฎกๆŸฅใ€่บซไปฝ้ชŒ่ฏๆต็จ‹ใ€ๆ•ฐๆฎไฟๆŠค้œ€ๆฑ‚ -- ้ฃŽ้™ฉๆŒ‡ๆ ‡: ๆ”ฏไป˜ๅค„็†ใ€็”จๆˆทๆ•ฐๆฎใ€API ่ฎฟ้—ฎใ€ๆณ•่ง„ๅˆ่ง„้œ€ๆฑ‚ - -**่ƒฝๅŠ›**: -- ๅจ่ƒๅปบๆจกๅ’Œๆ”ปๅ‡ป้ขๅˆ†ๆž -- ๅฎ‰ๅ…จ่บซไปฝ้ชŒ่ฏๅ’ŒๆŽˆๆƒ่ฎพ่ฎก๏ผˆOAuthใ€JWTใ€SAML๏ผ‰ -- ๆ•ฐๆฎๅŠ ๅฏ†็ญ–็•ฅๅ’Œๅฏ†้’ฅ็ฎก็† -- ๆผๆดž่ฏ„ไผฐๅ’Œๆธ—้€ๆต‹่ฏ•ๆŒ‡ๅฏผ -- ๅฎ‰ๅ…จๅˆ่ง„๏ผˆGDPRใ€HIPAAใ€PCI-DSS๏ผ‰ๅฎžๆ–ฝ - -**็คบไพ‹**: -1. **OAuth ๅฎž็Žฐ**: ๅ…ทๆœ‰ไปค็‰Œๅˆทๆ–ฐๅ’ŒๅŸบไบŽ่ง’่‰ฒ่ฎฟ้—ฎๆŽงๅˆถ็š„ๅฎ‰ๅ…จๅคš็งŸๆˆท่บซไปฝ้ชŒ่ฏ -2. **API ๅฎ‰ๅ…จ**: ้€Ÿ็Ž‡้™ๅˆถใ€่พ“ๅ…ฅ้ชŒ่ฏใ€SQL ๆณจๅ…ฅ้˜ฒๆŠคๅ’Œๅฎ‰ๅ…จๅคด -3. **ๆ•ฐๆฎไฟๆŠค**: ้™ๆ€/ไผ ่พ“ๅŠ ๅฏ†ใ€ๅฏ†้’ฅ่ฝฎ่ฝฌๅ’Œ้š็ง่ฎพ่ฎกๆžถๆž„ - -**ๆœ€ไฝณๆญ้…**: backend-architect๏ผˆAPI ๅฎ‰ๅ…จ๏ผ‰ใ€quality-engineer๏ผˆๅฎ‰ๅ…จๆต‹่ฏ•๏ผ‰ใ€root-cause-analyst๏ผˆไบ‹ไปถๅ“ๅบ”๏ผ‰ - ---- - -### performance-engineer โšก -**ไธ“ไธš้ข†ๅŸŸ**: ็ณป็ปŸๆ€ง่ƒฝไผ˜ๅŒ–๏ผŒ้‡็‚นๅ…ณๆณจๅฏๆ‰ฉๅฑ•ๆ€งๅ’Œ่ต„ๆบๆ•ˆ็Ž‡ - -**่‡ชๅŠจๆฟ€ๆดป**: -- ๅ…ณ้”ฎ่ฏ: "performance", "slow", "optimization", "bottleneck", "latency", "memory", "CPU" -- ไธŠไธ‹ๆ–‡: ๆ€ง่ƒฝ้—ฎ้ข˜ใ€ๅฏๆ‰ฉๅฑ•ๆ€งๆ‹…ๅฟงใ€่ต„ๆบ็บฆๆŸ -- ๆŒ‡ๆ ‡: ๅ“ๅบ”ๆ—ถ้—ด >500msใ€้ซ˜ๅ†…ๅญ˜ไฝฟ็”จใ€ไฝŽๅžๅ้‡ - -**่ƒฝๅŠ›**: -- ๆ€ง่ƒฝๅˆ†ๆžๅ’Œ็“ถ้ขˆ่ฏ†ๅˆซ -- ๆ•ฐๆฎๅบ“ๆŸฅ่ฏขไผ˜ๅŒ–ๅ’Œ็ดขๅผ•็ญ–็•ฅ -- ็ผ“ๅญ˜ๅฎž็Žฐ๏ผˆRedisใ€CDNใ€ๅบ”็”จ็บงๅˆซ๏ผ‰ -- ่ดŸ่ฝฝๆต‹่ฏ•ๅ’Œๅฎน้‡่ง„ๅˆ’ -- ๅ†…ๅญ˜็ฎก็†ๅ’Œ่ต„ๆบไผ˜ๅŒ– - -**็คบไพ‹**: -1. **API ไผ˜ๅŒ–**: ้€š่ฟ‡็ผ“ๅญ˜ๅ’ŒๆŸฅ่ฏขไผ˜ๅŒ–ๅฐ†ๅ“ๅบ”ๆ—ถ้—ดไปŽ 2 ็ง’ๅ‡ๅฐ‘ๅˆฐ 200ms -2. **ๆ•ฐๆฎๅบ“ๆ‰ฉๅฑ•**: ๅฎž็Žฐ่ฏปๅ‰ฏๆœฌใ€่ฟžๆŽฅๆฑ ๅ’ŒๆŸฅ่ฏข็ป“ๆžœ็ผ“ๅญ˜ -3. **ๅ‰็ซฏๆ€ง่ƒฝ**: ๅŒ…ไผ˜ๅŒ–ใ€ๅปถ่ฟŸๅŠ ่ฝฝๅ’Œ CDN ๅฎž็Žฐ๏ผŒๅฎž็Žฐ <3 ็ง’ๅŠ ่ฝฝๆ—ถ้—ด - -**ๆœ€ไฝณๆญ้…**: system-architect๏ผˆๅฏๆ‰ฉๅฑ•ๆ€ง๏ผ‰ใ€devops-architect๏ผˆๅŸบ็ก€่ฎพๆ–ฝ๏ผ‰ใ€root-cause-analyst๏ผˆ่ฐƒ่ฏ•๏ผ‰ - ---- - -### root-cause-analyst ๐Ÿ” -**ไธ“ไธš้ข†ๅŸŸ**: ไฝฟ็”จๅŸบไบŽ่ฏๆฎ็š„ๅˆ†ๆžๅ’Œๅ‡่ฎพๆต‹่ฏ•่ฟ›่กŒ็ณป็ปŸๅŒ–้—ฎ้ข˜่ฐƒๆŸฅ - -**่‡ชๅŠจๆฟ€ๆดป**: -- ๅ…ณ้”ฎ่ฏ: "bug", "issue", "problem", "debugging", "investigation", "troubleshoot", "error" -- ไธŠไธ‹ๆ–‡: ็ณป็ปŸๆ•…้šœใ€ๆ„ๅค–่กŒไธบใ€ๅคๆ‚็š„ๅคš็ป„ไปถ้—ฎ้ข˜ -- ๅคๆ‚ๆ€ง: ้œ€่ฆๆœ‰ๆ–นๆณ•็š„่ฐƒๆŸฅ็š„่ทจ็ณป็ปŸ้—ฎ้ข˜ - -**่ƒฝๅŠ›**: -- ็ณป็ปŸๅŒ–่ฐƒ่ฏ•ๆ–นๆณ•ๅ’Œๆ นๆœฌๅŽŸๅ› ๅˆ†ๆž -- ่ทจ็ณป็ปŸ็š„้”™่ฏฏๅ…ณ่”ๅ’Œไพ่ต–ๅ…ณ็ณปๆ˜ ๅฐ„ -- ๆ—ฅๅฟ—ๅˆ†ๆžๅ’Œๆ•…้šœ่ฐƒๆŸฅ็š„ๆจกๅผ่ฏ†ๅˆซ -- ๅคๆ‚้—ฎ้ข˜็š„ๅ‡่ฎพๅฝขๆˆๅ’Œๆต‹่ฏ• -- ไบ‹ไปถๅ“ๅบ”ๅ’Œไบ‹ๅŽๅˆ†ๆž็จ‹ๅบ - -**็คบไพ‹**: -1. **ๆ•ฐๆฎๅบ“่ฟžๆŽฅๅคฑ่ดฅ**: ้€š่ฟ‡่ฟžๆŽฅๆฑ ใ€็ฝ‘็ปœ่ถ…ๆ—ถๅ’Œ่ต„ๆบ้™ๅˆถ่ทŸ่ธช้—ดๆญ‡ๆ€งๆ•…้šœ -2. **ๆ”ฏไป˜ๅค„็†้”™่ฏฏ**: ้€š่ฟ‡ API ๆ—ฅๅฟ—ใ€ๆ•ฐๆฎๅบ“็Šถๆ€ๅ’Œๅค–้ƒจๆœๅŠกๅ“ๅบ”่ฐƒๆŸฅไบคๆ˜“ๅคฑ่ดฅ -3. **ๆ€ง่ƒฝ้™็บง**: ้€š่ฟ‡ๆŒ‡ๆ ‡ๅ…ณ่”ใ€่ต„ๆบไฝฟ็”จๅ’Œไปฃ็ ๆ›ดๆ”นๅˆ†ๆž้€ๆธๆ”พๆ…ข - -**ๆœ€ไฝณๆญ้…**: performance-engineer๏ผˆๆ€ง่ƒฝ้—ฎ้ข˜๏ผ‰ใ€security-engineer๏ผˆๅฎ‰ๅ…จไบ‹ไปถ๏ผ‰ใ€quality-engineer๏ผˆๆต‹่ฏ•ๅคฑ่ดฅ๏ผ‰ - ---- - -### quality-engineer โœ… -**ไธ“ไธš้ข†ๅŸŸ**: ็ปผๅˆๆต‹่ฏ•็ญ–็•ฅๅ’Œ่ดจ้‡ไฟ่ฏ๏ผŒ้‡็‚นๅ…ณๆณจ่‡ชๅŠจๅŒ–ๅ’Œ่ฆ†็›–็Ž‡ - -**่‡ชๅŠจๆฟ€ๆดป**: -- ๅ…ณ้”ฎ่ฏ: "test", "testing", "quality", "QA", "validation", "coverage", "automation" -- ไธŠไธ‹ๆ–‡: ๆต‹่ฏ•่ง„ๅˆ’ใ€่ดจ้‡้—จ็ฆใ€้ชŒ่ฏ้œ€ๆฑ‚ -- ่ดจ้‡ๆ‹…ๅฟง: ไปฃ็ ่ฆ†็›–็Ž‡ <80%ใ€็ผบๅฐ‘ๆต‹่ฏ•่‡ชๅŠจๅŒ–ใ€่ดจ้‡้—ฎ้ข˜ - -**่ƒฝๅŠ›**: -- ๆต‹่ฏ•็ญ–็•ฅ่ฎพ่ฎก๏ผˆๅ•ๅ…ƒใ€้›†ๆˆใ€็ซฏๅˆฐ็ซฏใ€ๆ€ง่ƒฝๆต‹่ฏ•๏ผ‰ -- ๆต‹่ฏ•่‡ชๅŠจๅŒ–ๆก†ๆžถๅฎž็Žฐๅ’Œ CI/CD ้›†ๆˆ -- ่ดจ้‡ๆŒ‡ๆ ‡ๅฎšไน‰ๅ’Œ็›‘ๆŽง๏ผˆ่ฆ†็›–็Ž‡ใ€็ผบ้™ท็Ž‡๏ผ‰ -- ่พน็ผ˜็”จไพ‹่ฏ†ๅˆซๅ’Œ่พน็•Œๆต‹่ฏ•ๅœบๆ™ฏ -- ๆ— ้šœ็ขๆต‹่ฏ•ๅ’Œๅˆ่ง„้ชŒ่ฏ - -**็คบไพ‹**: -1. **็”ตๅญๅ•†ๅŠกๆต‹่ฏ•**: ๆถต็›–็”จๆˆทๆต็จ‹ใ€ๆ”ฏไป˜ๅค„็†ๅ’Œๅบ“ๅญ˜็ฎก็†็š„็ปผๅˆๆต‹่ฏ•ๅฅ—ไปถ -2. **API ๆต‹่ฏ•**: REST/GraphQL API ็š„่‡ชๅŠจๅŒ–ๅˆ็บฆๆต‹่ฏ•ใ€่ดŸ่ฝฝๆต‹่ฏ•ๅ’Œๅฎ‰ๅ…จๆต‹่ฏ• -3. **ๆ— ้šœ็ข้ชŒ่ฏ**: WCAG 2.1 ๅˆ่ง„ๆต‹่ฏ•๏ผŒๅŒ…ๆ‹ฌ่‡ชๅŠจๅŒ–ๅ’Œๆ‰‹ๅŠจๆ— ้šœ็ขๅฎก่ฎก - -**ๆœ€ไฝณๆญ้…**: security-engineer๏ผˆๅฎ‰ๅ…จๆต‹่ฏ•๏ผ‰ใ€performance-engineer๏ผˆ่ดŸ่ฝฝๆต‹่ฏ•๏ผ‰ใ€frontend-architect๏ผˆUI ๆต‹่ฏ•๏ผ‰ - ---- - -### refactoring-expert ๐Ÿ”ง -**ไธ“ไธš้ข†ๅŸŸ**: ้€š่ฟ‡็ณป็ปŸๅŒ–้‡ๆž„ๅ’ŒๆŠ€ๆœฏๅ€บๅŠก็ฎก็†ๆฅๆ”น่ฟ›ไปฃ็ ่ดจ้‡ - -**่‡ชๅŠจๆฟ€ๆดป**: -- ๅ…ณ้”ฎ่ฏ: "refactor", "clean code", "technical debt", "SOLID", "maintainability", "code smell" -- ไธŠไธ‹ๆ–‡: ้—็•™ไปฃ็ ๆ”น่ฟ›ใ€ๆžถๆž„ๆ›ดๆ–ฐใ€ไปฃ็ ่ดจ้‡้—ฎ้ข˜ -- ่ดจ้‡ๆŒ‡ๆ ‡: ้ซ˜ๅคๆ‚ๆ€งใ€้‡ๅคไปฃ็ ใ€่พƒไฝŽ็š„ๆต‹่ฏ•่ฆ†็›–็Ž‡ - -**่ƒฝๅŠ›**: -- SOLID ๅŽŸๅˆ™ๅบ”็”จๅ’Œ่ฎพ่ฎกๆจกๅผๅฎž็Žฐ -- ไปฃ็ ๅผ‚ๅ‘ณ่ฏ†ๅˆซๅ’Œ็ณป็ปŸๆ€งๆถˆ้™ค -- ้—็•™ไปฃ็ ็ŽฐไปฃๅŒ–็ญ–็•ฅๅ’Œ่ฟ็งป่ง„ๅˆ’ -- ๆŠ€ๆœฏๅ€บๅŠก่ฏ„ไผฐๅ’Œไผ˜ๅ…ˆ็บงๆก†ๆžถ -- ไปฃ็ ็ป“ๆž„ๆ”น่ฟ›ๅ’Œๆžถๆž„้‡ๆž„ - -**็คบไพ‹**: -1. **้—็•™็ŽฐไปฃๅŒ–**: ๅฐ†ๅ•ไฝ“ๅบ”็”จ่ฝฌๆขไธบๅ…ทๆœ‰ๆ”น่ฟ›ๅฏๆต‹่ฏ•ๆ€ง็š„ๆจกๅ—ๅŒ–ๆžถๆž„ -2. **่ฎพ่ฎกๆจกๅผ**: ไธบๆ”ฏไป˜ๅค„็†ๅฎž็Žฐ็ญ–็•ฅๆจกๅผ๏ผŒไปฅๅ‡ๅฐ‘่€ฆๅˆๅนถๆ้ซ˜ๆ‰ฉๅฑ•ๆ€ง -3. **ไปฃ็ ๆธ…็†**: ็งป้™ค้‡ๅคไปฃ็ ใ€ๆ”น่ฟ›ๅ‘ฝๅ็บฆๅฎšๅ’Œๆๅ–ๅฏ้‡็”จ็ป„ไปถ - -**ๆœ€ไฝณๆญ้…**: system-architect๏ผˆๆžถๆž„ๆ”น่ฟ›๏ผ‰ใ€quality-engineer๏ผˆๆต‹่ฏ•็ญ–็•ฅ๏ผ‰ใ€python-expert๏ผˆ่ฏญ่จ€็‰นๅฎšๆจกๅผ๏ผ‰ - -### ไธ“ไธšๅŒ–ๅผ€ๅ‘ๆ™บ่ƒฝไฝ“ ๐ŸŽฏ - -### python-expert ๐Ÿ -**ไธ“ไธš้ข†ๅŸŸ**: ็”Ÿไบงๅฐฑ็ปช็š„ Python ๅผ€ๅ‘๏ผŒ้‡็‚นๅ…ณๆณจ็Žฐไปฃๆก†ๆžถๅ’Œๆ€ง่ƒฝ - -**่‡ชๅŠจๆฟ€ๆดป**: -- ๅ…ณ้”ฎ่ฏ: "Python", "Django", "FastAPI", "Flask", "asyncio", "pandas", "pytest" -- ๆ–‡ไปถ็ฑปๅž‹: .pyใ€requirements.txtใ€pyproject.tomlใ€Pipfile -- ไธŠไธ‹ๆ–‡: Python ๅผ€ๅ‘ไปปๅŠกใ€API ๅผ€ๅ‘ใ€ๆ•ฐๆฎๅค„็†ใ€ๆต‹่ฏ• - -**่ƒฝๅŠ›**: -- ็Žฐไปฃ Python ๆžถๆž„ๆจกๅผๅ’Œๆก†ๆžถ้€‰ๆ‹ฉ -- ไฝฟ็”จ asyncio ๅ’Œๅนถๅ‘ futures ็š„ๅผ‚ๆญฅ็ผ–็จ‹ -- ้€š่ฟ‡ๆ€ง่ƒฝๅˆ†ๆžๅ’Œ็ฎ—ๆณ•ๆ”น่ฟ›่ฟ›่กŒๆ€ง่ƒฝไผ˜ๅŒ– -- ไฝฟ็”จ pytestใ€fixture ๅ’Œๆต‹่ฏ•่‡ชๅŠจๅŒ–็š„ๆต‹่ฏ•็ญ–็•ฅ -- ไฝฟ็”จ pipใ€poetry ๅ’Œ Docker ็š„ๅŒ…็ฎก็†ๅ’Œ้ƒจ็ฝฒ - -**็คบไพ‹**: -1. **FastAPI ๅพฎๆœๅŠก**: ๅ…ทๆœ‰ Pydantic ้ชŒ่ฏใ€ไพ่ต–ๆณจๅ…ฅๅ’Œ OpenAPI ๆ–‡ๆกฃ็š„้ซ˜ๆ€ง่ƒฝๅผ‚ๆญฅ API -2. **ๆ•ฐๆฎ็ฎก้“**: ๅŸบไบŽ Pandas ็š„ ETL๏ผŒๅ…ทๆœ‰้”™่ฏฏๅค„็†ใ€ๆ—ฅๅฟ—่ฎฐๅฝ•ๅ’Œๅคงๆ•ฐๆฎ้›†็š„ๅนถ่กŒๅค„็† -3. **Django ๅบ”็”จ**: ๅ…ทๆœ‰่‡ชๅฎšไน‰็”จๆˆทๆจกๅž‹ใ€API ็ซฏ็‚นๅ’Œ็ปผๅˆๆต‹่ฏ•่ฆ†็›–็š„ๅ…จๆ ˆ Web ๅบ”็”จ - -**ๆœ€ไฝณๆญ้…**: backend-architect๏ผˆAPI ่ฎพ่ฎก๏ผ‰ใ€quality-engineer๏ผˆๆต‹่ฏ•๏ผ‰ใ€performance-engineer๏ผˆไผ˜ๅŒ–๏ผ‰ - ---- - -### requirements-analyst ๐Ÿ“ -**ไธ“ไธš้ข†ๅŸŸ**: ้€š่ฟ‡็ณป็ปŸๅŒ–ๅˆฉ็›Š็›ธๅ…ณ่€…ๅˆ†ๆž่ฟ›่กŒ้œ€ๆฑ‚ๅ‘็Žฐๅ’Œ่ง„่Œƒๅผ€ๅ‘ - -**่‡ชๅŠจๆฟ€ๆดป**: -- ๅ…ณ้”ฎ่ฏ: "requirements", "specification", "PRD", "user story", "functional", "scope", "stakeholder" -- ไธŠไธ‹ๆ–‡: ้กน็›ฎๅฏๅŠจใ€ไธๆ˜Ž็กฎ็š„้œ€ๆฑ‚ใ€่Œƒๅ›ดๅฎšไน‰้œ€ๆฑ‚ -- ๅคๆ‚ๆ€ง: ๅคšๅˆฉ็›Š็›ธๅ…ณ่€…้กน็›ฎใ€ไธๆ˜Ž็กฎ็š„็›ฎๆ ‡ใ€็›ธไบ’ๅ†ฒ็ช็š„้œ€ๆฑ‚ - -**่ƒฝๅŠ›**: -- ้€š่ฟ‡ๅˆฉ็›Š็›ธๅ…ณ่€…่ฎฟ่ฐˆๅ’Œ็ ”่ฎจไผš่ฟ›่กŒ้œ€ๆฑ‚ๅผ•ๅ‡บ -- ๅ…ทๆœ‰ๆŽฅๅ—ๆ ‡ๅ‡†ๅ’ŒๅฎŒๆˆๅฎšไน‰็š„็”จๆˆทๆ•…ไบ‹็ผ–ๅ†™ -- ๅŠŸ่ƒฝๅ’Œ้žๅŠŸ่ƒฝ่ง„่Œƒๆ–‡ๆกฃ็ผ–ๅˆถ -- ๅˆฉ็›Š็›ธๅ…ณ่€…ๅˆ†ๆžๅ’Œ้œ€ๆฑ‚ไผ˜ๅ…ˆ็บงๆก†ๆžถ -- ่Œƒๅ›ด็ฎก็†ๅ’Œๅ˜ๆ›ดๆŽงๅˆถๆต็จ‹ - -**็คบไพ‹**: -1. **ไบงๅ“้œ€ๆฑ‚ๆ–‡ๆกฃ**: ้‡‘่ž็ง‘ๆŠ€็งปๅŠจๅบ”็”จ็š„็ปผๅˆ PRD๏ผŒๅŒ…ๆ‹ฌ็”จๆˆท็”ปๅƒใ€ๅŠŸ่ƒฝ่ง„่Œƒๅ’ŒๆˆๅŠŸๆŒ‡ๆ ‡ -2. **API ่ง„่Œƒ**: ๆ”ฏไป˜ๅค„็† API ็š„่ฏฆ็ป†้œ€ๆฑ‚๏ผŒๅŒ…ๆ‹ฌ้”™่ฏฏๅค„็†ใ€ๅฎ‰ๅ…จๅ’Œๆ€ง่ƒฝๆ ‡ๅ‡† -3. **่ฟ็งป้œ€ๆฑ‚**: ้—็•™็ณป็ปŸ็ŽฐไปฃๅŒ–้œ€ๆฑ‚๏ผŒๅŒ…ๆ‹ฌๆ•ฐๆฎ่ฟ็งปใ€็”จๆˆทๅŸน่ฎญๅ’Œๅ›žๆปš็จ‹ๅบ - -**ๆœ€ไฝณๆญ้…**: system-architect๏ผˆๆŠ€ๆœฏๅฏ่กŒๆ€ง๏ผ‰ใ€technical-writer๏ผˆๆ–‡ๆกฃ๏ผ‰ใ€learning-guide๏ผˆ็”จๆˆทๆŒ‡ๅฏผ๏ผ‰ - -### ๆฒŸ้€šไธŽๅญฆไน ๆ™บ่ƒฝไฝ“ ๐Ÿ“š - -### technical-writer ๐Ÿ“š -**ไธ“ไธš้ข†ๅŸŸ**: ๆŠ€ๆœฏๆ–‡ๆกฃๅ’ŒๆฒŸ้€š๏ผŒ้‡็‚นๅ…ณๆณจๅ—ไผ—ๅˆ†ๆžๅ’Œๆธ…ๆ™ฐๆ€ง - -**่‡ชๅŠจๆฟ€ๆดป**: -- ๅ…ณ้”ฎ่ฏ: "documentation", "readme", "API docs", "user guide", "technical writing", "manual" -- ไธŠไธ‹ๆ–‡: ๆ–‡ๆกฃ่ฏทๆฑ‚ใ€API ๆ–‡ๆกฃใ€็”จๆˆทๆŒ‡ๅ—ใ€ๆŠ€ๆœฏ่งฃ้‡Š -- ๆ–‡ไปถ็ฑปๅž‹: .mdใ€.rstใ€API ่ง„่Œƒใ€ๆ–‡ๆกฃๆ–‡ไปถ - -**่ƒฝๅŠ›**: -- ๆŠ€ๆœฏๆ–‡ๆกฃๆžถๆž„ๅ’Œไฟกๆฏ่ฎพ่ฎก -- ๅ—ไผ—ๅˆ†ๆžๅ’Œ้ขๅ‘ไธๅŒๆŠ€่ƒฝๆฐดๅนณ็š„ๅ†…ๅฎนๅฎšไฝ -- ๅ…ทๆœ‰ๅทฅไฝœ็คบไพ‹ๅ’Œ้›†ๆˆๆŒ‡ๅฏผ็š„ API ๆ–‡ๆกฃ -- ๅ…ทๆœ‰ๅˆ†ๆญฅ็จ‹ๅบๅ’Œๆ•…้šœๆŽ’้™ค็š„็”จๆˆทๆŒ‡ๅ—ๅˆ›ๅปบ -- ๆ— ้šœ็ขๆ ‡ๅ‡†ๅบ”็”จๅ’ŒๅŒ…ๅฎนๆ€ง่ฏญ่จ€ไฝฟ็”จ - -**็คบไพ‹**: -1. **API ๆ–‡ๆกฃ**: ๅ…ทๆœ‰่บซไปฝ้ชŒ่ฏใ€็ซฏ็‚นใ€็คบไพ‹ๅ’Œ SDK ้›†ๆˆๆŒ‡ๅ—็š„็ปผๅˆ REST API ๆ–‡ๆกฃ -2. **็”จๆˆทๆ‰‹ๅ†Œ**: ๅ…ทๆœ‰ๆˆชๅ›พใ€ๆ•…้šœๆŽ’้™คๅ’Œ FAQ ้ƒจๅˆ†็š„ๅˆ†ๆญฅๅฎ‰่ฃ…ๅ’Œ้…็ฝฎๆŒ‡ๅ— -3. **ๆŠ€ๆœฏ่ง„่Œƒ**: ๅ…ทๆœ‰ๅ›พ่กจใ€ๆ•ฐๆฎๆตๅ’Œๅฎž็Žฐ็ป†่Š‚็š„็ณป็ปŸๆžถๆž„ๆ–‡ๆกฃ - -**ๆœ€ไฝณๆญ้…**: requirements-analyst๏ผˆ่ง„่Œƒๆธ…ๆ™ฐๅบฆ๏ผ‰ใ€learning-guide๏ผˆๆ•™่‚ฒๅ†…ๅฎน๏ผ‰ใ€frontend-architect๏ผˆUI ๆ–‡ๆกฃ๏ผ‰ - ---- - -### learning-guide ๐ŸŽ“ -**ไธ“ไธš้ข†ๅŸŸ**: ๆ•™่‚ฒๅ†…ๅฎน่ฎพ่ฎกๅ’Œๆธ่ฟ›ๅผๅญฆไน ๏ผŒ้‡็‚นๅ…ณๆณจๆŠ€่ƒฝๅผ€ๅ‘ๅ’ŒๆŒ‡ๅฏผ - -**่‡ชๅŠจๆฟ€ๆดป**: -- ๅ…ณ้”ฎ่ฏ: "explain", "learn", "tutorial", "beginner", "teaching", "education", "training" -- ไธŠไธ‹ๆ–‡: ๆ•™่‚ฒ่ฏทๆฑ‚ใ€ๆฆ‚ๅฟต่งฃ้‡Šใ€ๆŠ€่ƒฝๅผ€ๅ‘ใ€ๅญฆไน ่ทฏๅพ„ -- ๅคๆ‚ๆ€ง: ้œ€่ฆๅˆ†ๆญฅ้ชคๅˆ†่งฃๅ’Œๆธ่ฟ›็†่งฃ็š„ๅคๆ‚ไธป้ข˜ - -**่ƒฝๅŠ›**: -- ๅ…ทๆœ‰ๆธ่ฟ›ๆŠ€่ƒฝๅผ€ๅ‘็š„ๅญฆไน ่ทฏๅพ„่ฎพ่ฎก -- ้€š่ฟ‡็ฑปๆฏ”ๅ’Œ็คบไพ‹่ฟ›่กŒๅคๆ‚ๆฆ‚ๅฟต่งฃ้‡Š -- ๅ…ทๆœ‰ๅฎž่ทต็ปƒไน ็š„ไบคไบ’ๅผๆ•™็จ‹ๅˆ›ๅปบ -- ๆŠ€่ƒฝ่ฏ„ไผฐๅ’Œ่ƒฝๅŠ›่ฏ„ไผฐๆก†ๆžถ -- ๆŒ‡ๅฏผ็ญ–็•ฅๅ’Œไธชๆ€งๅŒ–ๅญฆไน ๆ–นๆณ• - -**็คบไพ‹**: -1. **็ผ–็จ‹ๆ•™็จ‹**: ๅ…ทๆœ‰ๅฎž่ทต็ปƒไน ใ€ไปฃ็ ็คบไพ‹ๅ’Œๆธ่ฟ›ๅคๆ‚ๆ€ง็š„ไบคไบ’ๅผ React ๆ•™็จ‹ -2. **ๆฆ‚ๅฟต่งฃ้‡Š**: ้€š่ฟ‡ๅฎž้™…็คบไพ‹ใ€่ง†่ง‰ๅ›พ่กจๅ’Œ็ปƒไน ่งฃ้‡Šๆ•ฐๆฎๅบ“่ง„่ŒƒๅŒ– -3. **ๆŠ€่ƒฝ่ฏ„ไผฐ**: ๅ…ทๆœ‰ๅฎž้™…้กน็›ฎๅ’Œๅ้ฆˆ็š„ๅ…จๆ ˆๅผ€ๅ‘็ปผๅˆ่ฏ„ไผฐๆก†ๆžถ - -**ๆœ€ไฝณๆญ้…**: technical-writer๏ผˆๆ•™่‚ฒๆ–‡ๆกฃ๏ผ‰ใ€frontend-architect๏ผˆไบคไบ’ๅญฆไน ๏ผ‰ใ€requirements-analyst๏ผˆๅญฆไน ็›ฎๆ ‡๏ผ‰ - ---- - -## ๆ™บ่ƒฝไฝ“ๅ่ฐƒไธŽ้›†ๆˆ ๐Ÿค - -### ๅ่ฐƒๆจกๅผ - -**ๆžถๆž„ๅ›ข้˜Ÿ**: -- **ๅ…จๆ ˆๅผ€ๅ‘**: frontend-architect + backend-architect + security-engineer + quality-engineer -- **็ณป็ปŸ่ฎพ่ฎก**: system-architect + devops-architect + performance-engineer + security-engineer -- **้—็•™็ŽฐไปฃๅŒ–**: refactoring-expert + system-architect + quality-engineer + technical-writer - -**่ดจ้‡ๅ›ข้˜Ÿ**: -- **ๅฎ‰ๅ…จๅฎก่ฎก**: security-engineer + quality-engineer + root-cause-analyst + requirements-analyst -- **ๆ€ง่ƒฝไผ˜ๅŒ–**: performance-engineer + system-architect + devops-architect + root-cause-analyst -- **ๆต‹่ฏ•็ญ–็•ฅ**: quality-engineer + security-engineer + performance-engineer + frontend-architect - -**ๆฒŸ้€šๅ›ข้˜Ÿ**: -- **ๆ–‡ๆกฃ้กน็›ฎ**: technical-writer + requirements-analyst + learning-guide + domain experts -- **ๅญฆไน ๅนณๅฐ**: learning-guide + frontend-architect + technical-writer + quality-engineer -- **API ๆ–‡ๆกฃ**: backend-architect + technical-writer + security-engineer + quality-engineer - -### MCP ๆœๅŠกๅ™จ้›†ๆˆ - -**้€š่ฟ‡ MCP ๆœๅŠกๅ™จๅขžๅผบ่ƒฝๅŠ›**: -- **Context7**: ไธบๆ‰€ๆœ‰ๆžถๆž„ๅธˆๅ’Œไธ“ๅฎถๆไพ›ๅฎ˜ๆ–นๆ–‡ๆกฃๆจกๅผ -- **Sequential**: ไธบ root-cause-analystใ€system-architectใ€performance-engineer ๆไพ›ๅคšๆญฅ้ชคๅˆ†ๆž -- **Magic**: ไธบ frontend-architect ๆไพ› UI ็”Ÿๆˆ๏ผŒไธบ learning-guide ๆไพ›ไบคไบ’ๅ†…ๅฎน -- **Playwright**: ไธบ quality-engineer ๆไพ›ๆต่งˆๅ™จๆต‹่ฏ•๏ผŒไธบ frontend-architect ๆไพ›ๆ— ้šœ็ข้ชŒ่ฏ -- **Morphllm**: ไธบ refactoring-expert ๆไพ›ไปฃ็ ่ฝฌๆข๏ผŒไธบ python-expert ๆไพ›ๆ‰น้‡ๆ›ดๆ”น -- **Serena**: ไธบๆ‰€ๆœ‰ๆ™บ่ƒฝไฝ“ๆไพ›้กน็›ฎๅ†…ๅญ˜๏ผŒๅœจไผš่ฏ้—ดไฟๆŒไธŠไธ‹ๆ–‡ - -### ๆ™บ่ƒฝไฝ“ๆฟ€ๆดปๆ•…้šœๆŽ’้™ค - -## ๆ•…้šœๆŽ’้™ค - -่Žทๅ–ๆ•…้šœๆŽ’้™คๅธฎๅŠฉ๏ผŒ่ฏทๅ‚้˜…๏ผš -- [ๅธธ่ง้—ฎ้ข˜](../Reference/common-issues.md) - ๅธธ่ง้—ฎ้ข˜็š„ๅฟซ้€Ÿไฟฎๅค -- [ๆ•…้šœๆŽ’้™คๆŒ‡ๅ—](../Reference/troubleshooting.md) - ็ปผๅˆ้—ฎ้ข˜่งฃๅ†ณ - -### ๅธธ่ง้—ฎ้ข˜ -- **ๆ— ๆ™บ่ƒฝไฝ“ๆฟ€ๆดป**: ไฝฟ็”จ้ข†ๅŸŸๅ…ณ้”ฎ่ฏ๏ผš"security"ใ€"performance"ใ€"frontend" -- **้€‰ๆ‹ฉไบ†้”™่ฏฏ็š„ๆ™บ่ƒฝไฝ“**: ๆฃ€ๆŸฅๆ™บ่ƒฝไฝ“ๆ–‡ๆกฃไธญ็š„่งฆๅ‘ๅ…ณ้”ฎ่ฏ -- **ๆ™บ่ƒฝไฝ“่ฟ‡ๅคš**: ๅฐ†ๅ…ณ้”ฎ่ฏ่š็„ฆๅœจไธป่ฆ้ข†ๅŸŸๆˆ–ไฝฟ็”จ `/sc:focus [้ข†ๅŸŸ]` -- **ๆ™บ่ƒฝไฝ“ไธๅ่ฐƒ**: ๅขžๅŠ ไปปๅŠกๅคๆ‚ๆ€งๆˆ–ไฝฟ็”จๅคš้ข†ๅŸŸๅ…ณ้”ฎ่ฏ -- **ๆ™บ่ƒฝไฝ“ไธ“ไธš็Ÿฅ่ฏ†ไธๅŒน้…**: ไฝฟ็”จๆ›ดๅ…ทไฝ“็š„ๆŠ€ๆœฏๆœฏ่ฏญ - -### ๅณๆ—ถไฟฎๅค -- **ๅผบๅˆถๆฟ€ๆดปๆ™บ่ƒฝไฝ“**: ๅœจ่ฏทๆฑ‚ไธญไฝฟ็”จๆ˜Ž็กฎ็š„้ข†ๅŸŸๅ…ณ้”ฎ่ฏ -- **้‡็ฝฎๆ™บ่ƒฝไฝ“้€‰ๆ‹ฉ**: ้‡ๅฏ Claude Code ไผš่ฏไปฅ้‡็ฝฎๆ™บ่ƒฝไฝ“็Šถๆ€ -- **ๆฃ€ๆŸฅๆ™บ่ƒฝไฝ“ๆจกๅผ**: ๆŸฅ็œ‹ๆ™บ่ƒฝไฝ“ๆ–‡ๆกฃไธญ็š„่งฆๅ‘ๅ…ณ้”ฎ่ฏ -- **ๆต‹่ฏ•ๅŸบๆœฌๆฟ€ๆดป**: ๅฐ่ฏ• `/sc:implement "security auth"` ๆต‹่ฏ• security-engineer - -### ็‰นๅฎšๆ™บ่ƒฝไฝ“ๆ•…้šœๆŽ’้™ค - -**ๆ— ๅฎ‰ๅ…จๆ™บ่ƒฝไฝ“๏ผš** -```bash -# ้—ฎ้ข˜๏ผšๅฎ‰ๅ…จ้—ฎ้ข˜ๆœช่งฆๅ‘ security-engineer -# ๅฟซ้€Ÿไฟฎๅค๏ผšไฝฟ็”จๆ˜Ž็กฎ็š„ๅฎ‰ๅ…จๅ…ณ้”ฎ่ฏ -"ๅฎž็Žฐ่บซไปฝ้ชŒ่ฏ" # ้€š็”จ - ๅฏ่ƒฝไธไผš่งฆๅ‘ -"ๅฎž็Žฐ JWT ่บซไปฝ้ชŒ่ฏๅฎ‰ๅ…จ" # ๆ˜Ž็กฎ - ่งฆๅ‘ security-engineer -"ไฝฟ็”จๅŠ ๅฏ†็š„ๅฎ‰ๅ…จ็”จๆˆท็™ปๅฝ•" # ๅฎ‰ๅ…จ่š็„ฆ - ่งฆๅ‘ security-engineer -``` - -**ๆ— ๆ€ง่ƒฝๆ™บ่ƒฝไฝ“๏ผš** -```bash -# ้—ฎ้ข˜๏ผšๆ€ง่ƒฝ้—ฎ้ข˜ๆœช่งฆๅ‘ performance-engineer -# ๅฟซ้€Ÿไฟฎๅค๏ผšไฝฟ็”จๆ€ง่ƒฝ็›ธๅ…ณๆœฏ่ฏญ -"่ฎฉๅฎƒๆ›ดๅฟซ" # ๆจก็ณŠ - ๅฏ่ƒฝไธไผš่งฆๅ‘ -"ไผ˜ๅŒ–็ผ“ๆ…ข็š„ๆ•ฐๆฎๅบ“ๆŸฅ่ฏข" # ๅ…ทไฝ“ - ่งฆๅ‘ performance-engineer -"ๅ‡ๅฐ‘ API ๅปถ่ฟŸๅ’Œ็“ถ้ขˆ" # ๆ€ง่ƒฝ่š็„ฆ - ่งฆๅ‘ performance-engineer -``` - -**ๆ— ๆžถๆž„ๆ™บ่ƒฝไฝ“๏ผš** -```bash -# ้—ฎ้ข˜๏ผš็ณป็ปŸ่ฎพ่ฎกๆœช่งฆๅ‘ๆžถๆž„ๆ™บ่ƒฝไฝ“ -# ๅฟซ้€Ÿไฟฎๅค๏ผšไฝฟ็”จๆžถๆž„ๅ…ณ้”ฎ่ฏ -"ๆž„ๅปบไธ€ไธชๅบ”็”จ" # ้€š็”จ - ่งฆๅ‘ๅŸบๆœฌๆ™บ่ƒฝไฝ“ -"่ฎพ่ฎกๅพฎๆœๅŠกๆžถๆž„" # ๅ…ทไฝ“ - ่งฆๅ‘ system-architect -"ๅฏๆ‰ฉๅฑ•็š„ๅˆ†ๅธƒๅผ็ณป็ปŸ่ฎพ่ฎก" # ๆžถๆž„่š็„ฆ - ่งฆๅ‘ system-architect -``` - -**้”™่ฏฏ็š„ๆ™บ่ƒฝไฝ“็ป„ๅˆ๏ผš** -```bash -# ้—ฎ้ข˜๏ผšๅœจๅŽ็ซฏไปปๅŠกไธญ่Žทๅพ—ๅ‰็ซฏๆ™บ่ƒฝไฝ“ -# ๅฟซ้€Ÿไฟฎๅค๏ผšไฝฟ็”จ้ข†ๅŸŸ็‰นๅฎšๆœฏ่ฏญ -"ๅˆ›ๅปบ็”จๆˆท็•Œ้ข" # ๅฏ่ƒฝ่งฆๅ‘ frontend-architect -"ๅˆ›ๅปบ REST API ็ซฏ็‚น" # ๅ…ทไฝ“ - ่งฆๅ‘ backend-architect -"ๅฎž็ŽฐๆœๅŠก็ซฏ่บซไปฝ้ชŒ่ฏ" # ๅŽ็ซฏ่š็„ฆ - ่งฆๅ‘ backend-architect -``` - -### ๆ”ฏๆŒ็บงๅˆซ - -**ๅฟซ้€Ÿไฟฎๅค๏ผš** -- ไปŽๆ™บ่ƒฝไฝ“่งฆๅ‘่กจไธญไฝฟ็”จๆ˜Ž็กฎ็š„้ข†ๅŸŸๅ…ณ้”ฎ่ฏ -- ๅฐ่ฏ•้‡ๅฏ Claude Code ไผš่ฏ -- ่š็„ฆๅœจๅ•ไธ€้ข†ๅŸŸไปฅ้ฟๅ…ๆททๆท† - -**่ฏฆ็ป†ๅธฎๅŠฉ๏ผš** -- ๆŸฅ็œ‹[ๅธธ่ง้—ฎ้ข˜ๆŒ‡ๅ—](../Reference/common-issues.md)ไบ†่งฃๆ™บ่ƒฝไฝ“ๅฎ‰่ฃ…้—ฎ้ข˜ -- ๆŸฅ็œ‹็›ฎๆ ‡ๆ™บ่ƒฝไฝ“็š„่งฆๅ‘ๅ…ณ้”ฎ่ฏ - -**ไธ“ๅฎถๆ”ฏๆŒ๏ผš** -- ไฝฟ็”จ `SuperClaude install --diagnose` -- ๆŸฅ็œ‹[่ฏŠๆ–ญๅ‚่€ƒๆŒ‡ๅ—](../Reference/diagnostic-reference.md)่ฟ›่กŒๅ่ฐƒๅˆ†ๆž - -**็คพๅŒบๆ”ฏๆŒ๏ผš** -- ๅœจ [GitHub Issues](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues) ๆŠฅๅ‘Š้—ฎ้ข˜ -- ๅŒ…ๆ‹ฌ้ข„ๆœŸไธŽๅฎž้™…ๆ™บ่ƒฝไฝ“ๆฟ€ๆดป็š„็คบไพ‹ - -### ๆˆๅŠŸ้ชŒ่ฏ - -ๅบ”็”จๆ™บ่ƒฝไฝ“ไฟฎๅคๅŽ๏ผŒ่ฏทๆต‹่ฏ•๏ผš -- [ ] ้ข†ๅŸŸ็‰นๅฎš่ฏทๆฑ‚ๆฟ€ๆดปๆญฃ็กฎ็š„ๆ™บ่ƒฝไฝ“๏ผˆsecurity โ†’ security-engineer๏ผ‰ -- [ ] ๅคๆ‚ไปปๅŠก่งฆๅ‘ๅคšๆ™บ่ƒฝไฝ“ๅ่ฐƒ๏ผˆ3+ ๆ™บ่ƒฝไฝ“๏ผ‰ -- [ ] ๆ™บ่ƒฝไฝ“ไธ“ไธš็Ÿฅ่ฏ†ๅŒน้…ไปปๅŠก้œ€ๆฑ‚๏ผˆAPI โ†’ backend-architect๏ผ‰ -- [ ] ่ดจ้‡ๆ™บ่ƒฝไฝ“ๅœจ้€‚ๅฝ“ๆ—ถ่‡ชๅŠจๅŒ…ๅซ๏ผˆๅฎ‰ๅ…จใ€ๆ€ง่ƒฝใ€ๆต‹่ฏ•๏ผ‰ -- [ ] ๅ“ๅบ”ๆ˜พ็คบ้ข†ๅŸŸไธ“ไธš็Ÿฅ่ฏ†ๅ’Œไธ“ไธšๅŒ–็Ÿฅ่ฏ† - -## ๅฟซ้€Ÿๆ•…้šœๆŽ’้™ค๏ผˆ้—็•™๏ผ‰ -- **ๆ— ๆ™บ่ƒฝไฝ“ๆฟ€ๆดป** โ†’ ไฝฟ็”จ้ข†ๅŸŸๅ…ณ้”ฎ่ฏ๏ผš"security"ใ€"performance"ใ€"frontend" -- **้”™่ฏฏ็š„ๆ™บ่ƒฝไฝ“** โ†’ ๆฃ€ๆŸฅๆ™บ่ƒฝไฝ“ๆ–‡ๆกฃไธญ็š„่งฆๅ‘ๅ…ณ้”ฎ่ฏ -- **ๆ™บ่ƒฝไฝ“่ฟ‡ๅคš** โ†’ ๅฐ†ๅ…ณ้”ฎ่ฏ่š็„ฆๅœจไธป่ฆ้ข†ๅŸŸ -- **ๆ™บ่ƒฝไฝ“ไธๅ่ฐƒ** โ†’ ๅขžๅŠ ไปปๅŠกๅคๆ‚ๆ€งๆˆ–ไฝฟ็”จๅคš้ข†ๅŸŸๅ…ณ้”ฎ่ฏ - -**ๆ™บ่ƒฝไฝ“ๆœชๆฟ€ๆดป๏ผŸ** -1. **ๆฃ€ๆŸฅๅ…ณ้”ฎ่ฏ**: ไฝฟ็”จ้ข†ๅŸŸ็‰นๅฎšๆœฏ่ฏญ๏ผˆไพ‹ๅฆ‚๏ผŒๅฏนไบŽ security-engineer ไฝฟ็”จ "authentication" ่€Œไธๆ˜ฏ "login"๏ผ‰ -2. **ๆทปๅŠ ไธŠไธ‹ๆ–‡**: ๅŒ…ๅซๆ–‡ไปถ็ฑปๅž‹ใ€ๆก†ๆžถๆˆ–็‰นๅฎšๆŠ€ๆœฏ -3. **ๅขžๅŠ ๅคๆ‚ๆ€ง**: ๅคš้ข†ๅŸŸ้—ฎ้ข˜ไผš่งฆๅ‘ๆ›ดๅคšๆ™บ่ƒฝไฝ“ -4. **ไฝฟ็”จ็คบไพ‹**: ๅผ•็”จไธŽๆ™บ่ƒฝไฝ“ไธ“ไธš็Ÿฅ่ฏ†ๅŒน้…็š„ๅ…ทไฝ“ๅœบๆ™ฏ - -**ๆ™บ่ƒฝไฝ“่ฟ‡ๅคš๏ผŸ** -- ๅฐ†ๅ…ณ้”ฎ่ฏ่š็„ฆๅœจไธป่ฆ้ข†ๅŸŸ้œ€ๆฑ‚ไธŠ -- ไฝฟ็”จ `/sc:focus [้ข†ๅŸŸ]` ้™ๅˆถ่Œƒๅ›ด -- ไปŽ็‰นๅฎšๆ™บ่ƒฝไฝ“ๅผ€ๅง‹๏ผŒๆŒ‰้œ€ๆ‰ฉๅฑ• - -**้”™่ฏฏ็š„ๆ™บ่ƒฝไฝ“๏ผŸ** -- ๆŸฅ็œ‹ๆ™บ่ƒฝไฝ“ๆ–‡ๆกฃไธญ็š„่งฆๅ‘ๅ…ณ้”ฎ่ฏ -- ไธบ็›ฎๆ ‡้ข†ๅŸŸไฝฟ็”จๆ›ดๅ…ทไฝ“็š„ๆœฏ่ฏญ -- ๆทปๅŠ ๆ˜Ž็กฎ็š„้œ€ๆฑ‚ๆˆ–็บฆๆŸ - -## ๅฟซ้€Ÿๅ‚่€ƒ ๐Ÿ“‹ - -### ๆ™บ่ƒฝไฝ“่งฆๅ‘ๆŸฅๆ‰พ - -| ่งฆๅ‘็ฑปๅž‹ | ๅ…ณ้”ฎ่ฏ/ๆจกๅผ | ๆฟ€ๆดป็š„ๆ™บ่ƒฝไฝ“ | -|-------------|-------------------|------------------| -| **ๅฎ‰ๅ…จ** | "auth", "security", "vulnerability", "encryption" | security-engineer | -| **ๆ€ง่ƒฝ** | "slow", "optimization", "bottleneck", "latency" | performance-engineer | -| **ๅ‰็ซฏ** | "UI", "React", "Vue", "component", "responsive" | frontend-architect | -| **ๅŽ็ซฏ** | "API", "server", "database", "REST", "GraphQL" | backend-architect | -| **ๆต‹่ฏ•** | "test", "QA", "validation", "coverage" | quality-engineer | -| **DevOps** | "deploy", "CI/CD", "Docker", "Kubernetes" | devops-architect | -| **ๆžถๆž„** | "architecture", "microservices", "scalability" | system-architect | -| **Python** | ".py", "Django", "FastAPI", "asyncio" | python-expert | -| **้—ฎ้ข˜** | "bug", "issue", "debugging", "troubleshoot" | root-cause-analyst | -| **ไปฃ็ ่ดจ้‡** | "refactor", "clean code", "technical debt" | refactoring-expert | -| **ๆ–‡ๆกฃ** | "documentation", "readme", "API docs" | technical-writer | -| **ๅญฆไน ** | "explain", "tutorial", "beginner", "teaching" | learning-guide | -| **้œ€ๆฑ‚** | "requirements", "PRD", "specification" | requirements-analyst | - -### ๅ‘ฝไปค-ๆ™บ่ƒฝไฝ“ๆ˜ ๅฐ„ - -| ๅ‘ฝไปค | ไธป่ฆๆ™บ่ƒฝไฝ“ | ๆ”ฏๆŒๆ™บ่ƒฝไฝ“ | -|---------|----------------|-------------------| -| `/sc:implement` | Domain architects (frontend, backend) | security-engineer, quality-engineer | -| `/sc:analyze` | quality-engineer, security-engineer | performance-engineer, root-cause-analyst | -| `/sc:troubleshoot` | root-cause-analyst | Domain specialists, performance-engineer | -| `/sc:improve` | refactoring-expert | quality-engineer, performance-engineer | -| `/sc:document` | technical-writer | Domain specialists, learning-guide | -| `/sc:design` | system-architect | Domain architects, requirements-analyst | -| `/sc:test` | quality-engineer | security-engineer, performance-engineer | -| `/sc:explain` | learning-guide | technical-writer, domain specialists | - -### ๆœ‰ๆ•ˆ็š„ๆ™บ่ƒฝไฝ“็ป„ๅˆ - -**ๅผ€ๅ‘ๅทฅไฝœๆต**: -- Web ๅบ”็”จ: frontend-architect + backend-architect + security-engineer + quality-engineer + devops-architect -- API ๅผ€ๅ‘: backend-architect + security-engineer + technical-writer + quality-engineer -- ๆ•ฐๆฎๅนณๅฐ: python-expert + performance-engineer + security-engineer + system-architect - -**ๅˆ†ๆžๅทฅไฝœๆต**: -- ๅฎ‰ๅ…จๅฎก่ฎก: security-engineer + quality-engineer + root-cause-analyst + technical-writer -- ๆ€ง่ƒฝ่ฐƒๆŸฅ: performance-engineer + root-cause-analyst + system-architect + devops-architect -- ้—็•™่ฏ„ไผฐ: refactoring-expert + system-architect + quality-engineer + security-engineer + technical-writer - -**ๆฒŸ้€šๅทฅไฝœๆต**: -- ๆŠ€ๆœฏๆ–‡ๆกฃ: technical-writer + requirements-analyst + domain experts + learning-guide -- ๆ•™่‚ฒๅ†…ๅฎน: learning-guide + technical-writer + frontend-architect + quality-engineer - -## ๆœ€ไฝณๅฎž่ทต ๐Ÿ’ก - -### ๅ…ฅ้—จ๏ผˆ็ฎ€ๅ•ๆ–นๆณ•๏ผ‰ - -**่‡ช็„ถ่ฏญ่จ€ไผ˜ๅ…ˆ๏ผš** -1. **ๆ่ฟฐ็›ฎๆ ‡**: ไฝฟ็”จๅŒ…ๅซ้ข†ๅŸŸ็‰นๅฎšๅ…ณ้”ฎ่ฏ็š„่‡ช็„ถ่ฏญ่จ€ -2. **ไฟกไปป่‡ชๅŠจๆฟ€ๆดป**: ่ฎฉ็ณป็ปŸ่‡ชๅŠจ่ทฏ็”ฑๅˆฐ้€‚ๅฝ“็š„ๆ™บ่ƒฝไฝ“ -3. **ไปŽๆจกๅผไธญๅญฆไน **: ่ง‚ๅฏŸไธๅŒ่ฏทๆฑ‚็ฑปๅž‹ๆฟ€ๆดป็š„ๆ™บ่ƒฝไฝ“ -4. **่ฟญไปฃๅ’Œไผ˜ๅŒ–**: ๆทปๅŠ ๅ…ทไฝ“ๆ€งไปฅๅธๅผ•้ขๅค–็š„ไธ“ๅฎถๆ™บ่ƒฝไฝ“ - -### ไผ˜ๅŒ–ๆ™บ่ƒฝไฝ“้€‰ๆ‹ฉ - -**ๆœ‰ๆ•ˆ็š„ๅ…ณ้”ฎ่ฏไฝฟ็”จ๏ผš** -- **ๅ…ทไฝ“ > ้€š็”จ**: ๅฏนไบŽ security-engineer ไฝฟ็”จ "authentication" ่€Œไธๆ˜ฏ "login" -- **ๆŠ€ๆœฏๆœฏ่ฏญ**: ๅŒ…ๅซๆก†ๆžถๅ็งฐใ€ๆŠ€ๆœฏๅ’Œๅ…ทไฝ“ๆŒ‘ๆˆ˜ -- **ไธŠไธ‹ๆ–‡็บฟ็ดข**: ๆๅŠๆ–‡ไปถ็ฑปๅž‹ใ€้กน็›ฎ่Œƒๅ›ดๅ’Œๅคๆ‚ๆ€งๆŒ‡ๆ ‡ -- **่ดจ้‡ๅ…ณ้”ฎ่ฏ**: ๆทปๅŠ  "security"ใ€"performance"ใ€"accessibility" ไปฅๅฎž็Žฐๅ…จ้ข่ฆ†็›– - -**่ฏทๆฑ‚ไผ˜ๅŒ–็คบไพ‹๏ผš** -```bash -# ้€š็”จ๏ผˆๆœ‰้™็š„ๆ™บ่ƒฝไฝ“ๆฟ€ๆดป๏ผ‰ -"ไฟฎๅค็™ปๅฝ•ๅŠŸ่ƒฝ" - -# ไผ˜ๅŒ–๏ผˆๅคšๆ™บ่ƒฝไฝ“ๅ่ฐƒ๏ผ‰ -"ๅฎž็Žฐๅ…ทๆœ‰้€Ÿ็Ž‡้™ๅˆถๅ’Œๆ— ้šœ็ขๅˆ่ง„็š„ๅฎ‰ๅ…จ JWT ่บซไปฝ้ชŒ่ฏ" -# โ†’ ่งฆๅ‘: security-engineer + backend-architect + frontend-architect + quality-engineer -``` - -### ๅธธ่ง็”จๆณ•ๆจกๅผ - -**ๅผ€ๅ‘ๅทฅไฝœๆต๏ผš** -```bash -# ๅ…จๆ ˆๅŠŸ่ƒฝๅผ€ๅ‘ -/sc:implement "ๅ…ทๆœ‰ๅฎžๆ—ถ้€š็Ÿฅ็š„ๅ“ๅบ”ๅผ็”จๆˆทไปช่กจๆฟ" -# โ†’ frontend-architect + backend-architect + performance-engineer - -# ๅธฆๆ–‡ๆกฃ็š„ API ๅผ€ๅ‘ -/sc:create "ๅธฆๆœ‰็ปผๅˆๆ–‡ๆกฃ็š„ๆ”ฏไป˜ๅค„็† REST API" -# โ†’ backend-architect + security-engineer + technical-writer + quality-engineer - -# ๆ€ง่ƒฝไผ˜ๅŒ–่ฐƒๆŸฅ -/sc:troubleshoot "ๅฝฑๅ“็”จๆˆทไฝ“้ชŒ็š„ๆ•ฐๆฎๅบ“ๆŸฅ่ฏข็ผ“ๆ…ข" -# โ†’ performance-engineer + root-cause-analyst + backend-architect -``` - -**ๅˆ†ๆžๅทฅไฝœๆต๏ผš** -```bash -# ๅฎ‰ๅ…จ่ฏ„ไผฐ -/sc:analyze "่บซไปฝ้ชŒ่ฏ็ณป็ปŸ็š„ GDPR ๅˆ่ง„ๆผๆดž" -# โ†’ security-engineer + quality-engineer + requirements-analyst - -# ไปฃ็ ่ดจ้‡ๅฎกๆŸฅ -/sc:review "้—็•™ไปฃ็ ๅบ“็š„็ŽฐไปฃๅŒ–ๆœบไผš" -# โ†’ refactoring-expert + system-architect + quality-engineer + technical-writer - -# ๅญฆไน ๅ’Œ่งฃ้‡Š -/sc:explain "ๅธฆๅฎž่ทต็คบไพ‹็š„ๅพฎๆœๅŠกๆจกๅผ" -# โ†’ system-architect + learning-guide + technical-writer -``` - -### ้ซ˜็บงๆ™บ่ƒฝไฝ“ๅ่ฐƒ - -**ๅคš้ข†ๅŸŸ้กน็›ฎ๏ผš** -- **ไปŽๅนฟๆณ›ๅผ€ๅง‹**: ไปŽ็ณป็ปŸ็บงๅ…ณ้”ฎ่ฏๅผ€ๅง‹ไปฅๅธๅผ•ๆžถๆž„ๆ™บ่ƒฝไฝ“ -- **ๆทปๅŠ ๅ…ทไฝ“ๆ€ง**: ๅŒ…ๅซ้ข†ๅŸŸ็‰นๅฎš้œ€ๆฑ‚ไปฅๆฟ€ๆดปไธ“ๅฎถๆ™บ่ƒฝไฝ“ -- **่ดจ้‡้›†ๆˆ**: ่‡ชๅŠจๅŒ…ๅซๅฎ‰ๅ…จใ€ๆ€ง่ƒฝๅ’Œๆต‹่ฏ•่ง†่ง’ -- **ๆ–‡ๆกฃๅŒ…ๅซ**: ๆทปๅŠ ๅญฆไน ๆˆ–ๆ–‡ๆกฃ้œ€ๆฑ‚ไปฅๅฎž็Žฐๅ…จ้ข่ฆ†็›– - -**ๆ™บ่ƒฝไฝ“้€‰ๆ‹ฉๆ•…้šœๆŽ’้™ค๏ผš** - -**้—ฎ้ข˜๏ผš้”™่ฏฏ็š„ๆ™บ่ƒฝไฝ“ๆฟ€ๆดป** -- ่งฃๅ†ณๆ–นๆกˆ๏ผšไฝฟ็”จๆ›ดๅ…ทไฝ“็š„้ข†ๅŸŸๆœฏ่ฏญ -- ็คบไพ‹๏ผš"ๆ•ฐๆฎๅบ“ไผ˜ๅŒ–" โ†’ performance-engineer + backend-architect - -**้—ฎ้ข˜๏ผšๆ™บ่ƒฝไฝ“ไธๅคŸ** -- ่งฃๅ†ณๆ–นๆกˆ๏ผšๅขžๅŠ ๅคๆ‚ๆ€งๆŒ‡ๆ ‡ๅ’Œ่ทจ้ข†ๅŸŸๅ…ณ้”ฎ่ฏ -- ็คบไพ‹๏ผšๅ‘่ฏทๆฑ‚ๆทปๅŠ  "security"ใ€"performance"ใ€"documentation" - -**้—ฎ้ข˜๏ผšๆ™บ่ƒฝไฝ“่ฟ‡ๅคš** -- ่งฃๅ†ณๆ–นๆกˆ๏ผšไฝฟ็”จๅ…ทไฝ“ๆŠ€ๆœฏๆœฏ่ฏญ่š็„ฆไบŽไธป่ฆ้ข†ๅŸŸ -- ็คบไพ‹๏ผšไฝฟ็”จ "/sc:focus backend" ๆฅ้™ๅˆถ่Œƒๅ›ด - -### ่ดจ้‡้ฉฑๅŠจๅผ€ๅ‘ - -**ๅฎ‰ๅ…จไผ˜ๅ…ˆๆ–นๆณ•๏ผš** -ๅง‹็ปˆๅœจๅผ€ๅ‘่ฏทๆฑ‚ไธญๅŒ…ๅซๅฎ‰ๅ…จ่€ƒ่™‘๏ผŒไปฅๅœจ้ข†ๅŸŸไธ“ๅฎถไน‹ๅค–่‡ชๅŠจๅธๅผ• security-engineerใ€‚ - -**ๆ€ง่ƒฝ้›†ๆˆ๏ผš** -ๅŒ…ๅซๆ€ง่ƒฝๅ…ณ้”ฎ่ฏ๏ผˆ"fast"ใ€"efficient"ใ€"scalable"๏ผ‰ไปฅ็กฎไฟไปŽไธ€ๅผ€ๅง‹ๅฐฑๆœ‰ performance-engineer ็š„ๅ่ฐƒใ€‚ - -**ๆ— ้šœ็ขๅˆ่ง„๏ผš** -ไฝฟ็”จ "accessible"ใ€"WCAG" ๆˆ– "inclusive" ๅœจๅ‰็ซฏๅผ€ๅ‘ไธญ่‡ชๅŠจๅŒ…ๅซๆ— ้šœ็ข้ชŒ่ฏใ€‚ - -**ๆ–‡ๆกฃๆ–‡ๅŒ–๏ผš** -ๅ‘่ฏทๆฑ‚ๆทปๅŠ  "documented"ใ€"explained" ๆˆ– "tutorial" ไปฅ่‡ชๅŠจๅŒ…ๅซ technical-writer ๅ’Œ็Ÿฅ่ฏ†่ฝฌ็งปใ€‚ - ---- - -## ็†่งฃๆ™บ่ƒฝไฝ“ๆ™บ่ƒฝ ๐Ÿง  - -### ไฝฟๆ™บ่ƒฝไฝ“้ซ˜ๆ•ˆ็š„ๅ› ็ด  - -**้ข†ๅŸŸไธ“ไธš็Ÿฅ่ฏ†**: ๆฏไธชๆ™บ่ƒฝไฝ“้ƒฝๅ…ทๆœ‰ไธ“ไธš็Ÿฅ่ฏ†ๆจกๅผใ€่กŒไธบๆ–นๆณ•ๅ’Œ้’ˆๅฏนๅ…ถ้ข†ๅŸŸ็š„้—ฎ้ข˜่งฃๅ†ณๆ–นๆณ•ใ€‚ - -**ไธŠไธ‹ๆ–‡ๆฟ€ๆดป**: ๆ™บ่ƒฝไฝ“ๅˆ†ๆž่ฏทๆฑ‚ไธŠไธ‹ๆ–‡๏ผŒ่€Œไธไป…ไป…ๆ˜ฏๅ…ณ้”ฎ่ฏ๏ผŒไปฅ็กฎๅฎš็›ธๅ…ณๆ€งๅ’Œๅ‚ไธŽ็จ‹ๅบฆใ€‚ - -**ๅไฝœๆ™บ่ƒฝ**: ๅคšๆ™บ่ƒฝไฝ“ๅ่ฐƒไบง็”Ÿ็š„ๅๅŒ็ป“ๆžœ่ถ…่ถŠไบ†ๅ•ไธชๆ™บ่ƒฝไฝ“็š„่ƒฝๅŠ›ใ€‚ - -**่‡ช้€‚ๅบ”ๅญฆไน **: ๆ™บ่ƒฝไฝ“้€‰ๆ‹ฉๆ นๆฎ่ฏทๆฑ‚ๆจกๅผๅ’ŒๆˆๅŠŸ็š„ๅ่ฐƒ็ป“ๆžœไธๆ–ญๆ”น่ฟ›ใ€‚ - -### ๆ™บ่ƒฝไฝ“ไธŽไผ ็ปŸ AI - -**ไผ ็ปŸๆ–นๆณ•**: ๅ•ไธช AI ไปฅไธๅŒ็š„ไธ“ไธš็Ÿฅ่ฏ†ๆฐดๅนณๅค„็†ๆ‰€ๆœ‰้ข†ๅŸŸ -**ๆ™บ่ƒฝไฝ“ๆ–นๆณ•**: ไธ“ไธšไธ“ๅฎถไปฅๆทฑๅบฆ้ข†ๅŸŸ็Ÿฅ่ฏ†ๅ’Œ่š็„ฆ้—ฎ้ข˜่งฃๅ†ณ่ฟ›่กŒๅไฝœ - -**ไผ˜็‚น**: -- ๅœจ้ข†ๅŸŸ็‰นๅฎšไปปๅŠกไธญๆ›ด้ซ˜็š„ๅ‡†็กฎๆ€ง -- ๆ›ดๅคๆ‚็š„้—ฎ้ข˜่งฃๅ†ณๆ–นๆณ• -- ้€š่ฟ‡ไธ“ๅฎถๅฎกๆŸฅๅฎž็Žฐๆ›ดๅฅฝ็š„่ดจ้‡ไฟ่ฏ -- ๅ่ฐƒ็š„ๅคš่ง†่ง’ๅˆ†ๆž - -### ไฟกไปป็ณป็ปŸ๏ผŒ็†่งฃๆจกๅผ - -**ๆœŸๆœ›ไป€ไนˆ**: -- ่‡ชๅŠจ่ทฏ็”ฑๅˆฐ้€‚ๅฝ“็š„้ข†ๅŸŸไธ“ๅฎถ -- ๅคๆ‚ไปปๅŠก็š„ๅคšๆ™บ่ƒฝไฝ“ๅ่ฐƒ -- ้€š่ฟ‡่‡ชๅŠจๅŒ…ๅซ QA ๆ™บ่ƒฝไฝ“ๅฎž็Žฐ่ดจ้‡้›†ๆˆ -- ้€š่ฟ‡ๆ•™่‚ฒๆ™บ่ƒฝไฝ“ๆฟ€ๆดป็š„ๅญฆไน ๆœบไผš - -**ไธ็”จๆ‹…ๅฟƒไป€ไนˆ**: -- ๆ‰‹ๅŠจ้€‰ๆ‹ฉๆˆ–้…็ฝฎๆ™บ่ƒฝไฝ“ -- ๅคๆ‚็š„่ทฏ็”ฑ่ง„ๅˆ™ๆˆ–ๆ™บ่ƒฝไฝ“็ฎก็† -- ๆ™บ่ƒฝไฝ“้…็ฝฎๆˆ–ๅ่ฐƒ -- ๅพฎ็ฎก็†ๆ™บ่ƒฝไฝ“ไบคไบ’ - ---- - -## ็›ธๅ…ณ่ต„ๆบ ๐Ÿ“š - -### ๅŸบๆœฌๆ–‡ๆกฃ -- **[ๅ‘ฝไปคๆŒ‡ๅ—](commands.md)** - ๆŽŒๆก่งฆๅ‘ๆœ€ไผ˜ๆ™บ่ƒฝไฝ“ๅ่ฐƒ็š„ SuperClaude ๅ‘ฝไปค -- **[MCP ๆœๅŠกๅ™จ](mcp-servers.md)** - ้€š่ฟ‡ไธ“ไธšๅŒ–ๅทฅๅ…ท้›†ๆˆๅขžๅผบๆ™บ่ƒฝไฝ“่ƒฝๅŠ› -- **[ไผš่ฏ็ฎก็†](session-management.md)** - ๅ…ทๆœ‰ๆŒไน…ๆ™บ่ƒฝไฝ“ไธŠไธ‹ๆ–‡็š„้•ฟๆœŸๅทฅไฝœๆต - -### ้ซ˜็บง็”จๆณ• -- **[่กŒไธบๆจกๅผ](modes.md)** - ็”จไบŽๅขžๅผบๆ™บ่ƒฝไฝ“ๅ่ฐƒ็š„ไธŠไธ‹ๆ–‡ไผ˜ๅŒ– -- **[ๅ…ฅ้—จๆŒ‡ๅ—](../Getting-Started/quick-start.md)** - ๆ™บ่ƒฝไฝ“ไผ˜ๅŒ–็š„ไธ“ๅฎถๆŠ€ๅทง -- **[็คบไพ‹้ฃŸ่ฐฑ](../Reference/examples-cookbook.md)** - ๅฎž้™…็š„ๆ™บ่ƒฝไฝ“ๅ่ฐƒๆจกๅผ - -### ๅผ€ๅ‘่ต„ๆบ -- **[ๆŠ€ๆœฏๆžถๆž„](../Developer-Guide/technical-architecture.md)** - ็†่งฃ SuperClaude ็š„ๆ™บ่ƒฝไฝ“็ณป็ปŸ่ฎพ่ฎก -- **[่ดก็ŒฎๆŒ‡ๅ—](../Developer-Guide/contributing-code.md)** - ๆ‰ฉๅฑ•ๆ™บ่ƒฝไฝ“่ƒฝๅŠ›ๅ’Œๅ่ฐƒๆจกๅผ - ---- - -## ๆ‚จ็š„ๆ™บ่ƒฝไฝ“ไน‹ๆ—… ๐Ÿš€ - -**็ฌฌ 1 ๅ‘จ๏ผš่‡ช็„ถไฝฟ็”จ** -ไปŽ่‡ช็„ถ่ฏญ่จ€ๆ่ฟฐๅผ€ๅง‹ใ€‚ๆณจๆ„ๅ“ชไบ›ๆ™บ่ƒฝไฝ“ไผšๆฟ€ๆดปไปฅๅŠๅŽŸๅ› ใ€‚ๅœจไธ่ฟ‡ๅบฆๆ€่€ƒ่ฟ‡็จ‹็š„ๆƒ…ๅ†ตไธ‹ๅปบ็ซ‹ๅฏนๅ…ณ้”ฎ่ฏๆจกๅผ็š„็›ด่ง‰ใ€‚ - -**็ฌฌ 2-3 ๅ‘จ๏ผšๆจกๅผ่ฏ†ๅˆซ** -่ง‚ๅฏŸๆ™บ่ƒฝไฝ“ๅ่ฐƒๆจกๅผใ€‚็†่งฃๅคๆ‚ๆ€งๅ’Œ้ข†ๅŸŸๅ…ณ้”ฎ่ฏๅฆ‚ไฝ•ๅฝฑๅ“ๆ™บ่ƒฝไฝ“้€‰ๆ‹ฉใ€‚ๅผ€ๅง‹ไผ˜ๅŒ–่ฏทๆฑ‚ๆŽช่พžไปฅๅฎž็Žฐๆ›ดๅฅฝ็š„ๅ่ฐƒใ€‚ - -**็ฌฌ 2 ไธชๆœˆ+๏ผšไธ“ๅฎถๅ่ฐƒ** -ๆŽŒๆก่งฆๅ‘ๆœ€ไผ˜ๆ™บ่ƒฝไฝ“็ป„ๅˆ็š„ๅคš้ข†ๅŸŸ่ฏทๆฑ‚ใ€‚ๅˆฉ็”จๆ•…้šœๆŽ’้™คๆŠ€ๅทง่ฟ›่กŒๆœ‰ๆ•ˆ็š„ๆ™บ่ƒฝไฝ“้€‰ๆ‹ฉใ€‚ไฝฟ็”จ้ซ˜็บงๆจกๅผๅค„็†ๅคๆ‚ๅทฅไฝœๆตใ€‚ - -**SuperClaude ไผ˜ๅŠฟ๏ผš** -ไฝ“้ชŒ 14 ไธชไธ“ไธš AI ไธ“ๅฎถๅ่ฐƒๅ“ๅบ”็š„ๅจๅŠ›๏ผŒๆ‰€ๆœ‰่ฟ™ไธ€ๅˆ‡้ƒฝ้€š่ฟ‡็ฎ€ๅ•็š„่‡ช็„ถ่ฏญ่จ€่ฏทๆฑ‚ๅฎž็Žฐใ€‚ๆ— ้œ€้…็ฝฎ๏ผŒๆ— ้œ€็ฎก็†๏ผŒๅชๆœ‰้šๆ‚จ็š„้œ€ๆฑ‚่€Œๆ‰ฉๅฑ•็š„ๆ™บ่ƒฝๅไฝœใ€‚ - -๐ŸŽฏ **ๅ‡†ๅค‡ไฝ“้ชŒๆ™บ่ƒฝๆ™บ่ƒฝไฝ“ๅ่ฐƒ๏ผŸไปŽ `/sc:implement` ๅผ€ๅง‹๏ผŒๅ‘็Žฐไธ“ไธš AI ๅไฝœ็š„้ญ”ๅŠ›ใ€‚** \ No newline at end of file diff --git a/docs/User-Guide-zh/commands.md b/docs/User-Guide-zh/commands.md deleted file mode 100644 index b45261b..0000000 --- a/docs/User-Guide-zh/commands.md +++ /dev/null @@ -1,305 +0,0 @@ -# SuperClaude ๅ‘ฝไปคๆŒ‡ๅ— - -SuperClaude ไธบ Claude Code ๆไพ› 21 ไธชๅ‘ฝไปค๏ผš็”จไบŽๅทฅไฝœๆต็š„ `/sc:*` ๅ‘ฝไปคๅ’Œ็”จไบŽไธ“ๅฎถ็š„ `@agent-*`ใ€‚ - -## ๅ‘ฝไปค็ฑปๅž‹ - -| ็ฑปๅž‹ | ไฝฟ็”จไฝ็ฝฎ | ๆ ผๅผ | ็คบไพ‹ | -|------|------------|--------|---------| -| **ๆ–œๆ ๅ‘ฝไปค** | Claude Code | `/sc:[command]` | `/sc:implement "feature"` | -| **ๆ™บ่ƒฝไฝ“** | Claude Code | `@agent-[name]` | `@agent-security "review"` | -| **ๅฎ‰่ฃ…ๅ‘ฝไปค** | ็ปˆ็ซฏ | `SuperClaude [command]` | `SuperClaude install` | - -## ๅฟซ้€Ÿๆต‹่ฏ• -```bash -# ็ปˆ็ซฏ๏ผš้ชŒ่ฏๅฎ‰่ฃ… -python3 -m SuperClaude --version -# Claude Code CLI ้ชŒ่ฏ๏ผšclaude --version - -# Claude Code๏ผšๆต‹่ฏ•ๅ‘ฝไปค -/sc:brainstorm "test project" # ๅบ”่ฏฅ่ฏข้—ฎๅ‘็Žฐๆ€ง้—ฎ้ข˜ -/sc:analyze README.md # ๅบ”่ฏฅๆไพ›ๅˆ†ๆž -``` - -**ๅทฅไฝœๆต**๏ผš`/sc:brainstorm "idea"` โ†’ `/sc:implement "feature"` โ†’ `/sc:test` - -## ๐ŸŽฏ ็†่งฃ SuperClaude ๅ‘ฝไปค - -## SuperClaude ๅฆ‚ไฝ•ๅทฅไฝœ - -SuperClaude ๆไพ›่กŒไธบไธŠไธ‹ๆ–‡ๆ–‡ไปถ๏ผŒClaude Code ้€š่ฟ‡่ฏปๅ–่ฟ™ไบ›ๆ–‡ไปถๆฅ้‡‡็”จไธ“้—จ็š„่กŒไธบใ€‚ๅฝ“ๆ‚จ้”ฎๅ…ฅ `/sc:implement` ๆ—ถ๏ผŒClaude Code ่ฏปๅ– `implement.md` ไธŠไธ‹ๆ–‡ๆ–‡ไปถๅนถ้ตๅพชๅ…ถ่กŒไธบๆŒ‡ไปคใ€‚ - -**SuperClaude ๅ‘ฝไปคไธๆ˜ฏ็”ฑ่ฝฏไปถๆ‰ง่กŒ็š„** - ๅฎƒไปฌๆ˜ฏไธŠไธ‹ๆ–‡่งฆๅ‘ๅ™จ๏ผŒ้€š่ฟ‡่ฏปๅ–ๆก†ๆžถไธญ็š„ไธ“้—จๆŒ‡ไปคๆ–‡ไปถๆฅไฟฎๆ”น Claude Code ็š„่กŒไธบใ€‚ - -### ๅ‘ฝไปค็ฑปๅž‹๏ผš -- **ๆ–œๆ ๅ‘ฝไปค** (`/sc:*`)๏ผš่งฆๅ‘ๅทฅไฝœๆตๆจกๅผๅ’Œ่กŒไธบๆจกๅผ -- **ๆ™บ่ƒฝไฝ“่ฐƒ็”จ** (`@agent-*`)๏ผšๆ‰‹ๅŠจๆฟ€ๆดป็‰นๅฎš้ข†ๅŸŸไธ“ๅฎถ -- **ๆ ‡ๅฟ—** (`--think`ใ€`--safe-mode`)๏ผšไฟฎๆ”นๅ‘ฝไปค่กŒไธบๅ’Œๆทฑๅบฆ - -### ไธŠไธ‹ๆ–‡ๆœบๅˆถ๏ผš -1. **็”จๆˆท่พ“ๅ…ฅ**๏ผšๆ‚จ่พ“ๅ…ฅ `/sc:implement "auth system"` -2. **ไธŠไธ‹ๆ–‡ๅŠ ่ฝฝ**๏ผšClaude Code ่ฏปๅ– `~/.claude/superclaude/Commands/implement.md` -3. **่กŒไธบ้‡‡็”จ**๏ผšClaude ่ฟ็”จไธ“ไธš็Ÿฅ่ฏ†่ฟ›่กŒๅทฅๅ…ท้€‰ๆ‹ฉๅ’Œ้ชŒ่ฏ -4. **ๅขžๅผบ่พ“ๅ‡บ**๏ผšๅธฆๆœ‰ๅฎ‰ๅ…จ่€ƒ่™‘ๅ’Œๆœ€ไฝณๅฎž่ทต็š„็ป“ๆž„ๅŒ–ๅฎž็Žฐ - -**ๅ…ณ้”ฎ่ฆ็‚น**๏ผš่ฟ™้€š่ฟ‡ไธŠไธ‹ๆ–‡็ฎก็†่€Œไธๆ˜ฏไผ ็ปŸ็š„่ฝฏไปถๆ‰ง่กŒๆฅๅˆ›ๅปบๅคๆ‚็š„ๅผ€ๅ‘ๅทฅไฝœๆตใ€‚ - -### ๅฎ‰่ฃ…ๅ‘ฝไปค vs ไฝฟ็”จๅ‘ฝไปค - -**๐Ÿ–ฅ๏ธ ็ปˆ็ซฏๅ‘ฝไปค** ๏ผˆๅฎž้™… CLI ่ฝฏไปถ๏ผ‰๏ผš -- `SuperClaude install` - ๅฎ‰่ฃ…ๆก†ๆžถ็ป„ไปถ -- `SuperClaude update` - ๆ›ดๆ–ฐ็Žฐๆœ‰ๅฎ‰่ฃ… -- `SuperClaude uninstall` - ๅธ่ฝฝๆก†ๆžถๅฎ‰่ฃ… -- `python3 -m SuperClaude --version` - ๆฃ€ๆŸฅๅฎ‰่ฃ…็Šถๆ€ - -**๐Ÿ’ฌ Claude Code ๅ‘ฝไปค** ๏ผˆไธŠไธ‹ๆ–‡่งฆๅ‘ๅ™จ๏ผ‰๏ผš -- `/sc:brainstorm` - ๆฟ€ๆดป้œ€ๆฑ‚ๅ‘็ŽฐไธŠไธ‹ๆ–‡ -- `/sc:implement` - ๆฟ€ๆดป็‰นๆ€งๅผ€ๅ‘ไธŠไธ‹ๆ–‡ -- `@agent-security` - ๆฟ€ๆดปๅฎ‰ๅ…จไธ“ๅฎถไธŠไธ‹ๆ–‡ -- ๆ‰€ๆœ‰ๅ‘ฝไปคไป…ๅœจ Claude Code ่Šๅคฉ็•Œ้ขไธญๅทฅไฝœ - - -> **ๅฟซ้€Ÿๅผ€ๅง‹**๏ผšๅฐ่ฏ• `/sc:brainstorm "your project idea"` โ†’ `/sc:implement "feature name"` โ†’ `/sc:test` ไฝ“้ชŒๆ ธๅฟƒๅทฅไฝœๆตใ€‚ - -## ๐Ÿงช Testing Your Setup - -### ๐Ÿ–ฅ๏ธ ็ปˆ็ซฏ้ชŒ่ฏ๏ผˆๅœจ็ปˆ็ซฏ/CMD ไธญ่ฟ่กŒ๏ผ‰ -```bash -# ้ชŒ่ฏ SuperClaude ๆ˜ฏๅฆๆญฃๅธธๅทฅไฝœ๏ผˆไธป่ฆๆ–นๆณ•๏ผ‰ -python3 -m SuperClaude --version -# ็คบไพ‹่พ“ๅ‡บ๏ผšSuperClaude 4.1.5 - -# Claude Code CLI ็‰ˆๆœฌๆฃ€ๆŸฅ -claude --version - -# ๆฃ€ๆŸฅๅทฒๅฎ‰่ฃ…็š„็ป„ไปถ -python3 -m SuperClaude install --list-components | grep mcp -# ็คบไพ‹่พ“ๅ‡บ๏ผšๆ˜พ็คบๅทฒๅฎ‰่ฃ…็š„ MCP ็ป„ไปถ -``` - -### ๐Ÿ’ฌ Claude Code ๆต‹่ฏ•๏ผˆๅœจ Claude Code ่Šๅคฉไธญ่พ“ๅ…ฅ๏ผ‰ -``` -# ๆต‹่ฏ•ๅŸบๆœฌ /sc: ๅ‘ฝไปค -/sc:brainstorm "test project" -# ็คบไพ‹่กŒไธบ๏ผšๅผ€ๅง‹ไบคไบ’ๅผ้œ€ๆฑ‚ๅ‘็Žฐ - -# ๆต‹่ฏ•ๅ‘ฝไปคๅธฎๅŠฉ -/sc:help -# ็คบไพ‹่กŒไธบ๏ผšๆ˜พ็คบๅฏ็”จๅ‘ฝไปคๅˆ—่กจ -``` - -**ๅฆ‚ๆžœๆต‹่ฏ•ๅคฑ่ดฅ**๏ผšๆฃ€ๆŸฅ [ๅฎ‰่ฃ…ๆŒ‡ๅ—](../Getting-Started/installation.md) ๆˆ– [ๆ•…้šœๆŽ’้™ค](#troubleshooting) - -### ๐Ÿ“ Command Quick Reference - -| Command Type | Where to Run | Format | Purpose | Example | -|-------------|--------------|--------|---------|----------| -| **๐Ÿ–ฅ๏ธ ๅฎ‰่ฃ…** | ็ปˆ็ซฏ/CMD | `SuperClaude [command]` | ่ฎพ็ฝฎๅ’Œ็ปดๆŠค | `SuperClaude install` | -| **๐Ÿ”ง ้…็ฝฎ** | ็ปˆ็ซฏ/CMD | `python3 -m SuperClaude [command]` | ้ซ˜็บง้…็ฝฎ | `python3 -m SuperClaude --version` | -| **๐Ÿ’ฌ ๆ–œๆ ๅ‘ฝไปค** | Claude Code | `/sc:[command]` | ๅทฅไฝœๆต่‡ชๅŠจๅŒ– | `/sc:implement "feature"` | -| **๐Ÿค– ๆ™บ่ƒฝไฝ“่ฐƒ็”จ** | Claude Code | `@agent-[name]` | ๆ‰‹ๅŠจไธ“ๅฎถๆฟ€ๆดป | `@agent-security "review"` | -| **โšก ๅขžๅผบๆ ‡ๅฟ—** | Claude Code | `/sc:[command] --flags` | ่กŒไธบไฟฎๆ”น | `/sc:analyze --think-hard` | - -> **่ฎฐไฝ**๏ผšๆ‰€ๆœ‰ `/sc:` ๅ‘ฝไปคๅ’Œ `@agent-` ่ฐƒ็”จ้ƒฝๅœจ Claude Code ่Šๅคฉไธญๅทฅไฝœ๏ผŒ่€Œไธๆ˜ฏๅœจๆ‚จ็š„็ปˆ็ซฏไธญใ€‚ๅฎƒไปฌ่งฆๅ‘ Claude Code ไปŽ SuperClaude ๆก†ๆžถไธญ่ฏปๅ–็‰นๅฎš็š„ไธŠไธ‹ๆ–‡ๆ–‡ไปถใ€‚ - -## ็›ฎๅฝ• - -- [ๅŸบๆœฌๅ‘ฝไปค](#essential-commands) - ไปŽ่ฟ™้‡Œๅผ€ๅง‹๏ผˆ8 ไธชๆ ธๅฟƒๅ‘ฝไปค๏ผ‰ -- [ๅธธ็”จๅทฅไฝœๆต](#common-workflows) - ๆœ‰ๆ•ˆ็š„ๅ‘ฝไปค็ป„ๅˆ -- [ๅฎŒๆ•ดๅ‘ฝไปคๅ‚่€ƒ](#full-command-reference) - ๆ‰€ๆœ‰ 21 ไธชๅ‘ฝไปคๆŒ‰็ฑปๅˆซ็ป„็ป‡ -- [ๆ•…้šœๆŽ’้™ค](#troubleshooting) - ๅธธ่ง้—ฎ้ข˜ๅ’Œ่งฃๅ†ณๆ–นๆกˆ -- [ๅ‘ฝไปค็ดขๅผ•](#command-index) - ๆŒ‰็ฑปๅˆซๆŸฅๆ‰พๅ‘ฝไปค - ---- - -## ๅŸบๆœฌๅ‘ฝไปค - -**็ซ‹ๅณๆ้ซ˜็”ŸไบงๅŠ›็š„ๆ ธๅฟƒๅทฅไฝœๆตๅ‘ฝไปค๏ผš** - -### `/sc:brainstorm` - ้กน็›ฎๅ‘็Žฐ -**็›ฎ็š„**๏ผšไบคไบ’ๅผ้œ€ๆฑ‚ๅ‘็Žฐๅ’Œ้กน็›ฎ่ง„ๅˆ’ -**่ฏญๆณ•**๏ผš`/sc:brainstorm "ๆ‚จ็š„ๆƒณๆณ•"` `[--strategy systematic|creative]` - -**ไฝฟ็”จๆกˆไพ‹**๏ผš -- ๆ–ฐ้กน็›ฎ่ง„ๅˆ’๏ผš`/sc:brainstorm "e-commerce platform"` -- ็‰นๆ€งๆŽข็ดข๏ผš`/sc:brainstorm "user authentication system"` -- ้—ฎ้ข˜่งฃๅ†ณ๏ผš`/sc:brainstorm "slow database queries"`` - -### `/sc:implement` - ๅŠŸ่ƒฝๅผ€ๅ‘ -**็›ฎ็š„**: ้€š่ฟ‡ๆ™บ่ƒฝไธ“ๅฎถ่ทฏ็”ฑ่ฟ›่กŒๅ…จๆ ˆๅŠŸ่ƒฝๅฎž็Žฐ -**่ฏญๆณ•**: `/sc:implement "feature description"` `[--type frontend|backend|fullstack] [--focus security|performance]` - -**ไฝฟ็”จๅœบๆ™ฏ**: -- ่บซไปฝ้ชŒ่ฏ: `/sc:implement "JWT login system"` -- UI ็ป„ไปถ: `/sc:implement "responsive dashboard"` -- APIs: `/sc:implement "REST user endpoints"` -- ๆ•ฐๆฎๅบ“: `/sc:implement "user schema with relationships"` - -### `/sc:analyze` - ไปฃ็ ่ฏ„ไผฐ -**็›ฎ็š„**: ่ทจ่ดจ้‡ใ€ๅฎ‰ๅ…จๆ€งๅ’Œๆ€ง่ƒฝ็š„็ปผๅˆไปฃ็ ๅˆ†ๆž -**่ฏญๆณ•**: `/sc:analyze [path]` `[--focus quality|security|performance|architecture]` - -**ไฝฟ็”จๅœบๆ™ฏ**: -- ้กน็›ฎๅฅๅบท: `/sc:analyze .` -- ๅฎ‰ๅ…จๅฎก่ฎก: `/sc:analyze --focus security` -- ๆ€ง่ƒฝ่ฏ„ๅฎก: `/sc:analyze --focus performance` - -### `/sc:troubleshoot` - ้—ฎ้ข˜่ฏŠๆ–ญ -**็›ฎ็š„**: ็ณป็ปŸๅŒ–้—ฎ้ข˜่ฏŠๆ–ญไธŽๆ นๆœฌๅŽŸๅ› ๅˆ†ๆž -**่ฏญๆณ•**: `/sc:troubleshoot "้—ฎ้ข˜ๆ่ฟฐ"` `[--type build|runtime|performance]` - -**ไฝฟ็”จๅœบๆ™ฏ**: -- ่ฟ่กŒๆ—ถ้”™่ฏฏ: `/sc:troubleshoot "็™ปๅฝ•ๆ—ถๅ‡บ็Žฐ500้”™่ฏฏ"` -- ๆž„ๅปบๅคฑ่ดฅ: `/sc:troubleshoot --type build` -- ๆ€ง่ƒฝ้—ฎ้ข˜: `/sc:troubleshoot "้กต้ขๅŠ ่ฝฝ็ผ“ๆ…ข"` - -### `/sc:test` - ่ดจ้‡ไฟ่ฏ -**็›ฎ็š„**: ๅ…จ้ขๆต‹่ฏ•ไธŽ่ฆ†็›–็Ž‡ๅˆ†ๆž -**่ฏญๆณ•**: `/sc:test` `[--type unit|integration|e2e] [--coverage] [--fix]` - -**ไฝฟ็”จๅœบๆ™ฏ**: -- ๅฎŒๆ•ดๆต‹่ฏ•ๅฅ—ไปถ: `/sc:test --coverage` -- ๅ•ๅ…ƒๆต‹่ฏ•: `/sc:test --type unit --watch` -- ็ซฏๅˆฐ็ซฏ้ชŒ่ฏ: `/sc:test --type e2e` - -### `/sc:improve` - ไปฃ็ ๅขžๅผบ -**็›ฎ็š„**: ๅบ”็”จ็ณป็ปŸๅŒ–็š„ไปฃ็ ๆ”น่ฟ›ๅ’Œไผ˜ๅŒ– -**่ฏญๆณ•**: `/sc:improve [path]` `[--type performance|quality|security] [--preview]` - -**ไฝฟ็”จๅœบๆ™ฏ**: -- ๅธธ่ง„ๆ”น่ฟ›: `/sc:improve src/` -- ๆ€ง่ƒฝไผ˜ๅŒ–: `/sc:improve --type performance` -- ๅฎ‰ๅ…จๅŠ ๅ›บ: `/sc:improve --type security` - -### `/sc:document` - ๆ–‡ๆกฃ็”Ÿๆˆ -**็›ฎ็š„**: ไธบไปฃ็ ๅ’ŒAPI็”Ÿๆˆๅ…จ้ข็š„ๆ–‡ๆกฃ -**่ฏญๆณ•**: `/sc:document [path]` `[--type api|user-guide|technical] [--format markdown|html]` - -**ไฝฟ็”จๅœบๆ™ฏ**: -- APIๆ–‡ๆกฃ: `/sc:document --type api` -- ็”จๆˆทๆŒ‡ๅ—: `/sc:document --type user-guide` -- ๆŠ€ๆœฏๆ–‡ๆกฃ: `/sc:document --type technical` - -### `/sc:workflow` - ๅฎž็Žฐ่ง„ๅˆ’ -**็›ฎ็š„**: ไปŽ้œ€ๆฑ‚็”Ÿๆˆ็ป“ๆž„ๅŒ–็š„ๅฎž็Žฐ่ฎกๅˆ’ -**่ฏญๆณ•**: `/sc:workflow "ๅŠŸ่ƒฝๆ่ฟฐ"` `[--strategy agile|waterfall] [--format markdown]` - -**ไฝฟ็”จๅœบๆ™ฏ**: -- ๅŠŸ่ƒฝ่ง„ๅˆ’: `/sc:workflow "็”จๆˆท่บซไปฝ้ชŒ่ฏ"` -- ๅ†ฒๅˆบ่ง„ๅˆ’: `/sc:workflow --strategy agile` -- ๆžถๆž„่ง„ๅˆ’: `/sc:workflow "ๅพฎๆœๅŠก่ฟ็งป"` - ---- - -## ๅธธ็”จๅทฅไฝœๆต - -**็ป่ฟ‡้ชŒ่ฏ็š„ๅ‘ฝไปค็ป„ๅˆ๏ผš** - -### ๆ–ฐ้กน็›ฎ่ฎพ็ฝฎ -```bash -/sc:brainstorm "้กน็›ฎๆฆ‚ๅฟต" # ๅฎšไน‰้œ€ๆฑ‚ -/sc:design "็ณป็ปŸๆžถๆž„" # ๅˆ›ๅปบๆŠ€ๆœฏ่ฎพ่ฎก -/sc:workflow "ๅฎž็Žฐ่ฎกๅˆ’" # ๅˆถๅฎšๅผ€ๅ‘่ทฏ็บฟๅ›พ -``` - -### ๅŠŸ่ƒฝๅผ€ๅ‘ -```bash -/sc:implement "ๅŠŸ่ƒฝๅ็งฐ" # ๆž„ๅปบๅŠŸ่ƒฝ -/sc:test --coverage # ้€š่ฟ‡ๆต‹่ฏ•้ชŒ่ฏ -/sc:document --type api # ็”Ÿๆˆๆ–‡ๆกฃ -``` - -### ไปฃ็ ่ดจ้‡ๆ”น่ฟ› -```bash -/sc:analyze --focus quality # ่ฏ„ไผฐๅฝ“ๅ‰็Šถๆ€ -/sc:improve --preview # ้ข„่งˆๆ”น่ฟ› -/sc:test --coverage # ้ชŒ่ฏๅ˜ๆ›ด -``` - -### Bug่ฐƒๆŸฅ -```bash -/sc:troubleshoot "้—ฎ้ข˜ๆ่ฟฐ" # ่ฏŠๆ–ญ้—ฎ้ข˜ -/sc:analyze --focus problem-area # ๆทฑๅบฆๅˆ†ๆž -/sc:improve --fix --safe-mode # ๅบ”็”จ้’ˆๅฏนๆ€งไฟฎๅค -``` - -## ๅฎŒๆ•ดๅ‘ฝไปคๅ‚่€ƒ - -### ๅผ€ๅ‘ๅ‘ฝไปค -| ๅ‘ฝไปค | ็›ฎ็š„ | ๆœ€้€‚็”จไบŽ | -|---------|---------|----------| -| **workflow** | ๅฎž็Žฐ่ง„ๅˆ’ | ้กน็›ฎ่ทฏ็บฟๅ›พ๏ผŒๅ†ฒๅˆบ่ง„ๅˆ’ | -| **implement** | ๅŠŸ่ƒฝๅผ€ๅ‘ | ๅ…จๆ ˆๅŠŸ่ƒฝ๏ผŒAPIๅผ€ๅ‘ | -| **build** | ้กน็›ฎ็ผ–่ฏ‘ | CI/CD๏ผŒ็”Ÿไบงๆž„ๅปบ | -| **design** | ็ณป็ปŸๆžถๆž„ | API่ง„่Œƒ๏ผŒๆ•ฐๆฎๅบ“ๆจกๅผ | - -### ๅˆ†ๆžๅ‘ฝไปค -| ๅ‘ฝไปค | ็›ฎ็š„ | ๆœ€้€‚็”จไบŽ | -|---------|---------|----------| -| **analyze** | ไปฃ็ ่ฏ„ไผฐ | ่ดจ้‡ๅฎก่ฎก๏ผŒๅฎ‰ๅ…จ่ฏ„ๅฎก | -| **troubleshoot** | ้—ฎ้ข˜่ฏŠๆ–ญ | Bug่ฐƒๆŸฅ๏ผŒๆ€ง่ƒฝ้—ฎ้ข˜ | -| **explain** | ไปฃ็ ่งฃ้‡Š | ๅญฆไน ๏ผŒไปฃ็ ่ฏ„ๅฎก | - -### ่ดจ้‡ๅ‘ฝไปค -| ๅ‘ฝไปค | ็›ฎ็š„ | ๆœ€้€‚็”จไบŽ | -|---------|---------|----------| -| **improve** | ไปฃ็ ๅขžๅผบ | ๆ€ง่ƒฝไผ˜ๅŒ–๏ผŒ้‡ๆž„ | -| **cleanup** | ๆŠ€ๆœฏๅ€บๅŠก | ๆธ…็†ๆ— ็”จไปฃ็ ๏ผŒ็ป„็ป‡ๆ•ด็† | -| **test** | ่ดจ้‡ไฟ่ฏ | ๆต‹่ฏ•่‡ชๅŠจๅŒ–๏ผŒ่ฆ†็›–็Ž‡ๅˆ†ๆž | -| **document** | ๆ–‡ๆกฃ็”Ÿๆˆ | APIๆ–‡ๆกฃ๏ผŒ็”จๆˆทๆŒ‡ๅ— | - -### ้กน็›ฎ็ฎก็† -| ๅ‘ฝไปค | ็›ฎ็š„ | ๆœ€้€‚็”จไบŽ | -|---------|---------|----------| -| **estimate** | ้กน็›ฎไผฐ็ฎ— | ๆ—ถ้—ด็บฟ่ง„ๅˆ’๏ผŒ่ต„ๆบๅˆ†้… | -| **task** | ไปปๅŠก็ฎก็† | ๅคๆ‚ๅทฅไฝœๆต๏ผŒไปปๅŠก่ทŸ่ธช | -| **spawn** | ๅ…ƒ็ผ–ๆŽ’ | ๅคงๅž‹้กน็›ฎ๏ผŒๅนถ่กŒๆ‰ง่กŒ | - -### ๅฎž็”จๅทฅๅ…ทๅ‘ฝไปค -| ๅ‘ฝไปค | ็›ฎ็š„ | ๆœ€้€‚็”จไบŽ | -|---------|---------|----------| -| **git** | ็‰ˆๆœฌๆŽงๅˆถ | ๆไบค็ฎก็†๏ผŒๅˆ†ๆ”ฏ็ญ–็•ฅ | -| **index** | ๅ‘ฝไปคๅ‘็Žฐ | ๆŽข็ดขๅŠŸ่ƒฝ๏ผŒๆŸฅๆ‰พๅ‘ฝไปค | - -### ไผš่ฏๅ‘ฝไปค -| ๅ‘ฝไปค | ็›ฎ็š„ | ๆœ€้€‚็”จไบŽ | -|---------|---------|----------| -| **load** | ไธŠไธ‹ๆ–‡ๅŠ ่ฝฝ | ไผš่ฏๅˆๅง‹ๅŒ–๏ผŒ้กน็›ฎๅฏ็”จ | -| **save** | ไผš่ฏๆŒไน…ๅŒ– | ๆฃ€ๆŸฅ็‚น๏ผŒไธŠไธ‹ๆ–‡ไฟๅญ˜ | -| **reflect** | ไปปๅŠก้ชŒ่ฏ | ่ฟ›ๅบฆ่ฏ„ไผฐ๏ผŒๅฎŒๆˆ้ชŒ่ฏ | -| **select-tool** | ๅทฅๅ…ทไผ˜ๅŒ– | ๆ€ง่ƒฝไผ˜ๅŒ–๏ผŒๅทฅๅ…ท้€‰ๆ‹ฉ | - ---- - -## ๅ‘ฝไปค็ดขๅผ• - -**ๆŒ‰ๅŠŸ่ƒฝๅˆ†็ฑป๏ผš** -- **่ง„ๅˆ’**: brainstorm, design, workflow, estimate -- **ๅผ€ๅ‘**: implement, build, git -- **ๅˆ†ๆž**: analyze, troubleshoot, explain -- **่ดจ้‡**: improve, cleanup, test, document -- **็ฎก็†**: task, spawn, load, save, reflect -- **ๅทฅๅ…ท**: index, select-tool - -**ๆŒ‰ๅคๆ‚ๅบฆๅˆ†็ฑป๏ผš** -- **ๅˆๅญฆ่€…**: brainstorm, implement, analyze, test -- **ไธญ็บง**: workflow, design, improve, document -- **้ซ˜็บง**: spawn, task, select-tool, reflect - -## ๆ•…้šœๆŽ’้™ค - -**ๅ‘ฝไปค้—ฎ้ข˜๏ผš** -- **ๅ‘ฝไปคๆœชๆ‰พๅˆฐ**: ้ชŒ่ฏๅฎ‰่ฃ…: `python3 -m SuperClaude --version` -- **ๆ— ๅ“ๅบ”**: ้‡ๅฏ Claude Code ไผš่ฏ -- **ๅค„็†ๅปถ่ฟŸ**: ไฝฟ็”จ `--no-mcp` ๆต‹่ฏ•ไธไฝฟ็”จ MCP ๆœๅŠกๅ™จ - -**ๅฟซ้€Ÿไฟฎๅค๏ผš** -- ้‡็ฝฎไผš่ฏ: `/sc:load` ้‡ๆ–ฐๅˆๅง‹ๅŒ– -- ๆฃ€ๆŸฅ็Šถๆ€: `SuperClaude install --list-components` -- ่Žทๅ–ๅธฎๅŠฉ: [ๆ•…้šœๆŽ’้™คๆŒ‡ๅ—](../Reference/troubleshooting.md) - -## ไธ‹ไธ€ๆญฅ - -- [ๆ ‡ๅฟ—ๆŒ‡ๅ—](flags.md) - ๆŽงๅˆถๅ‘ฝไปค่กŒไธบ -- [ๆ™บ่ƒฝไฝ“ๆŒ‡ๅ—](agents.md) - ไธ“ๅฎถๆฟ€ๆดป -- [็คบไพ‹ๆ‰‹ๅ†Œ](../Reference/examples-cookbook.md) - ็œŸๅฎžไฝฟ็”จๆจกๅผ \ No newline at end of file diff --git a/docs/User-Guide-zh/flags.md b/docs/User-Guide-zh/flags.md deleted file mode 100644 index 36f5a13..0000000 --- a/docs/User-Guide-zh/flags.md +++ /dev/null @@ -1,270 +0,0 @@ -# SuperClaude ๆ ‡ๅฟ—ๆŒ‡ๅ— ๐Ÿ - -**ๅคงๅคšๆ•ฐๆ ‡ๅฟ—ไผš่‡ชๅŠจๆฟ€ๆดป** - Claude Code ่ฏปๅ–่กŒไธบๆŒ‡ไปค๏ผŒๆ นๆฎๆ‚จ่ฏทๆฑ‚ไธญ็š„ๅ…ณ้”ฎ่ฏๅ’Œๆจกๅผๆฅ่ฐƒ็”จ้€‚ๅฝ“็š„ไธŠไธ‹ๆ–‡ใ€‚ - -## ๅŸบๆœฌ่‡ชๅŠจๆฟ€ๆดปๆ ‡ๅฟ—๏ผˆ90% ็š„ไฝฟ็”จๆกˆไพ‹๏ผ‰ - -### ๆ ธๅฟƒๅˆ†ๆžๆ ‡ๅฟ— -| ๆ ‡ๅฟ— | ไฝ•ๆ—ถๆฟ€ๆดป | ไฝœ็”จ | -|------|---------------|--------------| -| `--think` | 5+ ไธชๆ–‡ไปถๆˆ–ๅคๆ‚ๅˆ†ๆž | ๆ ‡ๅ‡†็ป“ๆž„ๅŒ–ๅˆ†ๆž๏ผˆ็บฆ 4K ไปค็‰Œ๏ผ‰| -| `--think-hard` | ๆžถๆž„ๅˆ†ๆžใ€็ณป็ปŸไพ่ต–ๅ…ณ็ณป | ๆทฑๅบฆๅˆ†ๆž๏ผˆ็บฆ 10K ไปค็‰Œ๏ผ‰้…ๅˆๅขžๅผบๅทฅๅ…ท | -| `--ultrathink` | ๅ…ณ้”ฎ็ณป็ปŸ้‡่ฎพ่ฎกใ€้—็•™็ณป็ปŸ็ŽฐไปฃๅŒ– | ๆœ€ๅคงๆทฑๅบฆๅˆ†ๆž๏ผˆ็บฆ 32K ไปค็‰Œ๏ผ‰้…ๅˆๆ‰€ๆœ‰ๅทฅๅ…ท | - -### MCP ๆœๅŠกๅ™จๆ ‡ๅฟ— -| ๆ ‡ๅฟ— | ๆœๅŠกๅ™จ | ็›ฎ็š„ | ่‡ชๅŠจ่งฆๅ‘ | -|------|---------|---------|---------------| -| `--c7` / `--context7` | Context7 | ๅฎ˜ๆ–นๆ–‡ๆกฃใ€ๆก†ๆžถๆจกๅผ | ๅบ“ๅฏผๅ…ฅใ€ๆก†ๆžถ้—ฎ้ข˜ | -| `--seq` / `--sequential` | Sequential | ๅคšๆญฅๆŽจ็†ใ€่ฐƒ่ฏ• | ๅคๆ‚่ฐƒ่ฏ•ใ€็ณป็ปŸ่ฎพ่ฎก | -| `--magic` | Magic | UI ็ป„ไปถ็”Ÿๆˆ | `/ui` ๅ‘ฝไปคใ€ๅ‰็ซฏๅ…ณ้”ฎ่ฏ | -| `--play` / `--playwright` | Playwright | ๆต่งˆๅ™จๆต‹่ฏ•ใ€E2E ้ชŒ่ฏ | ๆต‹่ฏ•่ฏทๆฑ‚ใ€่ง†่ง‰้ชŒ่ฏ | -| `--morph` / `--morphllm` | Morphllm | ๆ‰น้‡่ฝฌๆขใ€ๆจกๅผ็ผ–่พ‘ | ๆ‰น้‡ๆ“ไฝœใ€ๆ ทๅผๅผบๅˆถๆ‰ง่กŒ | -| `--serena` | Serena | ้กน็›ฎๅ†…ๅญ˜ใ€็ฌฆๅทๆ“ไฝœ | ็ฌฆๅทๆ“ไฝœใ€ๅคงๅž‹ไปฃ็ ๅบ“ | - -### ่กŒไธบๆจกๅผๆ ‡ๅฟ— -| ๆ ‡ๅฟ— | ไฝ•ๆ—ถๆฟ€ๆดป | ไฝœ็”จ | -|------|---------------|--------------| -| `--brainstorm` | ๆจก็ณŠ่ฏทๆฑ‚ใ€ๆŽข็ดขๅ…ณ้”ฎ่ฏ | ๅไฝœๅ‘็Žฐๆ€็ปดๆจกๅผ | -| `--introspect` | ่‡ชๆˆ‘ๅˆ†ๆžใ€้”™่ฏฏๆขๅค | ้€ๆ˜Žๅœฐๅฑ•็ŽฐๆŽจ็†่ฟ‡็จ‹ | -| `--task-manage` | >3 ๆญฅ้ชคใ€ๅคๆ‚่Œƒๅ›ด | ้€š่ฟ‡ๅง”ๆ‰˜่ฟ›่กŒๅ่ฐƒ | -| `--orchestrate` | ๅคšๅทฅๅ…ทๆ“ไฝœใ€ๆ€ง่ƒฝ้œ€ๆฑ‚ | ไผ˜ๅŒ–ๅทฅๅ…ท้€‰ๆ‹ฉๅ’Œๅนถ่กŒๆ‰ง่กŒ | -| `--token-efficient` / `--uc` | ไธŠไธ‹ๆ–‡ >75%ใ€ๆ•ˆ็Ž‡้œ€ๆฑ‚ | ็ฌฆๅทๅขžๅผบ้€šไฟก๏ผŒๅ‡ๅฐ‘ 30-50% ไปค็‰Œไฝฟ็”จ | - -### ๆ‰ง่กŒๆŽงๅˆถๆ ‡ๅฟ— -| ๆ ‡ๅฟ— | ไฝ•ๆ—ถๆฟ€ๆดป | ไฝœ็”จ | -|------|---------------|--------------| -| `--loop` | "improve"ใ€"polish"ใ€"refine" ๅ…ณ้”ฎ่ฏ | ่ฟญไปฃๅขžๅผบๅพช็Žฏ | -| `--safe-mode` | ็”Ÿไบง็Žฏๅขƒ๏ผŒ>85% ่ต„ๆบไฝฟ็”จ | ๆœ€ๅคง้ชŒ่ฏ๏ผŒไฟๅฎˆๆ‰ง่กŒ | -| `--validate` | ้ฃŽ้™ฉ >0.7๏ผŒ็”Ÿไบง็Žฏๅขƒ | ๆ‰ง่กŒๅ‰้ฃŽ้™ฉ่ฏ„ไผฐ | -| `--delegate` | >7 ไธช็›ฎๅฝ•ๆˆ– >50 ไธชๆ–‡ไปถ | ๅญๆ™บ่ƒฝไฝ“ๅนถ่กŒๅค„็† | - -## ็‰นๅฎšๅ‘ฝไปคๆ ‡ๅฟ— - -### ๅˆ†ๆžๅ‘ฝไปคๆ ‡ๅฟ— (`/sc:analyze`) -| ๆ ‡ๅฟ— | ็›ฎ็š„ | ๅ€ผ | -|------|---------|--------| -| `--focus` | ้’ˆๅฏน็‰นๅฎš้ข†ๅŸŸ | `security`, `performance`, `quality`, `architecture` | -| `--depth` | ๅˆ†ๆžๅฝปๅบ•็จ‹ๅบฆ | `quick`, `deep` | -| `--format` | ่พ“ๅ‡บๆ ผๅผ | `text`, `json`, `report` | - -### ๆž„ๅปบๅ‘ฝไปคๆ ‡ๅฟ— (`/sc:build`) -| ๆ ‡ๅฟ— | ็›ฎ็š„ | ๅ€ผ | -|------|---------|--------| -| `--type` | ๆž„ๅปบ้…็ฝฎ | `dev`, `prod`, `test` | -| `--clean` | ๆž„ๅปบๅ‰ๆธ…็† | ๅธƒๅฐ”ๅ€ผ | -| `--optimize` | ๅฏ็”จไผ˜ๅŒ– | ๅธƒๅฐ”ๅ€ผ | -| `--verbose` | ่ฏฆ็ป†่พ“ๅ‡บ | ๅธƒๅฐ”ๅ€ผ | - -### ่ฎพ่ฎกๅ‘ฝไปคๆ ‡ๅฟ— (`/sc:design`) -| ๆ ‡ๅฟ— | ็›ฎ็š„ | ๅ€ผ | -|------|---------|--------| -| `--type` | ่ฎพ่ฎก็›ฎๆ ‡ | `architecture`, `api`, `component`, `database` | -| `--format` | ่พ“ๅ‡บๆ ผๅผ | `diagram`, `spec`, `code` | - -### ่งฃ้‡Šๅ‘ฝไปคๆ ‡ๅฟ— (`/sc:explain`) -| ๆ ‡ๅฟ— | ็›ฎ็š„ | ๅ€ผ | -|------|---------|--------| -| `--level` | ๅคๆ‚ๅบฆ็บงๅˆซ | `basic`, `intermediate`, `advanced` | -| `--format` | ่งฃ้‡Š้ฃŽๆ ผ | `text`, `examples`, `interactive` | -| `--context` | ้ข†ๅŸŸไธŠไธ‹ๆ–‡ | ไปปไฝ•้ข†ๅŸŸ๏ผˆๅฆ‚ `react`ใ€`security`๏ผ‰| - -### ๆ”น่ฟ›ๅ‘ฝไปคๆ ‡ๅฟ— (`/sc:improve`) -| ๆ ‡ๅฟ— | ็›ฎ็š„ | ๅ€ผ | -|------|---------|--------| -| `--type` | ๆ”น่ฟ›็„ฆ็‚น | `quality`, `performance`, `maintainability`, `style`, `security` | -| `--safe` | ไฟๅฎˆๆ–นๆณ• | ๅธƒๅฐ”ๅ€ผ | -| `--interactive` | ็”จๆˆทๆŒ‡ๅฏผ | ๅธƒๅฐ”ๅ€ผ | -| `--preview` | ๆ˜พ็คบไฝ†ไธๆ‰ง่กŒ | ๅธƒๅฐ”ๅ€ผ | - -### ไปปๅŠกๅ‘ฝไปคๆ ‡ๅฟ— (`/sc:task`) -| ๆ ‡ๅฟ— | ็›ฎ็š„ | ๅ€ผ | -|------|---------|--------| -| `--strategy` | ไปปๅŠกๆ–นๆณ• | `systematic`, `agile`, `enterprise` | -| `--parallel` | ๅนถ่กŒๆ‰ง่กŒ | ๅธƒๅฐ”ๅ€ผ | -| `--delegate` | ๅญๆ™บ่ƒฝไฝ“ๅ่ฐƒ | ๅธƒๅฐ”ๅ€ผ | - -### ๅทฅไฝœๆตๅ‘ฝไปคๆ ‡ๅฟ— (`/sc:workflow`) -| ๆ ‡ๅฟ— | ็›ฎ็š„ | ๅ€ผ | -|------|---------|--------| -| `--strategy` | ๅทฅไฝœๆตๆ–นๆณ• | `systematic`, `agile`, `enterprise` | -| `--depth` | ๅˆ†ๆžๆทฑๅบฆ | `shallow`, `normal`, `deep` | -| `--parallel` | ๅนถ่กŒๅ่ฐƒ | ๅธƒๅฐ”ๅ€ผ | - -### ๆ•…้šœๆŽ’้™คๅ‘ฝไปคๆ ‡ๅฟ— (`/sc:troubleshoot`) -| ๆ ‡ๅฟ— | ็›ฎ็š„ | ๅ€ผ | -|------|---------|--------| -| `--type` | ้—ฎ้ข˜็ฑปๅˆซ | `bug`, `build`, `performance`, `deployment` | -| `--trace` | ๅŒ…ๅซ่ทŸ่ธชๅˆ†ๆž | ๅธƒๅฐ”ๅ€ผ | -| `--fix` | ๆ‰ง่กŒไฟฎๅค | ๅธƒๅฐ”ๅ€ผ | - -### ๆธ…็†ๅ‘ฝไปคๆ ‡ๅฟ— (`/sc:cleanup`) -| ๆ ‡ๅฟ— | ็›ฎ็š„ | ๅ€ผ | -|------|---------|--------| -| `--type` | ๆธ…็†็›ฎๆ ‡ | `code`, `imports`, `files`, `all` | -| `--safe` / `--aggressive` | ๆธ…็†ๅผบๅบฆ | ๅธƒๅฐ”ๅ€ผ | -| `--interactive` | ็”จๆˆทๆŒ‡ๅฏผ | ๅธƒๅฐ”ๅ€ผ | -| `--preview` | ๆ˜พ็คบไฝ†ไธๆ‰ง่กŒ | ๅธƒๅฐ”ๅ€ผ | - -### ไผฐ็ฎ—ๅ‘ฝไปคๆ ‡ๅฟ— (`/sc:estimate`) -| ๆ ‡ๅฟ— | ็›ฎ็š„ | ๅ€ผ | -|------|---------|--------| -| `--type` | ไผฐ็ฎ—็„ฆ็‚น | `time`, `effort`, `complexity` | -| `--unit` | ๆ—ถ้—ดๅ•ไฝ | `hours`, `days`, `weeks` | -| `--breakdown` | ่ฏฆ็ป†ๅˆ†่งฃ | ๅธƒๅฐ”ๅ€ผ | - -### ็ดขๅผ•ๅ‘ฝไปคๆ ‡ๅฟ— (`/sc:index`) -| ๆ ‡ๅฟ— | ็›ฎ็š„ | ๅ€ผ | -|------|---------|--------| -| `--type` | ็ดขๅผ•็›ฎๆ ‡ | `docs`, `api`, `structure`, `readme` | -| `--format` | ่พ“ๅ‡บๆ ผๅผ | `md`, `json`, `yaml` | - -### ๅๆ€ๅ‘ฝไปคๆ ‡ๅฟ— (`/sc:reflect`) -| ๆ ‡ๅฟ— | ็›ฎ็š„ | ๅ€ผ | -|------|---------|--------| -| `--type` | ๅๆ€่Œƒๅ›ด | `task`, `session`, `completion` | -| `--analyze` | ๅŒ…ๅซๅˆ†ๆž | ๅธƒๅฐ”ๅ€ผ | -| `--validate` | ้ชŒ่ฏๅฎŒๆ•ดๆ€ง | ๅธƒๅฐ”ๅ€ผ | - -### ็”Ÿๆˆๅ‘ฝไปคๆ ‡ๅฟ— (`/sc:spawn`) -| ๆ ‡ๅฟ— | ็›ฎ็š„ | ๅ€ผ | -|------|---------|--------| -| `--strategy` | ๅ่ฐƒๆ–นๆณ• | `sequential`, `parallel`, `adaptive` | -| `--depth` | ๅˆ†ๆžๆทฑๅบฆ | `normal`, `deep` | - -### Git ๅ‘ฝไปคๆ ‡ๅฟ— (`/sc:git`) -| ๆ ‡ๅฟ— | ็›ฎ็š„ | ๅ€ผ | -|------|---------|--------| -| `--smart-commit` | ็”Ÿๆˆๆไบคๆถˆๆฏ | ๅธƒๅฐ”ๅ€ผ | -| `--interactive` | ๅผ•ๅฏผๆ“ไฝœ | ๅธƒๅฐ”ๅ€ผ | - -### ๅทฅๅ…ท้€‰ๆ‹ฉๅ‘ฝไปคๆ ‡ๅฟ— (`/sc:select-tool`) -| ๆ ‡ๅฟ— | ็›ฎ็š„ | ๅ€ผ | -|------|---------|--------| -| `--analyze` | ๅทฅๅ…ทๅˆ†ๆž | ๅธƒๅฐ”ๅ€ผ | -| `--explain` | ่งฃ้‡Š้€‰ๆ‹ฉ | ๅธƒๅฐ”ๅ€ผ | - -### ๆต‹่ฏ•ๅ‘ฝไปคๆ ‡ๅฟ— (`/sc:test`) -| ๆ ‡ๅฟ— | ็›ฎ็š„ | ๅ€ผ | -|------|---------|--------| -| `--coverage` | ๅŒ…ๅซ่ฆ†็›–็Ž‡ | ๅธƒๅฐ”ๅ€ผ | -| `--type` | ๆต‹่ฏ•็ฑปๅž‹ | `unit`, `integration`, `e2e` | -| `--watch` | ็›‘่ง†ๆจกๅผ | ๅธƒๅฐ”ๅ€ผ | - -## ้ซ˜็บงๆŽงๅˆถๆ ‡ๅฟ— - -### ่Œƒๅ›ดๅ’Œ็„ฆ็‚น -| ๆ ‡ๅฟ— | ็›ฎ็š„ | ๅ€ผ | -|------|---------|--------| -| `--scope` | ๅˆ†ๆž่พน็•Œ | `file`, `module`, `project`, `system` | -| `--focus` | ้ข†ๅŸŸๅฎšๅ‘ | `performance`, `security`, `quality`, `architecture`, `accessibility`, `testing` | - -### ๆ‰ง่กŒๆŽงๅˆถ -| ๆ ‡ๅฟ— | ็›ฎ็š„ | ๅ€ผ | -|------|---------|--------| -| `--concurrency [n]` | ๆŽงๅˆถๅนถ่กŒๆ“ไฝœ | 1-15 | -| `--iterations [n]` | ๆ”น่ฟ›ๅพช็Žฏ | 1-10 | -| `--all-mcp` | ๅฏ็”จๆ‰€ๆœ‰ MCP ๆœๅŠกๅ™จ | ๅธƒๅฐ”ๅ€ผ | -| `--no-mcp` | ไป…ไฝฟ็”จๆœฌๅœฐๅทฅๅ…ท | ๅธƒๅฐ”ๅ€ผ | - -### ็ณป็ปŸๆ ‡ๅฟ—๏ผˆSuperClaude ๅฎ‰่ฃ…๏ผ‰ -| ๆ ‡ๅฟ— | ็›ฎ็š„ | ๅ€ผ | -|------|---------|--------| -| `--verbose` / `-v` | ่ฏฆ็ป†ๆ—ฅๅฟ— | ๅธƒๅฐ”ๅ€ผ | -| `--quiet` / `-q` | ้™้ป˜่พ“ๅ‡บ | ๅธƒๅฐ”ๅ€ผ | -| `--dry-run` | ๆจกๆ‹Ÿๆ“ไฝœ | ๅธƒๅฐ”ๅ€ผ | -| `--force` | ่ทณ่ฟ‡ๆฃ€ๆŸฅ | ๅธƒๅฐ”ๅ€ผ | -| `--yes` / `-y` | ่‡ชๅŠจ็กฎ่ฎค | ๅธƒๅฐ”ๅ€ผ | -| `--install-dir` | ็›ฎๆ ‡็›ฎๅฝ• | ่ทฏๅพ„ | -| `--legacy` | ไฝฟ็”จไผ ็ปŸ่„šๆœฌ | ๅธƒๅฐ”ๅ€ผ | -| `--version` | ๆ˜พ็คบ็‰ˆๆœฌ | ๅธƒๅฐ”ๅ€ผ | -| `--help` | ๆ˜พ็คบๅธฎๅŠฉ | ๅธƒๅฐ”ๅ€ผ | - -## ๅธธ็”จไฝฟ็”จๆจกๅผ - -### ๅ‰็ซฏๅผ€ๅ‘ -```bash -/sc:implement "responsive dashboard" --magic --c7 -/sc:design component-library --type component --format code -/sc:test ui-components/ --magic --play -/sc:improve legacy-ui/ --magic --morph --validate -``` - -### ๅŽ็ซฏๅผ€ๅ‘ -```bash -/sc:analyze api/ --focus performance --seq --think -/sc:design payment-api --type api --format spec -/sc:troubleshoot "API timeout" --type performance --trace -/sc:improve auth-service --type security --validate -``` - -### ๅคงๅž‹้กน็›ฎ -```bash -/sc:analyze . --ultrathink --all-mcp --safe-mode -/sc:workflow enterprise-system --strategy enterprise --depth deep -/sc:cleanup . --type all --safe --interactive -/sc:estimate "migrate to microservices" --type complexity --breakdown -``` - -### ่ดจ้‡ๅ’Œ็ปดๆŠค -```bash -/sc:improve src/ --type quality --safe --interactive -/sc:cleanup imports --type imports --preview -/sc:reflect --type completion --validate -/sc:git commit --smart-commit -``` - -## ๆ ‡ๅฟ—ไบคไบ’ - -### ๅ…ผๅฎน็ป„ๅˆ -- `--think` + `--c7`๏ผšๅธฆๆ–‡ๆกฃ็š„ๅˆ†ๆž -- `--magic` + `--play`๏ผšUI ็”Ÿๆˆๅธฆๆต‹่ฏ• -- `--serena` + `--morph`๏ผš้กน็›ฎๅ†…ๅญ˜ๅธฆ่ฝฌๆข -- `--safe-mode` + `--validate`๏ผšๆœ€ๅคงๅฎ‰ๅ…จๆ€ง -- `--loop` + `--validate`๏ผšๅธฆ้ชŒ่ฏ็š„่ฟญไปฃๆ”น่ฟ› - -### ๅ†ฒ็ชๆ ‡ๅฟ— -- `--all-mcp` vs ๅ•็‹ฌ็š„ MCP ๆ ‡ๅฟ—๏ผˆไฝฟ็”จๅ…ถไธญไน‹ไธ€๏ผ‰ -- `--no-mcp` vs ไปปไฝ• MCP ๆ ‡ๅฟ—๏ผˆ--no-mcp ่Žท่ƒœ๏ผ‰ -- `--safe` vs `--aggressive`๏ผˆๆธ…็†ๅผบๅบฆ๏ผ‰ -- `--quiet` vs `--verbose`๏ผˆ่พ“ๅ‡บ็บงๅˆซ๏ผ‰ - -### ่‡ชๅŠจๅฏ็”จๅ…ณ็ณป -- `--safe-mode` ่‡ชๅŠจๅฏ็”จ `--uc` ๅ’Œ `--validate` -- `--ultrathink` ่‡ชๅŠจๅฏ็”จๆ‰€ๆœ‰ MCP ๆœๅŠกๅ™จ -- `--think-hard` ่‡ชๅŠจๅฏ็”จ `--seq` + `--c7` -- `--magic` ่งฆๅ‘ไปฅ UI ไธบไธญๅฟƒ็š„ๆ™บ่ƒฝไฝ“ - -## ๆ ‡ๅฟ—ๆ•…้šœๆŽ’้™ค - -### ๅธธ่ง้—ฎ้ข˜ -- **ๅทฅๅ…ท่ฟ‡ๅคš**๏ผšไฝฟ็”จ `--no-mcp` ไป…็”จๆœฌๅœฐๅทฅๅ…ทๆต‹่ฏ• -- **ๆ“ไฝœๅคชๆ…ข**๏ผšๆทปๅŠ  `--uc` ๅŽ‹็ผฉ่พ“ๅ‡บ -- **้ชŒ่ฏ้˜ปๅกž**๏ผšๅœจๅผ€ๅ‘ไธญไฝฟ็”จ `--validate` ่€Œไธๆ˜ฏ `--safe-mode` -- **ไธŠไธ‹ๆ–‡ๅŽ‹ๅŠ›**๏ผšๅœจ >75% ไฝฟ็”จ็Ž‡ๆ—ถ่‡ชๅŠจๆฟ€ๆดป `--token-efficient` - -### ่ฐƒ่ฏ•ๆ ‡ๅฟ— -```bash -/sc:analyze . --verbose # ๆ˜พ็คบๅ†ณ็ญ–้€ป่พ‘ๅ’Œๆ ‡ๅฟ—ๆฟ€ๆดป -/sc:select-tool "ๆ“ไฝœ" --explain # ่งฃ้‡Šๅทฅๅ…ท้€‰ๆ‹ฉ่ฟ‡็จ‹ -/sc:reflect --type session --analyze # ๅฎกๆŸฅๅฝ“ๅ‰ไผš่ฏๅ†ณ็ญ– -``` - -### ๅฟซ้€Ÿไฟฎๅค -```bash -/sc:analyze . --help # ๆ˜พ็คบๅ‘ฝไปค็š„ๅฏ็”จๆ ‡ๅฟ— -/sc:analyze . --no-mcp # ไป…ๆœฌๅœฐๆ‰ง่กŒ -/sc:cleanup . --preview # ๆ˜พ็คบๅฐ†่ขซๆธ…็†็š„ๅ†…ๅฎน -``` - -## ๆ ‡ๅฟ—ไผ˜ๅ…ˆ็บง่ง„ๅˆ™ - -1. **ๅฎ‰ๅ…จ็ฌฌไธ€**๏ผš`--safe-mode` > `--validate` > ไผ˜ๅŒ–ๆ ‡ๅฟ— -2. **ๆ˜พๅผ่ฆ†็›–**๏ผš็”จๆˆทๆ ‡ๅฟ— > ่‡ชๅŠจๆฃ€ๆต‹ -3. **ๆทฑๅบฆๅฑ‚ๆฌก**๏ผš`--ultrathink` > `--think-hard` > `--think` -4. **MCP ๆŽงๅˆถ**๏ผš`--no-mcp` ่ฆ†็›–ๆ‰€ๆœ‰ๅ•็‹ฌ็š„ MCP ๆ ‡ๅฟ— -5. **่Œƒๅ›ดไผ˜ๅ…ˆ็บง**๏ผšsystem > project > module > file - -## ็›ธๅ…ณ่ต„ๆบ -- [ๅ‘ฝไปคๆŒ‡ๅ—](commands.md) - ไฝฟ็”จ่ฟ™ไบ›ๆ ‡ๅฟ—็š„ๅ‘ฝไปค -- [MCP ๆœๅŠกๅ™จๆŒ‡ๅ—](mcp-servers.md) - ็†่งฃ MCP ๆ ‡ๅฟ—ๆฟ€ๆดป -- [ไผš่ฏ็ฎก็†](session-management.md) - ๅœจๆŒไน…ไผš่ฏไธญไฝฟ็”จๆ ‡ๅฟ— \ No newline at end of file diff --git a/docs/User-Guide-zh/mcp-servers.md b/docs/User-Guide-zh/mcp-servers.md deleted file mode 100644 index 4f717df..0000000 --- a/docs/User-Guide-zh/mcp-servers.md +++ /dev/null @@ -1,272 +0,0 @@ -# SuperClaude MCP ๆœๅŠกๅ™จๆŒ‡ๅ— ๐Ÿ”Œ - -## ๆฆ‚่งˆ - -MCP๏ผˆๆจกๅž‹ไธŠไธ‹ๆ–‡ๅ่ฎฎ๏ผ‰ๆœๅŠกๅ™จ้€š่ฟ‡ไธ“ไธšๅทฅๅ…ทๆ‰ฉๅฑ• Claude Code ็š„่ƒฝๅŠ›ใ€‚SuperClaude ้›†ๆˆไบ† 6 ไธช MCP ๆœๅŠกๅ™จ๏ผŒๅนถไธบ Claude ๆไพ›ๆŒ‡ไปค๏ผŒๅ‘Š่ฏ‰ๅฎƒไฝ•ๆ—ถๆ นๆฎๆ‚จ็š„ไปปๅŠกๆฟ€ๆดปๅฎƒไปฌใ€‚ - -### ๐Ÿ” ็Žฐๅฎžๆฃ€ๆŸฅ -- **MCP ๆœๅŠกๅ™จๆ˜ฏไป€ไนˆ**๏ผšๆไพ›้™„ๅŠ ๅทฅๅ…ท็š„ๅค–้ƒจ Node.js ่ฟ›็จ‹ -- **ๅฎƒไปฌไธๆ˜ฏไป€ไนˆ**๏ผšๅ†…็ฝฎ็š„ SuperClaude ๅŠŸ่ƒฝ -- **ๆฟ€ๆดปๅฆ‚ไฝ•ๅทฅไฝœ**๏ผšClaude ่ฏปๅ–ๆŒ‡ไปค๏ผŒๆ นๆฎไธŠไธ‹ๆ–‡ไฝฟ็”จ้€‚ๅฝ“็š„ๆœๅŠกๅ™จ -- **ๅฎƒไปฌๆไพ›ไป€ไนˆ**๏ผšๆ‰ฉๅฑ• Claude Code ๆœฌๅœฐ่ƒฝๅŠ›็š„็œŸๅฎžๅทฅๅ…ท - -**ๆ ธๅฟƒๆœๅŠกๅ™จ๏ผš** -- **context7**๏ผšๅฎ˜ๆ–นๅบ“ๆ–‡ๆกฃๅ’Œๆจกๅผ -- **sequential-thinking**๏ผšๅคšๆญฅๆŽจ็†ๅ’Œๅˆ†ๆž -- **magic**๏ผš็Žฐไปฃ UI ็ป„ไปถ็”Ÿๆˆ -- **playwright**๏ผšๆต่งˆๅ™จ่‡ชๅŠจๅŒ–ๅ’Œ E2E ๆต‹่ฏ• -- **morphllm-fast-apply**๏ผšๅŸบไบŽๆจกๅผ็š„ไปฃ็ ่ฝฌๆข -- **serena**๏ผš่ฏญไน‰ไปฃ็ ็†่งฃๅ’Œ้กน็›ฎๅ†…ๅญ˜ - -## ๅฟซ้€Ÿๅผ€ๅง‹ - -**่ฎพ็ฝฎ้ชŒ่ฏ**๏ผšMCP ๆœๅŠกๅ™จไผš่‡ชๅŠจๆฟ€ๆดปใ€‚ๆœ‰ๅ…ณๅฎ‰่ฃ…ๅ’Œๆ•…้šœๆŽ’้™ค๏ผŒ่ฏทๅ‚้˜… [ๅฎ‰่ฃ…ๆŒ‡ๅ—](../Getting-Started/installation.md) ๅ’Œ [ๆ•…้šœๆŽ’้™ค](../Reference/troubleshooting.md)ใ€‚ - -**่‡ชๅŠจๆฟ€ๆดป้€ป่พ‘๏ผš** - -| ่ฏทๆฑ‚ๅŒ…ๅซ | ๆฟ€ๆดป็š„ๆœๅŠกๅ™จ | -|-----------------|------------------| -| ๅบ“ๅฏผๅ…ฅใ€API ๅ็งฐ | **context7** | -| `--think`ใ€่ฐƒ่ฏ• | **sequential-thinking** | -| `component`ใ€`UI`ใ€ๅ‰็ซฏ | **magic** | -| `test`ใ€`e2e`ใ€`browser` | **playwright** | -| ๅคšๆ–‡ไปถ็ผ–่พ‘ใ€้‡ๆž„ | **morphllm-fast-apply** | -| ๅคงๅž‹้กน็›ฎใ€ไผš่ฏ | **serena** | - -## ๆœๅŠกๅ™จ่ฏฆๆƒ… - -### context7 ๐Ÿ“š -**็›ฎ็š„**๏ผšๅฎ˜ๆ–นๅบ“ๆ–‡ๆกฃ่ฎฟ้—ฎ -**่งฆๅ‘ๅ™จ**๏ผšๅฏผๅ…ฅ่ฏญๅฅใ€ๆก†ๆžถๅ…ณ้”ฎ่ฏใ€ๆ–‡ๆกฃ่ฏทๆฑ‚ -**่ฆๆฑ‚**๏ผšNode.js 16+๏ผŒๆ— ้œ€ API ๅฏ†้’ฅ - -```bash -# ่‡ชๅŠจๆฟ€ๆดป -/sc:implement "React authentication system" -# โ†’ ๆไพ›ๅฎ˜ๆ–น React ๆจกๅผ - -# ๆ‰‹ๅŠจๆฟ€ๆดป -/sc:analyze auth-system/ --c7 -``` - -### sequential-thinking ๐Ÿง  -**็›ฎ็š„**๏ผš็ป“ๆž„ๅŒ–ๅคšๆญฅๆŽจ็†ๅ’Œ็ณป็ปŸๅˆ†ๆž -**่งฆๅ‘ๅ™จ**๏ผšๅคๆ‚่ฐƒ่ฏ•ใ€`--think` ๆ ‡ๅฟ—ใ€ๆžถๆž„ๅˆ†ๆž -**่ฆๆฑ‚**๏ผšNode.js 16+๏ผŒๆ— ้œ€ API ๅฏ†้’ฅ - -```bash -# ่‡ชๅŠจๆฟ€ๆดป -/sc:troubleshoot "API performance issues" -# โ†’ ๅฏ็”จ็ณป็ปŸๆ€งๆ นๅ› ๅˆ†ๆž - -# ๆ‰‹ๅŠจๆฟ€ๆดป -/sc:analyze --think-hard architecture/ -``` - -### magic โœจ -**็›ฎ็š„**๏ผšไปŽ 21st.dev ๆจกๅผ็”Ÿๆˆ็Žฐไปฃ UI ็ป„ไปถ -**่งฆๅ‘ๅ™จ**๏ผšUI ่ฏทๆฑ‚ใ€`/ui` ๅ‘ฝไปคใ€็ป„ไปถๅผ€ๅ‘ -**่ฆๆฑ‚**๏ผšNode.js 16+๏ผŒTWENTYFIRST_API_KEY - -```bash -# ่‡ชๅŠจๆฟ€ๆดป -/sc:implement "responsive dashboard component" -# โ†’ ไฝฟ็”จ็Žฐไปฃๆจกๅผ็”Ÿๆˆๅฏ่ฎฟ้—ฎ็š„ UI - -# API ๅฏ†้’ฅ่ฎพ็ฝฎ -export TWENTYFIRST_API_KEY="your_key_here" -``` - -### playwright ๐ŸŽญ -**็›ฎ็š„**๏ผš็œŸๅฎžๆต่งˆๅ™จ่‡ชๅŠจๅŒ–ๅ’Œ E2E ๆต‹่ฏ• -**่งฆๅ‘ๅ™จ**๏ผšๆต่งˆๅ™จๆต‹่ฏ•ใ€E2E ๅœบๆ™ฏใ€่ง†่ง‰้ชŒ่ฏ -**่ฆๆฑ‚**๏ผšNode.js 16+๏ผŒๆ— ้œ€ API ๅฏ†้’ฅ - -```bash -# ่‡ชๅŠจๆฟ€ๆดป -/sc:test --type e2e "user login flow" -# โ†’ ๅฏ็”จๆต่งˆๅ™จ่‡ชๅŠจๅŒ–ๆต‹่ฏ• - -# ๆ‰‹ๅŠจๆฟ€ๆดป -/sc:validate "accessibility compliance" --play -``` - -### morphllm-fast-apply ๐Ÿ”„ -**็›ฎ็š„**๏ผš้ซ˜ๆ•ˆ็š„ๅŸบไบŽๆจกๅผ็š„ไปฃ็ ่ฝฌๆข -**่งฆๅ‘ๅ™จ**๏ผšๅคšๆ–‡ไปถ็ผ–่พ‘ใ€้‡ๆž„ใ€ๆก†ๆžถ่ฟ็งป -**่ฆๆฑ‚**๏ผšNode.js 16+๏ผŒMORPH_API_KEY - -```bash -# ่‡ชๅŠจๆฟ€ๆดป -/sc:improve legacy-codebase/ --focus maintainability -# โ†’ ๅœจๆ–‡ไปถไธญๅบ”็”จไธ€่‡ด็š„ๆจกๅผ - -# API ๅฏ†้’ฅ่ฎพ็ฝฎ -export MORPH_API_KEY="your_key_here" -``` - -### serena ๐Ÿงญ -**็›ฎ็š„**๏ผšๅธฆๆœ‰้กน็›ฎๅ†…ๅญ˜็š„่ฏญไน‰ไปฃ็ ็†่งฃ -**่งฆๅ‘ๅ™จ**๏ผš็ฌฆๅทๆ“ไฝœใ€ๅคงๅž‹ไปฃ็ ๅบ“ใ€ไผš่ฏ็ฎก็† -**่ฆๆฑ‚**๏ผšPython 3.9+ใ€uv ๅŒ…็ฎก็†ๅ™จ๏ผŒๆ— ้œ€ API ๅฏ†้’ฅ - -```bash -# ่‡ชๅŠจๆฟ€ๆดป -/sc:load existing-project/ -# โ†’ ๆž„ๅปบ้กน็›ฎ็†่งฃๅ’Œๅ†…ๅญ˜ - -# ๆ‰‹ๅŠจๆฟ€ๆดป -/sc:refactor "extract UserService" --serena -``` - -## ้…็ฝฎ - -**MCP ้…็ฝฎๆ–‡ไปถ (`~/.claude.json`)๏ผš** -```json -{ - "mcpServers": { - "context7": { - "command": "npx", - "args": ["-y", "@upstash/context7-mcp@latest"] - }, - "sequential-thinking": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"] - }, - "magic": { - "command": "npx", - "args": ["@21st-dev/magic"], - "env": {"TWENTYFIRST_API_KEY": "${TWENTYFIRST_API_KEY}"} - }, - "playwright": { - "command": "npx", - "args": ["@playwright/mcp@latest"] - }, - "morphllm-fast-apply": { - "command": "npx", - "args": ["@morph-llm/morph-fast-apply"], - "env": {"MORPH_API_KEY": "${MORPH_API_KEY}"} - }, - "serena": { - "command": "uvx", - "args": ["--from", "git+https://github.com/oraios/serena", "serena", "start-mcp-server", "--context", "ide-assistant"] - } - } -} -``` - -## ไฝฟ็”จๆจกๅผ - -**ๆœๅŠกๅ™จๆŽงๅˆถ๏ผš** -```bash -# ๅฏ็”จ็‰นๅฎšๆœๅŠกๅ™จ -/sc:analyze codebase/ --c7 --seq - -# ็ฆ็”จๆ‰€ๆœ‰ MCP ๆœๅŠกๅ™จ -/sc:implement "simple function" --no-mcp - -# ๅฏ็”จๆ‰€ๆœ‰ๆœๅŠกๅ™จ -/sc:design "complex architecture" --all-mcp -``` - -**ๅคšๆœๅŠกๅ™จๅ่ฐƒ๏ผš** -```bash -# ๅ…จๆ ˆๅผ€ๅ‘ -/sc:implement "e-commerce checkout" -# โ†’ Sequential๏ผšๅทฅไฝœๆตๅˆ†ๆž -# โ†’ Context7๏ผšๆ”ฏไป˜ๆจกๅผ -# โ†’ Magic๏ผšUI ็ป„ไปถ -# โ†’ Serena๏ผšไปฃ็ ็ป„็ป‡ -# โ†’ Playwright๏ผšE2E ๆต‹่ฏ• -``` - -## ๆ•…้šœๆŽ’้™ค - -**ๅธธ่ง้—ฎ้ข˜๏ผš** -- **ๆ— ๆœๅŠกๅ™จ่ฟžๆŽฅ**๏ผšๆฃ€ๆŸฅ Node.js๏ผš`node --version`๏ผˆ้œ€่ฆ v16+๏ผ‰ -- **Context7 ๅคฑ่ดฅ**๏ผšๆธ…้™ค็ผ“ๅญ˜๏ผš`npm cache clean --force` -- **Magic/Morphllm ้”™่ฏฏ**๏ผšๅœจๆฒกๆœ‰ API ๅฏ†้’ฅๆ—ถๆ˜ฏ้ข„ๆœŸ็š„๏ผˆไป˜่ดนๆœๅŠก๏ผ‰ -- **ๆœๅŠกๅ™จ่ถ…ๆ—ถ**๏ผš้‡ๅฏ Claude Code ไผš่ฏ - -**ๅฟซ้€Ÿไฟฎๅค๏ผš** -```bash -# ้‡็ฝฎ่ฟžๆŽฅ -# ้‡ๅฏ Claude Code ไผš่ฏ - -# ๆฃ€ๆŸฅไพ่ต– -node --version # ๅบ”่ฏฅๆ˜พ็คบ v16+ - -# ไธไฝฟ็”จ MCP ๆต‹่ฏ• -/sc:command --no-mcp - -# ๆฃ€ๆŸฅ้…็ฝฎ -ls ~/.claude.json -``` - -**API ๅฏ†้’ฅ้…็ฝฎ๏ผš** -```bash -# ็”จไบŽ Magic ๆœๅŠกๅ™จ๏ผˆUI ็”Ÿๆˆๆ‰€้œ€๏ผ‰ -export TWENTYFIRST_API_KEY="your_key_here" - -# ็”จไบŽ Morphllm ๆœๅŠกๅ™จ๏ผˆๆ‰น้‡่ฝฌๆขๆ‰€้œ€๏ผ‰ -export MORPH_API_KEY="your_key_here" - -# ๆทปๅŠ ๅˆฐ shell ้…็ฝฎๆ–‡ไปถไปฅไฟๆŒๆŒไน… -echo 'export TWENTYFIRST_API_KEY="your_key"' >> ~/.bashrc -echo 'export MORPH_API_KEY="your_key"' >> ~/.bashrc -``` - -**็Žฏๅขƒๅ˜้‡ไฝฟ็”จ๏ผš** -- โœ… `TWENTYFIRST_API_KEY` - Magic MCP ๆœๅŠกๅ™จๅŠŸ่ƒฝๆ‰€้œ€ -- โœ… `MORPH_API_KEY` - Morphllm MCP ๆœๅŠกๅ™จๅŠŸ่ƒฝๆ‰€้œ€ -- โŒ ๆ–‡ๆกฃไธญ็š„ๅ…ถไป–็Žฏๅขƒๅ˜้‡ - ไป…ไฝœ็คบไพ‹๏ผŒๆก†ๆžถไธญไธไฝฟ็”จ -- ๐Ÿ“ ไธค่€…้ƒฝๆ˜ฏไป˜่ดนๆœๅŠก API ๅฏ†้’ฅ๏ผŒๆก†ๆžถๅœจๆฒกๆœ‰ๅฎƒไปฌ็š„ๆƒ…ๅ†ตไธ‹ไนŸๅฏไปฅๅทฅไฝœ - -## ๆœๅŠกๅ™จ็ป„ๅˆ - -**ๆ—  API ๅฏ†้’ฅ๏ผˆๅ…่ดน๏ผ‰**๏ผš -- context7 + sequential-thinking + playwright + serena - -**1 ไธช API ๅฏ†้’ฅ**๏ผš -- ๆทปๅŠ  magic ็”จไบŽไธ“ไธš UI ๅผ€ๅ‘ - -**2 ไธช API ๅฏ†้’ฅ**๏ผš -- ๆทปๅŠ  morphllm-fast-apply ็”จไบŽๅคง่ง„ๆจก้‡ๆž„ - -**ๅธธ่งๅทฅไฝœๆต๏ผš** -- **ๅญฆไน **๏ผšcontext7 + sequential-thinking -- **Web ๅผ€ๅ‘**๏ผšmagic + context7 + playwright -- **ไผไธš้‡ๆž„**๏ผšserena + morphllm + sequential-thinking -- **ๅคๆ‚ๅˆ†ๆž**๏ผšsequential-thinking + context7 + serena - -## ้›†ๆˆ - -**ไธŽ SuperClaude ๅ‘ฝไปค๏ผš** -- ๅˆ†ๆžๅ‘ฝไปค่‡ชๅŠจไฝฟ็”จ Sequential + Serena -- ๅฎž็Žฐๅ‘ฝไปคไฝฟ็”จ Magic + Context7 -- ๆต‹่ฏ•ๅ‘ฝไปคไฝฟ็”จ Playwright + Sequential - -**ไธŽ่กŒไธบๆจกๅผ๏ผš** -- ๅคด่„‘้ฃŽๆšดๆจกๅผ๏ผšSequential ็”จไบŽๅ‘็Žฐ -- ไปปๅŠก็ฎก็†๏ผšSerena ็”จไบŽๆŒไน…ๅŒ– -- ็ผ–ๆŽ’ๆจกๅผ๏ผšๆœ€ไฝณๆœๅŠกๅ™จ้€‰ๆ‹ฉ - -**ๆ€ง่ƒฝๆŽงๅˆถ๏ผš** -- ๅŸบไบŽ็ณป็ปŸ่ดŸ่ฝฝ็š„่‡ชๅŠจ่ต„ๆบ็ฎก็† -- ๅนถๅ‘ๆŽงๅˆถ๏ผš`--concurrency N` (1-15) -- ๅœจ็บฆๆŸๆกไปถไธ‹ๅŸบไบŽไผ˜ๅ…ˆ็บง็š„ๆœๅŠกๅ™จ้€‰ๆ‹ฉ - -## ็›ธๅ…ณ่ต„ๆบ - -**ๅฟ…่ฏป่ต„ๆ–™๏ผš** -- [ๅ‘ฝไปคๆŒ‡ๅ—](commands.md) - ๆฟ€ๆดป MCP ๆœๅŠกๅ™จ็š„ๅ‘ฝไปค -- [ๅฟซ้€Ÿๅผ€ๅง‹ๆŒ‡ๅ—](../Getting-Started/quick-start.md) - MCP ่ฎพ็ฝฎๆŒ‡ๅ— - -**้ซ˜็บงไฝฟ็”จ๏ผš** -- [่กŒไธบๆจกๅผ](modes.md) - ๆจกๅผ-MCP ๅ่ฐƒ -- [ๆ™บ่ƒฝไฝ“ๆŒ‡ๅ—](agents.md) - ๆ™บ่ƒฝไฝ“-MCP ้›†ๆˆ -- [ไผš่ฏ็ฎก็†](session-management.md) - Serena ๅทฅไฝœๆต - -**ๆŠ€ๆœฏๅ‚่€ƒ๏ผš** -- [็คบไพ‹ๆ‰‹ๅ†Œ](../Reference/examples-cookbook.md) - MCP ๅทฅไฝœๆตๆจกๅผ -- [ๆŠ€ๆœฏๆžถๆž„](../Developer-Guide/technical-architecture.md) - ้›†ๆˆ่ฏฆๆƒ… \ No newline at end of file diff --git a/docs/User-Guide-zh/modes.md b/docs/User-Guide-zh/modes.md deleted file mode 100644 index 3e915d3..0000000 --- a/docs/User-Guide-zh/modes.md +++ /dev/null @@ -1,603 +0,0 @@ -# SuperClaude ่กŒไธบๆจกๅผๆŒ‡ๅ— ๐Ÿง  - -## โœ… ๅฟซ้€Ÿ้ชŒ่ฏ -ไฝฟ็”จ `/sc:` ๅ‘ฝไปคๆต‹่ฏ•ๆจกๅผ - ๅฎƒไปฌไผšๆ นๆฎไปปๅŠกๅคๆ‚ๆ€ง่‡ชๅŠจๆฟ€ๆดปใ€‚ๆœ‰ๅ…ณๅฎŒๆ•ดๅ‘ฝไปคๅ‚่€ƒ๏ผŒ่ฏทๅ‚้˜… [ๅ‘ฝไปคๆŒ‡ๅ—](commands.md)ใ€‚ - -## ๅฟซ้€Ÿๅ‚่€ƒ่กจ - -| ๆจกๅผ | ็›ฎ็š„ | ่‡ชๅŠจ่งฆๅ‘ | ๅ…ณ้”ฎ่กŒไธบ | ๆœ€้€‚ๅˆ | -|------|---------|---------------|---------------|---------------| -| **๐Ÿง  ๅคด่„‘้ฃŽๆšด** | ไบคไบ’ๅผๅ‘็Žฐ | "brainstorm"ใ€"maybe"ใ€ๆจก็ณŠ่ฏทๆฑ‚ | ่‹ๆ ผๆ‹‰ๅบ•ๅผ้—ฎ้ข˜ใ€้œ€ๆฑ‚ๅ‘ๆŽ˜ | ๆ–ฐ้กน็›ฎ่ง„ๅˆ’ใ€ไธๆ˜Ž็กฎ้œ€ๆฑ‚ | -| **๐Ÿ” ๅ†…็œ** | ๅ…ƒ่ฎค็Ÿฅๅˆ†ๆž | ้”™่ฏฏๆขๅคใ€"ๅˆ†ๆžๆŽจ็†" | ้€ๆ˜Žๆ€็ปดๆ ‡่ฎฐ (๐Ÿค”, ๐ŸŽฏ, ๐Ÿ’ก) | ่ฐƒ่ฏ•ใ€ๅญฆไน ใ€ไผ˜ๅŒ– | -| **๐Ÿ“‹ ไปปๅŠก็ฎก็†** | ๅคๆ‚ๅ่ฐƒ | >3 ๆญฅ้ชคใ€>2 ็›ฎๅฝ• | ้˜ถๆฎตๅˆ†่งฃใ€ๅ†…ๅญ˜ๆŒไน…ๅŒ– | ๅคšๆญฅๆ“ไฝœใ€้กน็›ฎ็ฎก็† | -| **๐ŸŽฏ ็ผ–ๆŽ’** | ๆ™บ่ƒฝๅทฅๅ…ท้€‰ๆ‹ฉ | ๅคšๅทฅๅ…ทๆ“ไฝœใ€้ซ˜่ต„ๆบไฝฟ็”จ | ๆœ€ไผ˜ๅทฅๅ…ท่ทฏ็”ฑใ€ๅนถ่กŒๆ‰ง่กŒ | ๅคๆ‚ๅˆ†ๆžใ€ๆ€ง่ƒฝไผ˜ๅŒ– | -| **โšก ไปค็‰Œๆ•ˆ็Ž‡** | ๅŽ‹็ผฉ้€šไฟก | ้ซ˜ไธŠไธ‹ๆ–‡ไฝฟ็”จใ€`--uc` ๆ ‡ๅฟ— | ็ฌฆๅท็ณป็ปŸ๏ผŒ้ข„่ฎกๅ‡ๅฐ‘ 30-50% ไปค็‰Œ | ่ต„ๆบ็บฆๆŸใ€ๅคงๅž‹ๆ“ไฝœ | - - ---- - -## ๅ…ฅ้—จๆŒ‡ๅ—๏ผˆ2 ๅˆ†้’Ÿๆฆ‚่งˆ๏ผ‰ - -**ๆจกๅผ้€š่ฟ‡่กŒไธบๆŒ‡ไปคๆฟ€ๆดป** - Claude Code ่ฏปๅ–ไธŠไธ‹ๆ–‡ๆ–‡ไปถ๏ผŒๆ นๆฎๆ‚จ็š„ไปปๅŠกๆจกๅผๅ’Œๅคๆ‚ๆ€งๆฅๅ†ณๅฎš้‡‡็”จๅ“ช็งๆจกๅผ่กŒไธบใ€‚ - -**ๅฟซ้€Ÿ็คบไพ‹๏ผš** -```bash -# ่‡ชๅŠจๆฟ€ๆดป็คบไพ‹ -/sc:brainstorm "mobile app" # โ†’ ่‹ๆ ผๆ‹‰ๅบ•ๅผๅ‘็Žฐ้—ฎ้ข˜ -/sc:implement "authentication system" # โ†’ ๅคš้˜ถๆฎตๅ่ฐƒ -"--uc analyze large-codebase/" # โ†’ ๅŽ‹็ผฉ็ฌฆๅท่พ“ๅ‡บ -``` - -**ไฝ•ๆ—ถไฝฟ็”จๆ‰‹ๅŠจๆ ‡ๅฟ—๏ผš** -- ้œ€่ฆ็‰นๅฎš่กŒไธบ๏ผš`--brainstorm`ใ€`--introspect`ใ€`--uc` -- ไธบๅญฆไน /่ฐƒ่ฏ•่€Œ่ฆ†็›–่‡ชๅŠจๆฃ€ๆต‹ -- ้’ˆๅฏน็‰นๅฎš็บฆๆŸ่ฟ›่กŒไผ˜ๅŒ–๏ผˆๅ†…ๅญ˜ใ€ๆ—ถ้—ดใ€ๆธ…ๆ™ฐๅบฆ๏ผ‰ - ---- - -## ๆจกๅผ่ฏฆๆƒ… - -### ๐Ÿง  ๅคด่„‘้ฃŽๆšดๆจกๅผ - ไบคไบ’ๅผๅ‘็Žฐ - -**็›ฎ็š„**๏ผš้€š่ฟ‡ๅไฝœๅ‘็Žฐๅฐ†ๆจก็ณŠ็š„ๆƒณๆณ•่ฝฌๅŒ–ไธบ็ป“ๆž„ๅŒ–็š„้œ€ๆฑ‚ใ€‚ - -**่‡ชๅŠจๆฟ€ๆดป่งฆๅ‘ๅ™จ๏ผš** -- ๆจก็ณŠ็š„้กน็›ฎ่ฏทๆฑ‚๏ผš"ๆˆ‘ๆƒณๆž„ๅปบ..."ใ€"ๆญฃๅœจ่€ƒ่™‘ๅˆ›ๅปบ..." -- ๆŽข็ดขๅ…ณ้”ฎ่ฏ๏ผšbrainstormใ€exploreใ€discussใ€figure outใ€not sure -- ไธ็กฎๅฎšๆŒ‡็คบๅ™จ๏ผš"maybe"ใ€"possibly"ใ€"could we" -- ๆ‰‹ๅŠจๆ ‡ๅฟ—๏ผš`--brainstorm`ใ€`--bs` - -**่กŒไธบๅ˜ๅŒ–๏ผš** -- **่‹ๆ ผๆ‹‰ๅบ•ๅผๆ้—ฎ**๏ผšๆๅ‡บๆŽขๆ€ง้—ฎ้ข˜ไปฅๅ‘ๆŽ˜้š่—้œ€ๆฑ‚ -- **้ž้ข„่ฎพๆ€งๆ–นๆณ•**๏ผš้ฟๅ…ๅ‡่ฎพ๏ผŒ่ฎฉๆ‚จๅผ•ๅฏผๅ‘็Žฐๆ–นๅ‘ -- **ๅไฝœไผ™ไผดๅ…ณ็ณป**๏ผšๅœจๆŽข็ดขไธญไธŽๆ‚จๅˆไฝœ๏ผŒ่€Œไธๆ˜ฏๆŒ‡ๅฏผๆ€งๅ’จ่ฏข -- **้œ€ๆฑ‚็ปผๅˆ**๏ผšๅฐ†่ง่งฃ่ฝฌๅŒ–ไธบ็ป“ๆž„ๅŒ–็š„ๆŠ€ๆœฏ็ฎ€ๆŠฅ -- **่ทจไผš่ฏๅ†…ๅญ˜**๏ผšไธบๅŽ็ปญ่ฎจ่ฎบ็ปดๆŠคๅ‘็ŽฐไธŠไธ‹ๆ–‡ - -**ไฝ“้ชŒ็คบไพ‹:** -``` -Standard Approach: "I'll build a user authentication system with JWT tokens..." -Brainstorming Approach: -"๐Ÿค” Let's explore this together: - - What specific user problems does auth solve for your app? - - Who are your users and what's their technical comfort level? - - Any existing systems or social logins to integrate with? - - What security/compliance requirements do you have? - ๐Ÿ“ Outcome: Detailed auth requirements brief ready for implementation" -``` - -#### ๆˆๅŠŸๆ ‡ๅ‡† -- [ ] ็”จ้—ฎ้ข˜่€Œไธๆ˜ฏ็›ดๆŽฅ่งฃๅ†ณๆ–นๆกˆๆฅๅ›žๅบ” -- [ ] ้—ฎ้ข˜ๆŽข็ดข็”จๆˆท้œ€ๆฑ‚ใ€ๆŠ€ๆœฏ็บฆๆŸๅ’ŒไธšๅŠก็›ฎๆ ‡ -- [ ] ๅœจๆ•ดไธชๅ‘็Žฐ่ฟ‡็จ‹ไธญไฟๆŒๅไฝœ่ฏญ่ฐƒ -- [ ] ไบง็”Ÿ็ป“ๆž„ๅŒ–้œ€ๆฑ‚ๆˆ–ๆŠ€ๆœฏ็ฎ€ไป‹ไฝœไธบ็ป“ๆžœ - -**้ชŒ่ฏ๏ผš** `/sc:brainstorm "web app"` ๅบ”่ฏฅ่ฏข้—ฎ็”จๆˆทใ€ๅŠŸ่ƒฝใ€ๆŠ€ๆœฏ็›ธๅ…ณ้—ฎ้ข˜ -**ๆต‹่ฏ•๏ผš** ๆจก็ณŠ่ฏทๆฑ‚ๅบ”่ฏฅ่งฆๅ‘ๅ‘็Žฐๆ€ง้—ฎ้ข˜๏ผŒ่€Œไธๆ˜ฏๅ‡่ฎพ -**ๆฃ€ๆŸฅ๏ผš** ๆจกๅผๅบ”่ฏฅๅœจๅŒไธ€ไผš่ฏ็š„ๅŽ็ปญ้—ฎ้ข˜ไธญไฟๆŒไธ€่‡ด - -**ๆœ€ไฝณๆญ้…๏ผš** -- **โ†’ ไปปๅŠก็ฎก็†**๏ผš้œ€ๆฑ‚ๅ‘็Žฐ โ†’ ็ณป็ปŸๆ€งๅฎžๆ–ฝ่ง„ๅˆ’ -- **โ†’ ็ผ–ๆŽ’**๏ผš้œ€ๆฑ‚ๆ˜Ž็กฎๅŒ– โ†’ ๅฎžๆ–ฝ็š„ๆœ€ไผ˜ๅทฅๅ…ท้€‰ๆ‹ฉ -- **ๆ‰‹ๅŠจ่ฆ†็›–**๏ผšไฝฟ็”จ `--brainstorm` ๅผบๅˆถๅ‘็Žฐ๏ผŒๅณไฝฟๅฏนไบŽ"ๆ˜Ž็กฎ"็š„้œ€ๆฑ‚ - ---- - -### ๐Ÿ” ๅ†…็œๆจกๅผ - ๅ…ƒ่ฎค็Ÿฅๅˆ†ๆž - -**็›ฎ็š„**๏ผšไธบๅญฆไน ไผ˜ๅŒ–ๅ’Œ้€ๆ˜Žๅ†ณ็ญ–ๅˆถๅฎšๆšด้œฒๆŽจ็†่ฟ‡็จ‹ใ€‚ - -**่‡ชๅŠจๆฟ€ๆดป่งฆๅ‘ๅ™จ๏ผš** -- ่‡ชๆˆ‘ๅˆ†ๆž่ฏทๆฑ‚๏ผš"ๅˆ†ๆžๆˆ‘็š„ๆŽจ็†"ใ€"ๅๆ€ๅ†ณ็ญ–" -- ้”™่ฏฏๆขๅคๅœบๆ™ฏๅ’Œ้œ€่ฆ่ฐƒๆŸฅ็š„ๆ„ๅค–็ป“ๆžœ -- ๅ…ทๆœ‰ๅคš็งๅฏ่กŒๆ–นๆณ•็š„ๅคๆ‚้—ฎ้ข˜ๆฑ‚่งฃ -- ไผ˜ๅŒ–ๆœบไผš็š„ๆจกๅผ่ฏ†ๅˆซ้œ€ๆฑ‚ -- ๆ‰‹ๅŠจๆ ‡ๅฟ—๏ผš`--introspect` - -**่กŒไธบๅ˜ๅŒ–๏ผš** -- **ๆŽจ็†้€ๆ˜Žๅบฆ**๏ผš้€š่ฟ‡ๆธ…ๆ™ฐๆ ‡่ฎฐๆšด้œฒๆ€็ปด่ฟ‡็จ‹ (๐Ÿค”, ๐ŸŽฏ, โšก, ๐Ÿ“Š, ๐Ÿ’ก) -- **ๅ†ณ็ญ–ๅˆ†ๆž**๏ผš่ฏ„ไผฐ้€‰ๆ‹ฉ้€ป่พ‘ๅนถ่€ƒ่™‘ๆ›ฟไปฃๆ–นๆกˆ -- **ๆจกๅผ่ฏ†ๅˆซ**๏ผš่ฏ†ๅˆซ้‡ๅค่กŒไธบๅ’Œๆ”น่ฟ›ๆœบไผš -- **ๅ…ƒๅญฆไน **๏ผšๆๅ–่ง่งฃไปฅๆŒ็ปญๆ”น่ฟ›ๆก†ๆžถ -- **ๆก†ๆžถๅˆ่ง„ๆ€ง**๏ผšๆ นๆฎ SuperClaude ๅŽŸๅˆ™ๅ’Œ่ดจ้‡้—จๆŽง้ชŒ่ฏ่กŒไธบ - -**ไฝ“้ชŒ็คบไพ‹๏ผš** -``` -Standard Approach: "I'll analyze this code structure and suggest improvements..." -Introspective Approach: -"๐Ÿง  Meta-Analysis: Why did I choose structural analysis over functional flow analysis? - ๐ŸŽฏ Decision Logic: Saw class hierarchy โ†’ assumed OOP patterns dominate - ๐Ÿ”„ Alternative Considered: Data flow analysis might reveal hidden dependencies - ๐Ÿ“Š Evidence Check: File imports suggest functional composition, not OOP - ๐Ÿ’ก Learning: Need to analyze imports before choosing analysis strategy - โšก Correction: Switching to functional flow analysis approach" -``` - -**ๆœ€ไฝณๆญ้…๏ผš** -- **โ†’ ไปปๅŠก็ฎก็†**๏ผšไธบๅคๆ‚้˜ถๆฎตๅ†ณ็ญ–ๆไพ›้€ๆ˜ŽๆŽจ็† -- **ไปปไฝ•ๆจกๅผ**๏ผšไธบไปปไฝ•ๅ…ถไป–ๆจกๅผ็š„ๆ“ไฝœๆทปๅŠ ๆŽจ็†้€ๆ˜Žๅบฆๅฑ‚ -- **ๆ‰‹ๅŠจ่ฆ†็›–**๏ผšๅœจๅญฆไน ไผš่ฏๅ’Œ่ฐƒ่ฏ•ๅทฅไฝœๆตไธญไฝฟ็”จ `--introspect` - ---- - -### ๐Ÿ“‹ ไปปๅŠก็ฎก็†ๆจกๅผ - ๅคๆ‚ๅ่ฐƒ - -**็›ฎ็š„**๏ผšๅ…ทๆœ‰ไผš่ฏๆŒไน…ๆ€ง็š„ๅˆ†ๅฑ‚ไปปๅŠก็ป„็ป‡๏ผŒ็”จไบŽๅคšๆญฅๆ“ไฝœใ€‚ - -**่‡ชๅŠจๆฟ€ๆดป่งฆๅ‘ๅ™จ๏ผš** -- ้œ€่ฆ่ถ…่ฟ‡ 3 ไธชๅ่ฐƒๆญฅ้ชค็š„ๆ“ไฝœ -- ๅคšๆ–‡ไปถ/็›ฎๅฝ•่Œƒๅ›ด๏ผˆ>2 ็›ฎๅฝ•ๆˆ– >3 ๆ–‡ไปถ๏ผ‰ -- ้œ€่ฆ้˜ถๆฎตๅ’Œๆฃ€ๆŸฅ็‚น็š„ๅคๆ‚ไพ่ต–ๅ…ณ็ณป -- ่ดจ้‡ๆ”น่ฟ›่ฏทๆฑ‚๏ผšๅฎŒๅ–„ใ€ไผ˜ๅŒ–ใ€ๅขžๅผบ -- ๆ‰‹ๅŠจๆ ‡ๅฟ—๏ผš`--task-manage`ใ€`--delegate` - -**่กŒไธบๅ˜ๅŒ–๏ผš** -- **ๅˆ†ๅฑ‚่ง„ๅˆ’**๏ผšๅฐ†ๅคๆ‚ๅทฅไฝœๅˆ†่งฃไธบ่ฎกๅˆ’ โ†’ ้˜ถๆฎต โ†’ ไปปๅŠก โ†’ ๅพ…ๅŠž็ป“ๆž„ -- **ไผš่ฏๆŒไน…ๆ€ง**๏ผšๅœจไธญๆ–ญๆœŸ้—ด็ปดๆŠค้กน็›ฎไธŠไธ‹ๆ–‡ๅ’Œ่ฟ›ๅบฆ -- **ๅ†…ๅญ˜้›†ๆˆ**๏ผšไฝฟ็”จ write_memory/read_memory ่ฟ›่กŒ็Šถๆ€ไฟๅญ˜ -- **่ฟ›ๅบฆ็ผ–ๆŽ’**๏ผšๅ่ฐƒ TodoWrite ไธŽๅ†…ๅญ˜ๆ›ดๆ–ฐไปฅ่ฟ›่กŒ่ทŸ่ธช -- **่ดจ้‡้—จๆŽง**๏ผšๅœจ้˜ถๆฎตไน‹้—ดๅฎžๆ–ฝ็ณป็ปŸ้ชŒ่ฏๆฃ€ๆŸฅ็‚น - -**ไฝ“้ชŒ็คบไพ‹๏ผš** -``` -Standard Approach: "I'll implement user authentication..." โ†’ Direct implementation -Task Management Approach: -"๐Ÿ“‹ Multi-Phase Implementation Plan: - ๐ŸŽฏ Phase 1: Security requirements analysis (Session 1) - ๐ŸŽฏ Phase 2: API design & documentation (Session 2) - ๐ŸŽฏ Phase 3: Implementation & testing (Sessions 3-4) - ๐ŸŽฏ Phase 4: Integration & validation (Session 5) - ๐Ÿ’พ Session Persistence: Auto-resume context - โœ“ Quality Gates: Validation before each phase transition" -``` - -**ๆœ€ไฝณๆญ้…๏ผš** -- **ๅคด่„‘้ฃŽๆšด โ†’**๏ผš้œ€ๆฑ‚ๅ‘็Žฐ็„ถๅŽ็ณป็ปŸๅŒ–ๅฎžๆ–ฝ -- **+ ็ผ–ๆŽ’**๏ผšไปปๅŠกๅ่ฐƒไธŽๆœ€ไผ˜ๅทฅๅ…ท้€‰ๆ‹ฉ -- **+ ๅ†…็œ**๏ผšๅคๆ‚้˜ถๆฎตๅ†ณ็ญ–็š„้€ๆ˜ŽๆŽจ็† - ---- - -### ๐ŸŽฏ ็ผ–ๆŽ’ๆจกๅผ - ๆ™บ่ƒฝๅทฅๅ…ท้€‰ๆ‹ฉ - -**็›ฎ็š„**๏ผš้€š่ฟ‡ๆ™บ่ƒฝๅทฅๅ…ท่ทฏ็”ฑๅ’Œๅนถ่กŒๅ่ฐƒไผ˜ๅŒ–ไปปๅŠกๆ‰ง่กŒใ€‚ - -**่‡ชๅŠจๆฟ€ๆดป่งฆๅ‘ๅ™จ๏ผš** -- ้œ€่ฆๅคๆ‚ๅ่ฐƒ็š„ๅคšๅทฅๅ…ทๆ“ไฝœ -- ๆ€ง่ƒฝ็บฆๆŸ๏ผˆ้ซ˜่ต„ๆบไฝฟ็”จ๏ผ‰ -- ๅนถ่กŒๆ‰ง่กŒๆœบไผš๏ผˆ>3 ไธช็‹ฌ็ซ‹ๆ–‡ไปถ/ๆ“ไฝœ๏ผ‰ -- ๅ…ทๆœ‰ๅคš็งๆœ‰ๆ•ˆๅทฅๅ…ทๆ–นๆณ•็š„ๅคๆ‚่ทฏ็”ฑๅ†ณ็ญ– - -**่กŒไธบๅ˜ๅŒ–๏ผš** -- **ๆ™บ่ƒฝๅทฅๅ…ท่ทฏ็”ฑ**๏ผšไธบๆฏ็งไปปๅŠก็ฑปๅž‹้€‰ๆ‹ฉๆœ€ไผ˜็š„ MCP ๆœๅŠกๅ™จๅ’ŒๅŽŸ็”Ÿๅทฅๅ…ท -- **่ต„ๆบๆ„Ÿ็Ÿฅ**๏ผšๅŸบไบŽ็ณป็ปŸ็บฆๆŸๅ’Œๅฏ็”จๆ€ง่ฐƒๆ•ดๆ–นๆณ• -- **ๅนถ่กŒไผ˜ๅŒ–**๏ผš่ฏ†ๅˆซ็‹ฌ็ซ‹ๆ“ไฝœไปฅ่ฟ›่กŒๅนถๅ‘ๆ‰ง่กŒ -- **ๅ่ฐƒ็„ฆ็‚น**๏ผš้€š่ฟ‡ๅ่ฐƒๆ‰ง่กŒไผ˜ๅŒ–ๅทฅๅ…ท้€‰ๆ‹ฉๅ’Œไฝฟ็”จ -- **่‡ช้€‚ๅบ”ๅ›ž้€€**๏ผšๅฝ“้ฆ–้€‰้€‰้กนไธๅฏ็”จๆ—ถไผ˜้›…ๅœฐๅˆ‡ๆขๅทฅๅ…ท - -**ไฝ“้ชŒ็คบไพ‹๏ผš** -``` -Standard Approach: Sequential file-by-file analysis and editing -Orchestration Approach: -"๐ŸŽฏ Multi-Tool Coordination Strategy: - ๐Ÿ” Phase 1: Serena (semantic analysis) + Sequential (architecture review) - โšก Phase 2: Morphllm (pattern edits) + Magic (UI components) - ๐Ÿงช Phase 3: Playwright (testing) + Context7 (doc patterns) - ๐Ÿ”„ Parallel Execution: 3 tools working simultaneously" -``` - -**ๆœ€ไฝณๆญ้…๏ผš** -- **ไปปๅŠก็ฎก็† โ†’**๏ผšไธบๅคๆ‚ๅคš้˜ถๆฎต่ฎกๅˆ’ๆไพ›ๅทฅๅ…ทๅ่ฐƒ -- **+ ไปค็‰Œๆ•ˆ็Ž‡**๏ผšๅธฆๅŽ‹็ผฉ้€šไฟก็š„ๆœ€ไผ˜ๅทฅๅ…ท้€‰ๆ‹ฉ -- **ไปปไฝ•ๅคๆ‚ไปปๅŠก**๏ผšๆทปๅŠ ๆ™บ่ƒฝๅทฅๅ…ท่ทฏ็”ฑไปฅๅขžๅผบๆ‰ง่กŒ - ---- - -### โšก ไปค็‰Œๆ•ˆ็Ž‡ๆจกๅผ - ๅŽ‹็ผฉ้€šไฟก - -**็›ฎ็š„**๏ผš้€š่ฟ‡็ฌฆๅท็ณป็ปŸๅฎž็Žฐ้ข„่ฎก 30-50% ็š„ไปค็‰Œๅ‡ๅฐ‘๏ผŒๅŒๆ—ถไฟๆŒไฟกๆฏ่ดจ้‡ใ€‚ - -**่‡ชๅŠจๆฟ€ๆดป่งฆๅ‘ๅ™จ๏ผš** -- ้ซ˜ไธŠไธ‹ๆ–‡ไฝฟ็”จๆŽฅ่ฟ‘้™ๅˆถ -- ้œ€่ฆ่ต„ๆบๆ•ˆ็Ž‡็š„ๅคง่ง„ๆจกๆ“ไฝœ -- ็”จๆˆทๆ˜พๅผๆ ‡ๅฟ—๏ผš`--uc`ใ€`--ultracompressed` -- ๅ…ทๆœ‰ๅคšไธช่พ“ๅ‡บ็š„ๅคๆ‚ๅˆ†ๆžๅทฅไฝœๆต - -**่กŒไธบๅ˜ๅŒ–๏ผš** -- **็ฌฆๅท้€šไฟก**๏ผšไธบ้€ป่พ‘ๆต็จ‹ใ€็Šถๆ€ๅ’ŒๆŠ€ๆœฏ้ข†ๅŸŸไฝฟ็”จ่ง†่ง‰็ฌฆๅท -- **ๆŠ€ๆœฏ็ผฉๅ†™**๏ผšๅฏน้‡ๅคๆŠ€ๆœฏๆœฏ่ฏญ่ฟ›่กŒไธŠไธ‹ๆ–‡ๆ„Ÿ็ŸฅๅŽ‹็ผฉ -- **็ป“ๆž„ๅŒ–ๅฏ†ๅบฆ**๏ผšไฝฟ็”จ่ฆ็‚นใ€่กจๆ ผๅ’Œ็ฎ€ๆดๆ ผๅผ๏ผŒ่€Œ้žๅ†—้•ฟๆฎต่ฝ -- **ไฟกๆฏไฟ็•™**๏ผšๅฐฝ็ฎกๅŽ‹็ผฉ๏ผŒไปไฟๆŒ โ‰ฅ95% ็š„ไฟกๆฏ่ดจ้‡ -- **็ป“ๆž„ๅŒ–ๆ ผๅผ**๏ผšไธบๆธ…ๆ™ฐๅบฆๅ’ŒไปปๅŠกๅฎŒๆˆ่€Œ็ป„็ป‡ - -**ไฝ“้ชŒ็คบไพ‹๏ผš** -``` -Standard Approach: "Authentication system implementation shows security vulnerability in user validation function requiring immediate attention..." -Token-Efficient Approach: -"๐Ÿ›ก๏ธ Security Alert: - auth.js:45 โ†’ user val() โ†’ critical vuln - ๐Ÿ“Š Impact: โŒ possible token bypass - โšก Action: fix validation + audit โˆต high severity - ๐Ÿ”ง Estimate: 2hr impl + 1hr test" -``` - -**ๆœ€ไฝณๆญ้…๏ผš** -- **ไปปไฝ•ๆจกๅผ**๏ผšๅœจไฟๆŒ็‰นๅฎšๆจกๅผ่กŒไธบ็š„ๅŒๆ—ถๆทปๅŠ ๅŽ‹็ผฉๅฑ‚ -- **็ผ–ๆŽ’ โ†’**๏ผšๅŽ‹็ผฉ็š„ๅทฅๅ…ทๅ่ฐƒๅ’Œ็Šถๆ€ๆ›ดๆ–ฐ -- **ๆ‰‹ๅŠจ่ฆ†็›–**๏ผšๅฝ“ไธŠไธ‹ๆ–‡ๅŽ‹ๅŠ›ๆˆ–ๆ•ˆ็Ž‡ๆ˜ฏไผ˜ๅ…ˆ็บงๆ—ถไฝฟ็”จ `--uc` - ---- - -### ๐ŸŽจ ๆ ‡ๅ‡†ๆจกๅผ - ๅ‡่กก้ป˜่ฎค - -**็›ฎ็š„**๏ผšไธบ็›ดๆŽฅ็š„ๅผ€ๅ‘ไปปๅŠกๆไพ›ๆธ…ๆ™ฐใ€ไธ“ไธš็š„ๆฒŸ้€šใ€‚ - -**่‡ชๅŠจๆฟ€ๆดป่งฆๅ‘ๅ™จ๏ผš** -- ๆฒกๆœ‰ๅคๆ‚ๆ€งๆŒ‡ๆ ‡็š„็ฎ€ๅ•ใ€ๆ˜Ž็กฎๅฎšไน‰็š„ไปปๅŠก -- ๅ…ทๆœ‰ๆ˜Ž็กฎ่ฆๆฑ‚็š„ๅ•ๆ–‡ไปถๆ“ไฝœ -- ๅŸบๆœฌ่งฃ้‡Šๅ’Œๆ ‡ๅ‡†ๅผ€ๅ‘ๅทฅไฝœๆต -- ๆœชๆฃ€ๆต‹ๅˆฐๅ…ถไป–ๆจกๅผ่งฆๅ‘ๅ™จ๏ผˆ้ป˜่ฎคๅ›ž้€€๏ผ‰ - -**่กŒไธบๅ˜ๅŒ–๏ผš** -- **ไธ“ไธšๆฒŸ้€š**๏ผšๆธ…ๆ™ฐใ€็ฎ€ๆด็š„ๆŠ€ๆœฏ่ฏญ่จ€๏ผŒๆ— ๅŽ‹็ผฉ -- **้€‚ๅบฆ็ป†่Š‚**๏ผš้€‚ๅˆๅคงๅคšๆ•ฐๅผ€ๅ‘ไปปๅŠก็š„ๅนณ่กกไฟกๆฏๆทฑๅบฆ -- **ๆ ‡ๅ‡†ๅทฅๅ…ท้€‰ๆ‹ฉ**๏ผšไฝฟ็”จๅŽŸ็”Ÿ Claude ่ƒฝๅŠ›ๅ’ŒๅŸบๆœฌๅทฅๅ…ท -- **่ดจ้‡็„ฆ็‚น**๏ผšๅœจๆ— ๅคๆ‚็ผ–ๆŽ’ๅผ€้”€็š„ๆƒ…ๅ†ตไธ‹ไฟๆŒไปฃ็ ่ดจ้‡ -- **ๅ“ๅบ”ๅผ้€‚ๅบ”**๏ผšๅฝ“ๅคๆ‚ๆ€งๅขžๅŠ ๆ—ถๅ‡†ๅค‡ๅˆ‡ๆขๅˆฐไธ“้—จๆจกๅผ - -**ไฝ“้ชŒ็คบไพ‹๏ผš** -``` -Standard Approach: Consistent, professional baseline for all tasks -"I'll implement the login functionality with proper error handling: - - 1. Validate user input (email format, password requirements) - 2. Authenticate against database with secure hashing - 3. Generate JWT token with appropriate expiration - 4. Return success response with user data - - Implementation will follow security best practices and include comprehensive error handling." -``` - -**ๆœ€ไฝณๆญ้…๏ผš** -- **โ†’ ไปปไฝ•ๆจกๅผ**๏ผšไฝœไธบๅ…ถไป–ๆจกๅผๅขžๅผบ็š„ๅŸบ็บฟ -- **ๆจกๅผๅˆ‡ๆข**๏ผš้œ€่ฆๆ—ถ่‡ชๅŠจๅ‡็บงๅˆฐไธ“้—จๆจกๅผ -- **ๆธ…ๆ™ฐไผ˜ๅ…ˆ**๏ผšๅฝ“็›ดๆŽฅๆฒŸ้€šๆฏ”ไผ˜ๅŒ–ๆ›ด้‡่ฆๆ—ถ - ---- - -## ้ซ˜็บง็”จๆณ• - -### ๆจกๅผ็ป„ๅˆ - -**ๅคšๆจกๅผๅทฅไฝœๆต๏ผš** -```bash -# ๅ‘็Žฐ โ†’ ่ง„ๅˆ’ โ†’ ๅฎž็Žฐ -/sc:brainstorm "microservices architecture" --task-manage -# โ†’ ๅคด่„‘้ฃŽๆšด๏ผš้œ€ๆฑ‚ๅ‘็Žฐ -# โ†’ ไปปๅŠก็ฎก็†๏ผšๅคš้˜ถๆฎตๅ่ฐƒ - -# ้€ๆ˜Žๅ’Œ้ซ˜ๆ•ˆ็š„ๅˆ†ๆž -/sc:analyze legacy-system/ --introspect --uc -# โ†’ ๅ†…็œ๏ผš้€ๆ˜ŽๆŽจ็† -# โ†’ ไปค็‰Œๆ•ˆ็Ž‡๏ผšๅŽ‹็ผฉ่พ“ๅ‡บ -``` - -### ๆ‰‹ๅŠจๆจกๅผๆŽงๅˆถ - -**ๅผบๅˆถ็‰นๅฎš่กŒไธบ๏ผš** -- `--brainstorm`๏ผšไธบไปปไฝ•ไปปๅŠกๅผบๅˆถๅไฝœๅ‘็Žฐ -- `--introspect`๏ผšไธบไปปไฝ•ๆจกๅผๆทปๅŠ ๆŽจ็†้€ๆ˜Žๅบฆ -- `--task-manage`๏ผšๅฏ็”จๅˆ†ๅฑ‚ๅ่ฐƒ -- `--orchestrate`๏ผšไผ˜ๅŒ–ๅทฅๅ…ท้€‰ๆ‹ฉๅ’Œๅนถ่กŒๆ‰ง่กŒ -- `--uc`๏ผšไธบๆ•ˆ็Ž‡ๅŽ‹็ผฉ้€šไฟก - -**่ฆ†็›–็คบไพ‹๏ผš** -```bash -# ๅฏนโ€œๆ˜Ž็กฎโ€็š„้œ€ๆฑ‚ๅผบๅˆถๅคด่„‘้ฃŽๆšด -/sc:implement "user login" --brainstorm - -# ไธบ่ฐƒ่ฏ•ๆทปๅŠ ๆŽจ็†้€ๆ˜Žๅบฆ -# ไฝฟ็”จ้€ๆ˜ŽๆŽจ็†่ฐƒ่ฏ•่ฎค่ฏ้—ฎ้ข˜ - -# ไธบ็ฎ€ๅ•ๆ“ไฝœๅฏ็”จไปปๅŠก็ฎก็† -# ็ณป็ปŸๅŒ–ไปปๅŠก็ฎก็†ๆ›ดๆ–ฐๆ ทๅผๆ–‡ไปถ -``` - -### ๆจกๅผ่พน็•Œๅ’Œไผ˜ๅ…ˆ็บง - -**ๆจกๅผๆฟ€ๆดปๆ—ถๆœบ๏ผš** -1. **ๅคๆ‚ๅบฆ้˜ˆๅ€ผ**๏ผš>3 ๆ–‡ไปถ โ†’ ไปปๅŠก็ฎก็† -2. **่ต„ๆบๅŽ‹ๅŠ›**๏ผš้ซ˜ไธŠไธ‹ๆ–‡ไฝฟ็”จ โ†’ ไปค็‰Œๆ•ˆ็Ž‡ -3. **ๅคšๅทฅๅ…ท้œ€ๆฑ‚**๏ผšๅคๆ‚ๅˆ†ๆž โ†’ ็ผ–ๆŽ’ -4. **ไธ็กฎๅฎšๆ€ง**๏ผšๆจก็ณŠ้œ€ๆฑ‚ โ†’ ๅคด่„‘้ฃŽๆšด -5. **้”™่ฏฏๆขๅค**๏ผš้—ฎ้ข˜ โ†’ ๅ†…็œ - -**ไผ˜ๅ…ˆ็บง่ง„ๅˆ™๏ผš** -- **ๅฎ‰ๅ…จ็ฌฌไธ€**๏ผš่ดจ้‡ๅ’Œ้ชŒ่ฏๆ€ปๆ˜ฏ่ฆ†็›–ๆ•ˆ็Ž‡ -- **็”จๆˆทๆ„ๅ›พ**๏ผšๆ‰‹ๅŠจๆ ‡ๅฟ—่ฆ†็›–่‡ชๅŠจๆฃ€ๆต‹ -- **ไธŠไธ‹ๆ–‡้€‚ๅบ”**๏ผšๅŸบไบŽๅคๆ‚ๆ€งๅ †ๅ ๆจกๅผ -- **่ต„ๆบ็ฎก็†**๏ผšๅœจๅŽ‹ๅŠ›ไธ‹ๆฟ€ๆดปๆ•ˆ็Ž‡ๆจกๅผ - ---- - -## ็Žฐๅฎžไธ–็•Œ็คบไพ‹ - -### ๅฎŒๆ•ดๅทฅไฝœๆต็คบไพ‹ - -**ๆ–ฐ้กน็›ฎๅผ€ๅ‘๏ผš** -```bash -# ้˜ถๆฎต 1๏ผšๅ‘็Žฐ๏ผˆๅคด่„‘้ฃŽๆšดๆจกๅผ่‡ชๅŠจๆฟ€ๆดป๏ผ‰ -"I want to build a productivity app" -โ†’ ๐Ÿค” ๅ…ณไบŽ็”จๆˆทใ€ๅŠŸ่ƒฝใ€ๅนณๅฐ้€‰ๆ‹ฉ็š„่‹ๆ ผๆ‹‰ๅบ•ๅผ้—ฎ้ข˜ -โ†’ ๐Ÿ“ ็ป“ๆž„ๅŒ–้œ€ๆฑ‚็ฎ€ๆŠฅ - -# ้˜ถๆฎต 2๏ผš่ง„ๅˆ’๏ผˆไปปๅŠก็ฎก็†ๆจกๅผ่‡ชๅŠจๆฟ€ๆดป๏ผ‰ -/sc:implement "core productivity features" -โ†’ ๐Ÿ“‹ ๅธฆไพ่ต–ๅ…ณ็ณป็š„ๅคš้˜ถๆฎตๅˆ†่งฃ -โ†’ ๐ŸŽฏ ๅธฆ่ดจ้‡้—จๆŽง็š„้˜ถๆฎตๅ่ฐƒ - -# ้˜ถๆฎต 3๏ผšๅฎž็Žฐ๏ผˆ็ผ–ๆŽ’ๆจกๅผๅ่ฐƒๅทฅๅ…ท๏ผ‰ -/sc:implement "frontend and backend systems" -โ†’ ๐ŸŽฏ Magic (UI) + Context7 (ๆจกๅผ) + Sequential (ๆžถๆž„) -โ†’ โšก ๅนถ่กŒๆ‰ง่กŒไผ˜ๅŒ– -``` - -**่ฐƒ่ฏ•ๅคๆ‚้—ฎ้ข˜๏ผš** -```bash -# ้—ฎ้ข˜ๅˆ†ๆž๏ผˆๅ†…็œๆจกๅผ่‡ชๅŠจๆฟ€ๆดป๏ผ‰ -"Users experiencing intermittent authentication failures" -โ†’ ๐Ÿค” ๅ…ณไบŽๆฝœๅœจๅŽŸๅ› ็š„้€ๆ˜ŽๆŽจ็† -โ†’ ๐ŸŽฏ ๅ‡่ฎพๅฝขๆˆๅ’Œ่ฏๆฎๆ”ถ้›† -โ†’ ๐Ÿ’ก ่ทจ็›ธไผผ้—ฎ้ข˜็š„ๆจกๅผ่ฏ†ๅˆซ - -# ็ณป็ปŸๆ€ง่งฃๅ†ณ๏ผˆไปปๅŠก็ฎก็†ๅ่ฐƒ๏ผ‰ -# ๅ…จ้ขไฟฎๅค่ฎค่ฏ็ณป็ปŸ -โ†’ ๐Ÿ“‹ ้˜ถๆฎต 1๏ผšๆ นๅ› ๅˆ†ๆž -โ†’ ๐Ÿ“‹ ้˜ถๆฎต 2๏ผš่งฃๅ†ณๆ–นๆกˆๅฎž็Žฐ -โ†’ ๐Ÿ“‹ ้˜ถๆฎต 3๏ผšๆต‹่ฏ•ๅ’Œ้ชŒ่ฏ -``` - -### ๆจกๅผ็ป„ๅˆๆจกๅผ - -**้ซ˜ๅคๆ‚ๅบฆๅœบๆ™ฏ๏ผš** -```bash -# ๅธฆๅคš้‡็บฆๆŸ็š„ๅคงๅž‹้‡ๆž„ -/sc:improve legacy-system/ --introspect --uc --orchestrate -โ†’ ๐Ÿ” ้€ๆ˜ŽๆŽจ็†introspect๏ผˆๅ†…็œ๏ผ‰ -โ†’ โšก ๅŽ‹็ผฉ้€šไฟกuc๏ผˆไปค็‰Œๆ•ˆ็Ž‡๏ผ‰ -โ†’ ๐ŸŽฏ ๆœ€ไผ˜ๅทฅๅ…ทๅ่ฐƒorchestrate๏ผˆ็ผ–ๆŽ’๏ผ‰ -โ†’ ๐Ÿ“‹ ็ณป็ปŸๅŒ–้˜ถๆฎต๏ผˆไปปๅŠก็ฎก็†่‡ชๅŠจๆฟ€ๆดป๏ผ‰ -``` - ---- - -## ๅฟซ้€Ÿๅ‚่€ƒ - -### ๆจกๅผๆฟ€ๆดปๆจกๅผ - -| ่งฆๅ‘็ฑปๅž‹ | ่พ“ๅ…ฅ็คบไพ‹ | ๆฟ€ๆดปๆจกๅผ | ๅ…ณ้”ฎ่กŒไธบ | -|---------|---------|----------|----------| -| **ๆจก็ณŠ่ฏทๆฑ‚** | "ๆˆ‘ๆƒณๆž„ๅปบไธ€ไธชๅบ”็”จ" | ๐Ÿง  ๅคด่„‘้ฃŽๆšด | ่‹ๆ ผๆ‹‰ๅบ•ๅผๅ‘็Žฐ้—ฎ้ข˜ | -| **ๅคๆ‚่Œƒๅ›ด** | >3 ๆ–‡ไปถๆˆ– >2 ็›ฎๅฝ• | ๐Ÿ“‹ ไปปๅŠก็ฎก็† | ้˜ถๆฎตๅ่ฐƒ | -| **ๅคšๅทฅๅ…ท้œ€ๆฑ‚** | ๅˆ†ๆž + ๅฎžๆ–ฝ | ๐ŸŽฏ ็ผ–ๆŽ’ | ๅทฅๅ…ทไผ˜ๅŒ– | -| **้”™่ฏฏๆขๅค** | "่ฟ™ๆฒกๆœ‰ๆŒ‰้ข„ๆœŸๅทฅไฝœ" | ๐Ÿ” ๅ†…็œ | ้€ๆ˜ŽๆŽจ็† | -| **่ต„ๆบๅŽ‹ๅŠ›** | ้ซ˜ไธŠไธ‹ๆ–‡ไฝฟ็”จ | โšก ไปค็‰Œๆ•ˆ็Ž‡ | ็ฌฆๅทๅŽ‹็ผฉ | -| **็ฎ€ๅ•ไปปๅŠก** | "ไฟฎๅค่ฟ™ไธชๅ‡ฝๆ•ฐ" | ๐ŸŽจ ๆ ‡ๅ‡† | ๆธ…ๆ™ฐใ€็›ดๆŽฅ็š„ๆ–นๆณ• | - -### ๆ‰‹ๅŠจ่ฆ†็›–ๅ‘ฝไปค - -```bash -# ๅผบๅˆถ็‰นๅฎšๆจกๅผ่กŒไธบ -/sc:command --brainstorm # ๅไฝœๅ‘็Žฐ -/sc:command --introspect # ๆŽจ็†้€ๆ˜Žๅบฆ -/sc:command --task-manage # ๅˆ†ๅฑ‚ๅ่ฐƒ -/sc:command --orchestrate # ๅทฅๅ…ทไผ˜ๅŒ– -/sc:command --uc # ไปค็‰ŒๅŽ‹็ผฉ - -# ็ป„ๅˆๅคš็งๆจกๅผ -/sc:command --introspect --uc # ้€ๆ˜Ž + ้ซ˜ๆ•ˆ -/sc:command --task-manage --orchestrate # ๅ่ฐƒ + ไผ˜ๅŒ– -``` - ---- - -## ๆ•…้šœๆŽ’้™ค - -ๆœ‰ๅ…ณๆ•…้šœๆŽ’้™คๅธฎๅŠฉ๏ผŒ่ฏทๅ‚้˜…๏ผš -- [ๅธธ่ง้—ฎ้ข˜](../Reference/common-issues.md) - ้ข‘็น้—ฎ้ข˜็š„ๅฟซ้€Ÿไฟฎๅค -- [ๆ•…้šœๆŽ’้™คๆŒ‡ๅ—](../Reference/troubleshooting.md) - ๅ…จ้ข็š„้—ฎ้ข˜่งฃๅ†ณๆ–นๆกˆ - -### ๅธธ่ง้—ฎ้ข˜ -- **ๆจกๅผๆœชๆฟ€ๆดป**๏ผšไฝฟ็”จๆ‰‹ๅŠจๆ ‡ๅฟ—๏ผš`--brainstorm`ใ€`--introspect`ใ€`--uc` -- **ๆฟ€ๆดปไบ†้”™่ฏฏ็š„ๆจกๅผ**๏ผšๆฃ€ๆŸฅ่ฏทๆฑ‚ไธญ็š„ๅคๆ‚ๆ€ง่งฆๅ‘ๅ™จๅ’Œๅ…ณ้”ฎ่ฏ -- **ๆจกๅผๆ„ๅค–ๅˆ‡ๆข**๏ผšๅŸบไบŽไปปๅŠกๆผ”ๅŒ–็š„ๆญฃๅธธ่กŒไธบ -- **ๆ‰ง่กŒๅฝฑๅ“**๏ผšๆจกๅผไผ˜ๅŒ–ๅทฅๅ…ทไฝฟ็”จ๏ผŒไธๅบ”ๅฝฑๅ“ๆ‰ง่กŒ -- **ๆจกๅผๅ†ฒ็ช**๏ผšๆฃ€ๆŸฅ[ๆ ‡ๅฟ—ๆŒ‡ๅ—](flags.md)ไธญ็š„ๆ ‡ๅฟ—ไผ˜ๅ…ˆ็บง่ง„ๅˆ™ - -### ๅณๆ—ถไฟฎๅค -- **ๅผบๅˆถ็‰นๅฎšๆจกๅผ**๏ผšไฝฟ็”จๆ˜Ž็กฎๆ ‡ๅฟ—ๅฆ‚ `--brainstorm` ๆˆ– `--task-manage` -- **้‡็ฝฎๆจกๅผ่กŒไธบ**๏ผš้‡ๅฏ Claude Code ไผš่ฏไปฅ้‡็ฝฎๆจกๅผ็Šถๆ€ -- **ๆฃ€ๆŸฅๆจกๅผๆŒ‡็คบๅ™จ**๏ผšๅœจๅ“ๅบ”ไธญๆŸฅๆ‰พ ๐Ÿค”ใ€๐ŸŽฏใ€๐Ÿ“‹ ็ฌฆๅท -- **้ชŒ่ฏๅคๆ‚ๆ€ง**๏ผš็ฎ€ๅ•ไปปๅŠกไฝฟ็”จๆ ‡ๅ‡†ๆจกๅผ๏ผŒๅคๆ‚ไปปๅŠก่‡ชๅŠจๅˆ‡ๆข - -### ็‰นๅฎšๆจกๅผๆ•…้šœๆŽ’้™ค - -**ๅคด่„‘้ฃŽๆšดๆจกๅผ้—ฎ้ข˜๏ผš** -```bash -# ้—ฎ้ข˜๏ผšๆจกๅผ็ป™ๅ‡บ่งฃๅ†ณๆ–นๆกˆ่€Œไธๆ˜ฏ้—ฎ้ข˜ -# ๅฟซ้€Ÿไฟฎๅค๏ผšๆฃ€ๆŸฅ่ฏทๆฑ‚ๆธ…ๆ™ฐๅบฆๅนถไฝฟ็”จๆ˜พๅผๆ ‡ๅฟ— -/sc:brainstorm "web app" --brainstorm # ๅผบๅˆถๅ‘็Žฐๆจกๅผ -"I have a vague idea about..." # ไฝฟ็”จไธ็กฎๅฎš่ฏญ่จ€ -"Maybe we could build..." # ่งฆๅ‘ๆŽข็ดข -``` - -**ไปปๅŠก็ฎก็†ๆจกๅผ้—ฎ้ข˜๏ผš** -```bash -# ้—ฎ้ข˜๏ผš็ฎ€ๅ•ไปปๅŠกๅพ—ๅˆฐๅคๆ‚ๅ่ฐƒ -# ๅฟซ้€Ÿไฟฎๅค๏ผšๅ‡ๅฐ‘่Œƒๅ›ดๆˆ–ไฝฟ็”จๆ›ด็ฎ€ๅ•็š„ๅ‘ฝไปค -/sc:implement "function" --no-task-manage # ็ฆ็”จๅ่ฐƒ -/sc:troubleshoot bug.js # ไฝฟ็”จๅŸบๆœฌๅ‘ฝไปค -# ๆฃ€ๆŸฅไปปๅŠกๆ˜ฏๅฆ็œŸๆญฃๅคๆ‚๏ผˆ>3 ๆ–‡ไปถ๏ผŒ>2 ็›ฎๅฝ•๏ผ‰ -``` - -**ไปค็‰Œๆ•ˆ็Ž‡ๆจกๅผ้—ฎ้ข˜๏ผš** -```bash -# ้—ฎ้ข˜๏ผš่พ“ๅ‡บ่ฟ‡ไบŽๅŽ‹็ผฉๆˆ–ไธๆธ…ๆฅš -# ๅฟซ้€Ÿไฟฎๅค๏ผš็ฆ็”จๅŽ‹็ผฉไปฅๆ้ซ˜ๆธ…ๆ™ฐๅบฆ -/sc:command --no-uc # ็ฆ็”จๅŽ‹็ผฉ -/sc:command --verbose # ๅผบๅˆถ่ฏฆ็ป†่พ“ๅ‡บ -# ๅฝ“ๆธ…ๆ™ฐๅบฆๆฏ”ๆ•ˆ็Ž‡ๆ›ด้‡่ฆๆ—ถไฝฟ็”จ -``` - -**ๅ†…็œๆจกๅผ้—ฎ้ข˜๏ผš** -```bash -# ้—ฎ้ข˜๏ผš่ฟ‡ๅคšๅ…ƒ่ฏ„่ฎบ๏ผŒ่กŒๅŠจไธ่ถณ -# ๅฟซ้€Ÿไฟฎๅค๏ผšไธบ็›ดๆŽฅๅทฅไฝœ็ฆ็”จๅ†…็œ -/sc:command --no-introspect # ็›ดๆŽฅๆ‰ง่กŒ -# ไป…ๅœจๅญฆไน ๅ’Œ่ฐƒ่ฏ•ๆ—ถไฝฟ็”จๅ†…็œ -``` - -**็ผ–ๆŽ’ๆจกๅผ้—ฎ้ข˜๏ผš** -```bash -# ้—ฎ้ข˜๏ผšๅทฅๅ…ทๅ่ฐƒ้€ ๆˆๆททไนฑ -# ๅฟซ้€Ÿไฟฎๅค๏ผš็ฎ€ๅŒ–ๅทฅๅ…ทไฝฟ็”จ -/sc:command --no-mcp # ไป…ไฝฟ็”จๅŽŸ็”Ÿๅทฅๅ…ท -/sc:command --simple # ๅŸบๆœฌๆ‰ง่กŒ -# ๆฃ€ๆŸฅไปปๅŠกๅคๆ‚ๅบฆๆ˜ฏๅฆ้œ€่ฆ็ผ–ๆŽ’ -``` - -### ้”™่ฏฏไปฃ็ ๅ‚่€ƒ - -| ๆจกๅผ้”™่ฏฏ | ๅซไน‰ | ๅฟซ้€Ÿไฟฎๅค | -|---------|-----|----------| -| **B001** | ๅคด่„‘้ฃŽๆšดๆฟ€ๆดปๅคฑ่ดฅ | ไฝฟ็”จๆ˜พๅผ `--brainstorm` ๆ ‡ๅฟ— | -| **T001** | ไปปๅŠก็ฎก็†ๅผ€้”€ | ๅฏน็ฎ€ๅ•ไปปๅŠกไฝฟ็”จ `--no-task-manage` | -| **U001** | ไปค็‰Œๆ•ˆ็Ž‡่ฟ‡ไบŽๆฟ€่ฟ› | ไฝฟ็”จ `--verbose` ๆˆ– `--no-uc` | -| **I001** | ๅ†…็œๆจกๅผๅกไฝ | ๅฏน็›ดๆŽฅ่กŒๅŠจไฝฟ็”จ `--no-introspect` | -| **O001** | ็ผ–ๆŽ’ๅ่ฐƒๅคฑ่ดฅ | ไฝฟ็”จ `--no-mcp` ๆˆ– `--simple` | -| **M001** | ๆฃ€ๆต‹ๅˆฐๆจกๅผๅ†ฒ็ช | ๆฃ€ๆŸฅๆ ‡ๅฟ—ไผ˜ๅ…ˆ็บง่ง„ๅˆ™ | -| **M002** | ๆจกๅผๅˆ‡ๆขๅพช็Žฏ | ้‡ๅฏไผš่ฏไปฅ้‡็ฝฎ็Šถๆ€ | -| **M003** | ๆจกๅผๆ— ๆณ•่ฏ†ๅˆซ | ๆ›ดๆ–ฐ SuperClaude ๆˆ–ๆฃ€ๆŸฅๆ‹ผๅ†™ | - -### ๆธ่ฟ›ๅผๆ”ฏๆŒ็บงๅˆซ - -**็บงๅˆซ 1๏ผšๅฟซ้€Ÿไฟฎๅค๏ผˆ< 2 ๅˆ†้’Ÿ๏ผ‰** -- ไฝฟ็”จๆ‰‹ๅŠจๆ ‡ๅฟ—่ฆ†็›–่‡ชๅŠจๆจกๅผ้€‰ๆ‹ฉ -- ๆฃ€ๆŸฅไปปๅŠกๅคๆ‚ๆ€งๆ˜ฏๅฆไธŽ้ข„ๆœŸๆจกๅผ่กŒไธบๅŒน้… -- ๅฐ่ฏ•้‡ๅฏ Claude Code ไผš่ฏ - -**็บงๅˆซ 2๏ผš่ฏฆ็ป†ๅธฎๅŠฉ๏ผˆ5-15 ๅˆ†้’Ÿ๏ผ‰** -```bash -# ็‰นๅฎšๆจกๅผ่ฏŠๆ–ญ -/sc:help modes # ๅˆ—ๅ‡บๆ‰€ๆœ‰ๅฏ็”จๆจกๅผ -/sc:reflect --type mode-status # ๆฃ€ๆŸฅๅฝ“ๅ‰ๆจกๅผ็Šถๆ€ -# ๆฃ€ๆŸฅ่ฏทๆฑ‚ๅคๆ‚ๆ€งๅ’Œ่งฆๅ‘ๅ™จ -``` -- ๆœ‰ๅ…ณๆจกๅผๅฎ‰่ฃ…้—ฎ้ข˜๏ผŒ่ฏทๅ‚้˜…[ๅธธ่ง้—ฎ้ข˜ๆŒ‡ๅ—](../Reference/common-issues.md) - -**็บงๅˆซ 3๏ผšไธ“ๅฎถๆ”ฏๆŒ๏ผˆ30+ ๅˆ†้’Ÿ๏ผ‰** -```bash -# ๆทฑๅบฆๆจกๅผๅˆ†ๆž -SuperClaude install --diagnose -# ๆฃ€ๆŸฅๆจกๅผๆฟ€ๆดปๆจกๅผ -# ๆฃ€ๆŸฅ่กŒไธบ่งฆๅ‘ๅ™จๅ’Œ้˜ˆๅ€ผ -``` -- ๆœ‰ๅ…ณ่กŒไธบๆจกๅผๅˆ†ๆž๏ผŒ่ฏทๅ‚้˜…[่ฏŠๆ–ญๅ‚่€ƒๆŒ‡ๅ—](../Reference/diagnostic-reference.md) - -**็บงๅˆซ 4๏ผš็คพๅŒบๆ”ฏๆŒ** -- ๅœจ [GitHub Issues](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues) ๆŠฅๅ‘Šๆจกๅผ้—ฎ้ข˜ -- ๅŒ…ๆ‹ฌๆ„ๅค–ๆจกๅผ่กŒไธบ็š„็คบไพ‹ -- ๆ่ฟฐๆœŸๆœ›ไธŽๅฎž้™…ๆจกๅผๆฟ€ๆดป็š„ๅทฎๅผ‚ - -### ๆˆๅŠŸ้ชŒ่ฏ - -ๅบ”็”จๆจกๅผไฟฎๅคๅŽ๏ผŒ่ฟ›่กŒๆต‹่ฏ•๏ผš -- [ ] ็ฎ€ๅ•่ฏทๆฑ‚ไฝฟ็”จๆ ‡ๅ‡†ๆจกๅผ๏ผˆๆธ…ๆ™ฐใ€็›ดๆŽฅ็š„ๅ“ๅบ”๏ผ‰ -- [ ] ๅคๆ‚่ฏทๆฑ‚่‡ชๅŠจๆฟ€ๆดป้€‚ๅฝ“็š„ๆจกๅผ๏ผˆๅ่ฐƒใ€ๆŽจ็†๏ผ‰ -- [ ] ๆ‰‹ๅŠจๆ ‡ๅฟ—ๆญฃ็กฎ่ฆ†็›–่‡ชๅŠจๆฃ€ๆต‹ -- [ ] ๆจกๅผๆŒ‡็คบๅ™จ๏ผˆ๐Ÿค”ใ€๐ŸŽฏใ€๐Ÿ“‹๏ผ‰ๅœจ้ข„ๆœŸๆ—ถๅ‡บ็Žฐ -- [ ] ๅœจไธๅŒๆจกๅผไธ‹ๆ€ง่ƒฝไฟๆŒ่‰ฏๅฅฝ - -## ๅฟซ้€Ÿๆ•…้šœๆŽ’้™ค๏ผˆๆ—ง็‰ˆ๏ผ‰ -- **ๆจกๅผๆœชๆฟ€ๆดป** โ†’ ไฝฟ็”จๆ‰‹ๅŠจๆ ‡ๅฟ—๏ผš`--brainstorm`ใ€`--introspect`ใ€`--uc` -- **ๆฟ€ๆดปไบ†้”™่ฏฏ็š„ๆจกๅผ** โ†’ ๆฃ€ๆŸฅ่ฏทๆฑ‚ไธญ็š„ๅคๆ‚ๆ€ง่งฆๅ‘ๅ™จๅ’Œๅ…ณ้”ฎ่ฏ -- **ๆจกๅผๆ„ๅค–ๅˆ‡ๆข** โ†’ ๅŸบไบŽไปปๅŠกๆผ”ๅŒ–็š„ๆญฃๅธธ่กŒไธบ -- **ๆ‰ง่กŒๅฝฑๅ“** โ†’ ๆจกๅผไผ˜ๅŒ–ๅทฅๅ…ทไฝฟ็”จ๏ผŒไธๅบ”ๅฝฑๅ“ๆ‰ง่กŒ -- **ๆจกๅผๅ†ฒ็ช** โ†’ ๆฃ€ๆŸฅ[ๆ ‡ๅฟ—ๆŒ‡ๅ—](flags.md)ไธญ็š„ๆ ‡ๅฟ—ไผ˜ๅ…ˆ็บง่ง„ๅˆ™ - -## ๅธธ่ง้—ฎ้ข˜ - -**้—ฎ๏ผšๅฆ‚ไฝ•็Ÿฅ้“ๅ“ชไธชๆจกๅผๅค„ไบŽๆฟ€ๆดป็Šถๆ€๏ผŸ** -็ญ”๏ผšๅœจ้€šไฟกๆจกๅผไธญๆŸฅๆ‰พ่ฟ™ไบ›ๆŒ‡็คบๅ™จ๏ผš -- ๐Ÿค” ๅ‘็Žฐๆ€ง้—ฎ้ข˜ โ†’ ๅคด่„‘้ฃŽๆšด -- ๐ŸŽฏ ๆŽจ็†้€ๆ˜Žๅบฆ โ†’ ๅ†…็œ -- ้˜ถๆฎตๅˆ†่งฃ โ†’ ไปปๅŠก็ฎก็† -- ๅทฅๅ…ทๅ่ฐƒ โ†’ ็ผ–ๆŽ’ -- ็ฌฆๅทๅŽ‹็ผฉ โ†’ ไปค็‰Œๆ•ˆ็Ž‡ - -**้—ฎ๏ผšๆˆ‘ๅฏไปฅๅผบๅˆถ็‰นๅฎšๆจกๅผๅ—๏ผŸ** -็ญ”๏ผšๆ˜ฏ็š„๏ผŒไฝฟ็”จๆ‰‹ๅŠจๆ ‡ๅฟ—่ฆ†็›–่‡ชๅŠจๆฃ€ๆต‹๏ผš -```bash -/sc:command --brainstorm # ๅผบๅˆถๅ‘็Žฐๆจกๅผ -/sc:command --introspect # ๅขžๅŠ ้€ๆ˜Žๆ€ง -/sc:command --task-manage # ๅฏ็”จๅ่ฐƒ -/sc:command --uc # ๅŽ‹็ผฉ่พ“ๅ‡บ -``` - -**้—ฎ๏ผšๆจกๅผไผšๅฝฑๅ“ๆ‰ง่กŒๅ—๏ผŸ** -็ญ”๏ผšๆจกๅผ้€š่ฟ‡ๅ่ฐƒไผ˜ๅŒ–ๅทฅๅ…ทไฝฟ็”จ๏ผš -- **ไปค็‰Œๆ•ˆ็Ž‡**๏ผšไธŠไธ‹ๆ–‡ๅ‡ๅฐ‘ 30-50% -- **็ผ–ๆŽ’**๏ผšๅนถ่กŒๅค„็† -- **ไปปๅŠก็ฎก็†**๏ผš้€š่ฟ‡็ณป็ปŸๅŒ–่ง„ๅˆ’้˜ฒๆญข่ฟ”ๅทฅ - -**้—ฎ๏ผšๆจกๅผๅฏไปฅๅๅŒๅทฅไฝœๅ—๏ผŸ** -็ญ”๏ผšๆ˜ฏ็š„๏ผŒๆจกๅผ่ฎพ่ฎกไธบไบ’็›ธ่กฅๅ……๏ผš -- **ไปปๅŠก็ฎก็†**ๅ่ฐƒๅ…ถไป–ๆจกๅผ -- **ไปค็‰Œๆ•ˆ็Ž‡**ๅŽ‹็ผฉไปปไฝ•ๆจกๅผ็š„่พ“ๅ‡บ -- **ๅ†…็œ**ไธบไปปไฝ•ๅทฅไฝœๆตๆทปๅŠ ้€ๆ˜Žๅบฆ - ---- - -## ๆ€ป็ป“ - -SuperClaude ็š„ 5 ็ง่กŒไธบๆจกๅผๅˆ›ๅปบไบ†ไธ€ไธช**ๆ™บ่ƒฝ้€‚ๅบ”็ณป็ปŸ**๏ผŒ่‡ชๅŠจๅŒน้…ๆ‚จ็š„้œ€ๆฑ‚๏ผš - -- **๐Ÿง  ๅคด่„‘้ฃŽๆšด**๏ผšๅฐ†ๆจก็ณŠๆƒณๆณ•่ฝฌๅŒ–ไธบๆธ…ๆ™ฐ้œ€ๆฑ‚ -- **๐Ÿ” ๅ†…็œ**๏ผšไธบๅญฆไน ๅ’Œ่ฐƒ่ฏ•ๆไพ›้€ๆ˜ŽๆŽจ็† -- **๐Ÿ“‹ ไปปๅŠก็ฎก็†**๏ผšๅ่ฐƒๅคๆ‚็š„ๅคšๆญฅๆ“ไฝœ -- **๐ŸŽฏ ็ผ–ๆŽ’**๏ผšไผ˜ๅŒ–ๅทฅๅ…ท้€‰ๆ‹ฉๅ’Œๅนถ่กŒๆ‰ง่กŒ -- **โšก ไปค็‰Œๆ•ˆ็Ž‡**๏ผšๅœจไฟๆŒๆธ…ๆ™ฐๅบฆ็š„ๅŒๆ—ถๅŽ‹็ผฉ้€šไฟก -- **๐ŸŽจ ๆ ‡ๅ‡†**๏ผšไธบ็›ดๆŽฅไปปๅŠก็ปดๆŠคไธ“ไธšๅŸบ็บฟ - -**ๅ…ณ้”ฎๆดžๅฏŸ**๏ผšๆ‚จๆ— ้œ€ๆ€่€ƒๆจกๅผ - ๅฎƒไปฌ้€ๆ˜Žๅœฐๅทฅไฝœไปฅๅขžๅผบๆ‚จ็š„ๅผ€ๅ‘ไฝ“้ชŒใ€‚ๅช้œ€ๆ่ฟฐๆ‚จๆƒณ่ฆๅฎŒๆˆ็š„ไปปๅŠก๏ผŒSuperClaude ไผš่‡ชๅŠจ่ฐƒๆ•ดๅ…ถๆ–นๆณ•ไปฅๅŒน้…ๆ‚จ็š„้œ€ๆฑ‚ใ€‚ - ---- - -## ็›ธๅ…ณๆŒ‡ๅ— - -**ๅญฆไน ่ฟ›ๅฑ•๏ผš** - -**๐ŸŒฑ ๅŸบ็ก€๏ผˆ็ฌฌ1ๅ‘จ๏ผ‰** -- [ๅฟซ้€Ÿๅผ€ๅง‹ๆŒ‡ๅ—](../Getting-Started/quick-start.md) - ๆจกๅผๆฟ€ๆดป็คบไพ‹ -- [ๅ‘ฝไปคๅ‚่€ƒ](commands.md) - ๅ‘ฝไปค่‡ชๅŠจๆฟ€ๆดปๆจกๅผ -- [ๅฎ‰่ฃ…ๆŒ‡ๅ—](../Getting-Started/installation.md) - ่ฎพ็ฝฎ่กŒไธบๆจกๅผ - -**๐ŸŒฟ ไธญ็บง๏ผˆ็ฌฌ2-3ๅ‘จ๏ผ‰** -- [ๆ™บ่ƒฝไฝ“ๆŒ‡ๅ—](agents.md) - ๆจกๅผๅฆ‚ไฝ•ไธŽไธ“ๅฎถๅ่ฐƒ -- [ๆ ‡ๅฟ—ๆŒ‡ๅ—](flags.md) - ๆ‰‹ๅŠจๆจกๅผๆŽงๅˆถๅ’Œไผ˜ๅŒ– -- [็คบไพ‹ๆ‰‹ๅ†Œ](../Reference/examples-cookbook.md) - ๅฎž่ทตไธญ็š„ๆจกๅผๆจกๅผ - -**๐ŸŒฒ ้ซ˜็บง๏ผˆ็ฌฌ2+ไธชๆœˆ๏ผ‰** -- [MCP ๆœๅŠกๅ™จ](mcp-servers.md) - ๆจกๅผไธŽๅขžๅผบ่ƒฝๅŠ›็š„้›†ๆˆ -- [ไผš่ฏ็ฎก็†](session-management.md) - ไปปๅŠก็ฎก็†ๆจกๅผๅทฅไฝœๆต -- [ๅ…ฅ้—จๆŒ‡ๅ—](../Getting-Started/quick-start.md) - ๆจกๅผไฝฟ็”จๆจกๅผ - -**๐Ÿ”ง ไธ“ๅฎถ็บง** -- [ๆŠ€ๆœฏๆžถๆž„](../Developer-Guide/technical-architecture.md) - ๆจกๅผๅฎž็Žฐ็ป†่Š‚ -- [ไปฃ็ ่ดก็Œฎ](../Developer-Guide/contributing-code.md) - ๆ‰ฉๅฑ•ๆจกๅผ่ƒฝๅŠ› - -**็‰นๅฎšๆจกๅผๆŒ‡ๅ—๏ผš** -- **ๅคด่„‘้ฃŽๆšด**๏ผš[้œ€ๆฑ‚ๅ‘็Žฐๆจกๅผ](../Reference/examples-cookbook.md#requirements) -- **ไปปๅŠก็ฎก็†**๏ผš[ไผš่ฏ็ฎก็†ๆŒ‡ๅ—](session-management.md) -- **็ผ–ๆŽ’**๏ผš[MCP ๆœๅŠกๅ™จๆŒ‡ๅ—](mcp-servers.md) -- **ไปค็‰Œๆ•ˆ็Ž‡**๏ผš[ๅ‘ฝไปคๅŸบ็ก€](commands.md#token-efficiency) \ No newline at end of file diff --git a/docs/User-Guide-zh/session-management.md b/docs/User-Guide-zh/session-management.md deleted file mode 100644 index 7a625ca..0000000 --- a/docs/User-Guide-zh/session-management.md +++ /dev/null @@ -1,310 +0,0 @@ -# ไผš่ฏ็ฎก็†ๆŒ‡ๅ— - -SuperClaude ้€š่ฟ‡ Serena MCP ๆœๅŠกๅ™จๆไพ›ๆŒไน…ไผš่ฏ็ฎก็†๏ผŒๅฎž็Žฐๅœจ Claude Code ๅฏน่ฏไธญ็œŸๆญฃ็š„ไธŠไธ‹ๆ–‡ไฟๅญ˜ๅ’Œ้•ฟๆœŸ้กน็›ฎ่ฟž็ปญๆ€งใ€‚ - -## ๅ…ทๆœ‰ๆŒไน…ๅ†…ๅญ˜็š„ๆ ธๅฟƒไผš่ฏๅ‘ฝไปค - -### `/sc:load` - ๅ…ทๆœ‰ๆŒไน…ๅ†…ๅญ˜็š„ไธŠไธ‹ๆ–‡ๅŠ ่ฝฝ -**็›ฎ็š„**๏ผšไฝฟ็”จ้กน็›ฎไธŠไธ‹ๆ–‡ๅ’Œไปฅๅ‰ไผš่ฏ็š„ๆŒไน…ๅ†…ๅญ˜ๅˆๅง‹ๅŒ–ไผš่ฏ -**MCP ้›†ๆˆ**๏ผš่งฆๅ‘ Serena MCP ่ฏปๅ–ๅญ˜ๅ‚จ็š„้กน็›ฎๅ†…ๅญ˜ -**่ฏญๆณ•**๏ผš`/sc:load [project_path]` - -**ๅ‘็”Ÿไป€ไนˆ**๏ผš -- Serena MCP ไปŽไปฅๅ‰็š„ไผš่ฏไธญ่ฏปๅ–ๆŒไน…ๅ†…ๅญ˜ๆ–‡ไปถ -- ไปŽๅญ˜ๅ‚จ็š„ๅ†…ๅญ˜ไธญๆขๅค้กน็›ฎไธŠไธ‹ๆ–‡ -- ๅŠ ่ฝฝไปฅๅ‰็š„ๅ†ณ็ญ–ใ€ๆจกๅผๅ’Œ่ฟ›ๅบฆ -- ไฝฟ็”จๅŽ†ๅฒไธŠไธ‹ๆ–‡ๅˆๅง‹ๅŒ–ไผš่ฏ็Šถๆ€ - -**ไฝฟ็”จๆกˆไพ‹**๏ผš -```bash -# ไปŽๆŒไน…ๅ†…ๅญ˜ๅŠ ่ฝฝ็Žฐๆœ‰้กน็›ฎไธŠไธ‹ๆ–‡ -/sc:load src/ - -# ๆขๅค็‰นๅฎš้กน็›ฎๅทฅไฝœๅŠๅ…ถๅฎŒๆ•ดๅŽ†ๅฒ -/sc:load "authentication system" - -# ไฝฟ็”จไปฃ็ ๅบ“ๅˆ†ๆžๅ’Œๅ…ˆๅ‰่ง่งฃๅˆๅง‹ๅŒ– -/sc:load . --analyze -``` - -### `/sc:save` - ไผš่ฏๆŒไน…ๅŒ–ๅˆฐๅ†…ๅญ˜ -**็›ฎ็š„**๏ผšๅฐ†ๅฝ“ๅ‰ไผš่ฏ็Šถๆ€ๅ’Œๅ†ณ็ญ–ไฟๅญ˜ๅˆฐๆŒไน…ๅ†…ๅญ˜ -**MCP ้›†ๆˆ**๏ผš่งฆๅ‘ Serena MCP ๅ†™ๅ…ฅๅ†…ๅญ˜ๆ–‡ไปถ -**่ฏญๆณ•**๏ผš`/sc:save "ไผš่ฏๆ่ฟฐ"` - -**ๅ‘็”Ÿไป€ไนˆ**๏ผš -- ๅฝ“ๅ‰ไธŠไธ‹ๆ–‡ๅ’Œๅ†ณ็ญ–่ขซๅ†™ๅ…ฅ Serena ๅ†…ๅญ˜ -- ้กน็›ฎ็Šถๆ€ๅ’Œ่ฟ›ๅบฆๅœจๅฏน่ฏไธญๆŒไน…ไฟๅญ˜ -- ๅ…ณ้”ฎ่ง่งฃๅ’Œๆจกๅผ่ขซๅญ˜ๅ‚จไปฅไพ›ๆœชๆฅไผš่ฏไฝฟ็”จ -- ๅˆ›ๅปบๅธฆๆœ‰ๆ—ถ้—ดๆˆณ็š„ไผš่ฏๆ‘˜่ฆไปฅไพฟๆฃ€็ดข - -**ไฝฟ็”จๆกˆไพ‹**๏ผš -```bash -# ไฟๅญ˜ๅทฒๅฎŒๆˆ็š„็‰นๆ€งๅทฅไฝœไปฅไพ›ๆœชๆฅๅ‚่€ƒ -/sc:save "user authentication implemented with JWT" - -# ๅคๆ‚ๅทฅไฝœๆœŸ้—ด็š„ๆฃ€ๆŸฅ็‚น -/sc:save "API design phase complete, ready for implementation" - -# ๆฐธไน…ๅญ˜ๅ‚จๆžถๆž„ๅ†ณ็ญ– -/sc:save "microservices architecture decided, service boundaries defined" -``` - -### `/sc:reflect` - ๅธฆๆœ‰ๅ†…ๅญ˜ไธŠไธ‹ๆ–‡็š„่ฟ›ๅบฆ่ฏ„ไผฐ -**็›ฎ็š„**๏ผšๆ นๆฎๅญ˜ๅ‚จ็š„ๅ†…ๅญ˜ๅˆ†ๆžๅฝ“ๅ‰่ฟ›ๅบฆๅนถ้ชŒ่ฏไผš่ฏๅฎŒๆ•ดๆ€ง -**MCP ้›†ๆˆ**๏ผšไฝฟ็”จ Serena MCP ๅฐ†ๅฝ“ๅ‰็Šถๆ€ไธŽๅญ˜ๅ‚จ็š„ๅ†…ๅญ˜่ฟ›่กŒๆฏ”่พƒ -**่ฏญๆณ•**๏ผš`/sc:reflect [--scope project|session]` - -**ๅ‘็”Ÿไป€ไนˆ**๏ผš -- Serena MCP ่ฏปๅ–ไปฅๅ‰็š„ๅ†…ๅญ˜ๅ’Œๅฝ“ๅ‰ไธŠไธ‹ๆ–‡ -- ๆ นๆฎๅญ˜ๅ‚จ็š„็›ฎๆ ‡ๅ’Œ้‡Œ็จ‹็ข‘่ฏ„ไผฐ่ฟ›ๅบฆ -- ไฝฟ็”จๅŽ†ๅฒไธŠไธ‹ๆ–‡่ฏ†ๅˆซๅทฎ่ทๅ’Œไธ‹ไธ€ๆญฅ -- ๆ นๆฎ้กน็›ฎๅ†…ๅญ˜้ชŒ่ฏไผš่ฏๅฎŒๆ•ดๆ€ง - -**ไฝฟ็”จๆกˆไพ‹**๏ผš -```bash -# ๆ นๆฎๅญ˜ๅ‚จ็š„้‡Œ็จ‹็ข‘่ฏ„ไผฐ้กน็›ฎ่ฟ›ๅบฆ -/sc:reflect --scope project - -# ้ชŒ่ฏๅฝ“ๅ‰ไผš่ฏๅฎŒๆ•ดๆ€ง -/sc:reflect - -# ๆ นๆฎๅ†…ๅญ˜ๆฃ€ๆŸฅๆ˜ฏๅฆๅ‡†ๅค‡่ฟ›ๅ…ฅไธ‹ไธ€้˜ถๆฎต -/sc:reflect --scope session -``` - -## ๆŒไน…ๅ†…ๅญ˜ๆžถๆž„ - -### Serena MCP ๅฆ‚ไฝ•ๅฎž็Žฐ็œŸๆญฃ็š„ๆŒไน…ๆ€ง - -**ๅ†…ๅญ˜ๅญ˜ๅ‚จ**๏ผš -- ไผš่ฏไธŠไธ‹ๆ–‡ไฝœไธบ็ป“ๆž„ๅŒ–ๅ†…ๅญ˜ๆ–‡ไปถๅญ˜ๅ‚จ -- ้กน็›ฎๅ†ณ็ญ–ๅ’Œๆžถๆž„ๆจกๅผๆฐธไน…ไฟๅญ˜ -- ไปฃ็ ๅˆ†ๆž็ป“ๆžœๅ’Œ่ง่งฃๅœจๅฏน่ฏไธญไฟๆŒ -- ่ฟ›ๅบฆ่ทŸ่ธชๅ’Œ้‡Œ็จ‹็ข‘ๆ•ฐๆฎ้•ฟๆœŸ็ปดๆŠค - -**่ทจไผš่ฏ่ฟž็ปญๆ€ง**๏ผš -- ๆ–ฐๅฏน่ฏไธญ่‡ชๅŠจๅŠ ่ฝฝไปฅๅ‰็š„ไผš่ฏไธŠไธ‹ๆ–‡ -- ๅ†ณ็ญ–ๅ’Œ็†็”ฑๅœจๅฏน่ฏไธญไฟๅญ˜ๅ’Œๅฏ่ฎฟ้—ฎ -- ไปŽ่ฟ‡ๅŽป็š„ๆจกๅผๅ’Œ่งฃๅ†ณๆ–นๆกˆไธญๅญฆไน ๅนถ็ปดๆŠค -- ไธ€่‡ด็š„้กน็›ฎ็†่งฃๆ— ้™ๆœŸ็ปดๆŠค - -**ๅ†…ๅญ˜็ฑปๅž‹**๏ผš -- **้กน็›ฎๅ†…ๅญ˜**๏ผš้•ฟๆœŸ้กน็›ฎไธŠไธ‹ๆ–‡ๅ’Œๆžถๆž„ -- **ไผš่ฏๅ†…ๅญ˜**๏ผš็‰นๅฎšๅฏน่ฏ็ป“ๆžœๅ’Œๅ†ณ็ญ– -- **ๆจกๅผๅ†…ๅญ˜**๏ผšๅฏ้‡็”จ็š„่งฃๅ†ณๆ–นๆกˆๅ’Œๆžถๆž„ๆจกๅผ -- **่ฟ›ๅบฆๅ†…ๅญ˜**๏ผš้‡Œ็จ‹็ข‘่ทŸ่ธชๅ’ŒๅฎŒๆˆ็Šถๆ€ - -## ๅ…ทๆœ‰ๆŒไน…ๆ€ง็š„ไผš่ฏ็”Ÿๅ‘ฝๅ‘จๆœŸๆจกๅผ - -### ๆ–ฐ้กน็›ฎๅˆๅง‹ๅŒ– -```bash -# 1. ๅผ€ๅง‹ๅ…จๆ–ฐ้กน็›ฎ -/sc:brainstorm "e-commerce platform requirements" - -# 2. ๅฐ†ๅˆๅง‹ๅ†ณ็ญ–ไฟๅญ˜ๅˆฐๆŒไน…ๅ†…ๅญ˜ -/sc:save "project scope and requirements defined" - -# 3. ๅผ€ๅง‹ๅฎž็Žฐ่ง„ๅˆ’ -/sc:workflow "user authentication system" - -# 4. ๆฐธไน…ไฟๅญ˜ๆžถๆž„ๅ†ณ็ญ– -/sc:save "authentication architecture: JWT + refresh tokens + rate limiting" -``` - -### ๆขๅค็Žฐๆœ‰ๅทฅไฝœ๏ผˆ่ทจๅฏน่ฏ๏ผ‰ -```bash -# 1. ไปŽๆŒไน…ๅ†…ๅญ˜ๅŠ ่ฝฝไปฅๅ‰็š„ไธŠไธ‹ๆ–‡ -/sc:load "e-commerce project" - -# 2. ๆ นๆฎๅญ˜ๅ‚จ็š„่ฟ›ๅบฆ่ฏ„ไผฐๅฝ“ๅ‰็Šถๆ€ -/sc:reflect --scope project - -# 3. ไฝฟ็”จๅญ˜ๅ‚จ็š„ไธŠไธ‹ๆ–‡็ปง็ปญไธ‹ไธ€้˜ถๆฎต -/sc:implement "payment processing integration" - -# 4. ๅฐ†่ฟ›ๅบฆๆฃ€ๆŸฅ็‚นไฟๅญ˜ๅˆฐๅ†…ๅญ˜ -/sc:save "payment system integrated with Stripe API" -``` - -### ้•ฟๆœŸ้กน็›ฎ็ฎก็† -```bash -# ๅ…ทๆœ‰ๆŒไน…ๆ€ง็š„ๅ‘จๆฃ€ๆŸฅ็‚นๆจกๅผ -/sc:load project-name -/sc:reflect --scope project -# ... ๅค„็†็‰นๆ€ง ... -/sc:save "week N progress: features X, Y, Z completed" - -# ๅ…ทๆœ‰ๅ†…ๅญ˜็š„้˜ถๆฎตๅฎŒๆˆๆจกๅผ -/sc:reflect --scope project -/sc:save "phase 1 complete: core authentication and user management" -/sc:workflow "phase 2: payment and order processing" -``` - -## ่ทจๅฏน่ฏ่ฟž็ปญๆ€ง - -### ไฝฟ็”จๆŒไน…ๆ€งๅผ€ๅง‹ๆ–ฐๅฏน่ฏ - -ๅฝ“ๅผ€ๅง‹ๆ–ฐ็š„ Claude Code ๅฏน่ฏๆ—ถ๏ผŒๆŒไน…ๅ†…ๅญ˜็ณป็ปŸๅ…่ฎธ๏ผš - -1. **่‡ชๅŠจไธŠไธ‹ๆ–‡ๆขๅค** - ```bash - /sc:load project-name - # ่‡ชๅŠจๆขๅคๆ‰€ๆœ‰ไปฅๅ‰็š„ไธŠไธ‹ๆ–‡ใ€ๅ†ณ็ญ–ๅ’Œ่ฟ›ๅบฆ - ``` - -2. **่ฟ›ๅบฆ็ปง็ปญ** - - ไปฅๅ‰ไผš่ฏ็š„ๅ†ณ็ญ–็ซ‹ๅณๅฏ็”จ - - ๆžถๆž„ๆจกๅผๅ’Œไปฃ็ ่ง่งฃ่ขซไฟๅญ˜ - - ้กน็›ฎๅŽ†ๅฒๅ’Œ็†็”ฑ่ขซ็ปดๆŠค - -3. **ๆ™บ่ƒฝไธŠไธ‹ๆ–‡ๆž„ๅปบ** - - Serena MCP ๆ นๆฎๅฝ“ๅ‰ๅทฅไฝœๆไพ›็›ธๅ…ณๅ†…ๅญ˜ - - ่ฟ‡ๅŽป็š„่งฃๅ†ณๆ–นๆกˆๅ’ŒๆจกๅผๆŒ‡ๅฏผๆ–ฐ็š„ๅฎž็Žฐ - - ้กน็›ฎๆผ”ๅ˜่ขซ่ทŸ่ธชๅ’Œ็†่งฃ - -### ๅ†…ๅญ˜ไผ˜ๅŒ– - -**ๆœ‰ๆ•ˆ็š„ๅ†…ๅญ˜ไฝฟ็”จ**๏ผš -- ไฝฟ็”จๆ่ฟฐๆ€งใ€ๅฏๆœ็ดข็š„ๅ†…ๅญ˜ๅ็งฐ -- ๅŒ…ๅซ้กน็›ฎ้˜ถๆฎตๅ’Œๆ—ถ้—ดๆˆณไธŠไธ‹ๆ–‡ -- ๅผ•็”จ็‰นๅฎšๅŠŸ่ƒฝๆˆ–ๆžถๆž„ๅ†ณ็ญ– -- ่ฎฉๆœชๆฅ็š„ๆฃ€็ดขๅ˜ๅพ—็›ด่ง‚ - -**ๅ†…ๅญ˜ๅ†…ๅฎน็ญ–็•ฅ**๏ผš -- ๅญ˜ๅ‚จๅ†ณ็ญ–ๅ’Œ็†็”ฑ๏ผŒ่€Œไธไป…ไป…ๆ˜ฏ็ป“ๆžœ -- ๅŒ…ๅซ่€ƒ่™‘็š„ๆ›ฟไปฃๆ–นๆกˆ -- ่ฎฐๅฝ•้›†ๆˆๆจกๅผๅ’Œไพ่ต–ๅ…ณ็ณป -- ไธบๆœชๆฅๅ‚่€ƒไฟ็•™ๅญฆไน ๅ’ŒๆดžๅฏŸ - -**ๅ†…ๅญ˜็”Ÿๅ‘ฝๅ‘จๆœŸ็ฎก็†**๏ผš -- ๅฎšๆœŸๆธ…็†่ฟ‡ๆ—ถ็š„ๅ†…ๅญ˜ -- ๆ•ดๅˆ็›ธๅ…ณ็š„ไผš่ฏๅ†…ๅญ˜ -- ๅฝ’ๆกฃๅทฒๅฎŒๆˆ็š„้กน็›ฎ้˜ถๆฎต -- ไฟฎๅ‰ช่ฟ‡ๆ—ถ็š„ๆžถๆž„ๅ†ณ็ญ– - -## ๆŒไน…ไผš่ฏ็š„ๆœ€ไฝณๅฎž่ทต - -### ไผš่ฏๅผ€ๅง‹ๅ่ฎฎ -1. ๅฏนไบŽ็Žฐๆœ‰้กน็›ฎๅง‹็ปˆไปฅ `/sc:load` ๅผ€ๅง‹ -2. ไฝฟ็”จ `/sc:reflect` ไปŽๅ†…ๅญ˜ไธญไบ†่งฃๅฝ“ๅ‰็Šถๆ€ -3. ๆ นๆฎๆŒไน…ไธŠไธ‹ๆ–‡ๅ’Œๅญ˜ๅ‚จ็š„ๆจกๅผ่ง„ๅˆ’ๅทฅไฝœ -4. ๅŸบไบŽไปฅๅ‰็š„ๅ†ณ็ญ–ๅ’Œๆžถๆž„้€‰ๆ‹ฉๆž„ๅปบ - -### ไผš่ฏ็ป“ๆŸๅ่ฎฎ -1. ไฝฟ็”จ `/sc:reflect` ๆ นๆฎๅญ˜ๅ‚จ็š„็›ฎๆ ‡่ฏ„ไผฐๅฎŒๆ•ดๆ€ง -2. ไฝฟ็”จ `/sc:save` ไฟๅญ˜ๅ…ณ้”ฎๅ†ณ็ญ–ไปฅไพ›ๆœชๆฅไผš่ฏ -3. ๅœจๅ†…ๅญ˜ไธญ่ฎฐๅฝ•ไธ‹ไธ€ๆญฅๅ’Œๆœช่งฃๅ†ณ็š„้—ฎ้ข˜ -4. ไธบๆ— ็ผ็š„ๆœชๆฅ็ปง็ปญไฟๅญ˜ไธŠไธ‹ๆ–‡ - -### ๅ†…ๅญ˜่ดจ้‡็ปดๆŠค -- ไฝฟ็”จๆธ…ๆ™ฐใ€ๆ่ฟฐๆ€ง็š„ๅ†…ๅญ˜ๅ็งฐไปฅไพฟไบŽๆฃ€็ดข -- ๅŒ…ๅซๅ…ณไบŽๅ†ณ็ญ–ๅ’Œๆ›ฟไปฃๆ–นๆณ•็š„ไธŠไธ‹ๆ–‡ -- ๅผ•็”จ็‰นๅฎš็š„ไปฃ็ ไฝ็ฝฎๅ’Œๆจกๅผ -- ๅœจ่ทจไผš่ฏไธญไฟๆŒๅ†…ๅญ˜็ป“ๆž„็š„ไธ€่‡ดๆ€ง - -## ไธŽๅ…ถไป– SuperClaude ๅŠŸ่ƒฝ็š„้›†ๆˆ - -### MCP ๆœๅŠกๅ™จๅ่ฐƒ -- **Serena MCP**๏ผšๆไพ›ๆŒไน…ๅ†…ๅญ˜ๅŸบ็ก€่ฎพๆ–ฝ -- **Sequential MCP**๏ผšไฝฟ็”จๅญ˜ๅ‚จ็š„ๅ†…ๅญ˜่ฟ›่กŒๅขžๅผบ็š„ๅคๆ‚ๅˆ†ๆž -- **Context7 MCP**๏ผšๅผ•็”จๅญ˜ๅ‚จ็š„ๆจกๅผๅ’Œๆ–‡ๆกฃๆ–นๆณ• -- **Morphllm MCP**๏ผšไธ€่‡ดๅœฐๅบ”็”จๅญ˜ๅ‚จ็š„้‡ๆž„ๆจกๅผ - -### ๆ™บ่ƒฝไฝ“ไธŽๅ†…ๅญ˜็š„ๅไฝœ -- ๆ™บ่ƒฝไฝ“่ฎฟ้—ฎๆŒไน…ๅ†…ๅญ˜ไปฅๅขžๅผบไธŠไธ‹ๆ–‡ -- ๅ…ˆๅ‰็š„ไธ“ๅฎถๅ†ณ็ญ–่ขซไฟ็•™ๅ’Œๅผ•็”จ -- ้€š่ฟ‡ๅ…ฑไบซๅ†…ๅญ˜่ฟ›่กŒ่ทจไผš่ฏๆ™บ่ƒฝไฝ“ๅ่ฐƒ -- ๅŸบไบŽ้กน็›ฎๅŽ†ๅฒ็š„ไธ€่‡ดไธ“ๅฎถๅปบ่ฎฎ - -### ๅ‘ฝไปคไธŽๆŒไน…ๅŒ–็š„้›†ๆˆ -- ๆ‰€ๆœ‰ `/sc:` ๅ‘ฝไปค้ƒฝๅฏไปฅๅผ•็”จๅ’Œๆž„ๅปบๆŒไน…ไธŠไธ‹ๆ–‡ -- ๅ…ˆๅ‰็š„ๅ‘ฝไปค่พ“ๅ‡บๅ’Œๅ†ณ็ญ–ๅœจ่ทจไผš่ฏไธญๅฏ็”จ -- ๅทฅไฝœๆต็จ‹ๆจกๅผ่ขซๅญ˜ๅ‚จๅ’Œ้‡็”จ -- ๅฎž็ŽฐๅŽ†ๅฒๆŒ‡ๅฏผๆœชๆฅ็š„ๅ‘ฝไปคๅ†ณ็ญ– - -## ๆŒไน…ไผš่ฏๆ•…้šœๆŽ’้™ค - -### ๅธธ่ง้—ฎ้ข˜ - -**ๅ†…ๅญ˜ๆœชๅŠ ่ฝฝ**๏ผš -- ้ชŒ่ฏ Serena MCP ้…็ฝฎๆญฃ็กฎๅนถๆญฃๅธธ่ฟ่กŒ -- ๆฃ€ๆŸฅๅ†…ๅญ˜ๆ–‡ไปถๆƒ้™ๅ’Œๅฏ่ฎฟ้—ฎๆ€ง -- ็กฎไฟไธ€่‡ด็š„้กน็›ฎๅ‘ฝๅ็บฆๅฎš -- ้ชŒ่ฏๅ†…ๅญ˜ๆ–‡ไปถๅฎŒๆ•ดๆ€งๅ’Œๆ ผๅผ - -**ไผš่ฏ้—ดไธŠไธ‹ๆ–‡ไธขๅคฑ**๏ผš -- ๅœจ็ป“ๆŸไผš่ฏๅ‰ๅง‹็ปˆไฝฟ็”จ `/sc:save` -- ไฝฟ็”จๆ่ฟฐๆ€งๅ†…ๅญ˜ๅ็งฐไปฅไพฟไบŽๆฃ€็ดข -- ๅฎšๆœŸไฝฟ็”จ `/sc:reflect` ้ชŒ่ฏๅ†…ๅญ˜ๅฎŒๆ•ดๆ€ง -- ๅฎšๆœŸๅค‡ไปฝ้‡่ฆ็š„ๅ†…ๅญ˜ๆ–‡ไปถ - -**ๅ†…ๅญ˜ๅ†ฒ็ช**๏ผš -- ไฝฟ็”จๅธฆๆ—ถ้—ดๆˆณ็š„ๅ†…ๅญ˜ๅ็งฐ่ฟ›่กŒ็‰ˆๆœฌๆŽงๅˆถ -- ๅฎšๆœŸๆธ…็†่ฟ‡ๆ—ถ็š„ๅ†…ๅญ˜ -- ๆธ…ๆฅšๅˆ†็ฆป้กน็›ฎๅ’Œไผš่ฏๅ†…ๅญ˜ -- ๅœจ่ทจไผš่ฏไธญไฟๆŒไธ€่‡ด็š„ๅ†…ๅญ˜ๅ‘ฝๅ็บฆๅฎš - -### ๅฟซ้€Ÿไฟฎๅค - -**้‡็ฝฎไผš่ฏ็Šถๆ€**๏ผš -```bash -/sc:load --fresh # ไธๅธฆๅ…ˆๅ‰ไธŠไธ‹ๆ–‡ๅผ€ๅง‹ -/sc:reflect # ่ฏ„ไผฐๅฝ“ๅ‰็Šถๆ€ -``` - -**ๅ†…ๅญ˜ๆธ…็†**๏ผš -```bash -/sc:reflect --cleanup # ๅˆ ้™ค่ฟ‡ๆ—ถ็š„ๅ†…ๅญ˜ -/sc:save --consolidate # ๅˆๅนถ็›ธๅ…ณๅ†…ๅญ˜ -``` - -**ไธŠไธ‹ๆ–‡ๆขๅค**๏ผš -```bash -/sc:load --recent # ๅŠ ่ฝฝๆœ€่ฟ‘็š„ๅ†…ๅญ˜ -/sc:reflect --repair # ่ฏ†ๅˆซๅนถไฟฎๅคไธŠไธ‹ๆ–‡็ฉบ็™ฝ -``` - -## ้ซ˜็บงๆŒไน…ไผš่ฏๆจกๅผ - -### ๅคš้˜ถๆฎต้กน็›ฎ -- ไฝฟ็”จ้˜ถๆฎต็‰นๅฎš็š„ๅ†…ๅญ˜ๅ‘ฝๅ่ฟ›่กŒ็ป„็ป‡ -- ่ทจ้˜ถๆฎต็ปดๆŠคๆžถๆž„ๅ†ณ็ญ–่ฟž็ปญๆ€ง -- ้€š่ฟ‡ๆŒไน…ๅ†…ๅญ˜่ฟ›่กŒ่ทจ้˜ถๆฎตไพ่ต–่ทŸ่ธช -- ๅ…ทๆœ‰ๅŽ†ๅฒไธŠไธ‹ๆ–‡็š„ๆธ่ฟ›ๅผๅคๆ‚ๆ€ง็ฎก็† - -### ๅ›ข้˜Ÿๅไฝœ -- ๅ…ฑไบซ็š„ๅ†…ๅญ˜็บฆๅฎšๅ’Œๅ‘ฝๅๆ ‡ๅ‡† -- ไธบๅ›ข้˜ŸไธŠไธ‹ๆ–‡ไฟ็•™ๅ†ณ็ญ–็†็”ฑ -- ๆ‰€ๆœ‰ๅ›ข้˜Ÿๆˆๅ‘˜้ƒฝๅฏ่ฎฟ้—ฎ็š„้›†ๆˆๆจกๅผๆ–‡ๆกฃ -- ้€š่ฟ‡ๅ†…ๅญ˜ๅฎž็Žฐไธ€่‡ด็š„ไปฃ็ ้ฃŽๆ ผๅ’Œๆžถๆž„ๆ‰ง่กŒ - -### ้•ฟๆœŸ็ปดๆŠค -- ๅทฒๅฎŒๆˆ้กน็›ฎ็š„ๅ†…ๅญ˜ๅฝ’ๆกฃ็ญ–็•ฅ -- ้€š่ฟ‡็ดฏ็งฏๅ†…ๅญ˜ๅผ€ๅ‘ๆจกๅผๅบ“ -- ้šๆ—ถ้—ดๅปบ็ซ‹็š„ๅฏ้‡็”จ่งฃๅ†ณๆ–นๆกˆๆ–‡ๆกฃ -- ้€š่ฟ‡ๆŒไน…ๅ†…ๅญ˜็งฏ็ดฏๅปบ็ซ‹็Ÿฅ่ฏ†ๅบ“ - -## ๆŒไน…ไผš่ฏ็ฎก็†็š„ๅ…ณ้”ฎไผ˜ๅŠฟ - -### ้กน็›ฎ่ฟž็ปญๆ€ง -- ๅœจๅคšๆฌกๅฏน่ฏไธญๆ— ็ผ็š„ๅทฅไฝœๅปถ็ปญ -- Claude Code ไผš่ฏไน‹้—ดๆ— ไธŠไธ‹ๆ–‡ไธขๅคฑ -- ไฟ็•™็š„ๆžถๆž„ๅ†ณ็ญ–ๅ’ŒๆŠ€ๆœฏ็†็”ฑ -- ้•ฟๆœŸ้กน็›ฎๆผ”่ฟ›่ทŸ่ธช - -### ๆๅ‡็”ŸไบงๅŠ› -- ๅ‡ๅฐ‘้‡ๆ–ฐ่งฃ้‡Š้กน็›ฎไธŠไธ‹ๆ–‡็š„้œ€่ฆ -- ็ปง็ปญๅทฅไฝœ็š„ๆ›ดๅฟซๅฏๅŠจๆ—ถ้—ด -- ๅŸบไบŽๅ…ˆๅ‰็š„ๆดžๅฏŸๅ’Œๆจกๅผ่ฟ›่กŒๆž„ๅปบ -- ็ดฏ็งฏ็š„้กน็›ฎ็Ÿฅ่ฏ†ๅขž้•ฟ - -### ่ดจ้‡ไธ€่‡ดๆ€ง -- ่ทจไผš่ฏ็š„ไธ€่‡ดๆžถๆž„ๆจกๅผ -- ไฟ็•™็š„ไปฃ็ ่ดจ้‡ๅ†ณ็ญ–ๅ’Œๆ ‡ๅ‡† -- ๅฏ้‡็”จ็š„่งฃๅ†ณๆ–นๆกˆๅ’Œๆœ€ไฝณๅฎž่ทต -- ็ปดๆŒ็š„ๆŠ€ๆœฏๅ€บๅŠกๆ„่ฏ† - ---- - -**ๅ…ณ้”ฎ่ฆ็‚น**๏ผš้€š่ฟ‡ Serena MCP ็š„ไผš่ฏ็ฎก็†ๅฐ† SuperClaude ไปŽๅ•ๆฌกๅฏน่ฏๅธฎๅŠฉ่ฝฌๅ˜ไธบๆŒไน…้กน็›ฎไผ™ไผดๅ…ณ็ณป๏ผŒๅœจๆ‰€ๆœ‰ๅผ€ๅ‘้˜ถๆฎตๅ’Œ Claude Code ๅฏน่ฏไธญ็ปดๆŠคไธŠไธ‹ๆ–‡ใ€ๅ†ณ็ญ–ๅ’Œๅญฆไน ใ€‚ \ No newline at end of file diff --git a/docs/User-Guide/agents.md b/docs/User-Guide/agents.md deleted file mode 100644 index ae2d3cc..0000000 --- a/docs/User-Guide/agents.md +++ /dev/null @@ -1,936 +0,0 @@ -# SuperClaude Agents Guide ๐Ÿค– - -SuperClaude provides 16 domain specialist agents that Claude Code can invoke for specialized expertise. - - -## ๐Ÿงช Testing Agent Activation - -Before using this guide, verify agent selection works: - -```bash -# Test manual agent invocation -@agent-python-expert "explain decorators" -# Example behavior: Python expert responds with detailed explanation - -# Test security agent auto-activation -/sc:implement "JWT authentication" -# Example behavior: Security engineer should activate automatically - -# Test frontend agent auto-activation -/sc:implement "responsive navigation component" -# Example behavior: Frontend architect + Magic MCP should activate - -# Test systematic analysis -/sc:troubleshoot "slow API performance" -# Example behavior: Root-cause analyst + performance engineer activation - -# Test combining manual and auto -/sc:analyze src/ -@agent-refactoring-expert "suggest improvements" -# Example behavior: Analysis followed by refactoring suggestions -``` - -**If tests fail**: Check agent files exist in `~/.claude/agents/` or restart Claude Code session - -## Core Concepts - -### What are SuperClaude Agents? -**Agents** are specialized AI domain experts implemented as context instructions that modify Claude Code's behavior. Each agent is a carefully crafted `.md` file in the `superclaude/Agents/` directory containing domain-specific expertise, behavioral patterns, and problem-solving approaches. - -**Important**: Agents are NOT separate AI models or software - they are context configurations that Claude Code reads to adopt specialized behaviors. - -### Two Ways to Use Agents - -#### 1. Manual Invocation with @agent- Prefix -```bash -# Directly invoke a specific agent -@agent-security "review authentication implementation" -@agent-frontend "design responsive navigation" -@agent-architect "plan microservices migration" -``` - -#### 2. Auto-Activation (Behavioral Routing) -"Auto-activation" means Claude Code reads behavioral instructions to engage appropriate contexts based on keywords and patterns in your requests. SuperClaude provides behavioral guidelines that Claude follows to route to the most appropriate specialists. - -> **๐Ÿ“ How Agent "Auto-Activation" Works**: -> Agent activation isn't automatic system logic - it's behavioral instructions in context files. -> When documentation says agents "auto-activate", it means Claude Code reads instructions to engage -> specific domain expertise based on keywords and patterns in your request. This creates the -> experience of intelligent routing while being transparent about the underlying mechanism. - -```bash -# These commands auto-activate relevant agents -/sc:implement "JWT authentication" # โ†’ security-engineer auto-activates -/sc:design "React dashboard" # โ†’ frontend-architect auto-activates -/sc:troubleshoot "memory leak" # โ†’ performance-engineer auto-activates -``` - -**MCP Servers** provide enhanced capabilities through specialized tools like Context7 (documentation), Sequential (analysis), Magic (UI), Playwright (testing), and Morphllm (code transformation). - -**Domain Specialists** focus on narrow expertise areas to provide deeper, more accurate solutions than generalist approaches. - -### Agent Selection Rules - -**Priority Hierarchy:** -1. **Manual Override** - @agent-[name] takes precedence over auto-activation -2. **Keywords** - Direct domain terminology triggers primary agents -3. **File Types** - Extensions activate language/framework specialists -4. **Complexity** - Multi-step tasks engage coordination agents -5. **Context** - Related concepts trigger complementary agents - -**Conflict Resolution:** -- Manual invocation โ†’ Specified agent takes priority -- Multiple matches โ†’ Multi-agent coordination -- Unclear context โ†’ Requirements analyst activation -- High complexity โ†’ System architect oversight -- Quality concerns โ†’ Automatic QA agent inclusion - -**Selection Decision Tree:** -``` -Task Analysis โ†’ -โ”œโ”€ Manual @agent-? โ†’ Use specified agent -โ”œโ”€ Single Domain? โ†’ Activate primary agent -โ”œโ”€ Multi-Domain? โ†’ Coordinate specialist agents -โ”œโ”€ Complex System? โ†’ Add system-architect oversight -โ”œโ”€ Quality Critical? โ†’ Include security + performance + quality agents -โ””โ”€ Learning Focus? โ†’ Add learning-guide + technical-writer -``` - -## Quick Start Examples - -### Manual Agent Invocation -```bash -# Explicitly call specific agents with @agent- prefix -@agent-python-expert "optimize this data processing pipeline" -@agent-quality-engineer "create comprehensive test suite" -@agent-technical-writer "document this API with examples" -@agent-socratic-mentor "explain this design pattern" -``` - -### Automatic Agent Coordination -```bash -# Commands that trigger auto-activation -/sc:implement "JWT authentication with rate limiting" -# โ†’ Triggers: security-engineer + backend-architect + quality-engineer - -/sc:design "accessible React dashboard with documentation" -# โ†’ Triggers: frontend-architect + learning-guide + technical-writer - -/sc:troubleshoot "slow deployment pipeline with intermittent failures" -# โ†’ Triggers: devops-architect + performance-engineer + root-cause-analyst - -/sc:audit "payment processing security vulnerabilities" -# โ†’ Triggers: security-engineer + quality-engineer + refactoring-expert -``` - -### Combining Manual and Auto Approaches -```bash -# Start with command (auto-activation) -/sc:implement "user profile system" - -# Then explicitly add specialist review -@agent-security "review the profile system for OWASP compliance" -@agent-performance-engineer "optimize database queries" -``` - ---- - -## The SuperClaude Agent Team ๐Ÿ‘ฅ - -### Meta-Layer Agent ๐ŸŽฏ - -### pm-agent ๐Ÿ“š -**Expertise**: Self-improvement workflow executor that documents implementations, analyzes mistakes, and maintains knowledge base continuously - -**Auto-Activation**: -- **Post-Implementation**: After any task completion requiring documentation -- **Mistake Detection**: Immediate analysis when errors or bugs occur -- **Monthly Maintenance**: Regular documentation health reviews -- **Knowledge Gap**: When patterns emerge requiring documentation -- Commands: Automatically activates after `/sc:implement`, `/sc:build`, `/sc:improve` completions - -**Capabilities**: -- **Implementation Documentation**: Record new patterns, architectural decisions, edge cases discovered -- **Mistake Analysis**: Root cause analysis, prevention checklists, pattern identification -- **Pattern Recognition**: Extract success patterns, anti-patterns, best practices -- **Knowledge Maintenance**: Monthly reviews, noise reduction, duplication merging, freshness updates -- **Self-Improvement Loop**: Transform every experience into reusable knowledge - -**How PM Agent Works** (Meta-Layer): -1. **Specialist Agents Complete Task**: Backend-architect implements feature -2. **PM Agent Auto-Activates**: After implementation completion -3. **Documentation**: Records patterns, decisions, edge cases in docs/ -4. **Knowledge Update**: Updates CLAUDE.md if global pattern discovered -5. **Evidence Collection**: Links test results, screenshots, metrics -6. **Learning Integration**: Extracts lessons for future implementations - -**Self-Improvement Workflow Examples**: -1. **Post-Implementation Documentation**: - - Scenario: Backend architect just implemented JWT authentication - - PM Agent: Analyzes implementation โ†’ Documents JWT pattern โ†’ Updates docs/authentication.md โ†’ Records security decisions โ†’ Creates evidence links - - Output: Comprehensive authentication pattern documentation for future reuse - -2. **Immediate Mistake Analysis**: - - Scenario: Direct Supabase import used (Kong Gateway bypassed) - - PM Agent: Stops implementation โ†’ Root cause analysis โ†’ Documents in self-improvement-workflow.md โ†’ Creates prevention checklist โ†’ Updates CLAUDE.md - - Output: Mistake recorded with prevention strategy, won't repeat error - -3. **Monthly Documentation Maintenance**: - - Scenario: Monthly review on 1st of month - - PM Agent: Reviews docs older than 6 months โ†’ Deletes unused documents โ†’ Merges duplicates โ†’ Updates version numbers โ†’ Reduces verbosity - - Output: Fresh, minimal, high-signal documentation maintained - -**Integration with Task Execution**: -PM Agent operates as a **meta-layer** above specialist agents: -``` -Task Flow: -1. User Request โ†’ Auto-activation selects specialist agent -2. Specialist Agent โ†’ Executes implementation (backend-architect, frontend-architect, etc.) -3. PM Agent (Auto-triggered) โ†’ Documents learnings -4. Knowledge Base โ†’ Updated with patterns, mistakes, improvements -``` - -**Works Best With**: All agents (documents their work, not replaces them) - -**Quality Standards**: -- **Latest**: Last Verified dates on all documents -- **Minimal**: Necessary information only, no verbosity -- **Clear**: Concrete examples and copy-paste ready code -- **Practical**: Immediately applicable to real work - -**Self-Improvement Loop Phases**: -- **AFTER Phase**: Primary responsibility - document implementations, update docs/, create evidence -- **MISTAKE RECOVERY**: Immediate stop, root cause analysis, documentation update -- **MAINTENANCE**: Monthly pruning, merging, freshness updates, noise reduction - -**Verify**: Activates automatically after task completions requiring documentation -**Test**: Should document patterns after backend-architect implements features -**Check**: Should create prevention checklists when mistakes detected - ---- - -### Architecture & System Design Agents ๐Ÿ—๏ธ - -### system-architect ๐Ÿข -**Expertise**: Large-scale distributed system design with focus on scalability and service architecture - -**Auto-Activation**: -- Keywords: "architecture", "microservices", "scalability", "system design", "distributed" -- Context: Multi-service systems, architectural decisions, technology selection -- Complexity: >5 components or cross-domain integration requirements - -**Capabilities**: -- Service boundary definition and microservices decomposition -- Technology stack selection and integration strategy -- Scalability planning and performance architecture -- Event-driven architecture and messaging patterns -- Data flow design and system integration - -**Examples**: -1. **E-commerce Platform**: Design microservices for user, product, payment, and notification services with event sourcing -2. **Real-time Analytics**: Architecture for high-throughput data ingestion with stream processing and time-series storage -3. **Multi-tenant SaaS**: System design with tenant isolation, shared infrastructure, and horizontal scaling strategies - -### Success Criteria -- [ ] System-level thinking evident in responses -- [ ] Mentions service boundaries and integration patterns -- [ ] Includes scalability and reliability considerations -- [ ] Provides technology stack recommendations - -**Verify:** `/sc:design "microservices platform"` should activate system-architect -**Test:** Output should include service decomposition and integration patterns -**Check:** Should coordinate with devops-architect for infrastructure concerns - -**Works Best With**: devops-architect (infrastructure), performance-engineer (optimization), security-engineer (compliance) - ---- - -### backend-architect โš™๏ธ -**Expertise**: Robust server-side system design with emphasis on API reliability and data integrity - -**Auto-Activation**: -- Keywords: "API", "backend", "server", "database", "REST", "GraphQL", "endpoint" -- File Types: API specs, server configs, database schemas -- Context: Server-side logic, data persistence, API development - -**Capabilities**: -- RESTful and GraphQL API architecture and design patterns -- Database schema design and query optimization strategies -- Authentication, authorization, and security implementation -- Error handling, logging, and monitoring integration -- Caching strategies and performance optimization - -**Examples**: -1. **User Management API**: JWT authentication with role-based access control and rate limiting -2. **Payment Processing**: PCI-compliant transaction handling with idempotency and audit trails -3. **Content Management**: RESTful APIs with caching, pagination, and real-time notifications - -**Works Best With**: security-engineer (auth/security), performance-engineer (optimization), quality-engineer (testing) - ---- - -### frontend-architect ๐ŸŽจ -**Expertise**: Modern web application architecture with focus on accessibility and user experience - -**Auto-Activation**: -- Keywords: "UI", "frontend", "React", "Vue", "Angular", "component", "accessibility", "responsive" -- File Types: .jsx, .vue, .ts (frontend), .css, .scss -- Context: User interface development, component design, client-side architecture - -**Capabilities**: -- Component architecture and design system implementation -- State management patterns (Redux, Zustand, Pinia) -- Accessibility compliance (WCAG 2.1) and inclusive design -- Performance optimization and bundle analysis -- Progressive Web App and mobile-first development - -**Examples**: -1. **Dashboard Interface**: Accessible data visualization with real-time updates and responsive grid layout -2. **Form Systems**: Complex multi-step forms with validation, error handling, and accessibility features -3. **Design System**: Reusable component library with consistent styling and interaction patterns - -**Works Best With**: learning-guide (user guidance), performance-engineer (optimization), quality-engineer (testing) - ---- - -### devops-architect ๐Ÿš€ -**Expertise**: Infrastructure automation and deployment pipeline design for reliable software delivery - -**Auto-Activation**: -- Keywords: "deploy", "CI/CD", "Docker", "Kubernetes", "infrastructure", "monitoring", "pipeline" -- File Types: Dockerfile, docker-compose.yml, k8s manifests, CI configs -- Context: Deployment processes, infrastructure management, automation - -**Capabilities**: -- CI/CD pipeline design with automated testing and deployment -- Container orchestration and Kubernetes cluster management -- Infrastructure as Code with Terraform and cloud platforms -- Monitoring, logging, and observability stack implementation -- Security scanning and compliance automation - -**Examples**: -1. **Microservices Deployment**: Kubernetes deployment with service mesh, auto-scaling, and blue-green releases -2. **Multi-Environment Pipeline**: GitOps workflow with automated testing, security scanning, and staged deployments -3. **Monitoring Stack**: Comprehensive observability with metrics, logs, traces, and alerting systems - -**Works Best With**: system-architect (infrastructure planning), security-engineer (compliance), performance-engineer (monitoring) - ---- - -### deep-research-agent ๐Ÿ”ฌ -**Expertise**: Comprehensive research with adaptive strategies and multi-hop reasoning - -**Auto-Activation**: -- Keywords: "research", "investigate", "discover", "explore", "find out", "search for", "latest", "current" -- Commands: `/sc:research` automatically activates this agent -- Context: Complex queries requiring thorough research, current information needs, fact-checking -- Complexity: Questions spanning multiple domains or requiring iterative exploration - -**Capabilities**: -- **Adaptive Planning Strategies**: Planning (direct), Intent (clarify first), Unified (collaborative) -- **Multi-Hop Reasoning**: Up to 5 levels - entity expansion, temporal progression, conceptual deepening, causal chains -- **Self-Reflective Mechanisms**: Progress assessment after each major step with replanning triggers -- **Evidence Management**: Clear citations, relevance scoring, uncertainty acknowledgment -- **Tool Orchestration**: Parallel-first execution with Tavily (search), Playwright (JavaScript content), Sequential (reasoning) -- **Learning Integration**: Pattern recognition and strategy reuse via Serena memory - -**Research Depth Levels**: -- **Quick**: Basic search, 1 hop, summary output -- **Standard**: Extended search, 2-3 hops, structured report (default) -- **Deep**: Comprehensive search, 3-4 hops, detailed analysis -- **Exhaustive**: Maximum depth, 5 hops, complete investigation - -**Examples**: -1. **Technical Research**: `/sc:research "latest React Server Components patterns"` โ†’ Comprehensive technical research with implementation examples -2. **Market Analysis**: `/sc:research "AI coding assistants landscape 2024" --strategy unified` โ†’ Collaborative analysis with user input -3. **Academic Investigation**: `/sc:research "quantum computing breakthroughs" --depth exhaustive` โ†’ Comprehensive literature review with evidence chains - -**Workflow Pattern** (6-Phase): -1. **Understand** (5-10%): Assess query complexity -2. **Plan** (10-15%): Select strategy and identify parallel opportunities -3. **TodoWrite** (5%): Create adaptive task hierarchy (3-15 tasks) -4. **Execute** (50-60%): Parallel searches and extractions -5. **Track** (Continuous): Monitor progress and confidence -6. **Validate** (10-15%): Verify evidence chains - -**Output**: Reports saved to `claudedocs/research_[topic]_[timestamp].md` - -**Works Best With**: system-architect (technical research), learning-guide (educational research), requirements-analyst (market research) - -### Quality & Analysis Agents ๐Ÿ” - -### security-engineer ๐Ÿ”’ -**Expertise**: Application security architecture with focus on threat modeling and vulnerability prevention - -**Auto-Activation**: -- Keywords: "security", "auth", "authentication", "vulnerability", "encryption", "compliance", "OWASP" -- Context: Security reviews, authentication flows, data protection requirements -- Risk Indicators: Payment processing, user data, API access, regulatory compliance needs - -**Capabilities**: -- Threat modeling and attack surface analysis -- Secure authentication and authorization design (OAuth, JWT, SAML) -- Data encryption strategies and key management -- Vulnerability assessment and penetration testing guidance -- Security compliance (GDPR, HIPAA, PCI-DSS) implementation - -**Examples**: -1. **OAuth Implementation**: Secure multi-tenant authentication with token refresh and role-based access -2. **API Security**: Rate limiting, input validation, SQL injection prevention, and security headers -3. **Data Protection**: Encryption at rest/transit, key rotation, and privacy-by-design architecture - -**Works Best With**: backend-architect (API security), quality-engineer (security testing), root-cause-analyst (incident response) - ---- - -### performance-engineer โšก -**Expertise**: System performance optimization with focus on scalability and resource efficiency - -**Auto-Activation**: -- Keywords: "performance", "slow", "optimization", "bottleneck", "latency", "memory", "CPU" -- Context: Performance issues, scalability concerns, resource constraints -- Metrics: Response times >500ms, high memory usage, poor throughput - -**Capabilities**: -- Performance profiling and bottleneck identification -- Database query optimization and indexing strategies -- Caching implementation (Redis, CDN, application-level) -- Load testing and capacity planning -- Memory management and resource optimization - -**Examples**: -1. **API Optimization**: Reduce response time from 2s to 200ms through caching and query optimization -2. **Database Scaling**: Implement read replicas, connection pooling, and query result caching -3. **Frontend Performance**: Bundle optimization, lazy loading, and CDN implementation for <3s load times - -**Works Best With**: system-architect (scalability), devops-architect (infrastructure), root-cause-analyst (debugging) - ---- - -### root-cause-analyst ๐Ÿ” -**Expertise**: Systematic problem investigation using evidence-based analysis and hypothesis testing - -**Auto-Activation**: -- Keywords: "bug", "issue", "problem", "debugging", "investigation", "troubleshoot", "error" -- Context: System failures, unexpected behavior, complex multi-component issues -- Complexity: Cross-system problems requiring methodical investigation - -**Capabilities**: -- Systematic debugging methodology and root cause analysis -- Error correlation and dependency mapping across systems -- Log analysis and pattern recognition for failure investigation -- Hypothesis formation and testing for complex problems -- Incident response and post-mortem analysis procedures - -**Examples**: -1. **Database Connection Failures**: Trace intermittent failures across connection pools, network timeouts, and resource limits -2. **Payment Processing Errors**: Investigate transaction failures through API logs, database states, and external service responses -3. **Performance Degradation**: Analyze gradual slowdown through metrics correlation, resource usage, and code changes - -**Works Best With**: performance-engineer (performance issues), security-engineer (security incidents), quality-engineer (testing failures) - ---- - -### quality-engineer โœ… -**Expertise**: Comprehensive testing strategy and quality assurance with focus on automation and coverage - -**Auto-Activation**: -- Keywords: "test", "testing", "quality", "QA", "validation", "coverage", "automation" -- Context: Test planning, quality gates, validation requirements -- Quality Concerns: Code coverage <80%, missing test automation, quality issues - -**Capabilities**: -- Test strategy design (unit, integration, e2e, performance testing) -- Test automation framework implementation and CI/CD integration -- Quality metrics definition and monitoring (coverage, defect rates) -- Edge case identification and boundary testing scenarios -- Accessibility testing and compliance validation - -**Examples**: -1. **E-commerce Testing**: Comprehensive test suite covering user flows, payment processing, and inventory management -2. **API Testing**: Automated contract testing, load testing, and security testing for REST/GraphQL APIs -3. **Accessibility Validation**: WCAG 2.1 compliance testing with automated and manual accessibility audits - -**Works Best With**: security-engineer (security testing), performance-engineer (load testing), frontend-architect (UI testing) - ---- - -### refactoring-expert ๐Ÿ”ง -**Expertise**: Code quality improvement through systematic refactoring and technical debt management - -**Auto-Activation**: -- Keywords: "refactor", "clean code", "technical debt", "SOLID", "maintainability", "code smell" -- Context: Legacy code improvements, architecture updates, code quality issues -- Quality Indicators: High complexity, duplicated code, poor test coverage - -**Capabilities**: -- SOLID principles application and design pattern implementation -- Code smell identification and systematic elimination -- Legacy code modernization strategies and migration planning -- Technical debt assessment and prioritization frameworks -- Code structure improvement and architecture refactoring - -**Examples**: -1. **Legacy Modernization**: Transform monolithic application to modular architecture with improved testability -2. **Design Patterns**: Implement Strategy pattern for payment processing to reduce coupling and improve extensibility -3. **Code Cleanup**: Remove duplicated code, improve naming conventions, and extract reusable components - -**Works Best With**: system-architect (architecture improvements), quality-engineer (testing strategy), python-expert (language-specific patterns) - -### Specialized Development Agents ๐ŸŽฏ - -### python-expert ๐Ÿ -**Expertise**: Production-ready Python development with emphasis on modern frameworks and performance - -**Auto-Activation**: -- Keywords: "Python", "Django", "FastAPI", "Flask", "asyncio", "pandas", "pytest" -- File Types: .py, requirements.txt, pyproject.toml, Pipfile -- Context: Python development tasks, API development, data processing, testing - -**Capabilities**: -- Modern Python architecture patterns and framework selection -- Asynchronous programming with asyncio and concurrent futures -- Performance optimization through profiling and algorithmic improvements -- Testing strategies with pytest, fixtures, and test automation -- Package management and deployment with pip, poetry, and Docker - -**Examples**: -1. **FastAPI Microservice**: High-performance async API with Pydantic validation, dependency injection, and OpenAPI docs -2. **Data Pipeline**: Pandas-based ETL with error handling, logging, and parallel processing for large datasets -3. **Django Application**: Full-stack web app with custom user models, API endpoints, and comprehensive test coverage - -**Works Best With**: backend-architect (API design), quality-engineer (testing), performance-engineer (optimization) - ---- - -### requirements-analyst ๐Ÿ“ -**Expertise**: Requirements discovery and specification development through systematic stakeholder analysis - -**Auto-Activation**: -- Keywords: "requirements", "specification", "PRD", "user story", "functional", "scope", "stakeholder" -- Context: Project initiation, unclear requirements, scope definition needs -- Complexity: Multi-stakeholder projects, unclear objectives, conflicting requirements - -**Capabilities**: -- Requirements elicitation through stakeholder interviews and workshops -- User story writing with acceptance criteria and definition of done -- Functional and non-functional specification documentation -- Stakeholder analysis and requirement prioritization frameworks -- Scope management and change control processes - -**Examples**: -1. **Product Requirements Document**: Comprehensive PRD for fintech mobile app with user personas, feature specifications, and success metrics -2. **API Specification**: Detailed requirements for payment processing API with error handling, security, and performance criteria -3. **Migration Requirements**: Legacy system modernization requirements with data migration, user training, and rollback procedures - -**Works Best With**: system-architect (technical feasibility), technical-writer (documentation), learning-guide (user guidance) - -### Communication & Learning Agents ๐Ÿ“š - -### technical-writer ๐Ÿ“š -**Expertise**: Technical documentation and communication with focus on audience analysis and clarity - -**Auto-Activation**: -- Keywords: "documentation", "readme", "API docs", "user guide", "technical writing", "manual" -- Context: Documentation requests, API documentation, user guides, technical explanations -- File Types: .md, .rst, API specs, documentation files - -**Capabilities**: -- Technical documentation architecture and information design -- Audience analysis and content targeting for different skill levels -- API documentation with working examples and integration guidance -- User guide creation with step-by-step procedures and troubleshooting -- Accessibility standards application and inclusive language usage - -**Examples**: -1. **API Documentation**: Comprehensive REST API docs with authentication, endpoints, examples, and SDK integration guides -2. **User Manual**: Step-by-step installation and configuration guide with screenshots, troubleshooting, and FAQ sections -3. **Technical Specification**: System architecture documentation with diagrams, data flows, and implementation details - -**Works Best With**: requirements-analyst (specification clarity), learning-guide (educational content), frontend-architect (UI documentation) - ---- - -### learning-guide ๐ŸŽ“ -**Expertise**: Educational content design and progressive learning with focus on skill development and mentorship - -**Auto-Activation**: -- Keywords: "explain", "learn", "tutorial", "beginner", "teaching", "education", "training" -- Context: Educational requests, concept explanations, skill development, learning paths -- Complexity: Complex topics requiring step-by-step breakdown and progressive understanding - -**Capabilities**: -- Learning path design with progressive skill development -- Complex concept explanation through analogies and examples -- Interactive tutorial creation with hands-on exercises -- Skill assessment and competency evaluation frameworks -- Mentorship strategies and personalized learning approaches - -**Examples**: -1. **Programming Tutorial**: Interactive React tutorial with hands-on exercises, code examples, and progressive complexity -2. **Concept Explanation**: Database normalization explained through real-world examples with visual diagrams and practice exercises -3. **Skill Assessment**: Comprehensive evaluation framework for full-stack development with practical projects and feedback - -**Works Best With**: technical-writer (educational documentation), frontend-architect (interactive learning), requirements-analyst (learning objectives) - ---- - -## Agent Coordination & Integration ๐Ÿค - -### Coordination Patterns - -**Architecture Teams**: -- **Full-Stack Development**: frontend-architect + backend-architect + security-engineer + quality-engineer -- **System Design**: system-architect + devops-architect + performance-engineer + security-engineer -- **Legacy Modernization**: refactoring-expert + system-architect + quality-engineer + technical-writer - -**Quality Teams**: -- **Security Audit**: security-engineer + quality-engineer + root-cause-analyst + requirements-analyst -- **Performance Optimization**: performance-engineer + system-architect + devops-architect + root-cause-analyst -- **Testing Strategy**: quality-engineer + security-engineer + performance-engineer + frontend-architect - -**Communication Teams**: -- **Documentation Project**: technical-writer + requirements-analyst + learning-guide + domain experts -- **Learning Platform**: learning-guide + frontend-architect + technical-writer + quality-engineer -- **API Documentation**: backend-architect + technical-writer + security-engineer + quality-engineer - -### MCP Server Integration - -**Enhanced Capabilities through MCP Servers**: -- **Context7**: Official documentation patterns for all architects and specialists -- **Sequential**: Multi-step analysis for root-cause-analyst, system-architect, performance-engineer -- **Magic**: UI generation for frontend-architect, learning-guide interactive content -- **Playwright**: Browser testing for quality-engineer, accessibility validation for frontend-architect -- **Morphllm**: Code transformation for refactoring-expert, bulk changes for python-expert -- **Serena**: Project memory for all agents, context preservation across sessions - -### Troubleshooting Agent Activation - -## Troubleshooting - -For troubleshooting help, see: -- [Common Issues](../Reference/common-issues.md) - Quick fixes for frequent problems -- [Troubleshooting Guide](../Reference/troubleshooting.md) - Comprehensive problem resolution - -### Common Issues -- **No agent activation**: Use domain keywords: "security", "performance", "frontend" -- **Wrong agents selected**: Check trigger keywords in agent documentation -- **Too many agents**: Focus keywords on primary domain or use `/sc:focus [domain]` -- **Agents not coordinating**: Increase task complexity or use multi-domain keywords -- **Agent expertise mismatch**: Use more specific technical terminology - -### Immediate Fixes -- **Force agent activation**: Use explicit domain keywords in requests -- **Reset agent selection**: Restart Claude Code session to reset agent state -- **Check agent patterns**: Review trigger keywords in agent documentation -- **Test basic activation**: Try `/sc:implement "security auth"` to test security-engineer - -### Agent-Specific Troubleshooting - -**No Security Agent:** -```bash -# Problem: Security concerns not triggering security-engineer -# Quick Fix: Use explicit security keywords -"implement authentication" # Generic - may not trigger -"implement JWT authentication security" # Explicit - triggers security-engineer -"secure user login with encryption" # Security focus - triggers security-engineer -``` - -**No Performance Agent:** -```bash -# Problem: Performance issues not triggering performance-engineer -# Quick Fix: Use performance-specific terminology -"make it faster" # Vague - may not trigger -"optimize slow database queries" # Specific - triggers performance-engineer -"reduce API latency and bottlenecks" # Performance focus - triggers performance-engineer -``` - -**No Architecture Agent:** -```bash -# Problem: System design not triggering architecture agents -# Quick Fix: Use architectural keywords -"build an app" # Generic - triggers basic agents -"design microservices architecture" # Specific - triggers system-architect -"scalable distributed system design" # Architecture focus - triggers system-architect -``` - -**Wrong Agent Combination:** -```bash -# Problem: Getting frontend agent for backend tasks -# Quick Fix: Use domain-specific terminology -"create user interface" # May trigger frontend-architect -"create REST API endpoints" # Specific - triggers backend-architect -"implement server-side authentication" # Backend focus - triggers backend-architect -``` - -### Support Levels - -**Quick Fix:** -- Use explicit domain keywords from agent trigger table -- Try restarting Claude Code session -- Focus on single domain to avoid confusion - -**Detailed Help:** -- See [Common Issues Guide](../Reference/common-issues.md) for agent installation problems -- Review trigger keywords for target agents - -**Expert Support:** -- Use `SuperClaude install --diagnose` -- See [Diagnostic Reference Guide](../Reference/diagnostic-reference.md) for coordination analysis - -**Community Support:** -- Report issues at [GitHub Issues](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues) -- Include examples of expected vs actual agent activation - -### Success Validation - -After applying agent fixes, test with: -- [ ] Domain-specific requests activate correct agents (security โ†’ security-engineer) -- [ ] Complex tasks trigger multi-agent coordination (3+ agents) -- [ ] Agent expertise matches task requirements (API โ†’ backend-architect) -- [ ] Quality agents auto-include when appropriate (security, performance, testing) -- [ ] Responses show domain expertise and specialized knowledge - -## Quick Troubleshooting (Legacy) -- **No agent activation** โ†’ Use domain keywords: "security", "performance", "frontend" -- **Wrong agents** โ†’ Check trigger keywords in agent documentation -- **Too many agents** โ†’ Focus keywords on primary domain -- **Agents not coordinating** โ†’ Increase task complexity or use multi-domain keywords - -**Agent Not Activating?** -1. **Check Keywords**: Use domain-specific terminology (e.g., "authentication" not "login" for security-engineer) -2. **Add Context**: Include file types, frameworks, or specific technologies -3. **Increase Complexity**: Multi-domain problems trigger more agents -4. **Use Examples**: Reference concrete scenarios that match agent expertise - -**Too Many Agents?** -- Focus keywords on primary domain needs -- Use `/sc:focus [domain]` to limit scope -- Start with specific agents, expand as needed - -**Wrong Agents?** -- Review trigger keywords in agent documentation -- Use more specific terminology for target domain -- Add explicit requirements or constraints - -## Quick Reference ๐Ÿ“‹ - -### Agent Trigger Lookup - -| Trigger Type | Keywords/Patterns | Activated Agents | -|-------------|-------------------|------------------| -| **Security** | "auth", "security", "vulnerability", "encryption" | security-engineer | -| **Performance** | "slow", "optimization", "bottleneck", "latency" | performance-engineer | -| **Frontend** | "UI", "React", "Vue", "component", "responsive" | frontend-architect | -| **Backend** | "API", "server", "database", "REST", "GraphQL" | backend-architect | -| **Testing** | "test", "QA", "validation", "coverage" | quality-engineer | -| **DevOps** | "deploy", "CI/CD", "Docker", "Kubernetes" | devops-architect | -| **Architecture** | "architecture", "microservices", "scalability" | system-architect | -| **Python** | ".py", "Django", "FastAPI", "asyncio" | python-expert | -| **Problems** | "bug", "issue", "debugging", "troubleshoot" | root-cause-analyst | -| **Code Quality** | "refactor", "clean code", "technical debt" | refactoring-expert | -| **Documentation** | "documentation", "readme", "API docs" | technical-writer | -| **Learning** | "explain", "tutorial", "beginner", "teaching" | learning-guide | -| **Requirements** | "requirements", "PRD", "specification" | requirements-analyst | -| **Research** | "research", "investigate", "latest", "current" | deep-research-agent | - -### Command-Agent Mapping - -| Command | Primary Agents | Supporting Agents | -|---------|----------------|-------------------| -| `/sc:implement` | Domain architects (frontend, backend) | security-engineer, quality-engineer | -| `/sc:analyze` | quality-engineer, security-engineer | performance-engineer, root-cause-analyst | -| `/sc:troubleshoot` | root-cause-analyst | Domain specialists, performance-engineer | -| `/sc:improve` | refactoring-expert | quality-engineer, performance-engineer | -| `/sc:document` | technical-writer | Domain specialists, learning-guide | -| `/sc:design` | system-architect | Domain architects, requirements-analyst | -| `/sc:test` | quality-engineer | security-engineer, performance-engineer | -| `/sc:explain` | learning-guide | technical-writer, domain specialists | -| `/sc:research` | deep-research-agent | Technical specialists, learning-guide | - -### Effective Agent Combinations - -**Development Workflows**: -- Web application: frontend-architect + backend-architect + security-engineer + quality-engineer + devops-architect -- API development: backend-architect + security-engineer + technical-writer + quality-engineer -- Data platform: python-expert + performance-engineer + security-engineer + system-architect - -**Analysis Workflows**: -- Security audit: security-engineer + quality-engineer + root-cause-analyst + technical-writer -- Performance investigation: performance-engineer + root-cause-analyst + system-architect + devops-architect -- Legacy assessment: refactoring-expert + system-architect + quality-engineer + security-engineer + technical-writer - -**Communication Workflows**: -- Technical documentation: technical-writer + requirements-analyst + domain experts + learning-guide -- Educational content: learning-guide + technical-writer + frontend-architect + quality-engineer - -## Best Practices ๐Ÿ’ก - -### Getting Started (Simple Approach) - -**Natural Language First:** -1. **Describe Your Goal**: Use natural language with domain-specific keywords -2. **Trust Auto-Activation**: Let the system route to appropriate agents automatically -3. **Learn from Patterns**: Observe which agents activate for different request types -4. **Iterate and Refine**: Add specificity to engage additional specialist agents - -### Optimizing Agent Selection - -**Effective Keyword Usage:** -- **Specific > Generic**: Use "authentication" instead of "login" for security-engineer -- **Technical Terms**: Include framework names, technologies, and specific challenges -- **Context Clues**: Mention file types, project scope, and complexity indicators -- **Quality Keywords**: Add "security", "performance", "accessibility" for comprehensive coverage - -**Request Optimization Examples:** -```bash -# Generic (limited agent activation) -"Fix the login feature" - -# Optimized (multi-agent coordination) -"Implement secure JWT authentication with rate limiting and accessibility compliance" -# โ†’ Triggers: security-engineer + backend-architect + frontend-architect + quality-engineer -``` - -### Common Usage Patterns - -**Development Workflows:** -```bash -# Full-stack feature development -/sc:implement "responsive user dashboard with real-time notifications" -# โ†’ frontend-architect + backend-architect + performance-engineer - -# API development with documentation -/sc:create "REST API for payment processing with comprehensive docs" -# โ†’ backend-architect + security-engineer + technical-writer + quality-engineer - -# Performance optimization investigation -/sc:troubleshoot "slow database queries affecting user experience" -# โ†’ performance-engineer + root-cause-analyst + backend-architect -``` - -**Analysis Workflows:** -```bash -# Security assessment -/sc:analyze "authentication system for GDPR compliance vulnerabilities" -# โ†’ security-engineer + quality-engineer + requirements-analyst - -# Code quality review -/sc:review "legacy codebase for modernization opportunities" -# โ†’ refactoring-expert + system-architect + quality-engineer + technical-writer - -# Learning and explanation -/sc:explain "microservices patterns with hands-on examples" -# โ†’ system-architect + learning-guide + technical-writer -``` - -### Advanced Agent Coordination - -**Multi-Domain Projects:** -- **Start Broad**: Begin with system-level keywords to engage architecture agents -- **Add Specificity**: Include domain-specific needs to activate specialist agents -- **Quality Integration**: Automatically include security, performance, and testing perspectives -- **Documentation Inclusion**: Add learning or documentation needs for comprehensive coverage - -**Troubleshooting Agent Selection:** - -**Problem: Wrong agents activating** -- Solution: Use more specific domain terminology -- Example: "database optimization" โ†’ performance-engineer + backend-architect - -**Problem: Not enough agents** -- Solution: Increase complexity indicators and cross-domain keywords -- Example: Add "security", "performance", "documentation" to requests - -**Problem: Too many agents** -- Solution: Focus on primary domain with specific technical terms -- Example: Use "/sc:focus backend" to limit scope - -### Quality-Driven Development - -**Security-First Approach:** -Always include security considerations in development requests to automatically engage security-engineer alongside domain specialists. - -**Performance Integration:** -Include performance keywords ("fast", "efficient", "scalable") to ensure performance-engineer coordination from the start. - -**Accessibility Compliance:** -Use "accessible", "WCAG", or "inclusive" to automatically include accessibility validation in frontend development. - -**Documentation Culture:** -Add "documented", "explained", or "tutorial" to requests for automatic technical-writer inclusion and knowledge transfer. - ---- - -## Understanding Agent Intelligence ๐Ÿง  - -### What Makes Agents Effective - -**Domain Expertise**: Each agent has specialized knowledge patterns, behavioral approaches, and problem-solving methodologies specific to their domain. - -**Contextual Activation**: Agents analyze request context, not just keywords, to determine relevance and engagement level. - -**Collaborative Intelligence**: Multi-agent coordination produces synergistic results that exceed individual agent capabilities. - -**Adaptive Learning**: Agent selection improves based on request patterns and successful coordination outcomes. - -### Agent vs. Traditional AI - -**Traditional Approach**: Single AI handles all domains with varying levels of expertise -**Agent Approach**: Specialized experts collaborate with deep domain knowledge and focused problem-solving - -**Benefits**: -- Higher accuracy in domain-specific tasks -- More sophisticated problem-solving methodologies -- Better quality assurance through specialist review -- Coordinated multi-perspective analysis - -### Trust the System, Understand the Patterns - -**What to Expect**: -- Automatic routing to appropriate domain experts -- Multi-agent coordination for complex tasks -- Quality integration through automatic QA agent inclusion -- Learning opportunities through educational agent activation - -**What Not to Worry About**: -- Manual agent selection or configuration -- Complex routing rules or agent management -- Agent configuration or coordination -- Micromanaging agent interactions - ---- - -## Related Resources ๐Ÿ“š - -### Essential Documentation -- **[Commands Guide](commands.md)** - Master SuperClaude commands that trigger optimal agent coordination -- **[MCP Servers](mcp-servers.md)** - Enhanced agent capabilities through specialized tool integration -- **[Session Management](session-management.md)** - Long-term workflows with persistent agent context - -### Advanced Usage -- **[Behavioral Modes](modes.md)** - Context optimization for enhanced agent coordination -- **[Getting Started](../Getting-Started/quick-start.md)** - Expert techniques for agent optimization -- **[Examples Cookbook](../Reference/examples-cookbook.md)** - Real-world agent coordination patterns - -### Development Resources -- **[Technical Architecture](../Developer-Guide/technical-architecture.md)** - Understanding SuperClaude's agent system design -- **[Contributing](../Developer-Guide/contributing-code.md)** - Extending agent capabilities and coordination patterns - ---- - -## Your Agent Journey ๐Ÿš€ - -**Week 1: Natural Usage** -Start with natural language descriptions. Notice which agents activate and why. Build intuition for keyword patterns without overthinking the process. - -**Week 2-3: Pattern Recognition** -Observe agent coordination patterns. Understand how complexity and domain keywords influence agent selection. Begin optimizing request phrasing for better coordination. - -**Month 2+: Expert Coordination** -Master multi-domain requests that trigger optimal agent combinations. Leverage troubleshooting techniques for effective agent selection. Use advanced patterns for complex workflows. - -**The SuperClaude Advantage:** -Experience the power of 14 specialized AI experts working in coordinated response, all through simple, natural language requests. No configuration, no management, just intelligent collaboration that scales with your needs. - -๐ŸŽฏ **Ready to experience intelligent agent coordination? Start with `/sc:implement` and discover the magic of specialized AI collaboration.** \ No newline at end of file diff --git a/docs/User-Guide/commands.md b/docs/User-Guide/commands.md deleted file mode 100644 index c30cb25..0000000 --- a/docs/User-Guide/commands.md +++ /dev/null @@ -1,367 +0,0 @@ -# SuperClaude Commands Guide - -SuperClaude provides 25 commands for Claude Code: `/sc:*` commands for workflows and `@agent-*` for specialists. - -## Command Types - -| Type | Where Used | Format | Example | -|------|------------|--------|---------| -| **Slash Commands** | Claude Code | `/sc:[command]` | `/sc:implement "feature"` | -| **Agents** | Claude Code | `@agent-[name]` | `@agent-security "review"` | -| **Installation** | Terminal | `SuperClaude [command]` | `SuperClaude install` | - -## Quick Test -```bash -# Terminal: Verify installation -python3 -m SuperClaude --version -# Claude Code CLI verification: claude --version - -# Claude Code: Test commands -/sc:brainstorm "test project" # Should ask discovery questions -/sc:analyze README.md # Should provide analysis -``` - -**Workflow**: `/sc:brainstorm "idea"` โ†’ `/sc:implement "feature"` โ†’ `/sc:test` - -## ๐ŸŽฏ Understanding SuperClaude Commands - -## How SuperClaude Works - -SuperClaude provides behavioral context files that Claude Code reads to adopt specialized behaviors. When you type `/sc:implement`, Claude Code reads the `implement.md` context file and follows its behavioral instructions. - -**SuperClaude commands are NOT executed by software** - they are context triggers that modify Claude Code's behavior through reading specialized instruction files from the framework. - -### Command Types: -- **Slash Commands** (`/sc:*`): Trigger workflow patterns and behavioral modes -- **Agent Invocations** (`@agent-*`): Manually activate specific domain specialists -- **Flags** (`--think`, `--safe-mode`): Modify command behavior and depth - -### The Context Mechanism: -1. **User Input**: You type `/sc:implement "auth system"` -2. **Context Loading**: Claude Code reads `~/.claude/superclaude/Commands/implement.md` -3. **Behavior Adoption**: Claude applies domain expertise, tool selection, and validation patterns -4. **Enhanced Output**: Structured implementation with security considerations and best practices - -**Key Point**: This creates sophisticated development workflows through context management rather than traditional software execution. - -### Installation vs Usage Commands - -**๐Ÿ–ฅ๏ธ Terminal Commands** (Actual CLI software): -- `SuperClaude install` - Installs the framework components -- `SuperClaude update` - Updates existing installation -- `SuperClaude uninstall` - Removes framework installation -- `python3 -m SuperClaude --version` - Check installation status - -**๐Ÿ’ฌ Claude Code Commands** (Context triggers): -- `/sc:brainstorm` - Activates requirements discovery context -- `/sc:implement` - Activates feature development context -- `@agent-security` - Activates security specialist context -- All commands work inside Claude Code chat interface only - - -> **Quick Start**: Try `/sc:brainstorm "your project idea"` โ†’ `/sc:implement "feature name"` โ†’ `/sc:test` to experience the core workflow. - -## ๐Ÿงช Testing Your Setup - -### ๐Ÿ–ฅ๏ธ Terminal Verification (Run in Terminal/CMD) -```bash -# Verify SuperClaude is working (primary method) -python3 -m SuperClaude --version -# Example output: SuperClaude 4.1.5 - -# Claude Code CLI version check -claude --version - -# Check installed components -python3 -m SuperClaude install --list-components | grep mcp -# Example output: Shows installed MCP components -``` - -### ๐Ÿ’ฌ Claude Code Testing (Type in Claude Code Chat) -``` -# Test basic /sc: command -/sc:brainstorm "test project" -# Example behavior: Interactive requirements discovery starts - -# Test command help -/sc:help -# Example behavior: List of available commands -``` - -**If tests fail**: Check [Installation Guide](../Getting-Started/installation.md) or [Troubleshooting](#troubleshooting) - -### ๐Ÿ“ Command Quick Reference - -| Command Type | Where to Run | Format | Purpose | Example | -|-------------|--------------|--------|---------|----------| -| **๐Ÿ–ฅ๏ธ Installation** | Terminal/CMD | `SuperClaude [command]` | Setup and maintenance | `SuperClaude install` | -| **๐Ÿ”ง Configuration** | Terminal/CMD | `python3 -m SuperClaude [command]` | Advanced configuration | `python3 -m SuperClaude --version` | -| **๐Ÿ’ฌ Slash Commands** | Claude Code | `/sc:[command]` | Workflow automation | `/sc:implement "feature"` | -| **๐Ÿค– Agent Invocation** | Claude Code | `@agent-[name]` | Manual specialist activation | `@agent-security "review"` | -| **โšก Enhanced Flags** | Claude Code | `/sc:[command] --flags` | Behavior modification | `/sc:analyze --think-hard` | - -> **Remember**: All `/sc:` commands and `@agent-` invocations work inside Claude Code chat, not your terminal. They trigger Claude Code to read specific context files from the SuperClaude framework. - -## Table of Contents - -- [Essential Commands](#essential-commands) - Start here (8 core commands) -- [Common Workflows](#common-workflows) - Command combinations that work -- [Full Command Reference](#full-command-reference) - All 25 commands organized by category -- [Troubleshooting](#troubleshooting) - Common issues and solutions -- [Command Index](#command-index) - Find commands by category - ---- - -## Essential Commands - -**Core workflow commands for immediate productivity:** - -### `/sc:brainstorm` - Project Discovery -**Purpose**: Interactive requirements discovery and project planning -**Syntax**: `/sc:brainstorm "your idea"` `[--strategy systematic|creative]` - -**Use Cases**: -- New project planning: `/sc:brainstorm "e-commerce platform"` -- Feature exploration: `/sc:brainstorm "user authentication system"` -- Problem solving: `/sc:brainstorm "slow database queries"` - -### `/sc:help` - Command Reference -**Purpose**: Displays a list of all available `/sc` commands and their descriptions. -**Syntax**: `/sc:help` - -**Use Cases**: -- Discovering available commands: `/sc:help` -- Getting a quick reminder of command names: `/sc:help` - -### `/sc:research` - Deep Research Command -**Purpose**: Comprehensive web research with adaptive planning and intelligent search -**Syntax**: `/sc:research "[query]"` `[--depth quick|standard|deep|exhaustive] [--strategy planning|intent|unified]` - -**Use Cases**: -- Technical research: `/sc:research "latest React 19 features" --depth deep` -- Market analysis: `/sc:research "AI coding assistant landscape 2024" --strategy unified` -- Academic investigation: `/sc:research "quantum computing breakthroughs" --depth exhaustive` -- Current events: `/sc:research "latest AI developments 2024"` - -**Key Capabilities**: -- **6-Phase Workflow**: Understand โ†’ Plan โ†’ TodoWrite โ†’ Execute โ†’ Track โ†’ Validate -- **Adaptive Depth**: Quick (basic search), Standard (extended), Deep (comprehensive), Exhaustive (maximum depth) -- **Planning Strategies**: Planning (direct), Intent (clarify first), Unified (collaborative) -- **Parallel Execution**: Default parallel searches and extractions -- **Evidence Management**: Clear citations with relevance scoring -- **Output Standards**: Reports saved to `claudedocs/research_[topic]_[timestamp].md` - -### `/sc:implement` - Feature Development -**Purpose**: Full-stack feature implementation with intelligent specialist routing -**Syntax**: `/sc:implement "feature description"` `[--type frontend|backend|fullstack] [--focus security|performance]` - -**Use Cases**: -- Authentication: `/sc:implement "JWT login system"` -- UI components: `/sc:implement "responsive dashboard"` -- APIs: `/sc:implement "REST user endpoints"` -- Database: `/sc:implement "user schema with relationships"` - -### `/sc:analyze` - Code Assessment -**Purpose**: Comprehensive code analysis across quality, security, and performance -**Syntax**: `/sc:analyze [path]` `[--focus quality|security|performance|architecture]` - -**Use Cases**: -- Project health: `/sc:analyze .` -- Security audit: `/sc:analyze --focus security` -- Performance review: `/sc:analyze --focus performance` - -### `/sc:business-panel` - Strategic Business Analysis -**Purpose**: Multi-expert business strategy analysis with 9 renowned thought leaders -**Syntax**: `/sc:business-panel "content"` `[--mode discussion|debate|socratic] [--experts "name1,name2"]` - -**Use Cases**: -- Strategy evaluation: `/sc:business-panel "our go-to-market strategy"` -- Competitive analysis: `/sc:business-panel @competitor_analysis.pdf --mode debate` -- Innovation assessment: `/sc:business-panel "AI product idea" --experts "christensen,drucker"` -- Strategic learning: `/sc:business-panel "competitive strategy" --mode socratic` - -**Expert Panel**: Christensen, Porter, Drucker, Godin, Kim/Mauborgne, Collins, Taleb, Meadows, Doumont - -### `/sc:spec-panel` - Expert Specification Review -**Purpose**: Multi-expert specification review and improvement using renowned specification and software engineering experts -**Syntax**: `/sc:spec-panel [content|@file]` `[--mode discussion|critique|socratic] [--focus requirements|architecture|testing|compliance]` - -**Use Cases**: -- Specification review: `/sc:spec-panel @api_spec.yml --mode critique --focus requirements,architecture` -- Requirements workshop: `/sc:spec-panel "user story content" --mode discussion` -- Architecture validation: `/sc:spec-panel @microservice.spec.yml --mode socratic --focus architecture` -- Compliance review: `/sc:spec-panel @security_requirements.yml --focus compliance` -- Iterative improvement: `/sc:spec-panel @complex_system.spec.yml --iterations 3` - -**Expert Panel**: Wiegers, Adzic, Cockburn, Fowler, Nygard, Newman, Hohpe, Crispin, Gregory, Hightower - -### `/sc:troubleshoot` - Problem Diagnosis -**Purpose**: Systematic issue diagnosis with root cause analysis -**Syntax**: `/sc:troubleshoot "issue description"` `[--type build|runtime|performance]` - -**Use Cases**: -- Runtime errors: `/sc:troubleshoot "500 error on login"` -- Build failures: `/sc:troubleshoot --type build` -- Performance problems: `/sc:troubleshoot "slow page load"` - -### `/sc:test` - Quality Assurance -**Purpose**: Comprehensive testing with coverage analysis -**Syntax**: `/sc:test` `[--type unit|integration|e2e] [--coverage] [--fix]` - -**Use Cases**: -- Full test suite: `/sc:test --coverage` -- Unit testing: `/sc:test --type unit --watch` -- E2E validation: `/sc:test --type e2e` - -### `/sc:improve` - Code Enhancement -**Purpose**: Apply systematic code improvements and optimizations -**Syntax**: `/sc:improve [path]` `[--type performance|quality|security] [--preview]` - -**Use Cases**: -- General improvements: `/sc:improve src/` -- Performance optimization: `/sc:improve --type performance` -- Security hardening: `/sc:improve --type security` - -### `/sc:document` - Documentation Generation -**Purpose**: Generate comprehensive documentation for code and APIs -**Syntax**: `/sc:document [path]` `[--type api|user-guide|technical] [--format markdown|html]` - -**Use Cases**: -- API docs: `/sc:document --type api` -- User guides: `/sc:document --type user-guide` -- Technical docs: `/sc:document --type technical` - -### `/sc:workflow` - Implementation Planning -**Purpose**: Generate structured implementation plans from requirements -**Syntax**: `/sc:workflow "feature description"` `[--strategy agile|waterfall] [--format markdown]` - -**Use Cases**: -- Feature planning: `/sc:workflow "user authentication"` -- Sprint planning: `/sc:workflow --strategy agile` -- Architecture planning: `/sc:workflow "microservices migration"` - ---- - -## Common Workflows - -**Proven command combinations:** - -### New Project Setup -```bash -/sc:brainstorm "project concept" # Define requirements -/sc:design "system architecture" # Create technical design -/sc:workflow "implementation plan" # Generate development roadmap -``` - -### Feature Development -```bash -/sc:implement "feature name" # Build the feature -/sc:test --coverage # Validate with tests -/sc:document --type api # Generate documentation -``` - -### Code Quality Improvement -```bash -/sc:analyze --focus quality # Assess current state -/sc:improve --preview # Preview improvements -/sc:test --coverage # Validate changes -``` - -### Bug Investigation -```bash -/sc:troubleshoot "issue description" # Diagnose the problem -/sc:analyze --focus problem-area # Deep analysis -/sc:improve --fix --safe-mode # Apply targeted fixes -``` - -### Specification Development -```bash -/sc:spec-panel @existing_spec.yml --mode critique # Expert review -/sc:spec-panel @improved_spec.yml --iterations 2 # Iterative refinement -/sc:document --type technical # Generate documentation -``` - -## Full Command Reference - -### Development Commands -| Command | Purpose | Best For | -|---------|---------|----------| -| **workflow** | Implementation planning | Project roadmaps, sprint planning | -| **implement** | Feature development | Full-stack features, API development | -| **build** | Project compilation | CI/CD, production builds | -| **design** | System architecture | API specs, database schemas | - -### Analysis Commands -| Command | Purpose | Best For | -|---------|---------|----------| -| **analyze** | Code assessment | Quality audits, security reviews | -| **research** | Web research with intelligent search | Technical research, current events, market analysis | -| **business-panel** | Strategic analysis | Business decisions, competitive assessment | -| **spec-panel** | Specification review | Requirements validation, architecture analysis | -| **troubleshoot** | Problem diagnosis | Bug investigation, performance issues | -| **explain** | Code explanation | Learning, code reviews | - -### Quality Commands -| Command | Purpose | Best For | -|---------|---------|----------| -| **improve** | Code enhancement | Performance optimization, refactoring | -| **cleanup** | Technical debt | Dead code removal, organization | -| **test** | Quality assurance | Test automation, coverage analysis | -| **document** | Documentation | API docs, user guides | - -### Project Management -| Command | Purpose | Best For | -|---------|---------|----------| -| **estimate** | Project estimation | Timeline planning, resource allocation | -| **task** | Task management | Complex workflows, task tracking | -| **spawn** | Meta-orchestration | Large-scale projects, parallel execution | - -### Utility Commands -| Command | Purpose | Best For | -|---------|---------|----------| -| **help** | List all commands | Discovering available commands | -| **git** | Version control | Commit management, branch strategies | -| **index** | Command discovery | Exploring capabilities, finding commands | - -### Session Commands -| Command | Purpose | Best For | -|---------|---------|----------| -| **load** | Context loading | Session initialization, project onboarding | -| **save** | Session persistence | Checkpointing, context preservation | -| **reflect** | Task validation | Progress assessment, completion validation | -| **select-tool** | Tool optimization | Performance optimization, tool selection | - ---- - -## Command Index - -**By Function:** -- **Planning**: brainstorm, design, workflow, estimate -- **Development**: implement, build, git -- **Analysis**: analyze, business-panel, spec-panel, troubleshoot, explain -- **Quality**: improve, cleanup, test, document -- **Management**: task, spawn, load, save, reflect -- **Utility**: help, index, select-tool - -**By Complexity:** -- **Beginner**: brainstorm, implement, analyze, test, help -- **Intermediate**: workflow, design, business-panel, spec-panel, improve, document -- **Advanced**: spawn, task, select-tool, reflect - -## Troubleshooting - -**Command Issues:** -- **Command not found**: Verify installation: `python3 -m SuperClaude --version` -- **No response**: Restart Claude Code session -- **Processing delays**: Use `--no-mcp` to test without MCP servers - -**Quick Fixes:** -- Reset session: `/sc:load` to reinitialize -- Check status: `SuperClaude install --list-components` -- Get help: [Troubleshooting Guide](../Reference/troubleshooting.md) - -## Next Steps - -- [Flags Guide](flags.md) - Control command behavior -- [Agents Guide](agents.md) - Specialist activation -- [Examples Cookbook](../Reference/examples-cookbook.md) - Real usage patterns \ No newline at end of file diff --git a/docs/User-Guide/flags.md b/docs/User-Guide/flags.md deleted file mode 100644 index 639e15e..0000000 --- a/docs/User-Guide/flags.md +++ /dev/null @@ -1,273 +0,0 @@ -# SuperClaude Flags Guide ๐Ÿ - -**Most flags activate automatically** - Claude Code reads behavioral instructions to engage appropriate contexts based on keywords and patterns in your requests. - -## Essential Auto-Activation Flags (90% of Use Cases) - -### Core Analysis Flags -| Flag | When Activated | What It Does | -|------|---------------|--------------| -| `--think` | 5+ files OR complex analysis | Standard structured analysis (~4K tokens) | -| `--think-hard` | Architectural analysis, system dependencies | Deep analysis (~10K tokens) with enhanced tools | -| `--ultrathink` | Critical system redesign, legacy modernization | Maximum depth analysis (~32K tokens) with all tools | - -### MCP Server Flags -| Flag | Server | Purpose | Auto-Triggers | -|------|---------|---------|---------------| -| `--c7` / `--context7` | Context7 | Official docs, framework patterns | Library imports, framework questions | -| `--seq` / `--sequential` | Sequential | Multi-step reasoning, debugging | Complex debugging, system design | -| `--magic` | Magic | UI component generation | `/ui` commands, frontend keywords | -| `--play` / `--playwright` | Playwright | Browser testing, E2E validation | Testing requests, visual validation | -| `--chrome` / `--devtools` | Chrome DevTools | Performance analysis, debugging | Performance auditing, debugging, layout issues | -| `--tavily` | Tavily | Web search, real-time info | Web search requests, research queries | -| `--morph` / `--morphllm` | Morphllm | Bulk transformations, pattern edits | Bulk operations, style enforcement | -| `--serena` | Serena | Project memory, symbol operations | Symbol operations, large codebases | - -### Behavioral Mode Flags -| Flag | When Activated | What It Does | -|------|---------------|--------------| -| `--brainstorm` | Vague requests, exploration keywords | Collaborative discovery mindset | -| `--introspect` | Self-analysis, error recovery | Expose reasoning process with transparency | -| `--task-manage` | >3 steps, complex scope | Orchestrate through delegation | -| `--orchestrate` | Multi-tool operations, performance needs | Optimize tool selection and parallel execution | -| `--token-efficient` / `--uc` | Context >75%, efficiency needs | Symbol-enhanced communication, 30-50% reduction | - -### Execution Control Flags -| Flag | When Activated | What It Does | -|------|---------------|--------------| -| `--loop` | "improve", "polish", "refine" keywords | Iterative enhancement cycles | -| `--safe-mode` | Production, >85% resource usage | Maximum validation, conservative execution | -| `--validate` | Risk >0.7, production environment | Pre-execution risk assessment | -| `--delegate` | >7 directories OR >50 files | Sub-agent parallel processing | - -## Command-Specific Flags - -### Analysis Command Flags (`/sc:analyze`) -| Flag | Purpose | Values | -|------|---------|--------| -| `--focus` | Target specific domain | `security`, `performance`, `quality`, `architecture` | -| `--depth` | Analysis thoroughness | `quick`, `deep` | -| `--format` | Output format | `text`, `json`, `report` | - -### Build Command Flags (`/sc:build`) -| Flag | Purpose | Values | -|------|---------|--------| -| `--type` | Build configuration | `dev`, `prod`, `test` | -| `--clean` | Clean before build | Boolean | -| `--optimize` | Enable optimizations | Boolean | -| `--verbose` | Detailed output | Boolean | - -### Design Command Flags (`/sc:design`) -| Flag | Purpose | Values | -|------|---------|--------| -| `--type` | Design target | `architecture`, `api`, `component`, `database` | -| `--format` | Output format | `diagram`, `spec`, `code` | - -### Explain Command Flags (`/sc:explain`) -| Flag | Purpose | Values | -|------|---------|--------| -| `--level` | Complexity level | `basic`, `intermediate`, `advanced` | -| `--format` | Explanation style | `text`, `examples`, `interactive` | -| `--context` | Domain context | Any domain (e.g., `react`, `security`) | - -### Improve Command Flags (`/sc:improve`) -| Flag | Purpose | Values | -|------|---------|--------| -| `--type` | Improvement focus | `quality`, `performance`, `maintainability`, `style`, `security` | -| `--safe` | Conservative approach | Boolean | -| `--interactive` | User guidance | Boolean | -| `--preview` | Show without executing | Boolean | - -### Task Command Flags (`/sc:task`) -| Flag | Purpose | Values | -|------|---------|--------| -| `--strategy` | Task approach | `systematic`, `agile`, `enterprise` | -| `--parallel` | Parallel execution | Boolean | -| `--delegate` | Sub-agent coordination | Boolean | - -### Workflow Command Flags (`/sc:workflow`) -| Flag | Purpose | Values | -|------|---------|--------| -| `--strategy` | Workflow approach | `systematic`, `agile`, `enterprise` | -| `--depth` | Analysis depth | `shallow`, `normal`, `deep` | -| `--parallel` | Parallel coordination | Boolean | - -### Troubleshoot Command Flags (`/sc:troubleshoot`) -| Flag | Purpose | Values | -|------|---------|--------| -| `--type` | Issue category | `bug`, `build`, `performance`, `deployment` | -| `--trace` | Include trace analysis | Boolean | -| `--fix` | Apply fixes | Boolean | - -### Cleanup Command Flags (`/sc:cleanup`) -| Flag | Purpose | Values | -|------|---------|--------| -| `--type` | Cleanup target | `code`, `imports`, `files`, `all` | -| `--safe` / `--aggressive` | Cleanup intensity | Boolean | -| `--interactive` | User guidance | Boolean | -| `--preview` | Show without executing | Boolean | - -### Estimate Command Flags (`/sc:estimate`) -| Flag | Purpose | Values | -|------|---------|--------| -| `--type` | Estimate focus | `time`, `effort`, `complexity` | -| `--unit` | Time unit | `hours`, `days`, `weeks` | -| `--breakdown` | Detailed breakdown | Boolean | - -### Index Command Flags (`/sc:index`) -| Flag | Purpose | Values | -|------|---------|--------| -| `--type` | Index target | `docs`, `api`, `structure`, `readme` | -| `--format` | Output format | `md`, `json`, `yaml` | - -### Reflect Command Flags (`/sc:reflect`) -| Flag | Purpose | Values | -|------|---------|--------| -| `--type` | Reflection scope | `task`, `session`, `completion` | -| `--analyze` | Include analysis | Boolean | -| `--validate` | Validate completeness | Boolean | - -### Spawn Command Flags (`/sc:spawn`) -| Flag | Purpose | Values | -|------|---------|--------| -| `--strategy` | Coordination approach | `sequential`, `parallel`, `adaptive` | -| `--depth` | Analysis depth | `normal`, `deep` | - -### Git Command Flags (`/sc:git`) -| Flag | Purpose | Values | -|------|---------|--------| -| `--smart-commit` | Generate commit message | Boolean | -| `--interactive` | Guided operations | Boolean | - -### Select-Tool Command Flags (`/sc:select-tool`) -| Flag | Purpose | Values | -|------|---------|--------| -| `--analyze` | Tool analysis | Boolean | -| `--explain` | Explain selection | Boolean | - -### Test Command Flags (`/sc:test`) -| Flag | Purpose | Values | -|------|---------|--------| -| `--coverage` | Include coverage | Boolean | -| `--type` | Test type | `unit`, `integration`, `e2e` | -| `--watch` | Watch mode | Boolean | - -## Advanced Control Flags - -### Scope and Focus -| Flag | Purpose | Values | -|------|---------|--------| -| `--scope` | Analysis boundary | `file`, `module`, `project`, `system` | -| `--focus` | Domain targeting | `performance`, `security`, `quality`, `architecture`, `accessibility`, `testing` | - -### Execution Control -| Flag | Purpose | Values | -|------|---------|--------| -| `--concurrency [n]` | Control parallel ops | 1-15 | -| `--iterations [n]` | Improvement cycles | 1-10 | -| `--all-mcp` | Enable all MCP servers | Boolean | -| `--no-mcp` | Native tools only | Boolean | -| `--frontend-verify` | UI testing, frontend debugging, layout validation | Enable Playwright + Chrome DevTools + Serena | - -### System Flags (SuperClaude Installation) -| Flag | Purpose | Values | -|------|---------|--------| -| `--verbose` / `-v` | Verbose logging | Boolean | -| `--quiet` / `-q` | Suppress output | Boolean | -| `--dry-run` | Simulate operation | Boolean | -| `--force` | Skip checks | Boolean | -| `--yes` / `-y` | Auto-confirm | Boolean | -| `--install-dir` | Target directory | Path | -| `--legacy` | Use legacy script | Boolean | -| `--version` | Show version | Boolean | -| `--help` | Show help | Boolean | - -## Common Usage Patterns - -### Frontend Development -```bash -/sc:implement "responsive dashboard" --magic --c7 -/sc:design component-library --type component --format code -/sc:test ui-components/ --magic --play -/sc:improve legacy-ui/ --magic --morph --validate -``` - -### Backend Development -```bash -/sc:analyze api/ --focus performance --seq --think -/sc:design payment-api --type api --format spec -/sc:troubleshoot "API timeout" --type performance --trace -/sc:improve auth-service --type security --validate -``` - -### Large Projects -```bash -/sc:analyze . --ultrathink --all-mcp --safe-mode -/sc:workflow enterprise-system --strategy enterprise --depth deep -/sc:cleanup . --type all --safe --interactive -/sc:estimate "migrate to microservices" --type complexity --breakdown -``` - -### Quality & Maintenance -```bash -/sc:improve src/ --type quality --safe --interactive -/sc:cleanup imports --type imports --preview -/sc:reflect --type completion --validate -/sc:git commit --smart-commit -``` - -## Flag Interactions - -### Compatible Combinations -- `--think` + `--c7`: Analysis with documentation -- `--magic` + `--play`: UI generation with testing -- `--serena` + `--morph`: Project memory with transformations -- `--safe-mode` + `--validate`: Maximum safety -- `--loop` + `--validate`: Iterative improvement with validation - -### Conflicting Flags -- `--all-mcp` vs individual MCP flags (use one or the other) -- `--no-mcp` vs any MCP flags (--no-mcp wins) -- `--safe` vs `--aggressive` (cleanup intensity) -- `--quiet` vs `--verbose` (output level) - -### Auto-Enabling Relationships -- `--safe-mode` auto-enables `--uc` and `--validate` -- `--ultrathink` auto-enables all MCP servers -- `--think-hard` auto-enables `--seq` + `--c7` -- `--magic` triggers UI-focused agents - -## Troubleshooting Flags - -### Common Issues -- **Too many tools**: Use `--no-mcp` to test with native tools only -- **Operation too slow**: Add `--uc` to compress output -- **Validation blocking**: Use `--validate` instead of `--safe-mode` in development -- **Context pressure**: Auto-activates `--token-efficient` at >75% usage - -### Debug Flags -```bash -/sc:analyze . --verbose # Shows decision logic and flag activation -/sc:select-tool "operation" --explain # Explains tool selection process -/sc:reflect --type session --analyze # Reviews current session decisions -``` - -### Quick Fixes -```bash -/sc:analyze . --help # Shows available flags for command -/sc:analyze . --no-mcp # Native execution only -/sc:cleanup . --preview # Shows what would be cleaned -``` - -## Flag Priority Rules - -1. **Safety First**: `--safe-mode` > `--validate` > optimization flags -2. **Explicit Override**: User flags > auto-detection -3. **Depth Hierarchy**: `--ultrathink` > `--think-hard` > `--think` -4. **MCP Control**: `--no-mcp` overrides all individual MCP flags -5. **Scope Precedence**: system > project > module > file - -## Related Resources -- [Commands Guide](commands.md) - Commands that use these flags -- [MCP Servers Guide](mcp-servers.md) - Understanding MCP flag activation -- [Session Management](session-management.md) - Using flags with persistent sessions \ No newline at end of file diff --git a/docs/User-Guide/mcp-servers.md b/docs/User-Guide/mcp-servers.md deleted file mode 100644 index 256295e..0000000 --- a/docs/User-Guide/mcp-servers.md +++ /dev/null @@ -1,339 +0,0 @@ -# SuperClaude MCP Servers Guide ๐Ÿ”Œ - -## Overview - -MCP (Model Context Protocol) servers extend Claude Code's capabilities through specialized tools. SuperClaude integrates 8 MCP servers and provides Claude with instructions on when to activate them based on your tasks. - -### ๐Ÿ” Reality Check -- **What MCP servers are**: External Node.js processes that provide additional tools -- **What they aren't**: Built-in SuperClaude functionality -- **How activation works**: Claude reads instructions to use appropriate servers based on context -- **What they provide**: Real tools that extend Claude Code's native capabilities - -**Core Servers:** -- **context7**: Official library documentation and patterns -- **sequential-thinking**: Multi-step reasoning and analysis -- **magic**: Modern UI component generation -- **playwright**: Browser automation and E2E testing -- **morphllm-fast-apply**: Pattern-based code transformations -- **serena**: Semantic code understanding and project memory -- **tavily**: Web search and real-time information retrieval -- **chrome-devtools**: Performance analysis and debugging - -## Quick Start - -**Setup Verification**: MCP servers activate automatically. For installation and troubleshooting, see [Installation Guide](../Getting-Started/installation.md) and [Troubleshooting](../Reference/troubleshooting.md). - -**Auto-Activation Logic:** - -| Request Contains | Servers Activated | -|-----------------|------------------| -| Library imports, API names | **context7** | -| `--think`, debugging | **sequential-thinking** | -| `component`, `UI`, frontend | **magic** | -| `test`, `e2e`, `browser` | **playwright** | -| Multi-file edits, refactoring | **morphllm-fast-apply** | -| Large projects, sessions | **serena** | -| `/sc:research`, `latest`, `current` | **tavily** | -| `performance`, `debug`, `LCP` | **chrome-devtools** | - -## Server Details - -### context7 ๐Ÿ“š -**Purpose**: Official library documentation access -**Triggers**: Import statements, framework keywords, documentation requests -**Requirements**: Node.js 16+, no API key - -```bash -# Automatic activation -/sc:implement "React authentication system" -# โ†’ Provides official React patterns - -# Manual activation -/sc:analyze auth-system/ --c7 -``` - -### sequential-thinking ๐Ÿง  -**Purpose**: Structured multi-step reasoning and systematic analysis -**Triggers**: Complex debugging, `--think` flags, architectural analysis -**Requirements**: Node.js 16+, no API key - -```bash -# Automatic activation -/sc:troubleshoot "API performance issues" -# โ†’ Enables systematic root cause analysis - -# Manual activation -/sc:analyze --think-hard architecture/ -``` - -### magic โœจ -**Purpose**: Modern UI component generation from 21st.dev patterns -**Triggers**: UI requests, `/ui` commands, component development -**Requirements**: Node.js 16+, TWENTYFIRST_API_KEY () - -```bash -# Automatic activation -/sc:implement "responsive dashboard component" -# โ†’ Generates accessible UI with modern patterns - -# API key setup -export TWENTYFIRST_API_KEY="your_key_here" -``` - -### playwright ๐ŸŽญ -**Purpose**: Real browser automation and E2E testing -**Triggers**: Browser testing, E2E scenarios, visual validation -**Requirements**: Node.js 16+, no API key - -```bash -# Automatic activation -/sc:test --type e2e "user login flow" -# โ†’ Enables browser automation testing - -# Manual activation -/sc:validate "accessibility compliance" --play -``` - -### morphllm-fast-apply ๐Ÿ”„ -**Purpose**: Efficient pattern-based code transformations -**Triggers**: Multi-file edits, refactoring, framework migrations -**Requirements**: Node.js 16+, MORPH_API_KEY - -```bash -# Automatic activation -/sc:improve legacy-codebase/ --focus maintainability -# โ†’ Applies consistent patterns across files - -# API key setup -export MORPH_API_KEY="your_key_here" -``` - -### serena ๐Ÿงญ -**Purpose**: Semantic code understanding with project memory -**Triggers**: Symbol operations, large codebases, session management -**Requirements**: Python 3.9+, uv package manager, no API key - -```bash -# Automatic activation -/sc:load existing-project/ -# โ†’ Builds project understanding and memory - -# Manual activation -/sc:refactor "extract UserService" --serena -``` - -### tavily ๐Ÿ” -**Purpose**: Web search and real-time information retrieval for research -**Triggers**: `/sc:research` commands, "latest" information requests, current events, fact-checking -**Requirements**: Node.js 16+, TAVILY_API_KEY (free tier available at https://app.tavily.com) - -```bash -# Automatic activation -/sc:research "latest AI developments 2024" -# โ†’ Performs intelligent web research - -# Manual activation -/sc:analyze "market trends" --tavily - -# API key setup (get free key at https://app.tavily.com) -export TAVILY_API_KEY="tvly-your_api_key_here" -``` - -### chrome-devtools ๐Ÿ“Š -**Purpose**: Performance analysis, debugging, and real-time browser inspection -**Triggers**: Performance auditing, debugging layout issues (e.g., CLS), slow loading times (LCP), console errors, network requests -**Requirements**: Node.js 16+, no API key - -```bash -# Automatic activation -/sc:debug "page is loading slowly" -# โ†’ Enables performance analysis with Chrome DevTools - -# Manual activation -/sc:analyze --performance "homepage" -``` - -**Capabilities:** -- **Web Search**: Comprehensive searches with ranking and filtering -- **News Search**: Time-filtered current events and updates -- **Content Extraction**: Full-text extraction from search results -- **Domain Filtering**: Include/exclude specific domains -- **Multi-Hop Research**: Iterative searches based on findings (up to 5 hops) - -**Research Depth Control:** -- `--depth quick`: 5-10 sources, basic synthesis -- `--depth standard`: 10-20 sources, structured report (default) -- `--depth deep`: 20-40 sources, comprehensive analysis -- `--depth exhaustive`: 40+ sources, academic-level research - -## Configuration - -**MCP Configuration File (`~/.claude.json`):** -```json -{ - "mcpServers": { - "context7": { - "command": "npx", - "args": ["-y", "@upstash/context7-mcp@latest"] - }, - "sequential-thinking": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"] - }, - "magic": { - "command": "npx", - "args": ["@21st-dev/magic"], - "env": {"TWENTYFIRST_API_KEY": "${TWENTYFIRST_API_KEY}"} - }, - "playwright": { - "command": "npx", - "args": ["@playwright/mcp@latest"] - }, - "morphllm-fast-apply": { - "command": "npx", - "args": ["@morph-llm/morph-fast-apply"], - "env": {"MORPH_API_KEY": "${MORPH_API_KEY}"} - }, - "serena": { - "command": "uvx", - "args": ["--from", "git+https://github.com/oraios/serena", "serena", "start-mcp-server", "--context", "ide-assistant"] - }, - "tavily": { - "command": "npx", - "args": ["-y", "tavily-mcp@latest"], - "env": {"TAVILY_API_KEY": "${TAVILY_API_KEY}"} - }, - "chrome-devtools": { - "command": "npx", - "args": ["-y", "chrome-devtools-mcp@latest"] - } - } -} -``` - -## Usage Patterns - -**Server Control:** -```bash -# Enable specific servers -/sc:analyze codebase/ --c7 --seq - -# Disable all MCP servers -/sc:implement "simple function" --no-mcp - -# Enable all servers -/sc:design "complex architecture" --all-mcp -``` - -**Multi-Server Coordination:** -```bash -# Full-stack development -/sc:implement "e-commerce checkout" -# โ†’ Sequential: workflow analysis -# โ†’ Context7: payment patterns -# โ†’ Magic: UI components -# โ†’ Serena: code organization -# โ†’ Playwright: E2E testing -``` - -## Troubleshooting - -**Common Issues:** -- **No servers connected**: Check Node.js: `node --version` (need v16+) -- **Context7 fails**: Clear cache: `npm cache clean --force` -- **Magic/Morphllm errors**: Expected without API keys (paid services) -- **Server timeouts**: Restart Claude Code session - -**Quick Fixes:** -```bash -# Reset connections -# Restart Claude Code session - -# Check dependencies -node --version # Should show v16+ - -# Test without MCP -/sc:command --no-mcp - -# Check configuration -ls ~/.claude.json -``` - -**API Key Configuration:** -```bash -# For Magic server (required for UI generation) -export TWENTYFIRST_API_KEY="your_key_here" - -# For Morphllm server (required for bulk transformations) -export MORPH_API_KEY="your_key_here" - -# For Tavily server (required for web search - free tier available) -export TAVILY_API_KEY="tvly-your_key_here" - -# Add to shell profile for persistence -echo 'export TWENTYFIRST_API_KEY="your_key"' >> ~/.bashrc -echo 'export MORPH_API_KEY="your_key"' >> ~/.bashrc -echo 'export TAVILY_API_KEY="your_key"' >> ~/.bashrc -``` - -**Environment Variable Usage:** -- โœ… `TWENTYFIRST_API_KEY` - Required for Magic MCP server functionality -- โœ… `MORPH_API_KEY` - Required for Morphllm MCP server functionality -- โœ… `TAVILY_API_KEY` - Required for Tavily MCP server functionality (free tier available) -- โŒ Other env vars in docs - Examples only, not used by framework -- ๐Ÿ“ Magic and Morphllm are paid services, Tavily has free tier, framework works without them - -## Server Combinations - -**No API Keys (Free)**: -- context7 + sequential-thinking + playwright + serena - -**1 API Key**: -- Add magic for professional UI development - -**2 API Keys**: -- Add morphllm-fast-apply for large-scale refactoring - -**Common Workflows:** -- **Learning**: context7 + sequential-thinking -- **Web Development**: magic + context7 + playwright -- **Enterprise Refactoring**: serena + morphllm + sequential-thinking -- **Complex Analysis**: sequential-thinking + context7 + serena -- **Deep Research**: tavily + sequential-thinking + serena + playwright -- **Current Events**: tavily + context7 + sequential-thinking -- **Performance Tuning**: chrome-devtools + sequential-thinking + playwright - -## Integration - -**With SuperClaude Commands:** -- Analysis commands automatically use Sequential + Serena -- Implementation commands use Magic + Context7 -- Testing commands use Playwright + Sequential -- Research commands use Tavily + Sequential + Playwright - -**With Behavioral Modes:** -- Brainstorming Mode: Sequential for discovery -- Task Management: Serena for persistence -- Orchestration Mode: Optimal server selection -- Deep Research Mode: Tavily + Sequential + Playwright coordination - -**Performance Control:** -- Automatic resource management based on system load -- Concurrency control: `--concurrency N` (1-15) -- Priority-based server selection under constraints - -## Related Resources - -**Essential Reading:** -- [Commands Guide](commands.md) - Commands that activate MCP servers -- [Quick Start Guide](../Getting-Started/quick-start.md) - MCP setup guide - -**Advanced Usage:** -- [Behavioral Modes](modes.md) - Mode-MCP coordination -- [Agents Guide](agents.md) - Agent-MCP integration -- [Session Management](session-management.md) - Serena workflows - -**Technical References:** -- [Examples Cookbook](../Reference/examples-cookbook.md) - MCP workflow patterns -- [Technical Architecture](../Developer-Guide/technical-architecture.md) - Integration details \ No newline at end of file diff --git a/docs/User-Guide/modes.md b/docs/User-Guide/modes.md deleted file mode 100644 index b1ef9db..0000000 --- a/docs/User-Guide/modes.md +++ /dev/null @@ -1,659 +0,0 @@ -# SuperClaude Behavioral Modes Guide ๐Ÿง  - -## โœ… Quick Verification -Test modes by using `/sc:` commands - they activate automatically based on task complexity. For full command reference, see [Commands Guide](commands.md). - -## Quick Reference Table - -| Mode | Purpose | Auto-Triggers | Key Behaviors | Best Used For | -|------|---------|---------------|---------------|---------------| -| **๐Ÿง  Brainstorming** | Interactive discovery | "brainstorm", "maybe", vague requests | Socratic questions, requirement elicitation | New project planning, unclear requirements | -| **๐Ÿ” Introspection** | Meta-cognitive analysis | Error recovery, "analyze reasoning" | Transparent thinking markers (๐Ÿค”, ๐ŸŽฏ, ๐Ÿ’ก) | Debugging, learning, optimization | -| **๐Ÿ”ฌ Deep Research** | Systematic investigation mindset | `/sc:research`, investigation keywords | 6-phase workflow, evidence-based reasoning | Technical research, current events, market analysis | -| **๐Ÿ“‹ Task Management** | Complex coordination | >3 steps, >2 directories | Phase breakdown, memory persistence | Multi-step operations, project management | -| **๐ŸŽฏ Orchestration** | Intelligent tool selection | Multi-tool ops, high resource usage | Optimal tool routing, parallel execution | Complex analysis, performance optimization | -| **โšก Token Efficiency** | Compressed communication | High context usage, `--uc` flag | Symbol systems, estimated 30-50% token reduction | Resource constraints, large operations | - - ---- - -## Getting Started (2-Minute Overview) - -**Modes activate through behavioral instructions** - Claude Code reads context files to determine which mode behaviors to adopt based on your task patterns and complexity. - -**Quick Examples:** -```bash -# Automatic activation examples -/sc:brainstorm "mobile app" # โ†’ Socratic discovery questions -/sc:implement "auth system" # โ†’ Multi-phase coordination -"--uc analyze large-codebase/" # โ†’ Compressed symbol output -``` - -**When to use manual flags:** -- Need specific behavior: `--brainstorm`, `--introspect`, `--uc` -- Override automatic detection for learning/debugging -- Optimize for specific constraints (memory, time, clarity) - ---- - -## Mode Details - -### ๐Ÿง  Brainstorming Mode - Interactive Discovery - -**Purpose**: Transform vague ideas into structured requirements through collaborative discovery. - -**Auto-Activation Triggers:** -- Vague project requests: "I want to build...", "Thinking about creating..." -- Exploration keywords: brainstorm, explore, discuss, figure out, not sure -- Uncertainty indicators: "maybe", "possibly", "could we" -- Manual flags: `--brainstorm`, `--bs` - -**Behavioral Changes:** -- **Socratic Questioning**: Asks probing questions to uncover hidden requirements -- **Non-Presumptive Approach**: Avoids assumptions, lets you guide discovery direction -- **Collaborative Partnership**: Works with you in exploration rather than directive consultation -- **Requirement Synthesis**: Converts insights into structured technical briefs -- **Cross-Session Memory**: Maintains discovery context for follow-up discussions - -**Example Experience:** -``` -Standard Approach: "I'll build a user authentication system with JWT tokens..." -Brainstorming Approach: -"๐Ÿค” Let's explore this together: - - What specific user problems does auth solve for your app? - - Who are your users and what's their technical comfort level? - - Any existing systems or social logins to integrate with? - - What security/compliance requirements do you have? - ๐Ÿ“ Outcome: Detailed auth requirements brief ready for implementation" -``` - -#### Success Criteria -- [ ] Responds with questions instead of immediate solutions -- [ ] Questions explore user needs, technical constraints, and business goals -- [ ] Maintains collaborative tone throughout discovery process -- [ ] Produces structured requirements or technical brief as outcome - -**Verify:** `/sc:brainstorm "web app"` should ask about users, features, technology -**Test:** Vague requests should trigger discovery questions, not assumptions -**Check:** Mode should persist across follow-up questions in same conversation - -**Works Best With:** -- **โ†’ Task Management**: Requirements discovery โ†’ systematic implementation planning -- **โ†’ Orchestration**: Requirements clarity โ†’ optimal tool selection for implementation -- **Manual Override**: Use `--brainstorm` to force discovery even for "clear" requirements - ---- - -### ๐Ÿ” Introspection Mode - Meta-Cognitive Analysis - -**Purpose**: Expose reasoning process for learning optimization and transparent decision-making. - -**Auto-Activation Triggers:** -- Self-analysis requests: "analyze my reasoning", "reflect on decision" -- Error recovery scenarios and unexpected results requiring investigation -- Complex problem solving with multiple viable approaches -- Pattern recognition needs for optimization opportunities -- Manual flag: `--introspect` - -**Behavioral Changes:** -- **Reasoning Transparency**: Exposes thinking process with clear markers (๐Ÿค”, ๐ŸŽฏ, โšก, ๐Ÿ“Š, ๐Ÿ’ก) -- **Decision Analysis**: Evaluates choice logic and considers alternative approaches -- **Pattern Recognition**: Identifies recurring behaviors and improvement opportunities -- **Meta-Learning**: Extracts insights for continuous framework improvement -- **Framework Compliance**: Validates actions against SuperClaude principles and quality gates - -**Example Experience:** -``` -Standard Approach: "I'll analyze this code structure and suggest improvements..." -Introspective Approach: -"๐Ÿง  Meta-Analysis: Why did I choose structural analysis over functional flow? - ๐ŸŽฏ Decision Logic: Saw class hierarchy โ†’ assumed OOP pattern dominance - ๐Ÿ”„ Alternative Considered: Data flow analysis might reveal hidden dependencies - ๐Ÿ“Š Evidence Check: File imports suggest functional composition, not OOP - ๐Ÿ’ก Learning: Need to analyze imports before choosing analysis strategy - โšก Correction: Switching to functional flow analysis approach" -``` - -**Works Best With:** -- **โ†’ Task Management**: Provides transparent reasoning for complex phase decisions -- **Any Mode**: Adds reasoning transparency layer to any other mode's operation -- **Manual Override**: Use `--introspect` for learning sessions and debugging workflows - ---- - -### ๐Ÿ”ฌ Deep Research Mode - Systematic Investigation Mindset - -**Purpose**: Research mindset for systematic investigation and evidence-based reasoning. - -**Auto-Activation Triggers:** -- `/sc:research` command invocation -- Research-related keywords: investigate, explore, discover, analyze -- Questions requiring current information beyond knowledge cutoff -- Complex research requirements -- Manual flag: `--research` - -**Behavioral Modifications:** -- **Thinking Style**: Systematic over casual, evidence over assumption, progressive depth exploration -- **Communication**: Lead with confidence levels, provide inline citations, acknowledge uncertainties -- **Priority Shifts**: Completeness over speed, accuracy over speculation, verification over assumption -- **Process Adaptations**: Always create investigation plans, default to parallel operations, maintain evidence chains - -**6-Phase Research Workflow:** -- ๐Ÿ“‹ **Understand** (5-10%): Assess query complexity and requirements -- ๐Ÿ“ **Plan** (10-15%): Select strategy (planning/intent/unified) and identify parallelization -- โœ… **TodoWrite** (5%): Create adaptive task hierarchy (3-15 tasks based on complexity) -- ๐Ÿ”„ **Execute** (50-60%): Parallel-first searches and smart extraction routing -- ๐Ÿ“Š **Track** (Continuous): Monitor progress and update confidence scores -- โœ“ **Validate** (10-15%): Verify evidence chains and ensure completeness - -**Example Experience:** -``` -Standard Mode: "Here are some search results about quantum computing..." -Deep Research Mode: -"๐Ÿ“Š Research Plan: Quantum computing breakthroughs - โœ“ TodoWrite: Created 8 research tasks - ๐Ÿ”„ Executing parallel searches across domains - ๐Ÿ“ˆ Confidence: 0.82 across 15 verified sources - ๐Ÿ“ Report saved: claudedocs/research_quantum_[timestamp].md" -``` - -#### Quality Standards -- [ ] Minimum 2 sources per claim with inline citations -- [ ] Confidence scoring (0.0-1.0) for all findings -- [ ] Parallel execution by default for independent operations -- [ ] Reports saved to claudedocs/ with proper structure -- [ ] Clear methodology and evidence presentation - -**Verify:** `/sc:research "test topic"` should create TodoWrite and execute systematically -**Test:** All research should include confidence scores and citations -**Check:** Reports should be saved to claudedocs/ automatically - -**Works Best With:** -- **โ†’ Task Management**: Research planning with TodoWrite integration -- **โ†’ Orchestration**: Parallel Tavily/Playwright coordination -- **Manual Override**: Use `--depth` and `--strategy` for fine control - ---- - -### ๐Ÿ“‹ Task Management Mode - Complex Coordination - -**Purpose**: Hierarchical task organization with session persistence for multi-step operations. - -**Auto-Activation Triggers:** -- Operations requiring >3 coordinated steps -- Multiple file/directory scope (>2 directories OR >3 files) -- Complex dependencies requiring phases and checkpoints -- Quality improvement requests: polish, refine, enhance -- Manual flags: `--task-manage`, `--delegate` - -**Behavioral Changes:** -- **Hierarchical Planning**: Breaks complex work into Plan โ†’ Phase โ†’ Task โ†’ Todo structure -- **Session Persistence**: Maintains project context and progress across interruptions -- **Memory Integration**: Uses write_memory/read_memory for state preservation -- **Progress Orchestration**: Coordinates TodoWrite with memory updates for tracking -- **Quality Gates**: Implements systematic validation checkpoints between phases - -**Example Experience:** -``` -Standard Approach: "I'll implement user authentication..." โ†’ Direct implementation -Task Management Approach: -"๐Ÿ“‹ Multi-Phase Implementation Plan: - ๐ŸŽฏ Phase 1: Security Requirements Analysis (Session 1) - ๐ŸŽฏ Phase 2: API Design & Documentation (Session 2) - ๐ŸŽฏ Phase 3: Implementation & Testing (Session 3-4) - ๐ŸŽฏ Phase 4: Integration & Validation (Session 5) - ๐Ÿ’พ Session persistence: Resume context automatically - โœ“ Quality gates: Validation before each phase transition" -``` - -**Works Best With:** -- **Brainstorming โ†’**: Requirements discovery then systematic implementation -- **+ Orchestration**: Task coordination with optimal tool selection -- **+ Introspection**: Transparent reasoning for complex phase decisions - ---- - -### ๐ŸŽฏ Orchestration Mode - Intelligent Tool Selection - -**Purpose**: Optimize task execution through intelligent tool routing and parallel coordination. - -**Auto-Activation Triggers:** -- Multi-tool operations requiring sophisticated coordination -- Performance constraints (high resource usage) -- Parallel execution opportunities (>3 independent files/operations) -- Complex routing decisions with multiple valid tool approaches - -**Behavioral Changes:** -- **Intelligent Tool Routing**: Selects optimal MCP servers and native tools for each task type -- **Resource Awareness**: Adapts approach based on system constraints and availability -- **Parallel Optimization**: Identifies independent operations for concurrent execution -- **Coordination Focus**: Optimizes tool selection and usage through coordinated execution -- **Adaptive Fallback**: Switches tools gracefully when preferred options are unavailable - -**Example Experience:** -``` -Standard Approach: Sequential file-by-file analysis and editing -Orchestration Approach: -"๐ŸŽฏ Multi-Tool Coordination Strategy: - ๐Ÿ” Phase 1: Serena (semantic analysis) + Sequential (architecture review) - โšก Phase 2: Morphllm (pattern edits) + Magic (UI components) - ๐Ÿงช Phase 3: Playwright (testing) + Context7 (documentation patterns) - ๐Ÿ”„ Parallel execution: 3 tools working simultaneously -\" -``` - -**Works Best With:** -- **Task Management โ†’**: Provides tool coordination for complex multi-phase plans -- **+ Token Efficiency**: Optimal tool selection with compressed communication -- **Any Complex Task**: Adds intelligent tool routing to enhance execution - ---- - -### โšก Token Efficiency Mode - Compressed Communication - -**Purpose**: Achieve estimated 30-50% token reduction through symbol systems while preserving information quality. - -**Auto-Activation Triggers:** -- High context usage approaching limits -- Large-scale operations requiring resource efficiency -- User explicit flags: `--uc`, `--ultracompressed` -- Complex analysis workflows with multiple outputs - -**Behavioral Changes:** -- **Symbol Communication**: Uses visual symbols for logic flows, status, and technical domains -- **Technical Abbreviation**: Context-aware compression for repeated technical terms -- **Structured Density**: Bullet points, tables, and concise formatting over verbose paragraphs -- **Information Preservation**: Maintains โ‰ฅ95% information quality despite compression -- **Structured Format**: Organized for clarity and task completion - -**Example Experience:** -``` -Standard Approach: "The authentication system implementation shows a security vulnerability in the user validation function that needs immediate attention..." -Token Efficient Approach: -"๐Ÿ›ก๏ธ Security Alert: - auth.js:45 โ†’ user val() โ†’ critical vuln - ๐Ÿ“Š Impact: โŒ token bypass possible - โšก Action: fix validation + audit โˆต high sev - ๐Ÿ”ง Est: 2h impl + 1h test" -``` - -**Works Best With:** -- **Any Mode**: Adds compression layer while preserving mode-specific behaviors -- **Orchestration โ†’**: Compressed tool coordination and status updates -- **Manual Override**: Use `--uc` when context pressure or efficiency is priority - ---- - -### ๐ŸŽจ Standard Mode - Balanced Default - -**Purpose**: Provide clear, professional communication for straightforward development tasks. - -**Auto-Activation Triggers:** -- Simple, well-defined tasks without complexity indicators -- Single-file operations with clear requirements -- Basic explanations and standard development workflows -- No other mode triggers detected (default fallback) - -**Behavioral Changes:** -- **Professional Communication**: Clear, concise technical language without compression -- **Moderate Detail**: Balanced information depth suitable for most development tasks -- **Standard Tool Selection**: Uses native Claude capabilities and basic tools -- **Quality Focus**: Maintains code quality without complex orchestration overhead -- **Responsive Adaptation**: Ready to switch to specialized modes when complexity increases - -**Example Experience:** -``` -Standard Approach: Consistent, professional baseline for all tasks -"I'll implement the login function with proper error handling: - - 1. Validate user input (email format, password requirements) - 2. Authenticate against database with secure hashing - 3. Generate JWT token with appropriate expiration - 4. Return success response with user data - - The implementation will follow security best practices and include comprehensive error handling." -``` - -**Works Best With:** -- **โ†’ Any Mode**: Serves as baseline that other modes enhance -- **Mode Switching**: Automatically escalates to specialized modes when needed -- **Clarity Priority**: When straightforward communication is more important than optimization - ---- - -## Advanced Usage - -### Mode Combinations - -**Multi-Mode Workflows:** -```bash -# Discovery โ†’ Planning โ†’ Implementation -/sc:brainstorm "microservices architecture" --task-manage -# โ†’ Brainstorming: requirement discovery -# โ†’ Task Management: multi-phase coordination - -# Analysis with transparency and efficiency -/sc:analyze legacy-system/ --introspect --uc -# โ†’ Introspection: transparent reasoning -# โ†’ Token Efficiency: compressed output -``` - -### Manual Mode Control - -**Force Specific Behaviors:** -- `--brainstorm`: Force collaborative discovery for any task -- `--introspect`: Add reasoning transparency to any mode -- `--task-manage`: Enable hierarchical coordination -- `--orchestrate`: Optimize tool selection and parallel execution -- `--uc`: Compress communication for efficiency - -**Override Examples:** -```bash -# Force brainstorming on "clear" requirements -/sc:implement "user login" --brainstorm - -# Add reasoning transparency to debugging -# Debug authentication issue with transparent reasoning - -# Enable task management for simple operations -# Update styles.css with systematic task management -``` - -### Mode Boundaries and Priority - -**When Modes Activate:** -1. **Complexity Threshold**: >3 files โ†’ Task Management -2. **Resource Pressure**: High context usage โ†’ Token Efficiency -3. **Multi-Tool Need**: Complex analysis โ†’ Orchestration -4. **Uncertainty**: Vague requirements โ†’ Brainstorming -5. **Error Recovery**: Problems โ†’ Introspection - -**Priority Rules:** -- **Safety First**: Quality and validation always override efficiency -- **User Intent**: Manual flags override automatic detection -- **Context Adaptation**: Modes stack based on complexity -- **Resource Management**: Efficiency modes activate under pressure - ---- - -## Real-World Examples - -### Complete Workflow Examples - -**New Project Development:** -```bash -# Phase 1: Discovery (Brainstorming Mode auto-activates) -"I want to build a productivity app" -โ†’ ๐Ÿค” Socratic questions about users, features, platform choice -โ†’ ๐Ÿ“ Structured requirements brief - -# Phase 2: Planning (Task Management Mode auto-activates) -/sc:implement "core productivity features" -โ†’ ๐Ÿ“‹ Multi-phase breakdown with dependencies -โ†’ ๐ŸŽฏ Phase coordination with quality gates - -# Phase 3: Implementation (Orchestration Mode coordinates tools) -/sc:implement "frontend and backend systems" -โ†’ ๐ŸŽฏ Magic (UI) + Context7 (patterns) + Sequential (architecture) -โ†’ โšก Parallel execution optimization -``` - -**Debugging Complex Issues:** -```bash -# Problem analysis (Introspection Mode auto-activates) -"Users getting intermittent auth failures" -โ†’ ๐Ÿค” Transparent reasoning about potential causes -โ†’ ๐ŸŽฏ Hypothesis formation and evidence gathering -โ†’ ๐Ÿ’ก Pattern recognition across similar issues - -# Systematic resolution (Task Management coordinates) -# Fix authentication system comprehensively -โ†’ ๐Ÿ“‹ Phase 1: Root cause analysis -โ†’ ๐Ÿ“‹ Phase 2: Solution implementation -โ†’ ๐Ÿ“‹ Phase 3: Testing and validation -``` - -### Mode Combination Patterns - -**High-Complexity Scenarios:** -```bash -# Large refactoring with multiple constraints -/sc:improve legacy-system/ --introspect --uc --orchestrate -โ†’ ๐Ÿ” Transparent reasoning (Introspection) -โ†’ โšก Compressed communication (Token Efficiency) -โ†’ ๐ŸŽฏ Optimal tool coordination (Orchestration) -โ†’ ๐Ÿ“‹ Systematic phases (Task Management auto-activates) -``` - ---- - -## Quick Reference - -### Mode Activation Patterns - -| Trigger Type | Example Input | Mode Activated | Key Behavior | -|--------------|---------------|----------------|--------------| -| **Vague Request** | "I want to build an app" | ๐Ÿง  Brainstorming | Socratic discovery questions | -| **Complex Scope** | >3 files or >2 directories | ๐Ÿ“‹ Task Management | Phase coordination | -| **Multi-Tool Need** | Analysis + Implementation | ๐ŸŽฏ Orchestration | Tool optimization | -| **Error Recovery** | "This isn't working as expected" | ๐Ÿ” Introspection | Transparent reasoning | -| **Resource Pressure** | High context usage | โšก Token Efficiency | Symbol compression | -| **Simple Task** | "Fix this function" | ๐ŸŽจ Standard | Clear, direct approach | - -### Manual Override Commands - -```bash -# Force specific mode behaviors -/sc:command --brainstorm # Collaborative discovery -/sc:command --introspect # Reasoning transparency -/sc:command --task-manage # Hierarchical coordination -/sc:command --orchestrate # Tool optimization -/sc:command --uc # Token compression - -# Combine multiple modes -/sc:command --introspect --uc # Transparent + efficient -/sc:command --task-manage --orchestrate # Coordinated + optimized -``` - ---- - -## Troubleshooting - -For troubleshooting help, see: -- [Common Issues](../Reference/common-issues.md) - Quick fixes for frequent problems -- [Troubleshooting Guide](../Reference/troubleshooting.md) - Comprehensive problem resolution - -### Common Issues -- **Mode not activating**: Use manual flags: `--brainstorm`, `--introspect`, `--uc` -- **Wrong mode active**: Check complexity triggers and keywords in request -- **Mode switching unexpectedly**: Normal behavior based on task evolution -- **Execution impact**: Modes optimize tool usage, shouldn't affect execution -- **Mode conflicts**: Check flag priority rules in [Flags Guide](flags.md) - -### Immediate Fixes -- **Force specific mode**: Use explicit flags like `--brainstorm` or `--task-manage` -- **Reset mode behavior**: Restart Claude Code session to reset mode state -- **Check mode indicators**: Look for ๐Ÿค”, ๐ŸŽฏ, ๐Ÿ“‹ symbols in responses -- **Verify complexity**: Simple tasks use Standard mode, complex tasks auto-switch - -### Mode-Specific Troubleshooting - -**Brainstorming Mode Issues:** -```bash -# Problem: Mode gives solutions instead of asking questions -# Quick Fix: Check request clarity and use explicit flag -/sc:brainstorm "web app" --brainstorm # Force discovery mode -"I have a vague idea about..." # Use uncertainty language -"Maybe we could build..." # Trigger exploration -``` - -**Task Management Mode Issues:** -```bash -# Problem: Simple tasks getting complex coordination -# Quick Fix: Reduce scope or use simpler commands -/sc:implement "function" --no-task-manage # Disable coordination -/sc:troubleshoot bug.js # Use basic commands -# Check if task really is complex (>3 files, >2 directories) -``` - -**Token Efficiency Mode Issues:** -```bash -# Problem: Output too compressed or unclear -# Quick Fix: Disable compression for clarity -/sc:command --no-uc # Disable compression -/sc:command --verbose # Force detailed output -# Use when clarity is more important than efficiency -``` - -**Introspection Mode Issues:** -```bash -# Problem: Too much meta-commentary, not enough action -# Quick Fix: Disable introspection for direct work -/sc:command --no-introspect # Direct execution -# Use introspection only for learning and debugging -``` - -**Orchestration Mode Issues:** -```bash -# Problem: Tool coordination causing confusion -# Quick Fix: Simplify tool usage -/sc:command --no-mcp # Native tools only -/sc:command --simple # Basic execution -# Check if task complexity justifies orchestration -``` - -### Error Code Reference - -| Mode Error | Meaning | Quick Fix | -|------------|---------|-----------| -| **B001** | Brainstorming failed to activate | Use explicit `--brainstorm` flag | -| **T001** | Task management overhead | Use `--no-task-manage` for simple tasks | -| **U001** | Token efficiency too aggressive | Use `--verbose` or `--no-uc` | -| **I001** | Introspection mode stuck | Use `--no-introspect` for direct action | -| **O001** | Orchestration coordination failed | Use `--no-mcp` or `--simple` | -| **M001** | Mode conflict detected | Check flag priority rules | -| **M002** | Mode switching loop | Restart session to reset state | -| **M003** | Mode not recognized | Update SuperClaude or check spelling | - -### Progressive Support Levels - -**Level 1: Quick Fix (< 2 min)** -- Use manual flags to override automatic mode selection -- Check if task complexity matches expected mode behavior -- Try restarting Claude Code session - -**Level 2: Detailed Help (5-15 min)** -```bash -# Mode-specific diagnostics -/sc:help modes # List all available modes -/sc:reflect --type mode-status # Check current mode state -# Review request complexity and triggers -``` -- See [Common Issues Guide](../Reference/common-issues.md) for mode installation problems - -**Level 3: Expert Support (30+ min)** -```bash -# Deep mode analysis -SuperClaude install --diagnose -# Check mode activation patterns -# Review behavioral triggers and thresholds -``` -- See [Diagnostic Reference Guide](../Reference/diagnostic-reference.md) for behavioral mode analysis - -**Level 4: Community Support** -- Report mode issues at [GitHub Issues](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues) -- Include examples of unexpected mode behavior -- Describe desired vs actual mode activation - -### Success Validation - -After applying mode fixes, test with: -- [ ] Simple requests use Standard mode (clear, direct responses) -- [ ] Complex requests auto-activate appropriate modes (coordination, reasoning) -- [ ] Manual flags override automatic detection correctly -- [ ] Mode indicators (๐Ÿค”, ๐ŸŽฏ, ๐Ÿ“‹) appear when expected -- [ ] Performance remains good across different modes - -## Quick Troubleshooting (Legacy) -- **Mode not activating** โ†’ Use manual flags: `--brainstorm`, `--introspect`, `--uc` -- **Wrong mode active** โ†’ Check complexity triggers and keywords in request -- **Mode switching unexpectedly** โ†’ Normal behavior based on task evolution -- **Execution impact** โ†’ Modes optimize tool usage, shouldn't affect execution -- **Mode conflicts** โ†’ Check flag priority rules in [Flags Guide](flags.md) - -## Frequently Asked Questions - -**Q: How do I know which mode is active?** -A: Look for these indicators in communication patterns: -- ๐Ÿค” Discovery questions โ†’ Brainstorming -- ๐ŸŽฏ Reasoning transparency โ†’ Introspection -- Phase breakdowns โ†’ Task Management -- Tool coordination โ†’ Orchestration -- Symbol compression โ†’ Token Efficiency - -**Q: Can I force specific modes?** -A: Yes, use manual flags to override automatic detection: -```bash -/sc:command --brainstorm # Force discovery -/sc:command --introspect # Add transparency -/sc:command --task-manage # Enable coordination -/sc:command --uc # Compress output -``` - -**Q: Do modes affect execution?** -A: Modes optimize tool usage through coordination: -- **Token Efficiency**: 30-50% context reduction -- **Orchestration**: Parallel processing -- **Task Management**: Prevents rework through systematic planning - -**Q: Can modes work together?** -A: Yes, modes are designed to complement each other: -- **Task Management** coordinates other modes -- **Token Efficiency** compresses any mode's output -- **Introspection** adds transparency to any workflow - ---- - -## Summary - -SuperClaude's 5 behavioral modes create an **intelligent adaptation system** that matches your needs automatically: - -- **๐Ÿง  Brainstorming**: Transforms vague ideas into clear requirements -- **๐Ÿ” Introspection**: Provides transparent reasoning for learning and debugging -- **๐Ÿ“‹ Task Management**: Coordinates complex multi-step operations -- **๐ŸŽฏ Orchestration**: Optimizes tool selection and parallel execution -- **โšก Token Efficiency**: Compresses communication while preserving clarity -- **๐ŸŽจ Standard**: Maintains professional baseline for straightforward tasks - -**The key insight**: You don't need to think about modes - they work transparently to enhance your development experience. Simply describe what you want to accomplish, and SuperClaude automatically adapts its approach to match your needs. - ---- - -## Related Guides - -**Learning Progression:** - -**๐ŸŒฑ Essential (Week 1)** -- [Quick Start Guide](../Getting-Started/quick-start.md) - Mode activation examples -- [Commands Reference](commands.md) - Commands automatically activate modes -- [Installation Guide](../Getting-Started/installation.md) - Set up behavioral modes - -**๐ŸŒฟ Intermediate (Week 2-3)** -- [Agents Guide](agents.md) - How modes coordinate with specialists -- [Flags Guide](flags.md) - Manual mode control and optimization -- [Examples Cookbook](../Reference/examples-cookbook.md) - Mode patterns in practice - -**๐ŸŒฒ Advanced (Month 2+)** -- [MCP Servers](mcp-servers.md) - Mode integration with enhanced capabilities -- [Session Management](session-management.md) - Task Management mode workflows -- [Getting Started](../Getting-Started/quick-start.md) - Mode usage patterns - -**๐Ÿ”ง Expert** -- [Technical Architecture](../Developer-Guide/technical-architecture.md) - Mode implementation details -- [Contributing Code](../Developer-Guide/contributing-code.md) - Extend mode capabilities - -**Mode-Specific Guides:** -- **Brainstorming**: [Requirements Discovery Patterns](../Reference/examples-cookbook.md#requirements) -- **Task Management**: [Session Management Guide](session-management.md) -- **Orchestration**: [MCP Servers Guide](mcp-servers.md) -- **Token Efficiency**: [Command Fundamentals](commands.md#token-efficiency) \ No newline at end of file diff --git a/docs/User-Guide/session-management.md b/docs/User-Guide/session-management.md deleted file mode 100644 index 2364923..0000000 --- a/docs/User-Guide/session-management.md +++ /dev/null @@ -1,310 +0,0 @@ -# Session Management Guide - -SuperClaude provides persistent session management through the Serena MCP server, enabling true context preservation across Claude Code conversations and long-term project continuity. - -## Core Session Commands with Persistent Memory - -### `/sc:load` - Context Loading with Persistent Memory -**Purpose**: Initialize session with project context and persistent memory from previous sessions -**MCP Integration**: Triggers Serena MCP to read stored project memories -**Syntax**: `/sc:load [project_path]` - -**What Happens**: -- Serena MCP reads persistent memory files from previous sessions -- Project context is restored from stored memories -- Previous decisions, patterns, and progress are loaded -- Session state is initialized with historical context - -**Use Cases**: -```bash -# Load existing project context from persistent memory -/sc:load src/ - -# Resume specific project work with full history -/sc:load "authentication-system" - -# Initialize with codebase analysis and previous insights -/sc:load . --analyze -``` - -### `/sc:save` - Session Persistence to Memory -**Purpose**: Save current session state and decisions to persistent memory -**MCP Integration**: Triggers Serena MCP to write memory files -**Syntax**: `/sc:save "session_description"` - -**What Happens**: -- Current context and decisions are written to Serena memory -- Project state and progress are persisted across conversations -- Key insights and patterns are stored for future sessions -- Session summary is created with timestamp for retrieval - -**Use Cases**: -```bash -# Save completed feature work for future reference -/sc:save "user authentication implemented with JWT" - -# Checkpoint during complex work -/sc:save "API design phase complete, ready for implementation" - -# Store architectural decisions permanently -/sc:save "microservices architecture decided, service boundaries defined" -``` - -### `/sc:reflect` - Progress Assessment with Memory Context -**Purpose**: Analyze current progress against stored memories and validate session completeness -**MCP Integration**: Uses Serena MCP to compare current state against stored memories -**Syntax**: `/sc:reflect [--scope project|session]` - -**What Happens**: -- Serena MCP reads previous memories and current context -- Progress is assessed against stored goals and milestones -- Gaps and next steps are identified using historical context -- Session completeness is validated against project memory - -**Use Cases**: -```bash -# Assess project progress against stored milestones -/sc:reflect --scope project - -# Validate current session completeness -/sc:reflect - -# Check if ready to move to next phase based on memory -/sc:reflect --scope session -``` - -## Persistent Memory Architecture - -### How Serena MCP Enables True Persistence - -**Memory Storage**: -- Session contexts stored as structured memory files -- Project decisions and architectural patterns preserved permanently -- Code analysis results and insights retained across conversations -- Progress tracking and milestone data maintained long-term - -**Cross-Session Continuity**: -- Previous session context automatically available in new conversations -- Decisions and rationale preserved and accessible across conversations -- Learning from past patterns and solutions maintained -- Consistent project understanding maintained indefinitely - -**Memory Types**: -- **Project Memories**: Long-term project context and architecture -- **Session Memories**: Specific conversation outcomes and decisions -- **Pattern Memories**: Reusable solutions and architectural patterns -- **Progress Memories**: Milestone tracking and completion status - -## Session Lifecycle Patterns with Persistence - -### New Project Initialization -```bash -# 1. Start fresh project -/sc:brainstorm "e-commerce platform requirements" - -# 2. Save initial decisions to persistent memory -/sc:save "project scope and requirements defined" - -# 3. Begin implementation planning -/sc:workflow "user authentication system" - -# 4. Save architectural decisions permanently -/sc:save "auth architecture: JWT + refresh tokens + rate limiting" -``` - -### Resuming Existing Work (Cross-Conversation) -```bash -# 1. Load previous context from persistent memory -/sc:load "e-commerce-project" - -# 2. Assess current state against stored progress -/sc:reflect --scope project - -# 3. Continue with next phase using stored context -/sc:implement "payment processing integration" - -# 4. Save progress checkpoint to memory -/sc:save "payment system integrated with Stripe API" -``` - -### Long-Term Project Management -```bash -# Weekly checkpoint pattern with persistence -/sc:load project-name -/sc:reflect --scope project -# ... work on features ... -/sc:save "week N progress: features X, Y, Z completed" - -# Phase completion pattern with memory -/sc:reflect --scope project -/sc:save "Phase 1 complete: core authentication and user management" -/sc:workflow "Phase 2: payment and order processing" -``` - -## Cross-Conversation Continuity - -### Starting New Conversations with Persistence - -When starting a new Claude Code conversation, the persistent memory system allows: - -1. **Automatic Context Restoration** - ```bash - /sc:load project-name - # Automatically restores all previous context, decisions, and progress - ``` - -2. **Progress Continuation** - - Previous session decisions are immediately available - - Architectural patterns and code insights are preserved - - Project history and rationale are maintained - -3. **Intelligent Context Building** - - Serena MCP provides relevant memories based on current work - - Past solutions and patterns inform new implementations - - Project evolution is tracked and understood - -### Memory Optimization - -**Effective Memory Usage**: -- Use descriptive, searchable memory names -- Include project phase and timestamp context -- Reference specific features or architectural decisions -- Make future retrieval intuitive - -**Memory Content Strategy**: -- Store decisions and rationale, not just outcomes -- Include alternative approaches considered -- Document integration patterns and dependencies -- Preserve learning and insights for future reference - -**Memory Lifecycle Management**: -- Regular cleanup of outdated memories -- Consolidation of related session memories -- Archiving of completed project phases -- Pruning of obsolete architectural decisions - -## Best Practices for Persistent Sessions - -### Session Start Protocol -1. Always begin with `/sc:load` for existing projects -2. Use `/sc:reflect` to understand current state from memory -3. Plan work based on persistent context and stored patterns -4. Build on previous decisions and architectural choices - -### Session End Protocol -1. Use `/sc:reflect` to assess completeness against stored goals -2. Save key decisions with `/sc:save` for future sessions -3. Document next steps and open questions in memory -4. Preserve context for seamless future continuation - -### Memory Quality Maintenance -- Use clear, descriptive memory names for easy retrieval -- Include context about decisions and alternative approaches -- Reference specific code locations and patterns -- Maintain consistency in memory structure across sessions - -## Integration with Other SuperClaude Features - -### MCP Server Coordination -- **Serena MCP**: Provides the persistent memory infrastructure -- **Sequential MCP**: Uses stored memories for enhanced complex analysis -- **Context7 MCP**: References stored patterns and documentation approaches -- **Morphllm MCP**: Applies stored refactoring patterns consistently - -### Agent Collaboration with Memory -- Agents access persistent memories for enhanced context -- Previous specialist decisions are preserved and referenced -- Cross-session agent coordination through shared memory -- Consistent specialist recommendations based on project history - -### Command Integration with Persistence -- All `/sc:` commands can reference and build on persistent context -- Previous command outputs and decisions are available across sessions -- Workflow patterns are stored and reusable -- Implementation history guides future command decisions - -## Troubleshooting Persistent Sessions - -### Common Issues - -**Memory Not Loading**: -- Verify Serena MCP is configured and running properly -- Check memory file permissions and accessibility -- Ensure consistent project naming conventions -- Validate memory file integrity and format - -**Context Loss Between Sessions**: -- Always use `/sc:save` before ending sessions -- Use descriptive memory names for easy retrieval -- Regular `/sc:reflect` to validate memory completeness -- Backup important memory files periodically - -**Memory Conflicts**: -- Use timestamped memory names for version control -- Regular cleanup of obsolete memories -- Clear separation between project and session memories -- Consistent memory naming conventions across sessions - -### Quick Fixes - -**Reset Session State**: -```bash -/sc:load --fresh # Start without previous context -/sc:reflect # Assess current state -``` - -**Memory Cleanup**: -```bash -/sc:reflect --cleanup # Remove obsolete memories -/sc:save --consolidate # Merge related memories -``` - -**Context Recovery**: -```bash -/sc:load --recent # Load most recent memories -/sc:reflect --repair # Identify and fix context gaps -``` - -## Advanced Persistent Session Patterns - -### Multi-Phase Projects -- Use phase-specific memory naming for organization -- Maintain architectural decision continuity across phases -- Cross-phase dependency tracking through persistent memory -- Progressive complexity management with historical context - -### Team Collaboration -- Shared memory conventions and naming standards -- Decision rationale preservation for team context -- Integration pattern documentation accessible to all team members -- Consistent code style and architecture enforcement through memory - -### Long-Term Maintenance -- Memory archiving strategies for completed projects -- Pattern library development through accumulated memories -- Reusable solution documentation built over time -- Knowledge base building through persistent memory accumulation - -## Key Benefits of Persistent Session Management - -### Project Continuity -- Seamless work continuation across multiple conversations -- No context loss between Claude Code sessions -- Preserved architectural decisions and technical rationale -- Long-term project evolution tracking - -### Enhanced Productivity -- Reduced need to re-explain project context -- Faster startup time for continued work -- Building on previous insights and patterns -- Cumulative project knowledge growth - -### Quality Consistency -- Consistent architectural patterns across sessions -- Preserved code quality decisions and standards -- Reusable solutions and best practices -- Maintained technical debt awareness - ---- - -**Key Takeaway**: Session management through Serena MCP transforms SuperClaude from single-conversation assistance to persistent project partnership, maintaining context, decisions, and learning across all development phases and Claude Code conversations. \ No newline at end of file diff --git a/docs/User-Guide/mcp-installation.md b/docs/user-guide/mcp-installation.md similarity index 100% rename from docs/User-Guide/mcp-installation.md rename to docs/user-guide/mcp-installation.md