Skip to content

feat(fix-root-causes): add fix-root-causes guardrail skill plugin - #70

Open
yifu001 wants to merge 1 commit into
Factory-AI:masterfrom
yifu001:feat/fix-root-causes
Open

yifu001 wants to merge 1 commit into
Factory-AI:masterfrom
yifu001:feat/fix-root-causes

Conversation

@yifu001

@yifu001 yifu001 commented Oct 29, 2026

Copy link
Copy Markdown

Part of a 10-PR series contributing the agent-guardrail skill stack (prove-it-works, blast-radius, fix-root-causes, subtract-before-you-add, correct, interrogate, show-me-your-work, create-verification-skill, maintain-verification-skill, property-based-testing). Each PR is independent, adds exactly one single-skill plugin, and can be reviewed and merged in any order; adjacent additions to marketplace.json / README.md may show trivial conflicts with sibling PRs.

What

Adds the fix-root-causes plugin: a debugging guardrail that traces each symptom back to the first place the system went wrong and fixes it there. A guard counts as a fix only when the state it handles is legitimate; otherwise the guard hides the bug.

Why

The marketplace ships code-review, security, and runtime-verification guardrails (droid-control's /verify), but nothing covering behavioral verification discipline for the agent itself. This stack was built and battle-tested in a hackathon repo's quality gates; we are contributing it back.

Provenance and license

Adapted from the pstack skills by Lauren Tan (cursor/plugins, MIT License, commit c742dd6), with Cursor-specific machinery removed and Droid conventions applied. Made model-invocable so Droid applies it proactively.

Checklist

  • Plugin under plugins/fix-root-causes/ with .factory-plugin/plugin.json
  • Skill directory symlinked into skills/ (per the check-skills CI)
  • .factory-plugin/marketplace.json entry added
  • README "Available Plugins" section added
  • No name collision with existing marketplace skills or Droid built-in skills

Debugging guardrail: trace each symptom back to the first place the
system went wrong and fix it there, instead of patching the symptom.

Adapted from the pstack skills (MIT, (c) Lauren Tan,
https://github.com/cursor/plugins), Cursor-specific tooling removed.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant