diff --git a/PR_DOCUMENTATION.md b/PR_DOCUMENTATION.md deleted file mode 100644 index 55556bb..0000000 --- a/PR_DOCUMENTATION.md +++ /dev/null @@ -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) diff --git a/README-ja.md b/README-ja.md index 3251059..9a268f5 100644 --- a/README-ja.md +++ b/README-ja.md @@ -275,55 +275,55 @@ pip install --break-system-packages SuperClaude -- 📝 [**クイックスタートガイド**](docs/Getting-Started/quick-start.md) +- 📝 [**クイックスタートガイド**](docs/getting-started/quick-start.md) *すぐに開始* -- 💾 [**インストールガイド**](docs/Getting-Started/installation.md) +- 💾 [**インストールガイド**](docs/getting-started/installation.md) *詳細なセットアップ手順* -- 🎯 [**コマンドリファレンス**](docs/User-Guide-jp/commands.md) +- 🎯 [**コマンドリファレンス**](docs/user-guide-jp/commands.md) *全21のスラッシュコマンド* -- 🤖 [**エージェントガイド**](docs/User-Guide-jp/agents.md) +- 🤖 [**エージェントガイド**](docs/user-guide-jp/agents.md) *14の専門エージェント* -- 🎨 [**動作モード**](docs/User-Guide-jp/modes.md) +- 🎨 [**動作モード**](docs/user-guide-jp/modes.md) *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つのサーバー統合* -- 💼 [**セッション管理**](docs/User-Guide-jp/session-management.md) +- 💼 [**セッション管理**](docs/user-guide-jp/session-management.md) *状態の保存と復元* -- 🏗️ [**技術アーキテクチャ**](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) *品質保証* -- ✨ [**ベストプラクティス**](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) *一般的な問題と修正* diff --git a/README-kr.md b/README-kr.md index 9f071ab..942c52b 100644 --- a/README-kr.md +++ b/README-kr.md @@ -278,55 +278,55 @@ pip install --break-system-packages SuperClaude -- 📝 [**빠른 시작 가이드**](docs/Getting-Started/quick-start.md) +- 📝 [**빠른 시작 가이드**](docs/getting-started/quick-start.md) *즉시 시작하기* -- 💾 [**설치 가이드**](docs/Getting-Started/installation.md) +- 💾 [**설치 가이드**](docs/getting-started/installation.md) *상세한 설정 단계* -- 🎯 [**명령어 레퍼런스**](docs/User-Guide/commands.md) +- 🎯 [**명령어 레퍼런스**](docs/user-guide/commands.md) *전체 21개 슬래시 명령어* -- 🤖 [**에이전트 가이드**](docs/User-Guide/agents.md) +- 🤖 [**에이전트 가이드**](docs/user-guide/agents.md) *14개 전문 에이전트* -- 🎨 [**작동 모드**](docs/User-Guide/modes.md) +- 🎨 [**작동 모드**](docs/user-guide/modes.md) *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개 서버 통합* -- 💼 [**세션 관리**](docs/User-Guide/session-management.md) +- 💼 [**세션 관리**](docs/user-guide/session-management.md) *상태 저장 및 복원* -- 🏗️ [**기술 아키텍처**](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) *품질 보증* -- ✨ [**모범 사례**](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) *일반적인 문제와 수정* diff --git a/README-zh.md b/README-zh.md index a4dde36..1c65fa9 100644 --- a/README-zh.md +++ b/README-zh.md @@ -275,55 +275,55 @@ pip install --break-system-packages SuperClaude -- 📝 [**快速开始指南**](docs/Getting-Started/quick-start.md) +- 📝 [**快速开始指南**](docs/getting-started/quick-start.md) *快速上手使用* -- 💾 [**安装指南**](docs/Getting-Started/installation.md) +- 💾 [**安装指南**](docs/getting-started/installation.md) *详细的安装说明* -- 🎯 [**命令参考**](docs/User-Guide-zh/commands.md) +- 🎯 [**命令参考**](docs/user-guide-zh/commands.md) *全部21个斜杠命令* -- 🤖 [**智能体指南**](docs/User-Guide-zh/agents.md) +- 🤖 [**智能体指南**](docs/user-guide-zh/agents.md) *14个专业智能体* -- 🎨 [**行为模式**](docs/User-Guide-zh/modes.md) +- 🎨 [**行为模式**](docs/user-guide-zh/modes.md) *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个服务器集成* -- 💼 [**会话管理**](docs/User-Guide-zh/session-management.md) +- 💼 [**会话管理**](docs/user-guide-zh/session-management.md) *保存和恢复状态* -- 🏗️ [**技术架构**](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) *质量保证* -- ✨ [**最佳实践**](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) *常见问题和修复* diff --git a/README.md b/README.md index 2f79fa3..e639a77 100644 --- a/README.md +++ b/README.md @@ -392,51 +392,51 @@ The Deep Research system intelligently coordinates multiple tools: -- 📝 [**Quick Start Guide**](docs/Getting-Started/quick-start.md) +- 📝 [**Quick Start Guide**](docs/getting-started/quick-start.md) *Get up and running fast* -- 💾 [**Installation Guide**](docs/Getting-Started/installation.md) +- 💾 [**Installation Guide**](docs/getting-started/installation.md) *Detailed setup instructions* -- 🎯 [**Commands Reference**](docs/User-Guide/commands.md) +- 🎯 [**Commands Reference**](docs/user-guide/commands.md) *All 25 slash commands* -- 🤖 [**Agents Guide**](docs/User-Guide/agents.md) +- 🤖 [**Agents Guide**](docs/user-guide/agents.md) *15 specialized agents* -- 🎨 [**Behavioral Modes**](docs/User-Guide/modes.md) +- 🎨 [**Behavioral Modes**](docs/user-guide/modes.md) *7 adaptive modes* -- 🚩 [**Flags Guide**](docs/User-Guide/flags.md) +- 🚩 [**Flags Guide**](docs/user-guide/flags.md) *Control behaviors* -- 🔧 [**MCP Servers**](docs/User-Guide/mcp-servers.md) +- 🔧 [**MCP Servers**](docs/user-guide/mcp-servers.md) *7 server integrations* -- 💼 [**Session Management**](docs/User-Guide/session-management.md) +- 💼 [**Session Management**](docs/user-guide/session-management.md) *Save & restore state* -- 🏗️ [**Technical Architecture**](docs/Developer-Guide/technical-architecture.md) +- 🏗️ [**Technical Architecture**](docs/developer-guide/technical-architecture.md) *System design details* -- 💻 [**Contributing Code**](docs/Developer-Guide/contributing-code.md) +- 💻 [**Contributing Code**](docs/developer-guide/contributing-code.md) *Development workflow* -- 🧪 [**Testing & Debugging**](docs/Developer-Guide/testing-debugging.md) +- 🧪 [**Testing & Debugging**](docs/developer-guide/testing-debugging.md) *Quality assurance* -- 📓 [**Examples Cookbook**](docs/Reference/examples-cookbook.md) +- 📓 [**Examples Cookbook**](docs/reference/examples-cookbook.md) *Real-world recipes* -- 🔍 [**Troubleshooting**](docs/Reference/troubleshooting.md) +- 🔍 [**Troubleshooting**](docs/reference/troubleshooting.md) *Common issues & fixes* diff --git a/docs/Development/ARCHITECTURE.md b/docs/Development/ARCHITECTURE.md index 2039eb6..8057b57 100644 --- a/docs/Development/ARCHITECTURE.md +++ b/docs/Development/ARCHITECTURE.md @@ -236,7 +236,7 @@ Session End: "learned": ["Session Lifecycle pattern", "PDCA automation"] }, "next_actions": [ - "Create docs/Development/ structure", + "Create docs/development/ structure", "Write ARCHITECTURE.md", "Configure Serena MCP server" ] diff --git a/docs/Development/PROJECT_STATUS.md b/docs/Development/PROJECT_STATUS.md index 01f5cde..ffeb5d3 100644 --- a/docs/Development/PROJECT_STATUS.md +++ b/docs/Development/PROJECT_STATUS.md @@ -48,11 +48,11 @@ - ✅ Agents/pm-agent.md updated ### Documentation -- ✅ docs/Development/ARCHITECTURE.md -- ✅ docs/Development/ROADMAP.md -- ✅ docs/Development/TASKS.md -- ✅ docs/Development/PROJECT_STATUS.md -- ✅ docs/pm-agent-implementation-status.md +- ✅ docs/development/ARCHITECTURE.md +- ✅ docs/development/ROADMAP.md +- ✅ docs/development/TASKS.md +- ✅ docs/development/PROJECT_STATUS.md +- ✅ docs/PM_AGENT.md --- @@ -135,7 +135,7 @@ ### Week 2-3 - [ ] Implement PM Agent Core (session_lifecycle, pdca_engine, memory_ops) - [ ] Write unit tests -- [ ] Update User-Guide documentation +- [ ] Update user-guide documentation ### Week 4-5 - [ ] Configure Serena MCP server @@ -147,7 +147,7 @@ ## 📝 Recent Changes ### 2025-10-14 -- Created docs/Development/ structure +- Created docs/development/ structure - Wrote ARCHITECTURE.md (system overview) - Wrote ROADMAP.md (5-phase development plan) - Wrote TASKS.md (task tracking) diff --git a/docs/Development/ROADMAP.md b/docs/Development/ROADMAP.md index 47a2414..90ecce6 100644 --- a/docs/Development/ROADMAP.md +++ b/docs/Development/ROADMAP.md @@ -31,7 +31,7 @@ Transform SuperClaude into a self-improving development platform with PM Agent m ### 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 `ROADMAP.md` - Phase-based development plan with checkboxes - [ ] Write `TASKS.md` - Current task tracking system @@ -40,11 +40,11 @@ Transform SuperClaude into a self-improving development platform with PM Agent m ### Deliverables -- [x] **docs/Development/ARCHITECTURE.md** - Complete system architecture -- [x] **docs/Development/ROADMAP.md** - This file (development roadmap) -- [ ] **docs/Development/TASKS.md** - Task management with checkboxes -- [ ] **docs/Development/PROJECT_STATUS.md** - Current status and metrics -- [ ] **docs/Development/pm-agent-integration.md** - Integration procedures +- [x] **docs/development/ARCHITECTURE.md** - Complete system architecture +- [x] **docs/development/ROADMAP.md** - This file (development roadmap) +- [ ] **docs/development/TASKS.md** - Task management with checkboxes +- [ ] **docs/development/PROJECT_STATUS.md** - Current status and metrics +- [ ] **docs/development/pm-agent-integration.md** - Integration procedures ### Success Criteria @@ -69,9 +69,9 @@ Transform SuperClaude into a self-improving development platform with PM Agent m #### Documentation Updates - [x] Update `superclaude/Commands/pm.md` with Session Lifecycle - [x] Update `superclaude/Agents/pm-agent.md` with PDCA Cycle -- [x] Create `docs/pm-agent-implementation-status.md` -- [ ] Update `docs/User-Guide/agents.md` - Add PM Agent section -- [ ] Update `docs/User-Guide/commands.md` - Add /sc:pm command +- [x] Create `docs/PM_AGENT.md` +- [ ] Update `docs/user-guide/agents.md` - Add PM Agent section +- [ ] Update `docs/user-guide/commands.md` - Add /sc:pm command #### Core Implementation - [ ] Implement `superclaude/Core/session_lifecycle.py` @@ -100,7 +100,7 @@ Transform SuperClaude into a self-improving development platform with PM Agent m ### Deliverables - [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/pdca_engine.py** - PDCA automation - [ ] **superclaude/Core/memory_ops.py** - Memory operations @@ -269,7 +269,7 @@ Transform SuperClaude into a self-improving development platform with PM Agent m ### Deliverables - [ ] **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 - [ ] **Performance Report** - Startup time impact analysis diff --git a/docs/Development/TASKS.md b/docs/Development/TASKS.md index 439a532..09e34da 100644 --- a/docs/Development/TASKS.md +++ b/docs/Development/TASKS.md @@ -8,7 +8,7 @@ ## 🔥 High Priority (This Week: 2025-10-14 ~ 2025-10-20) ### Phase 1: Documentation Structure -- [x] Create docs/Development/ directory +- [x] Create docs/development/ directory - [x] Write ARCHITECTURE.md - [x] Write ROADMAP.md - [ ] Write TASKS.md (this file) @@ -21,7 +21,7 @@ - [x] Design PDCA Cycle - [x] Update Commands/pm.md - [x] Update Agents/pm-agent.md -- [x] Create pm-agent-implementation-status.md +- [x] Create PM_AGENT.md - [ ] Commit PM Agent Mode changes --- @@ -33,7 +33,7 @@ - [ ] Implement superclaude/Core/pdca_engine.py - [ ] Implement superclaude/Core/memory_ops.py - [ ] Write unit tests for PM Agent core -- [ ] Update User-Guide documentation +- [ ] Update user-guide documentation ### Testing & Validation - [ ] Create test suite for session_lifecycle @@ -84,8 +84,8 @@ ### 2025-10-14 - [x] Salvaged PM Agent mode changes from ~/.claude - [x] Cleaned up ~/.claude git repository -- [x] Created pm-agent-implementation-status.md -- [x] Created docs/Development/ directory +- [x] Created PM_AGENT.md +- [x] Created docs/development/ directory - [x] Wrote ARCHITECTURE.md - [x] Wrote ROADMAP.md - [x] Wrote TASKS.md diff --git a/docs/Development/installation-flow-understanding.md b/docs/Development/installation-flow-understanding.md index 1e7aee2..e981e14 100644 --- a/docs/Development/installation-flow-understanding.md +++ b/docs/Development/installation-flow-understanding.md @@ -286,7 +286,7 @@ Read ~/.claude/commands/sc/pm.md ### Phase 3: 改善案作成 ```bash # このプロジェクト内で（Git管理） -Write docs/Development/hypothesis-pm-enhancement-2025-10-14.md +Write docs/development/hypothesis-pm-enhancement-2025-10-14.md 内容: - 現状の問題（ドキュメント寄りすぎ、PMO機能不足） diff --git a/docs/Development/pm-agent-ideal-workflow.md b/docs/Development/pm-agent-ideal-workflow.md index 8d3e49b..c7adf40 100644 --- a/docs/Development/pm-agent-ideal-workflow.md +++ b/docs/Development/pm-agent-ideal-workflow.md @@ -23,12 +23,12 @@ 1. ドキュメント読み込み: 優先順位: 1. タスク管理ドキュメント → 進捗確認 - - docs/Development/tasks/current-tasks.md + - docs/development/tasks/current-tasks.md - 前回どこまでやったか - 次に何をすべきか 2. アーキテクチャドキュメント → 仕組み理解 - - docs/Development/architecture-*.md + - docs/development/architecture-*.md - このプロジェクトの構造 - インストールフロー - コンポーネント連携 @@ -36,7 +36,7 @@ 3. 禁止事項・ルール → 制約確認 - CLAUDE.md（グローバル） - PROJECT/CLAUDE.md（プロジェクト固有） - - docs/Development/constraints.md + - docs/development/constraints.md 4. 過去の学び → 同じミスを防ぐ - docs/mistakes/ （失敗記録） @@ -88,7 +88,7 @@ ```yaml 1. 改善仮説作成: # このプロジェクト内で（Git管理） - File: docs/Development/hypothesis-YYYY-MM-DD.md + File: docs/development/hypothesis-YYYY-MM-DD.md 内容: - 現状の問題点 @@ -127,7 +127,7 @@ - quality-engineer: テスト設計 2. 実装記録: - File: docs/Development/experiment-YYYY-MM-DD.md + File: docs/development/experiment-YYYY-MM-DD.md 内容: - 試行錯誤の記録 @@ -194,7 +194,7 @@ - チェックリスト 3. タスク更新: - File: docs/Development/tasks/current-tasks.md + File: docs/development/tasks/current-tasks.md 内容: - 完了したタスク @@ -292,7 +292,7 @@ docs/ │ └── experiment-*.md # 実験記録 ├── patterns/ # 成功パターン（清書後） ├── mistakes/ # 失敗記録と防止策 -└── (既存のUser-Guide等) +└── (既存のuser-guide等) ``` --- @@ -335,7 +335,7 @@ docs/ このドキュメント作成後: 1. 既存のインストールロジック理解（setup/components/） -2. タスク管理ドキュメント作成（docs/Development/tasks/） +2. タスク管理ドキュメント作成（docs/development/tasks/） 3. PM Agent実装修正（このワークフローを実際に実装） このドキュメント自体が**PM Agentの憲法**となる。 diff --git a/docs/Development/pm-agent-integration.md b/docs/Development/pm-agent-integration.md index 2656a72..d50c8ba 100644 --- a/docs/Development/pm-agent-integration.md +++ b/docs/Development/pm-agent-integration.md @@ -466,7 +466,7 @@ tests/integration/ - [ARCHITECTURE.md](./ARCHITECTURE.md) - System architecture - [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 - [Agents/pm-agent.md](../../superclaude/Agents/pm-agent.md) - PM Agent persona diff --git a/docs/Development/project-structure-understanding.md b/docs/Development/project-structure-understanding.md index 9f82f66..9083815 100644 --- a/docs/Development/project-structure-understanding.md +++ b/docs/Development/project-structure-understanding.md @@ -146,7 +146,7 @@ cat ~/.claude/commands/sc/pm.md # 現在の仕様確認 cd ~/github/SuperClaude_Framework # 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: ドキュメント駆動開発 -1. 理解 → docs/Development/ に記録 -2. 仮説 → docs/Development/hypothesis-*.md -3. 実験 → docs/Development/experiment-*.md +1. 理解 → docs/development/ に記録 +2. 仮説 → docs/development/hypothesis-*.md +3. 実験 → docs/development/experiment-*.md 4. 成功 → docs/patterns/ 5. 失敗 → docs/mistakes/ @@ -336,7 +336,7 @@ vim ~/.claude/commands/sc/pm.md ```bash # ✅ CORRECT 1. setup/components/ でロジック理解 -2. docs/Development/ に改善案記録 +2. docs/development/ に改善案記録 3. setup/ 側で変更・テスト 4. Git コミット 5. SuperClaude install --dev で動作確認 @@ -357,7 +357,7 @@ vim ~/.claude/commands/sc/pm.md - 現在の動作理解 3. **改善提案作成** - - `docs/Development/hypothesis-*.md` 作成 + - `docs/development/hypothesis-*.md` 作成 - ユーザーレビュー 4. **実装・テスト** diff --git a/docs/Development/tasks/current-tasks.md b/docs/Development/tasks/current-tasks.md index c38c4c7..d839987 100644 --- a/docs/Development/tasks/current-tasks.md +++ b/docs/Development/tasks/current-tasks.md @@ -20,22 +20,22 @@ ### Phase 1: ドキュメント基盤整備 - [x] **PM Agent理想ワークフローをドキュメント化** - - File: `docs/Development/pm-agent-ideal-workflow.md` + - File: `docs/development/pm-agent-ideal-workflow.md` - Content: 完璧なワークフロー（7フェーズ） - Purpose: 次回セッションで同じ説明を繰り返さない - [x] **プロジェクト構造理解をドキュメント化** - - File: `docs/Development/project-structure-understanding.md` + - File: `docs/development/project-structure-understanding.md` - Content: Git管理とインストール後環境の区別 - Purpose: 何百回も説明した内容を外部化 - [x] **インストールフロー理解をドキュメント化** - - File: `docs/Development/installation-flow-understanding.md` + - File: `docs/development/installation-flow-understanding.md` - Content: CommandsComponent動作の完全理解 - Source: `superclaude/commands/*.md` → `~/.claude/commands/sc/*.md` - [x] **ディレクトリ構造作成** - - `docs/Development/tasks/` - タスク管理 + - `docs/development/tasks/` - タスク管理 - `docs/patterns/` - 成功パターン記録 - `docs/mistakes/` - 失敗記録と防止策 @@ -58,7 +58,7 @@ - [ ] **改善提案ドキュメント作成** - Status: Pending - Action: 仮説ドキュメント作成 - - File: `docs/Development/hypothesis-pm-enhancement-2025-10-14.md` + - File: `docs/development/hypothesis-pm-enhancement-2025-10-14.md` - Content: - 現状の問題点（ドキュメント寄り、PMO機能不足） - 改善案（自律的PDCA、自己評価） @@ -130,7 +130,7 @@ - テスト時のバックアップ・復元必須 - **ドキュメント駆動開発** - - 理解 → docs/Development/ に記録 + - 理解 → docs/development/ に記録 - 仮説 → hypothesis-*.md - 実験 → experiment-*.md - 成功 → docs/patterns/ diff --git a/docs/PM_AGENT.md b/docs/PM_AGENT.md new file mode 100644 index 0000000..d7fb8d9 --- /dev/null +++ b/docs/PM_AGENT.md @@ -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) diff --git a/docs/README.md b/docs/README.md index af84744..ce87fc7 100644 --- a/docs/README.md +++ b/docs/README.md @@ -12,7 +12,7 @@ ## 🚀 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 # Recommended for Linux/macOS pipx install SuperClaude && SuperClaude install @@ -23,37 +23,37 @@ pip install SuperClaude && SuperClaude install # 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 ### 🌱 Start Here (New Users) | Guide | Purpose | |-------|---------| -| **[Quick Start](Getting-Started/quick-start.md)** | Setup and first commands | -| **[Installation](Getting-Started/installation.md)** | Detailed setup instructions | -| **[Commands Guide](User-Guide/commands.md)** | All 21 `/sc:` commands | +| **[Quick Start](getting-started/quick-start.md)** | Setup and first commands | +| **[Installation](getting-started/installation.md)** | Detailed setup instructions | +| **[Commands Guide](user-guide/commands.md)** | All 21 `/sc:` commands | ### 🌿 Daily Usage (Regular Users) | Guide | Purpose | Use For | |-------|---------|---------| -| **[Commands Guide](User-Guide/commands.md)** | Master all `/sc:` commands | Daily development | -| **[Agents Guide](User-Guide/agents.md)** | 14 domain specialists (`@agent-*`) | Expert assistance | -| **[Flags Guide](User-Guide/flags.md)** | Command behavior modification | Optimization | -| **[Modes Guide](User-Guide/modes.md)** | 5 behavioral modes | Workflow optimization | +| **[Commands Guide](user-guide/commands.md)** | Master all `/sc:` commands | Daily development | +| **[Agents Guide](user-guide/agents.md)** | 14 domain specialists (`@agent-*`) | Expert assistance | +| **[Flags Guide](user-guide/flags.md)** | Command behavior modification | Optimization | +| **[Modes Guide](user-guide/modes.md)** | 5 behavioral modes | Workflow optimization | ### 🌲 Reference & Advanced (Power Users) | Guide | Purpose | Use For | |-------|---------|---------| -| **[Troubleshooting](Reference/troubleshooting.md)** | Problem resolution | When things break | -| **[Examples Cookbook](Reference/examples-cookbook.md)** | Practical usage patterns | Learning workflows | -| **[MCP Servers](User-Guide/mcp-servers.md)** | 6 enhanced capabilities | Advanced features | +| **[Troubleshooting](reference/troubleshooting.md)** | Problem resolution | When things break | +| **[Examples Cookbook](reference/examples-cookbook.md)** | Practical usage patterns | Learning workflows | +| **[MCP Servers](user-guide/mcp-servers.md)** | 6 enhanced capabilities | Advanced features | ### 🔧 Development & Contributing | Guide | Purpose | Audience | |-------|---------|----------| -| **[Technical Architecture](Developer-Guide/technical-architecture.md)** | System design | Contributors | -| **[Contributing](Developer-Guide/contributing-code.md)** | Development workflow | Developers | +| **[Technical Architecture](developer-guide/technical-architecture.md)** | System design | Contributors | +| **[Contributing](developer-guide/contributing-code.md)** | Development workflow | Developers | ## 🔑 Key Concepts @@ -112,10 +112,10 @@ User Input → Claude Code → Reads SuperClaude Context → Modified Behavior ## 🆘 Getting Help -**Quick Issues** (< 2 min): [Common Issues →](Reference/common-issues.md) -**Complex Problems**: [Full Troubleshooting Guide →](Reference/troubleshooting.md) -**Installation Issues**: [Installation Guide →](Getting-Started/installation.md) -**Command Help**: [Commands Guide →](User-Guide/commands.md) +**Quick Issues** (< 2 min): [Common Issues →](reference/common-issues.md) +**Complex Problems**: [Full Troubleshooting Guide →](reference/troubleshooting.md) +**Installation Issues**: [Installation Guide →](getting-started/installation.md) +**Command Help**: [Commands Guide →](user-guide/commands.md) **Community Support**: [GitHub Discussions](https://github.com/SuperClaude-Org/SuperClaude_Framework/discussions) ## 🤔 Common Misconceptions Clarified diff --git a/docs/Developer-Guide/README.md b/docs/developer-guide/README.md similarity index 100% rename from docs/Developer-Guide/README.md rename to docs/developer-guide/README.md diff --git a/docs/Developer-Guide/contributing-code.md b/docs/developer-guide/contributing-code.md similarity index 100% rename from docs/Developer-Guide/contributing-code.md rename to docs/developer-guide/contributing-code.md diff --git a/docs/Developer-Guide/documentation-index.md b/docs/developer-guide/documentation-index.md similarity index 99% rename from docs/Developer-Guide/documentation-index.md rename to docs/developer-guide/documentation-index.md index 53052e6..76eff7e 100644 --- a/docs/Developer-Guide/documentation-index.md +++ b/docs/developer-guide/documentation-index.md @@ -1,4 +1,4 @@ -# SuperClaude Framework Developer-Guide Index +# SuperClaude Framework developer-guide Index ## Document Navigation Guide diff --git a/docs/Developer-Guide/technical-architecture.md b/docs/developer-guide/technical-architecture.md similarity index 100% rename from docs/Developer-Guide/technical-architecture.md rename to docs/developer-guide/technical-architecture.md diff --git a/docs/Developer-Guide/testing-debugging.md b/docs/developer-guide/testing-debugging.md similarity index 100% rename from docs/Developer-Guide/testing-debugging.md rename to docs/developer-guide/testing-debugging.md diff --git a/docs/Getting-Started/installation.md b/docs/getting-started/installation.md similarity index 96% rename from docs/Getting-Started/installation.md rename to docs/getting-started/installation.md index db3a054..80a81a9 100644 --- a/docs/Getting-Started/installation.md +++ b/docs/getting-started/installation.md @@ -470,24 +470,24 @@ brew install python3 **First Week:** - [Quick Start Guide](quick-start.md) -- [Commands Reference](../User-Guide/commands.md) +- [Commands Reference](../user-guide/commands.md) - Try `/sc:brainstorm` **Week 2-3:** -- [Behavioral Modes](../User-Guide/modes.md) -- [Agents Guide](../User-Guide/agents.md) -- [Examples Cookbook](../Reference/examples-cookbook.md) +- [Behavioral Modes](../user-guide/modes.md) +- [Agents Guide](../user-guide/agents.md) +- [Examples Cookbook](../reference/examples-cookbook.md) **Advanced:** -- [MCP Servers](../User-Guide/mcp-servers.md) -- [Technical Architecture](../Developer-Guide/technical-architecture.md) -- [Contributing Code](../Developer-Guide/contributing-code.md) +- [MCP Servers](../user-guide/mcp-servers.md) +- [Technical Architecture](../developer-guide/technical-architecture.md) +- [Contributing Code](../developer-guide/contributing-code.md) diff --git a/docs/Getting-Started/quick-start.md b/docs/getting-started/quick-start.md similarity index 95% rename from docs/Getting-Started/quick-start.md rename to docs/getting-started/quick-start.md index f825ae5..c0441d1 100644 --- a/docs/Getting-Started/quick-start.md +++ b/docs/getting-started/quick-start.md @@ -435,8 +435,8 @@ Start simple with basic commands. Complexity emerges naturally as needed. **First Week:** - [Installation Guide](installation.md) -- [Commands Reference](../User-Guide/commands.md) -- [Examples Cookbook](../Reference/examples-cookbook.md) +- [Commands Reference](../user-guide/commands.md) +- [Examples Cookbook](../reference/examples-cookbook.md) Start with `/sc:brainstorm` @@ -444,9 +444,9 @@ Start with `/sc:brainstorm` **Growing Skills:** -- [Behavioral Modes](../User-Guide/modes.md) -- [Agents Guide](../User-Guide/agents.md) -- [Session Management](../User-Guide/session-management.md) +- [Behavioral Modes](../user-guide/modes.md) +- [Agents Guide](../user-guide/agents.md) +- [Session Management](../user-guide/session-management.md) Explore mode combinations @@ -454,9 +454,9 @@ Explore mode combinations **Expert Usage:** -- [MCP Servers](../User-Guide/mcp-servers.md) -- [Technical Architecture](../Developer-Guide/technical-architecture.md) -- [Contributing](../Developer-Guide/contributing-code.md) +- [MCP Servers](../user-guide/mcp-servers.md) +- [Technical Architecture](../developer-guide/technical-architecture.md) +- [Contributing](../developer-guide/contributing-code.md) Create custom workflows @@ -465,10 +465,10 @@ Create custom workflows

- + Commands - + Examples

diff --git a/docs/Reference/README.md b/docs/reference/README.md similarity index 98% rename from docs/Reference/README.md rename to docs/reference/README.md index 713cddf..d538c30 100644 --- a/docs/Reference/README.md +++ b/docs/reference/README.md @@ -40,7 +40,7 @@ This documentation is organized for **progressive learning** with multiple entry **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 Day 3-4: basic-examples.md ↓ Practical application and pattern recognition @@ -159,7 +159,7 @@ Advanced Analysis: diagnostic-reference.md ### Immediate Issues - **Command not working**: Check [common-issues.md](./common-issues.md) → Common SuperClaude Problems -- **Session lost**: Use `/sc:load` → See [Session Management](../User-Guide/session-management.md) +- **Session lost**: Use `/sc:load` → See [Session Management](../user-guide/session-management.md) - **Flag confusion**: Check [basic-examples.md](./basic-examples.md) → Flag Usage Examples ### Development Blockers @@ -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. diff --git a/docs/Reference/advanced-patterns.md b/docs/reference/advanced-patterns.md similarity index 100% rename from docs/Reference/advanced-patterns.md rename to docs/reference/advanced-patterns.md diff --git a/docs/Reference/advanced-workflows.md b/docs/reference/advanced-workflows.md similarity index 100% rename from docs/Reference/advanced-workflows.md rename to docs/reference/advanced-workflows.md diff --git a/docs/Reference/basic-examples.md b/docs/reference/basic-examples.md similarity index 100% rename from docs/Reference/basic-examples.md rename to docs/reference/basic-examples.md diff --git a/docs/Reference/claude-code-history-management.md b/docs/reference/claude-code-history-management.md similarity index 100% rename from docs/Reference/claude-code-history-management.md rename to docs/reference/claude-code-history-management.md diff --git a/docs/Reference/common-issues.md b/docs/reference/common-issues.md similarity index 100% rename from docs/Reference/common-issues.md rename to docs/reference/common-issues.md diff --git a/docs/Reference/diagnostic-reference.md b/docs/reference/diagnostic-reference.md similarity index 100% rename from docs/Reference/diagnostic-reference.md rename to docs/reference/diagnostic-reference.md diff --git a/docs/Reference/examples-cookbook.md b/docs/reference/examples-cookbook.md similarity index 96% rename from docs/Reference/examples-cookbook.md rename to docs/reference/examples-cookbook.md index 42a9d82..e0a7e98 100644 --- a/docs/Reference/examples-cookbook.md +++ b/docs/reference/examples-cookbook.md @@ -95,7 +95,7 @@ ## Learning Progression Roadmap ### 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) 3. **Patterns**: Learn [Basic Usage Patterns](./basic-examples.md#basic-usage-patterns) 4. **Success**: Can execute common development tasks independently @@ -151,9 +151,9 @@ ## Support Resources **Documentation**: -- [Commands Reference](../User-Guide/commands.md) - Complete command documentation -- [Agents Guide](../User-Guide/agents.md) - Multi-agent coordination -- [MCP Servers](../User-Guide/mcp-servers.md) - Enhanced capabilities +- [Commands Reference](../user-guide/commands.md) - Complete command documentation +- [Agents Guide](../user-guide/agents.md) - Multi-agent coordination +- [MCP Servers](../user-guide/mcp-servers.md) - Enhanced capabilities - [Advanced Workflows](./advanced-workflows.md) - Complex coordination patterns **Community**: @@ -162,7 +162,7 @@ - [Contributing Guide](../CONTRIBUTING.md) - Framework contribution **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 --- diff --git a/docs/Reference/integration-patterns.md b/docs/reference/integration-patterns.md similarity index 100% rename from docs/Reference/integration-patterns.md rename to docs/reference/integration-patterns.md diff --git a/docs/Reference/mcp-server-guide.md b/docs/reference/mcp-server-guide.md similarity index 99% rename from docs/Reference/mcp-server-guide.md rename to docs/reference/mcp-server-guide.md index 4e3b0e6..ff69db0 100644 --- a/docs/Reference/mcp-server-guide.md +++ b/docs/reference/mcp-server-guide.md @@ -732,7 +732,7 @@ echo "Test MCP servers in Claude Code after restart" ## Related Resources ### MCP-Specific Documentation -- **Core SuperClaude Guide**: [../User-Guide/mcp-servers.md](../User-Guide/mcp-servers.md) - MCP server overview and usage +- **Core SuperClaude Guide**: [../user-guide/mcp-servers.md](../user-guide/mcp-servers.md) - MCP server overview and usage - **Common Issues**: [common-issues.md](./common-issues.md) - General troubleshooting procedures - **Diagnostic Reference**: [diagnostic-reference.md](./diagnostic-reference.md) - Advanced diagnostic procedures diff --git a/docs/Reference/troubleshooting.md b/docs/reference/troubleshooting.md similarity index 95% rename from docs/Reference/troubleshooting.md rename to docs/reference/troubleshooting.md index 267919a..da32212 100644 --- a/docs/Reference/troubleshooting.md +++ b/docs/reference/troubleshooting.md @@ -116,8 +116,8 @@ SuperClaude install --fresh ## Get Help **Documentation:** -- [Installation Guide](../Getting-Started/installation.md) - Setup issues -- [Commands Guide](../User-Guide/commands.md) - Usage issues +- [Installation Guide](../getting-started/installation.md) - Setup issues +- [Commands Guide](../user-guide/commands.md) - Usage issues **Community:** - [GitHub Issues](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues) diff --git a/docs/Templates/__init__.py b/docs/templates/__init__.py similarity index 100% rename from docs/Templates/__init__.py rename to docs/templates/__init__.py diff --git a/docs/User-Guide-jp/agents.md b/docs/user-guide-jp/agents.md similarity index 93% rename from docs/User-Guide-jp/agents.md rename to docs/user-guide-jp/agents.md index 7b75e26..16816e1 100644 --- a/docs/User-Guide-jp/agents.md +++ b/docs/user-guide-jp/agents.md @@ -1,12 +1,12 @@ # 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 のドメイン スペシャリスト エージェントを提供します。 ## 🧪 エージェントのアクティベーションのテスト -[](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 エージェントとは何ですか? -[](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/`。 @@ -49,11 +49,11 @@ SuperClaude は、Claude Code が専門知識を得るために呼び出すこ ### エージェントの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- プレフィックスを使用した手動呼び出し -[](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 # Directly invoke a specific agent @@ -64,7 +64,7 @@ SuperClaude は、Claude Code が専門知識を得るために呼び出すこ #### 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が最適なスペシャリストにルーティングするための動作ガイドラインを提供します。 @@ -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 # 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 # 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 # Start with command (auto-activation) @@ -165,15 +165,15 @@ Task Analysis → ## 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の信頼性とデータの整合性を重視した堅牢なサーバーサイドシステム設計 @@ -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 アプリケーション アーキテクチャ @@ -276,7 +276,7 @@ Task Analysis → ### 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 エキスパート 🐍 -[](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 開発 @@ -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 サーバー統合 -[](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 サーバーによる拡張機能**: @@ -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/troubleshooting.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/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 セッションを再起動します。 @@ -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` -- 協調分析については[診断リファレンスガイド](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 -[](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が、さまざまなレベルの専門知識を持つすべてのドメインを処理します。 **エージェントアプローチ**: 専門のエキスパートが、深いドメイン知識と集中的な問題解決で協力します。 @@ -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コマンドをマスターする -- **[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/commands.md)**- 最適なエージェント調整をトリガーするSuperClaudeコマンドをマスターする +- **[MCP サーバー](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/mcp-servers.md)**- 専用ツールの統合によるエージェント機能の強化 +- **[セッション管理](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md)**- 永続的なエージェントコンテキストによる長期ワークフロー ### 高度な使用法 -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#advanced-usage) +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#advanced-usage) -- **[行動モード](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/modes.md)**- エージェントの調整を強化するためのコンテキスト最適化 -- **[はじめに](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Getting-Started/quick-start.md)**- エージェントの最適化のための専門家のテクニック -- **[例のクックブック](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Reference/examples-cookbook.md)**- 現実世界のエージェントの調整パターン +- **[行動モード](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md)**- エージェントの調整を強化するためのコンテキスト最適化 +- **[はじめに](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/getting-started/quick-start.md)**- エージェントの最適化のための専門家のテクニック +- **[例のクックブック](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/reference/examples-cookbook.md)**- 現実世界のエージェントの調整パターン ### 開発リソース -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#development-resources) +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#development-resources) -- **[技術アーキテクチャ](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Developer-Guide/technical-architecture.md)**- SuperClaude のエージェント システム設計を理解する -- **[貢献](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Developer-Guide/contributing-code.md)**- エージェントの機能と調整パターンの拡張 +- **[技術アーキテクチャ](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/developer-guide/technical-architecture.md)**- SuperClaude のエージェント システム設計を理解する +- **[貢献](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/developer-guide/contributing-code.md)**- エージェントの機能と調整パターンの拡張 --- ## エージェントとしての道のり 🚀 -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md#your-agent-journey-) +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#your-agent-journey-) **第1週：自然な使用法** 自然な言語による説明から始めましょう。どのエージェントが、そしてなぜアクティブになるのかに注目しましょう。プロセスを考えすぎずに、キーワードのパターンに対する直感を養います。 diff --git a/docs/User-Guide-jp/commands.md b/docs/user-guide-jp/commands.md similarity index 86% rename from docs/User-Guide-jp/commands.md rename to docs/user-guide-jp/commands.md index 05d2b7f..e446794 100644 --- a/docs/User-Guide-jp/commands.md +++ b/docs/user-guide-jp/commands.md @@ -1,12 +1,12 @@ # 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 コマンドを提供します。 ## コマンドの種類 -[](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 # Terminal: Verify installation @@ -32,11 +32,11 @@ python3 -m SuperClaude --version ## 🎯 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の仕組み -[](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`コンテキストファイルを読み込み、その動作指示に従います。 @@ -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:*`）：ワークフローパターンと動作​​モードをトリガーする - **エージェントの呼び出し**（`@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"` 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 ソフトウェア）： @@ -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で実行） -[](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 # 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 @@ -116,11 +116,11 @@ python3 -m SuperClaude install --list-components | grep mcp # 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#common-workflows)- 機能するコマンドの組み合わせ -- [完全なコマンドリファレンス](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#full-command-reference)- カテゴリ別に整理された全21個のコマンド -- [トラブルシューティング](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#troubleshooting)- よくある問題と解決策 -- [コマンドインデックス](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#command-index)- カテゴリ別にコマンドを検索 +- [必須コマンド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#essential-commands)- ここから始めましょう（8つのコアコマンド） +- [一般的なワークフロー](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#common-workflows)- 機能するコマンドの組み合わせ +- [完全なコマンドリファレンス](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#full-command-reference)- カテゴリ別に整理された全21個のコマンド +- [トラブルシューティング](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#troubleshooting)- よくある問題と解決策 +- [コマンドインデックス](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#command-index)- カテゴリ別にコマンドを検索 --- ## 必須コマンド -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#essential-commands) +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#essential-commands) **即時の生産性向上のためのコアワークフロー コマンド:** ### `/sc:brainstorm`- プロジェクト発見 -[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#scbrainstorm---project-discovery) +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#scbrainstorm---project-discovery) **目的**: 対話型の要件検出とプロジェクト計画 **構文**:`/sc:brainstorm "your idea"` `[--strategy systematic|creative]` @@ -165,7 +165,7 @@ python3 -m SuperClaude install --list-components | grep mcp ### `/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]` @@ -179,7 +179,7 @@ python3 -m SuperClaude install --list-components | grep mcp ### `/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]` @@ -192,7 +192,7 @@ python3 -m SuperClaude install --list-components | grep mcp ### `/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]` @@ -205,7 +205,7 @@ python3 -m SuperClaude install --list-components | grep mcp ### `/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]` @@ -218,7 +218,7 @@ python3 -m SuperClaude install --list-components | grep mcp ### `/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]` @@ -231,7 +231,7 @@ python3 -m SuperClaude install --list-components | grep mcp ### `/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の包括的なドキュメントを生成する **構文**:`/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`- 実装計画 -[](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]` @@ -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 /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 /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 /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 /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`再初期化する - ステータスを確認:`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/agents.md)- スペシャリストのアクティベーション -- [例のクックブック](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Reference/examples-cookbook.md)- 実際の使用パターン \ No newline at end of file +- [フラグガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md)- コマンドの動作を制御する +- [エージェントガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md)- スペシャリストのアクティベーション +- [例のクックブック](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/reference/examples-cookbook.md)- 実際の使用パターン \ No newline at end of file diff --git a/docs/User-Guide-jp/flags.md b/docs/user-guide-jp/flags.md similarity index 85% rename from docs/User-Guide-jp/flags.md rename to docs/user-guide-jp/flags.md index 2233aec..7918bf8 100644 --- a/docs/User-Guide-jp/flags.md +++ b/docs/user-guide-jp/flags.md @@ -1,16 +1,16 @@ # 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 は、リクエスト内のキーワードとパターンに基づいて適切なコンテキストを実行するための動作指示を読み取ります。 ## 必須の自動アクティベーションフラグ（ユースケースの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 サーバーフラグ -[](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`） -[](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`） -[](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`） -[](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`） -[](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`） -[](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`） -[](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`） -[](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`) -[](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`） -[](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`） -[](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`） -[](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`) -[](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`） -[](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`） -[](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`) -[](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`） -[](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 インストール） -[](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 /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 /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 /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 /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`: ドキュメント付き分析 - `--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フラグと比較（どちらか一方を使用） - `--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` - `--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`ネイティブツールのみでテストする - **操作が遅すぎます**:`--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 /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 /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`> 最適化フラグ 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)- これらのフラグを使用するコマンド -- [MCP サーバーガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/mcp-servers.md)- MCP フラグのアクティブ化について -- [セッション管理](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md)- 永続セッションでのフラグの使用 \ No newline at end of file +- [コマンドガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md)- これらのフラグを使用するコマンド +- [MCP サーバーガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/mcp-servers.md)- MCP フラグのアクティブ化について +- [セッション管理](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md)- 永続セッションでのフラグの使用 \ No newline at end of file diff --git a/docs/User-Guide-jp/mcp-servers.md b/docs/user-guide-jp/mcp-servers.md similarity index 88% rename from docs/User-Guide-jp/mcp-servers.md rename to docs/user-guide-jp/mcp-servers.md index 284a05f..3b9b19d 100644 --- a/docs/User-Guide-jp/mcp-servers.md +++ b/docs/user-guide-jp/mcp-servers.md @@ -1,16 +1,16 @@ # 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に指示します。 ### 🔍 現実チェック -[](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プロセス - **含まれていないもの**：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 📚 -[](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キーなし @@ -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キーなし @@ -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() @@ -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キーなし @@ -109,7 +109,7 @@ export TWENTYFIRST_API_KEY="your_key_here" ### 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 @@ -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 キーなし @@ -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`):** @@ -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キーなし（無料）** : @@ -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 コマンドを使用する場合:** @@ -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/Getting-Started/quick-start.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/User-Guide/modes.md)- モード-MCP調整 -- [エージェントガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md)- エージェントとMCPの統合 -- [セッション管理](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md)- Serena ワークフロー +- [行動モード](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md)- モード-MCP調整 +- [エージェントガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md)- エージェントとMCPの統合 +- [セッション管理](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md)- Serena ワークフロー **技術リファレンス:** -- [例のクックブック](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Reference/examples-cookbook.md)- MCP ワークフローパターン -- [技術アーキテクチャ](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Developer-Guide/technical-architecture.md)- 統合の詳細 \ No newline at end of file +- [例のクックブック](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/reference/examples-cookbook.md)- MCP ワークフローパターン +- [技術アーキテクチャ](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/developer-guide/technical-architecture.md)- 統合の詳細 \ No newline at end of file diff --git a/docs/User-Guide-jp/modes.md b/docs/user-guide-jp/modes.md similarity index 91% rename from docs/User-Guide-jp/modes.md rename to docs/user-guide-jp/modes.md index 6811ef1..49d0f13 100644 --- a/docs/User-Guide-jp/modes.md +++ b/docs/user-guide-jp/modes.md @@ -1,16 +1,16 @@ # 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分の概要） -[](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 はコンテキスト ファイルを読み取り、タスクのパターンと複雑さに基づいてどのモード動作を採用するかを決定します。 @@ -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% のトークン削減を実現します。 @@ -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 # 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/troubleshooting.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/User-Guide/modes.md#common-issues) +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#common-issues) - **モードがアクティブ化されていません**: 手動フラグを使用してください: `--brainstorm`、、`--introspect``--uc` - **間違ったモードがアクティブです**: リクエスト内の複雑なトリガーとキーワードを確認してください - **予期しないモード切り替え**：タスクの進行に基づく通常の動作 - **実行への影響**: モードはツールの使用を最適化するものであり、実行には影響しないはずです。 -- **モードの競合**:[フラグガイドでフラグの優先順位ルールを確認してください](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md) +- **モードの競合**:[フラグガイドでフラグの優先順位ルールを確認してください](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/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` - **リセットモードの動作**: モード状態をリセットするには、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 分)** @@ -596,7 +596,7 @@ Standard Approach: Consistent, professional baseline for all tasks # 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分以上）** @@ -607,7 +607,7 @@ SuperClaude install --diagnose # 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: コミュニティサポート** @@ -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` - **間違ったモードがアクティブです**→ リクエスト内の複雑なトリガーとキーワードを確認してください - **予期せぬモード切り替え**→ タスクの進行に基づく通常の動作 - **実行への影響**→ モードはツールの使用を最適化するものであり、実行には影響しないはずです -- **モードの競合→**[フラグガイド](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: 通信パターンで次のインジケーターを確認してください。 @@ -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 つの行動モードは、ユーザーのニーズに自動的に適合する**インテリジェントな適応システムを作成します。** @@ -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週）** -- [クイックスタートガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Getting-Started/quick-start.md)- モードの有効化例 -- [コマンドリファレンス](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md)- コマンドは自動的にモードをアクティブ化します -- [インストールガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Getting-Started/installation.md)- 動作モードの設定 +- [クイックスタートガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/getting-started/quick-start.md)- モードの有効化例 +- [コマンドリファレンス](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md)- コマンドは自動的にモードをアクティブ化します +- [インストールガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/getting-started/installation.md)- 動作モードの設定 **🌿中級（第2～3週）** -- [エージェントガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/agents.md)- モードとスペシャリストの連携方法 -- [フラグガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/flags.md)- 手動モードの制御と最適化 -- [例文集](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Reference/examples-cookbook.md)- モードパターンの実践 +- [エージェントガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md)- モードとスペシャリストの連携方法 +- [フラグガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md)- 手動モードの制御と最適化 +- [例文集](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/reference/examples-cookbook.md)- モードパターンの実践 **🌲 上級（2ヶ月目以降）** -- [MCP サーバー](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/mcp-servers.md)- 拡張機能を備えたモード統合 -- [セッション管理](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md)- タスク管理モードのワークフロー -- [はじめに](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Getting-Started/quick-start.md)- モードの使用パターン +- [MCP サーバー](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/mcp-servers.md)- 拡張機能を備えたモード統合 +- [セッション管理](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md)- タスク管理モードのワークフロー +- [はじめに](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/getting-started/quick-start.md)- モードの使用パターン **🔧 エキスパート** -- [技術アーキテクチャ](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Developer-Guide/technical-architecture.md)- モード実装の詳細 -- [コードの貢献](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Developer-Guide/contributing-code.md)- モードの機能を拡張する +- [技術アーキテクチャ](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/developer-guide/technical-architecture.md)- モード実装の詳細 +- [コードの貢献](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/developer-guide/contributing-code.md)- モードの機能を拡張する **モード固有のガイド:** -- **ブレインストーミング**：[要件発見パターン](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/Reference/examples-cookbook.md#requirements) -- **タスク管理**：[セッション管理ガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/session-management.md) -- **オーケストレーション**: [MCP サーバー ガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/mcp-servers.md) -- **トークン効率**：[コマンドの基礎](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/User-Guide/commands.md#token-efficiency) \ No newline at end of file +- **ブレインストーミング**：[要件発見パターン](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/reference/examples-cookbook.md#requirements) +- **タスク管理**：[セッション管理ガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md) +- **オーケストレーション**: [MCP サーバー ガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/mcp-servers.md) +- **トークン効率**：[コマンドの基礎](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#token-efficiency) \ No newline at end of file diff --git a/docs/User-Guide-jp/session-management.md b/docs/user-guide-jp/session-management.md similarity index 88% rename from docs/User-Guide-jp/session-management.md rename to docs/user-guide-jp/session-management.md index e9c9fe6..80b42ac 100644 --- a/docs/User-Guide-jp/session-management.md +++ b/docs/user-guide-jp/session-management.md @@ -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 の会話全体にわたる真のコンテキスト保存と長期的なプロジェクト継続性を実現します。 ## 永続メモリを使用したコアセッションコマンド -[](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`- 永続メモリによるコンテキストの読み込み -[](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 **統合**: Serena MCP をトリガーして、保存されたプロジェクトメモリを読み取ります。 @@ -38,7 +38,7 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション ### `/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 をトリガーしてメモリ ファイルに書き込みます。 @@ -66,7 +66,7 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション ### `/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 を使用して、保存されたメモリと現在の状態を比較する @@ -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 が真の永続性を実現する方法 -[](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 # 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 # 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 # 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 会話を開始すると、永続メモリ システムによって次のことが可能になります。 @@ -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`既存のプロジェクトの場合は常に 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`保存された目標に対する完全性を評価するために使用します 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機能との統合 -[](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 サーバー調整 -[](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** : 永続メモリインフラストラクチャを提供します - **シーケンシャル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:`コマンドは永続的なコンテキストを参照し、そのコンテキストに基づいて構築できます。 - 以前のコマンド出力と決定はセッション間で利用可能 @@ -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セッション間でコンテキストが失われることはありません @@ -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) - セッション間で一貫したアーキテクチャパターン - コード品質の決定と標準の保持 diff --git a/docs/User-Guide-kr/agents.md b/docs/user-guide-kr/agents.md similarity index 98% rename from docs/User-Guide-kr/agents.md rename to docs/user-guide-kr/agents.md index 5186093..d3f3466 100644 --- a/docs/User-Guide-kr/agents.md +++ b/docs/user-guide-kr/agents.md @@ -537,8 +537,8 @@ SuperClaude는 Claude Code가 전문 지식을 위해 호출할 수 있는 15개 ## 문제 해결 문제 해결 도움말은 다음을 참조하세요: -- [일반적인 문제](../Reference/common-issues.md) - 자주 발생하는 문제에 대한 빠른 수정 -- [문제 해결 가이드](../Reference/troubleshooting.md) - 포괄적인 문제 해결 +- [일반적인 문제](../reference/common-issues.md) - 자주 발생하는 문제에 대한 빠른 수정 +- [문제 해결 가이드](../reference/troubleshooting.md) - 포괄적인 문제 해결 ### 일반적인 문제 - **에이전트 활성화 없음**: 도메인 키워드 사용: "security", "performance", "frontend" @@ -599,12 +599,12 @@ SuperClaude는 Claude Code가 전문 지식을 위해 호출할 수 있는 15개 - 혼란을 피하기 위해 단일 도메인에 집중 **상세 도움말:** -- 에이전트 설치 문제는 [일반적인 문제 가이드](../Reference/common-issues.md) 참조 +- 에이전트 설치 문제는 [일반적인 문제 가이드](../reference/common-issues.md) 참조 - 대상 에이전트의 트리거 키워드 검토 **전문가 지원:** - `SuperClaude install --diagnose` 사용 -- 조정 분석은 [진단 참조 가이드](../Reference/diagnostic-reference.md) 참조 +- 조정 분석은 [진단 참조 가이드](../reference/diagnostic-reference.md) 참조 **커뮤니티 지원:** - [GitHub Issues](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues)에서 문제 보고 @@ -838,12 +838,12 @@ SuperClaude는 Claude Code가 전문 지식을 위해 호출할 수 있는 15개 ### 고급 사용 - **[행동 모드](modes.md)** - 향상된 에이전트 조정을 위한 컨텍스트 최적화 -- **[시작하기](../Getting-Started/quick-start.md)** - 에이전트 최적화를 위한 전문가 기법 -- **[예제 모음](../Reference/examples-cookbook.md)** - 실제 에이전트 조정 패턴 +- **[시작하기](../getting-started/quick-start.md)** - 에이전트 최적화를 위한 전문가 기법 +- **[예제 모음](../reference/examples-cookbook.md)** - 실제 에이전트 조정 패턴 ### 개발 리소스 -- **[기술 아키텍처](../Developer-Guide/technical-architecture.md)** - SuperClaude의 에이전트 시스템 설계 이해 -- **[기여하기](../Developer-Guide/contributing-code.md)** - 에이전트 기능 및 조정 패턴 확장 +- **[기술 아키텍처](../developer-guide/technical-architecture.md)** - SuperClaude의 에이전트 시스템 설계 이해 +- **[기여하기](../developer-guide/contributing-code.md)** - 에이전트 기능 및 조정 패턴 확장 --- diff --git a/docs/User-Guide-kr/commands.md b/docs/user-guide-kr/commands.md similarity index 98% rename from docs/User-Guide-kr/commands.md rename to docs/user-guide-kr/commands.md index c383a5c..33ece65 100644 --- a/docs/User-Guide-kr/commands.md +++ b/docs/user-guide-kr/commands.md @@ -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`로 다시 초기화 - 상태 확인: `SuperClaude install --list-components` -- 도움말 받기: [문제 해결 가이드](../Reference/troubleshooting.md) +- 도움말 받기: [문제 해결 가이드](../reference/troubleshooting.md) ## 다음 단계 - [플래그 가이드](flags.md) - 명령어 동작 제어 - [에이전트 가이드](agents.md) - 전문가 활성화 -- [예제 모음](../Reference/examples-cookbook.md) - 실제 사용 패턴 +- [예제 모음](../reference/examples-cookbook.md) - 실제 사용 패턴 diff --git a/docs/User-Guide-kr/flags.md b/docs/user-guide-kr/flags.md similarity index 100% rename from docs/User-Guide-kr/flags.md rename to docs/user-guide-kr/flags.md diff --git a/docs/User-Guide-kr/mcp-servers.md b/docs/user-guide-kr/mcp-servers.md similarity index 97% rename from docs/User-Guide-kr/mcp-servers.md rename to docs/user-guide-kr/mcp-servers.md index 0f38de0..b96f0ed 100644 --- a/docs/User-Guide-kr/mcp-servers.md +++ b/docs/user-guide-kr/mcp-servers.md @@ -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 서버를 활성화하는 명령어 -- [빠른 시작 가이드](../Getting-Started/quick-start.md) - MCP 설정 가이드 +- [빠른 시작 가이드](../getting-started/quick-start.md) - MCP 설정 가이드 **고급 사용:** - [행동 모드](modes.md) - 모드-MCP 조정 @@ -335,6 +335,6 @@ echo 'export TAVILY_API_KEY="your_key"' >> ~/.bashrc - [세션 관리](session-management.md) - Serena 워크플로우 **기술 참조:** -- [예제 모음](../Reference/examples-cookbook.md) - MCP 워크플로우 패턴 -- [기술 아키텍처](../Developer-Guide/technical-architecture.md) - 통합 세부사항 +- [예제 모음](../reference/examples-cookbook.md) - MCP 워크플로우 패턴 +- [기술 아키텍처](../developer-guide/technical-architecture.md) - 통합 세부사항 diff --git a/docs/User-Guide-kr/modes.md b/docs/user-guide-kr/modes.md similarity index 97% rename from docs/User-Guide-kr/modes.md rename to docs/user-guide-kr/modes.md index ddb8750..79d4d95 100644 --- a/docs/User-Guide-kr/modes.md +++ b/docs/user-guide-kr/modes.md @@ -458,8 +458,8 @@ ## 문제 해결 문제 해결 도움말은 다음을 참조하세요: -- [일반적인 문제](../Reference/common-issues.md) - 자주 발생하는 문제에 대한 빠른 수정 -- [문제 해결 가이드](../Reference/troubleshooting.md) - 포괄적인 문제 해결 +- [일반적인 문제](../reference/common-issues.md) - 자주 발생하는 문제에 대한 빠른 수정 +- [문제 해결 가이드](../reference/troubleshooting.md) - 포괄적인 문제 해결 ### 일반적인 문제 - **모드가 활성화되지 않음**: 수동 플래그 사용: `--brainstorm`, `--introspect`, `--uc` @@ -547,7 +547,7 @@ /sc:reflect --type mode-status # 현재 모드 상태 확인 # 요청 복잡성 및 트리거 검토 ``` -- 모드 설치 문제는 [일반적인 문제 가이드](../Reference/common-issues.md) 참조 +- 모드 설치 문제는 [일반적인 문제 가이드](../reference/common-issues.md) 참조 **수준 3: 전문가 지원 (30분 이상)** ```bash @@ -556,7 +556,7 @@ SuperClaude install --diagnose # 모드 활성화 패턴 확인 # 행동 트리거 및 임계값 검토 ``` -- 행동 모드 분석은 [진단 참조 가이드](../Reference/diagnostic-reference.md) 참조 +- 행동 모드 분석은 [진단 참조 가이드](../reference/diagnostic-reference.md) 참조 **수준 4: 커뮤니티 지원** - [GitHub Issues](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues)에서 모드 문제 보고 @@ -632,26 +632,26 @@ SuperClaude의 5가지 행동 모드는 필요에 따라 자동으로 일치하 **학습 진행:** **🌱 필수 (1주차)** -- [빠른 시작 가이드](../Getting-Started/quick-start.md) - 모드 활성화 예제 +- [빠른 시작 가이드](../getting-started/quick-start.md) - 모드 활성화 예제 - [명령어 참조](commands.md) - 명령어가 자동으로 모드 활성화 -- [설치 가이드](../Getting-Started/installation.md) - 행동 모드 설정 +- [설치 가이드](../getting-started/installation.md) - 행동 모드 설정 **🌿 중급 (2-3주차)** - [에이전트 가이드](agents.md) - 모드가 전문가와 조정하는 방법 - [플래그 가이드](flags.md) - 수동 모드 제어 및 최적화 -- [예제 모음](../Reference/examples-cookbook.md) - 실제 모드 패턴 +- [예제 모음](../reference/examples-cookbook.md) - 실제 모드 패턴 **🌲 고급 (2개월 이상)** - [MCP 서버](mcp-servers.md) - 향상된 기능과의 모드 통합 - [세션 관리](session-management.md) - 작업 관리 모드 워크플로우 -- [시작하기](../Getting-Started/quick-start.md) - 모드 사용 패턴 +- [시작하기](../getting-started/quick-start.md) - 모드 사용 패턴 **🔧 전문가** -- [기술 아키텍처](../Developer-Guide/technical-architecture.md) - 모드 구현 세부사항 -- [코드 기여](../Developer-Guide/contributing-code.md) - 모드 기능 확장 +- [기술 아키텍처](../developer-guide/technical-architecture.md) - 모드 구현 세부사항 +- [코드 기여](../developer-guide/contributing-code.md) - 모드 기능 확장 **모드별 가이드:** -- **브레인스토밍**: [요구사항 발견 패턴](../Reference/examples-cookbook.md#requirements) +- **브레인스토밍**: [요구사항 발견 패턴](../reference/examples-cookbook.md#requirements) - **작업 관리**: [세션 관리 가이드](session-management.md) - **오케스트레이션**: [MCP 서버 가이드](mcp-servers.md) - **토큰 효율성**: [명령어 기본사항](commands.md#token-efficiency) diff --git a/docs/User-Guide-kr/session-management.md b/docs/user-guide-kr/session-management.md similarity index 100% rename from docs/User-Guide-kr/session-management.md rename to docs/user-guide-kr/session-management.md diff --git a/docs/User-Guide-zh/agents.md b/docs/user-guide-zh/agents.md similarity index 98% rename from docs/User-Guide-zh/agents.md rename to docs/user-guide-zh/agents.md index cdaa908..a808d66 100644 --- a/docs/User-Guide-zh/agents.md +++ b/docs/user-guide-zh/agents.md @@ -494,8 +494,8 @@ Task Analysis → ## 故障排除 获取故障排除帮助，请参阅： -- [常见问题](../Reference/common-issues.md) - 常见问题的快速修复 -- [故障排除指南](../Reference/troubleshooting.md) - 综合问题解决 +- [常见问题](../reference/common-issues.md) - 常见问题的快速修复 +- [故障排除指南](../reference/troubleshooting.md) - 综合问题解决 ### 常见问题 - **无智能体激活**: 使用领域关键词："security"、"performance"、"frontend" @@ -556,12 +556,12 @@ Task Analysis → - 聚焦在单一领域以避免混淆 **详细帮助：** -- 查看[常见问题指南](../Reference/common-issues.md)了解智能体安装问题 +- 查看[常见问题指南](../reference/common-issues.md)了解智能体安装问题 - 查看目标智能体的触发关键词 **专家支持：** - 使用 `SuperClaude install --diagnose` -- 查看[诊断参考指南](../Reference/diagnostic-reference.md)进行协调分析 +- 查看[诊断参考指南](../reference/diagnostic-reference.md)进行协调分析 **社区支持：** - 在 [GitHub Issues](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues) 报告问题 @@ -793,12 +793,12 @@ Task Analysis → ### 高级用法 - **[行为模式](modes.md)** - 用于增强智能体协调的上下文优化 -- **[入门指南](../Getting-Started/quick-start.md)** - 智能体优化的专家技巧 -- **[示例食谱](../Reference/examples-cookbook.md)** - 实际的智能体协调模式 +- **[入门指南](../getting-started/quick-start.md)** - 智能体优化的专家技巧 +- **[示例食谱](../reference/examples-cookbook.md)** - 实际的智能体协调模式 ### 开发资源 -- **[技术架构](../Developer-Guide/technical-architecture.md)** - 理解 SuperClaude 的智能体系统设计 -- **[贡献指南](../Developer-Guide/contributing-code.md)** - 扩展智能体能力和协调模式 +- **[技术架构](../developer-guide/technical-architecture.md)** - 理解 SuperClaude 的智能体系统设计 +- **[贡献指南](../developer-guide/contributing-code.md)** - 扩展智能体能力和协调模式 --- diff --git a/docs/User-Guide-zh/commands.md b/docs/user-guide-zh/commands.md similarity index 98% rename from docs/User-Guide-zh/commands.md rename to docs/user-guide-zh/commands.md index b45261b..d1f8ff6 100644 --- a/docs/User-Guide-zh/commands.md +++ b/docs/user-guide-zh/commands.md @@ -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 @@ -296,10 +296,10 @@ python3 -m SuperClaude install --list-components | grep mcp **快速修复：** - 重置会话: `/sc:load` 重新初始化 - 检查状态: `SuperClaude install --list-components` -- 获取帮助: [故障排除指南](../Reference/troubleshooting.md) +- 获取帮助: [故障排除指南](../reference/troubleshooting.md) ## 下一步 - [标志指南](flags.md) - 控制命令行为 - [智能体指南](agents.md) - 专家激活 -- [示例手册](../Reference/examples-cookbook.md) - 真实使用模式 \ No newline at end of file +- [示例手册](../reference/examples-cookbook.md) - 真实使用模式 \ No newline at end of file diff --git a/docs/User-Guide-zh/flags.md b/docs/user-guide-zh/flags.md similarity index 100% rename from docs/User-Guide-zh/flags.md rename to docs/user-guide-zh/flags.md diff --git a/docs/User-Guide-zh/mcp-servers.md b/docs/user-guide-zh/mcp-servers.md similarity index 95% rename from docs/User-Guide-zh/mcp-servers.md rename to docs/user-guide-zh/mcp-servers.md index 4f717df..eae2fc7 100644 --- a/docs/User-Guide-zh/mcp-servers.md +++ b/docs/user-guide-zh/mcp-servers.md @@ -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 服务器的命令 -- [快速开始指南](../Getting-Started/quick-start.md) - MCP 设置指南 +- [快速开始指南](../getting-started/quick-start.md) - MCP 设置指南 **高级使用：** - [行为模式](modes.md) - 模式-MCP 协调 @@ -268,5 +268,5 @@ echo 'export MORPH_API_KEY="your_key"' >> ~/.bashrc - [会话管理](session-management.md) - Serena 工作流 **技术参考：** -- [示例手册](../Reference/examples-cookbook.md) - MCP 工作流模式 -- [技术架构](../Developer-Guide/technical-architecture.md) - 集成详情 \ No newline at end of file +- [示例手册](../reference/examples-cookbook.md) - MCP 工作流模式 +- [技术架构](../developer-guide/technical-architecture.md) - 集成详情 \ No newline at end of file diff --git a/docs/User-Guide-zh/modes.md b/docs/user-guide-zh/modes.md similarity index 96% rename from docs/User-Guide-zh/modes.md rename to docs/user-guide-zh/modes.md index 3e915d3..25327f8 100644 --- a/docs/User-Guide-zh/modes.md +++ b/docs/user-guide-zh/modes.md @@ -404,8 +404,8 @@ Standard Approach: Consistent, professional baseline for all tasks ## 故障排除 有关故障排除帮助，请参阅： -- [常见问题](../Reference/common-issues.md) - 频繁问题的快速修复 -- [故障排除指南](../Reference/troubleshooting.md) - 全面的问题解决方案 +- [常见问题](../reference/common-issues.md) - 频繁问题的快速修复 +- [故障排除指南](../reference/troubleshooting.md) - 全面的问题解决方案 ### 常见问题 - **模式未激活**：使用手动标志：`--brainstorm`、`--introspect`、`--uc` @@ -493,7 +493,7 @@ Standard Approach: Consistent, professional baseline for all tasks /sc:reflect --type mode-status # 检查当前模式状态 # 检查请求复杂性和触发器 ``` -- 有关模式安装问题，请参阅[常见问题指南](../Reference/common-issues.md) +- 有关模式安装问题，请参阅[常见问题指南](../reference/common-issues.md) **级别 3：专家支持（30+ 分钟）** ```bash @@ -502,7 +502,7 @@ SuperClaude install --diagnose # 检查模式激活模式 # 检查行为触发器和阈值 ``` -- 有关行为模式分析，请参阅[诊断参考指南](../Reference/diagnostic-reference.md) +- 有关行为模式分析，请参阅[诊断参考指南](../reference/diagnostic-reference.md) **级别 4：社区支持** - 在 [GitHub Issues](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues) 报告模式问题 @@ -578,26 +578,26 @@ SuperClaude 的 5 种行为模式创建了一个**智能适应系统**，自动 **学习进展：** **🌱 基础（第1周）** -- [快速开始指南](../Getting-Started/quick-start.md) - 模式激活示例 +- [快速开始指南](../getting-started/quick-start.md) - 模式激活示例 - [命令参考](commands.md) - 命令自动激活模式 -- [安装指南](../Getting-Started/installation.md) - 设置行为模式 +- [安装指南](../getting-started/installation.md) - 设置行为模式 **🌿 中级（第2-3周）** - [智能体指南](agents.md) - 模式如何与专家协调 - [标志指南](flags.md) - 手动模式控制和优化 -- [示例手册](../Reference/examples-cookbook.md) - 实践中的模式模式 +- [示例手册](../reference/examples-cookbook.md) - 实践中的模式模式 **🌲 高级（第2+个月）** - [MCP 服务器](mcp-servers.md) - 模式与增强能力的集成 - [会话管理](session-management.md) - 任务管理模式工作流 -- [入门指南](../Getting-Started/quick-start.md) - 模式使用模式 +- [入门指南](../getting-started/quick-start.md) - 模式使用模式 **🔧 专家级** -- [技术架构](../Developer-Guide/technical-architecture.md) - 模式实现细节 -- [代码贡献](../Developer-Guide/contributing-code.md) - 扩展模式能力 +- [技术架构](../developer-guide/technical-architecture.md) - 模式实现细节 +- [代码贡献](../developer-guide/contributing-code.md) - 扩展模式能力 **特定模式指南：** -- **头脑风暴**：[需求发现模式](../Reference/examples-cookbook.md#requirements) +- **头脑风暴**：[需求发现模式](../reference/examples-cookbook.md#requirements) - **任务管理**：[会话管理指南](session-management.md) - **编排**：[MCP 服务器指南](mcp-servers.md) - **令牌效率**：[命令基础](commands.md#token-efficiency) \ No newline at end of file diff --git a/docs/User-Guide-zh/session-management.md b/docs/user-guide-zh/session-management.md similarity index 100% rename from docs/User-Guide-zh/session-management.md rename to docs/user-guide-zh/session-management.md diff --git a/docs/User-Guide/agents.md b/docs/user-guide/agents.md similarity index 98% rename from docs/User-Guide/agents.md rename to docs/user-guide/agents.md index ae2d3cc..64a5fac 100644 --- a/docs/User-Guide/agents.md +++ b/docs/user-guide/agents.md @@ -609,8 +609,8 @@ Task Flow: ## Troubleshooting For troubleshooting help, see: -- [Common Issues](../Reference/common-issues.md) - Quick fixes for frequent problems -- [Troubleshooting Guide](../Reference/troubleshooting.md) - Comprehensive problem resolution +- [Common Issues](../reference/common-issues.md) - Quick fixes for frequent problems +- [Troubleshooting Guide](../reference/troubleshooting.md) - Comprehensive problem resolution ### Common Issues - **No agent activation**: Use domain keywords: "security", "performance", "frontend" @@ -671,12 +671,12 @@ For troubleshooting help, see: - Focus on single domain to avoid confusion **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 **Expert Support:** - 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:** - 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 - **[Behavioral Modes](modes.md)** - Context optimization for enhanced agent coordination -- **[Getting Started](../Getting-Started/quick-start.md)** - Expert techniques for agent optimization -- **[Examples Cookbook](../Reference/examples-cookbook.md)** - Real-world agent coordination patterns +- **[Getting Started](../getting-started/quick-start.md)** - Expert techniques for agent optimization +- **[Examples Cookbook](../reference/examples-cookbook.md)** - Real-world agent coordination patterns ### Development Resources -- **[Technical Architecture](../Developer-Guide/technical-architecture.md)** - Understanding SuperClaude's agent system design -- **[Contributing](../Developer-Guide/contributing-code.md)** - Extending agent capabilities and coordination patterns +- **[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 --- diff --git a/docs/User-Guide/commands.md b/docs/user-guide/commands.md similarity index 98% rename from docs/User-Guide/commands.md rename to docs/user-guide/commands.md index c30cb25..5d20ce6 100644 --- a/docs/User-Guide/commands.md +++ b/docs/user-guide/commands.md @@ -88,7 +88,7 @@ python3 -m SuperClaude install --list-components | grep mcp # 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 @@ -358,10 +358,10 @@ python3 -m SuperClaude install --list-components | grep mcp **Quick Fixes:** - Reset session: `/sc:load` to reinitialize - Check status: `SuperClaude install --list-components` -- Get help: [Troubleshooting Guide](../Reference/troubleshooting.md) +- Get help: [Troubleshooting Guide](../reference/troubleshooting.md) ## Next Steps - [Flags Guide](flags.md) - Control command behavior - [Agents Guide](agents.md) - Specialist activation -- [Examples Cookbook](../Reference/examples-cookbook.md) - Real usage patterns \ No newline at end of file +- [Examples Cookbook](../reference/examples-cookbook.md) - Real usage patterns \ No newline at end of file diff --git a/docs/User-Guide/flags.md b/docs/user-guide/flags.md similarity index 100% rename from docs/User-Guide/flags.md rename to docs/user-guide/flags.md diff --git a/docs/User-Guide/mcp-servers.md b/docs/user-guide/mcp-servers.md similarity index 97% rename from docs/User-Guide/mcp-servers.md rename to docs/user-guide/mcp-servers.md index 256295e..e3c150b 100644 --- a/docs/User-Guide/mcp-servers.md +++ b/docs/user-guide/mcp-servers.md @@ -22,7 +22,7 @@ MCP (Model Context Protocol) servers extend Claude Code's capabilities through s ## 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:** @@ -327,7 +327,7 @@ echo 'export TAVILY_API_KEY="your_key"' >> ~/.bashrc **Essential Reading:** - [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:** - [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 **Technical References:** -- [Examples Cookbook](../Reference/examples-cookbook.md) - MCP workflow patterns -- [Technical Architecture](../Developer-Guide/technical-architecture.md) - Integration details \ No newline at end of file +- [Examples Cookbook](../reference/examples-cookbook.md) - MCP workflow patterns +- [Technical Architecture](../developer-guide/technical-architecture.md) - Integration details \ No newline at end of file diff --git a/docs/User-Guide/modes.md b/docs/user-guide/modes.md similarity index 97% rename from docs/User-Guide/modes.md rename to docs/user-guide/modes.md index b1ef9db..bec19b9 100644 --- a/docs/User-Guide/modes.md +++ b/docs/user-guide/modes.md @@ -460,8 +460,8 @@ Standard Approach: Consistent, professional baseline for all tasks ## Troubleshooting For troubleshooting help, see: -- [Common Issues](../Reference/common-issues.md) - Quick fixes for frequent problems -- [Troubleshooting Guide](../Reference/troubleshooting.md) - Comprehensive problem resolution +- [Common Issues](../reference/common-issues.md) - Quick fixes for frequent problems +- [Troubleshooting Guide](../reference/troubleshooting.md) - Comprehensive problem resolution ### Common Issues - **Mode not activating**: Use manual flags: `--brainstorm`, `--introspect`, `--uc` @@ -549,7 +549,7 @@ For troubleshooting help, see: /sc:reflect --type mode-status # Check current mode state # Review request complexity and triggers ``` -- See [Common Issues Guide](../Reference/common-issues.md) for mode installation problems +- See [Common Issues Guide](../reference/common-issues.md) for mode installation problems **Level 3: Expert Support (30+ min)** ```bash @@ -558,7 +558,7 @@ SuperClaude install --diagnose # Check mode activation patterns # 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** - 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:** **🌱 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 -- [Installation Guide](../Getting-Started/installation.md) - Set up behavioral modes +- [Installation Guide](../getting-started/installation.md) - Set up behavioral modes **🌿 Intermediate (Week 2-3)** - [Agents Guide](agents.md) - How modes coordinate with specialists - [Flags Guide](flags.md) - Manual mode control and optimization -- [Examples Cookbook](../Reference/examples-cookbook.md) - Mode patterns in practice +- [Examples Cookbook](../reference/examples-cookbook.md) - Mode patterns in practice **🌲 Advanced (Month 2+)** - [MCP Servers](mcp-servers.md) - Mode integration with enhanced capabilities - [Session Management](session-management.md) - Task Management mode workflows -- [Getting Started](../Getting-Started/quick-start.md) - Mode usage patterns +- [Getting Started](../getting-started/quick-start.md) - Mode usage patterns **🔧 Expert** -- [Technical Architecture](../Developer-Guide/technical-architecture.md) - Mode implementation details -- [Contributing Code](../Developer-Guide/contributing-code.md) - Extend mode capabilities +- [Technical Architecture](../developer-guide/technical-architecture.md) - Mode implementation details +- [Contributing Code](../developer-guide/contributing-code.md) - Extend mode capabilities **Mode-Specific Guides:** -- **Brainstorming**: [Requirements Discovery Patterns](../Reference/examples-cookbook.md#requirements) +- **Brainstorming**: [Requirements Discovery Patterns](../reference/examples-cookbook.md#requirements) - **Task Management**: [Session Management Guide](session-management.md) - **Orchestration**: [MCP Servers Guide](mcp-servers.md) - **Token Efficiency**: [Command Fundamentals](commands.md#token-efficiency) \ No newline at end of file diff --git a/docs/User-Guide/session-management.md b/docs/user-guide/session-management.md similarity index 100% rename from docs/User-Guide/session-management.md rename to docs/user-guide/session-management.md diff --git a/pr_documentation.md b/pr_documentation.md deleted file mode 100644 index 565d2b5..0000000 --- a/pr_documentation.md +++ /dev/null @@ -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)