Começando com o Synkra AIOS

# Criar um novo projeto
npx @synkra/aios-core init my-first-project
 
# Navegar até seu projeto
cd my-first-project
 
# Iniciar o meta-agent
npx @synkra/aios-core

# 1. Criar novo projeto com template personalizado
npx @synkra/aios-core init my-project --template enterprise
 
# 2. Instalar em projeto existente
cd existing-project
npx @synkra/aios-core install
 
# 3. Forçar instalação em diretório não vazio
npx @synkra/aios-core init my-project --force
 
# 4. Pular instalação de dependências (instalar manualmente depois)
npx @synkra/aios-core init my-project --skip-install

my-first-project/
├── .aios/                    # Configuração do framework
│   ├── config.json          # Arquivo principal de configuração
│   ├── memory-config.json   # Configurações da camada de memória
│   ├── cache/              # Cache de performance
│   └── logs/               # Logs do sistema
├── agents/                  # Diretório de agentes IA
│   └── sample-agent.yaml   # Agente de exemplo
├── components/             # Componentes da aplicação
├── workflows/              # Workflows automatizados
├── tasks/                  # Tasks reutilizáveis
├── tests/                  # Suites de teste
├── .env                    # Variáveis de ambiente
└── package.json           # Dependências do projeto

{
  "version": "1.0.0",
  "projectName": "my-first-project",
  "features": [
    "meta-agent",
    "memory-layer",
    "self-modification",
    "telemetry"
  ],
  "ai": {
    "provider": "openai",
    "model": "gpt-4"
  },
  "environment": "development"
}

# Configuração do Provedor de IA
OPENAI_API_KEY=your-openai-api-key
# ou
ANTHROPIC_API_KEY=your-anthropic-api-key

# Configurações do Framework
NODE_ENV=development
AIOS_TELEMETRY=enabled

# Iniciar no diretório atual
npx @synkra/aios-core
 
# Ou usar o atalho
npx aios

# Ajuda e Informações
*help                    # Mostrar todos os comandos disponíveis
*status                  # Exibir status do sistema
*config                  # Ver configuração atual
 
# Gerenciamento de Agentes
*list-agents             # Mostrar todos os agentes disponíveis
*activate <agent-name>   # Ativar agente específico
*deactivate <agent-name> # Desativar agente
 
# Operações Básicas
*analyze                 # Analisar base de código atual
*suggest                 # Obter sugestões de melhoria
*learn                   # Aprender com mudanças recentes

*create-agent my-helper

# agents/my-helper.yaml
name: my-helper
version: 1.0.0
description: Um assistente útil para tarefas diárias
type: assistant
 
capabilities:
  - name: summarize
    description: Resumir conteúdo de texto
    parameters:
      - name: text
        type: string
        required: true
      - name: maxLength
        type: number
        required: false
        default: 100
 
  - name: translate
    description: Traduzir texto entre idiomas
    parameters:
      - name: text
        type: string
        required: true
      - name: targetLanguage
        type: string
        required: true
 
instructions: |
  Você é um assistente útil que resume e traduz textos.
  Seja conciso, preciso e mantenha o significado original.
 
examples:
  - input: "*my-helper summarize 'Texto longo aqui...'"
    output: "Resumo: Pontos-chave do texto"
 
  - input: "*my-helper translate 'Hello' --targetLanguage spanish"
    output: "Tradução: Hola"

# Ativar o agente
*activate my-helper
 
# Testar resumo
*my-helper summarize "Este é um texto longo que precisa de resumo..."
 
# Testar tradução
*my-helper translate "Hello world" --targetLanguage french

*create-task data-processor

# tasks/data-processor.md
 
## Propósito
Processar e transformar dados de acordo com especificações
 
## Padrão de Comando

## Parâmetros
- `input`: Dados para processar
- `--format`: Formato de saída (json, csv, xml)
- `--transform`: Tipo de transformação

## Implementação
```javascript
class DataProcessor {
  async execute(params) {
    const [ input, format = 'json', transform ] = params;

    // Lógica de processamento aqui
    let processed = this.transform(input, transform);

    return this.format(processed, format);
  }
}

### Usando Tasks em Workflows

```yaml
# workflows/data-pipeline.yaml
name: data-pipeline
description: Pipeline automatizado de processamento de dados

triggers:
  - type: schedule
    cron: "0 */6 * * *"  # A cada 6 horas

steps:
  - task: fetch-data
    params:
      source: "api/endpoint"

  - task: data-processor
    params:
      transform: "normalize"
      format: "json"

  - task: save-results
    params:
      destination: "processed/data"

# Operações de memória
*memory status          # Verificar status da camada de memória
*memory search <query>  # Buscar memória semântica
*memory clear-cache     # Limpar cache de memória
*memory rebuild         # Reconstruir índice de memória

# Busca tradicional (baseada em palavras-chave)
*search "getUserData"
 
# Busca semântica (baseada em significado)
*memory search "função que recupera informações do usuário do banco de dados"

# Bom: Comece com agentes focados
*create-agent code-formatter
*create-agent test-generator
 
# Evite: Agentes iniciais muito complexos
*create-agent do-everything-ai

# Boa nomenclatura
*create-agent api-endpoint-validator
*create-task validate-user-input
 
# Nomenclatura ruim
*create-agent helper1
*create-task task123

# Após fazer mudanças
*learn --from recent-changes
 
# Antes de começar nova funcionalidade
*suggest --based-on similar-features

# Análise semanal
*analyze-framework --depth full
 
# Verificação rápida diária
*analyze-framework --depth surface

# Boa documentação de agente
instructions: |
  Este agente valida respostas de API contra schemas OpenAPI.
  Ele verifica:
  - Presença de campos obrigatórios
  - Correção de tipos de dados
  - Conformidade de formato
  - Validação de regras de negócio
 
examples:
  - input: "*validate-api POST /users response"
    output: "✓ Todas as validações passaram"

# Gerar um novo componente React
*create-component Dashboard --type react --features "charts,filters,export"
 
# O meta-agent irá:
# 1. Analisar componentes existentes
# 2. Aplicar padrões consistentes
# 3. Gerar código otimizado
# 4. Criar testes
# 5. Atualizar documentação

# Melhorar arquivo específico
*improve-code-quality src/services/api.js
 
# Melhorar módulo inteiro
*improve-code-quality src/services/ --recursive
 
# Obter sugestões primeiro
*suggest-improvements src/services/api.js

# Gerar testes para um componente
*generate-tests src/components/UserProfile.js
 
# Gerar testes de integração
*generate-tests src/api/ --type integration
 
# Gerar baseado em padrões de uso
*generate-tests --from-usage-analysis

# Documentar um módulo
*document src/utils/
 
# Gerar documentação de API
*generate-api-docs src/api/
 
# Criar guia do usuário
*create-documentation --type user-guide

# Verificar versão do Node.js
node --version  # Deve ser >= 18.0.0
 
# Verificar instalação
npx @synkra/aios-core doctor
 
# Corrigir problemas comuns
npx @synkra/aios-core doctor --fix

# Verificar se arquivo .env existe
ls -la .env
 
# Verificar formato da chave
# Deve ser: OPENAI_API_KEY=sk-...

# Reconstruir índice
*memory rebuild
 
# Verificar status
*memory status
 
# Limpar e reconstruir
*memory clear-cache && *memory rebuild