Validates that code changes meet defined architectural and documentation standards.
Install
mkdir -p .claude/skills/tl && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/10938" && unzip -o skill.zip -d .claude/skills/tl && rm skill.zipInstalls to .claude/skills/tl
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
> **📌 Carregado por:** Claude Code Web após QA marcar APROVADO. > **📌 Documentação:** ver [README.md](README.md) para visão geral.Key capabilities
- →Validates implementation against architectural standards
- →Enforces directory structure and naming conventions
- →Detects technical debt and undocumented hacks
- →Verifies alignment with project documentation
How it works
The skill acts as an automated gate, comparing the implementation against architectural specs and module patterns to ensure compliance.
Inputs & outputs
When to use tl
- →Validating architectural compliance
- →Enforcing code standards
- →Reviewing structural alignment with documentation
About this skill
TL Skill (Tech Lead)
📌 Localização:
skills/tl/📌 Etapa do fluxo: quarta (após QA) —docs/process/autonomous/workflow.md§4 📌 Pré-requisito: QA Skill aprovou.
1. PAPEL
A TL Skill é o gate arquitetural. Decide binariamente se a implementação está alinhada com os padrões técnicos do projeto.
Princípio: funcionar não basta — tem que estar no padrão. Divergência arquitetural sem justificativa documentada = rejeição.
2. CRITÉRIOS DE APROVAÇÃO
Aprova APENAS quando TODOS os itens forem verdadeiros:
- ✅ Decisões alinhadas com
docs/ARCHITECTURE.md - ✅ Padrões dos módulos análogos preservados (estrutura de pastas, nomenclatura, contratos)
- ✅ Sem duplicação de informação entre docs (CONSTITUTION §6 e
.claudecode.md) - ✅ Sem débito técnico desnecessário introduzido (TODOs vagos,
# FIXMEsem issue, código morto) - ✅ Domínio correto: código no lugar certo (
core/agents/,core/utils/,products/<x>/, etc) - ✅ Escopo coerente com ROADMAP da funcionalidade — sem extrapolar (ver PO Skill para gold plating)
- ✅ Documentação estrutural (
docs/ARCHITECTURE.md, specs emdocs/,core/docs/) atualizada se a estrutura mudou
3. CRITÉRIOS DE REJEIÇÃO
Rejeita automaticamente se qualquer item ocorrer:
- ❌ Padrão divergente de módulo análogo sem justificativa em commit/doc
- ❌ Decisão arquitetural quebrada (contraria
docs/ARCHITECTURE.mdou specs) - ❌ Documentação estrutural desalinhada do código entregue
- ❌ Duplicação de informação entre docs (mesma spec em 2 lugares)
- ❌ Código no domínio errado (ex: lógica de produto em
core/, util compartilhado em produto específico) - ❌ Débito introduzido sem registro/justificativa (TODO vago, dependência circular nova, hack temporário)
4. INPUT ESPERADO
- Branch
milestone/<id-em-caixa-baixa>aprovada por QA current_implementation.mdcomQA ✅- ROADMAP da funcionalidade
docs/ARCHITECTURE.md+ specs do tema afetado (viadocs/CONTEXT_INDEX.md)
5. OUTPUT PRODUZIDO
- ✅ Decisão binária registrada em
current_implementation.md - ✅ Lista de pontos verificados (com referência a
docs/ARCHITECTURE.md/ módulos análogos) - ✅ Em caso de rejeição: lista específica de desvios + arquivo + linha + padrão esperado
6. INTERAÇÃO COM OUTRAS SKILLS
| Cenário | Próxima ação |
|---|---|
| Aprovou | Fluxo segue para PO Skill |
| Rejeitou | Fluxo volta para Dev com lista de desvios |
| 3 rejeições consecutivas | Aplicar docs/process/implementation/blockers.md |
TL não reescreve código. Aponta padrão correto e devolve.
7. EXEMPLOS
- examples/approval-case.md — caso de aprovação simples
- examples/rejection-case.md — caso de rejeição com 2 desvios apontados
Ver também:
- Prompt operacional → skill.md
- Padrões arquiteturais →
docs/ARCHITECTURE.md - Princípios anti-duplicação →
docs/CONSTITUTION.md§6 e.claudecode.md - Próximo gate →
skills/po/README.md
When not to use it
- →When QA has not yet approved the implementation
- →When the goal is to rewrite code rather than validate it
Limitations
- →Does not re-write code
- →Requires existing architectural documentation
How it compares
It provides a binary architectural gate rather than a subjective code review.
Compared to similar skills
tl side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| tl (this skill) | 0 | 3mo | No flags | Intermediate |
| confidence-check | 13 | 4mo | Review | Beginner |
| specification-architect | 13 | 8mo | Review | Advanced |
| drift-analysis | 2 | 4mo | No flags | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by gmaiarviana
View all by gmaiarviana →You might also like
confidence-check
SuperClaude-Org
Pre-implementation confidence assessment (≥90% required). Use before starting any implementation to verify readiness with duplicate check, architecture compliance, official docs verification, OSS references, and root cause identification.
specification-architect
adrianpuiu
A rigorous, traceability-first system that generates five interconnected architectural documents (blueprint.md, requirements.md, design.md, tasks.md, and validation.md) with complete requirements-to-implementation traceability. Use this skill when users need to architect systems, create technical specifications, or develop structured project documentation with guaranteed traceability.
drift-analysis
avifenesh
This skill should be used when the user asks about "plan drift", "reality check", "comparing docs to code", "project state analysis", "roadmap alignment", "implementation gaps", or needs guidance on identifying discrepancies between documented plans and actual implementation state.
flow-next-plan-review
gmickel
Carmack-level plan review via RepoPrompt or Codex. Use when reviewing Flow epic specs or design docs. Triggers on /flow-next:plan-review.
rfc-check
meta-pytorch
Determine if proposed changes require an RFC. Use when planning significant changes, before starting major work, or when asked whether an RFC is needed.
feature-planning
mhattingpete
Break down feature requests into detailed, implementable plans with clear tasks. Use when user requests a new feature, enhancement, or complex change.