fusion/plugins/fusion-plugin-compound-engineering/src/skills.ts

import type { PluginSkillContribution } from "@fusion/plugin-sdk";

/**
 * Compound Engineering pipeline-stage skills, bundled (pinned) inside the plugin.
 *
 * Each entry's `skillFiles` is plugin-root-relative and points at a `SKILL.md`
 * physically shipped under `src/skills/<skillId>/`. The bundled copy is a pinned
 * snapshot (KTD5) — never a symlink to the global compound-engineering cache —
 * so registering it can never clobber a user's global install (R12).
 *
 * The frontmatter `name` in each bundled SKILL.md equals the directory name
 * (e.g. `ce-brainstorm`), so `skillId === name` here. pi-coding-agent's
 * `loadSkills` derives `Skill.name` from that frontmatter, which is what the
 * engine skill-resolver matches against.
 */
export const COMPOUND_ENGINEERING_SKILLS: PluginSkillContribution[] = [
  {
    skillId: "ce-strategy",
    name: "ce-strategy",
    description:
      "Create or maintain STRATEGY.md — the product's target problem, approach, users, key metrics, and tracks of work.",
    skillFiles: ["skills/ce-strategy/SKILL.md"],
    enabled: true,
    triggerPatterns: ["strategy", "roadmap", "what are we working on", "set up the strategy doc"],
  },
  {
    skillId: "ce-ideate",
    name: "ce-ideate",
    description:
      "Generate and critically evaluate grounded ideas about a topic before committing to one direction.",
    skillFiles: ["skills/ce-ideate/SKILL.md"],
    enabled: true,
    triggerPatterns: ["ideate", "give me ideas", "what should I improve", "surprise me"],
  },
  {
    skillId: "ce-brainstorm",
    name: "ce-brainstorm",
    description:
      "Explore requirements and approaches through collaborative dialogue, then write a right-sized requirements document.",
    skillFiles: ["skills/ce-brainstorm/SKILL.md"],
    enabled: true,
    triggerPatterns: ["brainstorm", "what should we build", "help me think through"],
  },
  {
    skillId: "ce-plan",
    name: "ce-plan",
    description:
      "Create structured plans for multi-step tasks and optionally deepen existing plans via sub-agent review.",
    skillFiles: ["skills/ce-plan/SKILL.md"],
    enabled: true,
    triggerPatterns: ["plan this", "create a plan", "break this down", "deepen the plan"],
  },
  {
    skillId: "ce-work",
    name: "ce-work",
    description: "Execute work efficiently while maintaining quality and finishing features.",
    skillFiles: ["skills/ce-work/SKILL.md"],
    enabled: true,
    triggerPatterns: ["do the work", "implement", "execute the plan", "finish this feature"],
  },
  {
    /*
     * FNXC:CompoundEngineering 2026-06-27-00:00:
     * FN-7144 bundles ce-doc-review because ce-plan and ce-brainstorm invoke it as a named markdown document-review skill, and the built-in CE workflow now exposes it as an optional advisory stage after planning.
     */
    skillId: "ce-doc-review",
    name: "ce-doc-review",
    description:
      "Review CE markdown plan documents for coherence, feasibility, scope alignment, and safe markdown-only fixes.",
    skillFiles: ["skills/ce-doc-review/SKILL.md"],
    enabled: true,
    triggerPatterns: ["doc review", "document review", "review the plan", "pressure-test the requirements"],
  },
  {
    skillId: "ce-code-review",
    name: "ce-code-review",
    description:
      "Structured code review using tiered persona agents, confidence-gated findings, and a merge/dedup pipeline.",
    skillFiles: ["skills/ce-code-review/SKILL.md"],
    enabled: true,
    triggerPatterns: ["code review", "review this change", "review before PR"],
  },
  {
    /*
     * FNXC:CompoundEngineering 2026-06-16-19:40:
     * ce-debug is bundled beside the other pinned CE skills so bug-shaped investigation sessions install from the plugin-local snapshot and never depend on an operator's global skill cache.
     */
    skillId: "ce-debug",
    name: "ce-debug",
    description:
      "Investigate bug-shaped work by reproducing failures, testing hypotheses, isolating root cause, and producing findings before implementation.",
    skillFiles: ["skills/ce-debug/SKILL.md"],
    enabled: true,
    triggerPatterns: ["debug", "investigate a bug", "root cause", "regression", "broken behavior", "error message"],
  },
  {
    skillId: "ce-compound",
    name: "ce-compound",
    description:
      "Document a recently solved problem to compound the team's knowledge or the project's shared CONCEPTS.md vocabulary.",
    skillFiles: ["skills/ce-compound/SKILL.md"],
    enabled: true,
    triggerPatterns: ["compound this", "document this learning", "capture this solution"],
  },
  {
    skillId: "ce-commit",
    name: "ce-commit",
    description:
      "Create a git commit with a clear, value-communicating message following repo conventions.",
    skillFiles: ["skills/ce-commit/SKILL.md"],
    enabled: true,
    triggerPatterns: ["commit", "commit this", "save my changes", "create a commit"],
  },
  {
    skillId: "ce-commit-push-pr",
    name: "ce-commit-push-pr",
    description:
      "Commit, push, and open a PR with an adaptive, value-first description that scales with the change.",
    skillFiles: ["skills/ce-commit-push-pr/SKILL.md"],
    enabled: true,
    triggerPatterns: ["commit and PR", "ship this", "create a PR", "open a pull request"],
  },
  {
    skillId: "ce-resolve-pr-feedback",
    name: "ce-resolve-pr-feedback",
    description:
      "Resolve PR review feedback by evaluating validity and fixing issues in parallel.",
    skillFiles: ["skills/ce-resolve-pr-feedback/SKILL.md"],
    enabled: true,
    triggerPatterns: ["resolve PR feedback", "address review comments", "fix review feedback"],
  },
];