Version Checker Skill

Metadata

• Skill ID: version-checker
• Version: 1.8.0
• Phase: 0 (Pre-workflow)
• Agent: orchestrator
• Invocation: Automatic (triggered on /sdlc-start)
• Model: sonnet (efficient for routine checks)

Purpose

Automatically checks for SDLC Agêntico framework updates, analyzes impact, and manages user approval before executing updates.

Dependencies

System Requirements

• Python 3.11+
• gh CLI (GitHub authentication required)
• git

Python Packages

• PyYAML (already in project)
• Standard library: subprocess, json, pathlib, datetime

Internal Dependencies

• .claude/lib/python/sdlc_logging.py (structured logging)
• .claude/VERSION (current version file)

Scripts

Integration Points

Orchestrator Agent

The orchestrator agent invokes this skill before starting any workflow:

# In orchestrator logic
update_info = check_for_updates()

if update_info["update_available"] and not update_info.get("dismissed"):
    # Present to user via AskUserQuestion
    response = AskUserQuestion([
        {
            "question": "Update available. What would you like to do?",
            "options": [
                {"label": "Update now", "description": "..."},
                {"label": "Show changelog", "description": "..."},
                {"label": "Skip this version", "description": "..."},
                {"label": "Remind me later", "description": "..."}
            ]
        }
    ])

    if response == "Update now":
        execute_update(update_info["latest"])

Hooks

No pre/post hooks required (invoked directly by orchestrator).

State Files

Configuration

No configuration file required. Behavior is hardcoded:

• Cache TTL: 1 hour
• Timeout: 10 seconds (GitHub API), 5 minutes (git operations)
• Rollback: Always attempted on failure

Logging

Skill Label: version-checker Phase Label: 0

Key log events:

• update_check_started
• version_comparison_completed
• github_api_call (with timing)
• update_execution_started
• rollback_triggered

Error Handling

All errors are non-blocking:

• GitHub unreachable → Log warning, return "no update"
• Invalid VERSION → Log error, use fallback
• Update fails → Automatic rollback

Never blocks workflow execution.

Testing

Tests: 88 total across 6 modules Coverage: 90%+ average

Run tests:

pytest .claude/skills/version-checker/tests/ -v

Performance

Security

• Uses gh CLI (authenticated, respects permissions)
• No secrets stored by skill
• Git operations run with user permissions
• Rollback available on all failures

Limitations

• Requires GitHub releases (won't detect unreleased commits)
• Depends on gh CLI authentication
• No support for pre-release versions (alpha/beta)
• Changelog parsing is heuristic (may miss some markers)

Future Enhancements

• Support for pre-release channels (beta, alpha)
• Scheduled update checks (weekly)
• Rollback command (/sdlc-rollback v1.7.0)
• Dependency update detection (Python packages, Node modules)
• Telemetry (track update adoption rates)

Changelog

v1.8.0 (2026-01-22)

• Initial implementation
• Semantic version comparison
• GitHub release fetching with caching
• Impact analysis (breaking changes, migrations, dependencies, security)
• Dismissal tracking
• Automated update execution with rollback
• Comprehensive test suite (88 tests, 90%+ coverage)
• Structured logging integration