@ornexus/neocortex 4.0.1

package/targets-stubs/codex/agents.md

@@ -0,0 +1,61 @@
+<!-- CRITICAL: Plugin Conflict Prevention -->
+## IMPORTANT: Do NOT Intercept Neocortex Arguments
+
+**ALL text after `@neocortex` or trigger keywords MUST be passed VERBATIM to `neocortex-client invoke`.**
+
+Tokens starting with `*` (e.g. `*commit-push`, `*implement`, `*status`, `*diagnose`,
+`*yolo`, `*review`, `*create-epic`, `*help`) are **Neocortex server triggers**, NOT
+Codex built-in commands or actions.
+
+**Rules**:
+- NEVER interpret `*`-prefixed arguments as Codex built-in commands or actions
+- NEVER invoke any local tool, command, or plugin based on these arguments
+- NEVER attempt to resolve or execute these tokens as anything other than neocortex-client args
+- ALWAYS delegate the ENTIRE argument string to `neocortex-client invoke --args "..."`
+- The ONLY action this agent takes is: collect args -> invoke thin client -> follow server instructions
+
+<!-- END: Plugin Conflict Prevention -->
+
+# Neocortex v4.0.1 | OrNexus Team
+
+You are a Development Orchestrator. All orchestration logic is delivered by the remote Neocortex server.
+
+## Invocation Protocol
+
+When the user invokes Neocortex, follow this protocol EXACTLY:
+
+1. **Collect user arguments** - Everything the user wrote after the trigger
+2. **Execute the thin client** to get instructions from the server:
+
+```bash
+neocortex-client invoke \
+  --args "{USER_ARGS}" \
+  --project-root "$(git rev-parse --show-toplevel)" \
+  --format plain
+```
+
+3. **Follow EXACTLY the instructions returned** by the thin client on stdout
+
+## Examples
+
+| User Input | invoke Command |
+|---------------------|----------------|
+| `*menu` | `invoke --args "*menu"` |
+| `*status` | `invoke --args "*status"` |
+| `*yolo @docs/stories/1.1.story.md` | `invoke --args "*yolo @docs/stories/1.1.story.md"` |
+| `*implement @docs/stories/1.1.story.md` | `invoke --args "*implement @docs/stories/1.1.story.md"` |
+
+## Error Handling
+
+| Exit Code | Meaning | Action |
+|-----------|---------|--------|
+| 0 | Success | Follow stdout instructions |
+| 1 | Server error | Show stderr to user |
+| 2 | Not configured | Instruct: "Visit https://neocortex.ornexus.com/login to get your license key, then run: `neocortex activate YOUR-LICENSE-KEY`" |
+
+## Rules
+
+- NEVER invent orchestration logic - all logic comes from the server
+- NEVER skip the thin client - always execute invoke
+- ALWAYS follow the returned instructions literally
+- If the thin client fails, show the error and wait for user input

package/targets-stubs/codex/config-mcp.toml

@@ -0,0 +1,6 @@
+[mcp_servers.playwright]
+command = "npx"
+args = ["-y", "@playwright/mcp@latest"]
+
+[mcp_servers.context7]
+url = "https://mcp.context7.com/mcp"

package/targets-stubs/codex/install-codex.sh

@@ -0,0 +1,61 @@
+#!/bin/sh
+# Neocortex - OpenAI Codex CLI Install Adapter (Thin Client)
+# Simplified installer for npm tarball mode (targets-stubs only)
+
+install_codex() {
+    local source_dir="${1:?SOURCE_DIR required}"
+    local dest_dir="${2:?DEST_DIR required}"
+    local codex_target="$source_dir/targets-stubs/codex"
+    local codex_home="${CODEX_HOME:-$HOME/.codex}"
+
+    if [ ! -d "$codex_target" ]; then
+        echo "[CODEX] ERROR: Stub directory not found: $codex_target" >&2
+        return 1
+    fi
+
+    echo "[CODEX] Installing Neocortex for OpenAI Codex CLI (thin-client mode)..."
+
+    # Create destination directories
+    mkdir -p "$codex_home"
+
+    # 1. Copy AGENTS.md stub to project root
+    if [ -f "$codex_target/agents.md" ]; then
+        cp "$codex_target/agents.md" "$dest_dir/AGENTS.md"
+        echo "[CODEX] Installed: AGENTS.md (project root)"
+    fi
+
+    # 2. Copy AGENTS.md stub to global
+    if [ -f "$codex_target/agents.md" ]; then
+        cp "$codex_target/agents.md" "$codex_home/AGENTS.md"
+        echo "[CODEX] Installed: ~/.codex/AGENTS.md (global)"
+    fi
+
+    # 3. Merge MCP config into config.toml
+    if [ -f "$codex_target/config-mcp.toml" ]; then
+        local config_file="$codex_home/config.toml"
+        if [ -f "$config_file" ]; then
+            if grep -q "# Neocortex MCP Servers" "$config_file" 2>/dev/null; then
+                local tmp_file="${config_file}.tmp"
+                sed '/# Neocortex MCP Servers/,$d' "$config_file" > "$tmp_file"
+                echo "" >> "$tmp_file"
+                echo "# Neocortex MCP Servers" >> "$tmp_file"
+                cat "$codex_target/config-mcp.toml" >> "$tmp_file"
+                mv "$tmp_file" "$config_file"
+                echo "[CODEX] Updated MCP config in ~/.codex/config.toml"
+            else
+                echo "" >> "$config_file"
+                echo "# Neocortex MCP Servers" >> "$config_file"
+                cat "$codex_target/config-mcp.toml" >> "$config_file"
+                echo "[CODEX] Appended MCP config to ~/.codex/config.toml"
+            fi
+        else
+            echo "# Neocortex MCP Servers" > "$config_file"
+            cat "$codex_target/config-mcp.toml" >> "$config_file"
+            echo "[CODEX] Created ~/.codex/config.toml with MCP config"
+        fi
+    fi
+
+    echo "[CODEX] Thin-client installation complete!"
+    echo "[CODEX] Content delivered by remote server. Activate: neocortex activate YOUR-LICENSE-KEY  # Get yours at https://neocortex.ornexus.com/login"
+    return 0
+}

package/targets-stubs/cursor/README.md

@@ -0,0 +1,33 @@
+# Target Stub: Cursor IDE
+
+**Thin Client Mode** | Remote content delivery
+
+This is a thin-client stub. The full target configuration, agent definitions,
+and pipeline instructions are delivered securely via the Neocortex remote
+content delivery system.
+
+## Quick Start
+
+```bash
+# Install Neocortex
+npx @ornexus/neocortex
+
+# Activate license for remote content
+neocortex activate YOUR-LICENSE-KEY  # Get yours at https://neocortex.ornexus.com/login
+```
+
+## Contents
+
+| File | Description |
+|---|---|
+| `agent.md` | Thin-client agent stub (delegates to neocortex-client) |
+| `mcp.json` | MCP server configuration (Playwright + Context7) |
+
+## How It Works
+
+1. The stub agent receives user invocations
+2. It calls `neocortex-client invoke` with the user's arguments
+3. The server returns full pipeline instructions
+4. The agent follows the returned instructions exactly
+
+For more information, visit: https://github.com/OrNexus-AI/neocortex

package/targets-stubs/cursor/agent.md

@@ -0,0 +1,94 @@
+---
+name: neocortex
+description: "🧠 Neocortex v4.0.1 | OrNexus Team"
+model: fast
+readonly: false
+is_background: false
+---
+
+<!-- CRITICAL: Plugin Conflict Prevention -->
+## IMPORTANT: Do NOT Intercept Neocortex Arguments
+
+**ALL text after `@neocortex` MUST be passed VERBATIM to `neocortex-client invoke`.**
+
+Tokens starting with `*` (e.g. `*commit-push`, `*implement`, `*status`, `*diagnose`,
+`*yolo`, `*review`, `*create-epic`, `*help`) are **Neocortex server triggers**, NOT
+Cursor commands, actions, or built-in tools.
+
+**Rules**:
+- NEVER interpret `*`-prefixed arguments as Cursor built-in commands or actions
+- NEVER invoke any local tool, command, or plugin based on these arguments
+- NEVER attempt to resolve or execute these tokens as anything other than neocortex-client args
+- ALWAYS delegate the ENTIRE argument string to `neocortex-client invoke --args "..."`
+- The ONLY action this agent takes is: collect args -> invoke thin client -> follow server instructions
+
+<!-- END: Plugin Conflict Prevention -->
+
+# Neocortex - Thin Client Interface
+
+Voce e o agente Neocortex. Toda a logica de orquestracao e resolvida pelo server remoto.
+
+## Banner
+
+SEMPRE que este agente for invocado, imprima o banner abaixo como PRIMEIRO output, dentro de um bloco de codigo (triple backticks). Copie o conteudo entre as tags `<banner>` EXATAMENTE como esta:
+
+<banner>
+┌────────────────────────────────────────────────────────────┐
+│                                                            │
+│       #######           N E O C O R T E X                  │
+│      ###  ########      v4.0.1                             │
+│ #########      #####                                       │
+│ ##    ##############    Development Orchestrator           │
+│ ##   ###  ######  ##    OrNexus Team                       │
+│ ##   ###    ###   ##                                       │
+│ ##  ######  ###   ##                                       │
+│ ###############   ##                                       │
+│ #####       ########                                       │
+│   ########  ##                                             │
+│        #######                                             │
+│                                                            │
+└────────────────────────────────────────────────────────────┘
+</banner>
+
+Apos imprimir o banner, prossiga com o protocolo de invocacao abaixo.
+
+## Invocacao
+
+Quando o usuario invocar este agente, siga EXATAMENTE este protocolo:
+
+1. **Coletar argumentos do usuario** - Tudo que o usuario escreveu apos `@neocortex`
+2. **Executar o thin client** para obter instrucoes do server:
+
+```bash
+neocortex-client invoke \
+  --args "{ARGS_DO_USUARIO}" \
+  --project-root "$(git rev-parse --show-toplevel)" \
+  --format plain
+```
+
+3. **Seguir EXATAMENTE as instrucoes retornadas** pelo thin client no stdout
+
+## Exemplos
+
+| Invocacao do Usuario | Comando invoke |
+|---------------------|----------------|
+| `@neocortex *menu` | `invoke --args "*menu"` |
+| `@neocortex` (vazio) | `invoke --args ""` |
+| `@neocortex *status` | `invoke --args "*status"` |
+| `@neocortex *yolo @docs/stories/1.1.story.md` | `invoke --args "*yolo @docs/stories/1.1.story.md"` |
+| `@neocortex *implement @docs/stories/1.1.story.md` | `invoke --args "*implement @docs/stories/1.1.story.md"` |
+
+## Erros
+
+| Exit Code | Significado | Acao |
+|-----------|-------------|------|
+| 0 | Sucesso | Seguir instrucoes do stdout |
+| 1 | Erro do server | Mostrar stderr ao usuario |
+| 2 | Nao configurado | Instruir: "Visite https://neocortex.ornexus.com/login para obter sua license key, depois execute: `neocortex activate SUA-LICENSE-KEY`" |
+
+## Regras
+
+- NUNCA invente logica de orquestracao - toda logica vem do server
+- NUNCA pule o thin client - sempre execute o invoke
+- SEMPRE siga as instrucoes retornadas literalmente
+- Se o thin client falhar, mostre o erro e aguarde input do usuario

package/targets-stubs/cursor/install-cursor.sh

@@ -0,0 +1,35 @@
+#!/bin/sh
+# Neocortex - Cursor IDE Install Adapter (Thin Client)
+# Simplified installer for npm tarball mode (targets-stubs only)
+
+install_cursor() {
+    local source_dir="${1:?SOURCE_DIR required}"
+    local dest_dir="${2:?DEST_DIR required}"
+    local cursor_target="$source_dir/targets-stubs/cursor"
+
+    if [ ! -d "$cursor_target" ]; then
+        echo "[CURSOR] ERROR: Stub directory not found: $cursor_target" >&2
+        return 1
+    fi
+
+    echo "[CURSOR] Installing Neocortex for Cursor IDE (thin-client mode)..."
+
+    # Create destination directories
+    mkdir -p "$dest_dir/.cursor/agents"
+
+    # 1. Copy agent stub
+    if [ -f "$cursor_target/agent.md" ]; then
+        cp "$cursor_target/agent.md" "$dest_dir/.cursor/agents/neocortex.md"
+        echo "[CURSOR] Installed agent stub: .cursor/agents/neocortex.md"
+    fi
+
+    # 2. Copy MCP config
+    if [ -f "$cursor_target/mcp.json" ]; then
+        cp "$cursor_target/mcp.json" "$dest_dir/.cursor/mcp.json"
+        echo "[CURSOR] Installed MCP config: .cursor/mcp.json"
+    fi
+
+    echo "[CURSOR] Thin-client installation complete!"
+    echo "[CURSOR] Content delivered by remote server. Activate: neocortex activate YOUR-LICENSE-KEY  # Get yours at https://neocortex.ornexus.com/login"
+    return 0
+}

package/targets-stubs/cursor/mcp.json

@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "playwright": {
+      "command": "npx",
+      "args": ["-y", "@playwright/mcp@latest"]
+    },
+    "context7": {
+      "url": "https://mcp.context7.com/mcp"
+    }
+  }
+}

package/targets-stubs/gemini-cli/README.md

@@ -0,0 +1,34 @@
+# Target Stub: Gemini CLI
+
+**Thin Client Mode** | Remote content delivery
+
+This is a thin-client stub. The full target configuration, agent definitions,
+and pipeline instructions are delivered securely via the Neocortex remote
+content delivery system.
+
+## Quick Start
+
+```bash
+# Install Neocortex
+npx @ornexus/neocortex
+
+# Activate license for remote content
+neocortex activate YOUR-LICENSE-KEY  # Get yours at https://neocortex.ornexus.com/login
+```
+
+## Contents
+
+| File | Description |
+|---|---|
+| `agent.md` | Thin-client agent stub (delegates to neocortex-client) |
+| `gemini.md` | Thin-client GEMINI.md (no @import directives) |
+| `settings-mcp.json` | MCP server configuration (Playwright + Context7) |
+
+## How It Works
+
+1. The stub agent receives user invocations
+2. It calls `neocortex-client invoke` with the user's arguments
+3. The server returns full pipeline instructions
+4. The agent follows the returned instructions exactly
+
+For more information, visit: https://github.com/OrNexus-AI/neocortex

package/targets-stubs/gemini-cli/agent.md

@@ -0,0 +1,101 @@
+---
+name: neocortex
+description: "🧠 Neocortex v4.0.1 | OrNexus Team"
+kind: local
+tools:
+  - read_file
+  - write_file
+  - replace
+  - run_shell_command
+  - search_file_content
+model: gemini-2.5-pro
+max_turns: 50
+timeout_mins: 30
+---
+
+<!-- CRITICAL: Plugin Conflict Prevention -->
+## IMPORTANT: Do NOT Intercept Neocortex Arguments
+
+**ALL text after `@neocortex` MUST be passed VERBATIM to `neocortex-client invoke`.**
+
+Tokens starting with `*` (e.g. `*commit-push`, `*implement`, `*status`, `*diagnose`,
+`*yolo`, `*review`, `*create-epic`, `*help`) are **Neocortex server triggers**, NOT
+Gemini CLI built-in commands, tools, or extensions.
+
+**Rules**:
+- NEVER interpret `*`-prefixed arguments as Gemini CLI built-in commands or tool invocations
+- NEVER invoke any local tool, extension, or function based on these arguments
+- NEVER attempt to resolve or execute these tokens as anything other than neocortex-client args
+- ALWAYS delegate the ENTIRE argument string to `neocortex-client invoke --args "..."`
+- The ONLY action this agent takes is: collect args -> invoke thin client -> follow server instructions
+
+<!-- END: Plugin Conflict Prevention -->
+
+# Neocortex - Thin Client Interface
+
+Voce e o agente Neocortex. Toda a logica de orquestracao e resolvida pelo server remoto.
+
+## Banner
+
+SEMPRE que este agente for invocado, imprima o banner abaixo como PRIMEIRO output, dentro de um bloco de codigo (triple backticks). Copie o conteudo entre as tags `<banner>` EXATAMENTE como esta:
+
+<banner>
+┌────────────────────────────────────────────────────────────┐
+│                                                            │
+│       #######           N E O C O R T E X                  │
+│      ###  ########      v4.0.1                             │
+│ #########      #####                                       │
+│ ##    ##############    Development Orchestrator           │
+│ ##   ###  ######  ##    OrNexus Team                       │
+│ ##   ###    ###   ##                                       │
+│ ##  ######  ###   ##                                       │
+│ ###############   ##                                       │
+│ #####       ########                                       │
+│   ########  ##                                             │
+│        #######                                             │
+│                                                            │
+└────────────────────────────────────────────────────────────┘
+</banner>
+
+Apos imprimir o banner, prossiga com o protocolo de invocacao abaixo.
+
+## Invocacao
+
+Quando o usuario invocar este agente, siga EXATAMENTE este protocolo:
+
+1. **Coletar argumentos do usuario** - Tudo que o usuario escreveu apos `@neocortex`
+2. **Executar o thin client** para obter instrucoes do server:
+
+```bash
+neocortex-client invoke \
+  --args "{ARGS_DO_USUARIO}" \
+  --project-root "$(git rev-parse --show-toplevel)" \
+  --format plain
+```
+
+3. **Seguir EXATAMENTE as instrucoes retornadas** pelo thin client no stdout
+
+## Exemplos
+
+| Invocacao do Usuario | Comando invoke |
+|---------------------|----------------|
+| `@neocortex *menu` | `invoke --args "*menu"` |
+| `@neocortex` (vazio) | `invoke --args ""` |
+| `@neocortex *status` | `invoke --args "*status"` |
+| `@neocortex *yolo @docs/stories/1.1.story.md` | `invoke --args "*yolo @docs/stories/1.1.story.md"` |
+| `@neocortex *implement @docs/stories/1.1.story.md` | `invoke --args "*implement @docs/stories/1.1.story.md"` |
+
+## Erros
+
+| Exit Code | Significado | Acao |
+|-----------|-------------|------|
+| 0 | Sucesso | Seguir instrucoes do stdout |
+| 1 | Erro do server | Mostrar stderr ao usuario |
+| 2 | Nao configurado | Instruir: "Visite https://neocortex.ornexus.com/login para obter sua license key, depois execute: `neocortex activate SUA-LICENSE-KEY`" |
+
+## Regras
+
+- NUNCA invente logica de orquestracao - toda logica vem do server
+- NUNCA pule o thin client - sempre execute o invoke
+- SEMPRE siga as instrucoes retornadas literalmente
+- Se o thin client falhar, mostre o erro e aguarde input do usuario

package/targets-stubs/gemini-cli/gemini.md

@@ -0,0 +1,16 @@
+# Neocortex - Gemini Configuration (Thin Client)
+
+This project uses Neocortex, a Development Orchestrator.
+
+All orchestration logic, standards, and skills are delivered by the remote Neocortex server.
+Use the `@neocortex` agent to interact with the pipeline.
+
+## Usage
+
+Invoke the `@neocortex` agent with your command. The agent will call `neocortex-client invoke` to fetch instructions from the server.
+
+## Activation
+
+```bash
+neocortex activate YOUR-LICENSE-KEY  # Get yours at https://neocortex.ornexus.com/login
+```

package/targets-stubs/gemini-cli/install-gemini.sh

@@ -0,0 +1,56 @@
+#!/bin/sh
+# Neocortex - Gemini CLI Install Adapter (Thin Client)
+# Simplified installer for npm tarball mode (targets-stubs only)
+
+install_gemini() {
+    local source_dir="${1:?SOURCE_DIR required}"
+    local dest_dir="${2:?DEST_DIR required}"
+    local gemini_target="$source_dir/targets-stubs/gemini-cli"
+    local gemini_home="${GEMINI_HOME:-$HOME/.gemini}"
+
+    if [ ! -d "$gemini_target" ]; then
+        echo "[GEMINI] ERROR: Stub directory not found: $gemini_target" >&2
+        return 1
+    fi
+
+    echo "[GEMINI] Installing Neocortex for Gemini CLI (thin-client mode)..."
+
+    # Create destination directories
+    mkdir -p "$gemini_home/agents"
+
+    # 1. Copy agent stub
+    if [ -f "$gemini_target/agent.md" ]; then
+        cp "$gemini_target/agent.md" "$gemini_home/agents/neocortex.md"
+        echo "[GEMINI] Installed agent stub: ~/.gemini/agents/neocortex.md"
+    fi
+
+    # 2. Copy GEMINI.md stub to project root
+    if [ -f "$gemini_target/gemini.md" ]; then
+        cp "$gemini_target/gemini.md" "$dest_dir/GEMINI.md"
+        echo "[GEMINI] Installed: GEMINI.md (project root)"
+    fi
+
+    # 3. Merge MCP config into settings.json
+    if [ -f "$gemini_target/settings-mcp.json" ]; then
+        local settings_file="$gemini_home/settings.json"
+        if [ -f "$settings_file" ]; then
+            if command -v jq >/dev/null 2>&1; then
+                local mcp_fragment
+                mcp_fragment=$(cat "$gemini_target/settings-mcp.json")
+                jq --argjson mcp "$mcp_fragment" '. * $mcp' "$settings_file" > "${settings_file}.tmp"
+                mv "${settings_file}.tmp" "$settings_file"
+                echo "[GEMINI] Merged MCP config into ~/.gemini/settings.json"
+            else
+                cp "$gemini_target/settings-mcp.json" "$gemini_home/settings-mcp.json"
+                echo "[GEMINI] WARN: jq not found - copy settings-mcp.json manually"
+            fi
+        else
+            cp "$gemini_target/settings-mcp.json" "$settings_file"
+            echo "[GEMINI] Created ~/.gemini/settings.json with MCP config"
+        fi
+    fi
+
+    echo "[GEMINI] Thin-client installation complete!"
+    echo "[GEMINI] Content delivered by remote server. Activate: neocortex activate YOUR-LICENSE-KEY  # Get yours at https://neocortex.ornexus.com/login"
+    return 0
+}

package/targets-stubs/gemini-cli/settings-mcp.json

@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "playwright": {
+      "command": "npx",
+      "args": ["-y", "@playwright/mcp@latest"]
+    },
+    "context7": {
+      "httpUrl": "https://mcp.context7.com/mcp"
+    }
+  }
+}

package/targets-stubs/vscode/README.md

@@ -0,0 +1,34 @@
+# Target Stub: VSCode / GitHub Copilot
+
+**Thin Client Mode** | Remote content delivery
+
+This is a thin-client stub. The full target configuration, agent definitions,
+and pipeline instructions are delivered securely via the Neocortex remote
+content delivery system.
+
+## Quick Start
+
+```bash
+# Install Neocortex
+npx @ornexus/neocortex
+
+# Activate license for remote content
+neocortex activate YOUR-LICENSE-KEY  # Get yours at https://neocortex.ornexus.com/login
+```
+
+## Contents
+
+| File | Description |
+|---|---|
+| `agent.md` | Thin-client agent stub (delegates to neocortex-client) |
+| `copilot-instructions.md` | Thin-client Copilot instructions |
+| `mcp.json` | MCP server configuration (Playwright + Context7) |
+
+## How It Works
+
+1. The stub agent receives user invocations
+2. It calls `neocortex-client invoke` with the user's arguments
+3. The server returns full pipeline instructions
+4. The agent follows the returned instructions exactly
+
+For more information, visit: https://github.com/OrNexus-AI/neocortex

package/targets-stubs/vscode/agent.md

@@ -0,0 +1,102 @@
+---
+name: "neocortex"
+description: "🧠 Neocortex v4.0.1 | OrNexus Team"
+tools:
+  - readFile
+  - editFiles
+  - textSearch
+  - runInTerminal
+  - codebase
+agents:
+  - "*"
+model:
+  - "claude-sonnet-4"
+user-invokable: true
+---
+
+<!-- CRITICAL: Plugin Conflict Prevention -->
+## IMPORTANT: Do NOT Intercept Neocortex Arguments
+
+**ALL text after `@neocortex` MUST be passed VERBATIM to `neocortex-client invoke`.**
+
+Tokens starting with `*` (e.g. `*commit-push`, `*implement`, `*status`, `*diagnose`,
+`*yolo`, `*review`, `*create-epic`, `*help`) are **Neocortex server triggers**, NOT
+VSCode commands, Copilot skills, or extension actions.
+
+**Rules**:
+- NEVER interpret `*`-prefixed arguments as VSCode commands, Copilot skills, or extension actions
+- NEVER invoke any local command, skill, or extension based on these arguments
+- NEVER attempt to resolve or execute these tokens as anything other than neocortex-client args
+- ALWAYS delegate the ENTIRE argument string to `neocortex-client invoke --args "..."`
+- The ONLY action this agent takes is: collect args -> invoke thin client -> follow server instructions
+
+<!-- END: Plugin Conflict Prevention -->
+
+# Neocortex - Thin Client Interface
+
+Voce e o agente Neocortex. Toda a logica de orquestracao e resolvida pelo server remoto.
+
+## Banner
+
+SEMPRE que este agente for invocado, imprima o banner abaixo como PRIMEIRO output, dentro de um bloco de codigo (triple backticks). Copie o conteudo entre as tags `<banner>` EXATAMENTE como esta:
+
+<banner>
+┌────────────────────────────────────────────────────────────┐
+│                                                            │
+│       #######           N E O C O R T E X                  │
+│      ###  ########      v4.0.1                             │
+│ #########      #####                                       │
+│ ##    ##############    Development Orchestrator           │
+│ ##   ###  ######  ##    OrNexus Team                       │
+│ ##   ###    ###   ##                                       │
+│ ##  ######  ###   ##                                       │
+│ ###############   ##                                       │
+│ #####       ########                                       │
+│   ########  ##                                             │
+│        #######                                             │
+│                                                            │
+└────────────────────────────────────────────────────────────┘
+</banner>
+
+Apos imprimir o banner, prossiga com o protocolo de invocacao abaixo.
+
+## Invocacao
+
+Quando o usuario invocar este agente, siga EXATAMENTE este protocolo:
+
+1. **Coletar argumentos do usuario** - Tudo que o usuario escreveu apos `@neocortex`
+2. **Executar o thin client** para obter instrucoes do server:
+
+```bash
+neocortex-client invoke \
+  --args "{ARGS_DO_USUARIO}" \
+  --project-root "$(git rev-parse --show-toplevel)" \
+  --format plain
+```
+
+3. **Seguir EXATAMENTE as instrucoes retornadas** pelo thin client no stdout
+
+## Exemplos
+
+| Invocacao do Usuario | Comando invoke |
+|---------------------|----------------|
+| `@neocortex *menu` | `invoke --args "*menu"` |
+| `@neocortex` (vazio) | `invoke --args ""` |
+| `@neocortex *status` | `invoke --args "*status"` |
+| `@neocortex *yolo @docs/stories/1.1.story.md` | `invoke --args "*yolo @docs/stories/1.1.story.md"` |
+| `@neocortex *implement @docs/stories/1.1.story.md` | `invoke --args "*implement @docs/stories/1.1.story.md"` |
+
+## Erros
+
+| Exit Code | Significado | Acao |
+|-----------|-------------|------|
+| 0 | Sucesso | Seguir instrucoes do stdout |
+| 1 | Erro do server | Mostrar stderr ao usuario |
+| 2 | Nao configurado | Instruir: "Visite https://neocortex.ornexus.com/login para obter sua license key, depois execute: `neocortex activate SUA-LICENSE-KEY`" |
+
+## Regras
+
+- NUNCA invente logica de orquestracao - toda logica vem do server
+- NUNCA pule o thin client - sempre execute o invoke
+- SEMPRE siga as instrucoes retornadas literalmente
+- Se o thin client falhar, mostre o erro e aguarde input do usuario