claude-nagger 1.0.1__tar.gz

claude_nagger-1.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 HollySizzle
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

claude_nagger-1.0.1/PKG-INFO

@@ -0,0 +1,328 @@
+Metadata-Version: 2.4
+Name: claude-nagger
+Version: 1.0.1
+Summary: Claude Code統合ツールシステム - フック・規約管理CLI
+Author: HollySizzle
+License: MIT
+Project-URL: Homepage, https://github.com/HollySizzle/claude-nagger
+Project-URL: Repository, https://github.com/HollySizzle/claude-nagger
+Keywords: claude,claude-code,hooks,conventions
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: questionary>=2.0.0
+Requires-Dist: pytz>=2023.3
+Requires-Dist: json5>=0.9.14
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: typing-extensions>=4.8.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: aiohttp>=3.8.0
+Requires-Dist: wcmatch>=10.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Dynamic: license-file
+
+# claude-nagger
+
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![PyPI](https://img.shields.io/pypi/v/claude-nagger.svg)](https://pypi.org/project/claude-nagger/)
+
+Claude Codeに「必要な時だけ」規約を読ませるフックツール
+
+## 解決する問題
+
+Claude Codeで中〜大規模プロジェクトを扱う際、以下の問題が発生します:
+
+| 問題 | 説明 |
+|------|------|
+| **コンテキスト肥大化** | 全規約をCLAUDE.mdに書くとトークン消費が膨大 |
+| **規約の忘却** | コンテキスト圧縮(compacting)により規約が「忘れられる」 |
+| **無関係な情報** | モデル編集時にCSS規約は不要、逆も然り |
+
+## 解決策
+
+```
+EditツールでCSS編集 → CSS規約のみ注入
+Editツールでモデル編集 → モデル規約のみ注入
+```
+
+CLAUDE.mdでは実現できない「PreToolUseフックによる条件付き規約注入」を提供します。
+
+---
+
+## クイックスタート
+
+### 1. インストール
+
+```bash
+# uvx（推奨・インストール不要で実行）
+uvx claude-nagger install-hooks
+
+# または pip
+pip install claude-nagger
+claude-nagger install-hooks
+```
+
+### 2. 動作確認
+
+```bash
+# dry-runで生成内容を確認
+claude-nagger install-hooks --dry-run
+```
+
+### 3. 設定カスタマイズ
+
+生成された `.claude-nagger/` 内のYAMLファイルを編集して、プロジェクト固有の規約を設定します。
+
+---
+
+## 生成されるファイル構造
+
+```
+your-project/
+├── .claude-nagger/
+│   ├── config.yaml              # メイン設定（セッション管理等）
+│   ├── file_conventions.yaml    # ファイル編集時の規約
+│   └── command_conventions.yaml # コマンド実行時の規約
+└── .claude/
+    └── settings.json            # ← claude-naggerが自動設定
+```
+
+---
+
+## 設定ファイル詳細
+
+### config.yaml（メイン設定）
+
+セッション開始時のメッセージやコンテキスト管理を設定します。
+
+```yaml
+# セッション開始時設定
+session_startup:
+  enabled: true
+  messages:
+    first_time:
+      title: "プロジェクトセットアップ"
+      main_text: |
+        プロジェクトの規約を確認してください
+      severity: "block"  # block: 確認必須, warn: 警告のみ
+
+# コンテキスト管理設定（トークン数に応じたリマインダー）
+context_management:
+  reminder_thresholds:
+    light_warning: 30000     # 軽い警告
+    medium_warning: 60000    # 中程度の警告
+    critical_warning: 100000 # 重要な警告
+
+# デバッグ設定
+debug:
+  enable_logging: false
+```
+
+### file_conventions.yaml（ファイル編集規約）
+
+特定のファイルパターンに対して適用される規約を定義します。
+
+```yaml
+rules:
+  # CSS編集時の規約
+  - name: "CSS編集規約"
+    patterns:
+      - "**/*.css"
+      - "**/*.scss"
+    severity: "warn"
+    token_threshold: 30000
+    message: |
+      ## CSS規約
+      - BEM命名規則を使用
+      - !important は禁止
+      - ネストは3階層まで
+
+  # モデル編集時の規約
+  - name: "モデル編集規約"
+    patterns:
+      - "**/models/**/*.py"
+      - "**/entities/**/*.py"
+    severity: "block"
+    token_threshold: 35000
+    message: |
+      ## モデル規約
+      - フィールド名はsnake_case
+      - 必ずdocstringを記載
+      - バリデーションを実装
+
+  # View層編集時の規約
+  - name: "View層編集規約"
+    patterns:
+      - "**/views/**/*.erb"
+      - "**/templates/**/*.html"
+    severity: "warn"
+    message: |
+      ## View規約
+      - XSS対策を徹底
+      - ロジックはヘルパーに委譲
+```
+
+### command_conventions.yaml（コマンド実行規約）
+
+危険なコマンドや確認が必要なコマンドに対して適用される規約を定義します。
+
+```yaml
+rules:
+  # Git操作規約
+  - name: "Git操作規約"
+    patterns:
+      - "git push*"
+      - "git commit*"
+    severity: "warn"
+    token_threshold: 25000
+    message: |
+      ## Git規約
+      - コミットメッセージは日本語で記載
+      - プッシュ前にテストを実行
+
+  # 本番環境操作規約
+  - name: "本番環境操作規約"
+    patterns:
+      - "*production*"
+      - "*deploy*"
+    severity: "block"
+    message: |
+      ## 本番環境操作
+      - 必ず承認を得てから実行
+      - バックアップを確認
+```
+
+---
+
+## ユースケース例
+
+### Rails プロジェクト
+
+```yaml
+# file_conventions.yaml
+rules:
+  - name: "コントローラ規約"
+    patterns: ["**/controllers/**/*.rb"]
+    message: |
+      - before_actionでの認証確認
+      - Strong Parametersの使用必須
+
+  - name: "マイグレーション規約"
+    patterns: ["**/migrate/*.rb"]
+    severity: "block"
+    message: |
+      - 必ずロールバック可能にする
+      - 大量データ更新時はバッチ処理
+```
+
+### React プロジェクト
+
+```yaml
+# file_conventions.yaml
+rules:
+  - name: "コンポーネント規約"
+    patterns: ["**/components/**/*.tsx"]
+    message: |
+      - Propsの型定義必須
+      - useCallbackでメモ化検討
+
+  - name: "フック規約"
+    patterns: ["**/hooks/**/*.ts"]
+    message: |
+      - カスタムフックは use* で命名
+      - 依存配列を正確に記述
+```
+
+### Python プロジェクト
+
+```yaml
+# file_conventions.yaml
+rules:
+  - name: "API規約"
+    patterns: ["**/api/**/*.py", "**/routes/**/*.py"]
+    message: |
+      - 入力バリデーション必須
+      - エラーハンドリングを実装
+
+  - name: "テスト規約"
+    patterns: ["**/tests/**/*.py"]
+    message: |
+      - Arrange-Act-Assertパターン
+      - モックは最小限に
+```
+
+---
+
+## 動作原理
+
+```
+┌─────────────────────────────────────────────────────────┐
+│ Claude Code                                             │
+│                                                         │
+│  ユーザー: "このCSSを修正して"                          │
+│       ↓                                                 │
+│  Claude: Edit ツール呼び出し (*.css)                    │
+│       ↓                                                 │
+│  ┌─────────────────────────────────────┐               │
+│  │ PreToolUse Hook (claude-nagger)     │               │
+│  │                                     │               │
+│  │ 1. パターン照合: "**/*.css" ✓       │               │
+│  │ 2. 対応する規約を読み込み           │               │
+│  │ 3. 規約をコンテキストに注入         │               │
+│  └─────────────────────────────────────┘               │
+│       ↓                                                 │
+│  Claude: 規約を参照しながらCSS編集                      │
+└─────────────────────────────────────────────────────────┘
+```
+
+---
+
+## コマンド一覧
+
+```bash
+# フックのインストール（.claude/settings.jsonに設定追加）
+claude-nagger install-hooks
+
+# dry-run（実際には変更しない）
+claude-nagger install-hooks --dry-run
+
+# 強制上書き（既存ファイルも再生成）
+claude-nagger install-hooks --force
+
+# バージョン表示
+claude-nagger --version
+```
+
+---
+
+## なぜCLAUDE.mdだけでは不十分か
+
+| アプローチ | コンテキスト消費 | 規約遵守率 | 柔軟性 |
+|-----------|-----------------|-----------|--------|
+| 全規約をCLAUDE.mdに記載 | 高 (常時) | 低 (忘却) | 低 |
+| claude-nagger | 低 (必要時のみ) | 高 | 高 |
+
+---
+
+## 要件
+
+- Python 3.10以上
+- Claude Code CLI
+
+---
+
+## ライセンス
+
+MIT License - 詳細は [LICENSE](LICENSE) を参照

claude_nagger-1.0.1/README.md

@@ -0,0 +1,294 @@
+# claude-nagger
+
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![PyPI](https://img.shields.io/pypi/v/claude-nagger.svg)](https://pypi.org/project/claude-nagger/)
+
+Claude Codeに「必要な時だけ」規約を読ませるフックツール
+
+## 解決する問題
+
+Claude Codeで中〜大規模プロジェクトを扱う際、以下の問題が発生します:
+
+| 問題 | 説明 |
+|------|------|
+| **コンテキスト肥大化** | 全規約をCLAUDE.mdに書くとトークン消費が膨大 |
+| **規約の忘却** | コンテキスト圧縮(compacting)により規約が「忘れられる」 |
+| **無関係な情報** | モデル編集時にCSS規約は不要、逆も然り |
+
+## 解決策
+
+```
+EditツールでCSS編集 → CSS規約のみ注入
+Editツールでモデル編集 → モデル規約のみ注入
+```
+
+CLAUDE.mdでは実現できない「PreToolUseフックによる条件付き規約注入」を提供します。
+
+---
+
+## クイックスタート
+
+### 1. インストール
+
+```bash
+# uvx（推奨・インストール不要で実行）
+uvx claude-nagger install-hooks
+
+# または pip
+pip install claude-nagger
+claude-nagger install-hooks
+```
+
+### 2. 動作確認
+
+```bash
+# dry-runで生成内容を確認
+claude-nagger install-hooks --dry-run
+```
+
+### 3. 設定カスタマイズ
+
+生成された `.claude-nagger/` 内のYAMLファイルを編集して、プロジェクト固有の規約を設定します。
+
+---
+
+## 生成されるファイル構造
+
+```
+your-project/
+├── .claude-nagger/
+│   ├── config.yaml              # メイン設定（セッション管理等）
+│   ├── file_conventions.yaml    # ファイル編集時の規約
+│   └── command_conventions.yaml # コマンド実行時の規約
+└── .claude/
+    └── settings.json            # ← claude-naggerが自動設定
+```
+
+---
+
+## 設定ファイル詳細
+
+### config.yaml（メイン設定）
+
+セッション開始時のメッセージやコンテキスト管理を設定します。
+
+```yaml
+# セッション開始時設定
+session_startup:
+  enabled: true
+  messages:
+    first_time:
+      title: "プロジェクトセットアップ"
+      main_text: |
+        プロジェクトの規約を確認してください
+      severity: "block"  # block: 確認必須, warn: 警告のみ
+
+# コンテキスト管理設定（トークン数に応じたリマインダー）
+context_management:
+  reminder_thresholds:
+    light_warning: 30000     # 軽い警告
+    medium_warning: 60000    # 中程度の警告
+    critical_warning: 100000 # 重要な警告
+
+# デバッグ設定
+debug:
+  enable_logging: false
+```
+
+### file_conventions.yaml（ファイル編集規約）
+
+特定のファイルパターンに対して適用される規約を定義します。
+
+```yaml
+rules:
+  # CSS編集時の規約
+  - name: "CSS編集規約"
+    patterns:
+      - "**/*.css"
+      - "**/*.scss"
+    severity: "warn"
+    token_threshold: 30000
+    message: |
+      ## CSS規約
+      - BEM命名規則を使用
+      - !important は禁止
+      - ネストは3階層まで
+
+  # モデル編集時の規約
+  - name: "モデル編集規約"
+    patterns:
+      - "**/models/**/*.py"
+      - "**/entities/**/*.py"
+    severity: "block"
+    token_threshold: 35000
+    message: |
+      ## モデル規約
+      - フィールド名はsnake_case
+      - 必ずdocstringを記載
+      - バリデーションを実装
+
+  # View層編集時の規約
+  - name: "View層編集規約"
+    patterns:
+      - "**/views/**/*.erb"
+      - "**/templates/**/*.html"
+    severity: "warn"
+    message: |
+      ## View規約
+      - XSS対策を徹底
+      - ロジックはヘルパーに委譲
+```
+
+### command_conventions.yaml（コマンド実行規約）
+
+危険なコマンドや確認が必要なコマンドに対して適用される規約を定義します。
+
+```yaml
+rules:
+  # Git操作規約
+  - name: "Git操作規約"
+    patterns:
+      - "git push*"
+      - "git commit*"
+    severity: "warn"
+    token_threshold: 25000
+    message: |
+      ## Git規約
+      - コミットメッセージは日本語で記載
+      - プッシュ前にテストを実行
+
+  # 本番環境操作規約
+  - name: "本番環境操作規約"
+    patterns:
+      - "*production*"
+      - "*deploy*"
+    severity: "block"
+    message: |
+      ## 本番環境操作
+      - 必ず承認を得てから実行
+      - バックアップを確認
+```
+
+---
+
+## ユースケース例
+
+### Rails プロジェクト
+
+```yaml
+# file_conventions.yaml
+rules:
+  - name: "コントローラ規約"
+    patterns: ["**/controllers/**/*.rb"]
+    message: |
+      - before_actionでの認証確認
+      - Strong Parametersの使用必須
+
+  - name: "マイグレーション規約"
+    patterns: ["**/migrate/*.rb"]
+    severity: "block"
+    message: |
+      - 必ずロールバック可能にする
+      - 大量データ更新時はバッチ処理
+```
+
+### React プロジェクト
+
+```yaml
+# file_conventions.yaml
+rules:
+  - name: "コンポーネント規約"
+    patterns: ["**/components/**/*.tsx"]
+    message: |
+      - Propsの型定義必須
+      - useCallbackでメモ化検討
+
+  - name: "フック規約"
+    patterns: ["**/hooks/**/*.ts"]
+    message: |
+      - カスタムフックは use* で命名
+      - 依存配列を正確に記述
+```
+
+### Python プロジェクト
+
+```yaml
+# file_conventions.yaml
+rules:
+  - name: "API規約"
+    patterns: ["**/api/**/*.py", "**/routes/**/*.py"]
+    message: |
+      - 入力バリデーション必須
+      - エラーハンドリングを実装
+
+  - name: "テスト規約"
+    patterns: ["**/tests/**/*.py"]
+    message: |
+      - Arrange-Act-Assertパターン
+      - モックは最小限に
+```
+
+---
+
+## 動作原理
+
+```
+┌─────────────────────────────────────────────────────────┐
+│ Claude Code                                             │
+│                                                         │
+│  ユーザー: "このCSSを修正して"                          │
+│       ↓                                                 │
+│  Claude: Edit ツール呼び出し (*.css)                    │
+│       ↓                                                 │
+│  ┌─────────────────────────────────────┐               │
+│  │ PreToolUse Hook (claude-nagger)     │               │
+│  │                                     │               │
+│  │ 1. パターン照合: "**/*.css" ✓       │               │
+│  │ 2. 対応する規約を読み込み           │               │
+│  │ 3. 規約をコンテキストに注入         │               │
+│  └─────────────────────────────────────┘               │
+│       ↓                                                 │
+│  Claude: 規約を参照しながらCSS編集                      │
+└─────────────────────────────────────────────────────────┘
+```
+
+---
+
+## コマンド一覧
+
+```bash
+# フックのインストール（.claude/settings.jsonに設定追加）
+claude-nagger install-hooks
+
+# dry-run（実際には変更しない）
+claude-nagger install-hooks --dry-run
+
+# 強制上書き（既存ファイルも再生成）
+claude-nagger install-hooks --force
+
+# バージョン表示
+claude-nagger --version
+```
+
+---
+
+## なぜCLAUDE.mdだけでは不十分か
+
+| アプローチ | コンテキスト消費 | 規約遵守率 | 柔軟性 |
+|-----------|-----------------|-----------|--------|
+| 全規約をCLAUDE.mdに記載 | 高 (常時) | 低 (忘却) | 低 |
+| claude-nagger | 低 (必要時のみ) | 高 | 高 |
+
+---
+
+## 要件
+
+- Python 3.10以上
+- Claude Code CLI
+
+---
+
+## ライセンス
+
+MIT License - 詳細は [LICENSE](LICENSE) を参照

claude_nagger-1.0.1/pyproject.toml

@@ -0,0 +1,65 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "claude-nagger"
+version = "1.0.1"
+description = "Claude Code統合ツールシステム - フック・規約管理CLI"
+readme = "README.md"
+requires-python = ">=3.10"
+license = {text = "MIT"}
+authors = [
+    {name = "HollySizzle"}
+]
+keywords = ["claude", "claude-code", "hooks", "conventions"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+
+dependencies = [
+    "questionary>=2.0.0",
+    "pytz>=2023.3",
+    "json5>=0.9.14",
+    "pyyaml>=6.0",
+    "typing-extensions>=4.8.0",
+    "rich>=13.0.0",
+    "aiohttp>=3.8.0",
+    "wcmatch>=10.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-cov>=4.0.0",
+]
+
+[project.scripts]
+claude-nagger = "application.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/HollySizzle/claude-nagger"
+Repository = "https://github.com/HollySizzle/claude-nagger"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["application*", "domain*", "infrastructure*", "shared*"]
+
+[tool.setuptools.package-dir]
+"" = "src"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_functions = ["test_*"]
+addopts = "-v --tb=short"
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"

claude_nagger-1.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+