InvestorClaw

Contrato operacional autoritativo

Estas regras regem qualquer agente que use esta skill. Exemplos em outras partes deste arquivo são apenas referência e nunca as sobrepõem.

Integridade de dados — InvestorClaw é a única fonte de verdade

• Cada preço, percentual, valor em dólar ou fato de mercado que um agente declarar DEVE vir de um resultado de ferramenta do InvestorClaw retornado na MESMA rodada. O InvestorClaw retorna envelopes com HMAC; esses dados assinados são a única fonte de verdade.
• Nunca invente, estime, adivinhe ou use o conhecimento de treinamento do modelo para qualquer número. Se uma ferramenta não o retornou nesta rodada, não o declare — diga "InvestorClaw não retornou dados para isso".
• Prosa de ferramenta sem números concretos = sem dados; nunca a converta em um valor.

Superfície de ferramentas atual (namespace underscore)

• investorclaw__portfolio_market_snapshot(symbols?, benchmarks?) — preços em tempo real + variação percentual do dia para posições e benchmarks (SPX/NDX/DJI/VIX, BTC/ETH). symbols é uma STRING SEPARADA POR VÍRGULAS (ex.: "NVDA,AAPL"), não uma lista. Sem argumentos = posições + benchmarks. Use esta (não portfolio_ask) para qualquer "preço de X" e para ler o portfólio em relação ao mercado.
• investorclaw__portfolio_performance_window(period=...) — retorno / P&L / maiores movimentações em uma janela. period: 1d, 1w, 1mo, 1y, 5y, 10y, 20y, max, ou frases naturais ("hoje", "semana passada", "ano passado", "histórico completo").
• investorclaw__portfolio_ask(question=...) — análise / explicação.

Exemplos mais antigos de namespace com ponto investorclaw.* abaixo estão desatualizados; as formas com underscore acima são os nomes de ferramentas atuais.

Agentes de monitoramento autônomos / sempre ativos

Para agentes não supervisionados (monitores e alertadores programados — ex.: um agente MarketWatch), além do contrato acima:

• Inicie cada execução com uma chamada de ferramenta; nunca responda a uma pergunta de mercado de memória. Uma "poll" programada significa chamar portfolio_market_snapshot.
• Varredura de limites: chame portfolio_market_snapshot, então emita UMA linha concisa apenas quando uma posição ou benchmark violar o movimento configurado (ex.: ±3% uma posição, ±10% VIX); caso contrário, emita um único token NO_ALERT e pare.
• Se a ferramenta necessária apresentar erro ou não retornar dados, emita um marcador fixo como OPS_FAIL market_snapshot unavailable e pare — nunca fabrique um número tranquilizador para preencher a lacuna.
• Sem perguntas de esclarecimento no modo não supervisionado; mapeie a intenção e aja.
• Relatórios periódicos / EOD: puxe portfolio_performance_window para a janela, depois portfolio_market_snapshot para fechamentos de índices; reporte os números textualmente.
• Sempre leia as posições no contexto dos benchmarks no mesmo snapshot.
• A entrega é push, concisa, números primeiro. Educacional, não aconselhamento personalizado.

O que InvestorClaw faz?

Este repositório é o projeto guarda-chuva do InvestorClaw — README, licença, harness de regressão e a face pública. O SKILL.md legível por agente que o ClawHub publica está no repositório de runtime:

• Runtime v4.x dockerizado + SKILL.md publicado pelo ClawHub: mnemos-os/mnemos-ic-runtime
• Plugin Claude Code / Claude Desktop (container-first, este repositório): /plugin marketplace add argonautsystems/InvestorClaw — mesma skill + container de todos os outros runtimes. Veja docs/GETTING_STARTED.md.
• Código-fonte do motor (analisadores Python): argonautsystems/ic-engine

Instalação (runtime dockerizado v4.x)

git clone https://github.com/mnemos-os/mnemos-ic-runtime.git ~/.investorclaw
cd ~/.investorclaw
mkdir -p portfolios
docker compose up -d

O compose puxa ghcr.io/argonautsystems/ic-engine:4.7.7-cpu (hospedado publicamente, sem autenticação) e o executa em localhost:18090 (MCP + REST) e localhost:18092 (painel).

Para a especificação completa legível por agente (catálogo de 12 ferramentas, cronograma de primeira execução, blocos de configuração por runtime, solução de problemas), veja o SKILL.md publicado no repositório de runtime.

Documentação

Este repositório guarda-chuva carrega o conjunto abrangente de documentos:

• README.md — funcionalidades, início rápido, recomendações de modelo + chave de API
• STONKMODE.md — modo de comentário narrado
• CAPABILITIES.md — catálogo completo de funcionalidades
• PRIVACY.md — política de tratamento de dados
• DISCLAIMER.md — aviso de uso educacional
• SECURITY.md — divulgação de vulnerabilidades
• CHANGELOG.md — histórico de versões
• docs/ — relatório EOD, glossário, filosofia, modelos de instalação, testes COBOL, referência de ferramentas MCP, arquitetura do Stonkmode + legenda de avatares, guia de configuração Windows
• docs/references/ — contratos de entrada / saída / esquema / LLM consultivo

Licença

• Este repositório guarda-chuva: Apache 2.0 (código substantivo) + MIT-0 (SKILL.md, artefatos de skills de agente).
• Cabeçalhos SPDX-License-Identifier por arquivo indicam a licença aplicável.

InvestorClaw é apenas para fins educacionais. Não é aconselhamento financeiro.