External/SuperClaude
1
0
Fork 0
mirror of https://github.com/SuperClaude-Org/SuperClaude_Framework.git synced 2025-12-17 09:46:06 +00:00
Code Issues Packages Projects Releases Wiki Activity

refactor(docs): normalize documentation naming to lowercase for PEP8 compliance (#434)

Browse Source 
* refactor(docs): rename directories to lowercase for PEP8 compliance

- Developer-Guide → developer-guide
- Getting-Started → getting-started
- Reference → reference
- Templates → templates
- User-Guide → user-guide
- User-Guide-jp → user-guide-jp
- User-Guide-kr → user-guide-kr
- User-Guide-zh → user-guide-zh

This change aligns with Python PEP8 package naming conventions.
All 43 files affected.

* refactor: rename root documentation files to lowercase

- CHANGELOG.md → changelog.md
- CODE_OF_CONDUCT.md → code_of_conduct.md
- CONTRIBUTING.md → contributing.md
- SECURITY.md → security.md

Aligns with Python package naming conventions (PEP8).
README files remain uppercase as per convention.

* refactor: move documentation files to docs/ for cleaner root

Moved OSS standard files to docs/:
- CHANGELOG.md → docs/CHANGELOG.md
- CODE_OF_CONDUCT.md → docs/CODE_OF_CONDUCT.md
- CONTRIBUTING.md → docs/CONTRIBUTING.md
- SECURITY.md → docs/SECURITY.md

Root now contains only essential files:
✓ README files (表紙: en, ja, kr, zh)
✓ LICENSE (法的要件)
✓ Build configs (pyproject.toml, setup.py, MANIFEST.in)
✓ VERSION

Rationale:
Cleaner root structure following modern Python project conventions.
All detailed documentation consolidated in docs/ directory.

* refactor: update documentation links after restructure

Auto-updated internal documentation links to reflect new structure:
- docs/ subdirectories now lowercase (PEP8)
- Root files moved to docs/
- All cross-references updated

This commit includes linter-generated link updates.

* chore(docs): keep OSS-standard uppercase root files (CHANGELOG, CODE_OF_CONDUCT, CONTRIBUTING, SECURITY)

* chore(docs): remove duplicated PR docs from repo root (moved under docs)

* docs: rename pm-agent-implementation-status.md -> PM_AGENT.md for clarity

* docs: update links to PM_AGENT.md after rename

---------

Co-authored-by: kazuki <kazuki@kazukinoMacBook-Air.local>
This commit is contained in:
kazuki nakai 2025-10-16 00:37:39 +09:00 committed by GitHub
parent 7c14a31bc3
commit d5dfd7da21
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
60 changed files with 836 additions and 886 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

191
PR_DOCUMENTATION.md
View File

@ -1,191 +0,0 @@
# Pull Request: Redesign PM Agent as Self-Improvement Meta-Layer
## Summary
Redesigned PM Agent from task orchestration system to self-improvement workflow executor (meta-layer agent). PM Agent now complements existing auto-activation by systematically documenting implementations, analyzing mistakes, and maintaining knowledge base quality.
## Motivation
**Problem**: Initial PM Agent design competed with existing auto-activation system for task routing, creating confusion about responsibilities and adding unnecessary complexity.
**Solution**: Redefined PM Agent as a meta-layer that operates AFTER specialist agents complete tasks, focusing on:
- Post-implementation documentation
- Immediate mistake analysis and prevention
- Monthly documentation maintenance
- Pattern extraction and knowledge synthesis
**Value Proposition**: Transforms SuperClaude into a continuously learning system that accumulates knowledge, prevents recurring mistakes, and maintains fresh documentation without manual intervention.
## Changes
### 1. PM Agent Agent File (`SuperClaude/Agents/pm-agent.md`)
**Status**: Complete rewrite
**Before**:
- Category: orchestration
- Triggers: All user interactions (default mode)
- Role: Task router and sub-agent coordinator
- Competed with existing auto-activation
**After**:
- Category: meta
- Triggers: Post-implementation, mistake detection, monthly maintenance
- Role: Self-improvement workflow executor
- Complements existing auto-activation
**Key Additions**:
- Behavioral Mindset: "Think like a continuous learning system"
- Focus Areas: Implementation Documentation, Mistake Analysis, Pattern Recognition, Knowledge Maintenance, Self-Improvement Loop
- Self-Improvement Workflow Integration: BEFORE/DURING/AFTER/MISTAKE RECOVERY/MAINTENANCE phases
- Quality Standards: Latest, Minimal, Clear, Practical documentation criteria
- Performance Metrics: Documentation coverage, mistake prevention effectiveness, knowledge maintenance health
**Workflow Examples**:
1. Post-Implementation Documentation: Backend architect implements JWT → PM Agent documents pattern
2. Immediate Mistake Analysis: Kong Gateway bypass detected → PM Agent stops, analyzes, documents prevention
3. Monthly Documentation Maintenance: PM Agent prunes outdated docs, merges duplicates, updates versions
### 2. Framework Rules (`SuperClaude/Core/RULES.md`)
**Status**: Agent Orchestration section updated (lines 17-44)
**Changes**:
- Split orchestration into two clear layers:
- **Task Execution Layer**: Existing auto-activation (unchanged)
- **Self-Improvement Layer**: PM Agent meta-layer (new)
- Added orchestration flow diagram showing task execution → documentation cycle
- Clarified examples: ✅ Right patterns and ❌ Wrong anti-patterns
- Emphasized PM Agent activates AFTER task completion, not before/during
**Purpose**: Eliminate confusion between task routing (auto-activation) and learning (PM Agent)
### 3. README.md
**Status**: PM Agent description updated (line 208)
**Before**: "PM Agent orchestrates all interactions seamlessly"
**After**: "PM Agent ensures continuous learning through systematic documentation"
**Impact**: Accurate representation of PM Agent's meta-layer role in main documentation
### 4. Agents Guide (`Docs/User-Guide/agents.md`)
**Status**: PM Agent section completely rewritten (lines 140-208)
**Changes**:
- Section title: "Orchestration Agent" → "Meta-Layer Agent"
- Expertise: Project orchestration → Self-improvement workflow executor
- Auto-Activation: Default mode for all interactions → Post-implementation, mistake detection, monthly maintenance
- Capabilities: Workflow orchestration → Implementation documentation, mistake analysis, pattern recognition, knowledge maintenance
- Examples: Vague feature requests → Post-implementation documentation, immediate mistake analysis, monthly maintenance
- Integration: Orchestrates entire ecosystem → Documents specialist agents' work
**Purpose**: User-facing documentation accurately reflects PM Agent's actual behavior
## Two-Layer Orchestration System
```
┌─────────────────────────────────────────────────────────┐
│ Task Execution Layer (Existing Auto-Activation) │
│ ─────────────────────────────────────────────────────── │
│ User Request → Context Analysis → Specialist Selection │
│ backend-architect | frontend-architect | security, etc. │
│ │
│ ↓ Implementation Complete ↓ │
└─────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────┐
│ Self-Improvement Layer (PM Agent Meta-Layer) │
│ ─────────────────────────────────────────────────────── │
│ PM Agent Auto-Triggers → Documentation → Learning │
│ Pattern Recording | Mistake Analysis | Maintenance │
│ │
│ ↓ Knowledge Base Updated ↓ │
└─────────────────────────────────────────────────────────┘
```
**Flow**:
1. User: "Add JWT authentication"
2. Task Execution Layer: Auto-activation → security-engineer + backend-architect → Implementation
3. Self-Improvement Layer: PM Agent auto-triggers → Documents JWT pattern in docs/authentication.md → Records security decisions → Updates CLAUDE.md
## Testing
**Validation Method**: Verified integration with existing self-improvement workflow
**Test Case**: agiletec project
- ✅ Reviewed `/Users/kazuki/github/agiletec/docs/self-improvement-workflow.md`
- ✅ Confirmed PM Agent design aligns with BEFORE/DURING/AFTER/MISTAKE RECOVERY phases
- ✅ Verified PM Agent complements (not competes with) existing workflow
- ✅ Confirmed agiletec workflow defines WHAT, PM Agent defines WHO executes it
**Integration Check**:
- ✅ PM Agent operates as meta-layer above specialist agents
- ✅ Existing auto-activation handles task routing (unchanged)
- ✅ PM Agent handles post-implementation documentation (new capability)
- ✅ No conflicts with existing agent activation patterns
## Breaking Changes
**None**. This is a design clarification and documentation update:
- ✅ Existing auto-activation continues to work identically
- ✅ Specialist agents (backend-architect, frontend-architect, etc.) unchanged
- ✅ User workflows remain the same
- ✅ Manual `@agent-[name]` override still works
- ✅ Commands (`/sc:implement`, `/sc:build`, etc.) unchanged
**New Capability**: PM Agent now automatically documents implementations and maintains knowledge base without user intervention.
## Impact on User Experience
**Before**:
- User requests task → Specialist agents implement → User manually documents (if at all)
- Mistakes repeated due to lack of systematic documentation
- Documentation becomes outdated over time
**After**:
- User requests task → Specialist agents implement → PM Agent auto-documents patterns
- Mistakes automatically analyzed with prevention checklists created
- Documentation systematically maintained through monthly reviews
**Result**: Zero additional user effort, continuous improvement built into framework
## Verification Checklist
- [x] PM Agent agent file completely rewritten with meta-layer design
- [x] RULES.md Agent Orchestration section updated with two-layer system
- [x] README.md PM Agent description updated
- [x] agents.md PM Agent section completely rewritten
- [x] Integration validated with agiletec project self-improvement workflow
- [x] All files properly formatted and consistent
- [x] No breaking changes to existing functionality
- [x] Documentation accurately reflects implementation
## Future Enhancements
**Potential Additions** (not included in this PR):
1. `/sc:pm status` - Show documentation coverage and maintenance health
2. `/sc:pm review` - Manual trigger for documentation review
3. Performance metrics dashboard - Track mistake prevention effectiveness
4. Integration with CI/CD - Auto-generate documentation on PR merge
**These are OPTIONAL** and should be separate PRs based on user feedback.
## Related Issues
Addresses internal design discussion about PM Agent role clarity and integration with existing auto-activation system.
## Reviewer Notes
**Key Points to Review**:
1. **pm-agent.md**: Complete rewrite - verify behavioral mindset, focus areas, and workflow examples make sense
2. **RULES.md**: Two-layer orchestration system - verify clear distinction between task execution and self-improvement
3. **agents.md**: User-facing documentation - verify accurate representation of PM Agent behavior
4. **Integration**: Verify PM Agent complements (not competes with) existing auto-activation
**Expected Outcome**: PM Agent transforms SuperClaude into a continuously learning system through systematic documentation, mistake analysis, and knowledge maintenance.
---
**PR Type**: Enhancement (Design Clarification)
**Complexity**: Medium (Documentation-focused, no code changes)
**Risk**: Low (No breaking changes, purely additive capability)

28
README-ja.md
View File

@ -275,55 +275,55 @@ pip install --break-system-packages SuperClaude
<tr> <tr>
<td valign="top"> <td valign="top">
- 📝 [**クイックスタートガイド**](docs/Getting-Started/quick-start.md) - 📝 [**クイックスタートガイド**](docs/getting-started/quick-start.md)
*すぐに開始* *すぐに開始*
- 💾 [**インストールガイド**](docs/Getting-Started/installation.md) - 💾 [**インストールガイド**](docs/getting-started/installation.md)
*詳細なセットアップ手順* *詳細なセットアップ手順*
</td> </td>
<td valign="top"> <td valign="top">
- 🎯 [**コマンドリファレンス**](docs/User-Guide-jp/commands.md) - 🎯 [**コマンドリファレンス**](docs/user-guide-jp/commands.md)
*全21のスラッシュコマンド* *全21のスラッシュコマンド*
- 🤖 [**エージェントガイド**](docs/User-Guide-jp/agents.md) - 🤖 [**エージェントガイド**](docs/user-guide-jp/agents.md)
*14の専門エージェント* *14の専門エージェント*
- 🎨 [**動作モード**](docs/User-Guide-jp/modes.md) - 🎨 [**動作モード**](docs/user-guide-jp/modes.md)
*5つの適応モード* *5つの適応モード*
- 🚩 [**フラグガイド**](docs/User-Guide-jp/flags.md) - 🚩 [**フラグガイド**](docs/user-guide-jp/flags.md)
*動作制御パラメータ* *動作制御パラメータ*
- 🔧 [**MCPサーバー**](docs/User-Guide-jp/mcp-servers.md) - 🔧 [**MCPサーバー**](docs/user-guide-jp/mcp-servers.md)
*6つのサーバー統合* *6つのサーバー統合*
- 💼 [**セッション管理**](docs/User-Guide-jp/session-management.md) - 💼 [**セッション管理**](docs/user-guide-jp/session-management.md)
*状態の保存と復元* *状態の保存と復元*
</td> </td>
<td valign="top"> <td valign="top">
- 🏗️ [**技術アーキテクチャ**](docs/Developer-Guide/technical-architecture.md) - 🏗️ [**技術アーキテクチャ**](docs/developer-guide/technical-architecture.md)
*システム設計の詳細* *システム設計の詳細*
- 💻 [**コード貢献**](docs/Developer-Guide/contributing-code.md) - 💻 [**コード貢献**](docs/developer-guide/contributing-code.md)
*開発ワークフロー* *開発ワークフロー*
- 🧪 [**テスト＆デバッグ**](docs/Developer-Guide/testing-debugging.md) - 🧪 [**テスト＆デバッグ**](docs/developer-guide/testing-debugging.md)
*品質保証* *品質保証*
</td> </td>
<td valign="top"> <td valign="top">
- ✨ [**ベストプラクティス**](docs/Reference/quick-start-practices.md) - ✨ [**ベストプラクティス**](docs/reference/quick-start-practices.md)
*プロのコツとパターン* *プロのコツとパターン*
- 📓 [**サンプル集**](docs/Reference/examples-cookbook.md) - 📓 [**サンプル集**](docs/reference/examples-cookbook.md)
*実際の使用例* *実際の使用例*
- 🔍 [**トラブルシューティング**](docs/Reference/troubleshooting.md) - 🔍 [**トラブルシューティング**](docs/reference/troubleshooting.md)
*一般的な問題と修正* *一般的な問題と修正*
</td> </td>

28
README-kr.md
View File

@ -278,55 +278,55 @@ pip install --break-system-packages SuperClaude
<tr> <tr>
<td valign="top"> <td valign="top">
- 📝 [**빠른 시작 가이드**](docs/Getting-Started/quick-start.md) - 📝 [**빠른 시작 가이드**](docs/getting-started/quick-start.md)
*즉시 시작하기* *즉시 시작하기*
- 💾 [**설치 가이드**](docs/Getting-Started/installation.md) - 💾 [**설치 가이드**](docs/getting-started/installation.md)
*상세한 설정 단계* *상세한 설정 단계*
</td> </td>
<td valign="top"> <td valign="top">
- 🎯 [**명령어 레퍼런스**](docs/User-Guide/commands.md) - 🎯 [**명령어 레퍼런스**](docs/user-guide/commands.md)
*전체 21개 슬래시 명령어* *전체 21개 슬래시 명령어*
- 🤖 [**에이전트 가이드**](docs/User-Guide/agents.md) - 🤖 [**에이전트 가이드**](docs/user-guide/agents.md)
*14개 전문 에이전트* *14개 전문 에이전트*
- 🎨 [**작동 모드**](docs/User-Guide/modes.md) - 🎨 [**작동 모드**](docs/user-guide/modes.md)
*5가지 적응형 모드* *5가지 적응형 모드*
- 🚩 [**플래그 가이드**](docs/User-Guide/flags.md) - 🚩 [**플래그 가이드**](docs/user-guide/flags.md)
*동작 제어 매개변수* *동작 제어 매개변수*
- 🔧 [**MCP 서버**](docs/User-Guide/mcp-servers.md) - 🔧 [**MCP 서버**](docs/user-guide/mcp-servers.md)
*6개 서버 통합* *6개 서버 통합*
- 💼 [**세션 관리**](docs/User-Guide/session-management.md) - 💼 [**세션 관리**](docs/user-guide/session-management.md)
*상태 저장 및 복원* *상태 저장 및 복원*
</td> </td>
<td valign="top"> <td valign="top">
- 🏗️ [**기술 아키텍처**](docs/Developer-Guide/technical-architecture.md) - 🏗️ [**기술 아키텍처**](docs/developer-guide/technical-architecture.md)
*시스템 설계 세부사항* *시스템 설계 세부사항*
- 💻 [**코드 기여**](docs/Developer-Guide/contributing-code.md) - 💻 [**코드 기여**](docs/developer-guide/contributing-code.md)
*개발 워크플로우* *개발 워크플로우*
- 🧪 [**테스트 및 디버깅**](docs/Developer-Guide/testing-debugging.md) - 🧪 [**테스트 및 디버깅**](docs/developer-guide/testing-debugging.md)
*품질 보증* *품질 보증*
</td> </td>
<td valign="top"> <td valign="top">
- ✨ [**모범 사례**](docs/Reference/quick-start-practices.md) - ✨ [**모범 사례**](docs/reference/quick-start-practices.md)
*전문가 팁과 패턴* *전문가 팁과 패턴*
- 📓 [**예제 모음**](docs/Reference/examples-cookbook.md) - 📓 [**예제 모음**](docs/reference/examples-cookbook.md)
*실제 사용 예제* *실제 사용 예제*
- 🔍 [**문제 해결**](docs/Reference/troubleshooting.md) - 🔍 [**문제 해결**](docs/reference/troubleshooting.md)
*일반적인 문제와 수정* *일반적인 문제와 수정*
</td> </td>

28
README-zh.md
View File

@ -275,55 +275,55 @@ pip install --break-system-packages SuperClaude
<tr> <tr>
<td valign="top"> <td valign="top">
- 📝 [**快速开始指南**](docs/Getting-Started/quick-start.md) - 📝 [**快速开始指南**](docs/getting-started/quick-start.md)
*快速上手使用* *快速上手使用*
- 💾 [**安装指南**](docs/Getting-Started/installation.md) - 💾 [**安装指南**](docs/getting-started/installation.md)
*详细的安装说明* *详细的安装说明*
</td> </td>
<td valign="top"> <td valign="top">
- 🎯 [**命令参考**](docs/User-Guide-zh/commands.md) - 🎯 [**命令参考**](docs/user-guide-zh/commands.md)
*全部21个斜杠命令* *全部21个斜杠命令*
- 🤖 [**智能体指南**](docs/User-Guide-zh/agents.md) - 🤖 [**智能体指南**](docs/user-guide-zh/agents.md)
*14个专业智能体* *14个专业智能体*
- 🎨 [**行为模式**](docs/User-Guide-zh/modes.md) - 🎨 [**行为模式**](docs/user-guide-zh/modes.md)
*5种自适应模式* *5种自适应模式*
- 🚩 [**标志指南**](docs/User-Guide-zh/flags.md) - 🚩 [**标志指南**](docs/user-guide-zh/flags.md)
*控制行为参数* *控制行为参数*
- 🔧 [**MCP服务器**](docs/User-Guide-zh/mcp-servers.md) - 🔧 [**MCP服务器**](docs/user-guide-zh/mcp-servers.md)
*6个服务器集成* *6个服务器集成*
- 💼 [**会话管理**](docs/User-Guide-zh/session-management.md) - 💼 [**会话管理**](docs/user-guide-zh/session-management.md)
*保存和恢复状态* *保存和恢复状态*
</td> </td>
<td valign="top"> <td valign="top">
- 🏗️ [**技术架构**](docs/Developer-Guide/technical-architecture.md) - 🏗️ [**技术架构**](docs/developer-guide/technical-architecture.md)
*系统设计详情* *系统设计详情*
- 💻 [**贡献代码**](docs/Developer-Guide/contributing-code.md) - 💻 [**贡献代码**](docs/developer-guide/contributing-code.md)
*开发工作流程* *开发工作流程*
- 🧪 [**测试与调试**](docs/Developer-Guide/testing-debugging.md) - 🧪 [**测试与调试**](docs/developer-guide/testing-debugging.md)
*质量保证* *质量保证*
</td> </td>
<td valign="top"> <td valign="top">
- ✨ [**最佳实践**](docs/Reference/quick-start-practices.md) - ✨ [**最佳实践**](docs/reference/quick-start-practices.md)
*专业技巧和模式* *专业技巧和模式*
- 📓 [**示例手册**](docs/Reference/examples-cookbook.md) - 📓 [**示例手册**](docs/reference/examples-cookbook.md)
*实际应用示例* *实际应用示例*
- 🔍 [**故障排除**](docs/Reference/troubleshooting.md) - 🔍 [**故障排除**](docs/reference/troubleshooting.md)
*常见问题和修复* *常见问题和修复*
</td> </td>

26
README.md
View File

@ -392,51 +392,51 @@ The Deep Research system intelligently coordinates multiple tools:
<tr> <tr>
<td valign="top"> <td valign="top">
- 📝 [**Quick Start Guide**](docs/Getting-Started/quick-start.md) - 📝 [**Quick Start Guide**](docs/getting-started/quick-start.md)
*Get up and running fast* *Get up and running fast*
- 💾 [**Installation Guide**](docs/Getting-Started/installation.md) - 💾 [**Installation Guide**](docs/getting-started/installation.md)
*Detailed setup instructions* *Detailed setup instructions*
</td> </td>
<td valign="top"> <td valign="top">
- 🎯 [**Commands Reference**](docs/User-Guide/commands.md) - 🎯 [**Commands Reference**](docs/user-guide/commands.md)
*All 25 slash commands* *All 25 slash commands*
- 🤖 [**Agents Guide**](docs/User-Guide/agents.md) - 🤖 [**Agents Guide**](docs/user-guide/agents.md)
*15 specialized agents* *15 specialized agents*
- 🎨 [**Behavioral Modes**](docs/User-Guide/modes.md) - 🎨 [**Behavioral Modes**](docs/user-guide/modes.md)
*7 adaptive modes* *7 adaptive modes*
- 🚩 [**Flags Guide**](docs/User-Guide/flags.md) - 🚩 [**Flags Guide**](docs/user-guide/flags.md)
*Control behaviors* *Control behaviors*
- 🔧 [**MCP Servers**](docs/User-Guide/mcp-servers.md) - 🔧 [**MCP Servers**](docs/user-guide/mcp-servers.md)
*7 server integrations* *7 server integrations*
- 💼 [**Session Management**](docs/User-Guide/session-management.md) - 💼 [**Session Management**](docs/user-guide/session-management.md)
*Save & restore state* *Save & restore state*
</td> </td>
<td valign="top"> <td valign="top">
- 🏗️ [**Technical Architecture**](docs/Developer-Guide/technical-architecture.md) - 🏗️ [**Technical Architecture**](docs/developer-guide/technical-architecture.md)
*System design details* *System design details*
- 💻 [**Contributing Code**](docs/Developer-Guide/contributing-code.md) - 💻 [**Contributing Code**](docs/developer-guide/contributing-code.md)
*Development workflow* *Development workflow*
- 🧪 [**Testing & Debugging**](docs/Developer-Guide/testing-debugging.md) - 🧪 [**Testing & Debugging**](docs/developer-guide/testing-debugging.md)
*Quality assurance* *Quality assurance*
</td> </td>
<td valign="top"> <td valign="top">
- 📓 [**Examples Cookbook**](docs/Reference/examples-cookbook.md) - 📓 [**Examples Cookbook**](docs/reference/examples-cookbook.md)
*Real-world recipes* *Real-world recipes*
- 🔍 [**Troubleshooting**](docs/Reference/troubleshooting.md) - 🔍 [**Troubleshooting**](docs/reference/troubleshooting.md)
*Common issues & fixes* *Common issues & fixes*
</td> </td>

2
docs/Development/ARCHITECTURE.md
View File

@ -236,7 +236,7 @@ Session End:
"learned": ["Session Lifecycle pattern", "PDCA automation"] "learned": ["Session Lifecycle pattern", "PDCA automation"]
}, },
"next_actions": [ "next_actions": [
"Create docs/Development/ structure", "Create docs/development/ structure",
"Write ARCHITECTURE.md", "Write ARCHITECTURE.md",
"Configure Serena MCP server" "Configure Serena MCP server"
] ]

14
docs/Development/PROJECT_STATUS.md
View File

@ -48,11 +48,11 @@
- ✅ Agents/pm-agent.md updated - ✅ Agents/pm-agent.md updated
### Documentation ### Documentation
- ✅ docs/Development/ARCHITECTURE.md - ✅ docs/development/ARCHITECTURE.md
- ✅ docs/Development/ROADMAP.md - ✅ docs/development/ROADMAP.md
- ✅ docs/Development/TASKS.md - ✅ docs/development/TASKS.md
- ✅ docs/Development/PROJECT_STATUS.md - ✅ docs/development/PROJECT_STATUS.md
- ✅ docs/pm-agent-implementation-status.md - ✅ docs/PM_AGENT.md
--- ---
@ -135,7 +135,7 @@
### Week 2-3 ### Week 2-3
- [ ] Implement PM Agent Core (session_lifecycle, pdca_engine, memory_ops) - [ ] Implement PM Agent Core (session_lifecycle, pdca_engine, memory_ops)
- [ ] Write unit tests - [ ] Write unit tests
- [ ] Update User-Guide documentation - [ ] Update user-guide documentation
### Week 4-5 ### Week 4-5
- [ ] Configure Serena MCP server - [ ] Configure Serena MCP server
@ -147,7 +147,7 @@
## 📝 Recent Changes ## 📝 Recent Changes
### 2025-10-14 ### 2025-10-14
- Created docs/Development/ structure - Created docs/development/ structure
- Wrote ARCHITECTURE.md (system overview) - Wrote ARCHITECTURE.md (system overview)
- Wrote ROADMAP.md (5-phase development plan) - Wrote ROADMAP.md (5-phase development plan)
- Wrote TASKS.md (task tracking) - Wrote TASKS.md (task tracking)

22
docs/Development/ROADMAP.md
View File

@ -31,7 +31,7 @@ Transform SuperClaude into a self-improving development platform with PM Agent m
### Tasks ### Tasks
- [x] Create `docs/Development/` directory structure - [x] Create `docs/development/` directory structure
- [x] Write `ARCHITECTURE.md` - System overview with PM Agent position - [x] Write `ARCHITECTURE.md` - System overview with PM Agent position
- [x] Write `ROADMAP.md` - Phase-based development plan with checkboxes - [x] Write `ROADMAP.md` - Phase-based development plan with checkboxes
- [ ] Write `TASKS.md` - Current task tracking system - [ ] Write `TASKS.md` - Current task tracking system
@ -40,11 +40,11 @@ Transform SuperClaude into a self-improving development platform with PM Agent m
### Deliverables ### Deliverables
- [x] **docs/Development/ARCHITECTURE.md** - Complete system architecture - [x] **docs/development/ARCHITECTURE.md** - Complete system architecture
- [x] **docs/Development/ROADMAP.md** - This file (development roadmap) - [x] **docs/development/ROADMAP.md** - This file (development roadmap)
- [ ] **docs/Development/TASKS.md** - Task management with checkboxes - [ ] **docs/development/TASKS.md** - Task management with checkboxes
- [ ] **docs/Development/PROJECT_STATUS.md** - Current status and metrics - [ ] **docs/development/PROJECT_STATUS.md** - Current status and metrics
- [ ] **docs/Development/pm-agent-integration.md** - Integration procedures - [ ] **docs/development/pm-agent-integration.md** - Integration procedures
### Success Criteria ### Success Criteria
@ -69,9 +69,9 @@ Transform SuperClaude into a self-improving development platform with PM Agent m
#### Documentation Updates #### Documentation Updates
- [x] Update `superclaude/Commands/pm.md` with Session Lifecycle - [x] Update `superclaude/Commands/pm.md` with Session Lifecycle
- [x] Update `superclaude/Agents/pm-agent.md` with PDCA Cycle - [x] Update `superclaude/Agents/pm-agent.md` with PDCA Cycle
- [x] Create `docs/pm-agent-implementation-status.md` - [x] Create `docs/PM_AGENT.md`
- [ ] Update `docs/User-Guide/agents.md` - Add PM Agent section - [ ] Update `docs/user-guide/agents.md` - Add PM Agent section
- [ ] Update `docs/User-Guide/commands.md` - Add /sc:pm command - [ ] Update `docs/user-guide/commands.md` - Add /sc:pm command
#### Core Implementation #### Core Implementation
- [ ] Implement `superclaude/Core/session_lifecycle.py` - [ ] Implement `superclaude/Core/session_lifecycle.py`
@ -100,7 +100,7 @@ Transform SuperClaude into a self-improving development platform with PM Agent m
### Deliverables ### Deliverables
- [x] **Updated pm.md and pm-agent.md** - Design documentation - [x] **Updated pm.md and pm-agent.md** - Design documentation
- [x] **pm-agent-implementation-status.md** - Status tracking - [x] **PM_AGENT.md** - Status tracking
- [ ] **superclaude/Core/session_lifecycle.py** - Session management - [ ] **superclaude/Core/session_lifecycle.py** - Session management
- [ ] **superclaude/Core/pdca_engine.py** - PDCA automation - [ ] **superclaude/Core/pdca_engine.py** - PDCA automation
- [ ] **superclaude/Core/memory_ops.py** - Memory operations - [ ] **superclaude/Core/memory_ops.py** - Memory operations
@ -269,7 +269,7 @@ Transform SuperClaude into a self-improving development platform with PM Agent m
### Deliverables ### Deliverables
- [ ] **superclaude/Core/auto_activation.py** - Auto-activation system - [ ] **superclaude/Core/auto_activation.py** - Auto-activation system
- [ ] **docs/Developer-Guide/auto-activation.md** - Implementation guide - [ ] **docs/developer-guide/auto-activation.md** - Implementation guide
- [ ] **tests/test_auto_activation.py** - Auto-activation tests - [ ] **tests/test_auto_activation.py** - Auto-activation tests
- [ ] **Performance Report** - Startup time impact analysis - [ ] **Performance Report** - Startup time impact analysis

10
docs/Development/TASKS.md
View File

@ -8,7 +8,7 @@
## 🔥 High Priority (This Week: 2025-10-14 ~ 2025-10-20) ## 🔥 High Priority (This Week: 2025-10-14 ~ 2025-10-20)
### Phase 1: Documentation Structure ### Phase 1: Documentation Structure
- [x] Create docs/Development/ directory - [x] Create docs/development/ directory
- [x] Write ARCHITECTURE.md - [x] Write ARCHITECTURE.md
- [x] Write ROADMAP.md - [x] Write ROADMAP.md
- [ ] Write TASKS.md (this file) - [ ] Write TASKS.md (this file)
@ -21,7 +21,7 @@
- [x] Design PDCA Cycle - [x] Design PDCA Cycle
- [x] Update Commands/pm.md - [x] Update Commands/pm.md
- [x] Update Agents/pm-agent.md - [x] Update Agents/pm-agent.md
- [x] Create pm-agent-implementation-status.md - [x] Create PM_AGENT.md
- [ ] Commit PM Agent Mode changes - [ ] Commit PM Agent Mode changes
--- ---
@ -33,7 +33,7 @@
- [ ] Implement superclaude/Core/pdca_engine.py - [ ] Implement superclaude/Core/pdca_engine.py
- [ ] Implement superclaude/Core/memory_ops.py - [ ] Implement superclaude/Core/memory_ops.py
- [ ] Write unit tests for PM Agent core - [ ] Write unit tests for PM Agent core
- [ ] Update User-Guide documentation - [ ] Update user-guide documentation
### Testing & Validation ### Testing & Validation
- [ ] Create test suite for session_lifecycle - [ ] Create test suite for session_lifecycle
@ -84,8 +84,8 @@
### 2025-10-14 ### 2025-10-14
- [x] Salvaged PM Agent mode changes from ~/.claude - [x] Salvaged PM Agent mode changes from ~/.claude
- [x] Cleaned up ~/.claude git repository - [x] Cleaned up ~/.claude git repository
- [x] Created pm-agent-implementation-status.md - [x] Created PM_AGENT.md
- [x] Created docs/Development/ directory - [x] Created docs/development/ directory
- [x] Wrote ARCHITECTURE.md - [x] Wrote ARCHITECTURE.md
- [x] Wrote ROADMAP.md - [x] Wrote ROADMAP.md
- [x] Wrote TASKS.md - [x] Wrote TASKS.md

2
docs/Development/installation-flow-understanding.md
View File

@ -286,7 +286,7 @@ Read ~/.claude/commands/sc/pm.md
### Phase 3: 改善案作成 ### Phase 3: 改善案作成
```bash ```bash
# このプロジェクト内で（Git管理） # このプロジェクト内で（Git管理）
Write docs/Development/hypothesis-pm-enhancement-2025-10-14.md Write docs/development/hypothesis-pm-enhancement-2025-10-14.md
内容: 内容:
- 現状の問題（ドキュメント寄りすぎ、PMO機能不足） - 現状の問題（ドキュメント寄りすぎ、PMO機能不足）

16
docs/Development/pm-agent-ideal-workflow.md
View File

@ -23,12 +23,12 @@
1. ドキュメント読み込み: 1. ドキュメント読み込み:
優先順位: 優先順位:
1. タスク管理ドキュメント → 進捗確認 1. タスク管理ドキュメント → 進捗確認
- docs/Development/tasks/current-tasks.md - docs/development/tasks/current-tasks.md
- 前回どこまでやったか - 前回どこまでやったか
- 次に何をすべきか - 次に何をすべきか
2. アーキテクチャドキュメント → 仕組み理解 2. アーキテクチャドキュメント → 仕組み理解
- docs/Development/architecture-*.md - docs/development/architecture-*.md
- このプロジェクトの構造 - このプロジェクトの構造
- インストールフロー - インストールフロー
- コンポーネント連携 - コンポーネント連携
@ -36,7 +36,7 @@
3. 禁止事項・ルール → 制約確認 3. 禁止事項・ルール → 制約確認
- CLAUDE.md（グローバル） - CLAUDE.md（グローバル）
- PROJECT/CLAUDE.md（プロジェクト固有） - PROJECT/CLAUDE.md（プロジェクト固有）
- docs/Development/constraints.md - docs/development/constraints.md
4. 過去の学び → 同じミスを防ぐ 4. 過去の学び → 同じミスを防ぐ
- docs/mistakes/ （失敗記録） - docs/mistakes/ （失敗記録）
@ -88,7 +88,7 @@
```yaml ```yaml
1. 改善仮説作成: 1. 改善仮説作成:
# このプロジェクト内で（Git管理） # このプロジェクト内で（Git管理）
File: docs/Development/hypothesis-YYYY-MM-DD.md File: docs/development/hypothesis-YYYY-MM-DD.md
内容: 内容:
- 現状の問題点 - 現状の問題点
@ -127,7 +127,7 @@
- quality-engineer: テスト設計 - quality-engineer: テスト設計
2. 実装記録: 2. 実装記録:
File: docs/Development/experiment-YYYY-MM-DD.md File: docs/development/experiment-YYYY-MM-DD.md
内容: 内容:
- 試行錯誤の記録 - 試行錯誤の記録
@ -194,7 +194,7 @@
- チェックリスト - チェックリスト
3. タスク更新: 3. タスク更新:
File: docs/Development/tasks/current-tasks.md File: docs/development/tasks/current-tasks.md
内容: 内容:
- 完了したタスク - 完了したタスク
@ -292,7 +292,7 @@ docs/
│ └── experiment-*.md # 実験記録 │ └── experiment-*.md # 実験記録
├── patterns/ # 成功パターン（清書後） ├── patterns/ # 成功パターン（清書後）
├── mistakes/ # 失敗記録と防止策 ├── mistakes/ # 失敗記録と防止策
└── (既存のUser-Guide等) └── (既存のuser-guide等)
``` ```
--- ---
@ -335,7 +335,7 @@ docs/
このドキュメント作成後: このドキュメント作成後:
1. 既存のインストールロジック理解（setup/components/） 1. 既存のインストールロジック理解（setup/components/）
2. タスク管理ドキュメント作成（docs/Development/tasks/） 2. タスク管理ドキュメント作成（docs/development/tasks/）
3. PM Agent実装修正（このワークフローを実際に実装） 3. PM Agent実装修正（このワークフローを実際に実装）
このドキュメント自体が**PM Agentの憲法**となる。 このドキュメント自体が**PM Agentの憲法**となる。

2
docs/Development/pm-agent-integration.md
View File

@ -466,7 +466,7 @@ tests/integration/
- [ARCHITECTURE.md](./ARCHITECTURE.md) - System architecture - [ARCHITECTURE.md](./ARCHITECTURE.md) - System architecture
- [ROADMAP.md](./ROADMAP.md) - Development roadmap - [ROADMAP.md](./ROADMAP.md) - Development roadmap
- [pm-agent-implementation-status.md](../pm-agent-implementation-status.md) - Status tracking - [PM_AGENT.md](../PM_AGENT.md) - Status tracking
- [Commands/pm.md](../../superclaude/Commands/pm.md) - PM Agent command - [Commands/pm.md](../../superclaude/Commands/pm.md) - PM Agent command
- [Agents/pm-agent.md](../../superclaude/Agents/pm-agent.md) - PM Agent persona - [Agents/pm-agent.md](../../superclaude/Agents/pm-agent.md) - PM Agent persona

12
docs/Development/project-structure-understanding.md
View File

@ -146,7 +146,7 @@ cat ~/.claude/commands/sc/pm.md # 現在の仕様確認
cd ~/github/SuperClaude_Framework cd ~/github/SuperClaude_Framework
# Git管理されているこのプロジェクト内で # Git管理されているこのプロジェクト内で
Write docs/Development/hypothesis-pm-improvement-YYYY-MM-DD.md Write docs/development/hypothesis-pm-improvement-YYYY-MM-DD.md
# 内容例: # 内容例:
# - 現状の問題 # - 現状の問題
@ -226,9 +226,9 @@ mv backup original
``` ```
### Rule 3: ドキュメント駆動開発 ### Rule 3: ドキュメント駆動開発
1. 理解 → docs/Development/ に記録 1. 理解 → docs/development/ に記録
2. 仮説 → docs/Development/hypothesis-*.md 2. 仮説 → docs/development/hypothesis-*.md
3. 実験 → docs/Development/experiment-*.md 3. 実験 → docs/development/experiment-*.md
4. 成功 → docs/patterns/ 4. 成功 → docs/patterns/
5. 失敗 → docs/mistakes/ 5. 失敗 → docs/mistakes/
@ -336,7 +336,7 @@ vim ~/.claude/commands/sc/pm.md
```bash ```bash
# ✅ CORRECT # ✅ CORRECT
1. setup/components/ でロジック理解 1. setup/components/ でロジック理解
2. docs/Development/ に改善案記録 2. docs/development/ に改善案記録
3. setup/ 側で変更・テスト 3. setup/ 側で変更・テスト
4. Git コミット 4. Git コミット
5. SuperClaude install --dev で動作確認 5. SuperClaude install --dev で動作確認
@ -357,7 +357,7 @@ vim ~/.claude/commands/sc/pm.md
- 現在の動作理解 - 現在の動作理解
3. **改善提案作成** 3. **改善提案作成**
- `docs/Development/hypothesis-*.md` 作成 - `docs/development/hypothesis-*.md` 作成
- ユーザーレビュー - ユーザーレビュー
4. **実装・テスト** 4. **実装・テスト**

12
docs/Development/tasks/current-tasks.md
View File

@ -20,22 +20,22 @@
### Phase 1: ドキュメント基盤整備 ### Phase 1: ドキュメント基盤整備
- [x] **PM Agent理想ワークフローをドキュメント化** - [x] **PM Agent理想ワークフローをドキュメント化**
- File: `docs/Development/pm-agent-ideal-workflow.md` - File: `docs/development/pm-agent-ideal-workflow.md`
- Content: 完璧なワークフロー（7フェーズ） - Content: 完璧なワークフロー（7フェーズ）
- Purpose: 次回セッションで同じ説明を繰り返さない - Purpose: 次回セッションで同じ説明を繰り返さない
- [x] **プロジェクト構造理解をドキュメント化** - [x] **プロジェクト構造理解をドキュメント化**
- File: `docs/Development/project-structure-understanding.md` - File: `docs/development/project-structure-understanding.md`
- Content: Git管理とインストール後環境の区別 - Content: Git管理とインストール後環境の区別
- Purpose: 何百回も説明した内容を外部化 - Purpose: 何百回も説明した内容を外部化
- [x] **インストールフロー理解をドキュメント化** - [x] **インストールフロー理解をドキュメント化**
- File: `docs/Development/installation-flow-understanding.md` - File: `docs/development/installation-flow-understanding.md`
- Content: CommandsComponent動作の完全理解 - Content: CommandsComponent動作の完全理解
- Source: `superclaude/commands/*.md` → `~/.claude/commands/sc/*.md` - Source: `superclaude/commands/*.md` → `~/.claude/commands/sc/*.md`
- [x] **ディレクトリ構造作成** - [x] **ディレクトリ構造作成**
- `docs/Development/tasks/` - タスク管理 - `docs/development/tasks/` - タスク管理
- `docs/patterns/` - 成功パターン記録 - `docs/patterns/` - 成功パターン記録
- `docs/mistakes/` - 失敗記録と防止策 - `docs/mistakes/` - 失敗記録と防止策
@ -58,7 +58,7 @@
- [ ] **改善提案ドキュメント作成** - [ ] **改善提案ドキュメント作成**
- Status: Pending - Status: Pending
- Action: 仮説ドキュメント作成 - Action: 仮説ドキュメント作成
- File: `docs/Development/hypothesis-pm-enhancement-2025-10-14.md` - File: `docs/development/hypothesis-pm-enhancement-2025-10-14.md`
- Content: - Content:
- 現状の問題点（ドキュメント寄り、PMO機能不足） - 現状の問題点（ドキュメント寄り、PMO機能不足）
- 改善案（自律的PDCA、自己評価） - 改善案（自律的PDCA、自己評価）
@ -130,7 +130,7 @@
- テスト時のバックアップ・復元必須 - テスト時のバックアップ・復元必須
- **ドキュメント駆動開発** - **ドキュメント駆動開発**
- 理解 → docs/Development/ に記録 - 理解 → docs/development/ に記録
- 仮説 → hypothesis-*.md - 仮説 → hypothesis-*.md
- 実験 → experiment-*.md - 実験 → experiment-*.md
- 成功 → docs/patterns/ - 成功 → docs/patterns/

332
docs/PM_AGENT.md Normal file
View File

@ -0,0 +1,332 @@
# PM Agent Implementation Status
**Last Updated**: 2025-10-14
**Version**: 1.0.0
## 📋 Overview
PM Agent has been redesigned as an **Always-Active Foundation Layer** that provides continuous context preservation, PDCA self-evaluation, and systematic knowledge management across sessions.
---
## ✅ Implemented Features
### 1. Session Lifecycle (Serena MCP Memory Integration)
**Status**: ✅ Documented (Implementation Pending)
#### Session Start Protocol
- **Auto-Activation**: PM Agent restores context at every session start
- **Memory Operations**:
- `list_memories()` → Check existing state
- `read_memory("pm_context")` → Overall project context
- `read_memory("last_session")` → Previous session summary
- `read_memory("next_actions")` → Planned next steps
- **User Report**: Automatic status report (前回/進捗/今回/課題)
**Implementation Details**: superclaude/Commands/pm.md:34-97
#### During Work (PDCA Cycle)
- **Plan Phase**: Hypothesis generation with `docs/temp/hypothesis-*.md`
- **Do Phase**: Experimentation with `docs/temp/experiment-*.md`
- **Check Phase**: Self-evaluation with `docs/temp/lessons-*.md`
- **Act Phase**: Success → `docs/patterns/` | Failure → `docs/mistakes/`
**Implementation Details**: superclaude/Commands/pm.md:56-80, superclaude/Agents/pm-agent.md:48-98
#### Session End Protocol
- **Final Checkpoint**: `think_about_whether_you_are_done()`
- **State Preservation**: `write_memory("pm_context", complete_state)`
- **Documentation Cleanup**: Temporary → Formal/Mistakes
**Implementation Details**: superclaude/Commands/pm.md:82-97, superclaude/Agents/pm-agent.md:100-135
---
### 2. PDCA Self-Evaluation Pattern
**Status**: ✅ Documented (Implementation Pending)
#### Plan (仮説生成)
- Goal definition and success criteria
- Hypothesis formulation
- Risk identification
#### Do (実験実行)
- TodoWrite task tracking
- 30-minute checkpoint saves
- Trial-and-error recording
#### Check (自己評価)
- `think_about_task_adherence()` → Pattern compliance
- `think_about_collected_information()` → Context sufficiency
- `think_about_whether_you_are_done()` → Completion verification
#### Act (改善実行)
- Success → Extract pattern → docs/patterns/
- Failure → Root cause analysis → docs/mistakes/
- Update CLAUDE.md if global pattern
**Implementation Details**: superclaude/Agents/pm-agent.md:137-175
---
### 3. Documentation Strategy (Trial-and-Error to Knowledge)
**Status**: ✅ Documented (Implementation Pending)
#### Temporary Documentation (`docs/temp/`)
- **Purpose**: Trial-and-error experimentation
- **Files**:
- `hypothesis-YYYY-MM-DD.md` → Initial plan
- `experiment-YYYY-MM-DD.md` → Implementation log
- `lessons-YYYY-MM-DD.md` → Reflections
- **Lifecycle**: 7 days → Move to formal or delete
#### Formal Documentation (`docs/patterns/`)
- **Purpose**: Successful patterns ready for reuse
- **Trigger**: Verified implementation success
- **Content**: Clean approach + concrete examples + "Last Verified" date
#### Mistake Documentation (`docs/mistakes/`)
- **Purpose**: Error records with prevention strategies
- **Structure**:
- What Happened (現象)
- Root Cause (根本原因)
- Why Missed (なぜ見逃したか)
- Fix Applied (修正内容)
- Prevention Checklist (防止策)
- Lesson Learned (教訓)
**Implementation Details**: superclaude/Agents/pm-agent.md:177-235
---
### 4. Memory Operations Reference
**Status**: ✅ Documented (Implementation Pending)
#### Memory Types
- **Session Start**: `pm_context`, `last_session`, `next_actions`
- **During Work**: `plan`, `checkpoint`, `decision`
- **Self-Evaluation**: `think_about_*` operations
- **Session End**: `last_session`, `next_actions`, `pm_context`
**Implementation Details**: superclaude/Agents/pm-agent.md:237-267
---
## 🚧 Pending Implementation
### 1. Serena MCP Memory Operations
**Required Actions**:
- [ ] Implement `list_memories()` integration
- [ ] Implement `read_memory(key)` integration
- [ ] Implement `write_memory(key, value)` integration
- [ ] Test memory persistence across sessions
**Blockers**: Requires Serena MCP server configuration
---
### 2. PDCA Think Operations
**Required Actions**:
- [ ] Implement `think_about_task_adherence()` hook
- [ ] Implement `think_about_collected_information()` hook
- [ ] Implement `think_about_whether_you_are_done()` hook
- [ ] Integrate with TodoWrite completion tracking
**Blockers**: Requires Serena MCP server configuration
---
### 3. Documentation Directory Structure
**Required Actions**:
- [ ] Create `docs/temp/` directory template
- [ ] Create `docs/patterns/` directory template
- [ ] Create `docs/mistakes/` directory template
- [ ] Implement automatic file lifecycle management (7-day cleanup)
**Blockers**: None (can be implemented immediately)
---
### 4. Auto-Activation at Session Start
**Required Actions**:
- [ ] Implement PM Agent auto-activation hook
- [ ] Integrate with Claude Code session lifecycle
- [ ] Test context restoration across sessions
- [ ] Verify "前回/進捗/今回/課題" report generation
**Blockers**: Requires understanding of Claude Code initialization hooks
---
## 📊 Implementation Roadmap
### Phase 1: Documentation Structure (Immediate)
**Timeline**: 1-2 days
**Complexity**: Low
1. Create `docs/temp/`, `docs/patterns/`, `docs/mistakes/` directories
2. Add README.md to each directory explaining purpose
3. Create template files for hypothesis/experiment/lessons
### Phase 2: Serena MCP Integration (High Priority)
**Timeline**: 1 week
**Complexity**: Medium
1. Configure Serena MCP server
2. Implement memory operations (read/write/list)
3. Test memory persistence
4. Integrate with PM Agent workflow
### Phase 3: PDCA Think Operations (High Priority)
**Timeline**: 1 week
**Complexity**: Medium
1. Implement think_about_* hooks
2. Integrate with TodoWrite
3. Test self-evaluation flow
4. Document best practices
### Phase 4: Auto-Activation (Critical)
**Timeline**: 2 weeks
**Complexity**: High
1. Research Claude Code initialization hooks
2. Implement PM Agent auto-activation
3. Test session start protocol
4. Verify context restoration
### Phase 5: Documentation Lifecycle (Medium Priority)
**Timeline**: 3-5 days
**Complexity**: Low
1. Implement 7-day temporary file cleanup
2. Create docs/temp → docs/patterns migration script
3. Create docs/temp → docs/mistakes migration script
4. Automate "Last Verified" date updates
---
## 🔍 Testing Strategy
### Unit Tests
- [ ] Memory operations (read/write/list)
- [ ] Think operations (task_adherence/collected_information/done)
- [ ] File lifecycle management (7-day cleanup)
### Integration Tests
- [ ] Session start → context restoration → user report
- [ ] PDCA cycle → temporary docs → formal docs
- [ ] Mistake detection → root cause analysis → prevention checklist
### E2E Tests
- [ ] Full session lifecycle (start → work → end)
- [ ] Cross-session context preservation
- [ ] Knowledge accumulation over time
---
## 📖 Documentation Updates Needed
### SuperClaude Framework
- [x] `superclaude/Commands/pm.md` - Updated with session lifecycle
- [x] `superclaude/Agents/pm-agent.md` - Updated with PDCA and memory operations
- [ ] `docs/ARCHITECTURE.md` - Add PM Agent architecture section
- [ ] `docs/GETTING_STARTED.md` - Add PM Agent usage examples
### Global CLAUDE.md (Future)
- [ ] Add PM Agent PDCA cycle to global rules
- [ ] Document session lifecycle best practices
- [ ] Add memory operations reference
---
## 🐛 Known Issues
### Issue 1: Serena MCP Not Configured
**Status**: Blocker
**Impact**: High (prevents memory operations)
**Resolution**: Configure Serena MCP server in project
### Issue 2: Auto-Activation Hook Unknown
**Status**: Research Needed
**Impact**: High (prevents session start automation)
**Resolution**: Research Claude Code initialization hooks
### Issue 3: Documentation Directory Structure Missing
**Status**: Can Implement Immediately
**Impact**: Medium (prevents PDCA documentation flow)
**Resolution**: Create directory structure (Phase 1)
---
## 📈 Success Metrics
### Quantitative
- **Context Restoration Rate**: 100% (sessions resume without re-explanation)
- **Documentation Coverage**: >80% (implementations documented)
- **Mistake Prevention**: <10% (recurring mistakes)
- **Session Continuity**: >90% (successful checkpoint restorations)
### Qualitative
- Users never re-explain project context
- Knowledge accumulates systematically
- Mistakes documented with prevention checklists
- Documentation stays fresh (Last Verified dates)
---
## 🎯 Next Steps
1. **Immediate**: Create documentation directory structure (Phase 1)
2. **High Priority**: Configure Serena MCP server (Phase 2)
3. **High Priority**: Implement PDCA think operations (Phase 3)
4. **Critical**: Research and implement auto-activation (Phase 4)
5. **Medium Priority**: Implement documentation lifecycle automation (Phase 5)
---
## 📚 References
- **PM Agent Command**: `superclaude/Commands/pm.md`
- **PM Agent Persona**: `superclaude/Agents/pm-agent.md`
- **Salvaged Changes**: `tmp/salvaged-pm-agent/`
- **Original Patches**: `tmp/salvaged-pm-agent/*.patch`
---
## 🔐 Commit Information
**Branch**: master
**Salvaged From**: `/Users/kazuki/.claude` (mistaken development location)
**Integration Date**: 2025-10-14
**Status**: Documentation complete, implementation pending
**Git Operations**:
```bash
# Salvaged valuable changes to tmp/
cp ~/.claude/Commands/pm.md tmp/salvaged-pm-agent/pm.md
cp ~/.claude/agents/pm-agent.md tmp/salvaged-pm-agent/pm-agent.md
git diff ~/.claude/CLAUDE.md > tmp/salvaged-pm-agent/CLAUDE.md.patch
git diff ~/.claude/RULES.md > tmp/salvaged-pm-agent/RULES.md.patch
# Cleaned up .claude directory
cd ~/.claude && git reset --hard HEAD
cd ~/.claude && rm -rf .git
# Applied changes to SuperClaude_Framework
cp tmp/salvaged-pm-agent/pm.md superclaude/Commands/pm.md
cp tmp/salvaged-pm-agent/pm-agent.md superclaude/Agents/pm-agent.md
```
---
**Last Verified**: 2025-10-14
**Next Review**: 2025-10-21 (1 week)

36
docs/README.md
View File

@ -12,7 +12,7 @@
## 🚀 Quick Start (5 Minutes) ## 🚀 Quick Start (5 Minutes)
**New Users**: [Quick Start Guide →](Getting-Started/quick-start.md) **New Users**: [Quick Start Guide →](getting-started/quick-start.md)
```bash ```bash
# Recommended for Linux/macOS # Recommended for Linux/macOS
pipx install SuperClaude && SuperClaude install pipx install SuperClaude && SuperClaude install
@ -23,37 +23,37 @@ pip install SuperClaude && SuperClaude install
# Then try: /sc:brainstorm "web app idea" in Claude Code # Then try: /sc:brainstorm "web app idea" in Claude Code
``` ```
**Having Issues**: [Quick Fixes →](Reference/common-issues.md) | [Troubleshooting →](Reference/troubleshooting.md) **Having Issues**: [Quick Fixes →](reference/common-issues.md) | [Troubleshooting →](reference/troubleshooting.md)
## 📚 Documentation Structure ## 📚 Documentation Structure
### 🌱 Start Here (New Users) ### 🌱 Start Here (New Users)
| Guide | Purpose | | Guide | Purpose |
|-------|---------| |-------|---------|
| **[Quick Start](Getting-Started/quick-start.md)** | Setup and first commands | | **[Quick Start](getting-started/quick-start.md)** | Setup and first commands |
| **[Installation](Getting-Started/installation.md)** | Detailed setup instructions | | **[Installation](getting-started/installation.md)** | Detailed setup instructions |
| **[Commands Guide](User-Guide/commands.md)** | All 21 `/sc:` commands | | **[Commands Guide](user-guide/commands.md)** | All 21 `/sc:` commands |
### 🌿 Daily Usage (Regular Users) ### 🌿 Daily Usage (Regular Users)
| Guide | Purpose | Use For | | Guide | Purpose | Use For |
|-------|---------|---------| |-------|---------|---------|
| **[Commands Guide](User-Guide/commands.md)** | Master all `/sc:` commands | Daily development | | **[Commands Guide](user-guide/commands.md)** | Master all `/sc:` commands | Daily development |
| **[Agents Guide](User-Guide/agents.md)** | 14 domain specialists (`@agent-*`) | Expert assistance | | **[Agents Guide](user-guide/agents.md)** | 14 domain specialists (`@agent-*`) | Expert assistance |
| **[Flags Guide](User-Guide/flags.md)** | Command behavior modification | Optimization | | **[Flags Guide](user-guide/flags.md)** | Command behavior modification | Optimization |
| **[Modes Guide](User-Guide/modes.md)** | 5 behavioral modes | Workflow optimization | | **[Modes Guide](user-guide/modes.md)** | 5 behavioral modes | Workflow optimization |
### 🌲 Reference & Advanced (Power Users) ### 🌲 Reference & Advanced (Power Users)
| Guide | Purpose | Use For | | Guide | Purpose | Use For |
|-------|---------|---------| |-------|---------|---------|
| **[Troubleshooting](Reference/troubleshooting.md)** | Problem resolution | When things break | | **[Troubleshooting](reference/troubleshooting.md)** | Problem resolution | When things break |
| **[Examples Cookbook](Reference/examples-cookbook.md)** | Practical usage patterns | Learning workflows | | **[Examples Cookbook](reference/examples-cookbook.md)** | Practical usage patterns | Learning workflows |
| **[MCP Servers](User-Guide/mcp-servers.md)** | 6 enhanced capabilities | Advanced features | | **[MCP Servers](user-guide/mcp-servers.md)** | 6 enhanced capabilities | Advanced features |
### 🔧 Development & Contributing ### 🔧 Development & Contributing
| Guide | Purpose | Audience | | Guide | Purpose | Audience |
|-------|---------|----------| |-------|---------|----------|
| **[Technical Architecture](Developer-Guide/technical-architecture.md)** | System design | Contributors | | **[Technical Architecture](developer-guide/technical-architecture.md)** | System design | Contributors |
| **[Contributing](Developer-Guide/contributing-code.md)** | Development workflow | Developers | | **[Contributing](developer-guide/contributing-code.md)** | Development workflow | Developers |
## 🔑 Key Concepts ## 🔑 Key Concepts
@ -112,10 +112,10 @@ User Input → Claude Code → Reads SuperClaude Context → Modified Behavior
## 🆘 Getting Help ## 🆘 Getting Help
**Quick Issues** (< 2 min): [Common Issues →](Reference/common-issues.md) **Quick Issues** (< 2 min): [Common Issues →](reference/common-issues.md)
**Complex Problems**: [Full Troubleshooting Guide →](Reference/troubleshooting.md) **Complex Problems**: [Full Troubleshooting Guide →](reference/troubleshooting.md)
**Installation Issues**: [Installation Guide →](Getting-Started/installation.md) **Installation Issues**: [Installation Guide →](getting-started/installation.md)
**Command Help**: [Commands Guide →](User-Guide/commands.md) **Command Help**: [Commands Guide →](user-guide/commands.md)
**Community Support**: [GitHub Discussions](https://github.com/SuperClaude-Org/SuperClaude_Framework/discussions) **Community Support**: [GitHub Discussions](https://github.com/SuperClaude-Org/SuperClaude_Framework/discussions)
## 🤔 Common Misconceptions Clarified ## 🤔 Common Misconceptions Clarified

0
docs/Developer-Guide/README.md → docs/developer-guide/README.md
View File

0
docs/Developer-Guide/contributing-code.md → docs/developer-guide/contributing-code.md
View File

2
docs/Developer-Guide/documentation-index.md → docs/developer-guide/documentation-index.md
View File

@ -1,4 +1,4 @@
# SuperClaude Framework Developer-Guide Index # SuperClaude Framework developer-guide Index
## Document Navigation Guide ## Document Navigation Guide

0
docs/Developer-Guide/technical-architecture.md → docs/developer-guide/technical-architecture.md
View File

0
docs/Developer-Guide/testing-debugging.md → docs/developer-guide/testing-debugging.md
View File

14
docs/Getting-Started/installation.md → docs/getting-started/installation.md
View File

@ -470,24 +470,24 @@ brew install python3
**First Week:** **First Week:**
- [Quick Start Guide](quick-start.md) - [Quick Start Guide](quick-start.md)
- [Commands Reference](../User-Guide/commands.md) - [Commands Reference](../user-guide/commands.md)
- Try `/sc:brainstorm` - Try `/sc:brainstorm`
</td> </td>
<td valign="top"> <td valign="top">
**Week 2-3:** **Week 2-3:**
- [Behavioral Modes](../User-Guide/modes.md) - [Behavioral Modes](../user-guide/modes.md)
- [Agents Guide](../User-Guide/agents.md) - [Agents Guide](../user-guide/agents.md)
- [Examples Cookbook](../Reference/examples-cookbook.md) - [Examples Cookbook](../reference/examples-cookbook.md)
</td> </td>
<td valign="top"> <td valign="top">
**Advanced:** **Advanced:**
- [MCP Servers](../User-Guide/mcp-servers.md) - [MCP Servers](../user-guide/mcp-servers.md)
- [Technical Architecture](../Developer-Guide/technical-architecture.md) - [Technical Architecture](../developer-guide/technical-architecture.md)
- [Contributing Code](../Developer-Guide/contributing-code.md) - [Contributing Code](../developer-guide/contributing-code.md)
</td> </td>
</tr> </tr>

20
docs/Getting-Started/quick-start.md → docs/getting-started/quick-start.md
View File

@ -435,8 +435,8 @@ Start simple with basic commands. Complexity emerges naturally as needed.
**First Week:** **First Week:**
- [Installation Guide](installation.md) - [Installation Guide](installation.md)
- [Commands Reference](../User-Guide/commands.md) - [Commands Reference](../user-guide/commands.md)
- [Examples Cookbook](../Reference/examples-cookbook.md) - [Examples Cookbook](../reference/examples-cookbook.md)
Start with `/sc:brainstorm` Start with `/sc:brainstorm`
@ -444,9 +444,9 @@ Start with `/sc:brainstorm`
<td valign="top"> <td valign="top">
**Growing Skills:** **Growing Skills:**
- [Behavioral Modes](../User-Guide/modes.md) - [Behavioral Modes](../user-guide/modes.md)
- [Agents Guide](../User-Guide/agents.md) - [Agents Guide](../user-guide/agents.md)
- [Session Management](../User-Guide/session-management.md) - [Session Management](../user-guide/session-management.md)
Explore mode combinations Explore mode combinations
@ -454,9 +454,9 @@ Explore mode combinations
<td valign="top"> <td valign="top">
**Expert Usage:** **Expert Usage:**
- [MCP Servers](../User-Guide/mcp-servers.md) - [MCP Servers](../user-guide/mcp-servers.md)
- [Technical Architecture](../Developer-Guide/technical-architecture.md) - [Technical Architecture](../developer-guide/technical-architecture.md)
- [Contributing](../Developer-Guide/contributing-code.md) - [Contributing](../developer-guide/contributing-code.md)
Create custom workflows Create custom workflows
@ -465,10 +465,10 @@ Create custom workflows
</table> </table>
<p align="center"> <p align="center">
<a href="../User-Guide/commands.md"> <a href="../user-guide/commands.md">
<img src="https://img.shields.io/badge/📚_Explore-All_21_Commands-blue?style=for-the-badge" alt="Commands"> <img src="https://img.shields.io/badge/📚_Explore-All_21_Commands-blue?style=for-the-badge" alt="Commands">
</a> </a>
<a href="../Reference/examples-cookbook.md"> <a href="../reference/examples-cookbook.md">
<img src="https://img.shields.io/badge/🍳_Try-Real_Examples-green?style=for-the-badge" alt="Examples"> <img src="https://img.shields.io/badge/🍳_Try-Real_Examples-green?style=for-the-badge" alt="Examples">
</a> </a>
</p> </p>

6
docs/Reference/README.md → docs/reference/README.md
View File

@ -40,7 +40,7 @@ This documentation is organized for **progressive learning** with multiple entry
**Goal**: Establish confident SuperClaude usage with essential workflows **Goal**: Establish confident SuperClaude usage with essential workflows
``` ```
Day 1-2: ../Getting-Started/quick-start.md Day 1-2: ../getting-started/quick-start.md
↓ Foundation building and first commands ↓ Foundation building and first commands
Day 3-4: basic-examples.md Day 3-4: basic-examples.md
↓ Practical application and pattern recognition ↓ Practical application and pattern recognition
@ -159,7 +159,7 @@ Advanced Analysis: diagnostic-reference.md
### Immediate Issues ### Immediate Issues
- **Command not working**: Check [common-issues.md](./common-issues.md) → Common SuperClaude Problems - **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) - **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 - **Flag confusion**: Check [basic-examples.md](./basic-examples.md) → Flag Usage Examples
### Development Blockers ### Development Blockers
@ -242,7 +242,7 @@ Found outdated information or broken examples?
--- ---
**Start Your Journey**: New to SuperClaude? Begin with [Quick Start Guide](../Getting-Started/quick-start.md) for immediate productivity gains. **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. **Need Answers Now**: Jump to [basic-examples.md](./basic-examples.md) for copy-paste solutions.

0
docs/Reference/advanced-patterns.md → docs/reference/advanced-patterns.md
View File

0
docs/Reference/advanced-workflows.md → docs/reference/advanced-workflows.md
View File

0
docs/Reference/basic-examples.md → docs/reference/basic-examples.md
View File

0
docs/Reference/claude-code-history-management.md → docs/reference/claude-code-history-management.md
View File

0
docs/Reference/common-issues.md → docs/reference/common-issues.md
View File

0
docs/Reference/diagnostic-reference.md → docs/reference/diagnostic-reference.md
View File

10
docs/Reference/examples-cookbook.md → docs/reference/examples-cookbook.md
View File

@ -95,7 +95,7 @@
## Learning Progression Roadmap ## Learning Progression Roadmap
### Phase 1: Foundation (Week 1-2) ### Phase 1: Foundation (Week 1-2)
1. **Setup**: Complete [Installation Guide](../Getting-Started/installation.md) 1. **Setup**: Complete [Installation Guide](../getting-started/installation.md)
2. **Basics**: Practice [Basic Examples](./basic-examples.md#essential-one-liner-commands) 2. **Basics**: Practice [Basic Examples](./basic-examples.md#essential-one-liner-commands)
3. **Patterns**: Learn [Basic Usage Patterns](./basic-examples.md#basic-usage-patterns) 3. **Patterns**: Learn [Basic Usage Patterns](./basic-examples.md#basic-usage-patterns)
4. **Success**: Can execute common development tasks independently 4. **Success**: Can execute common development tasks independently
@ -151,9 +151,9 @@
## Support Resources ## Support Resources
**Documentation**: **Documentation**:
- [Commands Reference](../User-Guide/commands.md) - Complete command documentation - [Commands Reference](../user-guide/commands.md) - Complete command documentation
- [Agents Guide](../User-Guide/agents.md) - Multi-agent coordination - [Agents Guide](../user-guide/agents.md) - Multi-agent coordination
- [MCP Servers](../User-Guide/mcp-servers.md) - Enhanced capabilities - [MCP Servers](../user-guide/mcp-servers.md) - Enhanced capabilities
- [Advanced Workflows](./advanced-workflows.md) - Complex coordination patterns - [Advanced Workflows](./advanced-workflows.md) - Complex coordination patterns
**Community**: **Community**:
@ -162,7 +162,7 @@
- [Contributing Guide](../CONTRIBUTING.md) - Framework contribution - [Contributing Guide](../CONTRIBUTING.md) - Framework contribution
**Advanced**: **Advanced**:
- [Technical Architecture](../Developer-Guide/technical-architecture.md) - Deep system understanding - [Technical Architecture](../developer-guide/technical-architecture.md) - Deep system understanding
- [Troubleshooting Guide](./troubleshooting.md) - Common issues and solutions - [Troubleshooting Guide](./troubleshooting.md) - Common issues and solutions
--- ---

0
docs/Reference/integration-patterns.md → docs/reference/integration-patterns.md
View File

2
docs/Reference/mcp-server-guide.md → docs/reference/mcp-server-guide.md
View File

@ -732,7 +732,7 @@ echo "Test MCP servers in Claude Code after restart"
## Related Resources ## Related Resources
### MCP-Specific Documentation ### MCP-Specific Documentation
- **Core SuperClaude Guide**: [../User-Guide/mcp-servers.md](../User-Guide/mcp-servers.md) - MCP server overview and usage - **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 - **Common Issues**: [common-issues.md](./common-issues.md) - General troubleshooting procedures
- **Diagnostic Reference**: [diagnostic-reference.md](./diagnostic-reference.md) - Advanced diagnostic procedures - **Diagnostic Reference**: [diagnostic-reference.md](./diagnostic-reference.md) - Advanced diagnostic procedures

4
docs/Reference/troubleshooting.md → docs/reference/troubleshooting.md
View File

@ -116,8 +116,8 @@ SuperClaude install --fresh
## Get Help ## Get Help
**Documentation:** **Documentation:**
- [Installation Guide](../Getting-Started/installation.md) - Setup issues - [Installation Guide](../getting-started/installation.md) - Setup issues
- [Commands Guide](../User-Guide/commands.md) - Usage issues - [Commands Guide](../user-guide/commands.md) - Usage issues
**Community:** **Community:**
- [GitHub Issues](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues) - [GitHub Issues](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues)

0
docs/Templates/__init__.py → docs/templates/__init__.py vendored
View File

146
docs/User-Guide-jp/agents.md → docs/user-guide-jp/agents.md
View File

@ -1,12 +1,12 @@
# SuperClaude エージェントガイド 🤖 # SuperClaude エージェントガイド 🤖
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#superclaude-agents-guide-) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#superclaude-agents-guide-)
SuperClaude は、Claude Code が専門知識を得るために呼び出すことができる 14 のドメイン スペシャリスト エージェントを提供します。 SuperClaude は、Claude Code が専門知識を得るために呼び出すことができる 14 のドメイン スペシャリスト エージェントを提供します。
## 🧪 エージェントのアクティベーションのテスト ## 🧪 エージェントのアクティベーションのテスト
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#-testing-agent-activation) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#-testing-agent-activation)
このガイドを使用する前に、エージェントの選択が機能することを確認してください。 このガイドを使用する前に、エージェントの選択が機能することを確認してください。
@ -37,11 +37,11 @@ SuperClaude は、Claude Code が専門知識を得るために呼び出すこ
## コアコンセプト ## コアコンセプト
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#core-concepts) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#core-concepts)
### SuperClaude エージェントとは何ですか? ### SuperClaude エージェントとは何ですか?
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#what-are-superclaude-agents) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#what-are-superclaude-agents)
**エージェントは**、Claude Codeの行動を変更するコンテキスト指示として実装された、専門分野のAIドメインエキスパートです。各エージェントは、ドメイン固有の専門知識、行動パターン、問題解決アプローチを含む、ディレクトリ`.md`内に綿密に作成されたファイルです`superclaude/Agents/`。 **エージェントは**、Claude Codeの行動を変更するコンテキスト指示として実装された、専門分野のAIドメインエキスパートです。各エージェントは、ドメイン固有の専門知識、行動パターン、問題解決アプローチを含む、ディレクトリ`.md`内に綿密に作成されたファイルです`superclaude/Agents/`。
@ -49,11 +49,11 @@ SuperClaude は、Claude Code が専門知識を得るために呼び出すこ
### エージェントの2つの使用方法 ### エージェントの2つの使用方法
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#two-ways-to-use-agents) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#two-ways-to-use-agents)
#### 1. @agent- プレフィックスを使用した手動呼び出し #### 1. @agent- プレフィックスを使用した手動呼び出し
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#1-manual-invocation-with-agent--prefix) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#1-manual-invocation-with-agent--prefix)
```shell ```shell
# Directly invoke a specific agent # Directly invoke a specific agent
@ -64,7 +64,7 @@ SuperClaude は、Claude Code が専門知識を得るために呼び出すこ
#### 2. 自動アクティベーション（行動ルーティング） #### 2. 自動アクティベーション（行動ルーティング）
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#2-auto-activation-behavioral-routing) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#2-auto-activation-behavioral-routing)
「自動アクティベーション」とは、Claude Codeがリクエスト内のキーワードとパターンに基づいて適切なコンテキストで動作指示を読み取り、エンゲージすることを意味します。SuperClaudeは、Claudeが最適なスペシャリストにルーティングするための動作ガイドラインを提供します。 「自動アクティベーション」とは、Claude Codeがリクエスト内のキーワードとパターンに基づいて適切なコンテキストで動作指示を読み取り、エンゲージすることを意味します。SuperClaudeは、Claudeが最適なスペシャリストにルーティングするための動作ガイドラインを提供します。
@ -83,7 +83,7 @@ SuperClaude は、Claude Code が専門知識を得るために呼び出すこ
### エージェント選択ルール ### エージェント選択ルール
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#agent-selection-rules) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#agent-selection-rules)
**優先順位の階層:** **優先順位の階層:**
@ -115,11 +115,11 @@ Task Analysis →
## クイックスタートの例 ## クイックスタートの例
[](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#quick-start-examples)
### 手動エージェント呼び出し ### 手動エージェント呼び出し
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#manual-agent-invocation) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#manual-agent-invocation)
```shell ```shell
# Explicitly call specific agents with @agent- prefix # Explicitly call specific agents with @agent- prefix
@ -131,7 +131,7 @@ Task Analysis →
### 自動エージェント調整 ### 自動エージェント調整
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#automatic-agent-coordination) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#automatic-agent-coordination)
```shell ```shell
# Commands that trigger auto-activation # Commands that trigger auto-activation
@ -150,7 +150,7 @@ Task Analysis →
### 手動と自動のアプローチを組み合わせる ### 手動と自動のアプローチを組み合わせる
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#combining-manual-and-auto-approaches) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#combining-manual-and-auto-approaches)
```shell ```shell
# Start with command (auto-activation) # Start with command (auto-activation)
@ -165,15 +165,15 @@ Task Analysis →
## SuperClaude エージェントチーム 👥 ## 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#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#architecture--system-design-agents-%EF%B8%8F)
### システムアーキテクト 🏢 ### システムアーキテクト 🏢
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#system-architect-) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#system-architect-)
**専門分野**：スケーラビリティとサービスアーキテクチャに重点を置いた大規模分散システム設計 **専門分野**：スケーラビリティとサービスアーキテクチャに重点を置いた大規模分散システム設計
@ -199,7 +199,7 @@ Task Analysis →
### 成功基準 ### 成功基準
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#success-criteria) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#success-criteria)
- [ ] 応答に表れたシステムレベルの思考 - [ ] 応答に表れたシステムレベルの思考
- [ ] サービスの境界と統合パターンについて言及する - [ ] サービスの境界と統合パターンについて言及する
@ -216,7 +216,7 @@ Task Analysis →
### バックエンドアーキテクト ⚙️ ### バックエンドアーキテクト ⚙️
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#backend-architect-%EF%B8%8F) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#backend-architect-%EF%B8%8F)
**専門分野**: APIの信頼性とデータの整合性を重視した堅牢なサーバーサイドシステム設計 **専門分野**: APIの信頼性とデータの整合性を重視した堅牢なサーバーサイドシステム設計
@ -246,7 +246,7 @@ Task Analysis →
### フロントエンドアーキテクト 🎨 ### フロントエンドアーキテクト 🎨
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#frontend-architect-) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#frontend-architect-)
**専門分野**: アクセシビリティとユーザーエクスペリエンスを重視した最新の Web アプリケーション アーキテクチャ **専門分野**: アクセシビリティとユーザーエクスペリエンスを重視した最新の Web アプリケーション アーキテクチャ
@ -276,7 +276,7 @@ Task Analysis →
### DevOps アーキテクト 🚀 ### DevOps アーキテクト 🚀
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#devops-architect-) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#devops-architect-)
**専門分野**: 信頼性の高いソフトウェア配信のためのインフラストラクチャ自動化と展開パイプライン設計 **専門分野**: 信頼性の高いソフトウェア配信のためのインフラストラクチャ自動化と展開パイプライン設計
@ -304,11 +304,11 @@ Task Analysis →
### 品質・分析エージェント 🔍 ### 品質・分析エージェント 🔍
[](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#quality--analysis-agents-)
### セキュリティエンジニア 🔒 ### セキュリティエンジニア 🔒
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#security-engineer-) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#security-engineer-)
**専門分野**: 脅威モデリングと脆弱性防止に重点を置いたアプリケーション セキュリティ アーキテクチャ **専門分野**: 脅威モデリングと脆弱性防止に重点を置いたアプリケーション セキュリティ アーキテクチャ
@ -338,7 +338,7 @@ Task Analysis →
### パフォーマンスエンジニア ⚡ ### パフォーマンスエンジニア ⚡
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#performance-engineer-) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#performance-engineer-)
**専門分野**：スケーラビリティとリソース効率を重視したシステムパフォーマンスの最適化 **専門分野**：スケーラビリティとリソース効率を重視したシステムパフォーマンスの最適化
@ -368,7 +368,7 @@ Task Analysis →
### 根本原因分析者 🔍 ### 根本原因分析者 🔍
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#root-cause-analyst-) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#root-cause-analyst-)
**専門分野**：証拠に基づく分析と仮説検定を用いた体系的な問題調査 **専門分野**：証拠に基づく分析と仮説検定を用いた体系的な問題調査
@ -398,7 +398,7 @@ Task Analysis →
### 品質エンジニア ✅ ### 品質エンジニア ✅
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#quality-engineer-) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#quality-engineer-)
**専門分野**:自動化とカバレッジに重点を置いた包括的なテスト戦略と品質保証 **専門分野**:自動化とカバレッジに重点を置いた包括的なテスト戦略と品質保証
@ -428,7 +428,7 @@ Task Analysis →
### リファクタリングの専門家 🔧 ### リファクタリングの専門家 🔧
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#refactoring-expert-) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#refactoring-expert-)
**専門分野**：体系的なリファクタリングと技術的負債管理によるコード品質の改善 **専門分野**：体系的なリファクタリングと技術的負債管理によるコード品質の改善
@ -456,11 +456,11 @@ Task Analysis →
### 専門開発エージェント 🎯 ### 専門開発エージェント 🎯
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#specialized-development-agents-) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#specialized-development-agents-)
### Python エキスパート 🐍 ### Python エキスパート 🐍
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#python-expert-) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#python-expert-)
**専門分野**: 最新のフレームワークとパフォーマンスを重視した、本番環境対応の Python 開発 **専門分野**: 最新のフレームワークとパフォーマンスを重視した、本番環境対応の Python 開発
@ -490,7 +490,7 @@ Task Analysis →
### 要件アナリスト 📝 ### 要件アナリスト 📝
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#requirements-analyst-) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#requirements-analyst-)
**専門分野**：体系的なステークホルダー分析による要件発見と仕様策定 **専門分野**：体系的なステークホルダー分析による要件発見と仕様策定
@ -518,11 +518,11 @@ Task Analysis →
### コミュニケーションと学習エージェント 📚 ### コミュニケーションと学習エージェント 📚
[](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#communication--learning-agents-)
### テクニカルライター 📚 ### テクニカルライター 📚
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#technical-writer-) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#technical-writer-)
**専門分野**: 視聴者分析と明確さを重視した技術文書作成とコミュニケーション **専門分野**: 視聴者分析と明確さを重視した技術文書作成とコミュニケーション
@ -552,7 +552,7 @@ Task Analysis →
### 学習ガイド 🎓 ### 学習ガイド 🎓
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#learning-guide-) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#learning-guide-)
**専門分野**：スキル開発とメンターシップに重点を置いた教育コンテンツの設計と漸進的学習 **専門分野**：スキル開発とメンターシップに重点を置いた教育コンテンツの設計と漸進的学習
@ -582,11 +582,11 @@ Task Analysis →
## エージェントの調整と統合 🤝 ## エージェントの調整と統合 🤝
[](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#agent-coordination--integration-)
### 調整パターン ### 調整パターン
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#coordination-patterns) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#coordination-patterns)
**アーキテクチャチーム**: **アーキテクチャチーム**:
@ -608,7 +608,7 @@ Task Analysis →
### MCP サーバー統合 ### MCP サーバー統合
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#mcp-server-integration) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#mcp-server-integration)
**MCP サーバーによる拡張機能**: **MCP サーバーによる拡張機能**:
@ -621,20 +621,20 @@ Task Analysis →
### エージェントのアクティベーションのトラブルシューティング ### エージェントのアクティベーションのトラブルシューティング
[](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-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/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/common-issues.md)- よくある問題に対するクイック修正
- [トラブルシューティングガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Reference/troubleshooting.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) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#common-issues)
- **エージェントのアクティベーションなし**: ドメインキーワード「セキュリティ」、「パフォーマンス」、「フロントエンド」を使用します - **エージェントのアクティベーションなし**: ドメインキーワード「セキュリティ」、「パフォーマンス」、「フロントエンド」を使用します
- **間違ったエージェントが選択されました**: エージェントのドキュメントでトリガーキーワードを確認してください - **間違ったエージェントが選択されました**: エージェントのドキュメントでトリガーキーワードを確認してください
@ -644,7 +644,7 @@ Task Analysis →
### 即時修正 ### 即時修正
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#immediate-fixes) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#immediate-fixes)
- **エージェントの強制アクティベーション**: リクエストで明示的なドメインキーワードを使用する - **エージェントの強制アクティベーション**: リクエストで明示的なドメインキーワードを使用する
- **エージェントの選択をリセット**: エージェントの状態をリセットするには、Claude Code セッションを再起動します。 - **エージェントの選択をリセット**: エージェントの状態をリセットするには、Claude Code セッションを再起動します。
@ -653,7 +653,7 @@ Task Analysis →
### エージェント固有のトラブルシューティング ### エージェント固有のトラブルシューティング
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#agent-specific-troubleshooting) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#agent-specific-troubleshooting)
**セキュリティエージェントなし:** **セキュリティエージェントなし:**
@ -697,7 +697,7 @@ Task Analysis →
### サポートレベル ### サポートレベル
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#support-levels) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#support-levels)
**クイックフィックス:** **クイックフィックス:**
@ -707,13 +707,13 @@ Task Analysis →
**詳細なヘルプ:** **詳細なヘルプ:**
- エージェントのインストールに関する問題については、[一般的な問題ガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Reference/common-issues.md)を参照してください。 - エージェントのインストールに関する問題については、[一般的な問題ガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/reference/common-issues.md)を参照してください。
- 対象エージェントのトリガーキーワードを確認する - 対象エージェントのトリガーキーワードを確認する
**専門家によるサポート:** **専門家によるサポート:**
- 使用`SuperClaude install --diagnose` - 使用`SuperClaude install --diagnose`
- 協調分析については[診断リファレンスガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Reference/diagnostic-reference.md)を参照してください - 協調分析については[診断リファレンスガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/reference/diagnostic-reference.md)を参照してください
**コミュニティサポート:** **コミュニティサポート:**
@ -722,7 +722,7 @@ Task Analysis →
### 成功の検証 ### 成功の検証
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#success-validation) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#success-validation)
エージェントの修正を適用した後、次のようにテストします。 エージェントの修正を適用した後、次のようにテストします。
@ -734,7 +734,7 @@ Task Analysis →
## クイックトラブルシューティング（レガシー） ## クイックトラブルシューティング（レガシー）
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#quick-troubleshooting-legacy) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#quick-troubleshooting-legacy)
- **エージェントが有効化されていない場合**→ ドメインキーワード「セキュリティ」、「パフォーマンス」、「フロントエンド」を使用します - **エージェントが有効化されていない場合**→ ドメインキーワード「セキュリティ」、「パフォーマンス」、「フロントエンド」を使用します
- **エージェントが間違っている**→ エージェントのドキュメントでトリガーキーワードを確認してください - **エージェントが間違っている**→ エージェントのドキュメントでトリガーキーワードを確認してください
@ -762,11 +762,11 @@ Task Analysis →
## クイックリファレンス 📋 ## クイックリファレンス 📋
[](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#quick-reference-)
### エージェントトリガー検索 ### エージェントトリガー検索
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#agent-trigger-lookup) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#agent-trigger-lookup)
|トリガータイプ|キーワード/パターン|活性化エージェント| |トリガータイプ|キーワード/パターン|活性化エージェント|
|---|---|---| |---|---|---|
@ -786,7 +786,7 @@ Task Analysis →
### コマンドエージェントマッピング ### コマンドエージェントマッピング
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#command-agent-mapping) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#command-agent-mapping)
|指示|主な薬剤|サポートエージェント| |指示|主な薬剤|サポートエージェント|
|---|---|---| |---|---|---|
@ -801,7 +801,7 @@ Task Analysis →
### 効果的な薬剤の組み合わせ ### 効果的な薬剤の組み合わせ
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#effective-agent-combinations) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#effective-agent-combinations)
**開発ワークフロー**: **開発ワークフロー**:
@ -822,11 +822,11 @@ Task Analysis →
## ベストプラクティス💡 ## ベストプラクティス💡
[](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#best-practices-)
### はじめに（シンプルなアプローチ） ### はじめに（シンプルなアプローチ）
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#getting-started-simple-approach) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#getting-started-simple-approach)
**自然言語ファースト:** **自然言語ファースト:**
@ -837,7 +837,7 @@ Task Analysis →
### エージェントの選択の最適化 ### エージェントの選択の最適化
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#optimizing-agent-selection) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#optimizing-agent-selection)
**効果的なキーワードの使用法:** **効果的なキーワードの使用法:**
@ -859,7 +859,7 @@ Task Analysis →
### 一般的な使用パターン ### 一般的な使用パターン
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#common-usage-patterns) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#common-usage-patterns)
**開発ワークフロー:** **開発ワークフロー:**
@ -895,7 +895,7 @@ Task Analysis →
### 高度なエージェント調整 ### 高度なエージェント調整
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#advanced-agent-coordination) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#advanced-agent-coordination)
**マルチドメインプロジェクト:** **マルチドメインプロジェクト:**
@ -923,7 +923,7 @@ Task Analysis →
### 品質重視の開発 ### 品質重視の開発
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#quality-driven-development) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#quality-driven-development)
**セキュリティ第一のアプローチ:** 開発リクエストには常にセキュリティに関する考慮事項を含め、ドメインスペシャリストとともにセキュリティエンジニアを自動的に関与させます。 **セキュリティ第一のアプローチ:** 開発リクエストには常にセキュリティに関する考慮事項を含め、ドメインスペシャリストとともにセキュリティエンジニアを自動的に関与させます。
@ -937,11 +937,11 @@ Task Analysis →
## エージェントインテリジェンスを理解する🧠 ## エージェントインテリジェンスを理解する🧠
[](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#understanding-agent-intelligence-)
### エージェントを効果的にする要素 ### エージェントを効果的にする要素
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#what-makes-agents-effective) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#what-makes-agents-effective)
**ドメイン専門知識**: 各エージェントは、それぞれのドメインに特有の専門的な知識パターン、行動アプローチ、問題解決方法論を備えています。 **ドメイン専門知識**: 各エージェントは、それぞれのドメインに特有の専門的な知識パターン、行動アプローチ、問題解決方法論を備えています。
@ -953,7 +953,7 @@ Task Analysis →
### エージェント vs. 従来のAI ### エージェント vs. 従来のAI
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#agent-vs-traditional-ai) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#agent-vs-traditional-ai)
**従来のアプローチ**: 単一のAIが、さまざまなレベルの専門知識を持つすべてのドメインを処理します。 **エージェントアプローチ**: 専門のエキスパートが、深いドメイン知識と集中的な問題解決で協力します。 **従来のアプローチ**: 単一のAIが、さまざまなレベルの専門知識を持つすべてのドメインを処理します。 **エージェントアプローチ**: 専門のエキスパートが、深いドメイン知識と集中的な問題解決で協力します。
@ -966,7 +966,7 @@ Task Analysis →
### システムを信頼し、パターンを理解する ### システムを信頼し、パターンを理解する
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#trust-the-system-understand-the-patterns) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#trust-the-system-understand-the-patterns)
**期待すること**: **期待すること**:
@ -986,36 +986,36 @@ Task Analysis →
## 関連リソース 📚 ## 関連リソース 📚
[](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#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/agents.md#essential-documentation)
- **[コマンドガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md)**- 最適なエージェント調整をトリガーするSuperClaudeコマンドをマスターする - **[コマンドガイド](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)**- 専用ツールの統合によるエージェント機能の強化 - **[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/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/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/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/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/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/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/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/developer-guide/contributing-code.md)**- エージェントの機能と調整パターンの拡張
--- ---
## エージェントとしての道のり 🚀 ## エージェントとしての道のり 🚀
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#your-agent-journey-) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#your-agent-journey-)
**第1週：自然な使用法** 自然な言語による説明から始めましょう。どのエージェントが、そしてなぜアクティブになるのかに注目しましょう。プロセスを考えすぎずに、キーワードのパターンに対する直感を養います。 **第1週：自然な使用法** 自然な言語による説明から始めましょう。どのエージェントが、そしてなぜアクティブになるのかに注目しましょう。プロセスを考えすぎずに、キーワードのパターンに対する直感を養います。

94
docs/User-Guide-jp/commands.md → docs/user-guide-jp/commands.md
View File

@ -1,12 +1,12 @@
# SuperClaude コマンドガイド # SuperClaude コマンドガイド
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#superclaude-commands-guide) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#superclaude-commands-guide)
`/sc:*`SuperClaude は、ワークフロー用コマンドと`@agent-*`スペシャリスト用コマンドの 21 個の Claude Code コマンドを提供します。 `/sc:*`SuperClaude は、ワークフロー用コマンドと`@agent-*`スペシャリスト用コマンドの 21 個の Claude Code コマンドを提供します。
## コマンドの種類 ## コマンドの種類
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#command-types) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#command-types)
|タイプ|使用場所|形式|例| |タイプ|使用場所|形式|例|
|---|---|---|---| |---|---|---|---|
@ -16,7 +16,7 @@
## クイックテスト ## クイックテスト
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#quick-test) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#quick-test)
```shell ```shell
# Terminal: Verify installation # Terminal: Verify installation
@ -32,11 +32,11 @@ python3 -m SuperClaude --version
## 🎯 SuperClaude コマンドの理解 ## 🎯 SuperClaude コマンドの理解
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#-understanding-superclaude-commands) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#-understanding-superclaude-commands)
## SuperClaudeの仕組み ## SuperClaudeの仕組み
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#how-superclaude-works) [](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 Code が特殊な動作を実行するために読み込む動作コンテキストファイルを提供します。 と入力すると`/sc:implement`、Claude Code は`implement.md`コンテキストファイルを読み込み、その動作指示に従います。
@ -44,7 +44,7 @@ SuperClaude は、Claude Code が特殊な動作を実行するために読み
### コマンドの種類: ### コマンドの種類:
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#command-types-1) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#command-types-1)
- **スラッシュコマンド**（`/sc:*`）：ワークフローパターンと動作​​モードをトリガーする - **スラッシュコマンド**（`/sc:*`）：ワークフローパターンと動作​​モードをトリガーする
- **エージェントの呼び出し**（`@agent-*`）：特定のドメインスペシャリストを手動で起動する - **エージェントの呼び出し**（`@agent-*`）：特定のドメインスペシャリストを手動で起動する
@ -52,7 +52,7 @@ SuperClaude は、Claude Code が特殊な動作を実行するために読み
### コンテキストメカニズム: ### コンテキストメカニズム:
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#the-context-mechanism) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#the-context-mechanism)
1. **ユーザー入力**: 入力する`/sc:implement "auth system"` 1. **ユーザー入力**: 入力する`/sc:implement "auth system"`
2. **コンテキスト読み込み**: クロードコード読み取り`~/.claude/superclaude/Commands/implement.md` 2. **コンテキスト読み込み**: クロードコード読み取り`~/.claude/superclaude/Commands/implement.md`
@ -63,7 +63,7 @@ SuperClaude は、Claude Code が特殊な動作を実行するために読み
### インストールコマンドと使用コマンド ### インストールコマンドと使用コマンド
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#installation-vs-usage-commands) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#installation-vs-usage-commands)
**🖥️ ターミナルコマンド**（実際の CLI ソフトウェア）： **🖥️ ターミナルコマンド**（実際の CLI ソフトウェア）：
@ -83,11 +83,11 @@ SuperClaude は、Claude Code が特殊な動作を実行するために読み
## 🧪 セットアップのテスト ## 🧪 セットアップのテスト
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#-testing-your-setup) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#-testing-your-setup)
### 🖥️ ターミナル検証（ターミナル/CMDで実行） ### 🖥️ ターミナル検証（ターミナル/CMDで実行）
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#%EF%B8%8F-terminal-verification-run-in-terminalcmd) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#%EF%B8%8F-terminal-verification-run-in-terminalcmd)
```shell ```shell
# Verify SuperClaude is working (primary method) # Verify SuperClaude is working (primary method)
@ -104,7 +104,7 @@ python3 -m SuperClaude install --list-components | grep mcp
### 💬 クロードコードテスト（クロードコードチャットに入力） ### 💬 クロードコードテスト（クロードコードチャットに入力）
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#-claude-code-testing-type-in-claude-code-chat) [](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 # Test basic /sc: command
@ -116,11 +116,11 @@ python3 -m SuperClaude install --list-components | grep mcp
# Example behavior: List of available commands # 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/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) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#-command-quick-reference)
|コマンドタイプ|走る場所|形式|目的|例| |コマンドタイプ|走る場所|形式|目的|例|
|---|---|---|---|---| |---|---|---|---|---|
@ -134,25 +134,25 @@ python3 -m SuperClaude install --list-components | grep mcp
## 目次 ## 目次
[](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#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#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#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#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#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#command-index)- カテゴリ別にコマンドを検索
--- ---
## 必須コマンド ## 必須コマンド
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#essential-commands) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#essential-commands)
**即時の生産性向上のためのコアワークフロー コマンド:** **即時の生産性向上のためのコアワークフロー コマンド:**
### `/sc:brainstorm`- プロジェクト発見 ### `/sc:brainstorm`- プロジェクト発見
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#scbrainstorm---project-discovery) [](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 "your idea"` `[--strategy systematic|creative]`
@ -165,7 +165,7 @@ python3 -m SuperClaude install --list-components | grep mcp
### `/sc:implement`- 機能開発 ### `/sc:implement`- 機能開発
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#scimplement---feature-development) [](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 "feature description"` `[--type frontend|backend|fullstack] [--focus security|performance]`
@ -179,7 +179,7 @@ python3 -m SuperClaude install --list-components | grep mcp
### `/sc:analyze`- コード評価 ### `/sc:analyze`- コード評価
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#scanalyze---code-assessment) [](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 [path]` `[--focus quality|security|performance|architecture]`
@ -192,7 +192,7 @@ python3 -m SuperClaude install --list-components | grep mcp
### `/sc:troubleshoot`- 問題診断 ### `/sc:troubleshoot`- 問題診断
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#sctroubleshoot---problem-diagnosis) [](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 "issue description"` `[--type build|runtime|performance]`
@ -205,7 +205,7 @@ python3 -m SuperClaude install --list-components | grep mcp
### `/sc:test`- 品質保証 ### `/sc:test`- 品質保証
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#sctest---quality-assurance) [](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` `[--type unit|integration|e2e] [--coverage] [--fix]`
@ -218,7 +218,7 @@ python3 -m SuperClaude install --list-components | grep mcp
### `/sc:improve`- コード強化 ### `/sc:improve`- コード強化
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#scimprove---code-enhancement) [](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 [path]` `[--type performance|quality|security] [--preview]`
@ -231,7 +231,7 @@ python3 -m SuperClaude install --list-components | grep mcp
### `/sc:document`- ドキュメント生成 ### `/sc:document`- ドキュメント生成
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#scdocument---documentation-generation) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#scdocument---documentation-generation)
**目的**: コードとAPIの包括的なドキュメントを生成する **目的**: コードとAPIの包括的なドキュメントを生成する
**構文**:`/sc:document [path]` `[--type api|user-guide|technical] [--format markdown|html]` **構文**:`/sc:document [path]` `[--type api|user-guide|technical] [--format markdown|html]`
@ -244,7 +244,7 @@ python3 -m SuperClaude install --list-components | grep mcp
### `/sc:workflow`- 実装計画 ### `/sc:workflow`- 実装計画
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#scworkflow---implementation-planning) [](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 "feature description"` `[--strategy agile|waterfall] [--format markdown]`
@ -259,13 +259,13 @@ python3 -m SuperClaude install --list-components | grep mcp
## 一般的なワークフロー ## 一般的なワークフロー
[](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#common-workflows)
**実証済みのコマンドの組み合わせ:** **実証済みのコマンドの組み合わせ:**
### 新しいプロジェクトのセットアップ ### 新しいプロジェクトのセットアップ
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#new-project-setup) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#new-project-setup)
```shell ```shell
/sc:brainstorm "project concept" # Define requirements /sc:brainstorm "project concept" # Define requirements
@ -275,7 +275,7 @@ python3 -m SuperClaude install --list-components | grep mcp
### 機能開発 ### 機能開発
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#feature-development) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#feature-development)
```shell ```shell
/sc:implement "feature name" # Build the feature /sc:implement "feature name" # Build the feature
@ -285,7 +285,7 @@ python3 -m SuperClaude install --list-components | grep mcp
### コード品質の改善 ### コード品質の改善
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#code-quality-improvement) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#code-quality-improvement)
```shell ```shell
/sc:analyze --focus quality # Assess current state /sc:analyze --focus quality # Assess current state
@ -295,7 +295,7 @@ python3 -m SuperClaude install --list-components | grep mcp
### バグ調査 ### バグ調査
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#bug-investigation) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#bug-investigation)
```shell ```shell
/sc:troubleshoot "issue description" # Diagnose the problem /sc:troubleshoot "issue description" # Diagnose the problem
@ -305,11 +305,11 @@ python3 -m SuperClaude install --list-components | grep mcp
## 完全なコマンドリファレンス ## 完全なコマンドリファレンス
[](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#full-command-reference)
### 開発コマンド ### 開発コマンド
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#development-commands) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#development-commands)
|指示|目的|最適な用途| |指示|目的|最適な用途|
|---|---|---| |---|---|---|
@ -320,7 +320,7 @@ python3 -m SuperClaude install --list-components | grep mcp
### 分析コマンド ### 分析コマンド
[](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#analysis-commands)
|指示|目的|最適な用途| |指示|目的|最適な用途|
|---|---|---| |---|---|---|
@ -330,7 +330,7 @@ python3 -m SuperClaude install --list-components | grep mcp
### 品質コマンド ### 品質コマンド
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#quality-commands) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#quality-commands)
|指示|目的|最適な用途| |指示|目的|最適な用途|
|---|---|---| |---|---|---|
@ -341,7 +341,7 @@ python3 -m SuperClaude install --list-components | grep mcp
### プロジェクト管理 ### プロジェクト管理
[](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#project-management)
|指示|目的|最適な用途| |指示|目的|最適な用途|
|---|---|---| |---|---|---|
@ -351,7 +351,7 @@ python3 -m SuperClaude install --list-components | grep mcp
### ユーティリティコマンド ### ユーティリティコマンド
[](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#utility-commands)
|指示|目的|最適な用途| |指示|目的|最適な用途|
|---|---|---| |---|---|---|
@ -360,7 +360,7 @@ python3 -m SuperClaude install --list-components | grep mcp
### セッションコマンド ### セッションコマンド
[](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#session-commands)
|指示|目的|最適な用途| |指示|目的|最適な用途|
|---|---|---| |---|---|---|
@ -373,7 +373,7 @@ python3 -m SuperClaude install --list-components | grep mcp
## コマンドインデックス ## コマンドインデックス
[](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#command-index)
**機能別:** **機能別:**
@ -392,7 +392,7 @@ python3 -m SuperClaude install --list-components | grep mcp
## トラブルシューティング ## トラブルシューティング
[](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#troubleshooting)
**コマンドの問題:** **コマンドの問題:**
@ -404,12 +404,12 @@ python3 -m SuperClaude install --list-components | grep mcp
- セッションをリセット:`/sc:load`再初期化する - セッションをリセット:`/sc:load`再初期化する
- ステータスを確認:`SuperClaude install --list-components` - ステータスを確認:`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/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/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/flags.md)- コマンドの動作を制御する
- [エージェントガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.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)- 実際の使用パターン - [例のクックブック](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/reference/examples-cookbook.md)- 実際の使用パターン

90
docs/User-Guide-jp/flags.md → docs/user-guide-jp/flags.md
View File

@ -1,16 +1,16 @@
# SuperClaude フラグガイド 🏁 # SuperClaude フラグガイド 🏁
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#superclaude-flags-guide-) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#superclaude-flags-guide-)
**ほとんどのフラグは自動的にアクティブになります**。Claude Code は、リクエスト内のキーワードとパターンに基づいて適切なコンテキストを実行するための動作指示を読み取ります。 **ほとんどのフラグは自動的にアクティブになります**。Claude Code は、リクエスト内のキーワードとパターンに基づいて適切なコンテキストを実行するための動作指示を読み取ります。
## 必須の自動アクティベーションフラグ（ユースケースの90%） ## 必須の自動アクティベーションフラグ（ユースケースの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#essential-auto-activation-flags-90-of-use-cases)
### コア分析フラグ ### コア分析フラグ
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#core-analysis-flags) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#core-analysis-flags)
|フラグ|起動時|何をするのか| |フラグ|起動時|何をするのか|
|---|---|---| |---|---|---|
@ -20,7 +20,7 @@
### MCP サーバーフラグ ### MCP サーバーフラグ
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#mcp-server-flags) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#mcp-server-flags)
|フラグ|サーバ|目的|自動トリガー| |フラグ|サーバ|目的|自動トリガー|
|---|---|---|---| |---|---|---|---|
@ -33,7 +33,7 @@
### 動作モードフラグ ### 動作モードフラグ
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#behavioral-mode-flags) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#behavioral-mode-flags)
|フラグ|起動時|何をするのか| |フラグ|起動時|何をするのか|
|---|---|---| |---|---|---|
@ -45,7 +45,7 @@
### 実行制御フラグ ### 実行制御フラグ
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#execution-control-flags) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#execution-control-flags)
|フラグ|起動時|何をするのか| |フラグ|起動時|何をするのか|
|---|---|---| |---|---|---|
@ -56,11 +56,11 @@
## コマンド固有のフラグ ## コマンド固有のフラグ
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#command-specific-flags) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#command-specific-flags)
### 分析コマンドフラグ（`/sc:analyze`） ### 分析コマンドフラグ（`/sc:analyze`）
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#analysis-command-flags-scanalyze) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#analysis-command-flags-scanalyze)
|フラグ|目的|価値観| |フラグ|目的|価値観|
|---|---|---| |---|---|---|
@ -70,7 +70,7 @@
### ビルドコマンドフラグ（`/sc:build`） ### ビルドコマンドフラグ（`/sc:build`）
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#build-command-flags-scbuild) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#build-command-flags-scbuild)
|フラグ|目的|価値観| |フラグ|目的|価値観|
|---|---|---| |---|---|---|
@ -81,7 +81,7 @@
### 設計コマンドフラグ（`/sc:design`） ### 設計コマンドフラグ（`/sc:design`）
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#design-command-flags-scdesign) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#design-command-flags-scdesign)
|フラグ|目的|価値観| |フラグ|目的|価値観|
|---|---|---| |---|---|---|
@ -90,7 +90,7 @@
### コマンドフラグの説明（`/sc:explain`） ### コマンドフラグの説明（`/sc:explain`）
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#explain-command-flags-scexplain) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#explain-command-flags-scexplain)
|フラグ|目的|価値観| |フラグ|目的|価値観|
|---|---|---| |---|---|---|
@ -100,7 +100,7 @@
### コマンドフラグの改善（`/sc:improve`） ### コマンドフラグの改善（`/sc:improve`）
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#improve-command-flags-scimprove) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#improve-command-flags-scimprove)
|フラグ|目的|価値観| |フラグ|目的|価値観|
|---|---|---| |---|---|---|
@ -111,7 +111,7 @@
### タスクコマンドフラグ（`/sc:task`） ### タスクコマンドフラグ（`/sc:task`）
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#task-command-flags-sctask) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#task-command-flags-sctask)
|フラグ|目的|価値観| |フラグ|目的|価値観|
|---|---|---| |---|---|---|
@ -121,7 +121,7 @@
### ワークフローコマンドフラグ（`/sc:workflow`） ### ワークフローコマンドフラグ（`/sc:workflow`）
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#workflow-command-flags-scworkflow) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#workflow-command-flags-scworkflow)
|フラグ|目的|価値観| |フラグ|目的|価値観|
|---|---|---| |---|---|---|
@ -131,7 +131,7 @@
### コマンドフラグのトラブルシューティング ( `/sc:troubleshoot`) ### コマンドフラグのトラブルシューティング ( `/sc:troubleshoot`)
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#troubleshoot-command-flags-sctroubleshoot) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#troubleshoot-command-flags-sctroubleshoot)
|フラグ|目的|価値観| |フラグ|目的|価値観|
|---|---|---| |---|---|---|
@ -141,7 +141,7 @@
### クリーンアップコマンドフラグ（`/sc:cleanup`） ### クリーンアップコマンドフラグ（`/sc:cleanup`）
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#cleanup-command-flags-sccleanup) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#cleanup-command-flags-sccleanup)
|フラグ|目的|価値観| |フラグ|目的|価値観|
|---|---|---| |---|---|---|
@ -152,7 +152,7 @@
### コマンドフラグの推定（`/sc:estimate`） ### コマンドフラグの推定（`/sc:estimate`）
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#estimate-command-flags-scestimate) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#estimate-command-flags-scestimate)
|フラグ|目的|価値観| |フラグ|目的|価値観|
|---|---|---| |---|---|---|
@ -162,7 +162,7 @@
### インデックスコマンドフラグ（`/sc:index`） ### インデックスコマンドフラグ（`/sc:index`）
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#index-command-flags-scindex) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#index-command-flags-scindex)
|フラグ|目的|価値観| |フラグ|目的|価値観|
|---|---|---| |---|---|---|
@ -171,7 +171,7 @@
### コマンドフラグを反映する ( `/sc:reflect`) ### コマンドフラグを反映する ( `/sc:reflect`)
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#reflect-command-flags-screflect) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#reflect-command-flags-screflect)
|フラグ|目的|価値観| |フラグ|目的|価値観|
|---|---|---| |---|---|---|
@ -181,7 +181,7 @@
### スポーンコマンドフラグ（`/sc:spawn`） ### スポーンコマンドフラグ（`/sc:spawn`）
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#spawn-command-flags-scspawn) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#spawn-command-flags-scspawn)
|フラグ|目的|価値観| |フラグ|目的|価値観|
|---|---|---| |---|---|---|
@ -190,7 +190,7 @@
### Gitコマンドフラグ（`/sc:git`） ### Gitコマンドフラグ（`/sc:git`）
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#git-command-flags-scgit) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#git-command-flags-scgit)
|フラグ|目的|価値観| |フラグ|目的|価値観|
|---|---|---| |---|---|---|
@ -199,7 +199,7 @@
### 選択ツールコマンドフラグ ( `/sc:select-tool`) ### 選択ツールコマンドフラグ ( `/sc:select-tool`)
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#select-tool-command-flags-scselect-tool) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#select-tool-command-flags-scselect-tool)
|フラグ|目的|価値観| |フラグ|目的|価値観|
|---|---|---| |---|---|---|
@ -208,7 +208,7 @@
### テストコマンドフラグ（`/sc:test`） ### テストコマンドフラグ（`/sc:test`）
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#test-command-flags-sctest) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#test-command-flags-sctest)
|フラグ|目的|価値観| |フラグ|目的|価値観|
|---|---|---| |---|---|---|
@ -218,11 +218,11 @@
## 高度な制御フラグ ## 高度な制御フラグ
[](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#advanced-control-flags)
### 範囲と焦点 ### 範囲と焦点
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#scope-and-focus) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#scope-and-focus)
|フラグ|目的|価値観| |フラグ|目的|価値観|
|---|---|---| |---|---|---|
@ -231,7 +231,7 @@
### 実行制御 ### 実行制御
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#execution-control) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#execution-control)
|フラグ|目的|価値観| |フラグ|目的|価値観|
|---|---|---| |---|---|---|
@ -242,7 +242,7 @@
### システムフラグ（SuperClaude インストール） ### システムフラグ（SuperClaude インストール）
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#system-flags-superclaude-installation) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#system-flags-superclaude-installation)
|フラグ|目的|価値観| |フラグ|目的|価値観|
|---|---|---| |---|---|---|
@ -258,11 +258,11 @@
## 一般的な使用パターン ## 一般的な使用パターン
[](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#common-usage-patterns)
### フロントエンド開発 ### フロントエンド開発
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#frontend-development) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#frontend-development)
```shell ```shell
/sc:implement "responsive dashboard" --magic --c7 /sc:implement "responsive dashboard" --magic --c7
@ -273,7 +273,7 @@
### バックエンド開発 ### バックエンド開発
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#backend-development) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#backend-development)
```shell ```shell
/sc:analyze api/ --focus performance --seq --think /sc:analyze api/ --focus performance --seq --think
@ -284,7 +284,7 @@
### 大規模プロジェクト ### 大規模プロジェクト
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#large-projects) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#large-projects)
```shell ```shell
/sc:analyze . --ultrathink --all-mcp --safe-mode /sc:analyze . --ultrathink --all-mcp --safe-mode
@ -295,7 +295,7 @@
### 品質とメンテナンス ### 品質とメンテナンス
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#quality--maintenance) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#quality--maintenance)
```shell ```shell
/sc:improve src/ --type quality --safe --interactive /sc:improve src/ --type quality --safe --interactive
@ -306,11 +306,11 @@
## フラグインタラクション ## フラグインタラクション
[](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#flag-interactions)
### 互換性のある組み合わせ ### 互換性のある組み合わせ
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#compatible-combinations) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#compatible-combinations)
- `--think`+ `--c7`: ドキュメント付き分析 - `--think`+ `--c7`: ドキュメント付き分析
- `--magic`+ `--play`: テスト付きのUI生成 - `--magic`+ `--play`: テスト付きのUI生成
@ -320,7 +320,7 @@
### 競合するフラグ ### 競合するフラグ
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#conflicting-flags) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#conflicting-flags)
- `--all-mcp`個別のMCPフラグと比較（どちらか一方を使用） - `--all-mcp`個別のMCPフラグと比較（どちらか一方を使用）
- `--no-mcp`任意のMCPフラグと比較（--no-mcpが優先） - `--no-mcp`任意のMCPフラグと比較（--no-mcpが優先）
@ -329,7 +329,7 @@
### 関係の自動有効化 ### 関係の自動有効化
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#auto-enabling-relationships) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#auto-enabling-relationships)
- `--safe-mode`自動的`--uc`に有効になり、`--validate` - `--safe-mode`自動的`--uc`に有効になり、`--validate`
- `--ultrathink`すべてのMCPサーバーを自動的に有効にする - `--ultrathink`すべてのMCPサーバーを自動的に有効にする
@ -338,11 +338,11 @@
## トラブルシューティングフラグ ## トラブルシューティングフラグ
[](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#troubleshooting-flags)
### よくある問題 ### よくある問題
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#common-issues) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#common-issues)
- **ツールが多すぎる**:`--no-mcp`ネイティブツールのみでテストする - **ツールが多すぎる**:`--no-mcp`ネイティブツールのみでテストする
- **操作が遅すぎます**:`--uc`出力を圧縮するために追加します - **操作が遅すぎます**:`--uc`出力を圧縮するために追加します
@ -351,7 +351,7 @@
### デバッグフラグ ### デバッグフラグ
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#debug-flags) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#debug-flags)
```shell ```shell
/sc:analyze . --verbose # Shows decision logic and flag activation /sc:analyze . --verbose # Shows decision logic and flag activation
@ -361,7 +361,7 @@
### クイックフィックス ### クイックフィックス
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#quick-fixes) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#quick-fixes)
```shell ```shell
/sc:analyze . --help # Shows available flags for command /sc:analyze . --help # Shows available flags for command
@ -371,7 +371,7 @@
## フラグの優先ルール ## フラグの優先ルール
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md#flag-priority-rules) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#flag-priority-rules)
1. **安全第一**: `--safe-mode`> `--validate`> 最適化フラグ 1. **安全第一**: `--safe-mode`> `--validate`> 最適化フラグ
2. **明示的なオーバーライド**: ユーザーフラグ > 自動検出 2. **明示的なオーバーライド**: ユーザーフラグ > 自動検出
@ -381,8 +381,8 @@
## 関連リソース ## 関連リソース
[](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/flags.md#related-resources)
- [コマンドガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md)- これらのフラグを使用するコマンド - [コマンドガイド](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 フラグのアクティブ化について - [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)- 永続セッションでのフラグの使用 - [セッション管理](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md)- 永続セッションでのフラグの使用

50
docs/User-Guide-jp/mcp-servers.md → docs/user-guide-jp/mcp-servers.md
View File

@ -1,16 +1,16 @@
# SuperClaude MCP サーバーガイド 🔌 # 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#superclaude-mcp-servers-guide-)
## 概要 ## 概要
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/mcp-servers.md#overview) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/mcp-servers.md#overview)
MCP（モデルコンテキストプロトコル）サーバーは、専用ツールを通じてClaude Codeの機能を拡張します。SuperClaudeは6つのMCPサーバーを統合し、タスクに応じてサーバーをいつ起動するかをClaudeに指示します。 MCP（モデルコンテキストプロトコル）サーバーは、専用ツールを通じてClaude Codeの機能を拡張します。SuperClaudeは6つのMCPサーバーを統合し、タスクに応じてサーバーをいつ起動するかをClaudeに指示します。
### 🔍 現実チェック ### 🔍 現実チェック
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/mcp-servers.md#-reality-check) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/mcp-servers.md#-reality-check)
- **MCPサーバーとは**: 追加ツールを提供する外部Node.jsプロセス - **MCPサーバーとは**: 追加ツールを提供する外部Node.jsプロセス
- **含まれていないもの**：SuperClaude 機能が組み込まれている - **含まれていないもの**：SuperClaude 機能が組み込まれている
@ -28,9 +28,9 @@ MCP（モデルコンテキストプロトコル）サーバーは、専用ツ
## クイックスタート ## クイックスタート
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/mcp-servers.md#quick-start) [](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)を参照してください。 **セットアップの確認**：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)を参照してください。
**自動アクティベーションロジック:** **自動アクティベーションロジック:**
@ -45,11 +45,11 @@ MCP（モデルコンテキストプロトコル）サーバーは、専用ツ
## サーバーの詳細 ## サーバーの詳細
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/mcp-servers.md#server-details) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/mcp-servers.md#server-details)
### コンテキスト7 📚 ### コンテキスト7 📚
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/mcp-servers.md#context7-) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/mcp-servers.md#context7-)
**目的**: 公式ライブラリドキュメントへのアクセス **トリガー**: インポートステートメント、フレームワークキーワード、ドキュメントリクエスト **要件**: Node.js 16+、APIキーなし **目的**: 公式ライブラリドキュメントへのアクセス **トリガー**: インポートステートメント、フレームワークキーワード、ドキュメントリクエスト **要件**: Node.js 16+、APIキーなし
@ -64,7 +64,7 @@ MCP（モデルコンテキストプロトコル）サーバーは、専用ツ
### 連続思考 🧠 ### 連続思考 🧠
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/mcp-servers.md#sequential-thinking-) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/mcp-servers.md#sequential-thinking-)
**目的**: 構造化された多段階の推論と体系的な分析 **トリガー**: 複雑なデバッグ、`--think`フラグ、アーキテクチャ分析 **要件**: Node.js 16+、APIキーなし **目的**: 構造化された多段階の推論と体系的な分析 **トリガー**: 複雑なデバッグ、`--think`フラグ、アーキテクチャ分析 **要件**: Node.js 16+、APIキーなし
@ -79,7 +79,7 @@ MCP（モデルコンテキストプロトコル）サーバーは、専用ツ
### 魔法✨ ### 魔法✨
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/mcp-servers.md#magic-) [](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() **目的**: 21st.dev パターンからのモダン UI コンポーネント生成 **トリガー**: UI リクエスト、`/ui`コマンド、コンポーネント開発 **要件**: Node.js 16+、TWENTYFIRST_API_KEY()
@ -94,7 +94,7 @@ export TWENTYFIRST_API_KEY="your_key_here"
### 劇作家🎭 ### 劇作家🎭
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/mcp-servers.md#playwright-) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/mcp-servers.md#playwright-)
**目的**: 実際のブラウザ自動化とE2Eテスト **トリガー**: ブラウザテスト、E2Eシナリオ、視覚的検証 **要件**: Node.js 16以上、APIキーなし **目的**: 実際のブラウザ自動化とE2Eテスト **トリガー**: ブラウザテスト、E2Eシナリオ、視覚的検証 **要件**: Node.js 16以上、APIキーなし
@ -109,7 +109,7 @@ export TWENTYFIRST_API_KEY="your_key_here"
### morphllm-fast-apply 🔄 ### morphllm-fast-apply 🔄
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/mcp-servers.md#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 **目的**: 効率的なパターンベースのコード変換 **トリガー**: 複数ファイルの編集、リファクタリング、フレームワークの移行 **要件**: Node.js 16+、MORPH_API_KEY
@ -124,7 +124,7 @@ export MORPH_API_KEY="your_key_here"
### セレナ🧭 ### セレナ🧭
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/mcp-servers.md#serena-) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/mcp-servers.md#serena-)
**目的**: プロジェクトメモリを使用したセマンティックコード理解 **トリガー**: シンボル操作、大規模コードベース、セッション管理 **要件**: Python 3.9+、UV パッケージマネージャー、API キーなし **目的**: プロジェクトメモリを使用したセマンティックコード理解 **トリガー**: シンボル操作、大規模コードベース、セッション管理 **要件**: Python 3.9+、UV パッケージマネージャー、API キーなし
@ -139,7 +139,7 @@ export MORPH_API_KEY="your_key_here"
## 構成 ## 構成
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/mcp-servers.md#configuration) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/mcp-servers.md#configuration)
**MCP 構成ファイル ( `~/.claude.json`):** **MCP 構成ファイル ( `~/.claude.json`):**
@ -178,7 +178,7 @@ export MORPH_API_KEY="your_key_here"
## 使用パターン ## 使用パターン
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/mcp-servers.md#usage-patterns) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/mcp-servers.md#usage-patterns)
**サーバー制御:** **サーバー制御:**
@ -207,7 +207,7 @@ export MORPH_API_KEY="your_key_here"
## トラブルシューティング ## トラブルシューティング
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/mcp-servers.md#troubleshooting) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/mcp-servers.md#troubleshooting)
**よくある問題:** **よくある問題:**
@ -255,7 +255,7 @@ echo 'export MORPH_API_KEY="your_key"' >> ~/.bashrc
## サーバーの組み合わせ ## サーバーの組み合わせ
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/mcp-servers.md#server-combinations) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/mcp-servers.md#server-combinations)
**APIキーなし（無料）** : **APIキーなし（無料）** :
@ -278,7 +278,7 @@ echo 'export MORPH_API_KEY="your_key"' >> ~/.bashrc
## 統合 ## 統合
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/mcp-servers.md#integration) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/mcp-servers.md#integration)
**SuperClaude コマンドを使用する場合:** **SuperClaude コマンドを使用する場合:**
@ -300,20 +300,20 @@ echo 'export MORPH_API_KEY="your_key"' >> ~/.bashrc
## 関連リソース ## 関連リソース
[](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/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/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/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/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/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/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/reference/examples-cookbook.md)- MCP ワークフローパターン
- [技術アーキテクチャ](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/technical-architecture.md)- 統合の詳細

110
docs/User-Guide-jp/modes.md → docs/user-guide-jp/modes.md
View File

@ -1,16 +1,16 @@
# SuperClaude 行動モードガイド 🧠 # 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#superclaude-behavioral-modes-guide-)
## ✅ クイック検証 ## ✅ クイック検証
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#-quick-verification) [](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)をご覧ください。 コマンドを使用してモードをテストします`/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) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#quick-reference-table)
|モード|目的|自動トリガー|重要な行動|最適な用途| |モード|目的|自動トリガー|重要な行動|最適な用途|
|---|---|---|---|---| |---|---|---|---|---|
@ -24,7 +24,7 @@
## はじめに（2分の概要） ## はじめに（2分の概要）
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#getting-started-2-minute-overview) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#getting-started-2-minute-overview)
**モードは動作指示を通じてアクティブ化されます**- Claude Code はコンテキスト ファイルを読み取り、タスクのパターンと複雑さに基づいてどのモード動作を採用するかを決定します。 **モードは動作指示を通じてアクティブ化されます**- Claude Code はコンテキスト ファイルを読み取り、タスクのパターンと複雑さに基づいてどのモード動作を採用するかを決定します。
@ -47,11 +47,11 @@
## モードの詳細 ## モードの詳細
[](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#mode-details)
### 🧠 ブレインストーミングモード - インタラクティブな発見 ### 🧠 ブレインストーミングモード - インタラクティブな発見
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#-brainstorming-mode---interactive-discovery) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#-brainstorming-mode---interactive-discovery)
**目的**: 共同作業による発見を通じて、漠然としたアイデアを構造化された要件に変換します。 **目的**: 共同作業による発見を通じて、漠然としたアイデアを構造化された要件に変換します。
@ -85,7 +85,7 @@ Brainstorming Approach:
#### 成功基準 #### 成功基準
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#success-criteria) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#success-criteria)
- [ ] すぐに解決策を提示するのではなく、質問で応答する - [ ] すぐに解決策を提示するのではなく、質問で応答する
- [ ] 質問はユーザーのニーズ、技術的制約、ビジネス目標を探ります - [ ] 質問はユーザーのニーズ、技術的制約、ビジネス目標を探ります
@ -106,7 +106,7 @@ Brainstorming Approach:
### 🔍 内省モード - メタ認知分析 ### 🔍 内省モード - メタ認知分析
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#-introspection-mode---meta-cognitive-analysis) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#-introspection-mode---meta-cognitive-analysis)
**目的**: 学習の最適化と透明な意思決定のための推論プロセスを公開します。 **目的**: 学習の最適化と透明な意思決定のための推論プロセスを公開します。
@ -149,7 +149,7 @@ Introspective Approach:
### 📋 タスク管理モード - 複雑な調整 ### 📋 タスク管理モード - 複雑な調整
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#-task-management-mode---complex-coordination) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#-task-management-mode---complex-coordination)
**目的**: 複数ステップの操作のためのセッション永続性を備えた階層的なタスク構成。 **目的**: 複数ステップの操作のためのセッション永続性を備えた階層的なタスク構成。
@ -193,7 +193,7 @@ Task Management Approach:
### 🎯 オーケストレーションモード - インテリジェントなツール選択 ### 🎯 オーケストレーションモード - インテリジェントなツール選択
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#-orchestration-mode---intelligent-tool-selection) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#-orchestration-mode---intelligent-tool-selection)
**目的**: インテリジェントなツールルーティングと並列調整を通じてタスクの実行を最適化します。 **目的**: インテリジェントなツールルーティングと並列調整を通じてタスクの実行を最適化します。
@ -235,7 +235,7 @@ Orchestration Approach:
### ⚡ トークン効率モード - 圧縮通信 ### ⚡ トークン効率モード - 圧縮通信
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#-token-efficiency-mode---compressed-communication) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#-token-efficiency-mode---compressed-communication)
**目的**: 情報の品質を維持しながら、シンボル システムを通じて推定 30 ～ 50% のトークン削減を実現します。 **目的**: 情報の品質を維持しながら、シンボル システムを通じて推定 30 ～ 50% のトークン削減を実現します。
@ -276,7 +276,7 @@ Token Efficient Approach:
### 🎨 標準モード - バランスのとれたデフォルト ### 🎨 標準モード - バランスのとれたデフォルト
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#-standard-mode---balanced-default) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#-standard-mode---balanced-default)
**目的**: 簡単な開発タスクに対して明確でプロフェッショナルなコミュニケーションを提供します。 **目的**: 簡単な開発タスクに対して明確でプロフェッショナルなコミュニケーションを提供します。
@ -319,11 +319,11 @@ Standard Approach: Consistent, professional baseline for all tasks
## 高度な使用法 ## 高度な使用法
[](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#advanced-usage)
### モードの組み合わせ ### モードの組み合わせ
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#mode-combinations) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#mode-combinations)
**マルチモードワークフロー:** **マルチモードワークフロー:**
@ -341,7 +341,7 @@ Standard Approach: Consistent, professional baseline for all tasks
### 手動モード制御 ### 手動モード制御
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#manual-mode-control) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#manual-mode-control)
**特定の動作を強制する:** **特定の動作を強制する:**
@ -366,7 +366,7 @@ Standard Approach: Consistent, professional baseline for all tasks
### モードの境界と優先順位 ### モードの境界と優先順位
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#mode-boundaries-and-priority) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#mode-boundaries-and-priority)
**モードがアクティブになると:** **モードがアクティブになると:**
@ -387,11 +387,11 @@ Standard Approach: Consistent, professional baseline for all tasks
## 実世界の例 ## 実世界の例
[](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#real-world-examples)
### 完全なワークフローの例 ### 完全なワークフローの例
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#complete-workflow-examples) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#complete-workflow-examples)
**新規プロジェクト開発:** **新規プロジェクト開発:**
@ -430,7 +430,7 @@ Standard Approach: Consistent, professional baseline for all tasks
### モードの組み合わせパターン ### モードの組み合わせパターン
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#mode-combination-patterns) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#mode-combination-patterns)
**非常に複雑なシナリオ:** **非常に複雑なシナリオ:**
@ -447,11 +447,11 @@ Standard Approach: Consistent, professional baseline for all tasks
## クイックリファレンス ## クイックリファレンス
[](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#quick-reference)
### モード起動パターン ### モード起動パターン
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#mode-activation-patterns) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#mode-activation-patterns)
|トリガータイプ|入力例|モードが有効|主要な動作| |トリガータイプ|入力例|モードが有効|主要な動作|
|---|---|---|---| |---|---|---|---|
@ -464,7 +464,7 @@ Standard Approach: Consistent, professional baseline for all tasks
### 手動オーバーライドコマンド ### 手動オーバーライドコマンド
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#manual-override-commands) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#manual-override-commands)
```shell ```shell
# Force specific mode behaviors # Force specific mode behaviors
@ -483,26 +483,26 @@ Standard Approach: Consistent, professional baseline for all tasks
## トラブルシューティング ## トラブルシューティング
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#troubleshooting) [](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/common-issues.md)- よくある問題に対するクイック修正
- [トラブルシューティングガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Reference/troubleshooting.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) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#common-issues)
- **モードがアクティブ化されていません**: 手動フラグを使用してください: `--brainstorm`、、`--introspect``--uc` - **モードがアクティブ化されていません**: 手動フラグを使用してください: `--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#immediate-fixes) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#immediate-fixes)
- **特定のモードを強制**:`--brainstorm`またはのような明示的なフラグを使用する`--task-manage` - **特定のモードを強制**:`--brainstorm`またはのような明示的なフラグを使用する`--task-manage`
- **リセットモードの動作**: モード状態をリセットするには、Claude Code セッションを再起動します。 - **リセットモードの動作**: モード状態をリセットするには、Claude Code セッションを再起動します。
@ -511,7 +511,7 @@ Standard Approach: Consistent, professional baseline for all tasks
### モード固有のトラブルシューティング ### モード固有のトラブルシューティング
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#mode-specific-troubleshooting) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#mode-specific-troubleshooting)
**ブレインストーミングモードの問題:** **ブレインストーミングモードの問題:**
@ -564,7 +564,7 @@ Standard Approach: Consistent, professional baseline for all tasks
### エラーコードリファレンス ### エラーコードリファレンス
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#error-code-reference) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#error-code-reference)
|モードエラー|意味|クイックフィックス| |モードエラー|意味|クイックフィックス|
|---|---|---| |---|---|---|
@ -579,7 +579,7 @@ Standard Approach: Consistent, professional baseline for all tasks
### プログレッシブサポートレベル ### プログレッシブサポートレベル
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#progressive-support-levels) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#progressive-support-levels)
**レベル 1: クイックフィックス (< 2 分)** **レベル 1: クイックフィックス (< 2 分)**
@ -596,7 +596,7 @@ Standard Approach: Consistent, professional baseline for all tasks
# Review request complexity and triggers # Review request complexity and triggers
``` ```
- モードのインストールに関する問題については、[一般的な問題ガイドを](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Reference/common-issues.md)参照してください。 - モードのインストールに関する問題については、[一般的な問題ガイドを](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/reference/common-issues.md)参照してください。
**レベル3: 専門家によるサポート（30分以上）** **レベル3: 専門家によるサポート（30分以上）**
@ -607,7 +607,7 @@ SuperClaude install --diagnose
# Review behavioral triggers and thresholds # Review behavioral triggers and thresholds
``` ```
- 行動モード分析については[診断リファレンスガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Reference/diagnostic-reference.md)を参照してください - 行動モード分析については[診断リファレンスガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/reference/diagnostic-reference.md)を参照してください
**レベル4: コミュニティサポート** **レベル4: コミュニティサポート**
@ -617,7 +617,7 @@ SuperClaude install --diagnose
### 成功の検証 ### 成功の検証
[](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#success-validation)
モード修正を適用した後、次のようにテストします。 モード修正を適用した後、次のようにテストします。
@ -629,17 +629,17 @@ SuperClaude install --diagnose
## クイックトラブルシューティング（レガシー） ## クイックトラブルシューティング（レガシー）
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#quick-troubleshooting-legacy) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#quick-troubleshooting-legacy)
- **モードがアクティブ化されない**→手動フラグを使用: `--brainstorm`、、`--introspect``--uc` - **モードがアクティブ化されない**→手動フラグを使用: `--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/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) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#frequently-asked-questions)
**Q: どのモードがアクティブになっているかはどうすればわかりますか?** A: 通信パターンで次のインジケーターを確認してください。 **Q: どのモードがアクティブになっているかはどうすればわかりますか?** A: 通信パターンで次のインジケーターを確認してください。
@ -674,7 +674,7 @@ SuperClaude install --diagnose
## まとめ ## まとめ
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#summary) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#summary)
SuperClaude の 5 つの行動モードは、ユーザーのニーズに自動的に適合する**インテリジェントな適応システムを作成します。** SuperClaude の 5 つの行動モードは、ユーザーのニーズに自動的に適合する**インテリジェントな適応システムを作成します。**
@ -691,36 +691,36 @@ SuperClaude の 5 つの行動モードは、ユーザーのニーズに自動
## 関連ガイド ## 関連ガイド
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md#related-guides) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#related-guides)
**学習の進捗:** **学習の進捗:**
**🌱 エッセンシャル（第1週）** **🌱 エッセンシャル（第1週）**
- [クイックスタートガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Getting-Started/quick-start.md)- モードの有効化例 - [クイックスタートガイド](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/user-guide/commands.md)- コマンドは自動的にモードをアクティブ化します
- [インストールガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Getting-Started/installation.md)- 動作モードの設定 - [インストールガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/getting-started/installation.md)- 動作モードの設定
**🌿中級（第2～3週）** **🌿中級（第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/agents.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/flags.md)- 手動モードの制御と最適化
- [例文集](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Reference/examples-cookbook.md)- モードパターンの実践 - [例文集](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/reference/examples-cookbook.md)- モードパターンの実践
**🌲 上級（2ヶ月目以降）** **🌲 上級（2ヶ月目以降）**
- [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/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/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/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/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/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/reference/examples-cookbook.md#requirements)
- **タスク管理**：[セッション管理ガイド](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/session-management.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/mcp-servers.md)
- **トークン効率**：[コマンドの基礎](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#token-efficiency) - **トークン効率**：[コマンドの基礎](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#token-efficiency)

66
docs/User-Guide-jp/session-management.md → docs/user-guide-jp/session-management.md
View File

@ -1,16 +1,16 @@
# セッション管理ガイド # セッション管理ガイド
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#session-management-guide) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#session-management-guide)
SuperClaude は、Serena MCP サーバーを通じて永続的なセッション管理を提供し、Claude Code の会話全体にわたる真のコンテキスト保存と長期的なプロジェクト継続性を実現します。 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) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#core-session-commands-with-persistent-memory)
### `/sc:load`- 永続メモリによるコンテキストの読み込み ### `/sc:load`- 永続メモリによるコンテキストの読み込み
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#scload---context-loading-with-persistent-memory) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#scload---context-loading-with-persistent-memory)
**目的**: 以前のセッションからのプロジェクトコンテキストと永続メモリを使用してセッションを初期化します。MCP **目的**: 以前のセッションからのプロジェクトコンテキストと永続メモリを使用してセッションを初期化します。MCP
**統合**: Serena MCP をトリガーして、保存されたプロジェクトメモリを読み取ります。 **統合**: Serena MCP をトリガーして、保存されたプロジェクトメモリを読み取ります。
@ -38,7 +38,7 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
### `/sc:save`- メモリへのセッションの永続性 ### `/sc:save`- メモリへのセッションの永続性
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#scsave---session-persistence-to-memory) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#scsave---session-persistence-to-memory)
**目的**: 現在のセッション状態と決定を永続メモリ **目的**: 現在のセッション状態と決定を永続メモリ
**MCP に保存します。統合**: Serena MCP をトリガーしてメモリ ファイルに書き込みます。 **MCP に保存します。統合**: Serena MCP をトリガーしてメモリ ファイルに書き込みます。
@ -66,7 +66,7 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
### `/sc:reflect`- メモリコンテキストによる進捗状況の評価 ### `/sc:reflect`- メモリコンテキストによる進捗状況の評価
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#screflect---progress-assessment-with-memory-context) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#screflect---progress-assessment-with-memory-context)
**目的**: 保存されたメモリに対して現在の進行状況を分析し、セッションの完全性を検証する **目的**: 保存されたメモリに対して現在の進行状況を分析し、セッションの完全性を検証する
**MCP 統合**: Serena MCP を使用して、保存されたメモリと現在の状態を比較する **MCP 統合**: Serena MCP を使用して、保存されたメモリと現在の状態を比較する
@ -94,11 +94,11 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
## 永続メモリアーキテクチャ ## 永続メモリアーキテクチャ
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#persistent-memory-architecture) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#persistent-memory-architecture)
### Serena MCP が真の永続性を実現する方法 ### 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#how-serena-mcp-enables-true-persistence)
**メモリストレージ**: **メモリストレージ**:
@ -123,11 +123,11 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
## 永続性を備えたセッションライフサイクルパターン ## 永続性を備えたセッションライフサイクルパターン
[](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#session-lifecycle-patterns-with-persistence)
### 新しいプロジェクトの初期化 ### 新しいプロジェクトの初期化
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#new-project-initialization) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#new-project-initialization)
```shell ```shell
# 1. Start fresh project # 1. Start fresh project
@ -145,7 +145,7 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
### 既存の作業の再開（クロス会話） ### 既存の作業の再開（クロス会話）
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#resuming-existing-work-cross-conversation) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#resuming-existing-work-cross-conversation)
```shell ```shell
# 1. Load previous context from persistent memory # 1. Load previous context from persistent memory
@ -163,7 +163,7 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
### 長期プロジェクト管理 ### 長期プロジェクト管理
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#long-term-project-management) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#long-term-project-management)
```shell ```shell
# Weekly checkpoint pattern with persistence # Weekly checkpoint pattern with persistence
@ -180,11 +180,11 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
## クロス会話の継続性 ## クロス会話の継続性
[](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#cross-conversation-continuity)
### 粘り強く新しい会話を始める ### 粘り強く新しい会話を始める
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#starting-new-conversations-with-persistence) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#starting-new-conversations-with-persistence)
新しい Claude Code 会話を開始すると、永続メモリ システムによって次のことが可能になります。 新しい Claude Code 会話を開始すると、永続メモリ システムによって次のことが可能になります。
@ -208,7 +208,7 @@ SuperClaude は、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#memory-optimization)
**有効なメモリ使用量**: **有効なメモリ使用量**:
@ -233,11 +233,11 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
## 永続セッションのベストプラクティス ## 永続セッションのベストプラクティス
[](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#best-practices-for-persistent-sessions)
### セッション開始プロトコル ### セッション開始プロトコル
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#session-start-protocol) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#session-start-protocol)
1. `/sc:load`既存のプロジェクトの場合は常に 1. `/sc:load`既存のプロジェクトの場合は常に
2. `/sc:reflect`記憶から現在の状態を理解するために使用する 2. `/sc:reflect`記憶から現在の状態を理解するために使用する
@ -246,7 +246,7 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
### セッション終了プロトコル ### セッション終了プロトコル
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#session-end-protocol) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#session-end-protocol)
1. `/sc:reflect`保存された目標に対する完全性を評価するために使用します 1. `/sc:reflect`保存された目標に対する完全性を評価するために使用します
2. 重要な決定を`/sc:save`将来のセッションのために保存する 2. 重要な決定を`/sc:save`将来のセッションのために保存する
@ -255,7 +255,7 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
### 記憶品質の維持 ### 記憶品質の維持
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#memory-quality-maintenance) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#memory-quality-maintenance)
- 簡単に思い出せるように、分かりやすく説明的なメモリ名を使用する - 簡単に思い出せるように、分かりやすく説明的なメモリ名を使用する
- 決定事項と代替アプローチに関する背景情報を含める - 決定事項と代替アプローチに関する背景情報を含める
@ -264,11 +264,11 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
## 他のSuperClaude機能との統合 ## 他のSuperClaude機能との統合
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#integration-with-other-superclaude-features) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#integration-with-other-superclaude-features)
### MCP サーバー調整 ### MCP サーバー調整
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#mcp-server-coordination) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#mcp-server-coordination)
- **Serena MCP** : 永続メモリインフラストラクチャを提供します - **Serena MCP** : 永続メモリインフラストラクチャを提供します
- **シーケンシャルMCP** : 保存されたメモリを使用して複雑な分析を強化します - **シーケンシャルMCP** : 保存されたメモリを使用して複雑な分析を強化します
@ -277,7 +277,7 @@ SuperClaude は、Serena 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#agent-collaboration-with-memory)
- エージェントは強化されたコンテキストのために永続的なメモリにアクセスします - エージェントは強化されたコンテキストのために永続的なメモリにアクセスします
- 以前の専門家の決定は保存され、参照されます - 以前の専門家の決定は保存され、参照されます
@ -286,7 +286,7 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
### 永続性を備えたコマンド統合 ### 永続性を備えたコマンド統合
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#command-integration-with-persistence) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#command-integration-with-persistence)
- すべての`/sc:`コマンドは永続的なコンテキストを参照し、そのコンテキストに基づいて構築できます。 - すべての`/sc:`コマンドは永続的なコンテキストを参照し、そのコンテキストに基づいて構築できます。
- 以前のコマンド出力と決定はセッション間で利用可能 - 以前のコマンド出力と決定はセッション間で利用可能
@ -295,11 +295,11 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
## 永続セッションのトラブルシューティング ## 永続セッションのトラブルシューティング
[](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#troubleshooting-persistent-sessions)
### よくある問題 ### よくある問題
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#common-issues) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#common-issues)
**メモリが読み込まれません**: **メモリが読み込まれません**:
@ -324,7 +324,7 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
### クイックフィックス ### クイックフィックス
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#quick-fixes) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#quick-fixes)
**セッション状態をリセット**: **セッション状態をリセット**:
@ -349,11 +349,11 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
## 高度な永続セッションパターン ## 高度な永続セッションパターン
[](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#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#multi-phase-projects)
- 整理のためにフェーズ固有のメモリ命名を使用する - 整理のためにフェーズ固有のメモリ命名を使用する
- フェーズ全体でアーキテクチャ上の決定の継続性を維持する - フェーズ全体でアーキテクチャ上の決定の継続性を維持する
@ -362,7 +362,7 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
### チームコラボレーション ### チームコラボレーション
[](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#team-collaboration)
- 共有メモリの規則と命名規則 - 共有メモリの規則と命名規則
- チームのコンテキストにおける意思決定根拠の保存 - チームのコンテキストにおける意思決定根拠の保存
@ -371,7 +371,7 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
### 長期メンテナンス ### 長期メンテナンス
[](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#long-term-maintenance)
- 完了したプロジェクトのメモリアーカイブ戦略 - 完了したプロジェクトのメモリアーカイブ戦略
- 蓄積された記憶によるパターンライブラリの開発 - 蓄積された記憶によるパターンライブラリの開発
@ -380,11 +380,11 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
## 永続セッション管理の主な利点 ## 永続セッション管理の主な利点
[](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#key-benefits-of-persistent-session-management)
### プロジェクトの継続性 ### プロジェクトの継続性
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#project-continuity) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#project-continuity)
- 複数の会話にわたるシームレスな作業継続 - 複数の会話にわたるシームレスな作業継続
- Claude Codeセッション間でコンテキストが失われることはありません - Claude Codeセッション間でコンテキストが失われることはありません
@ -393,7 +393,7 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
### 生産性の向上 ### 生産性の向上
[](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#enhanced-productivity)
- プロジェクトのコンテキストを再度説明する必要性が減少 - プロジェクトのコンテキストを再度説明する必要性が減少
- 起動時間が速く、作業を継続できる - 起動時間が速く、作業を継続できる
@ -402,7 +402,7 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
### 品質の一貫性 ### 品質の一貫性
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md#quality-consistency) [](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#quality-consistency)
- セッション間で一貫したアーキテクチャパターン - セッション間で一貫したアーキテクチャパターン
- コード品質の決定と標準の保持 - コード品質の決定と標準の保持

16
docs/User-Guide-kr/agents.md → docs/user-guide-kr/agents.md
View File

@ -537,8 +537,8 @@ SuperClaude는 Claude Code가 전문 지식을 위해 호출할 수 있는 15개
## 문제 해결 ## 문제 해결
문제 해결 도움말은 다음을 참조하세요: 문제 해결 도움말은 다음을 참조하세요:
- [일반적인 문제](../Reference/common-issues.md) - 자주 발생하는 문제에 대한 빠른 수정 - [일반적인 문제](../reference/common-issues.md) - 자주 발생하는 문제에 대한 빠른 수정
- [문제 해결 가이드](../Reference/troubleshooting.md) - 포괄적인 문제 해결 - [문제 해결 가이드](../reference/troubleshooting.md) - 포괄적인 문제 해결
### 일반적인 문제 ### 일반적인 문제
- **에이전트 활성화 없음**: 도메인 키워드 사용: "security", "performance", "frontend" - **에이전트 활성화 없음**: 도메인 키워드 사용: "security", "performance", "frontend"
@ -599,12 +599,12 @@ SuperClaude는 Claude Code가 전문 지식을 위해 호출할 수 있는 15개
- 혼란을 피하기 위해 단일 도메인에 집중 - 혼란을 피하기 위해 단일 도메인에 집중
**상세 도움말:** **상세 도움말:**
- 에이전트 설치 문제는 [일반적인 문제 가이드](../Reference/common-issues.md) 참조 - 에이전트 설치 문제는 [일반적인 문제 가이드](../reference/common-issues.md) 참조
- 대상 에이전트의 트리거 키워드 검토 - 대상 에이전트의 트리거 키워드 검토
**전문가 지원:** **전문가 지원:**
- `SuperClaude install --diagnose` 사용 - `SuperClaude install --diagnose` 사용
- 조정 분석은 [진단 참조 가이드](../Reference/diagnostic-reference.md) 참조 - 조정 분석은 [진단 참조 가이드](../reference/diagnostic-reference.md) 참조
**커뮤니티 지원:** **커뮤니티 지원:**
- [GitHub Issues](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues)에서 문제 보고 - [GitHub Issues](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues)에서 문제 보고
@ -838,12 +838,12 @@ SuperClaude는 Claude Code가 전문 지식을 위해 호출할 수 있는 15개
### 고급 사용 ### 고급 사용
- **[행동 모드](modes.md)** - 향상된 에이전트 조정을 위한 컨텍스트 최적화 - **[행동 모드](modes.md)** - 향상된 에이전트 조정을 위한 컨텍스트 최적화
- **[시작하기](../Getting-Started/quick-start.md)** - 에이전트 최적화를 위한 전문가 기법 - **[시작하기](../getting-started/quick-start.md)** - 에이전트 최적화를 위한 전문가 기법
- **[예제 모음](../Reference/examples-cookbook.md)** - 실제 에이전트 조정 패턴 - **[예제 모음](../reference/examples-cookbook.md)** - 실제 에이전트 조정 패턴
### 개발 리소스 ### 개발 리소스
- **[기술 아키텍처](../Developer-Guide/technical-architecture.md)** - SuperClaude의 에이전트 시스템 설계 이해 - **[기술 아키텍처](../developer-guide/technical-architecture.md)** - SuperClaude의 에이전트 시스템 설계 이해
- **[기여하기](../Developer-Guide/contributing-code.md)** - 에이전트 기능 및 조정 패턴 확장 - **[기여하기](../developer-guide/contributing-code.md)** - 에이전트 기능 및 조정 패턴 확장
--- ---

6
docs/User-Guide-kr/commands.md → docs/user-guide-kr/commands.md
View File

@ -87,7 +87,7 @@ python3 -m SuperClaude install --list-components | grep mcp
# 예상 동작: 사용 가능한 명령어 목록 # 예상 동작: 사용 가능한 명령어 목록
``` ```
**테스트가 실패하면**: [설치 가이드](../Getting-Started/installation.md) 또는 [문제 해결](#troubleshooting) 확인 **테스트가 실패하면**: [설치 가이드](../getting-started/installation.md) 또는 [문제 해결](#troubleshooting) 확인
### 📝 명령어 빠른 참조 ### 📝 명령어 빠른 참조
@ -357,11 +357,11 @@ python3 -m SuperClaude install --list-components | grep mcp
**빠른 수정:** **빠른 수정:**
- 세션 재설정: `/sc:load`로 다시 초기화 - 세션 재설정: `/sc:load`로 다시 초기화
- 상태 확인: `SuperClaude install --list-components` - 상태 확인: `SuperClaude install --list-components`
- 도움말 받기: [문제 해결 가이드](../Reference/troubleshooting.md) - 도움말 받기: [문제 해결 가이드](../reference/troubleshooting.md)
## 다음 단계 ## 다음 단계
- [플래그 가이드](flags.md) - 명령어 동작 제어 - [플래그 가이드](flags.md) - 명령어 동작 제어
- [에이전트 가이드](agents.md) - 전문가 활성화 - [에이전트 가이드](agents.md) - 전문가 활성화
- [예제 모음](../Reference/examples-cookbook.md) - 실제 사용 패턴 - [예제 모음](../reference/examples-cookbook.md) - 실제 사용 패턴

0
docs/User-Guide-kr/flags.md → docs/user-guide-kr/flags.md
View File

8
docs/User-Guide-kr/mcp-servers.md → docs/user-guide-kr/mcp-servers.md
View File

@ -22,7 +22,7 @@ MCP (Model Context Protocol) 서버는 전문 도구를 통해 Claude Code의
## 빠른 시작 ## 빠른 시작
**설정 확인**: MCP 서버는 자동으로 활성화됩니다. 설치 및 문제 해결은 [설치 가이드](../Getting-Started/installation.md) 및 [문제 해결](../Reference/troubleshooting.md)을 참조하세요. **설정 확인**: MCP 서버는 자동으로 활성화됩니다. 설치 및 문제 해결은 [설치 가이드](../getting-started/installation.md) 및 [문제 해결](../reference/troubleshooting.md)을 참조하세요.
**자동 활성화 로직:** **자동 활성화 로직:**
@ -327,7 +327,7 @@ echo 'export TAVILY_API_KEY="your_key"' >> ~/.bashrc
**필수 읽기:** **필수 읽기:**
- [명령어 가이드](commands.md) - MCP 서버를 활성화하는 명령어 - [명령어 가이드](commands.md) - MCP 서버를 활성화하는 명령어
- [빠른 시작 가이드](../Getting-Started/quick-start.md) - MCP 설정 가이드 - [빠른 시작 가이드](../getting-started/quick-start.md) - MCP 설정 가이드
**고급 사용:** **고급 사용:**
- [행동 모드](modes.md) - 모드-MCP 조정 - [행동 모드](modes.md) - 모드-MCP 조정
@ -335,6 +335,6 @@ echo 'export TAVILY_API_KEY="your_key"' >> ~/.bashrc
- [세션 관리](session-management.md) - Serena 워크플로우 - [세션 관리](session-management.md) - Serena 워크플로우
**기술 참조:** **기술 참조:**
- [예제 모음](../Reference/examples-cookbook.md) - MCP 워크플로우 패턴 - [예제 모음](../reference/examples-cookbook.md) - MCP 워크플로우 패턴
- [기술 아키텍처](../Developer-Guide/technical-architecture.md) - 통합 세부사항 - [기술 아키텍처](../developer-guide/technical-architecture.md) - 통합 세부사항

22
docs/User-Guide-kr/modes.md → docs/user-guide-kr/modes.md
View File

@ -458,8 +458,8 @@
## 문제 해결 ## 문제 해결
문제 해결 도움말은 다음을 참조하세요: 문제 해결 도움말은 다음을 참조하세요:
- [일반적인 문제](../Reference/common-issues.md) - 자주 발생하는 문제에 대한 빠른 수정 - [일반적인 문제](../reference/common-issues.md) - 자주 발생하는 문제에 대한 빠른 수정
- [문제 해결 가이드](../Reference/troubleshooting.md) - 포괄적인 문제 해결 - [문제 해결 가이드](../reference/troubleshooting.md) - 포괄적인 문제 해결
### 일반적인 문제 ### 일반적인 문제
- **모드가 활성화되지 않음**: 수동 플래그 사용: `--brainstorm`, `--introspect`, `--uc` - **모드가 활성화되지 않음**: 수동 플래그 사용: `--brainstorm`, `--introspect`, `--uc`
@ -547,7 +547,7 @@
/sc:reflect --type mode-status # 현재 모드 상태 확인 /sc:reflect --type mode-status # 현재 모드 상태 확인
# 요청 복잡성 및 트리거 검토 # 요청 복잡성 및 트리거 검토
``` ```
- 모드 설치 문제는 [일반적인 문제 가이드](../Reference/common-issues.md) 참조 - 모드 설치 문제는 [일반적인 문제 가이드](../reference/common-issues.md) 참조
**수준 3: 전문가 지원 (30분 이상)** **수준 3: 전문가 지원 (30분 이상)**
```bash ```bash
@ -556,7 +556,7 @@ SuperClaude install --diagnose
# 모드 활성화 패턴 확인 # 모드 활성화 패턴 확인
# 행동 트리거 및 임계값 검토 # 행동 트리거 및 임계값 검토
``` ```
- 행동 모드 분석은 [진단 참조 가이드](../Reference/diagnostic-reference.md) 참조 - 행동 모드 분석은 [진단 참조 가이드](../reference/diagnostic-reference.md) 참조
**수준 4: 커뮤니티 지원** **수준 4: 커뮤니티 지원**
- [GitHub Issues](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues)에서 모드 문제 보고 - [GitHub Issues](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues)에서 모드 문제 보고
@ -632,26 +632,26 @@ SuperClaude의 5가지 행동 모드는 필요에 따라 자동으로 일치하
**학습 진행:** **학습 진행:**
**🌱 필수 (1주차)** **🌱 필수 (1주차)**
- [빠른 시작 가이드](../Getting-Started/quick-start.md) - 모드 활성화 예제 - [빠른 시작 가이드](../getting-started/quick-start.md) - 모드 활성화 예제
- [명령어 참조](commands.md) - 명령어가 자동으로 모드 활성화 - [명령어 참조](commands.md) - 명령어가 자동으로 모드 활성화
- [설치 가이드](../Getting-Started/installation.md) - 행동 모드 설정 - [설치 가이드](../getting-started/installation.md) - 행동 모드 설정
**🌿 중급 (2-3주차)** **🌿 중급 (2-3주차)**
- [에이전트 가이드](agents.md) - 모드가 전문가와 조정하는 방법 - [에이전트 가이드](agents.md) - 모드가 전문가와 조정하는 방법
- [플래그 가이드](flags.md) - 수동 모드 제어 및 최적화 - [플래그 가이드](flags.md) - 수동 모드 제어 및 최적화
- [예제 모음](../Reference/examples-cookbook.md) - 실제 모드 패턴 - [예제 모음](../reference/examples-cookbook.md) - 실제 모드 패턴
**🌲 고급 (2개월 이상)** **🌲 고급 (2개월 이상)**
- [MCP 서버](mcp-servers.md) - 향상된 기능과의 모드 통합 - [MCP 서버](mcp-servers.md) - 향상된 기능과의 모드 통합
- [세션 관리](session-management.md) - 작업 관리 모드 워크플로우 - [세션 관리](session-management.md) - 작업 관리 모드 워크플로우
- [시작하기](../Getting-Started/quick-start.md) - 모드 사용 패턴 - [시작하기](../getting-started/quick-start.md) - 모드 사용 패턴
**🔧 전문가** **🔧 전문가**
- [기술 아키텍처](../Developer-Guide/technical-architecture.md) - 모드 구현 세부사항 - [기술 아키텍처](../developer-guide/technical-architecture.md) - 모드 구현 세부사항
- [코드 기여](../Developer-Guide/contributing-code.md) - 모드 기능 확장 - [코드 기여](../developer-guide/contributing-code.md) - 모드 기능 확장
**모드별 가이드:** **모드별 가이드:**
- **브레인스토밍**: [요구사항 발견 패턴](../Reference/examples-cookbook.md#requirements) - **브레인스토밍**: [요구사항 발견 패턴](../reference/examples-cookbook.md#requirements)
- **작업 관리**: [세션 관리 가이드](session-management.md) - **작업 관리**: [세션 관리 가이드](session-management.md)
- **오케스트레이션**: [MCP 서버 가이드](mcp-servers.md) - **오케스트레이션**: [MCP 서버 가이드](mcp-servers.md)
- **토큰 효율성**: [명령어 기본사항](commands.md#token-efficiency) - **토큰 효율성**: [명령어 기본사항](commands.md#token-efficiency)

0
docs/User-Guide-kr/session-management.md → docs/user-guide-kr/session-management.md
View File

16
docs/User-Guide-zh/agents.md → docs/user-guide-zh/agents.md
View File

@ -494,8 +494,8 @@ Task Analysis →
## 故障排除 ## 故障排除
获取故障排除帮助，请参阅： 获取故障排除帮助，请参阅：
- [常见问题](../Reference/common-issues.md) - 常见问题的快速修复 - [常见问题](../reference/common-issues.md) - 常见问题的快速修复
- [故障排除指南](../Reference/troubleshooting.md) - 综合问题解决 - [故障排除指南](../reference/troubleshooting.md) - 综合问题解决
### 常见问题 ### 常见问题
- **无智能体激活**: 使用领域关键词："security"、"performance"、"frontend" - **无智能体激活**: 使用领域关键词："security"、"performance"、"frontend"
@ -556,12 +556,12 @@ Task Analysis →
- 聚焦在单一领域以避免混淆 - 聚焦在单一领域以避免混淆
**详细帮助：** **详细帮助：**
- 查看[常见问题指南](../Reference/common-issues.md)了解智能体安装问题 - 查看[常见问题指南](../reference/common-issues.md)了解智能体安装问题
- 查看目标智能体的触发关键词 - 查看目标智能体的触发关键词
**专家支持：** **专家支持：**
- 使用 `SuperClaude install --diagnose` - 使用 `SuperClaude install --diagnose`
- 查看[诊断参考指南](../Reference/diagnostic-reference.md)进行协调分析 - 查看[诊断参考指南](../reference/diagnostic-reference.md)进行协调分析
**社区支持：** **社区支持：**
- 在 [GitHub Issues](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues) 报告问题 - 在 [GitHub Issues](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues) 报告问题
@ -793,12 +793,12 @@ Task Analysis →
### 高级用法 ### 高级用法
- **[行为模式](modes.md)** - 用于增强智能体协调的上下文优化 - **[行为模式](modes.md)** - 用于增强智能体协调的上下文优化
- **[入门指南](../Getting-Started/quick-start.md)** - 智能体优化的专家技巧 - **[入门指南](../getting-started/quick-start.md)** - 智能体优化的专家技巧
- **[示例食谱](../Reference/examples-cookbook.md)** - 实际的智能体协调模式 - **[示例食谱](../reference/examples-cookbook.md)** - 实际的智能体协调模式
### 开发资源 ### 开发资源
- **[技术架构](../Developer-Guide/technical-architecture.md)** - 理解 SuperClaude 的智能体系统设计 - **[技术架构](../developer-guide/technical-architecture.md)** - 理解 SuperClaude 的智能体系统设计
- **[贡献指南](../Developer-Guide/contributing-code.md)** - 扩展智能体能力和协调模式 - **[贡献指南](../developer-guide/contributing-code.md)** - 扩展智能体能力和协调模式
--- ---

6
docs/User-Guide-zh/commands.md → docs/user-guide-zh/commands.md
View File

@ -88,7 +88,7 @@ python3 -m SuperClaude install --list-components | grep mcp
# 示例行为：显示可用命令列表 # 示例行为：显示可用命令列表
``` ```
**如果测试失败**：检查 [安装指南](../Getting-Started/installation.md) 或 [故障排除](#troubleshooting) **如果测试失败**：检查 [安装指南](../getting-started/installation.md) 或 [故障排除](#troubleshooting)
### 📝 Command Quick Reference ### 📝 Command Quick Reference
@ -296,10 +296,10 @@ python3 -m SuperClaude install --list-components | grep mcp
**快速修复：** **快速修复：**
- 重置会话: `/sc:load` 重新初始化 - 重置会话: `/sc:load` 重新初始化
- 检查状态: `SuperClaude install --list-components` - 检查状态: `SuperClaude install --list-components`
- 获取帮助: [故障排除指南](../Reference/troubleshooting.md) - 获取帮助: [故障排除指南](../reference/troubleshooting.md)
## 下一步 ## 下一步
- [标志指南](flags.md) - 控制命令行为 - [标志指南](flags.md) - 控制命令行为
- [智能体指南](agents.md) - 专家激活 - [智能体指南](agents.md) - 专家激活
- [示例手册](../Reference/examples-cookbook.md) - 真实使用模式 - [示例手册](../reference/examples-cookbook.md) - 真实使用模式

0
docs/User-Guide-zh/flags.md → docs/user-guide-zh/flags.md
View File

8
docs/User-Guide-zh/mcp-servers.md → docs/user-guide-zh/mcp-servers.md
View File

@ -20,7 +20,7 @@ MCP（模型上下文协议）服务器通过专业工具扩展 Claude Code 的
## 快速开始 ## 快速开始
**设置验证**：MCP 服务器会自动激活。有关安装和故障排除，请参阅 [安装指南](../Getting-Started/installation.md) 和 [故障排除](../Reference/troubleshooting.md)。 **设置验证**：MCP 服务器会自动激活。有关安装和故障排除，请参阅 [安装指南](../getting-started/installation.md) 和 [故障排除](../reference/troubleshooting.md)。
**自动激活逻辑：** **自动激活逻辑：**
@ -260,7 +260,7 @@ echo 'export MORPH_API_KEY="your_key"' >> ~/.bashrc
**必读资料：** **必读资料：**
- [命令指南](commands.md) - 激活 MCP 服务器的命令 - [命令指南](commands.md) - 激活 MCP 服务器的命令
- [快速开始指南](../Getting-Started/quick-start.md) - MCP 设置指南 - [快速开始指南](../getting-started/quick-start.md) - MCP 设置指南
**高级使用：** **高级使用：**
- [行为模式](modes.md) - 模式-MCP 协调 - [行为模式](modes.md) - 模式-MCP 协调
@ -268,5 +268,5 @@ echo 'export MORPH_API_KEY="your_key"' >> ~/.bashrc
- [会话管理](session-management.md) - Serena 工作流 - [会话管理](session-management.md) - Serena 工作流
**技术参考：** **技术参考：**
- [示例手册](../Reference/examples-cookbook.md) - MCP 工作流模式 - [示例手册](../reference/examples-cookbook.md) - MCP 工作流模式
- [技术架构](../Developer-Guide/technical-architecture.md) - 集成详情 - [技术架构](../developer-guide/technical-architecture.md) - 集成详情

22
docs/User-Guide-zh/modes.md → docs/user-guide-zh/modes.md
View File

@ -404,8 +404,8 @@ Standard Approach: Consistent, professional baseline for all tasks
## 故障排除 ## 故障排除
有关故障排除帮助，请参阅： 有关故障排除帮助，请参阅：
- [常见问题](../Reference/common-issues.md) - 频繁问题的快速修复 - [常见问题](../reference/common-issues.md) - 频繁问题的快速修复
- [故障排除指南](../Reference/troubleshooting.md) - 全面的问题解决方案 - [故障排除指南](../reference/troubleshooting.md) - 全面的问题解决方案
### 常见问题 ### 常见问题
- **模式未激活**：使用手动标志：`--brainstorm`、`--introspect`、`--uc` - **模式未激活**：使用手动标志：`--brainstorm`、`--introspect`、`--uc`
@ -493,7 +493,7 @@ Standard Approach: Consistent, professional baseline for all tasks
/sc:reflect --type mode-status # 检查当前模式状态 /sc:reflect --type mode-status # 检查当前模式状态
# 检查请求复杂性和触发器 # 检查请求复杂性和触发器
``` ```
- 有关模式安装问题，请参阅[常见问题指南](../Reference/common-issues.md) - 有关模式安装问题，请参阅[常见问题指南](../reference/common-issues.md)
**级别 3：专家支持（30+ 分钟）** **级别 3：专家支持（30+ 分钟）**
```bash ```bash
@ -502,7 +502,7 @@ SuperClaude install --diagnose
# 检查模式激活模式 # 检查模式激活模式
# 检查行为触发器和阈值 # 检查行为触发器和阈值
``` ```
- 有关行为模式分析，请参阅[诊断参考指南](../Reference/diagnostic-reference.md) - 有关行为模式分析，请参阅[诊断参考指南](../reference/diagnostic-reference.md)
**级别 4：社区支持** **级别 4：社区支持**
- 在 [GitHub Issues](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues) 报告模式问题 - 在 [GitHub Issues](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues) 报告模式问题
@ -578,26 +578,26 @@ SuperClaude 的 5 种行为模式创建了一个**智能适应系统**，自动
**学习进展：** **学习进展：**
**🌱 基础（第1周）** **🌱 基础（第1周）**
- [快速开始指南](../Getting-Started/quick-start.md) - 模式激活示例 - [快速开始指南](../getting-started/quick-start.md) - 模式激活示例
- [命令参考](commands.md) - 命令自动激活模式 - [命令参考](commands.md) - 命令自动激活模式
- [安装指南](../Getting-Started/installation.md) - 设置行为模式 - [安装指南](../getting-started/installation.md) - 设置行为模式
**🌿 中级（第2-3周）** **🌿 中级（第2-3周）**
- [智能体指南](agents.md) - 模式如何与专家协调 - [智能体指南](agents.md) - 模式如何与专家协调
- [标志指南](flags.md) - 手动模式控制和优化 - [标志指南](flags.md) - 手动模式控制和优化
- [示例手册](../Reference/examples-cookbook.md) - 实践中的模式模式 - [示例手册](../reference/examples-cookbook.md) - 实践中的模式模式
**🌲 高级（第2+个月）** **🌲 高级（第2+个月）**
- [MCP 服务器](mcp-servers.md) - 模式与增强能力的集成 - [MCP 服务器](mcp-servers.md) - 模式与增强能力的集成
- [会话管理](session-management.md) - 任务管理模式工作流 - [会话管理](session-management.md) - 任务管理模式工作流
- [入门指南](../Getting-Started/quick-start.md) - 模式使用模式 - [入门指南](../getting-started/quick-start.md) - 模式使用模式
**🔧 专家级** **🔧 专家级**
- [技术架构](../Developer-Guide/technical-architecture.md) - 模式实现细节 - [技术架构](../developer-guide/technical-architecture.md) - 模式实现细节
- [代码贡献](../Developer-Guide/contributing-code.md) - 扩展模式能力 - [代码贡献](../developer-guide/contributing-code.md) - 扩展模式能力
**特定模式指南：** **特定模式指南：**
- **头脑风暴**：[需求发现模式](../Reference/examples-cookbook.md#requirements) - **头脑风暴**：[需求发现模式](../reference/examples-cookbook.md#requirements)
- **任务管理**：[会话管理指南](session-management.md) - **任务管理**：[会话管理指南](session-management.md)
- **编排**：[MCP 服务器指南](mcp-servers.md) - **编排**：[MCP 服务器指南](mcp-servers.md)
- **令牌效率**：[命令基础](commands.md#token-efficiency) - **令牌效率**：[命令基础](commands.md#token-efficiency)

0
docs/User-Guide-zh/session-management.md → docs/user-guide-zh/session-management.md
View File

16
docs/User-Guide/agents.md → docs/user-guide/agents.md
View File

@ -609,8 +609,8 @@ Task Flow:
## Troubleshooting ## Troubleshooting
For troubleshooting help, see: For troubleshooting help, see:
- [Common Issues](../Reference/common-issues.md) - Quick fixes for frequent problems - [Common Issues](../reference/common-issues.md) - Quick fixes for frequent problems
- [Troubleshooting Guide](../Reference/troubleshooting.md) - Comprehensive problem resolution - [Troubleshooting Guide](../reference/troubleshooting.md) - Comprehensive problem resolution
### Common Issues ### Common Issues
- **No agent activation**: Use domain keywords: "security", "performance", "frontend" - **No agent activation**: Use domain keywords: "security", "performance", "frontend"
@ -671,12 +671,12 @@ For troubleshooting help, see:
- Focus on single domain to avoid confusion - Focus on single domain to avoid confusion
**Detailed Help:** **Detailed Help:**
- See [Common Issues Guide](../Reference/common-issues.md) for agent installation problems - See [Common Issues Guide](../reference/common-issues.md) for agent installation problems
- Review trigger keywords for target agents - Review trigger keywords for target agents
**Expert Support:** **Expert Support:**
- Use `SuperClaude install --diagnose` - Use `SuperClaude install --diagnose`
- See [Diagnostic Reference Guide](../Reference/diagnostic-reference.md) for coordination analysis - See [Diagnostic Reference Guide](../reference/diagnostic-reference.md) for coordination analysis
**Community Support:** **Community Support:**
- Report issues at [GitHub Issues](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues) - Report issues at [GitHub Issues](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues)
@ -910,12 +910,12 @@ Add "documented", "explained", or "tutorial" to requests for automatic technical
### Advanced Usage ### Advanced Usage
- **[Behavioral Modes](modes.md)** - Context optimization for enhanced agent coordination - **[Behavioral Modes](modes.md)** - Context optimization for enhanced agent coordination
- **[Getting Started](../Getting-Started/quick-start.md)** - Expert techniques for agent optimization - **[Getting Started](../getting-started/quick-start.md)** - Expert techniques for agent optimization
- **[Examples Cookbook](../Reference/examples-cookbook.md)** - Real-world agent coordination patterns - **[Examples Cookbook](../reference/examples-cookbook.md)** - Real-world agent coordination patterns
### Development Resources ### Development Resources
- **[Technical Architecture](../Developer-Guide/technical-architecture.md)** - Understanding SuperClaude's agent system design - **[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 - **[Contributing](../developer-guide/contributing-code.md)** - Extending agent capabilities and coordination patterns
--- ---

6
docs/User-Guide/commands.md → docs/user-guide/commands.md
View File

@ -88,7 +88,7 @@ python3 -m SuperClaude install --list-components | grep mcp
# Example behavior: List of available commands # Example behavior: List of available commands
``` ```
**If tests fail**: Check [Installation Guide](../Getting-Started/installation.md) or [Troubleshooting](#troubleshooting) **If tests fail**: Check [Installation Guide](../getting-started/installation.md) or [Troubleshooting](#troubleshooting)
### 📝 Command Quick Reference ### 📝 Command Quick Reference
@ -358,10 +358,10 @@ python3 -m SuperClaude install --list-components | grep mcp
**Quick Fixes:** **Quick Fixes:**
- Reset session: `/sc:load` to reinitialize - Reset session: `/sc:load` to reinitialize
- Check status: `SuperClaude install --list-components` - Check status: `SuperClaude install --list-components`
- Get help: [Troubleshooting Guide](../Reference/troubleshooting.md) - Get help: [Troubleshooting Guide](../reference/troubleshooting.md)
## Next Steps ## Next Steps
- [Flags Guide](flags.md) - Control command behavior - [Flags Guide](flags.md) - Control command behavior
- [Agents Guide](agents.md) - Specialist activation - [Agents Guide](agents.md) - Specialist activation
- [Examples Cookbook](../Reference/examples-cookbook.md) - Real usage patterns - [Examples Cookbook](../reference/examples-cookbook.md) - Real usage patterns

0
docs/User-Guide/flags.md → docs/user-guide/flags.md
View File

8
docs/User-Guide/mcp-servers.md → docs/user-guide/mcp-servers.md
View File

@ -22,7 +22,7 @@ MCP (Model Context Protocol) servers extend Claude Code's capabilities through s
## Quick Start ## Quick Start
**Setup Verification**: MCP servers activate automatically. For installation and troubleshooting, see [Installation Guide](../Getting-Started/installation.md) and [Troubleshooting](../Reference/troubleshooting.md). **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:** **Auto-Activation Logic:**
@ -327,7 +327,7 @@ echo 'export TAVILY_API_KEY="your_key"' >> ~/.bashrc
**Essential Reading:** **Essential Reading:**
- [Commands Guide](commands.md) - Commands that activate MCP servers - [Commands Guide](commands.md) - Commands that activate MCP servers
- [Quick Start Guide](../Getting-Started/quick-start.md) - MCP setup guide - [Quick Start Guide](../getting-started/quick-start.md) - MCP setup guide
**Advanced Usage:** **Advanced Usage:**
- [Behavioral Modes](modes.md) - Mode-MCP coordination - [Behavioral Modes](modes.md) - Mode-MCP coordination
@ -335,5 +335,5 @@ echo 'export TAVILY_API_KEY="your_key"' >> ~/.bashrc
- [Session Management](session-management.md) - Serena workflows - [Session Management](session-management.md) - Serena workflows
**Technical References:** **Technical References:**
- [Examples Cookbook](../Reference/examples-cookbook.md) - MCP workflow patterns - [Examples Cookbook](../reference/examples-cookbook.md) - MCP workflow patterns
- [Technical Architecture](../Developer-Guide/technical-architecture.md) - Integration details - [Technical Architecture](../developer-guide/technical-architecture.md) - Integration details

22
docs/User-Guide/modes.md → docs/user-guide/modes.md
View File

@ -460,8 +460,8 @@ Standard Approach: Consistent, professional baseline for all tasks
## Troubleshooting ## Troubleshooting
For troubleshooting help, see: For troubleshooting help, see:
- [Common Issues](../Reference/common-issues.md) - Quick fixes for frequent problems - [Common Issues](../reference/common-issues.md) - Quick fixes for frequent problems
- [Troubleshooting Guide](../Reference/troubleshooting.md) - Comprehensive problem resolution - [Troubleshooting Guide](../reference/troubleshooting.md) - Comprehensive problem resolution
### Common Issues ### Common Issues
- **Mode not activating**: Use manual flags: `--brainstorm`, `--introspect`, `--uc` - **Mode not activating**: Use manual flags: `--brainstorm`, `--introspect`, `--uc`
@ -549,7 +549,7 @@ For troubleshooting help, see:
/sc:reflect --type mode-status # Check current mode state /sc:reflect --type mode-status # Check current mode state
# Review request complexity and triggers # Review request complexity and triggers
``` ```
- See [Common Issues Guide](../Reference/common-issues.md) for mode installation problems - See [Common Issues Guide](../reference/common-issues.md) for mode installation problems
**Level 3: Expert Support (30+ min)** **Level 3: Expert Support (30+ min)**
```bash ```bash
@ -558,7 +558,7 @@ SuperClaude install --diagnose
# Check mode activation patterns # Check mode activation patterns
# Review behavioral triggers and thresholds # Review behavioral triggers and thresholds
``` ```
- See [Diagnostic Reference Guide](../Reference/diagnostic-reference.md) for behavioral mode analysis - See [Diagnostic Reference Guide](../reference/diagnostic-reference.md) for behavioral mode analysis
**Level 4: Community Support** **Level 4: Community Support**
- Report mode issues at [GitHub Issues](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues) - Report mode issues at [GitHub Issues](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues)
@ -634,26 +634,26 @@ SuperClaude's 5 behavioral modes create an **intelligent adaptation system** tha
**Learning Progression:** **Learning Progression:**
**🌱 Essential (Week 1)** **🌱 Essential (Week 1)**
- [Quick Start Guide](../Getting-Started/quick-start.md) - Mode activation examples - [Quick Start Guide](../getting-started/quick-start.md) - Mode activation examples
- [Commands Reference](commands.md) - Commands automatically activate modes - [Commands Reference](commands.md) - Commands automatically activate modes
- [Installation Guide](../Getting-Started/installation.md) - Set up behavioral modes - [Installation Guide](../getting-started/installation.md) - Set up behavioral modes
**🌿 Intermediate (Week 2-3)** **🌿 Intermediate (Week 2-3)**
- [Agents Guide](agents.md) - How modes coordinate with specialists - [Agents Guide](agents.md) - How modes coordinate with specialists
- [Flags Guide](flags.md) - Manual mode control and optimization - [Flags Guide](flags.md) - Manual mode control and optimization
- [Examples Cookbook](../Reference/examples-cookbook.md) - Mode patterns in practice - [Examples Cookbook](../reference/examples-cookbook.md) - Mode patterns in practice
**🌲 Advanced (Month 2+)** **🌲 Advanced (Month 2+)**
- [MCP Servers](mcp-servers.md) - Mode integration with enhanced capabilities - [MCP Servers](mcp-servers.md) - Mode integration with enhanced capabilities
- [Session Management](session-management.md) - Task Management mode workflows - [Session Management](session-management.md) - Task Management mode workflows
- [Getting Started](../Getting-Started/quick-start.md) - Mode usage patterns - [Getting Started](../getting-started/quick-start.md) - Mode usage patterns
**🔧 Expert** **🔧 Expert**
- [Technical Architecture](../Developer-Guide/technical-architecture.md) - Mode implementation details - [Technical Architecture](../developer-guide/technical-architecture.md) - Mode implementation details
- [Contributing Code](../Developer-Guide/contributing-code.md) - Extend mode capabilities - [Contributing Code](../developer-guide/contributing-code.md) - Extend mode capabilities
**Mode-Specific Guides:** **Mode-Specific Guides:**
- **Brainstorming**: [Requirements Discovery Patterns](../Reference/examples-cookbook.md#requirements) - **Brainstorming**: [Requirements Discovery Patterns](../reference/examples-cookbook.md#requirements)
- **Task Management**: [Session Management Guide](session-management.md) - **Task Management**: [Session Management Guide](session-management.md)
- **Orchestration**: [MCP Servers Guide](mcp-servers.md) - **Orchestration**: [MCP Servers Guide](mcp-servers.md)
- **Token Efficiency**: [Command Fundamentals](commands.md#token-efficiency) - **Token Efficiency**: [Command Fundamentals](commands.md#token-efficiency)

0
docs/User-Guide/session-management.md → docs/user-guide/session-management.md
View File

191
pr_documentation.md
View File

@ -1,191 +0,0 @@
# Pull Request: Redesign PM Agent as Self-Improvement Meta-Layer
## Summary
Redesigned PM Agent from task orchestration system to self-improvement workflow executor (meta-layer agent). PM Agent now complements existing auto-activation by systematically documenting implementations, analyzing mistakes, and maintaining knowledge base quality.
## Motivation
**Problem**: Initial PM Agent design competed with existing auto-activation system for task routing, creating confusion about responsibilities and adding unnecessary complexity.
**Solution**: Redefined PM Agent as a meta-layer that operates AFTER specialist agents complete tasks, focusing on:
- Post-implementation documentation
- Immediate mistake analysis and prevention
- Monthly documentation maintenance
- Pattern extraction and knowledge synthesis
**Value Proposition**: Transforms SuperClaude into a continuously learning system that accumulates knowledge, prevents recurring mistakes, and maintains fresh documentation without manual intervention.
## Changes
### 1. PM Agent Agent File (`superclaude/Agents/pm-agent.md`)
**Status**: Complete rewrite
**Before**:
- Category: orchestration
- Triggers: All user interactions (default mode)
- Role: Task router and sub-agent coordinator
- Competed with existing auto-activation
**After**:
- Category: meta
- Triggers: Post-implementation, mistake detection, monthly maintenance
- Role: Self-improvement workflow executor
- Complements existing auto-activation
**Key Additions**:
- Behavioral Mindset: "Think like a continuous learning system"
- Focus Areas: Implementation Documentation, Mistake Analysis, Pattern Recognition, Knowledge Maintenance, Self-Improvement Loop
- Self-Improvement Workflow Integration: BEFORE/DURING/AFTER/MISTAKE RECOVERY/MAINTENANCE phases
- Quality Standards: Latest, Minimal, Clear, Practical documentation criteria
- Performance Metrics: Documentation coverage, mistake prevention effectiveness, knowledge maintenance health
**Workflow Examples**:
1. Post-Implementation Documentation: Backend architect implements JWT → PM Agent documents pattern
2. Immediate Mistake Analysis: Kong Gateway bypass detected → PM Agent stops, analyzes, documents prevention
3. Monthly Documentation Maintenance: PM Agent prunes outdated docs, merges duplicates, updates versions
### 2. Framework Rules (`superclaude/Core/RULES.md`)
**Status**: Agent Orchestration section updated (lines 17-44)
**Changes**:
- Split orchestration into two clear layers:
- **Task Execution Layer**: Existing auto-activation (unchanged)
- **Self-Improvement Layer**: PM Agent meta-layer (new)
- Added orchestration flow diagram showing task execution → documentation cycle
- Clarified examples: ✅ Right patterns and ❌ Wrong anti-patterns
- Emphasized PM Agent activates AFTER task completion, not before/during
**Purpose**: Eliminate confusion between task routing (auto-activation) and learning (PM Agent)
### 3. README.md
**Status**: PM Agent description updated (line 208)
**Before**: "PM Agent orchestrates all interactions seamlessly"
**After**: "PM Agent ensures continuous learning through systematic documentation"
**Impact**: Accurate representation of PM Agent's meta-layer role in main documentation
### 4. Agents Guide (`docs/User-Guide/agents.md`)
**Status**: PM Agent section completely rewritten (lines 140-208)
**Changes**:
- Section title: "Orchestration Agent" → "Meta-Layer Agent"
- Expertise: Project orchestration → Self-improvement workflow executor
- Auto-Activation: Default mode for all interactions → Post-implementation, mistake detection, monthly maintenance
- Capabilities: Workflow orchestration → Implementation documentation, mistake analysis, pattern recognition, knowledge maintenance
- Examples: Vague feature requests → Post-implementation documentation, immediate mistake analysis, monthly maintenance
- Integration: Orchestrates entire ecosystem → Documents specialist agents' work
**Purpose**: User-facing documentation accurately reflects PM Agent's actual behavior
## Two-Layer Orchestration System
```
┌─────────────────────────────────────────────────────────┐
│ Task Execution Layer (Existing Auto-Activation) │
│ ─────────────────────────────────────────────────────── │
│ User Request → Context Analysis → Specialist Selection │
│ backend-architect | frontend-architect | security, etc. │
│ │
│ ↓ Implementation Complete ↓ │
└─────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────┐
│ Self-Improvement Layer (PM Agent Meta-Layer) │
│ ─────────────────────────────────────────────────────── │
│ PM Agent Auto-Triggers → Documentation → Learning │
│ Pattern Recording | Mistake Analysis | Maintenance │
│ │
│ ↓ Knowledge Base Updated ↓ │
└─────────────────────────────────────────────────────────┘
```
**Flow**:
1. User: "Add JWT authentication"
2. Task Execution Layer: Auto-activation → security-engineer + backend-architect → Implementation
3. Self-Improvement Layer: PM Agent auto-triggers → Documents JWT pattern in docs/authentication.md → Records security decisions → Updates CLAUDE.md
## Testing
**Validation Method**: Verified integration with existing self-improvement workflow
**Test Case**: agiletec project
- ✅ Reviewed `/Users/kazuki/github/agiletec/docs/self-improvement-workflow.md`
- ✅ Confirmed PM Agent design aligns with BEFORE/DURING/AFTER/MISTAKE RECOVERY phases
- ✅ Verified PM Agent complements (not competes with) existing workflow
- ✅ Confirmed agiletec workflow defines WHAT, PM Agent defines WHO executes it
**Integration Check**:
- ✅ PM Agent operates as meta-layer above specialist agents
- ✅ Existing auto-activation handles task routing (unchanged)
- ✅ PM Agent handles post-implementation documentation (new capability)
- ✅ No conflicts with existing agent activation patterns
## Breaking Changes
**None**. This is a design clarification and documentation update:
- ✅ Existing auto-activation continues to work identically
- ✅ Specialist agents (backend-architect, frontend-architect, etc.) unchanged
- ✅ User workflows remain the same
- ✅ Manual `@agent-[name]` override still works
- ✅ Commands (`/sc:implement`, `/sc:build`, etc.) unchanged
**New Capability**: PM Agent now automatically documents implementations and maintains knowledge base without user intervention.
## Impact on User Experience
**Before**:
- User requests task → Specialist agents implement → User manually documents (if at all)
- Mistakes repeated due to lack of systematic documentation
- Documentation becomes outdated over time
**After**:
- User requests task → Specialist agents implement → PM Agent auto-documents patterns
- Mistakes automatically analyzed with prevention checklists created
- Documentation systematically maintained through monthly reviews
**Result**: Zero additional user effort, continuous improvement built into framework
## Verification Checklist
- [x] PM Agent agent file completely rewritten with meta-layer design
- [x] RULES.md Agent Orchestration section updated with two-layer system
- [x] README.md PM Agent description updated
- [x] agents.md PM Agent section completely rewritten
- [x] Integration validated with agiletec project self-improvement workflow
- [x] All files properly formatted and consistent
- [x] No breaking changes to existing functionality
- [x] Documentation accurately reflects implementation
## Future Enhancements
**Potential Additions** (not included in this PR):
1. `/sc:pm status` - Show documentation coverage and maintenance health
2. `/sc:pm review` - Manual trigger for documentation review
3. Performance metrics dashboard - Track mistake prevention effectiveness
4. Integration with CI/CD - Auto-generate documentation on PR merge
**These are OPTIONAL** and should be separate PRs based on user feedback.
## Related Issues
Addresses internal design discussion about PM Agent role clarity and integration with existing auto-activation system.
## Reviewer Notes
**Key Points to Review**:
1. **pm-agent.md**: Complete rewrite - verify behavioral mindset, focus areas, and workflow examples make sense
2. **RULES.md**: Two-layer orchestration system - verify clear distinction between task execution and self-improvement
3. **agents.md**: User-facing documentation - verify accurate representation of PM Agent behavior
4. **Integration**: Verify PM Agent complements (not competes with) existing auto-activation
**Expected Outcome**: PM Agent transforms SuperClaude into a continuously learning system through systematic documentation, mistake analysis, and knowledge maintenance.
---
**PR Type**: Enhancement (Design Clarification)
**Complexity**: Medium (Documentation-focused, no code changes)
**Risk**: Low (No breaking changes, purely additive capability)