diff --git a/.claude/commands/development/code-review.md b/.claude/commands/development/code-review.md deleted file mode 100644 index 8f3c00b..0000000 --- a/.claude/commands/development/code-review.md +++ /dev/null @@ -1,23 +0,0 @@ -# /code-review - -コードレビューを実行し、品質向上のための提案を行います。 - -## 実行内容 -1. コード品質の分析 -2. セキュリティ脆弱性のチェック -3. パフォーマンス改善点の指摘 -4. ベストプラクティスの適用確認 -5. テストカバレッジの評価 -6. ドキュメントの完全性チェック - -## 使用例 -- `/code-review` - 変更されたファイルをレビュー -- `/code-review --full` - プロジェクト全体をレビュー -- `/code-review src/main.rs` - 特定ファイルをレビュー - -## レビュー観点 -- コード品質(可読性、保守性) -- セキュリティ(脆弱性、認証・認可) -- パフォーマンス(計算量、メモリ使用量) -- テスト(カバレッジ、エッジケース) -- ドキュメント(コメント、README) \ No newline at end of file diff --git a/.claude/commands/development/debug-help.md b/.claude/commands/development/debug-help.md deleted file mode 100644 index 57828ca..0000000 --- a/.claude/commands/development/debug-help.md +++ /dev/null @@ -1,24 +0,0 @@ -# /debug-help - -デバッグ支援を行い、問題の特定と解決策を提供します。 - -## 実行内容 -1. エラーメッセージの解析 -2. ログの分析と問題箇所の特定 -3. 再現手順の確認 -4. 原因の推定と修正案の提示 -5. テストケースの作成支援 -6. デバッグ手法の提案 - -## 使用例 -- `/debug-help` - 現在のエラー状況を分析 -- `/debug-help "error message"` - 特定のエラーメッセージを分析 -- `/debug-help --logs` - ログファイルから問題を特定 - -## 対応する問題タイプ -- コンパイル/ビルドエラー -- 実行時エラー・例外 -- パフォーマンス問題 -- メモリリーク -- データ破損・不整合 -- ネットワーク・通信エラー \ No newline at end of file diff --git a/.claude/commands/development/refactor.md b/.claude/commands/development/refactor.md deleted file mode 100644 index c984e3b..0000000 --- a/.claude/commands/development/refactor.md +++ /dev/null @@ -1,25 +0,0 @@ -# /refactor - -コードリファクタリングを実行し、保守性と可読性を向上させます。 - -## 実行内容 -1. コード重複の除去 -2. 関数・クラス設計の改善 -3. 命名規則の統一 -4. デザインパターンの適用 -5. 依存関係の整理 -6. パフォーマンス最適化 - -## 使用例 -- `/refactor` - 選択中のコードをリファクタリング -- `/refactor --extract-function` - 関数抽出リファクタリング -- `/refactor --rename-variables` - 変数名の統一・改善 - -## リファクタリング手法 -- Extract Method/Function -- Extract Class/Module -- Rename Variable/Function/Class -- Move Method/Field -- Replace Magic Numbers with Constants -- Eliminate Code Duplication -- Simplify Conditional Expressions \ No newline at end of file diff --git a/.claude/commands/documentation/docs-gen.md b/.claude/commands/documentation/docs-gen.md deleted file mode 100644 index aff3da8..0000000 --- a/.claude/commands/documentation/docs-gen.md +++ /dev/null @@ -1,25 +0,0 @@ -# /docs-gen - -ドキュメントの自動生成と既存ドキュメントの改善を行います。 - -## 実行内容 -1. API ドキュメントの生成 -2. README ファイルの作成・更新 -3. インラインコメントの追加 -4. 使用例・サンプルコードの作成 -5. 設計ドキュメントの生成 -6. 多言語対応ドキュメント - -## 使用例 -- `/docs-gen` - 選択中のコードのドキュメントを生成 -- `/docs-gen --api` - API ドキュメントを生成 -- `/docs-gen --readme` - README ファイルを更新 - -## 生成するドキュメント -- README.md -- API Reference -- Code Comments -- Usage Examples -- Architecture Documents -- Development Guide -- User Manual \ No newline at end of file diff --git a/.claude/commands/project-management/setup-project.md b/.claude/commands/project-management/setup-project.md deleted file mode 100644 index 79b2f86..0000000 --- a/.claude/commands/project-management/setup-project.md +++ /dev/null @@ -1,22 +0,0 @@ -# /setup-project - -新規プロジェクトの初期セットアップを行います。 - -## 実行内容 -1. プロジェクト構造の分析 -2. 必要な設定ファイルの確認・作成 -3. 依存関係の解決 -4. 開発環境の初期化 -5. 基本的なCI/CD設定の確認 - -## 使用例 -- `/setup-project` - 現在のディレクトリでプロジェクトセットアップを実行 -- 言語やフレームワークを自動検出してセットアップを行う - -## 対象言語・フレームワーク -- Rust (Cargo.toml) -- Node.js (package.json) -- Python (pyproject.toml, requirements.txt) -- Go (go.mod) -- Java/Kotlin (build.gradle, pom.xml) -- その他の一般的なプロジェクト構成 \ No newline at end of file diff --git a/.claude/commands/spec-kit/analyze.md b/.claude/commands/spec-kit/analyze.md deleted file mode 100644 index f4c1a7b..0000000 --- a/.claude/commands/spec-kit/analyze.md +++ /dev/null @@ -1,101 +0,0 @@ ---- -description: Perform a non-destructive cross-artifact consistency and quality analysis across spec.md, plan.md, and tasks.md after task generation. ---- - -The user input to you can be provided directly by the agent or as a command argument - you **MUST** consider it before proceeding with the prompt (if not empty). - -User input: - -$ARGUMENTS - -Goal: Identify inconsistencies, duplications, ambiguities, and underspecified items across the three core artifacts (`spec.md`, `plan.md`, `tasks.md`) before implementation. This command MUST run only after `/tasks` has successfully produced a complete `tasks.md`. - -STRICTLY READ-ONLY: Do **not** modify any files. Output a structured analysis report. Offer an optional remediation plan (user must explicitly approve before any follow-up editing commands would be invoked manually). - -Constitution Authority: The project constitution (`.specify/memory/constitution.md`) is **non-negotiable** within this analysis scope. Constitution conflicts are automatically CRITICAL and require adjustment of the spec, plan, or tasks—not dilution, reinterpretation, or silent ignoring of the principle. If a principle itself needs to change, that must occur in a separate, explicit constitution update outside `/analyze`. - -Execution steps: - -1. Run `.specify/scripts/bash/check-prerequisites.sh --json --require-tasks --include-tasks` once from repo root and parse JSON for FEATURE_DIR and AVAILABLE_DOCS. Derive absolute paths: - - SPEC = FEATURE_DIR/spec.md - - PLAN = FEATURE_DIR/plan.md - - TASKS = FEATURE_DIR/tasks.md - Abort with an error message if any required file is missing (instruct the user to run missing prerequisite command). - -2. Load artifacts: - - Parse spec.md sections: Overview/Context, Functional Requirements, Non-Functional Requirements, User Stories, Edge Cases (if present). - - Parse plan.md: Architecture/stack choices, Data Model references, Phases, Technical constraints. - - Parse tasks.md: Task IDs, descriptions, phase grouping, parallel markers [P], referenced file paths. - - Load constitution `.specify/memory/constitution.md` for principle validation. - -3. Build internal semantic models: - - Requirements inventory: Each functional + non-functional requirement with a stable key (derive slug based on imperative phrase; e.g., "User can upload file" -> `user-can-upload-file`). - - User story/action inventory. - - Task coverage mapping: Map each task to one or more requirements or stories (inference by keyword / explicit reference patterns like IDs or key phrases). - - Constitution rule set: Extract principle names and any MUST/SHOULD normative statements. - -4. Detection passes: - A. Duplication detection: - - Identify near-duplicate requirements. Mark lower-quality phrasing for consolidation. - B. Ambiguity detection: - - Flag vague adjectives (fast, scalable, secure, intuitive, robust) lacking measurable criteria. - - Flag unresolved placeholders (TODO, TKTK, ???, , etc.). - C. Underspecification: - - Requirements with verbs but missing object or measurable outcome. - - User stories missing acceptance criteria alignment. - - Tasks referencing files or components not defined in spec/plan. - D. Constitution alignment: - - Any requirement or plan element conflicting with a MUST principle. - - Missing mandated sections or quality gates from constitution. - E. Coverage gaps: - - Requirements with zero associated tasks. - - Tasks with no mapped requirement/story. - - Non-functional requirements not reflected in tasks (e.g., performance, security). - F. Inconsistency: - - Terminology drift (same concept named differently across files). - - Data entities referenced in plan but absent in spec (or vice versa). - - Task ordering contradictions (e.g., integration tasks before foundational setup tasks without dependency note). - - Conflicting requirements (e.g., one requires to use Next.js while other says to use Vue as the framework). - -5. Severity assignment heuristic: - - CRITICAL: Violates constitution MUST, missing core spec artifact, or requirement with zero coverage that blocks baseline functionality. - - HIGH: Duplicate or conflicting requirement, ambiguous security/performance attribute, untestable acceptance criterion. - - MEDIUM: Terminology drift, missing non-functional task coverage, underspecified edge case. - - LOW: Style/wording improvements, minor redundancy not affecting execution order. - -6. Produce a Markdown report (no file writes) with sections: - - ### Specification Analysis Report - | ID | Category | Severity | Location(s) | Summary | Recommendation | - |----|----------|----------|-------------|---------|----------------| - | A1 | Duplication | HIGH | spec.md:L120-134 | Two similar requirements ... | Merge phrasing; keep clearer version | - (Add one row per finding; generate stable IDs prefixed by category initial.) - - Additional subsections: - - Coverage Summary Table: - | Requirement Key | Has Task? | Task IDs | Notes | - - Constitution Alignment Issues (if any) - - Unmapped Tasks (if any) - - Metrics: - * Total Requirements - * Total Tasks - * Coverage % (requirements with >=1 task) - * Ambiguity Count - * Duplication Count - * Critical Issues Count - -7. At end of report, output a concise Next Actions block: - - If CRITICAL issues exist: Recommend resolving before `/implement`. - - If only LOW/MEDIUM: User may proceed, but provide improvement suggestions. - - Provide explicit command suggestions: e.g., "Run /specify with refinement", "Run /plan to adjust architecture", "Manually edit tasks.md to add coverage for 'performance-metrics'". - -8. Ask the user: "Would you like me to suggest concrete remediation edits for the top N issues?" (Do NOT apply them automatically.) - -Behavior rules: -- NEVER modify files. -- NEVER hallucinate missing sections—if absent, report them. -- KEEP findings deterministic: if rerun without changes, produce consistent IDs and counts. -- LIMIT total findings in the main table to 50; aggregate remainder in a summarized overflow note. -- If zero issues found, emit a success report with coverage statistics and proceed recommendation. - -Context: $ARGUMENTS diff --git a/.claude/commands/spec-kit/clarify.md b/.claude/commands/spec-kit/clarify.md deleted file mode 100644 index 26ff530..0000000 --- a/.claude/commands/spec-kit/clarify.md +++ /dev/null @@ -1,158 +0,0 @@ ---- -description: Identify underspecified areas in the current feature spec by asking up to 5 highly targeted clarification questions and encoding answers back into the spec. ---- - -The user input to you can be provided directly by the agent or as a command argument - you **MUST** consider it before proceeding with the prompt (if not empty). - -User input: - -$ARGUMENTS - -Goal: Detect and reduce ambiguity or missing decision points in the active feature specification and record the clarifications directly in the spec file. - -Note: This clarification workflow is expected to run (and be completed) BEFORE invoking `/plan`. If the user explicitly states they are skipping clarification (e.g., exploratory spike), you may proceed, but must warn that downstream rework risk increases. - -Execution steps: - -1. Run `.specify/scripts/bash/check-prerequisites.sh --json --paths-only` from repo root **once** (combined `--json --paths-only` mode / `-Json -PathsOnly`). Parse minimal JSON payload fields: - - `FEATURE_DIR` - - `FEATURE_SPEC` - - (Optionally capture `IMPL_PLAN`, `TASKS` for future chained flows.) - - If JSON parsing fails, abort and instruct user to re-run `/specify` or verify feature branch environment. - -2. Load the current spec file. Perform a structured ambiguity & coverage scan using this taxonomy. For each category, mark status: Clear / Partial / Missing. Produce an internal coverage map used for prioritization (do not output raw map unless no questions will be asked). - - Functional Scope & Behavior: - - Core user goals & success criteria - - Explicit out-of-scope declarations - - User roles / personas differentiation - - Domain & Data Model: - - Entities, attributes, relationships - - Identity & uniqueness rules - - Lifecycle/state transitions - - Data volume / scale assumptions - - Interaction & UX Flow: - - Critical user journeys / sequences - - Error/empty/loading states - - Accessibility or localization notes - - Non-Functional Quality Attributes: - - Performance (latency, throughput targets) - - Scalability (horizontal/vertical, limits) - - Reliability & availability (uptime, recovery expectations) - - Observability (logging, metrics, tracing signals) - - Security & privacy (authN/Z, data protection, threat assumptions) - - Compliance / regulatory constraints (if any) - - Integration & External Dependencies: - - External services/APIs and failure modes - - Data import/export formats - - Protocol/versioning assumptions - - Edge Cases & Failure Handling: - - Negative scenarios - - Rate limiting / throttling - - Conflict resolution (e.g., concurrent edits) - - Constraints & Tradeoffs: - - Technical constraints (language, storage, hosting) - - Explicit tradeoffs or rejected alternatives - - Terminology & Consistency: - - Canonical glossary terms - - Avoided synonyms / deprecated terms - - Completion Signals: - - Acceptance criteria testability - - Measurable Definition of Done style indicators - - Misc / Placeholders: - - TODO markers / unresolved decisions - - Ambiguous adjectives ("robust", "intuitive") lacking quantification - - For each category with Partial or Missing status, add a candidate question opportunity unless: - - Clarification would not materially change implementation or validation strategy - - Information is better deferred to planning phase (note internally) - -3. Generate (internally) a prioritized queue of candidate clarification questions (maximum 5). Do NOT output them all at once. Apply these constraints: - - Maximum of 5 total questions across the whole session. - - Each question must be answerable with EITHER: - * A short multiple‑choice selection (2–5 distinct, mutually exclusive options), OR - * A one-word / short‑phrase answer (explicitly constrain: "Answer in <=5 words"). - - Only include questions whose answers materially impact architecture, data modeling, task decomposition, test design, UX behavior, operational readiness, or compliance validation. - - Ensure category coverage balance: attempt to cover the highest impact unresolved categories first; avoid asking two low-impact questions when a single high-impact area (e.g., security posture) is unresolved. - - Exclude questions already answered, trivial stylistic preferences, or plan-level execution details (unless blocking correctness). - - Favor clarifications that reduce downstream rework risk or prevent misaligned acceptance tests. - - If more than 5 categories remain unresolved, select the top 5 by (Impact * Uncertainty) heuristic. - -4. Sequential questioning loop (interactive): - - Present EXACTLY ONE question at a time. - - For multiple‑choice questions render options as a Markdown table: - - | Option | Description | - |--------|-------------| - | A |