agentleFS
bouobbouob/sysadmin-skills/skills/change-request/SKILL.md

change-request

Skill2 starsChanged 6 months agoMITView on GitHub

ITIL change request and CAB review workflow. This skill should be used when the user asks to "create a change request", "write an RFC", "plan a change", "CAB review", "change management", "schedule maintenance", "server migration plan", "upgrade plan", "AI model deployment", "GitOps change", or describes any planned modification to IT infrastructure or services. Produces a complete RFC document following ITIL v5 Change Enablement.

6 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

7 rules. 0 are common, 6 are distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 6 edited versions we read keep these.

  • 6

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Default output directory: ./changes/.

    line 36
  2. Distinctive:

    All change request documents are written in English.

    line 38
  3. Distinctive:

    MUST include the risk assessment table in the RFC with this exact format.

    line 98
  4. Distinctive:

    Create the change request file.

    line 114
  5. Distinctive:

    Verify all required sections are complete:

    line 221
  6. Distinctive:

    Always ask about blackout windows — some organizations have change freezes around releases, holidays, or fiscal close

    line 238
  7. Distinctive:

    If the change was triggered by an incident, link the incident ID

    line 240

“Common” is measured: kept by at least 6 in 10 of the 6 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Change Request Workflow

Structured change management following ITIL 4 Change Enablement. Produces a complete RFC (Request for Change) document that serves as both the change plan and the CAB review submission.

Related Skills (auto-loaded)

  • itil — change types (Standard/Normal/Emergency), CAB process, risk assessment matrix
  • done-ops — verification gate before finalizing the change

Output

File: {OUTPUT_DIR}/change-request-{YYYY-MM-DD}-{slug}.md

  • slug: lowercase kebab-case summary, e.g. exchange-upgrade, ad-entra-migration
  • Change ID (CHG-{YYYYMMDD}-{NNN}): {NNN} is a daily sequence number starting at 001. If the organization uses a ticketing system, use that system's ID instead.

Default output directory: ./changes/. If a docs/changes/ directory exists in the project, use that instead. Ask the user if neither exists. A user-specified path takes precedence over all defaults.

All change request documents are written in English. Before writing to file, preview the content for the user in their preferred language.


Workflow

Step 1: Gather Change Details

Collect the following from the user (use AskUserQuestion for missing items):

FieldRequiredExample
What is being changed?Yes"Upgrade Exchange Server 2019 to 2022"
Why is this change needed?Yes"End of support, security compliance"
Which systems/services affected?Yes"Email service, Active Directory"
Expected downtime?Yes"4-hour maintenance window"
Proposed schedule?Yes"Saturday 02:00-06:00"
Who will implement?Yes"IT Infrastructure team"

Step 2: Classify the Change

Determine the change type using the itil skill:

QuestionStandardNormalEmergency
Is this a routine, pre-approved procedure?Yes → StandardNoNo
Is there a documented SOP for this?Yes → StandardMaybeNo
Is this time-critical (active incident)?NoNoYes → Emergency
Otherwise—→ Normal—

Clarification: Compliance deadlines or business mandates with hard dates are Normal changes (with appropriate urgency), not Emergency. Emergency is reserved for active incidents or immediate security threats requiring same-day implementation.

AI / ML System Changes: If the change involves any AI or ML component (model update, prompt change, training data, RAG index, AI autonomy scope), load itil/references/change-enablement.md and follow the "AI / ML System Changes" section. Changes involving Cognition or Coordination capabilities require Normal (Significant) classification at minimum.

GitOps / IaC Changes: Changes delivered via pull request and automated pipeline may qualify as Standard if they meet pre-authorization criteria. See itil/references/change-enablement.md → "GitOps / IaC Change Pattern".

For Normal changes, further classify risk level:

  • Minor: Low risk, Change Manager approval sufficient
  • Significant/Major: Requires full CAB review

Step 3: Risk Assessment

Rate each dimension 1-3, multiply for Risk Score:

Impact (if change fails):

  • 3 = High: critical service outage, data loss risk
  • 2 = Medium: degraded service, limited users affected
  • 1 = Low: minimal/no user impact

Likelihood (of failure):

  • 3 = High: untested procedure, complex dependencies
  • 2 = Medium: tested in non-prod, moderate complexity
  • 1 = Low: routine procedure, well-documented, previously successful
Risk ScoreLevelAuthorization
7-9HighFull CAB + management approval
4-6MediumCAB review recommended
1-3LowChange Manager approval

MUST include the risk assessment table in the RFC with this exact format.

Sustainability note: If the change involves significant compute (AI model deployment, server provisioning >10 units, cloud region migration), add the optional Sustainability assessment from itil/references/sustainability.md to the Risk Assessment section.

| Dimension | Rating | Justification |
|---|---|---|
| Impact (if failure) | {1-3} | {Reason} |
| Likelihood (of failure) | {1-3} | {Reason} |
| **Risk Score** | **{N}** | **{Low/Medium/High}** |

Present the assessment to the user for validation.

Step 4: Build the RFC Document

Create the change request file. MUST follow this exact structure — do not rearrange or rename sections:

# Request for Change: {TITLE}

| Field | Value |
|---|---|
| Change ID | CHG-{YYYYMMDD}-{NNN} |
| Change Type | Standard / Normal / Emergency |
| Risk Level | {Low / Medium / High} (Score: {N}) |
| Status | Draft |
| Requester | {NAME} |
| Date Submitted | {YYYY-MM-DD} |
| Proposed Window | {DATE TIME} to {DATE TIME} ({TIMEZONE}) |

## Business Justification

{Why this change is needed. What problem it solves. What happens if not implemented.}

## Scope and Impact

### Systems Affected
{List of systems, services, and configuration items.}

### Users Affected
{Who will experience downtime or changes. Estimated number.}

### Dependencies
{Other systems, teams, or changes this depends on.}

## Risk Assessment

| Dimension | Rating | Justification |
|---|---|---|
| Impact (if failure) | {1-3} | {Reason} |
| Likelihood (of failure) | {1-3} | {Reason} |
| **Risk Score** | **{N}** | **{Low/Medium/High}** |

### Risk Mitigation
{Steps to reduce risk — e.g., tested in staging, phased rollout.}

## Implementation Plan

### Pre-Implementation
| Step | Action | Owner | Est. Duration |
|---|---|---|---|
| 1 | {Pre-check or preparation} | {Name} | {Time} |

### Implementation
| Step | Action | Owner | Est. Duration |
|---|---|---|---|
| 1 | {Step description} | {Name} | {Time} |

### Post-Implementation
| Step | Action | Owner | Est. Duration |
|---|---|---|---|
| 1 | {Verification step} | {Name} | {Time} |

## Test / Validation Plan

| Check | Expected Result | Method |
|---|---|---|
| {What to verify} | {Expected outcome} | {How to check} |

## Rollback Plan

**Trigger criteria:** {When to initiate rollback — specific, measurable conditions.}

**Estimated rollback time:** {Duration}

| Step | Action | Owner | Est. Duration |
|---|---|---|---|
| 1 | {Rollback step} | {Name} | {Time} |

## Communication Plan

| When | Audience | Channel | Message |
|---|---|---|---|
| Before change | {Who} | {Email/Teams/Statuspage} | Maintenance notification |
| During (if issues) | {Who} | {Channel} | Status update |
| After completion | {Who} | {Channel} | Completion confirmation |

## Approvals

| Role | Name | Decision | Date |
|---|---|---|---|
| Change Manager | | | |
| CAB | | | |
| Technical Lead | | | |

## Related Records

{Linked incidents, problems, or previous changes.}

Step 5: CAB Review Preparation

For Normal (Major) and Emergency changes, prepare the CAB review summary:

  1. Load the CAB Review Checklist from itil skill (references/change-enablement.md)
  2. Self-evaluate the RFC against each checklist item
  3. Flag any items that are incomplete or need discussion
  4. Present the checklist evaluation to the user

Step 6: Finalize

  1. Load done-ops verification gate
  2. Verify all required sections are complete:
    • Business justification is clear
    • Implementation plan has specific steps with owners
    • Rollback plan has trigger criteria and tested procedure
    • Communication plan identifies all audiences
    • Risk assessment is realistic
  3. Present the final RFC for user review
  4. Note the authorization path: who needs to approve this change

Gotchas

  • The RFC is the single document for the entire change lifecycle — plan, approval, implementation, and review all reference this document
  • Phased changes (e.g., multi-weekend migrations): use separate Implementation Plan tables per phase, add phase gate criteria (go/no-go between phases), and note all proposed windows in the Schedule section
  • Standard changes do not need individual CAB review, but the standard change catalog should be referenced
  • Emergency changes still need an abbreviated RFC before implementation, with a full RFC completed within 48 hours
  • Always ask about blackout windows — some organizations have change freezes around releases, holidays, or fiscal close
  • Rollback plan must have specific trigger criteria, not just "if something goes wrong"
  • If the change was triggered by an incident, link the incident ID
  • Post-Implementation Review (PIR) is mandatory for Emergency changes (48h) and recommended for all Normal changes (5 business days)

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.