Files
Gitea/AGENTS.md
T
2026-07-30 04:58:55 +00:00

21 lines
1.8 KiB
Markdown

- Never assume, verify before claiming
- Use `make help` to list the available development targets
- Keep PR descriptions minimal, no task lists
- Use Conventional Commits for commit messages and PR titles, plus Gitea's own `enhance` type for user-facing enhancements
- Add an `Assisted-by: AGENT_NAME:MODEL_VERSION` trailer to commit messages, never `Co-Authored-By` or `Signed-off-by`
- Never rewrite git history unless asked. Use new commits and normal push for PR updates
- Include authorship attribution when writing issue and PR comments
- Comments: Write almost no new ones, keep them short, preferably same-line, explain why for a future reader. Never narrate code, the current change or prompt. Preserve existing comments when they still apply.
- Add the current year to copyright headers of new `.go` files
- Leave no trailing whitespace in any edited file
- In TS, use `!` instead of `?.`/`??` when a value always exists
- Prefer `tw-*` utilities over inline `style`, and `flex-*` helpers over per-child `tw-ml-*` / `tw-mr-*` margins, falling back to `tw-*` when specificity requires `!important`
- Run `make fmt` after `.go` edits, `make tidy` after `go.mod` edits
- Lint what changed with `make lint-go`, `lint-js`, `lint-css` or `lint-templates`
- Run single Go tests with `go test -run '^TestName$' ./modulepath/`
- Run single TS test files with `pnpm exec vitest <path-filter>`
- Run single Playwright e2e test files with `GITEA_TEST_E2E_FLAGS='<filepath>' make test-e2e`
- Write the fewest, fastest tests covering the behavior. Prefer extending an existing test before adding a new one. Avoid `sleep` and similar mechanisms
- Prefer unit tests when logic is testable in isolation, aim for sub-2s local runtime per integration test and sub-4s per e2e test
- Prefer semantic locators in e2e tests