Operation Plugin Reference
Developmentoperation-plugin-referenceOperation Plugin Reference is an Agent Skill for development published in the erxes/erxes repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Apply erxes operation plugin conventions from operation_ui and operation_api. Use when creating or refactoring plugin features, backend entities, cursor tables, GraphQL/Apollo flows, Module Federation entries, permissions, notifications, or rules based on the repository's preferred operation plugin patterns.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/erxes/erxes/blob/HEAD/.agents/skills/operation-plugin-reference/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/operation-plugin-reference, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Skill: Operation Plugin Reference
Workflow
- Read
.agents/rules/operation-plugin-reference.md. - Identify whether the task is closest to operation
task,project,cycle,triage,team,template, oractivity. - Open the matching files in
frontend/plugins/operation_uiorbackend/plugins/operation_api. - Copy the pattern, not the code. Keep plugin boundaries intact.
- Keep feature internals near the feature: components, hooks, GraphQL, state, types, constants, schemas, models, and resolvers.
- Apply the current repo rules even when old operation files are inconsistent:
new GraphQL operation names must be unique and prefixed, and new backend
schemas must not use
schemaWrapper. - Validate with the owning Nx project.
Frontend Checklist
- Use
src/pagesfor route-level wrappers only when the plugin follows that split. - Put reusable feature UI under
src/modules/<feature>/components. - Put Apollo hooks under
src/modules/<feature>/hooks. - Put GraphQL documents under feature-local
graphql/queries,graphql/mutations, orgraphql/subscriptions. - Use
RecordTablecursor patterns for list/table screens. - Keep list, board, detail, count, progress, and selector data current after mutations through cache updates, refetches, or operation-style subscriptions.
- Use URL query state for filters and Jotai only for shared page UI state.
- Keep Module Federation exposes host-facing and small.
Backend Checklist
- Put schemas in
db/definitionsand model/static methods indb/models. - Define schemas with
new Schema(...), explicit fields, and timestamps when needed. - Keep resolvers thin and call
checkPermissionfirst. - Use
cursorPaginatefor cursor list responses. - Publish plugin-prefixed pubsub events for mutations when frontend screens use subscriptions for live detail or list updates.
- Wire schema strings through
src/apollo/schema/schema.ts. - Wire resolver maps through
src/apollo/resolvers. - Register models and plugin-prefixed collection names in
connectionResolvers.ts. - Update permission and notification metadata when behavior requires it.
Validation
- Frontend plugin changes:
pnpm nx lint <plugin>andpnpm nx build <plugin>. - Backend plugin changes:
pnpm nx build <api-plugin>. - Tests: run the focused test target when tests or tested behavior changed.