Skip to content
This repository was archived by the owner on Mar 11, 2026. It is now read-only.
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .serena/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
/cache
67 changes: 67 additions & 0 deletions .serena/project.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,67 @@
# language of the project (csharp, python, rust, java, typescript, go, cpp, or ruby)
# * For C, use cpp
# * For JavaScript, use typescript
# Special requirements:
# * csharp: Requires the presence of a .sln file in the project folder.
language: bash

# whether to use the project's gitignore file to ignore files
# Added on 2025-04-07
ignore_all_files_in_gitignore: true
# list of additional paths to ignore
# same syntax as gitignore, so you can use * and **
# Was previously called `ignored_dirs`, please update your config if you are using that.
# Added (renamed) on 2025-04-07
ignored_paths: []

# whether the project is in read-only mode
# If set to true, all editing tools will be disabled and attempts to use them will result in an error
# Added on 2025-04-18
read_only: false

# list of tool names to exclude. We recommend not excluding any tools, see the readme for more details.
# Below is the complete list of tools for convenience.
# To make sure you have the latest list of tools, and to view their descriptions,
# execute `uv run scripts/print_tool_overview.py`.
#
# * `activate_project`: Activates a project by name.
# * `check_onboarding_performed`: Checks whether project onboarding was already performed.
# * `create_text_file`: Creates/overwrites a file in the project directory.
# * `delete_lines`: Deletes a range of lines within a file.
# * `delete_memory`: Deletes a memory from Serena's project-specific memory store.
# * `execute_shell_command`: Executes a shell command.
# * `find_referencing_code_snippets`: Finds code snippets in which the symbol at the given location is referenced.
# * `find_referencing_symbols`: Finds symbols that reference the symbol at the given location (optionally filtered by type).
# * `find_symbol`: Performs a global (or local) search for symbols with/containing a given name/substring (optionally filtered by type).
# * `get_current_config`: Prints the current configuration of the agent, including the active and available projects, tools, contexts, and modes.
# * `get_symbols_overview`: Gets an overview of the top-level symbols defined in a given file.
# * `initial_instructions`: Gets the initial instructions for the current project.
# Should only be used in settings where the system prompt cannot be set,
# e.g. in clients you have no control over, like Claude Desktop.
# * `insert_after_symbol`: Inserts content after the end of the definition of a given symbol.
# * `insert_at_line`: Inserts content at a given line in a file.
# * `insert_before_symbol`: Inserts content before the beginning of the definition of a given symbol.
# * `list_dir`: Lists files and directories in the given directory (optionally with recursion).
# * `list_memories`: Lists memories in Serena's project-specific memory store.
# * `onboarding`: Performs onboarding (identifying the project structure and essential tasks, e.g. for testing or building).
# * `prepare_for_new_conversation`: Provides instructions for preparing for a new conversation (in order to continue with the necessary context).
# * `read_file`: Reads a file within the project directory.
# * `read_memory`: Reads the memory with the given name from Serena's project-specific memory store.
# * `remove_project`: Removes a project from the Serena configuration.
# * `replace_lines`: Replaces a range of lines within a file with new content.
# * `replace_symbol_body`: Replaces the full definition of a symbol.
# * `restart_language_server`: Restarts the language server, may be necessary when edits not through Serena happen.
# * `search_for_pattern`: Performs a search for a pattern in the project.
# * `summarize_changes`: Provides instructions for summarizing the changes made to the codebase.
# * `switch_modes`: Activates modes by providing a list of their names
# * `think_about_collected_information`: Thinking tool for pondering the completeness of collected information.
# * `think_about_task_adherence`: Thinking tool for determining whether the agent is still on track with the current task.
# * `think_about_whether_you_are_done`: Thinking tool for determining whether the task is truly completed.
# * `write_memory`: Writes a named memory (for future reference) to Serena's project-specific memory store.
excluded_tools: []

# initial prompt for the project. It will always be given to the LLM upon activating the project
# (contrary to the memories, which are loaded on demand).
initial_prompt: ""

project_name: "SmartPhoneAutoDevelopSetup"
28 changes: 27 additions & 1 deletion CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,29 +6,55 @@

## 開発ルール
- **共通ルール**: 変数命名、コードスタイル、コメントの書き方はプロジェクト内で統一する。
- **テスト駆動開発(TDD)** を基本とする
- **Spec Kit + TDD統合開発**: 仕様駆動開発とテスト駆動開発を組み合わせた開発フローを採用する
- **Issue Driven 開発**: すべての開発はIssueから開始し、Issueに紐づけて進める。
- **MCPツールの使用必須**: 開発作業は基本的にMCPのツールを使用する。
- **Formatter/Linter実行**: コード整形や静的解析はClaude CodeのHooksから自動実行すること。
- **プロジェクト憲法遵守**: 開発原則の一貫した適用と品質ゲートの確実な実行。
- **CLAUDE.mdの改善**: 開発を始める際には、READMEやIssueを参照して、そのプロジェクト用にCLAUDE.mdを必要に応じて改善する。

### Spec Kit + TDD 開発フロー
1. **仕様作成** (`/specify`) - 自然言語から正式仕様を作成
2. **計画立案** (`/plan`) - 技術選定と実装計画
3. **タスク生成** (`/tasks`) - TDD準拠のタスクリスト作成
4. **TDD実装** (`/implement`) - Red-Green-Refactorサイクル
5. **品質確認** (`/code-review`, `/constitution`) - 品質とプロジェクト憲法への準拠確認

## 構成
- `.github/workflows/claude.yml` : Claude Codeを動作させるワークフロー
- `README.md` : プロジェクト概要と開発ガイド
- `CLAUDE.md` : Claude Codeへの指示
- `.claude/commands/` : カスタムスラッシュコマンド定義
- `.claude/agents/` : 専門サブエージェント定義
- `.claude/hooks/` : コード検証・整形スクリプト
- `.specify/` : Spec Kit設定・テンプレート・実行スクリプト

### ドキュメント
- `docs/COMMANDS.md` : スラッシュコマンド詳細ガイド
- `docs/AGENTS.md` : サブエージェント詳細ガイド
- `docs/SPEC_KIT_TDD_WORKFLOW.md` : Spec Kit + TDD統合ワークフロー
- `docs/GITHUB_ACTIONS_SETUP.md` : GitHub Actions設定ガイド

## 設定・制約
- 依存ライブラリの追加は最小限にとどめる。
- トリガー条件やワークフローの変更も最小限にする。

## カスタムスラッシュコマンド
以下のスラッシュコマンドが利用可能です:

### プロジェクト管理
- `/setup-project` - プロジェクトの初期セットアップ

### Spec Kit統合コマンド(仕様駆動開発)
- `/specify` - 自然言語から仕様作成
- `/plan` - 仕様から実装計画作成
- `/clarify` - 仕様の対話的明確化
- `/tasks` - TDD準拠のタスクリスト生成
- `/implement` - TDDサイクルでの実装
- `/analyze` - 既存仕様の分析
- `/constitution` - プロジェクト憲法管理

### 開発支援
- `/code-review` - コード品質分析とレビュー
- `/debug-help` - デバッグ支援とエラー分析
- `/refactor` - コードリファクタリングと改善
Expand Down
184 changes: 183 additions & 1 deletion docs/AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,189 @@

## 利用可能なサブエージェント

再編集
### `rust-expert` - Rust開発専門家

**専門分野**:
- Rustの所有権システムとライフタイム管理
- パフォーマンス最適化とメモリ効率
- 非同期プログラミング(async/await、tokio)
- システムプログラミング・WebAssembly開発
- Cargoエコシステム

**実行可能タスク**:
- Rustプロジェクトの設計・実装
- 所有権エラーの解決
- パフォーマンス分析とボトルネック解決
- クレート選定と統合
- テストコード作成(unit、integration、doc tests)
- Clippyワーニング修正
- Unsafe Rustコードレビュー

**使用例**:
```bash
@claude rust-expert: 所有権エラーを修正してください
@claude rust-expert: tokioを使った非同期処理を実装
@claude rust-expert: パフォーマンス最適化を行ってください
```

**開発ツール**:
- cargo(build、test、clippy、fmt)
- rustdoc、cargo-audit、cargo-tarpaulin
- flamegraph(プロファイリング)

---

### `web-developer` - Web開発専門家

**専門分野**:
- フロントエンド開発(React、Vue、Angular等)
- バックエンドAPI設計・実装
- レスポンシブデザイン・UI/UX
- Web パフォーマンス最適化

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

表記の揺れを修正し、一貫性を保つことをお勧めします。他の箇所(例: 13行目のWebAssembly開発、53行目のWebパフォーマンス分析・改善)では Web と日本語の間にスペースが入っていません。一貫性のためにスペースを削除してはどうでしょうか。

Suggested change
- Web パフォーマンス最適化
- Webパフォーマンス最適化

- SEO・アクセシビリティ

**実行可能タスク**:
- SPAアプリケーション開発
- REST/GraphQL API設計
- レスポンシブWebデザイン
- PWA(Progressive Web App)開発
- Webパフォーマンス分析・改善
- Cross-browserテスト

**使用例**:
```bash
@claude web-developer: レスポンシブデザインを実装してください
@claude web-developer: REST APIを設計・実装
@claude web-developer: PWA化してください
```

**技術スタック**:
- Frontend: React/Vue/Angular、TypeScript
- Backend: Node.js、Express、FastAPI
- Database: PostgreSQL、MongoDB
- Tools: Webpack、Vite、ESLint

---

### `mobile-developer` - モバイルアプリ開発専門家

**専門分野**:
- iOS開発(Swift、UIKit、SwiftUI)
- Android開発(Kotlin、Jetpack Compose)
- クロスプラットフォーム(React Native、Flutter)
- モバイル設計パターン・アーキテクチャ
- アプリストア最適化

**実行可能タスク**:
- ネイティブモバイルアプリ開発
- クロスプラットフォームアプリ開発
- モバイル特化UI/UX実装
- プッシュ通知・バックグラウンド処理
- アプリ最適化・パフォーマンス改善
- アプリストア申請準備

**使用例**:
```bash
@claude mobile-developer: iOS アプリのUIを実装してください
@claude mobile-developer: プッシュ通知機能を追加
@claude mobile-developer: Flutter でクロスプラットフォームアプリを作成
```

---

### `devops-engineer` - DevOpsとインフラ専門家

**専門分野**:
- CI/CDパイプライン設計・構築
- コンテナ化(Docker、Kubernetes)
- クラウドインフラ(AWS、GCP、Azure)
- Infrastructure as Code(Terraform、CloudFormation)
- 監視・ログ管理システム

**実行可能タスク**:
- GitHub Actions/GitLab CI設定
- Docker化・Kubernetes設定
- クラウドインフラ設計・構築
- 監視・アラート設定
- セキュリティ設定・脆弱性対応
- デプロイメント自動化

**使用例**:
```bash
@claude devops-engineer: CI/CDパイプラインを設定してください
@claude devops-engineer: Kubernetesにデプロイできるよう設定
@claude devops-engineer: 監視システムを構築
```

**インフラツール**:
- Container: Docker、Kubernetes
- Cloud: AWS、GCP、Azure
- IaC: Terraform、Ansible
- Monitoring: Prometheus、Grafana

---

### `data-scientist` - データサイエンスと機械学習専門家

**専門分野**:
- 機械学習モデル設計・実装
- データ分析・可視化
- 統計解析・予測モデリング
- MLOps・モデルデプロイメント
- ビッグデータ処理

**実行可能タスク**:
- 機械学習パイプライン構築
- データクリーニング・前処理
- 特徴量エンジニアリング
- モデル評価・検証
- データ可視化・レポート作成
- A/Bテスト設計・分析

**使用例**:
```bash
@claude data-scientist: 予測モデルを構築してください
@claude data-scientist: データ分析とレポート作成
@claude data-scientist: MLOpsパイプラインを設定
```

**技術スタック**:
- Python: pandas、scikit-learn、PyTorch、TensorFlow
- R: tidyverse、ggplot2、caret
- Big Data: Spark、Hadoop
- Visualization: matplotlib、seaborn、plotly

---

### `security-expert` - セキュリティと脆弱性専門家

**専門分野**:
- セキュリティ監査・脆弱性評価
- ペネトレーションテスト
- セキュアコーディング
- 暗号化・認証システム
- コンプライアンス対応

**実行可能タスク**:
- セキュリティ監査・脆弱性スキャン
- セキュアなアーキテクチャ設計
- 認証・認可システム実装
- 暗号化機能実装
- セキュリティテスト実行
- コンプライアンス準拠確認

**使用例**:
```bash
@claude security-expert: 脆弱性を検査してください
@claude security-expert: 認証システムをセキュアに実装
@claude security-expert: OWASP準拠のセキュリティテスト実行
```

**セキュリティツール**:
- SAST: SonarQube、CodeQL
- DAST: OWASP ZAP、Burp Suite
- 依存関係: Snyk、npm audit
- Container: Trivy、Clair

## 使用時のベストプラクティス

Expand Down
Loading