Sistema Operativo Agêntico · v0.6.0

Claude Code como um sistema operativo profissional

Memória persistente, 23 skills curadas e operação multi-cliente — tudo instalado em 15-20 minutos com um script.

Sinapsis v4.5 MIT Português Multi-cliente
O que é

Três camadas que transformam o Claude Code

iAmasters OS não é um plugin — é uma arquitectura completa que empilha memória, contexto e skills numa sessão profissional.

🧠 Sinapsis v4.5

Engine de memória persistente que aprende os seus instintos e os converte em regras auto-aplicadas. Acaba o "explica-me a tua stack outra vez".

🗂️ Camada OS

Brand context, agent context, projetos estruturados e templates por vertical. Suporta múltiplos clientes com isolamento de contexto.

⚡ 23 Skills Curadas

Skills validadas para marketing, estratégia, automação e visualização. Activam-se automaticamente quando fala com o Claude sobre os temas certos.

Como funciona

Do script ao primeiro entregável em 20 minutos

O install gate guia as 4 fases conversacionais depois da instalação técnica. Se interromper, o /install --resume retoma exactamente onde parou.

git clone install.sh SessionStart hook /install Onboarding Wizard Welcome Quick-Win

🔧 Fases técnicas (terminal)

Script valida pré-requisitos, instala o engine Sinapsis e configura o state machine persistente. Usa validação profunda, não só presença de ficheiros.

💬 Fases conversacionais (Claude Code)

O hook SessionStart detecta o que falta e guia o agente. O onboarding wizard entrevista-o por sub-fases com commits incrementais — dados nunca se perdem.

Pré-requisitos

O que precisa antes de instalar

Sem programação — mas precisa do Claude e do terminal.

🤖 Claude Desktop + Pro

Claude Desktop (gratuito) e um plano Anthropic Pro ($20/mês). O plano Free não tem modelos suficientes para o OS funcionar bem.

# Descarregue em
https://claude.com/download

🐙 Git

Para clonar o repositório. Já vem instalado no macOS e na maioria dos Linux.

git --version  # verificar
# macOS: xcode-select --install
# Ubuntu: sudo apt install git

🖥️ Terminal

Terminal nativo do macOS, Linux, ou Windows Terminal com WSL. As fases técnicas correm no terminal, não dentro do Claude.

# Testar bash disponível
bash --version
Guia de uso · passo a passo

Instalação e primeiros passos

Total realista: 15-20 minutos. Se algo falhar, o --resume retoma sem perder dados.

1

Clonar o repositório

Clone para a sua home. O script de instalação espera a pasta ~/iamasters-os.

git clone https://github.com/iamasters-academy/iamasters-os.git ~/iamasters-os
cd ~/iamasters-os
2

Executar o script de instalação

Instala pré-requisitos e o engine Sinapsis com validação profunda. Demora ~5 minutos.

bash scripts/install.sh
# Se algo falhar no meio:
bash scripts/install.sh --resume
# Para começar limpo:
bash scripts/install.sh --force-reinstall
3

Abrir o Claude Code nesta pasta

O hook SessionStart detecta automaticamente as fases que faltam e guia o agente.

# Abrir o Claude Code na pasta do projecto
claude   # ou abrir pelo Claude Desktop → Open Folder → ~/iamasters-os
4

Executar /install dentro do Claude Code

O agente orquestra as 4 fases conversacionais: onboarding wizard, brand context, agent context e welcome quick-win.

/install            # inicia todas as fases
/install-status     # ver dashboard sem tocar em nada
/install --resume   # retomar se interrompeu
5

Completar o onboarding wizard

O wizard entrevista-o por sub-fases com commits incrementais. Demora ~10 minutos. No final gera o welcome-quick-win — o seu primeiro entregável real.

# Dentro do wizard, responda às perguntas sobre:
#   → a sua marca (voz, posicionamento, ICP)
#   → os seus clientes e prioridades
#   → os seus objectivos com IA
6

Usar o sistema no dia a dia

Depois do setup, o OS activa-se automaticamente em cada sessão. Use os comandos principais para operar.

/doctor         # diagnosticar e corrigir desvios
/aprende        # instalar skills oficiais Anthropic
/cliente new    # criar contexto para novo cliente
Roadmap

Evolução do iAmasters OS

Sistema vivo — cresce com a comunidade IA Masters Academy.

v0.6 ✅
State machine persistenteInstall gate com validação profunda. Onboarding com commits incrementais. Dashboard /install-status.
Activo
Catálogo de skills23 skills curadas em produção. Crescimento via propostas da comunidade (docs/skills-recommended.md).
Próximo
Marketplace de skillsSkills oficiais Anthropic (docx, xlsx, pdf, pptx) via /aprende · dia 4.
Futuro
Multi-cliente avançadoTemplates adicionais de vertical e isolamento de contexto aprimorado para agências.