Skip to content

Commit f0d326b

Browse files
committed
refactor: update contextual-stewardship skill to use sds stewardship CLI commands
Migrated skill from raw node script invocations (node packages/cli/dist/...) to proper sds stewardship CLI subcommands. Removed obsolete TOON-based orchestrator.js and TOON_SPEC.md reference, superseded by the JSON graph store CLI implementation.
1 parent f09da76 commit f0d326b

3 files changed

Lines changed: 21 additions & 235 deletions

File tree

packages/cli/templates/universal/skills/contextual-stewardship/SKILL.md

Lines changed: 21 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -44,9 +44,13 @@ The system uses JSON file storage for all rule persistence:
4444

4545
---
4646

47-
## Modes
47+
## CLI Commands
4848

49-
The skill operates in four modes, selected via the `mode` parameter. Always include `mode` in your skill invocation.
49+
All stewardship operations use the `sds stewardship` CLI command. Ensure `sds` (spec-driven-steroids) is installed and available in PATH.
50+
51+
```bash
52+
sds stewardship <subcommand> [options]
53+
```
5054

5155
### `retrieve` — Pre-flight Context Retrieval
5256

@@ -62,7 +66,7 @@ The skill operates in four modes, selected via the `mode` parameter. Always incl
6266

6367
**Command:**
6468
```bash
65-
node packages/cli/dist/context-stewardship/orchestrator.js retrieve <query> [--domain <domain>] [--scope <project-id>]
69+
sds stewardship retrieve <query> [--domain <domain>] [--scope <scope>]
6670
```
6771

6872
**Retrieval confirmation format:**
@@ -86,7 +90,7 @@ node packages/cli/dist/context-stewardship/orchestrator.js retrieve <query> [--d
8690

8791
**Command:**
8892
```bash
89-
node packages/cli/dist/context-stewardship/orchestrator.js store <domain> "<content>" [--author <name>]
93+
sds stewardship store <domain> --content "<content>" [--author <name>]
9094
```
9195

9296
**Persistence confirmation format:**
@@ -110,7 +114,7 @@ node packages/cli/dist/context-stewardship/orchestrator.js store <domain> "<cont
110114

111115
**Command:**
112116
```bash
113-
node packages/cli/dist/context-stewardship/orchestrator.js extract <file-path> [--author <name>]
117+
sds stewardship extract <file-path> [--author <name>]
114118
```
115119

116120
**Extraction confirmation format:**
@@ -120,9 +124,9 @@ node packages/cli/dist/context-stewardship/orchestrator.js extract <file-path> [
120124

121125
---
122126

123-
### `inject`MCP Phase Context Injection
127+
### `inject` — Phase Context Injection
124128

125-
**When to use:** Before entering a new spec-driven phase (requirements, design, tasks, implementation). Automatically retrieve and inject relevant context into the skill prompt.
129+
**When to use:** Before entering a new spec-driven phase (requirements, design, tasks, implementation). Automatically retrieve and inject relevant context.
126130

127131
**Behavior:**
128132
1. Map phase to relevant domains:
@@ -131,16 +135,15 @@ node packages/cli/dist/context-stewardship/orchestrator.js extract <file-path> [
131135
- `tasks``workflow`, `team-structure`
132136
- `implementation``architecture`, `technical-debt`
133137
2. Query semantic engine for phase-relevant rules
134-
3. Format as injected context block for the skill prompt
138+
3. Format as injected context block
135139
4. Offer-to-capture: if a decision is made mid-phase, prompt to store it
136140

137141
**Command:**
138142
```bash
139-
node packages/cli/dist/context-stewardship/orchestrator.js inject <phase>
143+
sds stewardship inject <phase>
140144
```
141145

142146
**Injection format:**
143-
- Injects a structured context block into the skill prompt listing active rules by domain
144147
- "Phase `{phase}` context injected: {n} rules available from {domains}."
145148

146149
---
@@ -149,16 +152,11 @@ node packages/cli/dist/context-stewardship/orchestrator.js inject <phase>
149152

150153
**When to use:** When explicitly asked to list, deprecate, or archive rules.
151154

152-
**Behavior:**
153-
- `list`: Return all rules grouped by lifecycle state (active / deprecated / archived)
154-
- `deprecate`: Transition a rule to `deprecated`, set `supersededBy` link
155-
- `archive`: Transition a rule to `archived` (historical retention)
156-
157155
**Commands:**
158156
```bash
159-
node packages/cli/dist/context-stewardship/orchestrator.js manage list [--scope <project-id>]
160-
node packages/cli/dist/context-stewardship/orchestrator.js manage deprecate <rule-id>
161-
node packages/cli/dist/context-stewardship/orchestrator.js manage archive <rule-id>
157+
sds stewardship manage list [--scope <scope>]
158+
sds stewardship manage deprecate --ruleId <rule-id>
159+
sds stewardship manage archive --ruleId <rule-id>
162160
```
163161

164162
---
@@ -168,7 +166,7 @@ node packages/cli/dist/context-stewardship/orchestrator.js manage archive <rule-
168166
**When to use:** Debugging or verifying why a certain feature is unavailable.
169167

170168
```bash
171-
node packages/cli/dist/context-stewardship/orchestrator.js capabilities
169+
sds stewardship capabilities
172170
```
173171

174172
Output example:
@@ -185,7 +183,7 @@ Enabled Features: json-graph, semantic-retrieval, versioning, conflict-detection
185183
**When to use:** When investigating the history or provenance of a specific rule.
186184

187185
```bash
188-
node packages/cli/dist/context-stewardship/orchestrator.js trace <rule-id>
186+
sds stewardship trace <rule-id>
189187
```
190188

191189
Returns: rule content, domain, state, full provenance, `supersededBy` link, and version history with timestamps and diffs.
@@ -196,11 +194,11 @@ Returns: rule content, domain, state, full provenance, `supersededBy` link, and
196194

197195
Before every implementation task, run through this checklist:
198196

199-
- [ ] **retrieve** with task keywords — do we have existing rules?
200-
- [ ] Check scope chain — are there project-specific overrides?
197+
- [ ] `sds stewardship retrieve "<task keywords>"` — do we have existing rules?
198+
- [ ] Check scope chain — are there project-specific overrides? (`--scope <project-id>`)
201199
- [ ] Check for conflicts — does the new decision contradict an existing rule?
202200
- [ ] Check deprecated rules — is there a `supersededBy` link to follow?
203-
- [ ] **extract** from spec files if reading `design.md` or `requirements.md`
201+
- [ ] `sds stewardship extract <spec-file>` if reading `design.md` or `requirements.md`
204202

205203
---
206204

packages/cli/templates/universal/skills/contextual-stewardship/references/TOON_SPEC.md

Lines changed: 0 additions & 71 deletions
This file was deleted.

packages/cli/templates/universal/skills/contextual-stewardship/scripts/orchestrator.js

Lines changed: 0 additions & 141 deletions
This file was deleted.

0 commit comments

Comments
 (0)