Sistema Operacional Agentivo

Trate o Claude Code como um ambiente de execução persistente / sistema operacional, em vez de uma sessão de chat. Esta habilidade codifica a arquitetura usada por configurações agentivas de produção: uma configuração de kernel que roteia tarefas para agentes especialistas, memória persistente baseada em arquivos, automação agendada e uma camada de dados JSON/markdown.

Quando Ativar

• Construindo um fluxo de trabalho multiagente dentro do Claude Code
• Configurando automação persistente no Claude Code que sobrevive a reinícios de sessão
• Criando um "sistema operacional pessoal" ou "sistema operacional agentivo" para tarefas recorrentes
• O usuário diz "sistema operacional agentivo", "sistema operacional pessoal", "multiagente", "coordenador de agente", "agente persistente"
• Estruturando projetos de longa duração onde o contexto deve sobreviver entre as sessões

Visão Geral da Arquitetura

O Sistema Operacional Agentivo tem quatro camadas. Cada camada é um diretório na raiz do seu projeto.

project-root/
├── CLAUDE.md          # Kernel: identity, routing rules, agent registry
├── agents/            # Specialist agent definitions (markdown prompts)
├── .claude/commands/  # Slash commands: user-facing CLI
├── scripts/           # Daemon scripts: scheduled or event-driven tasks
└── data/              # State: JSON/markdown filesystem, no external DB

Responsabilidades das Camadas

O Kernel

CLAUDE.md é o kernel. Ele atua como o COO / orquestrador. O Claude o lê no início da sessão e o usa para rotear o trabalho.

Estrutura do Kernel

# CLAUDE.md - Agentic OS Kernel

## Identity
You are the COO of [project-name]. You route tasks to specialist agents.
You never write code directly. You delegate to the right agent and synthesize results.

## Agent Registry

| Agent | Role | Trigger |
|---|---|---|
| @dev | Code, architecture, debugging | User says "build", "fix", "refactor" |
| @writer | Documentation, content, emails | User says "write", "draft", "blog" |
| @researcher | Research, analysis, fact-checking | User says "research", "analyze", "compare" |
| @ops | DevOps, deployment, infrastructure | User says "deploy", "CI", "server" |

## Routing Rules
1. Parse the user request for intent keywords
2. Match to the Agent Registry trigger column
3. Load the corresponding agent file from `agents/<name>.md`
4. Hand off execution with full context
5. Synthesize and present the result back to the user

## Model Policies
- Default model: use the repository or harness default.
- @dev tasks: prefer a higher-reasoning model for complex architecture.
- @researcher tasks: use the configured research-capable model and approved search tools.
- Cost ceiling: warn before exceeding the project's configured spend threshold.

Princípio Chave

O kernel deve ser pequeno e declarativo. A lógica de roteamento vive em tabelas markdown simples, não em código. Isso torna o sistema inspecionável e editável sem depuração.

Agentes Especialistas

Cada agente é um arquivo markdown independente em agents/. O Claude carrega o arquivo de agente relevante ao rotear uma tarefa.

Formato de Definição do Agente

# @dev - Software Engineer

## Identity
You are a senior software engineer. You write clean, tested, production-grade code.
You prefer simple solutions. You ask clarifying questions when requirements are ambiguous.

## Memory Scope
- Read `data/projects/<current-project>.md` for context
- Read `data/decisions/` for architectural decisions
- Append execution logs to `data/logs/<date>-@dev.md`

## Tool Access
- Full filesystem access within project root
- Git operations (status, diff, commit, branch)
- Test runner access
- MCP servers as configured in `.claude/mcp.json`

## Constraints
- Always write tests for new features
- Never commit directly to `main`; use feature branches
- Prefer editing existing files over creating new ones
- Keep functions under 50 lines when possible

Padrão de Colaboração Multiagente

Quando uma tarefa abrange vários agentes, o kernel os executa sequencialmente ou em paralelo:

Usuário: "Construa uma landing page e escreva o post do blog de lançamento"

Roteamento do Kernel:

…