Skip to content

AGENTS.md

Latest commit

 

History

History
52 lines (40 loc) · 3.33 KB

AGENTS.md

File metadata and controls

52 lines (40 loc) · 3.33 KB

AGENTS.md (Local-First)

Keep this file and CLAUDE.md aligned.

This repo is local-first now. Do not reintroduce hosted-service assumptions, remote deployment runbooks, or hardcoded production domains.

Core guardrails

  • Prefer local Mac runtime, local bridge, QR pairing, and daemon workflows.
  • Be an intraprendente agent: proactively inspect local code, protocol/schema, and official sources to confirm facts before replying; do not repeatedly stop to ask for confirmation when the next verification step is safe and obvious.
  • Keep repo isolation by thread/project metadata and local cwd.
  • Do not reintroduce filtering by selected repo in sidebar/content.
  • Keep cross-repo open/create flow with automatic local context switch.
  • Preserve single responsibility: shared logic belongs in services/coordinators, not duplicated in views.
  • Treat this repo as open source: avoid junk code, placeholder hacks, noisy one-off workarounds, and low-signal docs.
  • If you touch docs, keep them local-only and remove stale hosted-service notes instead of adding compatibility layers.
  • Do not create one-off report markdown files in the repo root (security reports, audit notes, scratch summaries, etc.) unless the user explicitly asks for a file. Keep ad-hoc analysis in the chat.
  • For open-source/self-hosted safety, do not log live relay sessionId values or other bearer-like pairing identifiers in server logs; redact or hash them instead.
  • Keep user-facing answers compact by default unless the user explicitly asks for more detail.

iOS runtime + timeline guardrails

  • turn/started may not include a usable turnId: keep the per-thread running fallback.
  • If Stop is tapped and activeTurnIdByThread is missing, resolve via thread/read before interrupting.
  • On reconnect/background recover, rehydrate active turn state so Stop remains visible.
  • Suppress benign background disconnect noise (NWError.posix(.ECONNABORTED)) and retry on foreground.
  • Keep assistant rows item-scoped to avoid timeline flattening/reordering.
  • Merge late reasoning deltas into existing rows; do not spawn fake extra "Thinking..." rows.
  • Ignore late turn-less activity events when the turn is already inactive.
  • Preserve item-aware history reconciliation instead of falling back to turnId-only matching.

Local connection guardrails

  • Prefer saved relay pairing and local connection state as the source of truth.
  • Avoid hardcoded remote domains; default to local values or explicit user config.
  • Keep pairing/auth UX stable: do not clear saved relay info too early during reconnect flows.
  • Preserve reconnect behavior across relaunch when the local host session is still valid.
  • Preserve the QR/local-relay pairing path: do not regress the scanner -> saved pairing -> connect flow by letting onboarding/auto-reconnect race manual scan control.
  • For local relay recovery, keep resumed desktop-thread live mirroring and rollout fallback logic intact so reopened/running threads still recover state even when the rollout file is older than the recent-candidate window.

Build guardrails

  • Do not run Xcode builds/tests unless the user explicitly asks.
  • Markdown files inside Xcode-synced groups can still produce harmless warnings.
  • For small iOS/mobile fixes, prefer inspection and targeted edits over simulator runs by default.

Local quick runbook

cd phodex-bridge
npm start