RpgRoller/AGENTS.md

Agent Guide

Also see the other related technical documentation: TECH.md and possibly other markdown files.

Rules

• This is a Windows environment, WSL is not installed (i.e. sed is not available). You're running under PowerShell 7.5.4. Due to platform restrictions, file deletions are not possible. Replacing the entire file content via a context diff is a viable alternative.
• PowerShell doesn't support bash-style heredocs. If complex scripts need to be executed, consider using python. Run Python code using python -c with inline commands instead of python - <<'PY'.
• web.config in the server is different than locally, it must be exluded from deployment.
• After every iteration, evaluate if the test coverage would fall below 100%, and write tests if necessary.
• After every iteration, run "scripts/ci-local.ps1" and ensure that nothing broke.
• After every iteration, update all related documentation according to the change, and evaluate if a FAQ entry would help the users, serving as public documentation for this project.
• After every iteration, do a git commit with a brief summary of the changes as a commit message.
• Keep changes small and commit often. If one iteration encompasses many smaller tasks with more than one commit, create a git branch and do the commits there. Let me review the branch before merging it back to master.
• If you find unexpected changes in the code (deletions, changes, diff results that were not communicated), never revert them and never restore the old state. Assume that those changes happened with intent.
• After changing the database, if your build is blocked by a running dotnet process, feel free to kill the process and retry the operation once.