Repository: cypress-io/cypress

Stars: 49626

CLAUDE.md Copy Chapter

CLAUDE.md

Workflow Orchestration Copy Chapter

1. Plan Mode Default Copy Section

- Enter plan mode for ANY non-trivial task (3+ steps or architectural decisions)
- If something goes sideways, STOP and re-plan immediately - don't keep pushing
- Use plan mode for verification steps, not just building
- Write detailed specs upfront to reduce ambiguity

2. Subagent Strategy Copy Section

- Use subagents liberally to keep main context window clean
- Offload research, exploration, and parallel analysis to subagents
- For complex problems, throw more compute at it via subagents
- One task per subagent for focused execution

3. Self-Improvement Loop Copy Section

- After ANY correction from the user: update the closest relevant CLAUDE.md file
- Write rules for yourself that prevent the same mistake

4. Verification Before Done Copy Section

- Never mark a task complete without proving it works
- Diff behavior between main and your changes when relevant
- Ask yourself: "Would a staff engineer approve this?"
- Run relevant tests only, check logs, demonstrate correctness

5. Demand Elegance (Balanced) Copy Section

- For non-trivial changes: pause and ask "is there a more elegant way?"
- If a fix feels hacky: "Knowing everything I know now, implement the elegant solution"
- Skip this for simple, obvious fixes - don't over-engineer
- Challenge your own work before presenting it

Core Principles Copy Chapter

- Minimal Impact: Changes should only touch what's necessary. Avoid introducing bugs.

@AGENTS.md

README.md Copy Chapter

<p align="center">
<a href="https://www.cypress.io">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="./assets/cypress-logo-dark.png">
<source media="(prefers-color-scheme: light)" srcset="./assets/cypress-logo-light.png">
<img alt="Cypress Logo" src="./assets/cypress-logo-light.png">
</picture>
</a>
</p>
<p align="center">
<a href="https://on.cypress.io">Documentation</a> |
<a href="https://on.cypress.io/changelog">Changelog</a> |
<a href="https://on.cypress.io/roadmap">Roadmap</a>
</p>

<h3 align="center">
The web has evolved. Finally, testing has too.
</h3>

<p align="center">
Fast, easy and reliable testing for anything that runs in a browser.
</p>
<p align="center">
Join us, we're <a href="https://cypress.io/jobs">hiring</a>.
</p>

<p align="center">
<a href="https://www.npmjs.com/package/cypress">
<img src="https://img.shields.io/npm/dm/cypress.svg" alt="npm"/>
</a>
<a href="https://on.cypress.io/discord">
<img src="https://img.shields.io/badge/chat-on%20Discord-brightgreen" alt="Discord chat"/>
</a>
<a href="https://stackshare.io/cypress">
<img src="https://img.stackshare.io/misc/follow-on-stackshare-badge.svg" alt="StackShare"/>
</a><br />
</p>

What is Cypress? Copy Chapter

<p align="center">
<a href="https://player.vimeo.com/video/237527670">
<img alt="Why Cypress Video" src="https://user-images.githubusercontent.com/1271364/31739717-dbdff0ee-b41c-11e7-9b16-bfa1b6ac1814.png" width="75%" height="75%" />
</a>
</p>

Installing Copy Chapter


Install Cypress for Mac, Linux, or Windows, then get started.

npm install cypress --save-dev

yarn add cypress --dev

pnpm add cypress --save-dev

!installing-cli e1693232

Contributing Copy Chapter

 - develop branch

Please see our Contributing Guideline which explains repo organization, linting, testing, and other steps.

License Copy Chapter


This project is licensed under the terms of the MIT license.

Badges Copy Chapter

Configure a badge for your project's README to show your test status or test count in the Cypress Cloud.



Or let the world know your project is using Cypress with the badge below.


![Cypress.io](https://www.cypress.io/)