wrangler:startup-checklist

Startup Checklist Skill

Skill Usage Announcement

MANDATORY: When using this skill, announce it at the start with:

🔧 Using Skill: wrangler:startup-checklist | [brief purpose based on context]

Example:

🔧 Using Skill: wrangler:startup-checklist | [Provide context-specific example of what you're doing]

This creates an audit trail showing which skills were applied during the session.

Purpose

Run automatically on session start to ensure project is using current wrangler version. Detects breaking changes and provides clear upgrade path.

When to Use

This skill runs automatically via session hooks. DO NOT manually invoke unless debugging version detection.

Auto-execution: Triggered by hooks/session-start.sh after workspace initialization.

Workflow

Phase 1: Read Project Version

Goal: Determine which version of wrangler the project is currently using.

1. Locate Constitution File

   Check locations in priority order:

   # Priority 1: New location (v1.1.0+)
   if [ -f ".wrangler/governance/CONSTITUTION.md" ]; then
     PROJECT_CONSTITUTION=".wrangler/governance/CONSTITUTION.md"
   
   # Priority 2: Legacy location (v1.0.0)
   elif [ -f "specifications/_CONSTITUTION.md" ]; then
     PROJECT_CONSTITUTION="specifications/_CONSTITUTION.md"
   
   # No constitution found
   else
     echo "⚠️ No constitution found. Initialize governance first."
     echo "   Run: /wrangler:initialize-governance"
     exit with WARN status
   fi
   

2. Extract Version from Frontmatter

   Read YAML frontmatter and extract wranglerVersion field:

   ---
   wranglerVersion: "1.1.0"
   lastUpdated: "2025-11-18"
   ---
   

   Fallback behavior:

   • If wranglerVersion field missing → Assume v1.0.0 (pre-versioning era)
   • If frontmatter entirely missing → Assume v1.0.0
   • If file exists but is empty → WARN and exit

3. Validate Version Format

   Ensure version follows semantic versioning (e.g., "1.1.0", "2.0.0"):

   • Pattern: MAJOR.MINOR.PATCH
   • Valid: "1.0.0", "1.1.0", "2.0.0"
   • Invalid: "1", "1.1", "v1.0.0", "latest"