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/mainFn/Daemons.ts

@@ -1,20 +1,20 @@
-import { Signals } from "../../../base/lib/types"
+import { Signals } from '../../../base/lib/types'
 
-import { HealthCheckResult } from "../health/checkFns"
+import { HealthCheckResult } from '../health/checkFns'
 
-import { Trigger } from "../trigger"
-import * as T from "../../../base/lib/types"
-import { SubContainer } from "../util/SubContainer"
+import { Trigger } from '../trigger'
+import * as T from '../../../base/lib/types'
+import { SubContainer } from '../util/SubContainer'
 
-import { promisify } from "node:util"
-import * as CP from "node:child_process"
+import { promisify } from 'node:util'
+import * as CP from 'node:child_process'
 
-export { Daemon } from "./Daemon"
-export { CommandController } from "./CommandController"
-import { EXIT_SUCCESS, HealthDaemon } from "./HealthDaemon"
-import { Daemon } from "./Daemon"
-import { CommandController } from "./CommandController"
-import { Oneshot } from "./Oneshot"
+export { Daemon } from './Daemon'
+export { CommandController } from './CommandController'
+import { EXIT_SUCCESS, HealthDaemon } from './HealthDaemon'
+import { Daemon } from './Daemon'
+import { CommandController } from './CommandController'
+import { Oneshot } from './Oneshot'
 
 export const cpExec = promisify(CP.exec)
 export const cpExecFile = promisify(CP.execFile)
@@ -231,7 +231,7 @@ export class Daemons<Manifest extends T.SDKManifest, Ids extends string>
     const res = (options: AddDaemonParams<Manifest, Ids, Id, C> | null) => {
       if (!options) return prev
       const daemon =
-        "daemon" in options
+        'daemon' in options
           ? options.daemon
           : Daemon.of<Manifest>()<C>(
               this.effects,
@@ -369,8 +369,8 @@ export class Daemons<Manifest extends T.SDKManifest, Ids extends string>
     const healthDaemon = new HealthDaemon<Manifest>(
       daemon,
       [...this.healthDaemons],
-      "__RUN_UNTIL_SUCCESS",
-      "EXIT_SUCCESS",
+      '__RUN_UNTIL_SUCCESS',
+      'EXIT_SUCCESS',
       this.effects,
     )
     const daemons = await new Daemons<Manifest, Ids>(this.effects, this.ids, [
@@ -400,7 +400,7 @@ export class Daemons<Manifest extends T.SDKManifest, Ids extends string>
       if (canShutdown.length === 0) {
         // Dependency cycle that should not happen, just shutdown remaining daemons
         console.warn(
-          "Dependency cycle detected, shutting down remaining daemons",
+          'Dependency cycle detected, shutting down remaining daemons',
         )
         canShutdown.push(...[...remaining].reverse())
       }