gh-aojdevstudio-dev-utils-marketplace-documentation/commands/update-claude.md

allowed-tools, description, argument-hint, flags, model

allowed-tools	description	argument-hint	flags	model
Bash(git diff:*), Bash(git log:*), Bash(git status:*), Bash(find:*), Bash(grep:*), Bash(wc:*), Bash(ls:*), mcp__serena__*	Update CLAUDE.md using Serena-first analysis of recent code changes	--directory target-dir	--directory Create/update CLAUDE.md for a specific directory instead of project root	claude-sonnet-4-5-20250929

Update Claude.md

Use Serena-first analysis to update CLAUDE.md based on recent code changes and git history.

Variables

TARGET_DIRECTORY: {{if flags.directory}}{{flags.directory}}{{else}}.{{endif}} CLAUDE_FILE: {{if flags.directory}}{{flags.directory}}/CLAUDE.md{{else}}CLAUDE.md{{endif}} ANALYSIS_SCOPE: {{if flags.directory}}directory-specific{{else}}project-wide{{endif}}

Workflow

1. Initial Setup

• Check Serena onboarding: mcp__serena__check_onboarding_performed
• If not onboarded, complete onboarding process first
• Use mcp__serena__think_about_task_adherence to validate update scope

2. Git Analysis

• Get current status: !git status --porcelain
• Review recent commits: !git log --oneline -10
• Analyze changed files: !git diff HEAD~5 --name-only | head -20
• Check key file modifications: !git diff --name-status HEAD~10 | grep "^M" | head -10
• Store git insights: mcp__serena__write_memory --memory_name="git_analysis"

3. Serena Codebase Analysis

• Analyze directory structure: mcp__serena__list_dir --relative_path="TARGET_DIRECTORY" --recursive=true
• For each modified file from git analysis:
  • Get symbol overview: mcp__serena__get_symbols_overview --relative_path="<FILE>"
  • Find new symbols: mcp__serena__find_symbol --name_path="<NEW_SYMBOLS>"
  • Check symbol impact: mcp__serena__find_referencing_symbols --name_path="<KEY_SYMBOLS>"
• Store symbol analysis: mcp__serena__write_memory --memory_name="symbol_changes"

4. Content Integration

• Read existing CLAUDE.md file: @CLAUDE_FILE
• Use mcp__serena__think_about_collected_information to validate analysis
• Update CLAUDE.md based on @ai-docs/serena-enhanced-claude-template.md:
  • Project overview with new architecture patterns
• Save updated CLAUDE.md to CLAUDE_FILE location

5. Validation

• Use mcp__serena__think_about_whether_you_are_done to verify completeness
• Store update insights: mcp__serena__write_memory --memory_name="claude_update_ANALYSIS_SCOPE"

Report

CLAUDE.md Update Complete

File: CLAUDE_FILE Analysis Scope: ANALYSIS_SCOPE Key Updates:

• Symbol-level changes documented in serena memory
• Architecture patterns updated
• Development workflow enhanced
• Integration points clarified Memory Stored: claude_update_ANALYSIS_SCOPE

Template Reference

Use the comprehensive template from: @ai-docs/serena-enhanced-claude-template.md

Template Selection Logic

{{if flags.directory}}

• Apply directory-specific template sections from the referenced file
• Focus on symbol-based architecture and development workflow patterns {{else}}
• Apply full project root template structure from the referenced file
• Include all Serena-first development patterns and core command references {{endif}}