mirror of
https://github.com/cypress-io/cypress.git
synced 2026-05-25 01:49:06 -05:00
Ryan Manuel
4931cf06ff
* chore: bootstrap AI agent context files (AGENTS.md + CLAUDE.md)
Adds a three-tier set of AI context files across the monorepo:
- Root AGENTS.md / CLAUDE.md — project overview, workspaces, common
commands, architecture map, code conventions, and CI/CD summary
- Workspace-level pairs for cli/, packages/, npm/, tooling/,
system-tests/, and scripts/
- Package-level pairs for all 33 packages/, 15 npm/, 3 tooling/
packages, and the cli workspace (117 files total)
CLAUDE.md files are thin wrappers (@AGENTS.md import + workflow rules)
so Claude Code picks them up walking upward from cwd. AGENTS.md files
carry the substantive content and are also read natively by Codex CLI
and Cursor.
Command conventions applied throughout:
- No watch / file-watcher commands (agents run once and read results)
- No bare full-suite test runs for large packages; always target a
specific file (<path-to-spec>) or glob ("<glob-pattern>")
- No cypress:open (interactive mode); use cypress:run with --spec
- Test runner syntax varies by package: vitest (test --),
mocha (test-unit/test-integration --), jest (--testPathPattern),
Cypress CT (cypress:run:ct -- --spec)
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
* gitignore
* clarify AI internal docs and contribution guidelines
* update TOC
* tweak nvm wording
---------
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Runner
This is an old package, deprecated in favor of @packages/app. It has two remaining responsibilities before it can be entirely removed:
- Bundles
@packages/reporterand@packages/drivervia webpack. Once those can be directly imported to@packages/app, we can remove this. - Bundles styles for
@packages/reporter, loaded inmain.scss. Ideally, reporter should import its own styles. - Contains
dom.js, which uses proprietary webpack loaders and cannot easily be imported with Vite (dev server in@packages/app). Oncedom.jsis free of webpack-specific loader code, we should move it to@packages/app. - Contains Cypress Studio Recorder code, which was marked as experimental in Cypress 9.x and won't be part of Cypress 10.x initially. It will return at a later date. Until then, the code will be here. It's not currently used in the app. @see https://github.com/cypress-io/cypress/issues/22870
- Contains Legacy Cypress styles, most of these can likely be removed.
Implicit Dependencies
We have the following implicit dependencies defined in package.json
- @packages/driver
- @packages/config
- @packages/reporter
The source code from these packages are bundled into dist/cypress_runner.js when this package is built. Because of this, we need to specify to Nx that any changes in the source files of the above packages need to invalidate the build cache for this package so that it gets rebuilt.