add documentation for ai agents (#3115)

* add documentation for ai agents

* docs: consolidate CLAUDE.md and CONTRIBUTING.md, add style guidelines

- Refactor CLAUDE.md to reference CONTRIBUTING.md for build/test/format info
- Expand CONTRIBUTING.md with comprehensive build targets, env vars, and testing
- Add code style guidelines section with conventional commits
- Standardize SDK prettier config to use single quotes (matching web)
- Add project-level Claude Code settings to disable co-author attribution

* style(sdk): apply prettier with single quotes

Run prettier across sdk/base and sdk/package to apply the
standardized quote style (single quotes matching web).

* docs: add USER.md for per-developer TODO filtering

- Add agents/USER.md to .gitignore (contains user identifier)
- Document session startup flow in CLAUDE.md:
  - Create USER.md if missing, prompting for identifier
  - Filter TODOs by @username tags
  - Offer relevant TODOs on session start

* docs: add i18n documentation task to agent TODOs

* docs: document i18n ID patterns in core/

Add agents/i18n-patterns.md covering rust-i18n setup, translation file
format, t!() macro usage, key naming conventions, and locale selection.
Remove completed TODO item and add reference in CLAUDE.md.

* chore: clarify that all builds work on any OS with Docker

sdk/package/lib/version/VersionInfo.ts

@@ -1,7 +1,7 @@
-import { ValidateExVer } from "../../../base/lib/exver"
-import * as T from "../../../base/lib/types"
+import { ValidateExVer } from '../../../base/lib/exver'
+import * as T from '../../../base/lib/types'
 
-export const IMPOSSIBLE: unique symbol = Symbol("IMPOSSIBLE")
+export const IMPOSSIBLE: unique symbol = Symbol('IMPOSSIBLE')
 
 export type VersionOptions<Version extends string> = {
   /** The exver-compliant version number */
@@ -60,30 +60,30 @@ export class VersionInfo<Version extends string> {
 }
 
 function __type_tests() {
-  const version: VersionInfo<"1.0.0:0"> = VersionInfo.of({
-    version: "1.0.0:0",
-    releaseNotes: "",
+  const version: VersionInfo<'1.0.0:0'> = VersionInfo.of({
+    version: '1.0.0:0',
+    releaseNotes: '',
     migrations: {},
   })
-    .satisfies("#other:1.0.0:0")
-    .satisfies("#other:2.0.0:0")
+    .satisfies('#other:1.0.0:0')
+    .satisfies('#other:2.0.0:0')
     // @ts-expect-error
-    .satisfies("#other:2.f.0:0")
+    .satisfies('#other:2.f.0:0')
 
-  let a: VersionInfo<"1.0.0:0"> = version
+  let a: VersionInfo<'1.0.0:0'> = version
   // @ts-expect-error
-  let b: VersionInfo<"1.0.0:3"> = version
+  let b: VersionInfo<'1.0.0:3'> = version
 
   VersionInfo.of({
     // @ts-expect-error
-    version: "test",
-    releaseNotes: "",
+    version: 'test',
+    releaseNotes: '',
     migrations: {},
   })
   VersionInfo.of({
     // @ts-expect-error
-    version: "test" as string,
-    releaseNotes: "",
+    version: 'test' as string,
+    releaseNotes: '',
     migrations: {},
   })
 }