Skip to content

Conversation

@jeremyeder
Copy link
Collaborator

Summary

Add comprehensive shared Claude Code configuration for vTeam with automatic enforcement via hooks system.

Key Features

  • 🔄 Automatic enforcement - Pre-commit hooks ensure latest team config on every Git operation
  • ⚙️ Developer flexibility - Full override capability via .claude/settings.local.json
  • 📊 Visual documentation - Mermaid workflow diagrams show configuration hierarchy
  • 🎯 Zero maintenance - Hook-based system keeps configuration current automatically
  • 🛠️ Complete templates - Python, JavaScript, Shell project templates included

What's Added

Configuration Management

  • .claude/settings.json - Team hooks and enforcement rules
  • hooks/enforce-config.sh - Pre-commit configuration validation
  • hooks/status-check.sh - Session start status display
  • Automatic symlink management for global config and templates

Documentation & Diagrams

  • Mermaid workflow diagrams showing configuration hierarchy
  • Developer workflow sequence from setup to daily use
  • File structure visualization with symlink relationships
  • Comprehensive troubleshooting guides

Team Standards

  • Global team configuration via claude/global-CLAUDE.md
  • Project templates for Python, JavaScript, Shell development
  • Dependency management via dependabot
  • Git workflow and code quality standards

Configuration Hierarchy

flowchart TD
    A[Developer Action] --> B{Claude Settings Hierarchy}
    B --> C[".claude/settings.local.json<br/>🏆 HIGHEST PRIORITY<br/>Personal overrides"]
    B --> D[".claude/settings.json<br/>📋 TEAM STANDARDS<br/>vTeam shared config"]
    B --> E["~/.claude/settings.json<br/>⚙️ PERSONAL DEFAULTS<br/>Global user settings"]
    C --> F[Final Configuration]
    D --> F
    E --> F
Loading

Team Benefits

  • Consistent development standards across all projects
  • Automatic updates when team standards evolve
  • Developer autonomy with clear override boundaries
  • Visual workflow understanding via Mermaid diagrams
  • Zero configuration drift through hook enforcement

Test Plan

  • Hook configuration loads correctly in Claude Code
  • Enforcement script creates proper symlinks
  • Status check displays accurate configuration state
  • Mermaid diagrams render properly in GitHub
  • Documentation provides clear setup instructions
  • Developer override examples work as documented

Installation for Team

# Copy team hooks to personal Claude configuration
cp vTeam/shared-configs/.claude/settings.json ~/.claude/settings.json

# Configuration automatically enforced on first Git operation
# All team standards active immediately

🤖 Generated with Claude Code

@jeremyeder jeremyeder force-pushed the feature/add-shared-configs branch from 779491c to 9f158d7 Compare August 13, 2025 05:05
- Add hook-based automatic configuration management via .claude/settings.json
- Add pre-commit enforcement script ensuring latest team configs are active
- Add session start status check displaying current configuration state
- Add comprehensive Mermaid workflow diagrams for developer understanding
- Add hierarchical configuration support with developer override flexibility
- Add global team standards and language-specific project templates
- Add automated dependency management via dependabot
- Add comprehensive documentation with visual workflow guides
- Update main README.md with shared-configs overview and quick setup

Key Features:
- ✅ Zero-maintenance automatic configuration enforcement
- ✅ Developer customization via .claude/settings.local.json
- ✅ Visual workflow documentation with Mermaid diagrams
- ✅ Symlink-based template and configuration management
- ✅ Git hooks ensure team standards on every commit/push

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

Co-Authored-By: Claude <noreply@anthropic.com>
@jeremyeder jeremyeder force-pushed the feature/add-shared-configs branch from 9f158d7 to 2a40ce5 Compare August 13, 2025 05:08
@jeremyeder jeremyeder self-assigned this Aug 13, 2025
}
]
},
"permissions": {
Copy link
Collaborator Author

Choose a reason for hiding this comment

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

arguable whether this is preference...

- Add pyproject.toml with modern Python packaging configuration
- Create vteam-shared-configs package with CLI interface
- Add vteam-config command with install/uninstall/status/update subcommands
- Implement ConfigInstaller class with symlink management and backup functionality
- Move shared-configs content to package data directory
- Update all documentation for pip install workflow
- Add comprehensive error handling and user-friendly status display
- Include MIT license for PyPI distribution

Installation now simplified to:
```bash
pip install vteam-shared-configs
vteam-config install
```

Available commands:
- vteam-config install    # Set up team configuration
- vteam-config status     # Show current status
- vteam-config update     # Update to latest
- vteam-config uninstall  # Remove configuration

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

Co-Authored-By: Claude <noreply@anthropic.com>
@jeremyeder jeremyeder force-pushed the feature/add-shared-configs branch from 5b4ecb7 to 4ec37cb Compare August 13, 2025 05:20
- Remove obsolete vTeam/shared-configs directory entirely
- Add missing .claude/settings.json to package data with CLI commands
- Update all documentation references to use pip install approach
- Fix sequence diagrams to show PyPI installation workflow
- Update hooks configuration to use vteam-config CLI commands
- Ensure single source of truth for all installation instructions
- Remove all references to old directory-based installation

All documentation now consistently uses:
```bash
pip install vteam-shared-configs
vteam-config install
```

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

Co-Authored-By: Claude <noreply@anthropic.com>
vteam-config install
```

**Available Commands:**
Copy link
Collaborator Author

Choose a reason for hiding this comment

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

something like this might be workable.

Copy link
Collaborator Author

@jeremyeder jeremyeder left a comment

Choose a reason for hiding this comment

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

good enough

@jeremyeder jeremyeder merged commit 805467a into main Aug 13, 2025
jeremyeder pushed a commit that referenced this pull request Sep 9, 2025
sallyom pushed a commit that referenced this pull request Oct 15, 2025
Add vTeam shared Claude Code configuration with hooks-based enforcement
sallyom pushed a commit that referenced this pull request Oct 15, 2025
@github-actions github-actions bot mentioned this pull request Oct 29, 2025
@github-actions github-actions bot mentioned this pull request Nov 8, 2025
@github-actions github-actions bot mentioned this pull request Nov 20, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants