issues-quality

A set of project rules for checking that code changes still work before they are considered finished.

In plain words
What is it for?
It guides checks for Java and Angular changes, including builds, relevant tests, the full test suite, and lint warnings. Documentation-only edits can skip these checks.
Why use it?
It prevents broken builds, failing tests, and new code-quality problems from being left behind.

Cursor rule for Cursor

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add rules/vepo/issues/issues-quality
Clone the repo
git clone --depth 1 https://github.com/vepo/issues

Made for: Cursor.

Per session 613 This file is loaded in full into every session.
When invoked 613 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00613 $0.00613
Opus 5 $0.00307 $0.00307
Sonnet 5 $0.00123 $0.00123
Haiku 4.5 $0.00061 $0.00061

Measured 2d ago against content hash 71013033c29f, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

issues-quality scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.cursor/rules/issues-quality.mdc · 59 lines

How it starts

The opening of the file, as written. The whole thing — 59 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Coding quality and standards

Working code invariant

Development never ends with non-working code. Before stopping — whether the changelog is done or still in-progress:

  • The project compiles (mvn verify for backend; npm run build when webui changed).
  • Affected tests pass; no new failures in touched code.
  • No compile errors or new linter errors in edited files.

If a change breaks the build, fix it or revert it before ending. Partial features stay in-progress; they do not ship broken.

Finish gate (before marking done)

  1. Mid-task: tiered tests per issues-testing.mdc.
  2. Backend scope: affected *Test classes pass.
  3. Full suite: mvn verify — same as .github/workflows/build.yml backend portion.
  4. Frontend scope: npm run build then npm test in src/main/webui when Angular files changed.
  5. IDE: ReadLints on edited paths — fix new warnings.

Skip gates for docs-only, .mdc-only, or comment-only edits.

What to fix

  • Compile errors and test failures from verify.
  • New linter issues in touched files.
  • Smells you introduced: dead code, swallowed exceptions, System.out — see issues-java.mdc.

Pre-existing issues elsewhere: fix only if trivial; no scope creep.

Do not finish while

  • mvn verify fails on backend changes you made.
  • npm run build fails on frontend changes you made.
  • New linter problems in files you changed.
  • Failing tests remain in touched code.
  • Any compile error or broken test exists in your diff — including when stopping mid-task (in-progress is allowed; broken code is not).

Standards (file-scoped detail)

Topic Rule
Java style, logging, var, streams issues-java.mdc
Imports and formatting issues-format-imports.mdc
String building issues-strings.mdc
HTTP Request/Response records issues-http-contract.mdc
Layered architecture issues-layered-architecture.mdc
JPA / repositories issues-jpa.mdc
Angular conventions issues-angular.mdc

Read the full file on GitHub · 59 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 59 lines · 613 tokens per session scan A 71013033c29f

Subscribe to this mod's changes

issues-quality is a cursor rule published in the GitHub repository vepo/issues (8 stars, last pushed 1mo ago), licensed Apache-2.0. It adds 613 tokens to every session, about $0.0031 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.