---

15.4 Coding conventions ¶

• Kiss patterns first. Use Kiss’s Connection/Record API and MainServlet.openNewConnection() / closeConnection(db, success), not raw JDBC. Use org.kissweb.json.{JSONObject, JSONArray}, not external JSON libraries.
• If-statement bodies on the next line. Required by project style; see CLAUDE.md.

  // CORRECT
  if (x == null)
      return;
  
  // CORRECT
  if (x == null) {
      return;
  }
  
  // WRONG
  if (x == null) return;
  

• Comments explain why, not what. Well-named identifiers cover the what. Comments are for non-obvious constraints, workarounds, or surprises.
• Additive migrations. See guardrail above. A new schema change is a new Migration class plus a registry entry plus a CURRENT_DB_VERSION bump, all in one commit.
• Tests for behavior changes. If you fix a bug, add a test that fails without your fix.