Skill: Research

Description

# Skill: Research ## Mô tả Skill này giúp **tìm kiếm và phân tích repo mẫu** trên GitHub trước khi triển khai. Thay vì "nghĩ từ đầu", chúng ta học hỏi từ những gì đã có, tiết kiệm thời gian và tránh lỗi phổ biến. ## Khi nào sử dụng - User đưa yêu cầu nhưng chưa rõ cách làm nhanh nhất - Cần tìm patterns, architectures đã proven - Muốn so sánh các approaches khác nhau - Cần tìm libraries/tools phù hợp ## Workflow ### Phase 1: Parse Requirements 1. Đọc `intake.md` để hiểu context 2. Extract keywords cho search 3. Xác định tech stack constraints ### Phase 2: GitHub Search 1. Tạo search queries thông minh 2. Tìm repos phù hợp (stars, recent activity, license) 3. Filter theo language/tech stack 4. Rank theo relevance ### Phase 3: Deep Analysis 1. Phân tích cấu trúc thư mục của top repos 2. Xác định patterns được dùng 3. Tìm hiểu technologies và dependencies 4. Ghi nhận anti-patterns cần tránh ### Phase 4: Summarize 1. Tổng hợp shortlist các repos hay nhất 2. Recommend architecture/patterns 3. Liệt kê lessons learned 4. Xuất output chuẩn ## Output Format ### File: `output/research/shortlist.json` ```json { "query": "original search context", "timestamp": "2024-01-22T00:00:00Z", "intake_source": "output/intake/intake.md", "repos": [ { "rank": 1, "name": "owner/repo-name", "url": "https://github.com/owner/repo-name", "stars": 5000, "forks": 500, "last_updated": "2024-01-15", "description": "Short description from GitHub", "language": "TypeScript", "license": "MIT", "relevance_score": 0.95, "technologies": ["React", "Next.js", "Prisma"], "patterns_found": [ "monorepo with turborepo", "feature-based folder structure", "server components" ], "strengths": [ "Well documented", "Active maintenance", "Good test coverage" ], "weaknesses": [ "Complex setup", "Heavy dependencies" ], "notes": "Good example for enterprise-scale apps" } ], "summary": { "total_repos_analyzed": 50, "shortlisted": 5, "recommended_stack": { "frontend": "Next.js with App Router", "backend": "tRPC or Next.js API Routes", "database": "PostgreSQL with Prisma", "deployment": "Vercel" } } } ``` ### File: `output/research/patterns.md` ```markdown # Research Patterns Report ## Context - **Project**: [from intake] - **Search Date**: [timestamp] - **Repos Analyzed**: [count] --- ## Recommended Architecture ### Pattern: [Name] - **Source**: [repo link] - **Why it fits**: [reasoning] - **Implementation notes**: [how to apply] ### Folder Structure ``` src/ ├── app/ # Routes (Next.js App Router) ├── components/ # Reusable UI ├── lib/ # Utilities ├── services/ # Business logic └── types/ # TypeScript types ``` --- ## Technology Recommendations ### Frontend | Option | Pros | Cons | Recommended? | |--------|------|------|--------------| | Next.js | SSR, App Router, Vercel | Learning curve | Yes | | Vite + React | Fast dev, simple | No SSR | For SPAs | ### Backend | Option | Pros | Cons | Recommended? | |--------|------|------|--------------| | tRPC | Type-safe, fast | Next.js specific | Yes | | Express | Flexible | More setup | No | ### Database | Option | Pros | Cons | Recommended? | |--------|------|------|--------------| | Prisma + PostgreSQL | Type-safe ORM | Schema migrations | Yes | | Drizzle | Lighter | Newer | Alternative | --- ## Code Patterns ### 1. [Pattern Name] **Source**: [repo] **Usage**: [when to use] ```typescript // Example code from repo ``` ### 2. [Pattern Name] ... --- ## Anti-patterns to Avoid 1. **[Anti-pattern]**: [why it's bad, found in repo X] 2. **[Anti-pattern]**: [why it's bad] --- ## Dependencies Worth Noting | Package | Purpose | Stars | License | |---------|---------|-------|---------| | package-name | Description | 10k | MIT | --- ## Next Steps 1. Clone

Security Status