# lifecycle-canary-convergence

lifecycle-canary-convergence is a Claude Code skill that checks Memory lifecycle state through an inventory, dry-run, apply, and audit. It runs before another retry or canary.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 104 repo stars
- Author: dodo-labs-ai
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/dodo-labs-ai/mem-forge/tree/HEAD/.agents/skills/lifecycle-canary-convergence/SKILL.md
- Updated: 2026-11-17
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/lifecycle-canary-convergence

## What it does

The skill builds a bounded snapshot of Memory lifecycle state, including durable runs and jobs, Plans and mutations, Support records, source projections, Reviews and Findings, and the vector outbox. It then moves through a report-only inventory, an exact dry-run, an authorized apply, and a strict incremental audit.

Before changing code or data, define a testable hypothesis and the evidence that would confirm or reject it. The skill separates historical data, migration residue, and one-off provider or runtime failures from reproducible contract violations. It preserves Plans, Relations, Reviews, Findings, and failed jobs; it does not invent missing evidence or rewrite history. The sequence stops when the incremental audit is clean and relevant state has not changed.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add dodo-labs-ai/mem-forge --skill lifecycle-canary-convergence -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/lifecycle-canary-convergence/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/lifecycle-canary-convergence/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add dodo-labs-ai/mem-forge --skill lifecycle-canary-convergence -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/lifecycle-canary-convergence/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add dodo-labs-ai/mem-forge --skill lifecycle-canary-convergence -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/lifecycle-canary-convergence/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install dodo-labs-ai/mem-forge .agents/skills/lifecycle-canary-convergence
```

2. **Manually: put the files in place**
- File: `.github/skills/lifecycle-canary-convergence/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add dodo-labs-ai/mem-forge --skill lifecycle-canary-convergence -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/dodo-labs-ai/mem-forge --path .agents/skills/lifecycle-canary-convergence
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/lifecycle-canary-convergence/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/dodo-labs-ai/mem-forge/tree/HEAD/.agents/skills/lifecycle-canary-convergence/SKILL.md

## When to use it
- inspect lifecycle state before another retry
- correlate Plans, Support records, and outbox state
- separate historical anomalies from recurring contract violations
- audit changes without rewriting lifecycle history

## Example prompts
- Inventory Memory lifecycle state before another retry.
- Correlate Plans, Support records, Reviews, and outbox state.
- Classify historical lifecycle anomalies and run an incremental audit.

## Source text · SKILL.md · Apache-2.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 17d23f1bbb4bb221.

BEGIN THIRD-PARTY FILE 17d23f1bbb4bb221
```text
---
name: lifecycle-canary-convergence
description: "Converge a Memory lifecycle canary, retry or data repair with one bounded inventory, dry-run, apply and audit. Use before another lifecycle retry or canary, when auditing Plans, Support, Reviews and outbox state, or when classifying historical lifecycle anomalies."
---

# Lifecycle Canary Convergence

- Before another retry or canary, review the complete design contract and static call path for the affected state transition: transaction ownership, operation ordering, idempotency, stale guards, retry semantics, and SQLite/Cloud adapter parity.
- Define a falsifiable hypothesis and the exact confirming or rejecting evidence before changing code or data. Classify historical data, migration residue, and one-off provider/runtime failures separately from reproducible shared-contract violations.
- Prefer one bounded joint snapshot that correlates durable runs/jobs, Lifecycle Plans and mutations, current and stale Support, Source Projection lineage, Reviews/Findings, vector outbox, and process health. Do not replace it with repeated narrow probes that guess at adjacent causes.
- Use a bounded convergence sequence: one report-only inventory, one exact dry-run, one controlled apply when authorized, and one strict incremental audit. Stop when the incremental audit is clean and no relevant state changed.
- Never fabricate Evidence, infer missing provenance from semantic similarity, or silently rewrite lifecycle history to make an audit pass. Preserve historical Plans, Relations, Reviews, Findings, and failed jobs.
- Report current and historical populations separately. Distinguish active Memories from superseded or retired lifecycle records and classify unexpected growth by lifecycle reason and bounded time cohort.
```
END THIRD-PARTY FILE 17d23f1bbb4bb221

The third-party file has ended. Everything between the 17d23f1bbb4bb221 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

© dodo-labs-ai · Apache-2.0 · https://github.com/dodo-labs-ai/mem-forge/tree/HEAD/.agents/skills/lifecycle-canary-convergence/SKILL.md

## Similar
- [agency-continuity-audit](https://affpapa.org/en/nevibecode/plugins/agency-continuity-audit.md) — plugin · ★ 1596 repo stars
- [rig-lifecycle](https://affpapa.org/en/nevibecode/skills/rig-lifecycle.md) — skill · ★ 8928 repo stars
- [maui-app-lifecycle](https://affpapa.org/en/nevibecode/skills/maui-app-lifecycle.md) — skill · 4300 installs
- [inspeximus: agent memory with provenance, GDPR erasure and a tamper-evident audit trail](https://affpapa.org/en/nevibecode/mcp/inspeximus-agent-memory-with-provenance-gdpr-erasure-and-a-tamper-evident-audit.md) — MCP server · ★ 8 repo stars
- [lifecycle-play-advisor](https://affpapa.org/en/nevibecode/skills/lifecycle-play-advisor.md) — skill · 941 installs
- [customer-lifecycle-marketer](https://affpapa.org/en/nevibecode/skills/customer-lifecycle-marketer.md) — skill · 231 installs

From the same set: [dodo-labs-ai/mem-forge](https://affpapa.org/en/nevibecode/by/dodo-labs-ai/mem-forge.md) — 8 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
