Brownfield Takeover Skills
hoangliem88/claude-skills
Ciclo completo de takeover de projetos brownfield com skills Claude Code
Ver no GitHubConjunto de 4 skills Claude Code que padronizam o ciclo de vida de assunção de projetos legados: auditoria de codebase, análise de gaps, implementação de tickets e revisão de aceitação. Integra fluxo completo de onboarding técnico com templates e checklists prontos.
Instalação
npx convez-ai hoangliem88/claude-skills1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Auditoria técnica e mapeamento de estado atual de codebase
- Análise de divergências entre requerimentos (URD) e Figma vs código
- Implementação padronizada de tickets em ambiente terminal
- Revisão e aceitação técnica com critérios estruturados
Veredito

Solução prática para times que recebem projetos legados; a modularização em 4 skills bem definidas e o suporte a instalação por pessoa ou por projeto facilitam adoção. Faltam exemplos em português e documentação de casos reais de uso, mas a estrutura é sólida.
README
A tradução para o português deste README ainda está na fila.
Brownfield Takeover Skills — Bộ skill Claude Code cho quy trình tiếp nhận dự án
Bộ 4 skill chuẩn hóa vòng đời tiếp nhận dự án brownfield:
codebase-audit (quét hiện trạng) → gap-analysis (đối chiếu URD/Figma, sinh ticket)
→ implement-ticket (dev làm ticket trong terminal) → acceptance-review (TL nghiệm thu).
Tài liệu sử dụng đầy đủ: docs/huong-dan-su-dung-bo-skill.md
Cài đặt (mỗi người một lần)
git clone <url-repo-nay> ~/claude-skills
cd ~/claude-skills && ./install.sh
Script tạo symlink từ ~/.claude/skills/<tên-skill> về repo. Mở session
Claude Code mới, gõ /skills để xác nhận 4 skill xuất hiện.
Máy không dùng được symlink (một số môi trường Windows): ./install.sh --copy.
Cập nhật
cd ~/claude-skills && git pull
Xong — vì là symlink nên skill tự mới, chỉ cần mở session Claude Code mới.
(Nếu cài bằng --copy thì sau git pull chạy thêm ./install.sh --copy.)
Cài cho một dự án cụ thể (cả team dùng chung qua repo dự án)
./install.sh --project /đường/dẫn/repo-dự-án
cd /đường/dẫn/repo-dự-án && git add .claude/skills && git commit -m "Add team skills"
Lưu ý: cài theo project là bản copy đóng băng tại thời điểm cài — khi bộ skill có phiên bản mới cần chạy lại lệnh trên và commit.
Đóng góp / tinh chỉnh skill
Skill là Markdown thuần trong skills/<tên>/. Quy trình sửa:
- Tạo nhánh, sửa
SKILL.mdhoặc file trongreferences/. - Cập nhật
docs/huong-dan-su-dung-bo-skill.mdnếu thay đổi ảnh hưởng cách dùng (quy ước: skill đổi thì tài liệu đổi cùng). - Ghi vào
CHANGELOG.md, tạo MR để review — đặc biệt các thay đổi về quy tắc kiến trúc mặc định và template ticket vì ảnh hưởng mọi dự án.
Cấu trúc repo
skills/
├── codebase-audit/ SKILL.md + references/ (discovery, templates, security checklist)
├── gap-analysis/ SKILL.md + references/ (inputs & figma, templates)
├── implement-ticket/ SKILL.md
└── acceptance-review/ SKILL.md
docs/
└── huong-dan-su-dung-bo-skill.md
install.sh
CHANGELOG.md