Context dự án: Huỳnh Sang Blog

Khi nào dùng skill này

• •Khi bạn nói: “giải thích kiến trúc repo”, “nên sửa ở đâu”, “luồng blog/docs/admin hoạt động thế nào”.
• •Khi cần mapping nhanh: route → service → DB → UI component.

Bản đồ nhanh (repo-specific)

• •App Router: apps/web/src/app/[locale]/...
  • •Site routes: apps/web/src/app/[locale]/(site)/*
  • •Admin routes: apps/web/src/app/[locale]/admin/*
• •Services (DB-first): apps/web/src/services/*-service.ts
  • •Blog: apps/web/src/services/blog-service.ts
  • •Docs: apps/web/src/services/docs-service.ts
• •UI components:
  • •Shared: apps/web/src/components/*
  • •Shadcn UI (KHÔNG SỬA): apps/web/src/components/ui/*
• •i18n messages: apps/web/src/i18n/locales/vi.json
• •Supabase migrations: apps/web/supabase/migrations/*
• •E2E tests: apps/web/tests/*.spec.ts

Quy tắc “không được phá”

• •UI text luôn là Tiếng Việt qua next-intl (thuật ngữ kỹ thuật giữ English).
• •Next.js 16: luôn await params và await searchParams trong page.
• •Source of truth: Supabase cho blog/docs/projects (không Contentlayer).
• •Media file ở Cloudinary, DB chỉ lưu metadata/reference.
• •Không sửa: apps/web/src/lib/core/** và apps/web/src/components/ui/**.

Workflow tool (khi cần verify)

• •Repo ops: Serena (tìm file/symbol trước khi đọc cả file).
• •Library docs: Context7.
• •Web research: Perplexity.
• •Database: Supabase MCP (DDL → migration; query/debug → SQL).

Gợi ý cách làm việc hiệu quả

1. •Xác định nơi sửa: route (app) → component → service → DB.
2. •Dùng search (workspace) để tìm usage trước khi sửa API.
3. •Sau khi đổi API/signature: cập nhật mọi references.