mirror of https://github.com/alirezarezvani/ClaudeForge.git synced 2026-07-03 02:13:15 -04:00

Files

T

Reza Rezvani 35d17b0ba3 feat(v2.0.0): migrate to Claude Code v2.1.4+ architecture

Major architectural update to support Claude Code v2.1.4+ features including
hooks, modern permission syntax, and hot-reload capabilities.

## Core Component Updates

### Skill (skill/SKILL.md)
- Updated frontmatter from old `tools:` to `permissions.allow:` array
- Added wildcard Bash permissions: Bash(ls:*), Bash(find:*), Bash(git:*)
- Python modules unchanged (backward compatible)

### Command (command/enhance-claude-md.md)
- Updated frontmatter from `allowed-tools:` to `permissions.allow:` array
- Added startup hook for workflow initiation
- 3-phase discovery workflow unchanged

### Guardian Agent (agent/claude-md-guardian.md)
- Updated frontmatter from `tools:` to `permissions.allow:` array
- Added SessionStart hook for auto-updates on new sessions
- Added PreToolUse/PostToolUse hooks for Write validation
- Added fork_safe: true for independent operation
- Removed obsolete mcp_tools field
- Agent workflow logic unchanged

## Installation Scripts

### install.sh
- Added Claude Code version detection (checks for 2.1.0+)
- Added auto-migration logic with timestamped backups
- Added post-installation v2.1.4 compatibility validation
- Updated version to 2.0.0
- Updated download URLs to main branch

### install.ps1
- Added equivalent PowerShell version detection
- Added auto-migration logic with timestamped backups
- Added post-installation v2.1.4 compatibility validation
- Updated version to 2.0.0
- Updated download URLs to main branch

## Documentation

### New Files
- docs/MIGRATION_V2.md: Comprehensive migration guide
- test/validate_migration.sh: Validation script (18 tests)
- test/rollback.sh: Rollback script for v1.x restoration
- test/README.md: Testing documentation

### Updated Files
- README.md: Updated version badges (2.0.0, Claude Code 2.1.4+)
- README.md: Added "New in v2.0" section highlighting features
- CHANGELOG.md: Added comprehensive v2.0.0 release entry
- CHANGELOG.md: Documented all changes, fixes, and breaking changes

## Validation

All changes validated:
✓ Python modules compile without errors
✓ install.sh bash syntax valid
✓ YAML frontmatter syntax valid (skill, command, agent)
✓ No Python code modified (2,190 lines unchanged)
✓ Backward compatible with existing installations

## Breaking Changes

- Minimum Claude Code version: 2.1.0+ (was 2.0+)
- Old permission syntax deprecated (but backward compatible)
- Users on Claude Code < 2.1.0 should use ClaudeForge v1.0.0

## Migration Path

Installer automatically:
1. Detects Claude Code version
2. Backs up v1.x installations
3. Installs v2.0 with new syntax
4. Validates compatibility

See docs/MIGRATION_V2.md for detailed instructions.

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

Co-Authored-By: Claude Sonnet 4.5 (1M context) <noreply@anthropic.com>

2026-01-13 13:26:46 +01:00

4.0 KiB

Raw Blame History

description, permissions, hooks

description

permissions

hooks

Initialize or enhance CLAUDE.md files using the claude-md-enhancer skill with interactive workflow and 100% native format compliance

allow

Bash(ls:*)

Bash(find:*)

Bash(git status:*)

Read

Glob

Skill

matcher

once

commands

true

echo "Starting CLAUDE.md enhancement workflow"

CLAUDE.md Enhancer Command

This command uses the claude-md-enhancer skill to initialize or enhance CLAUDE.md files for your project.

Phase 1: Discovery - Check Current State

Check if CLAUDE.md exists

!ls -la CLAUDE.md 2>/dev/null || echo "CLAUDE.md not found"

Check for modular CLAUDE.md files

!find . -name "CLAUDE.md" -type f -not -path "./node_modules/*" -not -path "./.git/*" | head -10

Get repository status

!git status --short 2>/dev/null || echo "Not a git repository"

Check project structure

!ls -la

Phase 2: Analysis - Determine Action

Based on the discovery above, I need to determine the appropriate action:

If CLAUDE.md does NOT exist → Interactive Initialization Workflow If CLAUDE.md exists → Analysis and Enhancement Workflow

For New Projects (No CLAUDE.md):

The claude-md-enhancer skill will:

Explore your repository structure
Detect project type, tech stack, team size, development phase
Show you the discoveries and ask for confirmation
Create customized CLAUDE.md file(s) after your approval
Apply 100% native format compliance (project structure diagrams, setup instructions, architecture sections)

For Existing Projects (CLAUDE.md exists):

The claude-md-enhancer skill will:

Analyze current CLAUDE.md for quality and completeness
Calculate quality score (0-100)
Identify missing sections
Provide actionable recommendations
Offer to enhance with missing native format sections

Phase 3: Task - Execute with Skill or Agent

Option A: Direct Skill Invocation

I can invoke the claude-md-enhancer skill directly to handle the appropriate workflow based on what I discovered above.

The skill provides:

✨ 100% Native Format Compliance: All generated files follow official Claude Code format with project structure diagrams, setup instructions, architecture sections, and file structure explanations
🆕 Interactive Initialization: For new projects, explores repository and asks for confirmation before creating files
✅ Intelligent Analysis: For existing projects, scans and evaluates for quality and completeness
🚀 Smart Generation: Creates customized CLAUDE.md files from scratch
🔧 Enhancement: Adds missing sections and improves existing files
📦 Modular Architecture: Supports context-specific files (backend/, frontend/, database/)

Option B: Agent Invocation (Recommended for Maintenance)

For ongoing maintenance and automatic updates throughout your project lifecycle, I can invoke the claude-md-guardian agent instead:

When to use the agent:

After feature completion
After major refactoring
When new dependencies are added
After architecture changes
For periodic CLAUDE.md synchronization

Agent benefits:

🔄 Auto-Sync: Updates CLAUDE.md based on detected changes
🎯 Smart Detection: Only updates when significant changes occur
⚡ Token-Efficient: Uses haiku model for routine updates
📦 Milestone-Aware: Triggers after completion signals
✨ Native Format: Ensures 100% Claude Code format compliance

Your Task

I'm ready to proceed. What would you like me to do?

For new projects: I'll run the interactive initialization workflow (skill) For existing projects: I'll analyze your current CLAUDE.md and suggest improvements (skill) For maintenance: I'll invoke claude-md-guardian agent to check for updates and synchronize

Please confirm how you'd like to proceed, or let me know if you have specific requirements (e.g., "Create a CLAUDE.md for my Python FastAPI project" or "Invoke claude-md-guardian to update my CLAUDE.md").

4.0 KiB Raw Blame History