@fro.bot/systematic 2.18.0 → 2.20.0

package/dist/cli.js

@@ -6,7 +6,7 @@ import {
   findCommandsInDir,
   findSkillsInDir,
   getConfigPaths
-} from "./index-ek6rskkw.js";
+} from "./index-6evyges6.js";
 
 // src/cli.ts
 import fs from "fs";

package/dist/{index-ek6rskkw.js → index-6evyges6.js}

@@ -500,6 +500,21 @@ function extractFrontmatter(filePath) {
         metadata = Object.fromEntries(entries);
       }
     }
+    const deprecatedRaw = data.deprecated;
+    let deprecated;
+    if (isRecord(deprecatedRaw)) {
+      const since = typeof deprecatedRaw.since === "string" && deprecatedRaw.since !== "" ? deprecatedRaw.since : undefined;
+      const removal = typeof deprecatedRaw.removal === "string" && deprecatedRaw.removal !== "" ? deprecatedRaw.removal : undefined;
+      if (since !== undefined && removal !== undefined) {
+        deprecated = { since, removal };
+        if (typeof deprecatedRaw.replacement === "string") {
+          deprecated.replacement = deprecatedRaw.replacement;
+        }
+        if (typeof deprecatedRaw.reason === "string") {
+          deprecated.reason = deprecatedRaw.reason;
+        }
+      }
+    }
     const argumentHintRaw = extractNonEmptyString(data, "argument-hint");
     const argumentHint = argumentHintRaw?.replace(/^["']|["']$/g, "") || undefined;
     return {
@@ -508,6 +523,7 @@ function extractFrontmatter(filePath) {
       license: extractNonEmptyString(data, "license"),
       compatibility: extractNonEmptyString(data, "compatibility"),
       metadata,
+      deprecated,
       disableModelInvocation: extractBoolean(data, "disable-model-invocation"),
       userInvocable: extractBoolean(data, "user-invocable"),
       subtask: data.context === "fork" ? true : extractBoolean(data, "subtask") ?? undefined,
@@ -538,6 +554,7 @@ function findSkillsInDir(dir, maxDepth = 3) {
         license: frontmatter.license,
         compatibility: frontmatter.compatibility,
         metadata: frontmatter.metadata,
+        deprecated: frontmatter.deprecated,
         disableModelInvocation: frontmatter.disableModelInvocation,
         userInvocable: frontmatter.userInvocable,
         subtask: frontmatter.subtask,

package/dist/index.js

@@ -13,7 +13,7 @@ import {
   loadConfig,
   loadConfigWithSources,
   parseFrontmatter
-} from "./index-ek6rskkw.js";
+} from "./index-6evyges6.js";
 
 // src/index.ts
 import fs5 from "fs";
@@ -81,7 +81,8 @@ function loadSkill(skillInfo) {
       subtask: skillInfo.subtask,
       agent: skillInfo.agent,
       model: skillInfo.model,
-      argumentHint: skillInfo.argumentHint
+      argumentHint: skillInfo.argumentHint,
+      deprecated: skillInfo.deprecated
     };
   } catch {
     return null;
@@ -1186,8 +1187,25 @@ function discoverSkillFiles(dir, limit = 10) {
   return files.map((file) => `  <file>${file}</file>`).join(`
 `);
 }
+function formatDeprecationMessage(name, deprecated) {
+  let msg = `[systematic] skill "${name}" is deprecated since ${deprecated.since}; will be removed in ${deprecated.removal}.`;
+  if (deprecated.replacement) {
+    msg += ` Replacement: ${deprecated.replacement}`;
+    if (!deprecated.replacement.endsWith(".")) {
+      msg += ".";
+    }
+  }
+  if (deprecated.reason) {
+    msg += ` Reason: ${deprecated.reason}`;
+    if (!deprecated.reason.endsWith(".")) {
+      msg += ".";
+    }
+  }
+  return msg;
+}
 function createSkillTool(options) {
   const { bundledSkillsDir, disabledSkills } = options;
+  const warnedSkills = new Set;
   const getAllSkills = () => {
     return findSkillsInDir(bundledSkillsDir).filter((s) => !disabledSkills.includes(s.name)).map((skillInfo) => loadSkill(skillInfo)).filter((s) => s !== null).sort((a, b) => a.name.localeCompare(b.name));
   };
@@ -1238,6 +1256,10 @@ ${catalog}`;
         }).map((s) => s.prefixedName);
         throw new Error(`Skill "${requestedName}" not found. Available systematic skills: ${availableSystematic.join(", ")}`);
       }
+      if (matchedSkill.deprecated && !warnedSkills.has(matchedSkill.name)) {
+        console.warn(formatDeprecationMessage(matchedSkill.name, matchedSkill.deprecated));
+        warnedSkills.add(matchedSkill.name);
+      }
       const body = extractSkillBody(matchedSkill.wrappedTemplate);
       const dir = path6.dirname(matchedSkill.skillFile);
       const base = pathToFileURL2(dir).href;

package/dist/lib/skill-loader.d.ts

@@ -1,4 +1,4 @@
-import type { SkillInfo } from './skills.js';
+import type { SkillDeprecated, SkillInfo } from './skills.js';
 export interface LoadedSkill {
     name: string;
     prefixedName: string;
@@ -12,6 +12,7 @@ export interface LoadedSkill {
     agent?: string;
     model?: string;
     argumentHint?: string;
+    deprecated?: SkillDeprecated;
 }
 export declare function formatSkillCommandName(name: string): string;
 export declare function formatSkillDescription(description: string, fallbackName: string): string;

package/dist/lib/skills.d.ts

@@ -1,9 +1,16 @@
+export interface SkillDeprecated {
+    since: string;
+    removal: string;
+    replacement?: string;
+    reason?: string;
+}
 export interface SkillFrontmatter {
     name: string;
     description: string;
     license?: string;
     compatibility?: string;
     metadata?: Record<string, string>;
+    deprecated?: SkillDeprecated;
     disableModelInvocation?: boolean;
     userInvocable?: boolean;
     subtask?: boolean;
@@ -20,6 +27,7 @@ export interface SkillInfo {
     license?: string;
     compatibility?: string;
     metadata?: Record<string, string>;
+    deprecated?: SkillDeprecated;
     disableModelInvocation?: boolean;
     userInvocable?: boolean;
     subtask?: boolean;
@@ -28,6 +36,6 @@ export interface SkillInfo {
     argumentHint?: string;
     allowedTools?: string;
 }
-export declare const SKILL_FRONTMATTER_FIELDS: readonly ["name", "description", "argument-hint", "disable-model-invocation", "allowed-tools", "license", "compatibility", "metadata", "user-invocable", "agent", "model", "context", "subtask"];
+export declare const SKILL_FRONTMATTER_FIELDS: readonly ["name", "description", "argument-hint", "disable-model-invocation", "allowed-tools", "license", "compatibility", "metadata", "deprecated", "user-invocable", "agent", "model", "context", "subtask"];
 export declare function extractFrontmatter(filePath: string): SkillFrontmatter;
 export declare function findSkillsInDir(dir: string, maxDepth?: number): SkillInfo[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fro.bot/systematic",
-  "version": "2.18.0",
+  "version": "2.20.0",
   "description": "Structured engineering workflows for OpenCode",
   "type": "module",
   "homepage": "https://fro.bot/systematic",
@@ -65,8 +65,8 @@
   },
   "devDependencies": {
     "@biomejs/biome": "2.4.15",
-    "@opencode-ai/plugin": "1.14.50",
-    "@opencode-ai/sdk": "1.14.50",
+    "@opencode-ai/plugin": "1.15.0",
+    "@opencode-ai/sdk": "1.15.0",
     "@types/bun": "latest",
     "@types/js-yaml": "4.0.9",
     "@types/node": "24.12.4",

package/skills/claude-permissions-optimizer/SKILL.md

@@ -3,6 +3,10 @@ name: claude-permissions-optimizer
 context: fork
 description: Optimize Claude Code permissions by finding safe Bash commands from session history and auto-applying them to settings.json. Can run from any coding agent but targets Claude Code specifically. Use when experiencing permission fatigue, too many permission prompts, wanting to optimize permissions, or needing to set up allowlists. Triggers on "optimize permissions", "reduce permission prompts", "allowlist commands", "too many permission prompts", "permission fatigue", "permission setup", or complaints about clicking approve too often.
 subtask: true
+deprecated:
+  since: v2.19.0
+  removal: v3.0.0
+  reason: "Targets Claude Code's ~/.claude/settings.json allowlist mechanism. OpenCode uses a SQLite-backed session-scoped permission model with built-in always-persistence via the always button. No prompt-fatigue analog exists in OpenCode; there is no equivalent allowlist to optimize."
 ---
 
 # Claude Permissions Optimizer

package/skills/orchestrating-swarms/SKILL.md

@@ -2,6 +2,11 @@
 name: orchestrating-swarms
 description: Use when orchestrating multi-agent swarms, coordinating parallel code reviews, creating pipeline workflows with dependencies, building self-organizing task queues, or any task benefiting from divide-and-conquer patterns.
 disable-model-invocation: true
+deprecated:
+  since: v2.19.0
+  removal: v3.0.0
+  replacement: orchestrating-subagents
+  reason: "Documents the CEP Teammate API (TeammateTool, spawnTeam, TaskCreate/TaskList/TaskGet, team_name parameter on task(), CC subagent_type names). These primitives do not exist in OpenCode. A replacement skill will cover OpenCode-native parallel task() orchestration."
 ---
 
 # Swarm Orchestration

package/skills/using-systematic/SKILL.md

@@ -3,6 +3,10 @@ name: using-systematic
 description: Use when starting any conversation - establishes how to find and use skills, requiring skill tool invocation before ANY response including clarifying questions
 ---
 
+<SUBAGENT-STOP>
+If you were dispatched as a subagent to execute a specific task, skip this skill.
+</SUBAGENT-STOP>
+
 <EXTREMELY-IMPORTANT>
 If you think there is even a 1% chance a skill might apply to what you are doing, you ABSOLUTELY MUST invoke the skill.
 
@@ -11,6 +15,16 @@ IF A SKILL APPLIES TO YOUR TASK, YOU DO NOT HAVE A CHOICE. YOU MUST USE IT.
 This is not negotiable. This is not optional. You cannot rationalize your way out of this.
 </EXTREMELY-IMPORTANT>
 
+## Instruction Priority
+
+Systematic skills override default system prompt behavior, but **user instructions always take precedence**:
+
+1. **User's explicit instructions** (CLAUDE.md, GEMINI.md, AGENTS.md, direct requests) — highest priority
+2. **Systematic skills** — override default system behavior where they conflict
+3. **Default system prompt** — lowest priority
+
+If CLAUDE.md, GEMINI.md, or AGENTS.md says "don't use TDD" and a skill says "always use TDD," follow the user's instructions. The user is in control.
+
 ## How to Access Skills
 
 Use the `systematic_skill` tool for Systematic bundled skills. Use the `skill` tool for non-Systematic skills. When you invoke a skill, its content is loaded and presented to you—follow it directly.