convez.ai
SkillDesenvolvimento WebAvançado
bastndev

Skills - Framework de Scaffolding e Refatoração de Projetos

bastndev/skills

Scaffolding, melhoria e refatoração segura de projetos com análise arquitetural

Ver no GitHub
InicialPluginScore · de 0 a 100

Coleção de skills para Claude que cobre três fases do ciclo de vida de um projeto: inicialização (Start), melhoria contínua (Middle) e auditoria/refatoração (End). Permite criar estruturas production-ready, melhorar projetos durante desenvolvimento e executar refatoração segura com análise profunda de arquitetura.

Instalação

$npx convez-ai bastndev/skills

1 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

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 1 dia
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Inicializar novos projetos com estruturas production-ready
  • Executar refatoração segura e auditoria de código existente
  • Melhorar performance, segurança e manutenibilidade durante desenvolvimento
  • Análise categorizada de problemas arquiteturais com plano faseado de execução

Veredito

Repositório robusto com foco em ciclo de vida completo de projetos. A skill 'end' (refatoração) está funcional; as fases Start e Middle ainda planejadas. Bem documentado em múltiplos idiomas e com suporte a múltiplos runtimes. Ideal para times que precisam de análise estruturada e refatoração segura.

README

A tradução para o português deste README ainda está na fila.

npx skills add https://github.com/bastndev/skills --skill end

The Three Phases

PhasePurposeKey CapabilitiesExample SkillsStatus
StartProject initialization & scaffoldingCreate production-ready folder structures, initialize frameworks, apply best-practice defaults and configs from commit #1.start-nextjs, start-vite, start-fastapi...Planned
MiddleContinuous improvement & polishEnhance UI/UX, harden security, boost performance, clean logic, eliminate dead code, improve maintainability — during active development.Targeted enhancers (TBD)Planned
EndAudit, diagnosis & safe refactoringFull architecture & quality analysis. Categorized findings with file-level evidence. Prioritized phased plan executed only with explicit approval. Behavior-preserving. Multi-runtime support.refactor-project (the end skill)✅

Available Skills

SkillDescription
endrefactor-project — Understands your project end-to-end. Delivers a clear diagnosis (confirmed bugs, risks, opportunities, technical debt) with concrete references. Recommends the right architecture direction for this codebase and builds an ordered execution plan. Every change happens in an isolated, reviewable phase. You stay in full control: the skill only proceeds when you say go, start, or proceed. No files are touched during analysis.→ Full documentation & examples

Note: Each skill ships with its own detailed README. The root page gives the high-level overview; dive into ./skills/<skill>/README.md for deep usage, report examples, and guarantees.

Installation

# Install the End skill (refactor-project)
npx skills add bastndev/skills --skill end

Additional skills (once released) are installed the same way:

npx skills add bastndev/skills --skill start-nextjs

How the End Skill Works

  1. Analysis first — Maps entry points and understands the project. Zero files are modified.
  2. Structured report — Clear findings in four categories (Confirmed Bugs with severity, Risks, Refactoring Opportunities, Technical Debt) + an architecture recommendation and ordered plan. All items include concrete file + line references.
  3. You authorize every phase — It executes exactly one phase at a time. After each phase you get a precise summary of changes, validations performed, and the list of remaining phases.
  4. Full control & safety — Never creates tests if the project had none. Never adds dependencies or changes the package manager without permission. Respects your uncommitted work and always preserves current behavior unless fixing a justified bug.

For the complete workflow, exact report formats (including the required closing blocks), architecture decision rules, and all safety guarantees, read the dedicated skill documentation:

→ End – Refactor Project

The full internal specification lives in skills/end/SKILL.md.

Roadmap

  • Start skills — One-command project scaffolding for popular stacks (Next.js, Vite, FastAPI, etc.)
  • Middle skills — Focused, on-demand improvers (performance, security, UX, dead-code removal, etc.)
  • End expansions — More runtimes, additional specialized refactoring modes, and utilities

Each skill will have its own dedicated documentation (like the current End – Refactor Project).


If you find any bugs or have feedback, feel free to open an issue.

Made in 🇵🇪 by Gohit X · Licensed under MIT

Ver o original no GitHub

Bom para

Relacionados