E156 Ecosystem Starter — Início rápido (português)

O mais fácil — instalação completa no navegador, sem terminal

Se você nunca usou um terminal, clique neste botão. Um espaço de trabalho gratuito do GitHub abre com todo o sistema pré-instalado: regras, memória, hook Sentinel, verificador Overmind com chave HMAC TruthCert, semente ProjectIndex e Gemini CLI. Nada é instalado no seu laptop.

Abrir no GitHub Codespaces →

Construção ~2-3 min. Melhor num computador — Codespaces num browser de telemóvel funciona mas o terminal é instável.

Ainda não tem conta GitHub? Leia isto primeiro.

Se tem um email universitário em .ac.mz, .edu.br, .ao, etc. — peça primeiro GitHub Education. Recebe 90 horas grátis de Codespaces/mês (em vez de 60), sem passo de verificação por telemóvel, e acesso a outras ferramentas pagas.
Se só tem email pessoal (Gmail/Yahoo) — registe-se em github.com/signup. O GitHub pede verificação SMS; pode falhar silenciosamente em algumas redes móveis africanas (Vivo, Tim, Movicel). Se o código não chegar, tente outra rede ou use a via GitHub Education acima.
Se o telemóvel é o seu único dispositivo — peça emprestado um portátil para os primeiros 90 minutos; depois pode escrever do telemóvel via o editor web do GitHub.

O que é um GitHub Codespace? (1 parágrafo)

Um Codespace é um computador Linux que corre na cloud do GitHub, com VS Code (um editor de código) aberto no seu navegador web. Nada se instala no seu portátil — tudo acontece na máquina cloud. Escreve código no navegador, guarda no GitHub, e continua lá quando fecha o separador. Grátis 60 horas/mês em contas pessoais (90 em contas Education), depois pausa até ao próximo mês. Como o Google Docs, mas para um ambiente de programação.

Já instalou uma versão anterior? (atualização)

Se executou o instalador antes (ex. v0.7.0 em março), volte a executar o mesmo one-liner no topo desta página. O novo bootstrap puxa a última release com tag e sobrescreve as suas regras + templates de memória. Os seus ficheiros editados (*.md.user) são preservados. Para verificar a versão instalada, em qualquer terminal Codespace execute e156 version.

Dica i18n: para ter tudo em português dentro do Codespace, adicione E156_LANG=pt aos seus segredos de utilizador em github.com/settings/codespaces. Aplica-se a todos os codespaces que abrir.

Dica — pare o seu codespace quando terminar. Codespaces inativos continuam consumindo as suas horas mensais até serem suspensos automaticamente (padrão: 30 min). Para parar imediatamente: vá a github.com/codespaces e clique em ⋯ → Stop codespace, ou execute gh codespace stop num terminal. Com 60 horas grátis por mês, deixar uma aba aberta o dia todo esgotará a sua cota em menos de uma semana.

Nota: esta é uma versão resumida em português. A versão completa em inglês contém todas as instruções detalhadas (pré-requisitos, resolução de problemas, modelo de segurança, projetos de exemplo). Os comandos de instalação abaixo são idênticos em todos os idiomas.

Instalação — Windows

Abra o PowerShell (não o Command Prompt). Pressione Win+R, digite powershell, Enter. Cole:

irm https://mahmood726-cyber.github.io/e156-ecosystem-starter/bootstrap.ps1 | iex

Instalação — macOS / Linux / WSL

curl -fsSL https://mahmood726-cyber.github.io/e156-ecosystem-starter/e156-setup.sh | bash

Verificar a instalação

# Windows PowerShell
ls $env:USERPROFILE\.claude\rules

# macOS / Linux / WSL
ls ~/.claude/rules

Você deve ver quatro arquivos .md: e156, lessons, advanced-stats, rules.

Próximo passo — produzir trabalho com a mesma qualidade

Instalar as regras é apenas metade do trabalho. A outra metade é usá-las com o mesmo método: brainstorm → spec-lock → plan-lock → TDD → audit.

Leia o STUDENT-WORKFLOW.md (em inglês) para o guia completo: o método passo a passo, os repositórios de exemplo para clonar, e como o Sentinel e o Overmind funcionam como controles de qualidade.

Pré-requisitos

Python 3.11+ de python.org/downloads (marque "Add python.exe to PATH").
R 4.5+ de cran.r-project.org.
Node.js 20+ de nodejs.org.
Uma CLI de agente de IA: Gemini CLI (gratuito), Claude Code (pago), ou OpenAI Codex.

Em caso de problema

Veja a seção "What if something goes wrong" na página em inglês.
O instalador grava um log em %LOCALAPPDATA%\e156\logs\install-<ts>.log (Windows) ou ~/.local/state/e156/logs/install-<ts>.log (Linux/WSL). Chaves de API e segredos são automaticamente mascarados antes de qualquer compartilhamento.