diff --git a/README.md b/README.md
index 25ac003..158888b 100644
--- a/README.md
+++ b/README.md
@@ -1,98 +1,216 @@
-
+
+ 
+
-# mikael-3.3-co-behavior
+
+ Behavioral discipline for AI agents — inspired by Claude Opus 4.7
+
-> What if your agent had the behavioral discipline of Claude Opus 4.7 — search-first, copyright-aware, tool-routing logic — as a reusable skill?
+
+
+ 
+
+
+ 
+
+ 
+
-A behavioral framework for AI agents, adapted from the patterns I observed inside Claude Opus 4.7's system prompt.
+
-## The idea
+---
-I spent time reverse-engineering how top-tier models behave internally — not just *what* they say, but *how* they decide to say it. When to search vs. answer from memory. When to create a file vs. respond inline. How to handle copyright without breaking flow. How to route between tools without narrating the decision.
+
-These aren't magic. They're **engineering patterns**. And they're transferable.
+## ✦ The Story
-So I extracted the principles, restructured them in my own format, and packaged them as a skill that any agent in the open skills ecosystem can install.
+Most AI agents feel like they're guessing. They answer from training data when they should search. They create files for everything or nothing. They over-format, narrate their decisions, and ignore copyright.
-## What you get
+I spent time reverse-engineering how **Claude Opus 4.7** behaves internally — not just *what* it says, but *how* it decides to say it. The patterns I found weren't magic. They were **engineering discipline**.
-| Capability | Before | After |
-|------------|--------|-------|
-| **Search discipline** | Guesses from training data | Searches before every present-day factual question |
-| **Copyright** | Quotes freely, risks reproduction | 15-word max per quote, one per source, paraphrase-first |
-| **Tool routing** | Picks tools randomly or narrates the choice | Clear decision tree: MCP → file → visualizer → inline |
-| **File creation** | Creates files for everything or nothing | Concrete triggers: blog post → file, explanation → inline |
-| **Tone** | Over-formatted, bullet-heavy, robotic | Natural prose, minimal formatting, concise |
-| **Safety** | Inconsistent boundaries | Structured child safety, mental health, harmful content filters |
+So I extracted them, restructured them in my own format, and built **Mikael** — a behavioral framework skill that brings production-grade agent behavior to any system in the open skills ecosystem.
-## Quick install
+
+
+## ✦ What Changes
+
+
+
+ | Before |
+ |
+ After |
+
+
+ | 🎲 Guesses from training data |
+ → |
+ 🔍 Searches before every factual question |
+
+
+ | 📋 Over-formatted, bullet-heavy |
+ → |
+ ✍️ Natural prose, minimal formatting |
+
+
+ | 📁 Creates files for everything or nothing |
+ → |
+ 📄 Concrete triggers: blog post → file, explanation → inline |
+
+
+ | ⚖️ Ignores copyright boundaries |
+ → |
+ 🛡️ 15-word max per quote, paraphrase-first |
+
+
+ | 🔀 Picks tools randomly |
+ → |
+ 🧭 Clear decision tree: MCP → file → visualizer → inline |
+
+
+ | 🚫 Inconsistent safety boundaries |
+ → |
+ 🧒 Structured child safety, mental health, content filters |
+
+
+
+
+
+---
+
+
+
+## ⚡ Quick Install
```bash
npx skills add domfelipe/mikael-3.3-co-behavior
```
-That's it. The agent picks up the behavioral constraints on next load.
+That's it. Your agent picks up the behavioral constraints on next load.
-## What's inside
+
-- **Core Behavior** — default stance, tone rules, refusal handling
-- **Search Policy** — when to search, how to construct queries, scaling effort to complexity
-- **Copyright Rules** — hard limits, paraphrase-first, content safety
-- **File Handling** — creation triggers, directory structure, artifact criteria
-- **Tool Routing** — decision trees for web_search, image_search, visualize, computer_use
-- **Visualizer** — 4-step routing: visual needed → MCP fit → file request → inline widget
-- **API Patterns** — Claudeception, MCP integration, context window management
-- **Memory System** — conversation search cues, past chat retrieval
+## 📦 What's Inside
-## Who is this for?
+| Module | What It Does |
+|--------|-------------|
+| 🧠 **Core Behavior** | Default stance, tone rules, refusal handling, user wellbeing |
+| 🔍 **Search Policy** | When to search vs. answer from memory, query construction, effort scaling |
+| 🛡️ **Copyright Rules** | Hard limits, paraphrase-first, content safety filters |
+| 📄 **File Handling** | Creation triggers, directory structure, artifact criteria |
+| 🧭 **Tool Routing** | Decision trees for web_search, image_search, visualize, computer_use |
+| 🎨 **Visualizer** | 4-step routing: visual needed → MCP fit → file request → inline widget |
+| 🔌 **API Patterns** | Claudeception, MCP integration, context window management |
+| 💭 **Memory System** | Conversation search cues, past chat retrieval patterns |
+
+
+
+## 🎯 Who Is This For?
- **Agent builders** who want production-grade behavioral constraints without writing them from scratch
- **Prompt engineers** studying how top models handle tool routing, safety, and content creation
- **Developers** tired of agents that over-format, skip searches, or ignore copyright
-- **Curious folks** who want to peek behind the curtain of how advanced agents are configured
+- **Curious minds** who want to peek behind the curtain of how advanced agents are configured
-## Design decisions
+
+
+## 🏗️ Design Philosophy
+
+> **Adapted, not copied.** Inspired by Opus 4.7, but restructured and rewritten in my own format. The organization and emphasis reflect my own judgment about what matters.
-- **Adapted, not copied** — Inspired by Opus 4.7, but restructured and rewritten in my own format. The organization and emphasis reflect my own judgment.
- **Modular** — Each section is self-contained. Agents can reference specific modules without loading everything.
- **Practical** — Every rule maps to a concrete behavior. No abstract principles.
+- **Transferable** — These patterns work across agents, not just one model.
-## Try it out
+
-Install it, load it on your agent, and notice the difference in how it handles searches, files, and formatting. If something feels off or you have ideas for improvements, open an issue or PR — this is a living project.
+## 🚀 Try It Out
-## Disclaimer
+Install it. Load it on your agent. Notice the difference in how it handles searches, files, and formatting.
-This skill is inspired by publicly observable behavior from Claude Opus 4.7 but is my own adaptation. It is not affiliated with, endorsed by, or sourced directly from Anthropic. Some patterns may differ from the actual model configuration.
+If something feels off or you have ideas for improvements, **open an issue or PR** — this is a living project.
+
+
---
-## 🇧🇷 Português
+
-> E se seu agente tivesse a disciplina comportamental do Claude Opus 4.7 — busca antes de responder, respeito a direitos autorais, roteamento inteligente entre ferramentas — como uma skill reutilizável?
+
+ This skill is inspired by publicly observable behavior from Claude Opus 4.7 but is my own adaptation. It is not affiliated with, endorsed by, or sourced directly from Anthropic.
+
-Um framework comportamental para agentes de IA, adaptado a partir dos padrões que observei dentro do system prompt do Claude Opus 4.7.
+
-### A ideia
+---
-Passei tempo analisando como modelos de ponta se comportam internamente — não apenas *o que* dizem, mas *como* decidem dizer. Quando buscar na web vs. responder da memória. Quando criar um arquivo vs. responder no chat. Como lidar com copyright sem quebrar o fluxo. Como rotear entre ferramentas sem narrar a decisão.
+
+
+
+ 
+
+
+
+ 🇧🇷 Português
+
+
+
+ Um framework comportamental para agentes de IA, adaptado a partir dos padrões que observei dentro do system prompt do Claude Opus 4.7.
+
+
+
+
+### ✦ A Ideia
+
+Passei tempo analisando como modelos de ponta se comportam internamente — não apenas *o que* dizem, mas *como* decidem dizer. Quando buscar na web vs. responder da memória. Quando criar um arquivo vs. responder no chat. Como lidar com copyright sem quebrar o fluxo.
Isso não é mágica. São **padrões de engenharia**. E são transferíveis.
Extraí os princípios, reestruturei no meu próprio formato e empacotei como uma skill que qualquer agente no ecossistema open skills pode instalar.
-### O que você ganha
+
-| Capacidade | Antes | Depois |
-|------------|-------|--------|
-| **Disciplina de busca** | Chuta a partir do treino | Busca antes de toda pergunta factual sobre o presente |
-| **Copyright** | Cita livremente, risco de reprodução | Máx. 15 palavras por citação, uma por fonte, paráfrase primeiro |
-| **Roteamento de ferramentas** | Escolhe aleatoriamente ou narra a escolha | Árvore de decisão clara: MCP → arquivo → visualizer → inline |
-| **Criação de arquivos** | Cria pra tudo ou pra nada | Gatilhos concretos: blog post → arquivo, explicação → inline |
-| **Tom** | Over-formatado, cheio de bullets, robótico | Prosa natural, formatação mínima, conciso |
-| **Segurança** | Limites inconsistentes | Child safety, saúde mental, filtros de conteúdo nocivo |
+### ✦ O Que Você Ganha
-### Instalação rápida
+
+
+ | Antes |
+ |
+ Depois |
+
+
+ | 🎲 Chuta a partir do treino |
+ → |
+ 🔍 Busca antes de toda pergunta factual |
+
+
+ | 📋 Over-formatado, cheio de bullets |
+ → |
+ ✍️ Prosa natural, formatação mínima |
+
+
+ | 📁 Cria pra tudo ou pra nada |
+ → |
+ 📄 Gatilhos concretos de criação |
+
+
+ | ⚖️ Ignora limites de copyright |
+ → |
+ 🛡️ Máx. 15 palavras por citação |
+
+
+ | 🔀 Escolhe ferramentas aleatoriamente |
+ → |
+ 🧭 Árvore de decisão clara |
+
+
+ | 🚫 Limites inconsistentes |
+ → |
+ 🧒 Segurança estruturada |
+
+
+
+
+
+### ⚡ Instalação Rápida
```bash
npx skills add domfelipe/mikael-3.3-co-behavior
@@ -100,38 +218,52 @@ npx skills add domfelipe/mikael-3.3-co-behavior
Só isso. O agente absorve as restrições comportamentais no próximo load.
-### O que tem dentro
+
-- **Comportamento base** — postura padrão, regras de tom, tratamento de recusa
-- **Política de busca** — quando buscar, como construir queries, esforço proporcional à complexidade
-- **Regras de copyright** — limites rígidos, paráfrase primeiro, filtros de segurança
-- **Manuseio de arquivos** — gatilhos de criação, estrutura de diretórios, critérios de artifacts
-- **Roteamento de ferramentas** — árvores de decisão para web_search, image_search, visualize, computer_use
-- **Visualizer** — roteamento em 4 passos: visual necessário → MCP → arquivo → widget inline
-- **Padrões de API** — Claudeception, integração MCP, gerenciamento de contexto
-- **Sistema de memória** — cues de busca em conversas passadas, recuperação de histórico
+### 📦 O Que Tem Dentro
-### Pra quem é
+| Módulo | O Que Faz |
+|--------|-----------|
+| 🧠 **Comportamento Base** | Postura padrão, regras de tom, tratamento de recusa |
+| 🔍 **Política de Busca** | Quando buscar, como construir queries, esforço proporcional |
+| 🛡️ **Regras de Copyright** | Limites rígidos, paráfrase primeiro, filtros de segurança |
+| 📄 **Manuseio de Arquivos** | Gatilhos de criação, estrutura de diretórios, critérios |
+| 🧭 **Roteamento de Ferramentas** | Árvores de decisão para web_search, image_search, visualize |
+| 🎨 **Visualizer** | Roteamento em 4 passos: visual → MCP → arquivo → inline |
+| 🔌 **Padrões de API** | Claudeception, integração MCP, gerenciamento de contexto |
+| 💭 **Sistema de Memória** | Cues de busca em conversas passadas, recuperação de histórico |
-- **Construtores de agentes** que querem restrições comportamentais de nível production sem escrever do zero
-- **Engenheiros de prompt** estudando como modelos top lidam com roteamento, segurança e criação de conteúdo
-- **Desenvolvedores** cansados de agentes que formatam demais, pulam buscas ou ignoram copyright
-- **Curiosos** que querem espiar por trás das cortinas de como agentes avançados são configurados
+
-### Decisões de design
+### 🎯 Pra Quem É
-- **Adaptado, não copiado** — Inspirado no Opus 4.7, mas reestruturado e reescrito no meu formato. A organização e ênfase refletem meu próprio julgamento.
-- **Modular** — Cada seção é autocontida. Agentes podem referenciar módulos específicos sem carregar tudo.
-- **Prático** — Toda regra mapeia um comportamento concreto. Sem princípios abstratos.
+- **Construtores de agentes** que querem restrições comportamentais de nível production
+- **Engenheiros de prompt** estudando como modelos top lidam com roteamento e segurança
+- **Desenvolvedores** cansados de agentes que formatam demais ou pulam buscas
+- **Curiosos** que querem espiar por trás das cortinas
-### Experimente
+
-Instale, carregue no seu agente e note a diferença em como ele lida com buscas, arquivos e formatação. Se algo não soar certo ou tiver ideias pra melhorar, abre uma issue ou PR — esse é um projeto vivo.
+### 🏗️ Filosofia de Design
-### Disclaimer
+> **Adaptado, não copiado.** Inspirado no Opus 4.7, mas reestruturado e reescrito no meu formato.
-Esta skill é inspirada em comportamento publicamente observável do Claude Opus 4.7, mas é minha própria adaptação. Não é afiliada, endossada ou fornecida diretamente pela Anthropic. Alguns padrões podem diferir da configuração real do modelo.
+- **Modular** — Cada seção é autocontida
+- **Prático** — Toda regra mapeia um comportamento concreto
+- **Transferível** — Padrões que funcionam em qualquer agente
+
+
+
+### 🚀 Experimente
+
+Instale, carregue no seu agente e note a diferença. Se algo não soar certo ou tiver ideias pra melhorar, abre uma issue ou PR — esse é um projeto vivo.
+
+
---
-> 🇧🇷 Desenvolvido no Brasil
+
+
+
+ 🇧 Desenvolvido no Brasil com e obsessão por detalhes
+