External/SuperClaude
1
0
Fork 0
mirror of https://github.com/SuperClaude-Org/SuperClaude_Framework.git synced 2025-12-17 09:46:06 +00:00
Code Issues Packages Projects Releases Wiki Activity
SuperClaude/TASK.md
kazuki nakai 00706f0ea9
feat: comprehensive framework improvements (#447) 
* refactor(docs): move core docs into framework/business/research (move-only)

- framework/: principles, rules, flags (思想・行動規範)
- business/: symbols, examples (ビジネス領域)
- research/: config (調査設定)
- All files renamed to lowercase for consistency

* docs: update references to new directory structure

- Update ~/.claude/CLAUDE.md with new paths
- Add migration notice in core/MOVED.md
- Remove pm.md.backup
- All @superclaude/ references now point to framework/business/research/

* fix(setup): update framework_docs to use new directory structure

- Add validate_prerequisites() override for multi-directory validation
- Add _get_source_dirs() for framework/business/research directories
- Override _discover_component_files() for multi-directory discovery
- Override get_files_to_install() for relative path handling
- Fix get_size_estimate() to use get_files_to_install()
- Fix uninstall/update/validate to use install_component_subdir

Fixes installation validation errors for new directory structure.

Tested: make dev installs successfully with new structure
  - framework/: flags.md, principles.md, rules.md
  - business/: examples.md, symbols.md
  - research/: config.md

* refactor(modes): update component references for docs restructure

* chore: remove redundant docs after PLANNING.md migration

Cleanup after Self-Improvement Loop implementation:

**Deleted (21 files, ~210KB)**:
- docs/Development/ - All content migrated to PLANNING.md & TASK.md
  * ARCHITECTURE.md (15KB) → PLANNING.md
  * TASKS.md (3.7KB) → TASK.md
  * ROADMAP.md (11KB) → TASK.md
  * PROJECT_STATUS.md (4.2KB) → outdated
  * 13 PM Agent research files → archived in KNOWLEDGE.md
- docs/PM_AGENT.md - Old implementation status
- docs/pm-agent-implementation-status.md - Duplicate
- docs/templates/ - Empty directory

**Retained (valuable documentation)**:
- docs/memory/ - Active session metrics & context
- docs/patterns/ - Reusable patterns
- docs/research/ - Research reports
- docs/user-guide*/ - User documentation (4 languages)
- docs/reference/ - Reference materials
- docs/getting-started/ - Quick start guides
- docs/agents/ - Agent-specific guides
- docs/testing/ - Test procedures

**Result**:
- Eliminated redundancy after Root Documents consolidation
- Preserved all valuable content in PLANNING.md, TASK.md, KNOWLEDGE.md
- Maintained user-facing documentation structure

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* refactor: relocate PM modules to commands/modules

- Move modules to superclaude/commands/modules/
- Organize command-specific modules under commands/

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* feat: add self-improvement loop with 4 root documents

Implements Self-Improvement Loop based on Cursor's proven patterns:

**New Root Documents**:
- PLANNING.md: Architecture, design principles, 10 absolute rules
- TASK.md: Current tasks with priority (🔴🟡🟢⚪)
- KNOWLEDGE.md: Accumulated insights, best practices, failures
- README.md: Updated with developer documentation links

**Key Features**:
- Session Start Protocol: Read docs → Git status → Token budget → Ready
- Evidence-Based Development: No guessing, always verify
- Parallel Execution Default: Wave → Checkpoint → Wave pattern
- Mac Environment Protection: Docker-first, no host pollution
- Failure Pattern Learning: Past mistakes become prevention rules

**Cleanup**:
- Removed: docs/memory/checkpoint.json, current_plan.json (migrated to TASK.md)
- Enhanced: setup/components/commands.py (module discovery)

**Benefits**:
- LLM reads rules at session start → consistent quality
- Past failures documented → no repeats
- Progressive knowledge accumulation → continuous improvement
- 3.5x faster execution with parallel patterns

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* test: validate Self-Improvement Loop workflow

Tested complete cycle: Read docs → Extract rules → Execute task → Update docs

Test Results:
- Session Start Protocol: ✅ All 6 steps successful
- Rule Extraction: ✅ 10/10 absolute rules identified from PLANNING.md
- Task Identification: ✅ Next tasks identified from TASK.md
- Knowledge Application: ✅ Failure patterns accessed from KNOWLEDGE.md
- Documentation Update: ✅ TASK.md and KNOWLEDGE.md updated with completed work
- Confidence Score: 95% (exceeds 70% threshold)

Proved Self-Improvement Loop closes: Execute → Learn → Update → Improve

* refactor: responsibility-driven component architecture

Rename components to reflect their responsibilities:
- framework_docs.py → knowledge_base.py (KnowledgeBaseComponent)
- modes.py → behavior_modes.py (BehaviorModesComponent)
- agents.py → agent_personas.py (AgentPersonasComponent)
- commands.py → slash_commands.py (SlashCommandsComponent)
- mcp.py → mcp_integration.py (MCPIntegrationComponent)

Each component now clearly documents its responsibility:
- knowledge_base: Framework knowledge initialization
- behavior_modes: Execution mode definitions
- agent_personas: AI agent personality definitions
- slash_commands: CLI command registration
- mcp_integration: External tool integration

Benefits:
- Self-documenting architecture
- Clear responsibility boundaries
- Easy to navigate and extend
- Scalable for future hierarchical organization

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* docs: add project-specific CLAUDE.md with UV rules

- Document UV as required Python package manager
- Add common operations and integration examples
- Document project structure and component architecture
- Provide development workflow guidelines

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* fix: resolve installation failures after framework_docs rename

## Problems Fixed
1. **Syntax errors**: Duplicate docstrings in all component files (line 1)
2. **Dependency mismatch**: Stale framework_docs references after rename to knowledge_base

## Changes
- Fix docstring format in all component files (behavior_modes, agent_personas, slash_commands, mcp_integration)
- Update all dependency references: framework_docs → knowledge_base
- Update component registration calls in knowledge_base.py (5 locations)
- Update install.py files in both setup/ and superclaude/ (5 locations total)
- Fix documentation links in README-ja.md and README-zh.md

## Verification
✅ All components load successfully without syntax errors
✅ Dependency resolution works correctly
✅ Installation completes in 0.5s with all validations passing
✅ make dev succeeds

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* feat: add automated README translation workflow

## New Features
- **Auto-translation workflow** using GPT-Translate
- Automatically translates README.md to Chinese (ZH) and Japanese (JA)
- Triggers on README.md changes to master/main branches
- Cost-effective: ~¥90/month for typical usage

## Implementation Details
- Uses OpenAI GPT-4 for high-quality translations
- GitHub Actions integration with gpt-translate@v1.1.11
- Secure API key management via GitHub Secrets
- Automatic commit and PR creation on translation updates

## Files Added
- `.github/workflows/translation-sync.yml` - Auto-translation workflow
- `docs/Development/translation-workflow.md` - Setup guide and documentation

## Setup Required
Add `OPENAI_API_KEY` to GitHub repository secrets to enable auto-translation.

## Benefits
- 🤖 Automated translation on every README update
- 💰 Low cost (~$0.06 per translation)
- 🛡️ Secure API key storage
- 🔄 Consistent translation quality across languages

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* fix(mcp): update airis-mcp-gateway URL to correct organization

Fixes #440

## Problem
Code referenced non-existent `oraios/airis-mcp-gateway` repository,
causing MCP installation to fail completely.

## Root Cause
- Repository was moved to organization: `agiletec-inc/airis-mcp-gateway`
- Old reference `oraios/airis-mcp-gateway` no longer exists
- Users reported "not a python/uv module" error

## Changes
- Update install_command URL: oraios → agiletec-inc
- Update run_command URL: oraios → agiletec-inc
- Location: setup/components/mcp_integration.py lines 37-38

## Verification
✅ Correct URL now references active repository
✅ MCP installation will succeed with proper organization
✅ No other code references oraios/airis-mcp-gateway

## Related Issues
- Fixes #440 (Airis-mcp-gateway url has changed)
- Related to #442 (MCP update issues)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* feat: replace cloud translation with local Neural CLI

## Changes

### Removed (OpenAI-dependent)
- ❌ `.github/workflows/translation-sync.yml` - GPT-Translate workflow
- ❌ `docs/Development/translation-workflow.md` - OpenAI setup docs

### Added (Local Ollama-based)
- ✅ `Makefile`: New `make translate` target using Neural CLI
- ✅ `docs/Development/translation-guide.md` - Neural CLI guide

## Benefits

**Before (GPT-Translate)**:
- 💰 Monthly cost: ~¥90 (OpenAI API)
- 🔑 Requires API key setup
- 🌐 Data sent to external API
- ⏱️ Network latency

**After (Neural CLI)**:
- ✅ **$0 cost** - Fully local execution
- ✅ **No API keys** - Zero setup friction
- ✅ **Privacy** - No external data transfer
- ✅ **Fast** - ~1-2 min per README
- ✅ **Offline capable** - Works without internet

## Technical Details

**Neural CLI**:
- Built in Rust with Tauri
- Uses Ollama + qwen2.5:3b model
- Binary size: 4.0MB
- Auto-installs to ~/.local/bin/

**Usage**:
```bash
make translate  # Translates README.md → README-zh.md, README-ja.md
```

## Requirements

- Ollama installed: `curl -fsSL https://ollama.com/install.sh | sh`
- Model downloaded: `ollama pull qwen2.5:3b`
- Neural CLI built: `cd ~/github/neural/src-tauri && cargo build --bin neural-cli --release`

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

---------

Co-authored-by: kazuki <kazuki@kazukinoMacBook-Air.local>
Co-authored-by: Claude <noreply@anthropic.com>
2025-10-18 20:28:10 +05:30

5.4 KiB
Raw Blame History

SuperClaude Framework - Task List

最終更新: 2025-10-17

🔴 Critical（最優先）

インポートパス修正

  • CLAUDE.md のインポートパス修正
    • 問題: @superclaude/MODE_*.md → modes/ プレフィックス欠落
    • 原因: コミット 4599b90 でディレクトリ再構成時に発生
    • 実際の場所: superclaude/modes/MODE_*.md
    • 影響: MODE定義が正しくロードされない
    • 対応: .claude/CLAUDE.md の全 @superclaude/MODE_* を @superclaude/modes/MODE_* に修正

並列実行機能の復元

  • PARALLEL ツール呼び出しの徹底
    • 問題: Sequential実行されるべきでない操作がSequentialになっている
    • 要求: pm-agent.md および parallel-with-reflection.md の仕様通り
    • パターン: Wave → Checkpoint → Wave（並列→検証→並列）
    • 修正箇所: エージェント実装、モード定義

🟡 High Priority（重要）

PM Agent自動起動

  • セッション開始時の自動起動実装
    • 現状: 手動 /sc:pm 実行が必要
    • 目標: セッション開始時に自動実行
    • プロトコル:
      1. Read PLANNING.md, TASK.md, KNOWLEDGE.md
      2. Git status確認
      3. Token budget計算
      4. Confidence check
      5. Ready表示

Business Panel遅延ロード

  • 常時ロード削除によるトークン削減
    • 現状: 4,169トークン常時消費
    • 目標: 必要時のみロード（/sc:business-panel コマンド実行時）
    • 効果: 起動トークン3,000+削減

ドキュメント構造改善

  • PLANNING.md 作成 (2025-10-17)
    • アーキテクチャ、ディレクトリ構成、絶対守るルール
  • TASK.md 作成 (2025-10-17)
    • 優先度付きタスクリスト、完了履歴
  • KNOWLEDGE.md 作成 (2025-10-17)
    • 蓄積された知見、調査結果、失敗パターン
  • README.md 更新 (2025-10-17)
    • 新ドキュメント構造への参照追加
  • docs/重複削除 (2025-10-17)
    • 21ファイル、210KB削除（docs/Development/等）

🟢 Medium Priority（中優先度）

スタートアッププロトコル再設計

  • ディレクトリ構造探索優先
    • 現状: MODE定義を先にロード
    • 目標: プロジェクト構造を理解してからMODE適用
    • 順序:
      1. Git status、ディレクトリ構造把握
      2. PLANNING.md, TASK.md読み込み
      3. MODE定義ロード

パフォーマンス検証

  • Before/After トークン使用量測定
    • 測定項目:
      • セッション開始時のトークン使用量
      • Business Panel削除の効果
      • 並列実行の効率化
    • 目標: >3,000トークン削減を証明

⚪ Low Priority（低優先度）

ドキュメント整理

  • 重複ドキュメントの削除
    • 対象: docs/ 内の古い・重複ファイル
    • 基準: PLANNING.md, TASK.md, KNOWLEDGE.mdと重複する内容
    • 保持: ユーザーガイド、開発者ガイド等の公式ドキュメント

テストカバレッジ向上

  • PM Agent ユニットテスト
    • 対象: tests/pm_agent/
    • カバレッジ目標: >80%

✅ Completed（完了）

2025-10-17

  • ドキュメント再構成 (コミット 4599b90, edae4ac)
    • framework/business/research ディレクトリへ移動
    • コンポーネント参照更新
  • PM Agent動的トークン計算実装 (コミット eb90e17)
    • モジュラーアーキテクチャ
  • Root cause調査完了 (checkpoint.json)
    • ディレクトリリファクタでCLAUDE.mdのインポートパス破損を特定
  • Self-Improvement Loop実装完了 (コミット 9ef86a2, efd964d)
    • PLANNING.md: アーキテクチャ + 10個の絶対ルール (14KB)
    • TASK.md: 優先度付きタスクリスト (6KB)
    • KNOWLEDGE.md: 蓄積知見 + 失敗パターン (11KB)
    • README.md: 開発者向けリンク追加
    • docs/重複削除: 21ファイル、210KB削減

📋 Future Backlog（将来の課題）

新機能

  • Self-Improvement Loop完全実装
    • セッション開始プロトコル
    • 実行中の学習フロー
    • 定期振り返りメカニズム
  • Context7 統合強化
    • 最新ドキュメント自動参照
  • Deep Research エージェント改善
    • Multi-hop推論の精度向上

インフラ

  • CI/CD パイプライン整備
  • 自動テスト実行環境

📝 Task Management Rules

新しいタスクの追加

Format:
  - [ ] **タスク名**
    - 説明: 何をするか
    - 理由: なぜ必要か
    - 成功基準: 完了の定義

Priority:
  🔴 Critical: 即座に対応（バグ、ブロッカー）
  🟡 High: 近日中に対応（重要機能）
  🟢 Medium: 計画的に対応（改善）
  ⚪ Low: 余裕があれば対応（最適化）

タスク完了時

Action:
  1. チェックボックスにチェック [x]
  2. 完了日付を追記
  3. Completedセクションに移動
  4. 学んだことを KNOWLEDGE.md に追記

タスクの優先度変更

Trigger:
  - ブロッカー発生 → Critical昇格
  - 依存関係変化 → 優先度調整
  - ユーザー要求 → 優先度変更

このファイルは生きているタスクリストです。 常に最新の状態に保ち、完了したタスクは速やかにCompletedセクションへ移動してください。