Add vTeam shared Claude Code configuration with hooks-based enforcement

.gitignore

@@ -0,0 +1,104 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Jeremy Eder
+
+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.

README.md

@@ -45,4 +45,32 @@ RAT employs a microservices-based architecture with event-driven communication:
 - **Agent-Based Processing**: Specialized AI agents handle different aspects of refinement
 - **Jira Integration**: Seamless workflow integration with existing processes  
 - **Data Source Connectivity**: Links to RFEs, repositories, architectural decision records
-- **Automated Workflow**: Event-driven processing with minimal manual intervention
+- **Automated Workflow**: Event-driven processing with minimal manual intervention
+
+## Shared Configuration
+
+This repository includes shared Claude Code configuration for team development standards and workflows.
+
+### vTeam Shared-Configs
+
+Automated team configuration management via Python package:
+
+- **🔄 Automatic enforcement** - Hooks ensure team standards on every Git operation
+- **⚙️ Developer flexibility** - Personal overrides via `.claude/settings.local.json`
+- **📊 Visual documentation** - Mermaid workflow diagrams show configuration hierarchy
+- **🛠️ Project templates** - Python, JavaScript, Shell development templates
+
+**Quick Setup:**
+```bash
+pip install vteam-shared-configs
+vteam-config install
+```
+
+**Available Commands:**
+```bash
+vteam-config status      # Show current configuration
+vteam-config update      # Update to latest version
+vteam-config uninstall   # Remove configuration
+```
+
+📚 **Full Documentation:** [Package Documentation](https://pypi.org/project/vteam-shared-configs/)

pyproject.toml

@@ -0,0 +1,57 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "vteam-shared-configs"
+version = "1.0.0"
+description = "Shared Claude Code configuration for vTeam development standards"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.8"
+authors = [
+    {name = "Jeremy Eder", email = "jeremy@example.com"},
+]
+keywords = ["claude", "configuration", "development", "team", "standards"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Software Development :: Quality Assurance",
+]
+dependencies = [
+    "click>=8.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=6.0",
+    "black",
+    "isort",
+    "flake8",
+]
+
+[project.urls]
+Homepage = "https://github.com/jeremyeder/vTeam"
+Repository = "https://github.com/jeremyeder/vTeam"
+Issues = "https://github.com/jeremyeder/vTeam/issues"
+
+[project.scripts]
+vteam-config = "vteam_shared_configs.cli:main"
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "/src",
+    "/README.md",
+    "/LICENSE",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/vteam_shared_configs"]

src/vteam_shared_configs/__init__.py

@@ -0,0 +1,12 @@
+"""vTeam Shared Claude Code Configuration Package.
+
+Provides shared Claude Code configuration for team development standards.
+"""
+
+__version__ = "1.0.0"
+__author__ = "Jeremy Eder"
+__email__ = "jeremy@example.com"
+
+from .installer import ConfigInstaller
+
+__all__ = ["ConfigInstaller"]

src/vteam_shared_configs/cli.py

@@ -0,0 +1,77 @@
+"""Command-line interface for vTeam shared configuration management."""
+
+import click
+from .installer import ConfigInstaller
+
+
+@click.group()
+@click.version_option(version="1.0.0")
+def main():
+    """vTeam Shared Claude Code Configuration Manager.
+
+    Manage shared Claude Code configuration for team development standards.
+    """
+    pass
+
+
+@main.command()
+@click.option('--force', is_flag=True, help='Force reinstallation even if already installed')
+def install(force):
+    """Install vTeam shared Claude Code configuration.
+
+    Sets up symlinks for global configuration and project templates.
+    Automatically backs up existing configuration.
+    """
+    installer = ConfigInstaller()
+
+    if installer.install(force_reinstall=force):
+        click.echo(click.style("✅ vTeam configuration installed successfully!", fg="green"))
+        installer.status()
+    else:
+        click.echo(click.style("❌ Installation failed", fg="red"))
+        exit(1)
+
+
+@main.command()
+def uninstall():
+    """Uninstall vTeam shared Claude Code configuration.
+
+    Removes symlinks and restores backed up configuration if available.
+    """
+    installer = ConfigInstaller()
+
+    if installer.uninstall():
+        click.echo(click.style("✅ vTeam configuration uninstalled successfully!", fg="green"))
+    else:
+        click.echo(click.style("❌ Uninstallation failed", fg="red"))
+        exit(1)
+
+
+@main.command()
+def status():
+    """Show current vTeam configuration status.
+
+    Displays whether configuration is active and properly linked.
+    """
+    installer = ConfigInstaller()
+    installer.status()
+
+
+@main.command()
+def update():
+    """Update to latest vTeam configuration.
+
+    Equivalent to reinstalling with --force flag.
+    """
+    installer = ConfigInstaller()
+
+    if installer.install(force_reinstall=True):
+        click.echo(click.style("✅ vTeam configuration updated successfully!", fg="green"))
+        installer.status()
+    else:
+        click.echo(click.style("❌ Update failed", fg="red"))
+        exit(1)
+
+
+if __name__ == "__main__":
+    main()

src/vteam_shared_configs/data/.claude/settings.json

@@ -0,0 +1,45 @@
+{
+  "hooks": {
+    "preToolUse": [
+      {
+        "name": "enforce-vteam-config",
+        "description": "Ensure latest vTeam shared configuration is active before Git operations",
+        "match": {
+          "tool": "Bash",
+          "command": "git commit*"
+        },
+        "command": "vteam-config install --force"
+      },
+      {
+        "name": "enforce-vteam-config-push",
+        "description": "Ensure latest vTeam shared configuration is active before Git push",
+        "match": {
+          "tool": "Bash", 
+          "command": "git push*"
+        },
+        "command": "vteam-config install --force"
+      }
+    ],
+    "sessionStart": [
+      {
+        "name": "vteam-welcome",
+        "description": "Display vTeam configuration status on session start",
+        "command": "vteam-config status"
+      }
+    ]
+  },
+  "permissions": {
+    "allow": [
+      "Bash(git:*)",
+      "Bash(npm:*)",
+      "Bash(python:*)",
+      "Bash(uv:*)",
+      "Bash(black:*)",
+      "Bash(isort:*)",
+      "Bash(flake8:*)",
+      "Bash(pytest:*)",
+      "Bash(shellcheck:*)",
+      "Bash(markdownlint:*)"
+    ]
+  }
+}