agent-notify AGENTS.md

AgentNotify agent workflow

These instructions apply to every coding agent working in this repository.

Start or resume work

1. Read docs/DEVELOPMENT_STATE.md, docs/FEATURE_BACKLOG.md, TODO.md, and the relevant architecture/security documentation.
2. Inspect git status, the current branch, and recent commits before editing.
3. Preserve user changes and runtime secrets. Never read or print the bearer token unless direct API debugging was explicitly requested.
4. Update docs/DEVELOPMENT_STATE.md whenever a decision, verification result, migration, or next step would otherwise be lost after context compaction.

Local Git workflow

• This repository is local-only unless the user explicitly asks to configure or use a remote.
• main is the stable release line. Never edit or commit while checked out on main.
• dev is the integration branch. Do not implement features directly on dev.
• Create each branch from an up-to-date local dev:
  • feature/<short-name> for product capabilities;
  • fix/<short-name> for defects;
  • docs/<short-name> for documentation;
  • test/<short-name> for test-only work;
  • chore/<short-name> for tooling and maintenance.
• Keep commits focused and use imperative Conventional Commit subjects such as feat: add webhook delivery.
• Build and test the branch in proportion to its risk. Update documentation and migrations in the same branch as the behavior they describe.
• Merge a verified branch into local dev with git merge --no-ff. Delete the local topic branch after the merge when safe.
• Start the next topic branch from the newly merged dev.
• Never rewrite shared history, force-push, or use destructive Git commands.

Required quality gates

Run Windows .NET tooling through the repository scripts from WSL:

./scripts/build.sh
./scripts/test.sh
./scripts/package.sh

For narrow iterations, targeted tests are acceptable during development; the full build and test suite are required before merging to dev. Packaging is required when installer payload, embedded resources, publish settings, or release automation changes.