Imported from storm-software/stryke (
AGENTS.md). Install upstream withnpx skills add storm-software/stryke. Copyright stays with the author.
General Guidelines for working with Nx
- When running tasks (for example build, lint, test, e2e, etc.), always prefer
running the task through
nx(i.e.nx run,nx run-many,nx affected) instead of using the underlying tooling directly - You have access to the Nx MCP server and its tools, use them to help the user
- When answering questions about the repository, use the
nx_workspacetool first to gain an understanding of the workspace architecture where applicable. - When working in individual projects, use the
nx_project_detailsmcp tool to analyze and understand the specific project structure and dependencies - For questions around nx configuration, best practices or if you're unsure, use
the
nx_docstool to get relevant, up-to-date docs. Always use this instead of assuming things about nx configuration - If the user needs help with an Nx configuration or project graph error, use
the
nx_workspacetool to get any errors
External packages — DO NOT PATCH
The following Storm Software ecosystems are maintained in separate repositories. Do not modify their package code, vendored scaffolding, or node_modules contents in this repo — including via patch-package, manual edits under node_modules, or direct changes to generated integration layers.
| Ecosystem | Upstream repository | In this repo (do not patch) |
|---|---|---|
| powerlines | storm-software/powerlines | powerlines, @powerlines/*, and Powerlines-generated CLI scaffolding |
| power-plant | storm-software/power-plant | @power-plant/* and any power-plant schema or tooling packages |
| shell-shock | storm-software/shell-shock | @shell-shock/* and apps/cli/.shell-shock/ |
| razorwind | storm-software/razorwind | @razorwind/* |
| cyclone-ui | storm-software/cyclone-ui | Consumer configuration and integration owned by this repo (for example powerlines.config.ts, razorwind.config.ts, shell-shock.config.ts, tools/razorwind/, and cyclone-ui CLI command implementations under apps/cli/src/) |
| storm-ops | storm-software/storm-ops | Reusable workflows, devenv modules, Terraform modules, and other storm-ops artifacts consumed by reference |
Allowed in this repository: consumer configuration and integration owned by this repo (for example powerlines.config.ts, razorwind.config.ts, shell-shock.config.ts, tools/razorwind/, and cyclone-ui CLI command implementations under apps/cli/src/).
When a bug or feature belongs in one of the ecosystems above:
- Stop — do not patch the external package or its vendored layer in this repository.
- Produce a descriptive upstream fix outline so a human or agent can apply the change in the correct external repository.
- Optionally implement only this repository's workaround or configuration change if one exists and is explicitly requested.