Name: xfi-create-plugin
Author: zotoio

Prompt file imported from zotoio/x-fidelity (.cursor/commands/xfi-create-plugin.md). Copyright stays with the author.

xfi-create-plugin

Create a new X-Fidelity analysis plugin with facts, operators, tests, and sample rules.

Instructions

This command uses:

Skill: Read and follow the xfi-create-plugin skill at .cursor/skills/xfi-create-plugin/SKILL.md
Subagent: Use xfi-plugin-expert for architecture guidance and implementation details

Workflow

Read the skill file to get the step-by-step plugin creation guide
Gather requirements from the user:
- What should the plugin analyze?
- What data should the fact(s) collect?
- What comparisons should the operator(s) perform?
- Is this for iterative (per-file) or global (repo-wide) analysis?
Use xfi-plugin-expert subagent for:
- Plugin architecture guidance
- AST analysis patterns (if needed)
- Best practices for fact/operator implementation

Create the plugin structure:

packages/x-fidelity-plugins/src/xfiPlugin{Name}/
├── index.ts                  # Plugin definition
├── types.ts                  # Plugin-specific types (optional)
├── facts/
│   ├── {name}Fact.ts         # Fact implementation
│   └── {name}Fact.test.ts    # Fact tests
├── operators/
│   ├── {name}Operator.ts     # Operator implementation
│   └── {name}Operator.test.ts # Operator tests
└── sampleRules/
    └── {name}-rule.json      # Example rule

Register the plugin in packages/x-fidelity-plugins/src/index.ts

Run tests to verify:

yarn workspace @x-fidelity/plugins test
yarn test

Plugin Checklist

Plugin Creation Progress:
- [ ] Step 1: Create plugin directory structure
- [ ] Step 2: Create plugin index.ts
- [ ] Step 3: Create fact(s)
- [ ] Step 4: Create operator(s)
- [ ] Step 5: Add tests for facts and operators
- [ ] Step 6: Create sample rule(s)
- [ ] Step 7: Register plugin in main index
- [ ] Step 8: Run tests to verify

Key References

Template plugin: packages/x-fidelity-plugins/src/xfiPluginSimpleExample/
Plugin types: packages/x-fidelity-types/src/plugins.ts
Shared utils: packages/x-fidelity-plugins/src/sharedPluginUtils/
Plugin registry: packages/x-fidelity-plugins/src/index.ts

Requirements

100% test coverage for all facts and operators
Graceful error handling (return safe defaults on error)
Use pluginLogger for debugging information
Include working sample rules demonstrating usage

Install xfi-create-plugin and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

# xfi-create-plugin Create a new X-Fidelity analysis plugin with facts, operators, tests, and sample rules. ## Instructions This command uses: - **Skill**: Read and follow the `xfi-create-plugin` skill at `.cursor/skills/xfi-create-plugin/SKILL.md` - **Subagent**: Use `xfi-plugin-expert` for architecture guidance and implementation details ## Workflow 1. **Read the skill file** to get the step-by-step plugin creation guide 2. **Gather requirements** from the user: - What should the plugin analyze? - What data should the fact(s) collect? - What comparisons should the operator(s) perform? - Is this for iterative (per-file) or global (repo-wide) analysis? 3. **Use xfi-plugin-expert subagent** for: - Plugin architecture guidance - AST analysis patterns (if needed) - Best practices for fact/operator implementation 4. **Create the plugin structure**: ``` packages/x-fidelity-plugins/src/xfiPlugin{Name}/ ├── index.ts # Plugin definition ├── types.ts # Plugin-specific types (optional) ├── facts/ │ ├── {name}Fact.ts # Fact implementation │ └── {name}Fact.test.ts # Fact tests ├── operators/ │ ├── {name}Operator.ts # Operator implementation │ └── {name}Operator.test.ts # Operator tests └── sampleRules/ └── {name}-rule.json # Example rule ``` 5. **Register the plugin** in `packages/x-fidelity-plugins/src/index.ts` 6. **Run tests** to verify: ```bash yarn workspace @x-fidelity/plugins test yarn test ``` ## Plugin Checklist ``` Plugin Creation Progress: - [ ] Step 1: Create plugin directory structure - [ ] Step 2: Create plugin index.ts - [ ] Step 3: Create fact(s) - [ ] Step 4: Create operator(s) - [ ] Step 5: Add tests for facts and operators - [ ] Step 6: Create sample rule(s) - [ ] Step 7: Register plugin in main index - [ ] Step 8: Run tests to verify ``` ## Key References - Template plugin: `packages/x-fidelity-plugins/src/xfiPluginSimpleExample/` - Plugin types: `packages/x-fidelity-types/src/plugins.ts` - Shared utils: `packages/x-fidelity-plugins/src/sharedPluginUtils/` - Plugin registry: `packages/x-fidelity-plugins/src/index.ts` ## Requirements - 100% test coverage for all facts and operators - Graceful error handling (return safe defaults on error) - Use `pluginLogger` for debugging information - Include working sample rules demonstrating usage

{ "prompt": "# xfi-create-plugin\n\nCreate a new X-Fidelity analysis plugin with facts, operators, tests, and sample rules.\n\n## Instructions\n\nThis command uses:\n- **Skill**: Read and follow the `xfi-create-plugin` skill at `.cursor/skills/xfi-create-plugin/SKILL.md`\n- **Subagent**: Use `xfi-plugin-expert` for architecture guidance and implementation details\n\n## Workflow\n\n1. **Read the skill file** to get the step-by-step plugin creation guide\n2. **Gather requirements** from the user:\n - What should the plugin analyze?\n - What data should the fact(s) collect?\n - What comparisons should the operator(s) perform?\n - Is this for iterative (per-file) or global (repo-wide) analysis?\n\n3. **Use xfi-plugin-expert subagent** for:\n - Plugin architecture guidance\n - AST analysis patterns (if needed)\n - Best practices for fact/operator implementation\n\n4. **Create the plugin structure**:\n ```\n packages/x-fidelity-plugins/src/xfiPlugin{Name}/\n ├── index.ts # Plugin definition\n ├── types.ts # Plugin-specific types (optional)\n ├── facts/\n │ ├── {name}Fact.ts # Fact implementation\n │ └── {name}Fact.test.ts # Fact tests\n ├── operators/\n │ ├── {name}Operator.ts # Operator implementation\n │ └── {name}Operator.test.ts # Operator tests\n └── sampleRules/\n └── {name}-rule.json # Example rule\n ```\n\n5. **Register the plugin** in `packages/x-fidelity-plugins/src/index.ts`\n\n6. **Run tests** to verify:\n ```bash\n yarn workspace @x-fidelity/plugins test\n yarn test\n ```\n\n## Plugin Checklist\n\n```\nPlugin Creation Progress:\n- [ ] Step 1: Create plugin directory structure\n- [ ] Step 2: Create plugin index.ts\n- [ ] Step 3: Create fact(s)\n- [ ] Step 4: Create operator(s)\n- [ ] Step 5: Add tests for facts and operators\n- [ ] Step 6: Create sample rule(s)\n- [ ] Step 7: Register plugin in main index\n- [ ] Step 8: Run tests to verify\n```\n\n## Key References\n\n- Template plugin: `packages/x-fidelity-plugins/src/xfiPluginSimpleExample/`\n- Plugin types: `packages/x-fidelity-types/src/plugins.ts`\n- Shared utils: `packages/x-fidelity-plugins/src/sharedPluginUtils/`\n- Plugin registry: `packages/x-fidelity-plugins/src/index.ts`\n\n## Requirements\n\n- 100% test coverage for all facts and operators\n- Graceful error handling (return safe defaults on error)\n- Use `pluginLogger` for debugging information\n- Include working sample rules demonstrating usage", "variables": [], "notes": "Create a new X-Fidelity analysis plugin with facts, operators, tests, and sample rules.", "metadata": { "source": { "provider": "github-cursor-commands", "repository": "https://github.com/zotoio/x-fidelity", "path": ".cursor/commands/xfi-create-plugin.md", "ref": "fd6cfd9335ecefc6f0a00b186f542de1a05cd7ad", "url": "https://github.com/zotoio/x-fidelity/blob/fd6cfd9335ecefc6f0a00b186f542de1a05cd7ad/.cursor/commands/xfi-create-plugin.md", "key": "zotoio/x-fidelity/.cursor/commands/xfi-create-plugin.md" } } }

xfi-create-plugin

About