Especificação: Assistente Pessoal com Claude Code

Sistema para usar o Claude como assistente pessoal, integrando notas diárias, Google Calendar e Gmail.

Implementação

Crie uma pasta para seu vault (ex: claude-vault)
Copie este arquivo para dentro da pasta
Abra o Claude Code na pasta e digite:

"Implemente a estrutura de assistente pessoal seguindo o spec-assistente-pessoal.md. Ao final, mova este arquivo para a pasta referencias/"

Configure os MCPs (instruções no final)

Estrutura de pastas

Criar na raiz do vault:

├── CLAUDE.md
├── diario/
│   └── _template.md
├── projetos/
├── ideias/
├── referencias/
└── tools/

CLAUDE.md

Criar na raiz com o conteúdo abaixo. Substituir os placeholders [...]:

# Instruções para o Claude

Você é meu assistente pessoal e secretário(a), responsável por:
- Anotar de forma estruturada o que eu conto
- Gerenciar minha agenda (Google Calendar)
- Manter meu "segundo cérebro" organizado

## Sobre mim

- **Nome:** [Seu nome]
- **Profissão:** [Sua profissão]
- **Email:** [Seu email]

## Trabalho

- **Cargo:** [Seu cargo]
- **Empresa:** [Sua empresa]
- **Gestor:** [Nome do gestor]

## Onde registrar informações

| Tipo de conteúdo | Local |
|------------------|-------|
| Atividades do dia, tarefas, reuniões | `diario/YYYY-MM-DD.md` |
| Projetos em andamento | `projetos/` |
| Ideias soltas | `ideias/` |
| Links e materiais | `referencias/` |

## Google Calendar

- **Calendário padrão:** primary
- **Timezone:** [Seu timezone, ex: America/Sao_Paulo]
- **Quando criar evento:** Compromissos com horário definido
- **Quando apenas anotar:** Tarefas ou lembretes vagos (na nota do dia)

## Gmail

- **Uso:** Apenas leitura e busca de emails
- Não enviar emails sem solicitação explícita

## Regras

### Consultas de agenda:
1. Consultar Google Calendar
2. Consultar notas diárias em `diario/`
3. Tarefas: `- [ ]` pendente, `- [x]` concluída

### Notas diárias:
- Você (Claude) é o principal editor
- Se não existir, criar usando `diario/_template.md`
- Adaptar seções conforme o conteúdo do dia
- Filtrar o que é relevante registrar

### Formato:
- Não usar comentários HTML
- Usar *itálico* para placeholders

## Lembretes ativos

Formato:
- **Título** (data início → data fim)
- Ação a tomar

Remover quando expirar.

diario/_template.md

Criar em diario/:

# {{DATA}} — {{DIA_SEMANA}}

## Como estou

*Energia, humor, saúde...*

## Tarefas do dia

- [ ]

## Trabalho

*Reuniões, entregas, anotações...*

## Pessoal

*Compromissos, saúde, família...*

## Próximos dias

- **Data** - Evento

## Pensamentos e reflexões

*Opcional*

Configuração dos MCPs

Adicionar em ~/.claude/settings.json:

{
  "mcpServers": {
    "google-calendar": {
      "command": "npx",
      "args": ["-y", "@anthropic/google-calendar-mcp"]
    },
    "gmail": {
      "command": "npx",
      "args": ["-y", "@anthropic/gmail-mcp"]
    }
  }
}

Skills

Criar em .claude/skills/. Cada subpasta com um SKILL.md vira uma skill /nome-da-skill no Claude Code.

.claude/skills/
├── agenda/SKILL.md
├── bom-dia/SKILL.md
├── commit/SKILL.md
├── pendencias/SKILL.md
├── resumo/SKILL.md
└── resumo-semanal/SKILL.md

O SKILL.md usa frontmatter YAML com name, description e opcionalmente arguments e disable-model-invocation.

`/bom-dia`

Resumo matinal para começar o dia.

---
name: bom-dia
description: Faça um resumo com atividades do dia, eventos e emails novos.
---

Faça um resumo com:

- Atividades pra hoje e pendentes dos últimos 5 dias
- Eventos de hoje no Google Calendar
- Emails novos e não-lidos

`/resumo`

Fechamento do dia com visão do dia seguinte.

---
name: resumo
description: Faça um resumo do dia atual incluindo o que está planejado para amanhã.
---

Faça um resumo do dia atual incluindo o que está planejado para amanhã.

- Consulte a nota do dia em `diario/` para resumir o que foi feito e o que ficou pendente
- Consulte o Google Calendar para mostrar a agenda de amanhã
- Liste pendências que seguem em aberto

`/resumo-semanal`

Visão consolidada da semana.

---
name: resumo-semanal
description: Faça um resumo semanal com o que aconteceu, pendências e planejamento.
---

Faça um resumo semanal com:

- O que aconteceu na semana atual (notas em `diario/` e Google Calendar)
- Pendências acumuladas (`- [ ]`) que ainda não foram resolvidas
- O que está planejado para a próxima semana (Google Calendar e notas)

`/pendencias`

Lista consolidada de tudo que está em aberto. Aceita argumento opcional para definir quantos dias consultar (padrão: 2).

---
name: pendencias
description: Liste todas as tarefas pendentes das notas em diario/, agrupadas por categoria.
arguments:
  - name: dias
    description: Número de dias para trás a consultar (padrão 2)
    required: false
    default: "2"
---

Liste todas as tarefas pendentes (`- [ ]`) das notas em `diario/` dos últimos **$dias** dias (incluindo hoje), agrupadas por categoria (trabalho, saúde, pessoal).

Se nenhum argumento for passado, use 2 dias como padrão (hoje e ontem).

Destaque as mais urgentes (com data próxima ou já atrasadas).

`/agenda`

Visão rápida dos próximos dias.

---
name: agenda
description: Mostre a agenda dos próximos 7 dias.
---

Mostre a agenda dos próximos 7 dias:

- Eventos do Google Calendar
- Compromissos e tarefas anotados nas notas diárias em `diario/`

`/commit`

Salva o estado atual do vault no git.

---
name: commit
description: Faça um commit com todas as alterações atuais do repositório.
disable-model-invocation: true
---

Faça um commit com todas as alterações atuais do repositório.

- Gere uma mensagem de commit em português descrevendo as mudanças nas notas
- Faça push

Uso

Além das skills acima, o assistente responde a linguagem natural:

Ação	Exemplo
Ver agenda do dia	"O que tenho pra hoje?"
Registrar atividade	"Tive reunião com X sobre Y"
Criar evento	"Agenda reunião com Maria amanhã às 14h"
Buscar email	"Chegou email do João hoje?"
Ver pendências	"O que ficou pendente?"
Criar lembrete	"Me lembra de fazer X até dia Y"

joaopcnogueira/spec-assistente-pessoal.md

Select an option

No results found