@fro.bot/systematic 2.15.0 → 2.17.0

package/ATTRIBUTIONS.md

@@ -0,0 +1,108 @@
+# Attributions
+
+Systematic ships bundled skills and agents adapted from third-party sources. This file records the provenance, license, and pin point for each derivative work in the published package.
+
+## License Conventions
+
+Bundled skills and agents may declare a `license:` field in their YAML frontmatter to communicate their licensing origin. When this field is **present**, it reflects the upstream source's license — these files are derivative works adapted from clearly identified projects. When this field is **absent**, the file is unspecified Systematic-originated content, not "proprietary" or "unlicensed." Treat absence as "no upstream attribution required," not as a missing legal notice.
+
+The full repository license is in `LICENSE` at the repository root.
+
+## obra/superpowers — MIT
+
+**Source repository:** [`obra/superpowers`](https://github.com/obra/superpowers)
+**Pinned commit:** `f2cbfbefebbfef77321e4c9abc9e949826bea9d7` (tag `v5.1.0`)
+**License:** MIT
+**Copyright:** Copyright (c) 2025 Jesse Vincent
+**Cloned at:** `.slim/clonedeps/repos/obra__superpowers/` (development inspection only; not shipped)
+
+### Files derived
+
+The following bundled skills are adaptations of the upstream `obra/superpowers` source:
+
+- `skills/test-driven-development/SKILL.md`
+- `skills/test-driven-development/references/testing-anti-patterns.md`
+- `skills/writing-skills/SKILL.md`
+- `skills/writing-skills/references/persuasion-principles.md`
+- `skills/writing-skills/references/graphviz-conventions.dot`
+- `skills/writing-skills/references/testing-skills-with-subagents.md`
+- `skills/writing-skills/references/examples/skill-testing-walkthrough.md` (renamed from upstream's `examples/CLAUDE_MD_TESTING.md`)
+- `skills/writing-skills/scripts/render-graphs.js`
+
+The two `SKILL.md` files (`skills/test-driven-development/SKILL.md` and `skills/writing-skills/SKILL.md`) carry `license: MIT` in their frontmatter to make the licensing inheritance explicit at the file level. The reference files, script, and graphviz definition inherit MIT licensing from this attribution file — frontmatter `license:` is a YAML-only convention.
+
+### Adaptation notes
+
+- Adaptation was light: rewrote upstream's `@filename` force-load syntax to repo-local `references/` paths; rewrote `superpowers:<skill-name>` namespace cross-references to bare names (matching Systematic's runtime convention where the `systematic:` prefix is applied at load time); swapped `~/.claude/skills` path mentions to the canonical OpenCode path `~/.agents/skills/`; renamed the `CLAUDE_MD_TESTING.md` worked example to `skill-testing-walkthrough.md` to fit Systematic's descriptive-filename convention.
+- Per-file copyright comments are deliberately omitted. Frontmatter `license: MIT` plus this attribution file constitute the full attribution surface.
+- These files are load-bearing for `ce:work`, `ce:plan`, and `writing-systematic-skills` cross-references. Future contributors editing them should preserve the discipline-enforcing prose (e.g., the Iron Law, the rationalization tables, the RED-GREEN-REFACTOR cycle).
+
+### Future refresh discipline
+
+Future upstream refreshes from `obra/superpowers` are explicit human-reviewed events, not automatic syncs. Bumping the pinned commit requires re-running the adaptation pass and re-validating the two-layer originality check for the Anthropic-distilled reference (see below). The pinned commit above is the stable source-of-truth for the currently-shipped versions.
+
+### Upstream MIT license text
+
+The following is the full MIT license text from `obra/superpowers@v5.1.0`, reproduced here in compliance with the MIT license's notice requirements:
+
+```
+MIT License
+
+Copyright (c) 2025 Jesse Vincent
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
+## Anthropic — CC-BY-4.0
+
+**Source page:** [Skill authoring best practices](https://docs.claude.com/en/docs/agents-and-tools/agent-skills/best-practices)
+**License:** [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/) (Creative Commons Attribution 4.0 International). The distilled file is a **modified derivative work** of Anthropic's source under the CC-BY-4.0 grant — reorganized by Systematic-relevant authoring tasks (per the Distillation Outline below) rather than mirroring the upstream document structure.
+**Publisher:** Anthropic
+**Retrieved:** 2026-05-17
+
+### File derived
+
+- `skills/writing-skills/references/anthropic-best-practices-distilled.md`
+
+This file is a distillation of Anthropic's published Skills authoring guidance. CC-BY-4.0 permits derivative works with attribution; this file's first paragraph carries the attribution line and source URL.
+
+### Distillation Outline
+
+The distilled file is organized around 6 Systematic-relevant authoring tasks rather than mirroring upstream's section structure. This ordering and category list is the authoritative outline for any future re-distillation pass:
+
+1. **Triggering Skills Through Precise Descriptions** — when to use this skill / when not / triggering language patterns. Source signal: upstream's "Writing effective descriptions" section.
+2. **Organizing Content for Progressive Disclosure** — when to inline content vs split into `references/`, how to keep SKILL.md scannable, naming conventions. Source signal: upstream's "Progressive disclosure patterns" and "Avoid deeply nested references" sections.
+3. **Writing Concise Prose** — what to cut, what to keep, how to balance detail vs. agent context budget. Source signal: upstream's "Concise is key" + "Core principles" sections.
+4. **Matching Skill Rigidity to Task Variance** — when skills are prescriptive vs flexible, how to match skill rigidity to task variance. Source signal: upstream's "Set appropriate degrees of freedom" section.
+5. **Testing Skills Through Evaluation** — how to test that a skill changes agent behavior, evaluation patterns, falsifiable success criteria. Source signal: upstream's evaluation-related content (scattered, not in one named section).
+6. **Common Content Patterns and Naming** — naming conventions, file structure conventions, when to use code examples vs prose. Source signal: upstream's "Naming conventions" + "Skill structure" sections.
+
+**Wholesale drops** (not included in the distillation): model-specific testing matrix; advanced executable-code patterns (PDF processing, BigQuery, DOCX); MCP-tool-specific references; package dependency guidance; runtime environment guidance; YAML technical reference notes; Anthropic compliance / checklist sections; marketing-card / cross-link footers.
+
+**Acceptance bar applied at distillation time:**
+
+- Size in 3500–6000 bytes.
+- CC-BY-4.0 attribution + `docs.claude.com` link in first 3 lines.
+- Zero 1:1 heading matches with upstream.
+- Heading sequence does not map 1:1 to upstream order.
+- No paragraph contains a >120-character contiguous substring shared with upstream.
+- At least 2 Systematic-specific organizing categories introduced (4 confirmed: triggering, freedom, evaluation, patterns).
+- At least 3 upstream topic areas dropped wholesale (8 confirmed; see drops above).
+
+If Anthropic's source page is restructured or relocated after this attribution date, the retrieval date above plus the page title triangulate the canonical replacement.

package/dist/cli.js

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

package/dist/{index-6xnehr4s.js → index-f90kjf1c.js}

@@ -15831,11 +15831,13 @@ var BUNDLED_SKILL_NAMES = [
   "setup",
   "slfg",
   "test-browser",
+  "test-driven-development",
   "test-xcode",
   "todo-create",
   "todo-resolve",
   "todo-triage",
   "using-systematic",
+  "writing-skills",
   "writing-systematic-skills"
 ];
 
@@ -15961,53 +15963,63 @@ var BootstrapSchema = exports_external.object({
   description: "Bootstrap prompt configuration",
   examples: [{ enabled: true }, { enabled: false }]
 });
-var SystematicConfigSchema = exports_external.object({
-  $schema: exports_external.string().url().optional().meta({
-    description: "JSON Schema URL for IDE autocomplete. The value is informational only \u2014 the loader does not fetch or validate against it. Add this to enable IDE schema activation and field-level autocomplete in editors that support JSON Schema (VSCode, Zed, IntelliJ).",
-    examples: [
-      "https://fro.bot/systematic/schemas/v2/systematic-config.schema.json"
-    ]
-  }),
-  agents: exports_external.object(Object.fromEntries([...BUNDLED_AGENT_NAMES, ...BUNDLED_AGENT_QUALIFIED_IDS].map((name) => [name, AgentOverlaySchema.optional()]))).strict().default({}).meta({
-    description: "Per-agent configuration overlays keyed by bundled agent name (bare or qualified category/name). Unknown keys are rejected with a Zod parse error. To overlay a user-defined agent, configure it through OpenCode-native config (.opencode/opencode.json) instead.",
-    examples: [
-      { "correctness-reviewer": { temperature: 0.1 } },
-      { "review/correctness-reviewer": { temperature: 0.1 } },
-      {}
-    ]
-  }),
-  categories: exports_external.record(exports_external.string(), CategoryOverlaySchema).default({}).meta({
-    description: "Per-category configuration overlays keyed by category name",
-    examples: [{ review: { model: "anthropic/claude-opus-4-7" } }, {}]
-  }),
-  disabled_skills: exports_external.array(exports_external.enum(BUNDLED_SKILL_NAMES)).default([]).meta({
-    description: "Array of bundled skill names to disable globally. Unknown skill names are rejected at parse time.",
-    examples: [["ce:plan", "ce:review"]]
-  }),
-  disabled_agents: exports_external.array(exports_external.enum([
-    ...BUNDLED_AGENT_NAMES,
-    ...BUNDLED_AGENT_QUALIFIED_IDS
-  ])).default([]).meta({
-    description: "Array of bundled agent names (bare or qualified category/name) to disable globally. Unknown agent names are rejected at parse time.",
-    examples: [
-      ["previous-comments-reviewer", "cli-readiness-reviewer"],
-      ["review/security-reviewer"]
-    ]
-  }),
-  disabled_commands: exports_external.array(exports_external.string()).default([]).meta({
-    description: "Array of command names to disable globally",
-    examples: [["deprecated-migration-helper"]]
-  }),
-  bootstrap: BootstrapSchema.default({ enabled: true }).meta({
-    description: "Bootstrap prompt configuration",
+function createSystematicConfigSchema(opts) {
+  const { agentNames, qualifiedAgentIds, skillNames } = opts;
+  return exports_external.object({
+    $schema: exports_external.string().url().optional().meta({
+      description: "JSON Schema URL for IDE autocomplete. The value is informational only \u2014 the loader does not fetch or validate against it. Add this to enable IDE schema activation and field-level autocomplete in editors that support JSON Schema (VSCode, Zed, IntelliJ).",
+      examples: [
+        "https://fro.bot/systematic/schemas/v2/systematic-config.schema.json"
+      ]
+    }),
+    agents: exports_external.object(Object.fromEntries([...agentNames, ...qualifiedAgentIds].map((name) => [
+      name,
+      AgentOverlaySchema.optional()
+    ]))).strict().default({}).meta({
+      description: "Per-agent configuration overlays keyed by bundled agent name (bare or qualified category/name). Unknown keys are rejected with a Zod parse error. To overlay a user-defined agent, configure it through OpenCode-native config (.opencode/opencode.json) instead.",
+      examples: [
+        { "correctness-reviewer": { temperature: 0.1 } },
+        { "review/correctness-reviewer": { temperature: 0.1 } },
+        {}
+      ]
+    }),
+    categories: exports_external.record(exports_external.string(), CategoryOverlaySchema).default({}).meta({
+      description: "Per-category configuration overlays keyed by category name",
+      examples: [{ review: { model: "anthropic/claude-opus-4-7" } }, {}]
+    }),
+    disabled_skills: exports_external.array(exports_external.enum(skillNames)).default([]).meta({
+      description: "Array of bundled skill names to disable globally. Unknown skill names are rejected at parse time.",
+      examples: [["ce:plan", "ce:review"]]
+    }),
+    disabled_agents: exports_external.array(exports_external.enum([...agentNames, ...qualifiedAgentIds])).default([]).meta({
+      description: "Array of bundled agent names (bare or qualified category/name) to disable globally. Unknown agent names are rejected at parse time.",
+      examples: [
+        ["previous-comments-reviewer", "cli-readiness-reviewer"],
+        ["review/security-reviewer"]
+      ]
+    }),
+    disabled_commands: exports_external.array(exports_external.string()).default([]).meta({
+      description: "Array of command names to disable globally",
+      examples: [["deprecated-migration-helper"]]
+    }),
+    bootstrap: BootstrapSchema.default({ enabled: true }).meta({
+      description: "Bootstrap prompt configuration",
+      examples: [
+        { enabled: true },
+        { enabled: false, file: ".opencode/custom-prompt.md" }
+      ]
+    })
+  }).strict().meta({
+    description: "Systematic user configuration file (systematic.json / systematic.jsonc)",
     examples: [
-      { enabled: true },
-      { enabled: false, file: ".opencode/custom-prompt.md" }
+      { disabled_skills: ["ce:plan"], bootstrap: { enabled: false } }
     ]
-  })
-}).strict().meta({
-  description: "Systematic user configuration file (systematic.json / systematic.jsonc)",
-  examples: [{ disabled_skills: ["ce:plan"], bootstrap: { enabled: false } }]
+  });
+}
+var SystematicConfigSchema = createSystematicConfigSchema({
+  agentNames: BUNDLED_AGENT_NAMES,
+  qualifiedAgentIds: BUNDLED_AGENT_QUALIFIED_IDS,
+  skillNames: BUNDLED_SKILL_NAMES
 });
 var SECURITY_OVERLAY_FIELDS = [
   "model",
@@ -16064,21 +16076,55 @@ var TYPED_KEY_FIELDS = new Set([
   "disabled_agents",
   "disabled_skills"
 ]);
-function enrichUnrecognizedKeyIssues(issues) {
+function formatUnrecognizedKeysHint(badKeys, topField) {
+  if (badKeys.length === 0) {
+    throw new Error("formatUnrecognizedKeysHint requires non-empty keys");
+  }
+  if (badKeys.length === 1) {
+    return `Unrecognized key '${badKeys[0]}' in \`${topField}\`. This must be a bundled name. See ${TYPED_VALIDATION_DOCS_URL} for the full list of valid names.`;
+  }
+  const joined = badKeys.map((k) => `'${k}'`).join(", ");
+  return `Unrecognized keys ${joined} in \`${topField}\`. These must be bundled names. See ${TYPED_VALIDATION_DOCS_URL} for the full list of valid names.`;
+}
+function enrichUnrecognizedKeyIssues(issues, rawInput) {
   return issues.map((issue2) => {
-    if (issue2.code !== "unrecognized_keys")
-      return issue2;
     const topField = issue2.path[0];
     if (typeof topField !== "string" || !TYPED_KEY_FIELDS.has(topField)) {
       return issue2;
     }
-    const badKey = issue2.message.match(/"([^"]+)"/)?.[1] ?? "";
-    const hint = badKey ? `Unrecognized key '${badKey}' in \`${topField}\`. This must be a bundled name. See ${TYPED_VALIDATION_DOCS_URL} for the full list of valid names.` : `${issue2.message} See ${TYPED_VALIDATION_DOCS_URL} for the full list of valid names.`;
-    return { ...issue2, message: hint };
+    if (issue2.code === "unrecognized_keys") {
+      const hint = formatUnrecognizedKeysHint(issue2.keys, topField);
+      return { ...issue2, message: hint };
+    }
+    if (issue2.code === "invalid_value" && (topField === "disabled_agents" || topField === "disabled_skills")) {
+      const badValue = resolveValueAtPath(rawInput, issue2.path);
+      const kind = topField === "disabled_agents" ? "agent" : "skill";
+      const hint = typeof badValue === "string" ? `Unrecognized ${kind} name '${badValue}' in \`${topField}\`. This must be a bundled name. See ${TYPED_VALIDATION_DOCS_URL} for the full list of valid names.` : `Invalid value in \`${topField}\`. See ${TYPED_VALIDATION_DOCS_URL} for the full list of valid names.`;
+      return { ...issue2, message: hint };
+    }
+    return issue2;
   });
 }
-function throwTopLevelConfigSchemaError(filePath, trust, rawIssues) {
-  const issues = enrichUnrecognizedKeyIssues(rawIssues);
+function resolveValueAtPath(root, path4) {
+  let current = root;
+  for (const segment of path4) {
+    if (typeof segment === "symbol") {
+      return;
+    }
+    if (typeof segment === "number") {
+      if (!Array.isArray(current))
+        return;
+      current = current[segment];
+    } else {
+      if (!isRecord2(current))
+        return;
+      current = current[segment];
+    }
+  }
+  return current;
+}
+function throwTopLevelConfigSchemaError(filePath, trust, rawIssues, rawInput) {
+  const issues = enrichUnrecognizedKeyIssues(rawIssues, rawInput);
   const issue2 = issues[0];
   if (!issue2) {
     throw Object.assign(new Error(`Invalid Systematic config in ${filePath}: schema validation failed`), { _tag: "ConfigSchemaError", filePath, trust, issues });
@@ -16098,7 +16144,7 @@ function loadConfigSource(filePath, trust) {
     return null;
   const result = SystematicConfigSchema.safeParse(rawConfig);
   if (!result.success) {
-    throwTopLevelConfigSchemaError(filePath, trust, result.error.issues);
+    throwTopLevelConfigSchemaError(filePath, trust, result.error.issues, rawConfig);
   }
   return { path: filePath, config: rawConfig, trust };
 }

package/dist/index.js

@@ -13,7 +13,7 @@ import {
   loadConfig,
   loadConfigWithSources,
   parseFrontmatter
-} from "./index-6xnehr4s.js";
+} from "./index-f90kjf1c.js";
 
 // src/index.ts
 import fs5 from "fs";

package/dist/lib/bundled-names.d.ts

@@ -1,5 +1,5 @@
 export declare const BUNDLED_AGENT_NAMES: readonly ["adversarial-document-reviewer", "adversarial-reviewer", "agent-native-reviewer", "ankane-readme-writer", "api-contract-reviewer", "architecture-strategist", "best-practices-researcher", "bug-reproduction-validator", "cli-agent-readiness-reviewer", "cli-readiness-reviewer", "code-simplicity-reviewer", "coherence-reviewer", "correctness-reviewer", "data-integrity-guardian", "data-migration-expert", "data-migrations-reviewer", "deployment-verification-agent", "design-implementation-reviewer", "design-iterator", "design-lens-reviewer", "dhh-rails-reviewer", "feasibility-reviewer", "figma-design-sync", "framework-docs-researcher", "git-history-analyzer", "issue-intelligence-analyst", "julik-frontend-races-reviewer", "kieran-python-reviewer", "kieran-rails-reviewer", "kieran-typescript-reviewer", "learnings-researcher", "lint", "maintainability-reviewer", "pattern-recognition-specialist", "performance-oracle", "performance-reviewer", "pr-comment-resolver", "previous-comments-reviewer", "product-lens-reviewer", "project-standards-reviewer", "reliability-reviewer", "repo-research-analyst", "schema-drift-detector", "scope-guardian-reviewer", "security-lens-reviewer", "security-reviewer", "security-sentinel", "slack-researcher", "spec-flow-analyzer", "systematic-implementer", "testing-reviewer"];
 export declare const BUNDLED_AGENT_QUALIFIED_IDS: readonly ["design/design-implementation-reviewer", "design/design-iterator", "design/figma-design-sync", "docs/ankane-readme-writer", "document-review/adversarial-document-reviewer", "document-review/coherence-reviewer", "document-review/design-lens-reviewer", "document-review/feasibility-reviewer", "document-review/product-lens-reviewer", "document-review/scope-guardian-reviewer", "document-review/security-lens-reviewer", "research/best-practices-researcher", "research/framework-docs-researcher", "research/git-history-analyzer", "research/issue-intelligence-analyst", "research/learnings-researcher", "research/repo-research-analyst", "research/slack-researcher", "review/adversarial-reviewer", "review/agent-native-reviewer", "review/api-contract-reviewer", "review/architecture-strategist", "review/cli-agent-readiness-reviewer", "review/cli-readiness-reviewer", "review/code-simplicity-reviewer", "review/correctness-reviewer", "review/data-integrity-guardian", "review/data-migration-expert", "review/data-migrations-reviewer", "review/deployment-verification-agent", "review/dhh-rails-reviewer", "review/julik-frontend-races-reviewer", "review/kieran-python-reviewer", "review/kieran-rails-reviewer", "review/kieran-typescript-reviewer", "review/maintainability-reviewer", "review/pattern-recognition-specialist", "review/performance-oracle", "review/performance-reviewer", "review/previous-comments-reviewer", "review/project-standards-reviewer", "review/reliability-reviewer", "review/schema-drift-detector", "review/security-reviewer", "review/security-sentinel", "review/testing-reviewer", "workflow/bug-reproduction-validator", "workflow/lint", "workflow/pr-comment-resolver", "workflow/spec-flow-analyzer", "workflow/systematic-implementer"];
-export declare const BUNDLED_SKILL_NAMES: readonly ["agent-browser", "agent-native-architecture", "agent-native-audit", "andrew-kane-gem-writer", "ce:brainstorm", "ce:compound", "ce:compound-refresh", "ce:ideate", "ce:plan", "ce:review", "ce:work", "changelog", "claude-permissions-optimizer", "compound-docs", "deepen-plan", "deploy-docs", "dhh-rails-style", "document-review", "dspy-ruby", "every-style-editor", "feature-video", "frontend-design", "gemini-imagegen", "generate_command", "git-clean-gone-branches", "git-commit", "git-commit-push-pr", "git-worktree", "lfg", "onboarding", "orchestrating-swarms", "proof", "rclone", "report-bug-ce", "reproduce-bug", "resolve-pr-feedback", "setup", "slfg", "test-browser", "test-xcode", "todo-create", "todo-resolve", "todo-triage", "using-systematic", "writing-systematic-skills"];
+export declare const BUNDLED_SKILL_NAMES: readonly ["agent-browser", "agent-native-architecture", "agent-native-audit", "andrew-kane-gem-writer", "ce:brainstorm", "ce:compound", "ce:compound-refresh", "ce:ideate", "ce:plan", "ce:review", "ce:work", "changelog", "claude-permissions-optimizer", "compound-docs", "deepen-plan", "deploy-docs", "dhh-rails-style", "document-review", "dspy-ruby", "every-style-editor", "feature-video", "frontend-design", "gemini-imagegen", "generate_command", "git-clean-gone-branches", "git-commit", "git-commit-push-pr", "git-worktree", "lfg", "onboarding", "orchestrating-swarms", "proof", "rclone", "report-bug-ce", "reproduce-bug", "resolve-pr-feedback", "setup", "slfg", "test-browser", "test-driven-development", "test-xcode", "todo-create", "todo-resolve", "todo-triage", "using-systematic", "writing-skills", "writing-systematic-skills"];
 export type BundledAgentName = (typeof BUNDLED_AGENT_NAMES)[number];
 export type BundledSkillName = (typeof BUNDLED_SKILL_NAMES)[number];