Imported from druva-kiran/ripple-sync (.agents/AGENTS.md). Install upstream with npx skills add druva-kiran/ripple-sync --skill .agents. Copyright stays with the author.

Ripple Context-Sync Rules

When you are asked to make changes to this project, you MUST first run the Ripple tool to gather all relevant context before making any edits. This ensures you do not forget to update dependent files or documentation.

Steps for Editing Code:

1. Before making a change, think about the core symbols (functions, classes, variables) that will be affected.
2. Run ripple search to search for references if you want to manually find related files.
3. Or simply rely on the tool: make your changes, then run ripple diff to see what changed, and ripple search to find all referencing files that you might have missed.
4. Read all the files returned by the search command into your context.
5. After you finish making all edits, run ripple verify to run the project's tests and ensure the documentation is still accurate.

Always remember: You must fix everything that depends on the code you just changed!