taw-kit-codex

Vietnamese-friendly entrypoint for taw-kit-codex. Trigger WHENEVER user describes a software task in VN or EN — build/add/fix/deploy/test/refactor/audit any app, website, mobile app, backend API, CLI, automation, data script, docs, or repo workflow. Sample triggers: "lam app quan ly kho", "viet tool CLI doi ten file", "them API webhook", "fix loi", "deploy len vercel", "test login", "don code". Classifies intent → loads one branch file from `branches/`; branches and agents detect stack before choosing skills. SAFE clarifies+approves; YOLO ("lam luon"/"nhanh nha"/"auto"/"yolo") skips gates. Reply in user's language.

Systematic error analysis for build, runtime, type, test, and deploy failures. Reads stack traces, greps relevant source files, identifies root cause, and proposes or applies a targeted fix. Triggers: "debug", "fix error", "stack trace", "loi build", "khong chay", "sua loi", "root cause".

Distinctive, production-grade frontend UIs that avoid generic AI aesthetics. Triggers: "build web component", "landing page", "dashboard UI", "react component", "lam giao dien", "thiet ke", "cho dep", "anti AI slop".

Stage + scan secrets + generate conventional commit message from actual diff + commit. CONTEXT mode (called by taw orchestrator, uses .taw/checkpoint.json phase) or SMART mode (ad-hoc). Triggers: "commit", "git commit", "save my work", "luu lai", "commit dum".

Advanced git: create branches, open PRs (auto-generated body from diff + commits), fast-forward merge, recover mistakes. Triggers: "create PR", "open pull request", "tao branch", "merge", "tao PR", "git branch", "rebase".

Ralph-style long-running task queue for Codex. Use when the user wants an autonomous loop over a PRD/task JSON, progress file, git history, and fresh context per task; useful for many small verifiable tasks such as tests, migrations, components, cleanup, refactors, or user stories. Triggers include "Ralph", "task loop", "prd.json", "long-running tasks", "non stop", "agent loop", "run task queue", "auto tasks", "passes true", "vòng lặp task", and "làm tới khi hết task".

Look up git history without knowing git — find which commit added a feature, changed a file, or ran in which taw phase. Triggers: "xem lich su", "ai sua cai nay", "khi nao them", "commit nao lam hong", "show git history", "blame".

Playwright/Cypress E2E tests for web user flows. Detection-first: adapts to existing webServer, Next.js/Vite/other dev commands, and current test runner. Triggers: "playwright", "e2e test", "end to end", "test luong", "browser test", "test user flow", "cypress".

Internal taw-kit-codex skill — render a 3-5 bullet approval plan in Vietnamese and wait for confirmation before code changes. Used only by the taw orchestrator/branches; never triggered directly by user prose.

Implement Supabase magic-link email authentication when user asks for login, passwordless auth, email link sign-in, protected routes, or "dang nhap bang email". Next.js/Supabase-specific; if project uses Clerk/NextAuth, adapt or route through taw stack detection instead of forcing Supabase.

Fetch up-to-date official documentation for any framework, library, API, CLI, or SDK before coding against it. Triggers: "tra tài liệu", "xem docs mới nhất", "tìm hướng dẫn <lib>", "latest docs", "official docs", "API docs", "migration guide".

Generate and validate environment files for apps/scripts: .env.local, .env.example, required keys, deploy env checklist, and secret-safe validation. Triggers: "env", ".env", "thieu bien moi truong", "validate env", "env example", "cau hinh key". Never logs secret values.

Translate build/runtime/type/deploy errors into plain Vietnamese with a short fix hint. Covers common Next.js, TypeScript, Supabase, npm, env, and deploy failures. Triggers: "dịch lỗi", "giai thich loi", "error nay la gi", "translate error", "loi build nay sua sao".

Build contact, lead capture, order, booking, survey, or signup forms with validation and storage. Triggers: "contact form", "lead form", "booking form", "order form", "them form", "form dat hang", "form lien he". Detects project stack; Supabase + react-hook-form + zod is the default web pattern.

Generate GitHub Actions CI workflows for web, mobile, backend, CLI, data, and docs repos. Detects stack and adds lint/type/test/build, Playwright, Supabase schema, preview deploys, or language-specific checks without overwriting existing CI. Triggers: "github actions", "ci cd", "set up ci", "tao ci", "chay test tren github", "workflow yaml".

Next.js App Router conventions for web apps: file-based routing, layouts, Server Components, Client Components, API route handlers, middleware, loading, error, and metadata files. Triggers: "Next.js", "App Router", "app router", "server component", "route handler", "middleware", "next layout".

Integrate payments for Vietnamese-friendly web products: Polar checkout, subscriptions, SePay/MoMo/VietQR fallback, COD notes, and webhook basics. Triggers: "payment", "checkout", "thanh toan", "Polar", "VietQR", "MoMo", "SePay", "subscription", "ban hang co thanh toan". Use stripe-checkout when user explicitly asks Stripe or project already uses Stripe.

Run a local web dev server and expose it via localtunnel for shareable preview before deploy. Triggers: "preview URL", "share local", "localtunnel", "cho khach xem thu", "xem tren dien thoai", "public preview". Defaults to Next.js dev server but can adapt to other local web ports.

Add essential SEO for web projects: metadata, Open Graph, sitemap.xml, robots.txt, canonical URLs, and structured data. Triggers: "SEO", "meta tags", "open graph", "sitemap", "robots.txt", "google search", "toi uu seo", "chia se Facebook/Zalo".

Install and use shadcn/ui components for Tailwind web apps. Covers Button, Card, Form, Table, Dialog, Toast, navigation, component patterns, and theming. Triggers: "shadcn", "ui component", "button/card/dialog/table", "cai shadcn", "them component", "tailwind component". Web-only.

Create or update Supabase schema, migrations, tables, storage, auth-related database setup, and Row Level Security policies. Triggers: "supabase", "database", "migration", "RLS", "policy", "tao bang", "them cot", "schema", "db setup". Non-dev safe: generates SQL and explains actions.

Set up + write Vitest unit/component tests for JavaScript/TypeScript apps, React components, utilities, and API helpers. Detection-first; respects existing Jest/Vitest setup. Triggers: "vitest setup", "unit test", "gen test", "viet test", "test component", "jsdom test", "@testing-library".

Embed TikTok Shop product cards, affiliate links, shop widgets, and video embeds into web pages. Triggers: "TikTok Shop", "affiliate", "san pham TikTok", "nhung TikTok Shop", "link affiliate", "video san pham". Web-only.

Generate or polish Vietnamese user-facing copy: landing page text, UI labels, CTAs, empty states, error messages, emails, product descriptions, and app microcopy. Triggers: "viet copy", "copy tieng Viet", "CTA", "noi dung landing", "sua cau chu", "Southern Vietnamese tone".

Internal taw-kit-codex agent role — general software builder for web, backend, CLI, automation, data, docs, and repo tooling. Detects stack first; Next.js/Tailwind/Supabase/Polar is only the default for new unspecified web apps. Invoked only by the `taw` skill orchestrator (BUILD branch Step 5) to scaffold/extend code from phase files.

Internal taw-kit-codex agent role — target-neutral architect/planner. Invoked only by the `taw` skill orchestrator (BUILD branch Step 5) to decompose intent.json into plan.md + numbered phase files.

Internal taw-kit-codex agent role — target-aware build + smoke-test validator. Invoked only by the `taw` skill orchestrator (BUILD branch Step 5). Detects stack, runs the right verifier, and translates errors to Vietnamese.

Internal taw-kit-codex agent role — security + quality reviewer (P0-only quick pass). Invoked only by the `taw` skill orchestrator (BUILD branch Step 5) as the final gate before SHIP.

Add contextual logs along a bug's call path, run the repro, collect logs, then auto-remove (marker-comment cleanup). Triggers: "debug with logs", "add console logs", "flight recorder", "bug khong tai hien", "khong biet loi o dau", "trace bug".

Generate Mermaid v11 diagrams for architecture, data flow, or user journey when a picture explains faster than prose. Used by planner when rendering phase files. Vietnamese trigger phrases: "vẽ sơ đồ", "vẽ flow", "diagram kiến trúc".

Break a multi-step task into numbered reasoning steps before acting. Used by taw-kit planner agent to decompose ambiguous Vietnamese prompts into executable phases. Vietnamese trigger phrases: "suy nghĩ từng bước", "phân tích kĩ", "chia nhỏ ra".

Stripe Checkout + webhook for Next.js App Router (one-time + subscriptions, signature verification). Alternative to `payment-integration` (Polar). Triggers: "stripe", "stripe checkout", "card payment", "stripe webhook", "subscription billing", "thanh toan the", "tich hop stripe", "doi polar sang stripe".

Internal taw-kit-codex agent role — React Native (Expo) developer. Invoked only by the `taw` skill orchestrator (BUILD branch Step 5) when project target is mobile or hybrid.

Internal taw-kit-codex agent role — documentation researcher. Invoked only by the `taw` skill orchestrator (BUILD branch Step 5) to fetch focused docs for unfamiliar APIs/libraries.

ast-grep (sg) cookbook for safe structural refactors in TS/TSX (rename, extract, find-replace with context). Triggers: "ast-grep", "structural replace", "rename symbol", "codemod tsx", "tim cau truc", "thay the theo pattern".

Build native UIs with Expo Router (file-based routing for mobile). Mobile counterpart of `nextjs-app-router`. Triggers: "expo router", "react native ui", "build mobile screen", "tao man hinh app", "navigation mobile".

Analyze + reduce Next.js JS bundle (@next/bundle-analyzer + dynamic imports, lib swaps, tree-shake). Triggers: "bundle size", "bundle analyzer", "giam bundle", "first load js", "giam size", "toi uu bundle".

Safe dep upgrade refs (Next.js/React/Supabase/Tailwind/TS/shadcn) + codemods + safety protocol. Triggers: "breaking change", "codemod", "upgrade next", "upgrade react", "nang cap", "cap nhat deps", "migration guide".

Deploy Expo apps to iOS/Android/Web via EAS Build + Submit. Mobile equivalent of taw SHIP branch (which targets Vercel/Docker/VPS). Triggers: "deploy expo app", "publish to app store", "eas build", "day app len store", "deploy app mobile", "len app store".

Build + distribute Expo dev clients (custom Expo Go) for projects needing native modules beyond stock Expo Go. Triggers: "expo dev client", "custom expo go", "tao dev client", "test native module".