sdtk-ops-kit 0.2.1 → 0.2.3
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.
- package/README.md +95 -8
- package/assets/manifest/toolkit-bundle.manifest.json +66 -66
- package/assets/manifest/toolkit-bundle.sha256.txt +32 -32
- package/assets/toolkit/toolkit/AGENTS.md +30 -2
- package/assets/toolkit/toolkit/SDTKOPS_TOOLKIT.md +203 -166
- package/assets/toolkit/toolkit/install.ps1 +1 -8
- package/assets/toolkit/toolkit/scripts/install-codex-skills.ps1 +30 -7
- package/assets/toolkit/toolkit/scripts/uninstall-codex-skills.ps1 +31 -2
- package/assets/toolkit/toolkit/sdtk-spec.config.profiles.example.json +12 -12
- package/assets/toolkit/toolkit/skills/ops-backup/SKILL.md +0 -2
- package/assets/toolkit/toolkit/skills/ops-backup/references/backup-script-patterns.md +0 -2
- package/assets/toolkit/toolkit/skills/ops-ci-cd/SKILL.md +0 -2
- package/assets/toolkit/toolkit/skills/ops-ci-cd/references/pipeline-examples.md +0 -2
- package/assets/toolkit/toolkit/skills/ops-container/SKILL.md +0 -2
- package/assets/toolkit/toolkit/skills/ops-container/references/k8s-manifest-patterns.md +0 -2
- package/assets/toolkit/toolkit/skills/ops-cost/SKILL.md +0 -2
- package/assets/toolkit/toolkit/skills/ops-debug/SKILL.md +0 -1
- package/assets/toolkit/toolkit/skills/ops-debug/references/root-cause-tracing.md +0 -1
- package/assets/toolkit/toolkit/skills/ops-deploy/SKILL.md +0 -2
- package/assets/toolkit/toolkit/skills/ops-discover/SKILL.md +21 -0
- package/assets/toolkit/toolkit/skills/ops-incident/SKILL.md +0 -2
- package/assets/toolkit/toolkit/skills/ops-incident/references/communication-templates.md +0 -2
- package/assets/toolkit/toolkit/skills/ops-incident/references/postmortem-template.md +0 -2
- package/assets/toolkit/toolkit/skills/ops-incident/references/runbook-template.md +0 -2
- package/assets/toolkit/toolkit/skills/ops-infra-plan/SKILL.md +1 -3
- package/assets/toolkit/toolkit/skills/ops-infra-plan/references/iac-patterns.md +0 -2
- package/assets/toolkit/toolkit/skills/ops-monitor/SKILL.md +0 -2
- package/assets/toolkit/toolkit/skills/ops-monitor/references/alert-rules.md +0 -2
- package/assets/toolkit/toolkit/skills/ops-monitor/references/slo-templates.md +0 -2
- package/assets/toolkit/toolkit/skills/ops-parallel/SKILL.md +22 -5
- package/assets/toolkit/toolkit/skills/ops-plan/SKILL.md +33 -1
- package/assets/toolkit/toolkit/skills/ops-security-infra/SKILL.md +1 -3
- package/assets/toolkit/toolkit/skills/ops-security-infra/references/cicd-security-pipeline.md +0 -2
- package/assets/toolkit/toolkit/skills/ops-security-infra/references/security-headers.md +0 -2
- package/assets/toolkit/toolkit/skills/ops-verify/SKILL.md +16 -1
- package/package.json +1 -1
- package/src/commands/help.js +88 -53
- package/src/commands/init.js +10 -1
- package/src/commands/runtime.js +29 -7
- package/src/commands/update.js +11 -0
- package/src/index.js +68 -65
- package/src/lib/scope.js +19 -2
- package/src/lib/update.js +337 -0
package/README.md
CHANGED
|
@@ -6,13 +6,12 @@
|
|
|
6
6
|
|
|
7
7
|
- Package: `sdtk-ops-kit`
|
|
8
8
|
- CLI: `sdtk-ops`
|
|
9
|
-
-
|
|
10
|
-
- Patch note: `0.2.1` corrects stale help-surface wording that shipped in `0.2.0`
|
|
9
|
+
- Latest published version lookup: `npm view sdtk-ops-kit version`
|
|
11
10
|
|
|
12
11
|
## Install
|
|
13
12
|
|
|
14
13
|
```bash
|
|
15
|
-
npm install -g sdtk-ops-kit
|
|
14
|
+
npm install -g sdtk-ops-kit
|
|
16
15
|
```
|
|
17
16
|
|
|
18
17
|
Then verify the installed command:
|
|
@@ -22,6 +21,43 @@ sdtk-ops --version
|
|
|
22
21
|
sdtk-ops --help
|
|
23
22
|
```
|
|
24
23
|
|
|
24
|
+
If you need the exact latest published version number, run:
|
|
25
|
+
|
|
26
|
+
```bash
|
|
27
|
+
npm view sdtk-ops-kit version
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
## Update Existing Installation
|
|
31
|
+
|
|
32
|
+
Use the public `update` command when `sdtk-ops-kit` is already installed and you want the newest published package line.
|
|
33
|
+
|
|
34
|
+
```bash
|
|
35
|
+
sdtk-ops update --check-only
|
|
36
|
+
sdtk-ops update --runtime claude --project-path ./my-project
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
Codex user-scope variant:
|
|
40
|
+
|
|
41
|
+
```bash
|
|
42
|
+
sdtk-ops update --runtime codex --scope user --project-path ./my-project
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
Project-local Codex refresh is also supported, but only when you intentionally launch the runtime with the explicit local `CODEX_HOME=<project>/.codex` contract. Native `.codex/skills` auto-discovery is still not claimed.
|
|
46
|
+
|
|
47
|
+
Then verify:
|
|
48
|
+
|
|
49
|
+
```bash
|
|
50
|
+
sdtk-ops --version
|
|
51
|
+
sdtk-ops runtime status --runtime claude --project-path ./my-project
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
Important truth:
|
|
55
|
+
- `sdtk-ops update` still uses `npm install -g sdtk-ops-kit@<target>` as the package refresh mechanism
|
|
56
|
+
- `update --check-only` is non-destructive and prints the planned commands only
|
|
57
|
+
- `init --force` refreshes managed project files
|
|
58
|
+
- `runtime install --force` refreshes managed runtime assets
|
|
59
|
+
- existing ops evidence is not rewritten automatically
|
|
60
|
+
|
|
25
61
|
## Supported Command Surface
|
|
26
62
|
|
|
27
63
|
`SDTK-OPS` keeps a deliberately small CLI surface.
|
|
@@ -30,6 +66,7 @@ sdtk-ops --help
|
|
|
30
66
|
|---|---|
|
|
31
67
|
| `sdtk-ops help` | Show the supported command surface and routing guidance |
|
|
32
68
|
| `sdtk-ops init` | Copy shared project files and prepare runtime installation |
|
|
69
|
+
| `sdtk-ops update` | Refresh the installed package line and optionally rerun bounded managed-file/runtime refresh steps |
|
|
33
70
|
| `sdtk-ops runtime install` | Install runtime assets for Claude or Codex |
|
|
34
71
|
| `sdtk-ops runtime status` | Check installed runtime assets |
|
|
35
72
|
| `sdtk-ops runtime uninstall` | Remove runtime assets cleanly |
|
|
@@ -43,13 +80,34 @@ Not supported:
|
|
|
43
80
|
| Runtime | Project Scope | User Scope | Notes |
|
|
44
81
|
|---|:---:|:---:|---|
|
|
45
82
|
| Claude | Yes | Yes | Default scope is project |
|
|
46
|
-
| Codex |
|
|
83
|
+
| Codex | Yes | Yes | Default scope is user; project-local installs require the explicit local `CODEX_HOME=<project>/.codex` contract |
|
|
47
84
|
|
|
48
85
|
Important truth:
|
|
49
86
|
- Claude supports `project` and `user` scope.
|
|
50
|
-
- Codex
|
|
87
|
+
- Codex defaults to `user` scope and supports `project` scope only through the explicit local `CODEX_HOME=<project>/.codex` contract.
|
|
51
88
|
- Codex installs collision-avoiding `sdtk-ops-*` skill names.
|
|
52
89
|
|
|
90
|
+
## Remove Runtime Assets vs Remove the Package
|
|
91
|
+
|
|
92
|
+
`runtime uninstall` removes only the SDTK-OPS-managed skill folders for the selected runtime and scope.
|
|
93
|
+
It does not delete `.claude/`, `.claude/skills/`, `$CODEX_HOME/`, or `$CODEX_HOME/skills/`, because those roots may contain non-SDTK user assets.
|
|
94
|
+
|
|
95
|
+
Use runtime cleanup first:
|
|
96
|
+
|
|
97
|
+
```bash
|
|
98
|
+
sdtk-ops runtime uninstall --runtime claude --scope project --project-path ./my-project
|
|
99
|
+
sdtk-ops runtime uninstall --runtime claude --scope user
|
|
100
|
+
sdtk-ops runtime uninstall --runtime codex --all
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
Use npm uninstall separately when you also want to remove the globally installed CLI package:
|
|
104
|
+
|
|
105
|
+
```bash
|
|
106
|
+
npm uninstall -g sdtk-ops-kit
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
That npm command removes the package only. It does not remove runtime assets already copied into Claude or Codex skill directories.
|
|
110
|
+
|
|
53
111
|
## Quick Start
|
|
54
112
|
|
|
55
113
|
### 1. Initialize a project
|
|
@@ -83,13 +141,13 @@ Codex user scope:
|
|
|
83
141
|
sdtk-ops runtime install --runtime codex --scope user
|
|
84
142
|
```
|
|
85
143
|
|
|
86
|
-
|
|
144
|
+
Codex project-local scope, only when you intentionally launch with `CODEX_HOME=<project>/.codex`:
|
|
87
145
|
|
|
88
146
|
```bash
|
|
89
|
-
sdtk-ops runtime install --runtime codex --scope project
|
|
147
|
+
sdtk-ops runtime install --runtime codex --scope project --project-path ./my-project
|
|
90
148
|
```
|
|
91
149
|
|
|
92
|
-
|
|
150
|
+
Project-local Codex installs remain bounded explicit-local support. Native `.codex/skills` auto-discovery is not claimed.
|
|
93
151
|
|
|
94
152
|
### 3. Choose the right skill journey
|
|
95
153
|
|
|
@@ -103,6 +161,35 @@ Canonical journeys:
|
|
|
103
161
|
|
|
104
162
|
Always close work with `ops-verify`.
|
|
105
163
|
|
|
164
|
+
## DEV-Run Intake Contract
|
|
165
|
+
|
|
166
|
+
When operationalization begins from `SDTK-CODE`, the only canonical intake artifact is:
|
|
167
|
+
|
|
168
|
+
- `docs/dev/OPS_HANDOFF_[FEATURE_KEY].json`
|
|
169
|
+
|
|
170
|
+
`SDTK-OPS` consumes that frozen contract as input.
|
|
171
|
+
It does not redefine the schema, rename fields, or move the canonical handoff path.
|
|
172
|
+
|
|
173
|
+
Ready-path intake:
|
|
174
|
+
- inspect `handoff_status`
|
|
175
|
+
- if status is `READY_FOR_SDTK_OPS`, start from `suggested_next_ops_path.start_with`
|
|
176
|
+
- treat `suggested_next_ops_path.suggested_chain` as the default route unless fresh evidence requires a bounded reroute
|
|
177
|
+
- close accepted work with `suggested_next_ops_path.close_with`, normally `ops-verify`
|
|
178
|
+
|
|
179
|
+
Blocked-path intake:
|
|
180
|
+
- if status is `BLOCKED_FOR_SDTK_OPS`, the handoff is still inspectable
|
|
181
|
+
- inspect `open_blockers`, `code_evidence_refs`, and the prerequisite fields before choosing the next step
|
|
182
|
+
- do not treat blocked handoff state as normal ready-path execution
|
|
183
|
+
|
|
184
|
+
Minimum OPS evidence expectations for this wave:
|
|
185
|
+
- record the consumed handoff path and `handoff_status`
|
|
186
|
+
- record whether the chosen first OPS step followed or overrode `suggested_next_ops_path`, and why
|
|
187
|
+
- record checked prerequisites, assumptions, dependencies, observability requirements, and rollback or recovery expectations
|
|
188
|
+
- record journey-specific operational evidence
|
|
189
|
+
- record final `ops-verify` closeout evidence
|
|
190
|
+
|
|
191
|
+
This wave does not define a final OPS evidence schema and does not implement QA bridge logic.
|
|
192
|
+
|
|
106
193
|
## Product Boundary
|
|
107
194
|
|
|
108
195
|
`SDTK-OPS` is the downstream operations product in the `SDTK-SPEC -> SDTK-CODE -> SDTK-OPS` family.
|
|
@@ -1,17 +1,17 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "0.2.
|
|
3
|
-
"sourceCommit": "
|
|
2
|
+
"version": "0.2.3",
|
|
3
|
+
"sourceCommit": "5b21b7376fcf11a9138f486921de5e07e0c88ac7",
|
|
4
4
|
"fileCount": 36,
|
|
5
5
|
"files": [
|
|
6
6
|
{
|
|
7
7
|
"path": "toolkit/AGENTS.md",
|
|
8
|
-
"sha256": "
|
|
9
|
-
"size":
|
|
8
|
+
"sha256": "a1a8d03564680cde44ef34e1878f3c8fb6ad7ce79e79b7ba7274fdb072321f30",
|
|
9
|
+
"size": 5925
|
|
10
10
|
},
|
|
11
11
|
{
|
|
12
12
|
"path": "toolkit/install.ps1",
|
|
13
|
-
"sha256": "
|
|
14
|
-
"size":
|
|
13
|
+
"sha256": "ac041e80d0771b13fc1dc94c6a572debaddba223ff4d029695a6953f35ebaa92",
|
|
14
|
+
"size": 3015
|
|
15
15
|
},
|
|
16
16
|
{
|
|
17
17
|
"path": "toolkit/scripts/install-claude-skills.ps1",
|
|
@@ -20,8 +20,8 @@
|
|
|
20
20
|
},
|
|
21
21
|
{
|
|
22
22
|
"path": "toolkit/scripts/install-codex-skills.ps1",
|
|
23
|
-
"sha256": "
|
|
24
|
-
"size":
|
|
23
|
+
"sha256": "68eb662bc9b8906882d32f6cd1247238f6ae663137a489f18054a75724cd1e81",
|
|
24
|
+
"size": 4761
|
|
25
25
|
},
|
|
26
26
|
{
|
|
27
27
|
"path": "toolkit/scripts/uninstall-claude-skills.ps1",
|
|
@@ -30,13 +30,13 @@
|
|
|
30
30
|
},
|
|
31
31
|
{
|
|
32
32
|
"path": "toolkit/scripts/uninstall-codex-skills.ps1",
|
|
33
|
-
"sha256": "
|
|
34
|
-
"size":
|
|
33
|
+
"sha256": "fdb9631a80ecfb0d986a52a2833e88bf15c5303ab654d35bad6d64cca43046e8",
|
|
34
|
+
"size": 2428
|
|
35
35
|
},
|
|
36
36
|
{
|
|
37
37
|
"path": "toolkit/SDTKOPS_TOOLKIT.md",
|
|
38
|
-
"sha256": "
|
|
39
|
-
"size":
|
|
38
|
+
"sha256": "bed302b782f0c1729c8010877207a67bbc4c3032209186a54bac280d468cf5c8",
|
|
39
|
+
"size": 8171
|
|
40
40
|
},
|
|
41
41
|
{
|
|
42
42
|
"path": "toolkit/sdtk-spec.config.json",
|
|
@@ -45,28 +45,28 @@
|
|
|
45
45
|
},
|
|
46
46
|
{
|
|
47
47
|
"path": "toolkit/sdtk-spec.config.profiles.example.json",
|
|
48
|
-
"sha256": "
|
|
49
|
-
"size":
|
|
48
|
+
"sha256": "de0310b0c69f77d1c1601b94b0ea72b2c83c92cb8ee94d2f4a1759ceb58f2fd4",
|
|
49
|
+
"size": 315
|
|
50
50
|
},
|
|
51
51
|
{
|
|
52
52
|
"path": "toolkit/skills/ops-backup/references/backup-script-patterns.md",
|
|
53
|
-
"sha256": "
|
|
54
|
-
"size":
|
|
53
|
+
"sha256": "1cd81e12cebdb2be528803e2d8afe43959aab1493e55499af529b99ec566a56c",
|
|
54
|
+
"size": 3071
|
|
55
55
|
},
|
|
56
56
|
{
|
|
57
57
|
"path": "toolkit/skills/ops-backup/SKILL.md",
|
|
58
|
-
"sha256": "
|
|
59
|
-
"size":
|
|
58
|
+
"sha256": "76e8385190d967bf98b3cafbbf8925d9b9c656ee7a7ed66ff51285b6459ebff1",
|
|
59
|
+
"size": 3537
|
|
60
60
|
},
|
|
61
61
|
{
|
|
62
62
|
"path": "toolkit/skills/ops-ci-cd/references/pipeline-examples.md",
|
|
63
|
-
"sha256": "
|
|
64
|
-
"size":
|
|
63
|
+
"sha256": "d27e47b0c832656c2835e3d3e32dae7c86419014199439b10fc6823956324716",
|
|
64
|
+
"size": 2257
|
|
65
65
|
},
|
|
66
66
|
{
|
|
67
67
|
"path": "toolkit/skills/ops-ci-cd/SKILL.md",
|
|
68
|
-
"sha256": "
|
|
69
|
-
"size":
|
|
68
|
+
"sha256": "c9bf8e6f602d6201ccd54a78a9a7f850028924b460d60495d144bd5ec473c5e6",
|
|
69
|
+
"size": 2657
|
|
70
70
|
},
|
|
71
71
|
{
|
|
72
72
|
"path": "toolkit/skills/ops-compliance/SKILL.md",
|
|
@@ -75,113 +75,113 @@
|
|
|
75
75
|
},
|
|
76
76
|
{
|
|
77
77
|
"path": "toolkit/skills/ops-container/references/k8s-manifest-patterns.md",
|
|
78
|
-
"sha256": "
|
|
79
|
-
"size":
|
|
78
|
+
"sha256": "070ebcad0d0cb71cd3815de6e4c78d22517a28f825d65ea3677215e57112d1df",
|
|
79
|
+
"size": 2237
|
|
80
80
|
},
|
|
81
81
|
{
|
|
82
82
|
"path": "toolkit/skills/ops-container/SKILL.md",
|
|
83
|
-
"sha256": "
|
|
84
|
-
"size":
|
|
83
|
+
"sha256": "7eb1113162af029886974d2dba6553fec6ba9b002adc31a18c427a5e471d48a3",
|
|
84
|
+
"size": 3541
|
|
85
85
|
},
|
|
86
86
|
{
|
|
87
87
|
"path": "toolkit/skills/ops-cost/SKILL.md",
|
|
88
|
-
"sha256": "
|
|
89
|
-
"size":
|
|
88
|
+
"sha256": "3000b78ad911d667b056efdc01c639d8e069c1df1b157c6a6721ba2c61cce678",
|
|
89
|
+
"size": 3356
|
|
90
90
|
},
|
|
91
91
|
{
|
|
92
92
|
"path": "toolkit/skills/ops-debug/references/root-cause-tracing.md",
|
|
93
|
-
"sha256": "
|
|
94
|
-
"size":
|
|
93
|
+
"sha256": "d70b59d276edf5c6c8aebb5fc669b8f6d04673fc8e8561cbaf4d7e5fb9f4e2f2",
|
|
94
|
+
"size": 3875
|
|
95
95
|
},
|
|
96
96
|
{
|
|
97
97
|
"path": "toolkit/skills/ops-debug/SKILL.md",
|
|
98
|
-
"sha256": "
|
|
99
|
-
"size":
|
|
98
|
+
"sha256": "d5f58322afebcf5c3a110b02de0d2eec4494f9ed9d358b113b6717275c3524af",
|
|
99
|
+
"size": 11066
|
|
100
100
|
},
|
|
101
101
|
{
|
|
102
102
|
"path": "toolkit/skills/ops-deploy/SKILL.md",
|
|
103
|
-
"sha256": "
|
|
104
|
-
"size":
|
|
103
|
+
"sha256": "c2cacc94ffba4d7ef84e635c2078e08abb8d52f79afbbb1534661c0e0cf9bda6",
|
|
104
|
+
"size": 4068
|
|
105
105
|
},
|
|
106
106
|
{
|
|
107
107
|
"path": "toolkit/skills/ops-discover/SKILL.md",
|
|
108
|
-
"sha256": "
|
|
109
|
-
"size":
|
|
108
|
+
"sha256": "6f38c9b2ab972f272fb86e17926585a9a254a1c48c8454459a61315d4bd81d81",
|
|
109
|
+
"size": 5617
|
|
110
110
|
},
|
|
111
111
|
{
|
|
112
112
|
"path": "toolkit/skills/ops-incident/references/communication-templates.md",
|
|
113
|
-
"sha256": "
|
|
114
|
-
"size":
|
|
113
|
+
"sha256": "f6102d127e47861068b285ebbbb2045e4c3dc8cd9af73b3c975f285f2141639e",
|
|
114
|
+
"size": 1000
|
|
115
115
|
},
|
|
116
116
|
{
|
|
117
117
|
"path": "toolkit/skills/ops-incident/references/postmortem-template.md",
|
|
118
|
-
"sha256": "
|
|
119
|
-
"size":
|
|
118
|
+
"sha256": "fda6d9cadc5a3757e5559798a67716a6356809735b076d47d6bd99a993b71b99",
|
|
119
|
+
"size": 2008
|
|
120
120
|
},
|
|
121
121
|
{
|
|
122
122
|
"path": "toolkit/skills/ops-incident/references/runbook-template.md",
|
|
123
|
-
"sha256": "
|
|
124
|
-
"size":
|
|
123
|
+
"sha256": "358644dcd477fe32d3368ced5c9da30663ae3d54fdd5e825ae3e56327f7f6f2d",
|
|
124
|
+
"size": 1570
|
|
125
125
|
},
|
|
126
126
|
{
|
|
127
127
|
"path": "toolkit/skills/ops-incident/SKILL.md",
|
|
128
|
-
"sha256": "
|
|
129
|
-
"size":
|
|
128
|
+
"sha256": "df03ad86862020941e69b90ea1f2ccf8cd69762e53f0a539936c16fb433e61c8",
|
|
129
|
+
"size": 4128
|
|
130
130
|
},
|
|
131
131
|
{
|
|
132
132
|
"path": "toolkit/skills/ops-infra-plan/references/iac-patterns.md",
|
|
133
|
-
"sha256": "
|
|
134
|
-
"size":
|
|
133
|
+
"sha256": "14f02a1921cb58e2c54c355c0b24ffdf5a9bdb91a7be6921f22da5974787efee",
|
|
134
|
+
"size": 3990
|
|
135
135
|
},
|
|
136
136
|
{
|
|
137
137
|
"path": "toolkit/skills/ops-infra-plan/SKILL.md",
|
|
138
|
-
"sha256": "
|
|
139
|
-
"size":
|
|
138
|
+
"sha256": "35eec623e41603dae0a1a328c1e6d822d2e1dc79a471f06bab3c1f3e2d552e53",
|
|
139
|
+
"size": 4442
|
|
140
140
|
},
|
|
141
141
|
{
|
|
142
142
|
"path": "toolkit/skills/ops-monitor/references/alert-rules.md",
|
|
143
|
-
"sha256": "
|
|
144
|
-
"size":
|
|
143
|
+
"sha256": "28be1bd1babdaa3de9fc58f859060697c31b9249cc684c9c4272a9c3bc159db9",
|
|
144
|
+
"size": 2505
|
|
145
145
|
},
|
|
146
146
|
{
|
|
147
147
|
"path": "toolkit/skills/ops-monitor/references/slo-templates.md",
|
|
148
|
-
"sha256": "
|
|
149
|
-
"size":
|
|
148
|
+
"sha256": "af28797b442fb94fa96dc0182881847e50b5fe9e68ecf7a71471502030f4bd27",
|
|
149
|
+
"size": 2103
|
|
150
150
|
},
|
|
151
151
|
{
|
|
152
152
|
"path": "toolkit/skills/ops-monitor/SKILL.md",
|
|
153
|
-
"sha256": "
|
|
154
|
-
"size":
|
|
153
|
+
"sha256": "2d09968790ed63dd8e0969f59023c0ced71dd182d56475689a2d3bfc3f889002",
|
|
154
|
+
"size": 4292
|
|
155
155
|
},
|
|
156
156
|
{
|
|
157
157
|
"path": "toolkit/skills/ops-parallel/SKILL.md",
|
|
158
|
-
"sha256": "
|
|
159
|
-
"size":
|
|
158
|
+
"sha256": "8c83a7f267b7222cf9765a4328dd6945e30f3629dfca21cd85f7439f501b8ee0",
|
|
159
|
+
"size": 7277
|
|
160
160
|
},
|
|
161
161
|
{
|
|
162
162
|
"path": "toolkit/skills/ops-plan/SKILL.md",
|
|
163
|
-
"sha256": "
|
|
164
|
-
"size":
|
|
163
|
+
"sha256": "db75109542354b70a9502231f6c66803642c013958eedb93a26770f28b9e7fad",
|
|
164
|
+
"size": 7170
|
|
165
165
|
},
|
|
166
166
|
{
|
|
167
167
|
"path": "toolkit/skills/ops-security-infra/references/cicd-security-pipeline.md",
|
|
168
|
-
"sha256": "
|
|
169
|
-
"size":
|
|
168
|
+
"sha256": "1a2d6c5ab225af2abc2591cc897808ebcce16bf0478ed55daea61000aa7652ee",
|
|
169
|
+
"size": 1173
|
|
170
170
|
},
|
|
171
171
|
{
|
|
172
172
|
"path": "toolkit/skills/ops-security-infra/references/security-headers.md",
|
|
173
|
-
"sha256": "
|
|
174
|
-
"size":
|
|
173
|
+
"sha256": "796ebd48e399aedc59b0a1e9bbbe2363813d3b74be38721bec330cec683ecc69",
|
|
174
|
+
"size": 955
|
|
175
175
|
},
|
|
176
176
|
{
|
|
177
177
|
"path": "toolkit/skills/ops-security-infra/SKILL.md",
|
|
178
|
-
"sha256": "
|
|
179
|
-
"size":
|
|
178
|
+
"sha256": "81d19ee0002c70788295a6a7e93ae8b0ff0e97af5e71c0a3591548e5bbd5bab6",
|
|
179
|
+
"size": 4866
|
|
180
180
|
},
|
|
181
181
|
{
|
|
182
182
|
"path": "toolkit/skills/ops-verify/SKILL.md",
|
|
183
|
-
"sha256": "
|
|
184
|
-
"size":
|
|
183
|
+
"sha256": "497bcb22ccb191dbb77d7db46cd96801b56cf9b1ec630c834d3a947b90a6169e",
|
|
184
|
+
"size": 5983
|
|
185
185
|
}
|
|
186
186
|
]
|
|
187
187
|
}
|
|
@@ -1,36 +1,36 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
1
|
+
a1a8d03564680cde44ef34e1878f3c8fb6ad7ce79e79b7ba7274fdb072321f30 toolkit/AGENTS.md
|
|
2
|
+
ac041e80d0771b13fc1dc94c6a572debaddba223ff4d029695a6953f35ebaa92 toolkit/install.ps1
|
|
3
3
|
5eae77f4d14b81d56c3c109f563fefafd1967d85093ff1b192293fe438aeabe5 toolkit/scripts/install-claude-skills.ps1
|
|
4
|
-
|
|
4
|
+
68eb662bc9b8906882d32f6cd1247238f6ae663137a489f18054a75724cd1e81 toolkit/scripts/install-codex-skills.ps1
|
|
5
5
|
2c629d8316b205c6a7cd0d95959b80801b281ef62e205c10a92e3a2568eb8b41 toolkit/scripts/uninstall-claude-skills.ps1
|
|
6
|
-
|
|
7
|
-
|
|
6
|
+
fdb9631a80ecfb0d986a52a2833e88bf15c5303ab654d35bad6d64cca43046e8 toolkit/scripts/uninstall-codex-skills.ps1
|
|
7
|
+
bed302b782f0c1729c8010877207a67bbc4c3032209186a54bac280d468cf5c8 toolkit/SDTKOPS_TOOLKIT.md
|
|
8
8
|
8247ddf24502ce285bee213eefc801ce6b0b83afe00efd828468ac9130f53b09 toolkit/sdtk-spec.config.json
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
9
|
+
de0310b0c69f77d1c1601b94b0ea72b2c83c92cb8ee94d2f4a1759ceb58f2fd4 toolkit/sdtk-spec.config.profiles.example.json
|
|
10
|
+
1cd81e12cebdb2be528803e2d8afe43959aab1493e55499af529b99ec566a56c toolkit/skills/ops-backup/references/backup-script-patterns.md
|
|
11
|
+
76e8385190d967bf98b3cafbbf8925d9b9c656ee7a7ed66ff51285b6459ebff1 toolkit/skills/ops-backup/SKILL.md
|
|
12
|
+
d27e47b0c832656c2835e3d3e32dae7c86419014199439b10fc6823956324716 toolkit/skills/ops-ci-cd/references/pipeline-examples.md
|
|
13
|
+
c9bf8e6f602d6201ccd54a78a9a7f850028924b460d60495d144bd5ec473c5e6 toolkit/skills/ops-ci-cd/SKILL.md
|
|
14
14
|
a0bb24484cba68a7201e6b7f614c8b5ada8b2dff540a4e4390661a0ced112e8d toolkit/skills/ops-compliance/SKILL.md
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
15
|
+
070ebcad0d0cb71cd3815de6e4c78d22517a28f825d65ea3677215e57112d1df toolkit/skills/ops-container/references/k8s-manifest-patterns.md
|
|
16
|
+
7eb1113162af029886974d2dba6553fec6ba9b002adc31a18c427a5e471d48a3 toolkit/skills/ops-container/SKILL.md
|
|
17
|
+
3000b78ad911d667b056efdc01c639d8e069c1df1b157c6a6721ba2c61cce678 toolkit/skills/ops-cost/SKILL.md
|
|
18
|
+
d70b59d276edf5c6c8aebb5fc669b8f6d04673fc8e8561cbaf4d7e5fb9f4e2f2 toolkit/skills/ops-debug/references/root-cause-tracing.md
|
|
19
|
+
d5f58322afebcf5c3a110b02de0d2eec4494f9ed9d358b113b6717275c3524af toolkit/skills/ops-debug/SKILL.md
|
|
20
|
+
c2cacc94ffba4d7ef84e635c2078e08abb8d52f79afbbb1534661c0e0cf9bda6 toolkit/skills/ops-deploy/SKILL.md
|
|
21
|
+
6f38c9b2ab972f272fb86e17926585a9a254a1c48c8454459a61315d4bd81d81 toolkit/skills/ops-discover/SKILL.md
|
|
22
|
+
f6102d127e47861068b285ebbbb2045e4c3dc8cd9af73b3c975f285f2141639e toolkit/skills/ops-incident/references/communication-templates.md
|
|
23
|
+
fda6d9cadc5a3757e5559798a67716a6356809735b076d47d6bd99a993b71b99 toolkit/skills/ops-incident/references/postmortem-template.md
|
|
24
|
+
358644dcd477fe32d3368ced5c9da30663ae3d54fdd5e825ae3e56327f7f6f2d toolkit/skills/ops-incident/references/runbook-template.md
|
|
25
|
+
df03ad86862020941e69b90ea1f2ccf8cd69762e53f0a539936c16fb433e61c8 toolkit/skills/ops-incident/SKILL.md
|
|
26
|
+
14f02a1921cb58e2c54c355c0b24ffdf5a9bdb91a7be6921f22da5974787efee toolkit/skills/ops-infra-plan/references/iac-patterns.md
|
|
27
|
+
35eec623e41603dae0a1a328c1e6d822d2e1dc79a471f06bab3c1f3e2d552e53 toolkit/skills/ops-infra-plan/SKILL.md
|
|
28
|
+
28be1bd1babdaa3de9fc58f859060697c31b9249cc684c9c4272a9c3bc159db9 toolkit/skills/ops-monitor/references/alert-rules.md
|
|
29
|
+
af28797b442fb94fa96dc0182881847e50b5fe9e68ecf7a71471502030f4bd27 toolkit/skills/ops-monitor/references/slo-templates.md
|
|
30
|
+
2d09968790ed63dd8e0969f59023c0ced71dd182d56475689a2d3bfc3f889002 toolkit/skills/ops-monitor/SKILL.md
|
|
31
|
+
8c83a7f267b7222cf9765a4328dd6945e30f3629dfca21cd85f7439f501b8ee0 toolkit/skills/ops-parallel/SKILL.md
|
|
32
|
+
db75109542354b70a9502231f6c66803642c013958eedb93a26770f28b9e7fad toolkit/skills/ops-plan/SKILL.md
|
|
33
|
+
1a2d6c5ab225af2abc2591cc897808ebcce16bf0478ed55daea61000aa7652ee toolkit/skills/ops-security-infra/references/cicd-security-pipeline.md
|
|
34
|
+
796ebd48e399aedc59b0a1e9bbbe2363813d3b74be38721bec330cec683ecc69 toolkit/skills/ops-security-infra/references/security-headers.md
|
|
35
|
+
81d19ee0002c70788295a6a7e93ae8b0ff0e97af5e71c0a3591548e5bbd5bab6 toolkit/skills/ops-security-infra/SKILL.md
|
|
36
|
+
497bcb22ccb191dbb77d7db46cd96801b56cf9b1ec630c834d3a947b90a6169e toolkit/skills/ops-verify/SKILL.md
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
|
|
1
|
+
# SDTK-OPS -- Operations Discipline Toolkit
|
|
2
2
|
|
|
3
3
|
Purpose: use SDTK-OPS to drive disciplined infrastructure and operations work across planning, deployment, monitoring, incident response, recovery, security hardening, and cost optimization.
|
|
4
4
|
|
|
@@ -14,11 +14,39 @@ Document role:
|
|
|
14
14
|
- If the correct entry point is unclear, start with `ops-discover`.
|
|
15
15
|
- Use `ops-verify` before marking any operational task complete.
|
|
16
16
|
- Use `ops-debug` for evidence-first diagnosis before proposing speculative fixes.
|
|
17
|
+
- Use `ops-parallel` only for truly independent slices. If collab or subagent dispatch is unavailable in the active runtime, keep the same slice boundaries but execute them sequentially in one controller session.
|
|
17
18
|
- Keep guidance cloud-agnostic unless the task explicitly requires a platform-specific example.
|
|
18
19
|
- Do not drift into application specification or coding workflows. Those belong to SDTK-SPEC or SDTK-CODE.
|
|
19
20
|
- `ops-discover` is a skill, not a CLI command.
|
|
20
21
|
- `generate` remains unsupported and deferred in the current SDTK-OPS CLI surface.
|
|
21
22
|
|
|
23
|
+
## DEV-Run Intake
|
|
24
|
+
|
|
25
|
+
When `DEV-Run` begins from `SDTK-CODE`, the only canonical bridge artifact is:
|
|
26
|
+
- `docs/dev/OPS_HANDOFF_[FEATURE_KEY].json`
|
|
27
|
+
|
|
28
|
+
Treat that file as the frozen suite contract input.
|
|
29
|
+
`SDTK-OPS` consumes it, but does not redefine the schema, rename fields, or move the canonical path.
|
|
30
|
+
|
|
31
|
+
Ready-path intake:
|
|
32
|
+
- inspect `handoff_status` first
|
|
33
|
+
- if status is `READY_FOR_SDTK_OPS`, default to `suggested_next_ops_path.start_with`
|
|
34
|
+
- treat `suggested_next_ops_path.suggested_chain` as the default route unless fresh evidence requires a bounded reroute
|
|
35
|
+
- close with `suggested_next_ops_path.close_with`, which should normally be `ops-verify`
|
|
36
|
+
|
|
37
|
+
Blocked-path intake:
|
|
38
|
+
- if status is `BLOCKED_FOR_SDTK_OPS`, the handoff is still inspectable
|
|
39
|
+
- inspect `open_blockers`, `code_evidence_refs`, and prerequisite fields before choosing a next step
|
|
40
|
+
- do not treat a blocked handoff as normal ready-path execution
|
|
41
|
+
- use `ops-discover` only to select bounded triage or clarification, not to silently reinterpret blocked scope as deployment-ready
|
|
42
|
+
|
|
43
|
+
Minimum OPS evidence expectations:
|
|
44
|
+
- record the consumed handoff path and `handoff_status`
|
|
45
|
+
- record whether the chosen first skill followed or overrode `suggested_next_ops_path`, and why
|
|
46
|
+
- record which prerequisites, assumptions, dependencies, observability, and rollback items were checked
|
|
47
|
+
- record journey-specific operational evidence for the scoped OPS work
|
|
48
|
+
- record final `ops-verify` closeout evidence
|
|
49
|
+
|
|
22
50
|
## Primary Routing Journeys
|
|
23
51
|
|
|
24
52
|
| Journey | Start With | Suggested Chain | Close With |
|
|
@@ -58,7 +86,7 @@ Document role:
|
|
|
58
86
|
| Runtime | Project Scope | User Scope | Default Scope | Notes |
|
|
59
87
|
|---------|:-------------:|:----------:|---------------|-------|
|
|
60
88
|
| Claude | true | true | project | project-local toolkit supported |
|
|
61
|
-
| Codex |
|
|
89
|
+
| Codex | true | true | user | Project-local skill runtime is supported only through the explicit local `CODEX_HOME=<project>/.codex` contract; native `.codex/skills` auto-discovery is not claimed. |
|
|
62
90
|
|
|
63
91
|
## Verification Policy
|
|
64
92
|
|