ITIL Framework Activation Summary

Activated: 2026-06-21
Status: ✅ Operational


What Was Activated

1. Automated Metrics Collection

Status: ✅ Active
Schedule: Weekly (every Monday at 09:00 UTC)
Systemd Timer: itil-metrics-weekly.timer

Collects 6 Critical Success Factors:

  • Value Delivery (euphoric surprise ≥8/10)
  • Quality (ISC pass rate ≥95%)
  • Learning Capture (≥1 feedback memory per failed ISC)
  • Efficiency (Ollama routing ≥60%)
  • Reliability (uptime ≥99.9%)
  • Security (blocked ops compliance 100%)

Data: ~/.claude/PAI/MEMORY/STATE.claude/itil-metrics.jsonl


2. Monthly Improvement Review

Status: ✅ Active
Schedule: Monthly (1st of each month at 09:00 UTC)
Systemd Timer: itil-review-monthly.timer
First Run: 2026-07-01

Generates automated review with:

  • Metric trends (week-over-week, month-over-month)
  • Practice maturity gaps
  • Prioritized improvement recommendations
  • Action items

Output: ~/.claude/PAI/MEMORY/STATE.claude/itil-monthly-review-YYYY-MM.md


3. ITIL Dashboard

Status: ✅ Active
Command: /itil

Visual dashboard showing:

  • 6 CSFs with pass/fail indicators
  • Top 5 weakest practices with maturity scores
  • Last updated timestamp

Subcommands:

/itil            # Show dashboard
/itil metrics    # Run metrics collection now
/itil maturity   # Run practice maturity assessment now
/itil review     # Generate monthly review now

4. Documentation & Tools

Status: ✅ Installed

Documentation:

  • ITIL_FRAMEWORK.md - Complete framework (31KB, 7 principles, 20 practices)
  • ITIL_IMPLEMENTATION_GUIDE.md - Daily/weekly/monthly operations
  • ITIL_QUICK_REFERENCE.md - Cheat sheet for common tasks

Tools:

  • ITILMetricsCollector.ts - Collects 6 KPIs
  • ITILMonthlyReview.ts - Generates improvement recommendations
  • PracticeMaturity.ts - Scores 20 practices on 0-5 scale
  • GenerateServiceCatalog.ts - Documents skills/agents/APIs
  • ProblemMetrics.ts - Tracks hook violations
  • DashboardITILPanel.tsx - React component (ready for future UI integration)

Hooks:

  • ITILDashboard.hook.ts - /itil command handler

How to Use Daily

Check Status

/itil

After Completing Work

The systemd timers run automatically. No manual intervention required unless you want immediate feedback:

/itil metrics    # Refresh metrics now
/itil maturity   # Check practice gaps now

Monthly Review (Automated)

On the 1st of each month at 09:00 UTC, the system automatically:

  1. Analyzes metric trends
  2. Identifies practice gaps
  3. Generates prioritized recommendations
  4. Creates action items

Review the output at: ~/.claude/PAI/MEMORY/STATE.claude/itil-monthly-review-YYYY-MM.md


Current Baseline (2026-06-21)

Critical Success Factors

  • ❌ Value Delivery: 0.0 (target: ≥8/10)
  • ❌ Quality: 48.4% (target: ≥95%)
  • ❌ Learning Capture: 0.0 (target: ≥1 per fail)
  • ❌ Efficiency: 0.0 (target: ≥60%)
  • ❌ Reliability: 0.0 (target: ≥99.9%)
  • ✅ Security: 100% (target: 100%)

Weakest Practices (0/5)

  1. Problem Detection & Response
  2. Root Cause Analysis & Prevention
  3. Capability Registry
  4. State Tracking
  5. Learning Capture & Retrieval

What’s Next

Immediate (Week 1)

  • Automated metrics collection runs Monday 2026-06-22 at 09:00 UTC
  • Baseline data accumulates weekly

Short-term (Month 1)

  • First monthly review generates 2026-07-01 at 09:00 UTC
  • Implement top recommended improvement (likely Problem Detection)

Long-term (Quarters 2-4 2026)

  • Track CSF trend improvements
  • Iterate on weakest practices
  • Aim for ≥3/5 maturity across all practices

Algorithm Template Enhancement (Deferred)

Status: ⏸️ Documented, Not Applied

The following enhancements were documented but NOT applied to Algorithm v5.7.11:

  1. Guiding principle auto-detection in OBSERVE phase
  2. Learning capture check in REFLECT phase

Reason: Algorithm is at v5.7.11 (not v5.7.3 as patch targets). Changes are invasive to mature template.

Proposal: Create v5.7.12 with ITIL enhancements if desired.

Location: ~/.opencode/PAI/Algorithm/ITIL_INTEGRATION_PATCH.md (reference only)


Troubleshooting

Timers Not Running

systemctl --user list-timers itil-*

Should show two timers with NEXT run times. If not:

systemctl --user daemon-reload
systemctl --user enable itil-metrics-weekly.timer
systemctl --user enable itil-review-monthly.timer
systemctl --user start itil-metrics-weekly.timer
systemctl --user start itil-review-monthly.timer

Dashboard Not Showing Data

Check if metrics/maturity files exist:

ls -lh ~/.claude/PAI/MEMORY/STATE.claude/itil-*

If missing, run:

/itil metrics
/itil maturity

Manual Systemd Service Execution

systemctl --user start itil-metrics-weekly.service
systemctl --user start itil-review-monthly.service

Files & Locations

Configuration

  • ~/.config/systemd/user/itil-metrics-weekly.{service,timer}
  • ~/.config/systemd/user/itil-review-monthly.{service,timer}

Data

  • ~/.claude/PAI/MEMORY/STATE.claude/itil-metrics.jsonl (time-series)
  • ~/.claude/PAI/MEMORY/STATE.claude/practice-maturity.json (latest)
  • ~/.claude/PAI/MEMORY/STATE.claude/itil-monthly-review-*.md (monthly)
  • ~/.claude/PAI/MEMORY/STATE.claude/problem-metrics.jsonl (hook violations)

Code

  • ~/.claude/PAI/Tools/{ITIL,Practice,Generate,Problem}*.ts (6 tools)
  • ~/.claude/hooks/ITILDashboard.hook.ts (dashboard command)

Documentation

  • ~/.claude/PAI/DOCUMENTATION/ITIL_FRAMEWORK.md
  • ~/.claude/PAI/DOCUMENTATION/ITIL_IMPLEMENTATION_GUIDE.md
  • ~/.claude/PAI/DOCUMENTATION/ITIL_QUICK_REFERENCE.md
  • ~/.claude/PAI/DOCUMENTATION/ITIL_ACTIVATION_SUMMARY.md (this file)

Framework Version: ITIL v4 (PAI Adaptation)
Activated By: PNK (OpenCode)
Activated For: PNC (Claude Code / pai-primary)
Integration Status: Full (timers, dashboard, tools, docs)