✨ feat: update deployment scripts and configuration; enhance CI/CD process with new scripts for staging and production

AGENTS.md

@@ -12,6 +12,8 @@ Tibi CMS starter template — Svelte 5 SPA with esbuild, SSR via goja, and Playw
 
 ## Setup commands
 
+> **New project from this template?** Follow the step-by-step guide in [README.md](README.md).
+
 - Install deps: `yarn install`
 - Start dev: `make docker-up && make docker-start`
 - Start with mock data: set `MOCK=1` in `.env`, then `make docker-up && make docker-start`
@@ -59,6 +61,36 @@ Tibi CMS starter template — Svelte 5 SPA with esbuild, SSR via goja, and Playw
 - API access to collections uses the reverse proxy: `CODING_URL/api/<collection>` (e.g. `CODING_URL/api/content`).
 - Auth via `Token` header with ADMIN_TOKEN from `api/config.yml.env`.
 
+## Reference repositories
+
+These sibling repos in the workspace provide documentation, types, and reference implementations:
+
+| Repository | Path | Purpose |
+| --- | --- | --- |
+| **tibi-types** | `../../cms/tibi-types` | TypeScript type definitions for hooks, collections, permissions, etc. Included via `tsconfig.json` — **read-only, do not modify**. Key file: `index.d.ts`. JSON schemas in `schemas/api-config/`. |
+| **tibi-server** | `../../cms/tibi-server` | Go source code of the server. `docs/` has detailed documentation (16 files), `examples/` has sample projects. |
+| **tibi-admin-nova** | `../../cms/tibi-admin-nova` | Admin UI reference project. Key file: `types/admin.d.ts` (1147 lines — all admin types: `AdminCollection`, `AdminCollectionField`, `AdminCollectionMeta`, `AdminDashboard`, etc.). Use as reference for collection field configs, dashboard setup, and fieldLists. |
+
+### When to consult which repo
+
+- **Write collection YAML** → `tibi-server/docs/04-collections.md` + `tibi-types/schemas/api-config/collection.json` (JSON schema)
+- **Write/debug hooks** → `tibi-server/docs/06-hooks.md` + `tibi-types/index.d.ts` (context types)
+- **Configure admin UI** → `tibi-admin-nova/types/admin.d.ts` (field types, meta, dashboard) + `tibi-admin-nova/api/collections/` (real examples)
+- **Permissions** → `tibi-server/docs/05-authentication.md`
+- **Realtime/SSE** → `tibi-server/docs/07-realtime.md`
+- **Images/uploads** → `tibi-server/docs/08-file-upload-images.md`
+- **LLM integration** → `tibi-server/docs/09-llm-integration.md`
+
+### TypeScript types
+
+`tibi-types` is included via `tsconfig.json`:
+
+```json
+"include": ["frontend/src/**/*", "types/**/*", "./../../cms/tibi-types", "api/**/*"]
+```
+
+Project-specific types (e.g. `Ssr`, `ApiOptions`, `ContentEntry`) live in `types/global.d.ts`.
+
 ## Code style
 
 - Follow the existing code style and conventions used in the project.