Memory ops

Skill NEXUZ-SYS/devflow/skills/memory-ops

Run MemPalace ingestion and maintenance operations — mine, wake-up, status, sweep, sync — scoped to the project wingFrom its SKILL.md

Install

npx -y skills add NEXUZ-SYS/devflow --skill memory-ops

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

4.3 KB, as published. Nobody here has run it

Memory Ops

Executa as operações de ingestão e manutenção do MemPalace via CLI, sempre escopadas à wing do projeto. Complementa devflow:memory-recall (que faz a busca) — este skill escreve/mantém o palace.

Announce at start: "I'm using the devflow:memory-ops skill to run a MemPalace operation."

Pre-requisite

Verifique que o CLI do MemPalace está disponível:

command -v mempalace

Se encontrado → prossiga.
Se não → informe: "MemPalace não está instalado. Instale com uv tool install mempalace (ou pipx install mempalace) e registre o MCP com claude mcp add mempalace -- mempalace-mcp."

Use sempre o binário mempalace no PATH. Nunca invoque python -m mempalace.mcp_server — esse é o servidor MCP (stdio), não o CLI de operações.

Step 1: Resolver wing e raiz do projeto

A wing escopa as operações ao projeto atual (evita misturar memórias entre repos).

Raiz do projeto: git rev-parse --show-toplevel (fallback: diretório atual).
Wing: ler mempalace.wing em .context/.devflow.yaml.
- Se ausente ou auto → wing = basename da raiz do projeto.
Palace: mempalace.palace em .context/.devflow.yaml se definido; senão o default do CLI (~/.mempalace/palace). Passe --palace <path> apenas se o config definir um caminho customizado.

Step 2: Mapear subcomando → CLI

Subcomando	Comando executado
`mine`	`mempalace mine <project-root> --wing <wing>`
`mine --convos`	`mempalace mine ~/.claude/projects/ --mode convos --wing <wing>`
`mine --dry-run`	acrescenta `--dry-run` ao comando de mine
`wake-up`	`mempalace wake-up --wing <wing>`
`status`	`mempalace status`
`sweep`	`mempalace sweep <project-root>`
`sync`	`mempalace sync --wing <wing> --dry-run`
`sync --apply`	`mempalace sync --wing <wing> --apply`
`install-hook`	`bash "$CLAUDE_PLUGIN_ROOT/scripts/install-git-hook.sh" <repo-root>`

Combine flags conforme passadas (ex.: mine --convos --dry-run).

`install-hook` — auto-mine no post-merge

Instala o git hook post-merge que minera o projeto automaticamente sempre que um merge/pull aterrissa numa branch protegida (pega tanto gh pr merge+git pull do autoFinish quanto git merge/git pull no terminal).

Rodar bash "$CLAUDE_PLUGIN_ROOT/scripts/install-git-hook.sh" "$(git rev-parse --show-toplevel)".
Se o instalador avisar que já existe um hook post-merge alheio, NÃO sobrescrever — repassar ao usuário as instruções de encadeamento que o script imprime.
Informar que o comportamento é controlado por mempalace.autoMine no .devflow.yaml (post-merge = ativo/default; off = desativa sem precisar desinstalar). Para remover de vez: rm <repo>/.git/hooks/post-merge.
O hook é não-bloqueante (roda em background) e fail-safe (nunca quebra o git); minera incrementalmente + sync --apply na wing do projeto.

Step 3: Salvaguardas (antes de executar)

mine --convos lê ~/.claude/projects/ inteiro e grava no palace global — pode ser lento e grande. Avise e prossiga (o usuário já optou pela flag explícita).
sync --apply remove drawers de forma definitiva. Antes de executar --apply, rode/mostre o --dry-run e confirme com o usuário o que será removido.
mine/sweep/sync escrevem no palace global (~/.mempalace), não em arquivos versionados do projeto.

Step 4: Executar e formatar

Execute o comando via Bash (use run_in_background se o mine tender a demorar).
Resuma a saída: quantos drawers filed/skipped, wing/rooms afetados, tempo. Para status, apresente a tabela de wings/rooms. Para wake-up, mostre o contexto carregado.
Em erro, mostre a mensagem do CLI e sugira o próximo passo (ex.: rodar mempalace init <project-root> se a wing não existir ainda).

Guidelines

Sempre escope por --wing (exceto status, que é global por natureza).
Não rode mine --convos "por garantia" — só quando a flag for passada.
Este skill não faz busca semântica — para isso, use devflow:memory-recall / /devflow:devflow-recall.
Se a wing ainda não existe no palace, oriente rodar mempalace init <project-root> primeiro.