Skip to content

Glossario

Petrus Silva Costa edited this page Aug 17, 2026 · 1 revision

Glossary

English below · Português abaixo

This page explains the technical terms used in the bigtech plugin and in this wiki, from scratch, without assuming prior knowledge. The terms are grouped by subject. Come back here whenever you run into an unfamiliar word.

Claude Code and plugin terms

Claude Code

An artificial intelligence assistant that runs in the terminal (the computer's text command window). You write requests in plain language and it reads files, writes code, runs commands, and helps build software. Think of it as a programmer who works alongside you, inside your computer.

Terminal

The text window where you type commands for the computer, instead of clicking buttons. Also called the "command line" or "console". It is where Claude Code runs.

Plugin

A package that adds new features to Claude Code, the way installing an app on a phone adds new functions. bigtech is a plugin.

Marketplace

A store (or catalog) from which plugins are downloaded. To install bigtech, you first register the marketplace called petrinhu and then install the bigtech plugin from it. Similar to adding an app source before installing an app.

Session

A period of conversation with Claude Code, from the moment you open it until you close it. Some plugin features (the hooks) only work fully after restarting the session, because they prepare the environment at the start.

CWD (current working directory)

The folder you are currently in within the terminal. The plugin looks at this folder to figure out which project you are working on.

The three pieces of the plugin

Agent

A virtual specialist with a defined role (for example, a backend engineer or a product manager). Each agent has its own rules, its quality standards, and knows when to step in. Claude Code calls the right agent for each task. The plugin brings 51 agents.

Subagent

When the main assistant calls a specialist agent to do part of the work, that specialist acts as a "subagent": it receives the task, carries it out, and returns the result. The main assistant coordinates.

Skill (command skill)

A ready-made flow shortcut that you trigger by typing a slash and a name, for example /bigtech. The skill runs several steps automatically. The plugin brings 4 skills: /bigtech, /proj_software, /tab_pendencias, and /visual-design-director.

Hook (automatic hook)

A small program that fires on its own at a specific moment, without you asking. For example: when a session starts, or right after a file is saved. The hooks enforce quality and governance rules automatically. The plugin brings 6 hooks.

Event

The moment that makes a hook fire. The main events are: SessionStart (the session begins), UserPromptSubmit (you send a message), PreToolUse (before the assistant uses a tool, such as saving a file), and PostToolUse (right after).

The company-style organization

Constellation

The name given to the group of 12 leadership agents (the C-level) working together. Like a company's board of directors. The word "constellation" is used because they are several points of leadership that, together, form a shape.

C-level

A company's senior leadership roles, whose titles usually begin with "Chief" and end with "Officer": CEO, CTO, CFO, and so on. The "C" comes from "Chief". In the plugin there are 12 C-level agents, each with its own name.

Acronym Role in English In Portuguese
CEO Chief Executive Officer Diretor-executivo (overall strategy)
CPO Chief Product Officer Diretor de produto
CTO Chief Technology Officer Diretor de tecnologia
CMO Chief Marketing Officer Diretor de marketing
COO Chief Operating Officer Diretor de operações
CISO Chief Information Security Officer Diretor de segurança da informação
CDO Chief Data Officer Diretor de dados
CAIO Chief AI Officer Diretor de inteligência artificial
CFO Chief Financial Officer Diretor financeiro
CRO Chief Revenue Officer Diretor de receita
CLO Chief Legal Officer Diretor jurídico
Chief of Staff Chief of Staff Chefe de gabinete (organizes and coordinates)

Operational agent

The 39 agents that do the hands-on work (programming, testing, writing documents, designing screens). They are called by the C-level or directly by the skills.

Role

The agent's function in the company. For example, the role of the backend-engineer agent is "backend engineer".

Color and layer

Each agent has a color that indicates its part in the organization. In bigtech there are two:

  • Orange: the 12 C-level leadership agents (they decide and coordinate).
  • Blue: the 39 operational agents (they do the work).

"Layer" is the level the agent belongs to: leadership (orange) or execution (blue).

Family

A grouping of the operational agents by area of work: Engineering, Data and AI, Product and Design, Management and People, Marketing, and Support and Docs. It serves only to organize the reading.

Backend and frontend

Backend is the part of the software that runs on the server, away from the user's eyes: database, business rules, logic. Frontend is the visible part: the screens, the buttons, the interface the user interacts with.

RACI

A way of making clear who does what at each step. Each letter is a role: R = Responsible (makes it happen), A = Accountable (decides), C = Consulted (gives input), I = Informed (is kept in the loop). The plugin's manuals use RACI tables to define who leads each phase.

Project size and anti-over-engineering

Porte (project size)

The size and criticality of the project. The plugin classifies it into three sizes: early (floor / small or early-stage project; also the default), scale (growing product), and bigtech (large / highly complex). Headcount alone does not set the porte. Deprecated alias solo normalizes to early. The size decides how many agents step in. The one who classifies it is the Cosimo agent (Chief of Staff).

Levels S0 to S4

A scale similar to the size, used by the /proj_software skill to measure the size of a software project: S0 (tiny script / early minimal), S1 (personal app or MVP), S2 (small product), S3 (medium product), and S4 (large, regulated). The higher the level, the more agents and process.

Over-engineering

Building something more complicated than the problem requires: using heavy technology, creating layers nobody needs, planning for a future that may never come. The plugin fights this by turning on only what is needed for the size. In plain words: "making things more complicated than necessary".

MVP (Minimum Viable Product)

The simplest version of a product that already solves the problem and can really be used. It serves to learn from real users before investing more.

Pipeline

The sequence of phases a product goes through, from idea to launch. The plugin describes a 12-phase pipeline. "Pipeline" means, literally, a set of pipes: the phases flow in order, like water in a pipe.

SDLC (Software Development Life Cycle)

The set of stages to create software: thinking through the problem, designing, programming, testing, launching, and maintaining. The /proj_software skill organizes this cycle into 5 major phases.

GTM (Go-To-Market)

The plan for how to launch and promote a product to the public: positioning, pricing, sales channels, communication. It is the work of the CMO (marketing).

Quality, testing, and planning

TDD (Test-Driven Development)

A programming discipline in which you write a failing test first, then write the code that makes the test pass, and finally improve the code without breaking the test. The cycle has three stages named after colors:

  • Red: write a test for something that does not exist yet; it fails.
  • Green: write the minimum code to make the test pass.
  • Refactor: improve the organization of the code while keeping the test green.

The tdd-guard and tdd-runner hooks help follow this cycle automatically.

Test

A small program that checks whether your code does what it should. If the code breaks, the test fails and warns you. There are several types: unit (tests one isolated piece), integration (tests pieces working together), and e2e (end to end, simulating the real user).

Refactor

Reorganizing the code to make it clearer and easier to maintain, without changing what it does on the outside. Like tidying a drawer: the contents stay the same, but become more organized.

Test suite

The set of all the tests of a project, run together.

Opt-in

A feature that only acts when you choose to enable it. The TDD hooks are opt-in: they only work on projects that have a specific configuration file. Without that file, they stay inert (idle) and do not get in the way.

Fail-open and fail-safe

Fail-open means that if something goes wrong in the hook, it allows the action instead of blocking it, so as to never lock up your work. It is a safety choice so the user does not get stuck because of a plugin defect.

CI (Continuous Integration)

An automatic system that, at each change in the code, runs the tests and checks on a server. It ensures the project keeps working as new changes arrive.

WSJF (Weighted Shortest Job First)

A method to decide the order of tasks. It puts first what delivers the most value for the least effort. The calculation combines the value of doing it now (and the risk of postponing) divided by the size of the work. The /tab_pendencias skill uses WSJF to order the task list. The loose translation is: "do first what delivers the most result with the least work".

Topological sort

A way of ordering tasks while respecting dependencies: nothing appears before what it depends on. If task B can only start after A, the sort places A before B. The /tab_pendencias skill uses this to avoid rework.

Wave

In the task table, a group of steps that can be done at the same time (in parallel) because they do not depend on one another and have similar value. The waves are numbered: W1, W2, W3.

Backlog

The list of everything still left to do in a project. The /tab_pendencias skill organizes the backlog in the best order.

Audit

A quality and security review done after the code has already been written and tested, to confirm that everything is correct. It always comes after the tests, never before.

Documentation

docs-bootstrap

A plugin feature that, at the start of the session, injects into the assistant's context the path to the governance manuals (the docs/ folder). "Bootstrap" here means "automatic initial preparation". That way the assistant knows where to find the rules before it starts working.

Governance manual

A document that defines the rules of the organization: who decides what, how to measure the size, code, testing, and deployment standards. The manuals live in the plugin's docs/ folder (for example, ORG.md).

Diataxis

A method of organizing documentation into four types, according to the reader's need: tutorial (learning from scratch), how-to (solving a specific task), reference (looking up an exact fact), and explanation (understanding why something is the way it is). This wiki follows that principle.

PII (Personally Identifiable Information)

Any data that identifies a person: name, email, phone, address, document. Software that handles PII needs extra care for security and privacy laws (such as the LGPD in Brazil).

LGPD

Lei Geral de Proteção de Dados (General Data Protection Law), the Brazilian law that regulates how personal data may be collected and used. Projects that handle personal data need to comply with it.

Compatibility

caveman

Another Claude Code plugin, incompatible with bigtech. caveman compresses and shortens communication, which conflicts with bigtech's mode reinforcement. The two should not be active at the same time. See Installation.

Suggested dependency

An optional plugin that improves the experience but is not mandatory. bigtech suggests two: playwright (browser automation) and superpowers (advanced flows).


Back to the Home.


Glossário

English above · Português abaixo

Esta página explica os termos técnicos usados no plugin bigtech e nesta wiki, do zero, sem assumir conhecimento prévio. Os termos estão agrupados por assunto. Volte aqui sempre que encontrar uma palavra desconhecida.

Termos do Claude Code e de plugins

Claude Code

Um assistente de inteligência artificial que roda no terminal (a janela de comandos de texto do computador). Você escreve pedidos em português e ele lê arquivos, escreve código, roda comandos e ajuda a construir software. Pense nele como um programador que trabalha junto com você, dentro do seu computador.

Terminal

A janela de texto onde você digita comandos para o computador, em vez de clicar em botões. Também chamada de "linha de comando" ou "console". É onde o Claude Code roda.

Plugin

Um pacote que adiciona recursos novos ao Claude Code, como instalar um aplicativo no celular adiciona funções novas. O bigtech é um plugin.

Marketplace

Uma loja (ou catálogo) de onde se baixam plugins. Para instalar o bigtech, você primeiro registra o marketplace chamado petrinhu e depois instala o plugin bigtech a partir dele. Parecido com adicionar uma fonte de aplicativos antes de instalar um app.

Sessão

Um período de conversa com o Claude Code, do momento em que você abre até fechar. Alguns recursos do plugin (os hooks) só funcionam plenamente depois de reiniciar a sessão, porque eles preparam o ambiente no início.

CWD (current working directory, diretório de trabalho atual)

A pasta em que você está no momento dentro do terminal. O plugin olha para essa pasta para descobrir em qual projeto você está trabalhando.

As três peças do plugin

Agente (em inglês, agent)

Um especialista virtual com um cargo definido (por exemplo, engenheiro de backend ou gerente de produto). Cada agente tem suas regras, seus padrões de qualidade e sabe quando entrar em ação. O Claude Code aciona o agente certo para cada tarefa. O plugin traz 51 agentes.

Subagente (subagent)

Quando o assistente principal aciona um agente especialista para fazer uma parte do trabalho, esse especialista atua como um "subagente": ele recebe a tarefa, executa e devolve o resultado. O assistente principal coordena.

Skill (habilidade de comando)

Um atalho de fluxo pronto que você dispara digitando uma barra e um nome, por exemplo /bigtech. A skill executa vários passos automaticamente. O plugin traz 4 skills: /bigtech, /proj_software, /tab_pendencias e /visual-design-director.

Hook (gancho automático)

Um pequeno programa que dispara sozinho em um momento específico, sem você pedir. Por exemplo: ao iniciar uma sessão, ou logo depois de salvar um arquivo. Os hooks aplicam regras de qualidade e governança de forma automática. O plugin traz 6 hooks.

Evento

O momento que faz um hook disparar. Os principais eventos são: SessionStart (a sessão começa), UserPromptSubmit (você envia uma mensagem), PreToolUse (antes de o assistente usar uma ferramenta, como salvar um arquivo) e PostToolUse (logo depois).

A organização tipo empresa

Constelação

O nome dado ao conjunto dos 12 agentes de liderança (os C-level) trabalhando juntos. Como um time de diretores de uma empresa. A palavra "constelação" é usada porque são vários pontos de liderança que, juntos, formam um desenho.

C-level

Os cargos de alta liderança de uma empresa, cujos títulos costumam começar com "Chief" (chefe) e terminar com "Officer" (diretor): CEO, CTO, CFO, e assim por diante. O "C" vem de "Chief". No plugin são 12 agentes C-level, cada um com nome próprio.

Sigla Cargo em inglês Em português
CEO Chief Executive Officer Diretor-executivo (estratégia geral)
CPO Chief Product Officer Diretor de produto
CTO Chief Technology Officer Diretor de tecnologia
CMO Chief Marketing Officer Diretor de marketing
COO Chief Operating Officer Diretor de operações
CISO Chief Information Security Officer Diretor de segurança da informação
CDO Chief Data Officer Diretor de dados
CAIO Chief AI Officer Diretor de inteligência artificial
CFO Chief Financial Officer Diretor financeiro
CRO Chief Revenue Officer Diretor de receita
CLO Chief Legal Officer Diretor jurídico
Chief of Staff Chief of Staff Chefe de gabinete (organiza e coordena)

Agente operacional

Os 39 agentes que executam o trabalho de mão na massa (programar, testar, escrever documentos, desenhar telas). Eles são acionados pelos C-level ou diretamente pelas skills.

Cargo

A função do agente na empresa. Por exemplo, o cargo do agente backend-engineer é "engenheiro de backend".

Cor e camada

Cada agente tem uma cor que indica seu papel na organização. No bigtech são duas:

  • Laranja: os 12 agentes de liderança C-level (decidem e coordenam).
  • Azul: os 39 agentes operacionais (executam o trabalho).

"Camada" é o nível ao qual o agente pertence: liderança (laranja) ou execução (azul).

Família

Um agrupamento dos agentes operacionais por área de trabalho: Engenharia, Dados e IA, Produto e Design, Gestão e Pessoas, Marketing, e Suporte e Docs. Serve apenas para organizar a leitura.

Backend e frontend

Backend é a parte do software que roda no servidor, longe dos olhos do usuário: banco de dados, regras de negócio, lógica. Frontend é a parte visível: as telas, os botões, a interface com que o usuário interage.

RACI

Uma forma de deixar claro quem faz o que em cada etapa. Cada letra é um papel: R = Responsável (faz acontecer), A = Aprovador (decide), C = Consultado (opina), I = Informado (fica sabendo). Os manuais do plugin usam tabelas RACI para definir quem lidera cada fase.

Tamanho do projeto e anti-over-engineering

Porte

O tamanho e a criticidade do projeto. O plugin classifica em três portes: early (piso / projeto pequeno ou early-stage; também o padrão), scale (produto em crescimento) e bigtech (grande / alta complexidade). Headcount sozinho não define o porte. O alias deprecado solo normaliza para early. O porte decide quantos agentes entram em ação. Quem classifica é o agente Cosimo (Chief of Staff).

Níveis S0 a S4

Uma escala parecida com o porte, usada pela skill /proj_software para medir o tamanho de um projeto de software: S0 (script mínimo / early minimal), S1 (app pessoal ou MVP), S2 (produto pequeno), S3 (produto médio) e S4 (grande, regulado). Quanto maior o nível, mais agentes e processo.

Over-engineering (engenharia em excesso)

Construir algo mais complicado do que o problema exige: usar tecnologia pesada, criar camadas que ninguém precisa, planejar para um futuro que talvez nunca chegue. O plugin combate isso ligando só o necessário para o porte. Em português: "complicar mais do que precisa".

MVP (Minimum Viable Product, produto mínimo viável)

A versão mais simples de um produto que já resolve o problema e pode ser usada de verdade. Serve para aprender com usuários reais antes de investir mais.

Pipeline

A sequência de fases pela qual um produto passa, da ideia até o lançamento. O plugin descreve um pipeline de 12 fases. "Pipeline" significa, ao pé da letra, "tubulação": as fases fluem em ordem, como água num cano.

SDLC (Software Development Life Cycle, ciclo de vida de desenvolvimento de software)

O conjunto de etapas para criar software: pensar o problema, projetar, programar, testar, lançar e manter. A skill /proj_software organiza esse ciclo em 5 grandes fases.

GTM (Go-To-Market, ida ao mercado)

O plano de como lançar e divulgar um produto para o público: posicionamento, preço, canais de venda, comunicação. É o trabalho do CMO (marketing).

Qualidade, testes e planejamento

TDD (Test-Driven Development, desenvolvimento guiado por testes)

Uma disciplina de programação em que você escreve primeiro um teste que falha, depois escreve o código que faz o teste passar, e por fim melhora o código sem quebrar o teste. O ciclo tem três etapas com nomes de cor:

  • Red (vermelho): escreva um teste para algo que ainda não existe; ele falha.
  • Green (verde): escreva o código mínimo para o teste passar.
  • Refactor (refatorar): melhore a organização do código mantendo o teste verde.

Os hooks tdd-guard e tdd-runner ajudam a seguir esse ciclo automaticamente.

Teste

Um pequeno programa que verifica se o seu código faz o que deveria. Se o código quebra, o teste falha e avisa. Há vários tipos: unitário (testa uma peça isolada), de integração (testa peças trabalhando juntas) e e2e (de ponta a ponta, simula o usuário real).

Refatorar (refactor)

Reorganizar o código para deixá-lo mais claro e fácil de manter, sem mudar o que ele faz por fora. Como arrumar uma gaveta: o conteúdo continua o mesmo, mas fica mais organizado.

Suite de testes

O conjunto de todos os testes de um projeto, rodados juntos.

Opt-in (adesão voluntária)

Um recurso que só atua quando você escolhe ativá-lo. Os hooks de TDD são opt-in: só funcionam em projetos que têm um arquivo de configuração específico. Sem esse arquivo, ficam inertes (parados) e não atrapalham.

Fail-open e fail-safe

Fail-open ("falha aberta") significa que, se algo der errado no hook, ele libera a ação em vez de bloquear, para nunca travar o seu trabalho. É uma escolha de segurança para o usuário não ficar preso por um defeito do plugin.

CI (Continuous Integration, integração contínua)

Um sistema automático que, a cada mudança no código, roda os testes e verificações em um servidor. Garante que o projeto continua funcionando conforme novas alterações chegam.

WSJF (Weighted Shortest Job First, menor trabalho ponderado primeiro)

Um método para decidir a ordem das tarefas. Ele coloca primeiro o que dá mais valor por menos esforço. A conta combina o valor de fazer agora (e o risco de adiar) dividido pelo tamanho do trabalho. A skill /tab_pendencias usa WSJF para ordenar a lista de tarefas. A tradução livre é: "faça primeiro o que entrega mais resultado com menos trabalho".

Ordenação topológica (topological sort)

Uma forma de ordenar tarefas respeitando dependências: nada aparece antes daquilo de que depende. Se a tarefa B só pode começar depois da A, a ordenação coloca A antes de B. A skill /tab_pendencias usa isso para evitar retrabalho.

Onda

Na tabela de tarefas, um grupo de passos que podem ser feitos ao mesmo tempo (em paralelo) porque não dependem uns dos outros e têm valor parecido. As ondas são numeradas: W1, W2, W3.

Backlog

A lista de tudo o que ainda falta fazer em um projeto. A skill /tab_pendencias organiza o backlog na melhor ordem.

Auditoria

Uma revisão de qualidade e segurança feita depois que o código já foi escrito e testado, para confirmar que está tudo correto. Sempre vem depois dos testes, nunca antes.

Documentação

docs-bootstrap

Um recurso do plugin que, no início da sessão, injeta no contexto do assistente o caminho até os manuais de governança (a pasta docs/). "Bootstrap" aqui significa "preparação inicial automática". Assim o assistente sabe onde encontrar as regras antes de começar a trabalhar.

Manual de governança

Documento que define as regras da organização: quem decide o que, como medir o porte, padrões de código, de testes e de deploy. Os manuais ficam na pasta docs/ do plugin (por exemplo, ORG.md).

Diataxis

Um método de organizar documentação em quatro tipos, conforme a necessidade do leitor: tutorial (aprender do zero), how-to (resolver uma tarefa específica), reference (consultar um dado exato) e explanation (entender por que algo é assim). Esta wiki segue esse princípio.

PII (Personally Identifiable Information, informação pessoal identificável)

Qualquer dado que identifique uma pessoa: nome, e-mail, telefone, endereço, documento. Software que lida com PII precisa de cuidados extras de segurança e de leis de privacidade (como a LGPD no Brasil).

LGPD

Lei Geral de Proteção de Dados, a lei brasileira que regula como dados pessoais podem ser coletados e usados. Projetos que tratam dados pessoais precisam respeitá-la.

Compatibilidade

caveman

Outro plugin do Claude Code, incompatível com o bigtech. O caveman comprime e encurta a comunicação, o que conflita com o reforço de modo do bigtech. Os dois não devem ficar ativos ao mesmo tempo. Veja Instalação.

Dependência sugerida

Um plugin opcional que melhora a experiência, mas não é obrigatório. O bigtech sugere dois: playwright (automação de navegador) e superpowers (fluxos avançados).


Voltar para a Home.

Clone this wiki locally