@windyroad/itil 3.0.0 → 3.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -486,5 +486,5 @@
486
486
  }
487
487
  },
488
488
  "name": "wr-itil",
489
- "version": "3.0.0"
489
+ "version": "3.0.1"
490
490
  }
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "wr-itil",
3
- "version": "3.0.0",
3
+ "version": "3.0.1",
4
4
  "description": "ITIL problem-management workflows for AI coding agents",
5
5
  "author": {
6
6
  "name": "Windy Road Technology",
package/README.md CHANGED
@@ -17,7 +17,7 @@ Bugs recur. Incidents repeat. Without a disciplined process, you fix symptoms in
17
17
 
18
18
  **Incident management** — restore service fast with an audit trail:
19
19
 
20
- - **Declare incidents** when production is actively broken
20
+ - **Declare incidents** when an existing service is interrupted or degrades from an established prior working baseline. Track missing, incomplete or initially deficient features as problems; an unknown baseline calls for problem investigation.
21
21
  - **Evidence-first discipline** — hypotheses must cite evidence before any mitigation
22
22
  - **Reversible mitigations first** — rollback, feature flag, restart, route away
23
23
  - **Automatic handoff** to problem management once service is restored
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@windyroad/itil",
3
- "version": "3.0.0",
3
+ "version": "3.0.1",
4
4
  "description": "ITIL-aligned IT service management for Claude Code and Codex",
5
5
  "bin": {
6
6
  "windyroad-itil": "./bin/install.mjs"
@@ -9,7 +9,19 @@ deprecated-arguments: true
9
9
 
10
10
  Declare, triage, mitigate, and close an incident using an evidence-first, cool-headed workflow. This skill's primary goal is **restoring service**. Once service is restored, the skill hands off to `wr-itil:manage-problem` so the underlying cause is tracked.
11
11
 
12
- Incidents are time-bound events. Problems are persistent root causes. One problem can cause many incidents; one incident may (or may not) link to a problem.
12
+ Incidents are observed interruptions or degradations of an existing service with an established prior working baseline to restore. Problems include missing, incomplete or deficient capabilities as well as persistent underlying causes. One problem can cause many incidents; one incident may (or may not) link to a problem.
13
+
14
+ ## Eligibility before declaration
15
+
16
+ Classify the report before incident duplicate lookup, ID allocation, severity rating or mitigation. This classification is agent-owned from the available evidence; do not ask permission to use the applicable workflow.
17
+
18
+ | Evidence | Route |
19
+ |----------|-------|
20
+ | Missing or incomplete feature, deficiency present from the outset, or performance that has always been slow | Use `wr-itil:manage-problem`. There is no prior service to restore; do not declare an incident or run restoration ceremony. |
21
+ | Slow or deficient behavior with no established prior working baseline | Investigate through `wr-itil:manage-problem`, measuring the current behavior and seeking evidence of the baseline. Do not invent a regression or declare an incident from unmet expectations alone. |
22
+ | Previously working service becomes unavailable, or previously fast service becomes slower, with an observed change from its baseline | Use incident management to restore that affected existing service. |
23
+
24
+ Being deployed, customer-visible or called a failure does not turn a capability gap into an incident. Being part of an unfinished product does not exempt a real regression of an existing service from incident handling. If problem investigation establishes an actual interruption or degradation of existing service, switch to incident management and record the baseline and observed change. Keep unrelated incomplete features in problem management.
13
25
 
14
26
  ## Operations
15
27
 
@@ -80,7 +92,7 @@ Determine the operation from `$ARGUMENTS`:
80
92
  - If arguments match `<I###> close` → **delegate to `/wr-itil:close-incident <I###>`** via the Skill tool. See "Deprecated-argument forwarders" below.
81
93
  - If arguments match `<I###> link P<MMM>` → **delegate to `/wr-itil:link-incident <I###> P<MMM>`** via the Skill tool. See "Deprecated-argument forwarders" below.
82
94
  - If arguments start with `I<NNN>` or a bare number → this is an update
83
- - Otherwise → declare a new incident
95
+ - Otherwise → apply **Eligibility before declaration**. Only an eligible report proceeds as a new incident; route initial deficiencies or an unknown baseline to `wr-itil:manage-problem` before any incident creation.
84
96
 
85
97
  #### Deprecated-argument forwarders (the "Rename `wr-problem` Plugin to `wr-itil`" architecture rule amended + the "Problem 071: Argument-based skill subcommands are not discoverable in Claude Code autocomplete" problem)
86
98
 
@@ -20,7 +20,19 @@ deprecated-arguments: true
20
20
 
21
21
  Declare, triage, mitigate, and close an incident using an evidence-first, cool-headed workflow. This skill's primary goal is **restoring service**. Once service is restored, the skill hands off to `wr-itil:manage-problem` so the underlying cause is tracked.
22
22
 
23
- Incidents are time-bound events. Problems are persistent root causes. One problem can cause many incidents; one incident may (or may not) link to a problem.
23
+ Incidents are observed interruptions or degradations of an existing service with an established prior working baseline to restore. Problems include missing, incomplete or deficient capabilities as well as persistent underlying causes. One problem can cause many incidents; one incident may (or may not) link to a problem.
24
+
25
+ ## Eligibility before declaration
26
+
27
+ Classify the report before incident duplicate lookup, ID allocation, severity rating or mitigation. This classification is agent-owned from the available evidence; do not ask permission to use the applicable workflow.
28
+
29
+ | Evidence | Route |
30
+ |----------|-------|
31
+ | Missing or incomplete feature, deficiency present from the outset, or performance that has always been slow | Use `wr-itil:manage-problem`. There is no prior service to restore; do not declare an incident or run restoration ceremony. |
32
+ | Slow or deficient behavior with no established prior working baseline | Investigate through `wr-itil:manage-problem`, measuring the current behavior and seeking evidence of the baseline. Do not invent a regression or declare an incident from unmet expectations alone. |
33
+ | Previously working service becomes unavailable, or previously fast service becomes slower, with an observed change from its baseline | Use incident management to restore that affected existing service. |
34
+
35
+ Being deployed, customer-visible or called a failure does not turn a capability gap into an incident. Being part of an unfinished product does not exempt a real regression of an existing service from incident handling. If problem investigation establishes an actual interruption or degradation of existing service, switch to incident management and record the baseline and observed change. Keep unrelated incomplete features in problem management.
24
36
 
25
37
  ## Operations
26
38
 
@@ -91,7 +103,7 @@ Determine the operation from `$ARGUMENTS`:
91
103
  - If arguments match `<I###> close` → **delegate to `/wr-itil:close-incident <I###>`** via the installed skill invocation. See "Deprecated-argument forwarders" below.
92
104
  - If arguments match `<I###> link P<MMM>` → **delegate to `/wr-itil:link-incident <I###> P<MMM>`** via the installed skill invocation. See "Deprecated-argument forwarders" below.
93
105
  - If arguments start with `I<NNN>` or a bare number → this is an update
94
- - Otherwise → declare a new incident
106
+ - Otherwise → apply **Eligibility before declaration**. Only an eligible report proceeds as a new incident; route initial deficiencies or an unknown baseline to `wr-itil:manage-problem` before any incident creation.
95
107
 
96
108
  #### Deprecated-argument forwarders (the "Rename `wr-problem` Plugin to `wr-itil`" architecture rule amended + the "Problem 071: Argument-based skill subcommands are not discoverable in Codex autocomplete" problem)
97
109