docs: update agents files (#930)

Author: strickvl

AGENTS.md

@@ -25,6 +25,19 @@
 - Place unit specs alongside code as `*.spec.ts[x]`; run them with `pnpm test:unit`. Reuse helpers in `src/lib` so fixtures stay deterministic and reset timers, TanStack Query caches, and mocks in `beforeEach`.
 - Reserve Playwright (`pnpm test:e2e`) for end-to-end flows and smoke coverage; keep component snapshots and accessibility assertions in Vitest using `@testing-library/react`.
 
+## Scope Guardrails
+
+- **Workspace-level resources only:** This repo implements workspace-level service accounts. User-level API keys are out of scope.
+- **Icons:** Reuse existing icon components; **do not** import from `lucide-react` (AI tools default to this incorrectly).
+
+## Common Implementation Patterns
+
+- Reference similar existing features when implementing new ones (check zenml-cloud-ui repo for shared patterns)
+- **One-time secrets**: Display token/key once after creation in a dialog, never persist in UI state
+- **Query invalidation**: After mutations (create/update/delete), invalidate TanStack Query cache to refetch data
+- **Component reuse**: Check `src/components/` for existing patterns before creating new components
+- **Type safety**: Use generated types from `src/types/core.ts`, avoid `type any`
+
 ## Commit & Pull Request Guidelines
 
 - Follow Conventional Commit prefixes (`feat:`, `fix:`, `chore:`) with ≤72-character subjects and include issue references (`#123`) when relevant.

CLAUDE.md

@@ -212,6 +212,24 @@ Vite build is configured to split chunks by library:
 2. **Bundle size:** Build files are bundled into the Python package, so bundle size matters
 3. **No standalone use:** This dashboard is designed to work with the ZenML Server backend
 4. **Backwards compatibility:** Consider that users may be running different ZenML Server versions
+5. **Scope: Workspace-level resources only:** This dashboard implements workspace-level service accounts. User-level API keys are out of scope for this repository.
+
+## Working with AI Coding Assistants
+
+When using AI tools with this codebase:
+
+### Provide Context
+
+1. Reference existing implementations for similar features
+2. Point to the data fetching patterns in `src/data/`
+3. Note that many patterns are shared with zenml-cloud-ui (check that repo for reference implementations)
+
+### Common Patterns
+
+- **One-time secrets**: Display token/key once after creation, never show again
+- **Query invalidation**: After mutations, invalidate related TanStack Query queries to trigger refetch
+- **Component reuse**: Check `src/components/` before creating new components
+- **Type safety**: Use generated types from `src/types/core.ts`, avoid `type any`
 
 ## Common Patterns