auto-updater

auto-updater automatically applies improvements to skills and ecosystem components based on identified patterns and learnings.

Purpose: Automated application of validated improvements across ecosystem

The 5-Step Auto-Update Workflow:

1. Identify Improvements - Gather recommendations from reviews and learnings
2. Assess Safety - Determine which can be safely automated
3. Apply Updates - Implement improvements automatically
4. Validate Changes - Ensure improvements effective, no regressions
5. Rollback if Needed - Revert changes if validation fails

Safety: Always validates before finalizing, can rollback

• Applying systematic improvements across multiple skills
• Implementing guideline updates ecosystem-wide
• Automating common enhancement patterns
• Bulk updates (e.g., add Quick Reference to all skills missing it)

Step 1: Identify Improvements

Sources:

• system-reviewer recommendations
• best-practices-learner documented patterns
• review-multi common findings
• Manual improvement requests

Output: List of potential improvements

Time: 15-30 minutes

---

Step 2: Assess Safety

Safe to Automate:

• Structural additions (add Quick Reference section)
• Content additions (add examples in standard locations)
• Format standardization (consistent heading levels)
• Documentation updates (README enhancements)

NOT Safe to Automate:

• Logic changes (requires understanding context)
• Content rewrites (needs judgment)
• Major refactoring (risk too high)
• Custom implementations

Output: Classified improvements (auto-safe vs manual-only)

Time: 20-40 minutes

---

Step 3: Apply Updates

Process:

1. Backup affected skills (git commit or copy)
2. Apply improvement to each skill
3. Log changes made
4. Track success/failure per skill

Approach: One skill at a time, validate each before moving to next

Time: Varies by improvement and skill count

---

Step 4: Validate Changes

For Each Updated Skill:

1. Run skill-validator (pass/fail)
2. Run review-multi structure check (score maintained?)
3. Visual inspection (looks correct?)
4. Mark as validated or flagged for review

Output: Validation results per skill

Time: 10-15 minutes per skill

---

Step 5: Rollback if Needed

If Validation Fails:

1. Identify which skill failed
2. Restore from backup (git revert or copy back)
3. Analyze why it failed
4. Mark improvement as manual-only for that skill

Output: Rolled back skill, failure analysis

---

```

Auto-Update: Add Quick Reference to All Skills Missing It

Step 1: Identify

• Improvements: Add Quick Reference section
• Target Skills: planning-architect, task-development, todo-management
• Count: 3 skills to update

Step 2: Assess Safety

• ✅ Safe: Adding new section (doesn't modify existing content)
• ✅ Safe: Standard format (use template)
• ✅ Safe: Low risk (can validate easily)
• Decision: Auto-update approved

Step 3: Apply

• Backup: Git commit all 3 skills
• Apply to planning-architect: ✅ Success
• Apply to task-development: ✅ Success
• Apply to todo-management: ✅ Success
• Changes: 3/3 skills updated

Step 4: Validate

• planning-architect: 5/5 structure (maintained)
• task-development: 5/5 structure (maintained)
• todo-management: 5/5 structure (maintained)
• All validations: ✅ PASS

Step 5: Rollback

• Not needed (all validations passed)

Result: ✅ 3 skills successfully auto-updated

Time: 90 minutes (vs 3-4 hours manual)

Impact: 100% Quick Reference coverage achieved

Quality: All skills maintained 5/5 scores

```

---

5-Step Auto-Update Workflow

| Step | Focus | Time | Safety |

|------|-------|------|--------|

| Identify | Gather improvements | 15-30m | N/A |

| Assess Safety | Classify auto-safe | 20-40m | Critical |

| Apply | Implement changes | Varies | Backup first |

| Validate | Check quality maintained | 10-15m/skill | Essential |

| Rollback | Revert if fails | 5m/skill | Safety net |

Safe vs Unsafe Automation

Safe to Automate:

• Adding standard sections
• Format standardization
• Documentation additions
• Structural improvements (following patterns)

NOT Safe:

• Logic changes
• Content rewrites
• Major refactoring
• Custom implementations

Rule: If requires judgment or understanding → Manual only

---

auto-updater enables safe, validated, automated improvement application across multiple skills simultaneously.