Skip to content

Uso

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

Day-to-day usage

English below · Português abaixo

This page teaches you how to use the bigtech plugin day to day, with simple examples. If any term is new, check the Glossary. To install first, see Installation.

The general idea

You do not need to memorize anything. The plugin has 4 entry points (the skills), and you trigger them by typing a slash (/) and the name inside Claude Code. You can also just describe what you want in plain language: the plugin recognizes the intent and routes it to the right skill.

The 4 skills are:

Skill What it is for When to use it
/bigtech Assembles the team of specialists and measures the size of the project "organize as a company", "who handles this", "what is the size"
/proj_software Drives the building of a piece of software from start to finish "I am going to create a system", "build a feature"
/tab_pendencias Organizes the task list in the best order "what is left", "in what order to do it", "plan"
/visual-design-director Drives the high-fidelity visual design of a product, rendered in the browser "design this screen", "make it modern", "redesign", "rendered mockup", "dark mode"

Each skill has its own page with more detail: /bigtech, /proj_software, /tab_pendencias, /visual-design-director.

Starting a project: /bigtech

When you want to structure a project as a software company, start here. The skill calls the Cosimo agent (the Chief of Staff), who measures the size of the project (the porte) and returns the team map: which leaders and which specialists join, and in which phases.

Official porte values are only three:

Porte Meaning (short)
early Floor / default. Small or early-stage project. Most C-levels stay dormant.
scale Growing product, more process and more specialists.
bigtech Large / highly complex org; full constellation.

Headcount alone does not set the porte (complexity, criticality, and scale do). The floor is always early — even a one-person project is classified as early, not as a separate band.

Deprecated alias: if you pass --porte solo, the skill accepts it and normalizes to early, with a short warning. "Solo" is informal language only; it is not a porte category and must not be written into new .bigtech-porte markers.

Examples of how to invoke it:

/bigtech ./my-project
/bigtech "scheduling app for clinics"
/bigtech ./my-project --porte early

In the first example, you point to an existing project folder. In the second, you describe the idea in words. In the third, you give an explicit porte hint (Cosimo still validates it against project signals). The plugin never turns on the whole company for a small project: it calibrates by porte, avoiding over-engineering.

Use /bigtech when you think in phrases like: "assemble the team", "organize as a bigtech", "who leads this", "classify the size", or "structure the project's company".

Building software: /proj_software

When the focus is building the software itself (programming, testing, releasing), use this skill. It drives the software life cycle through 5 major phases and only calls the engineers needed for the size of the project.

Examples:

/proj_software
/proj_software "payments API with idempotency"

Use /proj_software when you think in phrases like: "I am going to create software", "new system", "build this feature", or "which flow to follow".

The difference from /bigtech: /bigtech handles the business and leadership side (product, marketing, sales, legal) and delegates the engineering part to /proj_software. On engineering-only projects, you can go straight to /proj_software.

Planning tasks: /tab_pendencias

When you want to organize what is left to do, use this skill. It creates and maintains a task table ordered top to bottom in the best sequence, so as to avoid rework. Tasks that can be done at the same time appear in the same "wave".

Examples:

/tab_pendencias --create
/tab_pendencias --show
/tab_pendencias --reorder

What each one does:

  • --create: creates the task table from scratch.
  • --show: shows the full table, including what has already been completed.
  • --reorder: reorders the table when new tasks come in or dependencies change.

When the table plans a test or an audit whose external tool is missing, the agent offers to install it with your confirmation, using the command that fits your OS (apt/dnf/brew/winget/choco/scoop) and preferring cross-platform managers (pip/uv, cargo, npm). It never installs silently, and it never skips the step without telling you.

The table is written to the TODO.md file at the root of the project. Use this skill when you think: "what is left", "in what order to do it", "plan the steps", or "organize the backlog".

To keep the table fresh, follow a cheap convention: when a commit closes or advances a task, cite its ID in the commit message and update the Status column in the same commit, marking delivered work as pending verification and moving it to done only after the test and audit wave (see Skill: tab_pendencias for the details).

Speaking in plain language, without a command

You are not required to remember the slash commands. You can simply write what you want, for example:

  • "I want to assemble the team for this project." -> the plugin routes to /bigtech.
  • "I am going to create a sign-up system." -> the plugin routes to /proj_software.
  • "What is still left to do here?" -> the plugin routes to /tab_pendencias.

This works because of the bigtech-reinforce hook, which recognizes the intent and steers it to the right skill.

You are the one in charge

At any moment, the final decision is yours. The agents propose paths and execute them, but on important choices (what to build, which technology to use, how much to spend, what to publish) they ask first, presenting the options with the recommended one in first place. If a decision of yours could cause a problem, a good agent will point out the risk and suggest an alternative, but the final word remains yours.

The agents check the planning before they start

Whenever a specialist agent is called on a project, it runs a quick start-up check, a "pre-flight of the pending-tasks table": it checks whether the TODO.md file (the task table from /tab_pendencias) already exists at the root.

  • If the table does not exist, the agent warns right at the start of the reply that it recommends generating it (by running /tab_pendencias) before proceeding, and goes on with the task you asked for. It does not create the table on its own, because the one who starts skills is the main thread, not the agents.
  • If the table exists, the agent aligns the work with it: it respects the waves, the task identifiers, and the prerequisites.

This behavior applies to all 51 agents, from leadership to operational. The goal is simple: to prevent someone from starting to work out of order and generating rework. You do not need to do anything to activate it; it is automatic.

Typical flow of a new project

A common path, from start to finish:

  1. /bigtech to measure the size and assemble the right team.
  2. /proj_software to drive the building of the software through the engineering specialists.
  3. /tab_pendencias to organize what is left and in what order to do it.
  4. At each important milestone (the end of a phase, a launch, a change in team size), go back to /bigtech to re-evaluate whether the project has grown or shrunk in size.

For the detail of each skill, see /bigtech, /proj_software, and /tab_pendencias. Back to the Home.

Uso no dia a dia

English above · Português abaixo

Esta página ensina a usar o plugin bigtech no dia a dia, com exemplos simples. Se algum termo for novo, consulte o Glossário. Para instalar antes, veja Instalação.

A ideia geral

Você não precisa decorar nada. O plugin tem 4 pontos de entrada (as skills), e você os aciona digitando uma barra (/) e o nome dentro do Claude Code. Também dá para apenas descrever o que quer em português: o plugin reconhece a intenção e roteia para a skill certa.

As 4 skills são:

Skill Para que serve Quando usar
/bigtech Monta a equipe de especialistas e mede o tamanho do projeto "organizar como empresa", "quem cuida disso", "qual o porte"
/proj_software Conduz a construção de um software do início ao fim "vou criar um sistema", "construir uma funcionalidade"
/tab_pendencias Organiza a lista de tarefas na melhor ordem "o que falta", "em que ordem fazer", "planejar"
/visual-design-director Conduz o design visual de alta fidelidade de um produto, renderizado no navegador "desenhar esta tela", "deixar moderno", "redesign", "mockup renderizado", "dark mode"

Cada skill tem sua própria página com mais detalhes: /bigtech, /proj_software, /tab_pendencias, /visual-design-director.

Começando um projeto: /bigtech

Quando você quer estruturar um projeto como uma empresa de software, comece por aqui. A skill aciona o agente Cosimo (o Chief of Staff), que mede o tamanho do projeto (o porte) e devolve o mapa da equipe: quais líderes e quais especialistas entram, e em quais fases.

Os valores oficiais de porte são só três:

Porte Significado (curto)
early Piso / padrão. Projeto pequeno ou em estágio inicial. A maioria dos C-levels fica dormente.
scale Produto em crescimento, mais processo e mais especialistas.
bigtech Organização grande / muito complexa; constelação completa.

Headcount sozinho não define o porte (complexidade, criticidade e escala definem). O piso é sempre early — mesmo um projeto de uma pessoa classifica-se como early, não como uma faixa separada.

Alias deprecado: se você passar --porte solo, a skill aceita e normaliza para early, com um aviso curto. "Solo" é linguagem informal; não é categoria de porte e não deve ser gravado em marcadores novos .bigtech-porte.

Exemplos de como invocar:

/bigtech ./meu-projeto
/bigtech "app de agenda para clinicas"
/bigtech ./meu-projeto --porte early

No primeiro exemplo, você aponta para uma pasta de projeto existente. No segundo, você descreve a ideia em palavras. No terceiro, você dá um hint explícito de porte (o Cosimo ainda valida contra os sinais do projeto). O plugin nunca liga a empresa inteira para um projeto pequeno: ele calibra pelo porte, evitando over-engineering.

Use /bigtech quando pensar em frases como: "montar o time", "organizar como bigtech", "quem lidera isso", "classificar o porte" ou "estruturar a empresa do projeto".

Construindo software: /proj_software

Quando o foco é construir o software em si (programar, testar, lançar), use esta skill. Ela conduz o ciclo de vida do software em 5 grandes fases e aciona só os engenheiros necessários para o tamanho do projeto.

Exemplos:

/proj_software
/proj_software "API de pagamentos com idempotencia"

Use /proj_software quando pensar em frases como: "vou criar um software", "novo sistema", "construir essa funcionalidade" ou "qual fluxo seguir".

A diferença para a /bigtech: a /bigtech cuida do lado de negócio e liderança (produto, marketing, vendas, jurídico) e delega a parte de engenharia para a /proj_software. Em projetos só de engenharia, você pode ir direto à /proj_software.

Planejando tarefas: /tab_pendencias

Quando você quer organizar o que falta fazer, use esta skill. Ela cria e mantém uma tabela de tarefas ordenada de cima para baixo na melhor sequência, de modo a evitar retrabalho. Tarefas que podem ser feitas ao mesmo tempo aparecem na mesma "onda".

Exemplos:

/tab_pendencias --create
/tab_pendencias --show
/tab_pendencias --reorder

O que cada um faz:

  • --create: cria a tabela de tarefas do zero.
  • --show: mostra a tabela completa, incluindo o que já foi concluído.
  • --reorder: reordena a tabela quando novas tarefas entram ou as dependências mudam.

Quando a tabela planeja um teste ou uma auditoria cuja ferramenta externa está ausente, o agente oferece instalá-la com a sua confirmação, no comando adequado ao seu SO (apt/dnf/brew/winget/choco/scoop) e preferindo gerenciadores cross-platform (pip/uv, cargo, npm). Ele nunca instala em silêncio nem pula o passo sem avisar.

A tabela é gravada no arquivo TODO.md na raiz do projeto. Use esta skill quando pensar: "o que falta", "em que ordem fazer", "planejar os passos" ou "organizar o backlog".

Para manter a tabela viva, siga uma convenção barata: quando um commit fecha ou avança uma tarefa, cite o ID dela na mensagem do commit e atualize a coluna Status no mesmo commit, marcando o trabalho entregue como pendente de verificação e só passando para concluído depois da onda de teste e auditoria (veja a Skill: tab_pendencias para os detalhes).

Falando em português, sem comando

Você não é obrigado a lembrar dos comandos com barra. Pode simplesmente escrever o que quer, por exemplo:

  • "Quero montar o time para este projeto." -> o plugin roteia para /bigtech.
  • "Vou criar um sistema de cadastro." -> o plugin roteia para /proj_software.
  • "O que ainda falta fazer aqui?" -> o plugin roteia para /tab_pendencias.

Isso funciona por causa do hook bigtech-reinforce, que reconhece a intenção e direciona para a skill certa.

Quem manda é você

Em qualquer momento, a decisão final é sua. Os agentes propõem caminhos e executam, mas em escolhas importantes (o que construir, qual tecnologia usar, quanto gastar, o que publicar) eles perguntam antes, apresentando as opções com a recomendada em primeiro lugar. Se uma decisão sua puder causar problema, um bom agente vai apontar o risco e sugerir alternativa, mas a palavra final continua sendo sua.

Os agentes checam o planejamento antes de começar

Sempre que um agente especialista é acionado em um projeto, ele faz uma checagem rápida de início, um "pre-flight da tabela de pendências": confere se já existe o arquivo TODO.md (a tabela de tarefas da /tab_pendencias) na raiz.

  • Se a tabela não existe, o agente avisa logo no começo da resposta que recomenda gerá-la (rodando a /tab_pendencias) antes de prosseguir e segue com a tarefa que você pediu. Ele não cria a tabela sozinho, porque quem inicia skills é a thread principal, não os agentes.
  • Se a tabela existe, o agente alinha o trabalho a ela: respeita as ondas, os identificadores das tarefas e os pré-requisitos.

Esse comportamento vale para os 51 agentes, da liderança aos operacionais. O objetivo é simples: evitar que alguém comece a trabalhar fora de ordem e gere retrabalho. Você não precisa fazer nada para ativá-lo; é automático.

Fluxo típico de um projeto novo

Um caminho comum, do começo ao fim:

  1. /bigtech para medir o porte e montar a equipe certa.
  2. /proj_software para conduzir a construção do software pelos especialistas de engenharia.
  3. /tab_pendencias para organizar o que falta e em que ordem fazer.
  4. A cada marco importante (fim de uma fase, um lançamento, mudança de tamanho da equipe), volte à /bigtech para reavaliar se o projeto cresceu ou diminuiu de porte.

Para o detalhe de cada skill, veja /bigtech, /proj_software e /tab_pendencias. Voltar para a Home.

Clone this wiki locally