# Obsidian Project Lifecycle

> Use this skill when the user wants to detach, archive, purge, or otherwise change the lifecycle state of an Obsidian project knowledge base.

- Skill: `brycewang-stanford/obsidian-project-lifecycle` (Agent Skill)
- Install (CLI): `npx skillmds@latest add brycewang-stanford/obsidian-project-lifecycle`
- Raw SKILL.md: https://api.skillmd.com/api/skills/brycewang-stanford/obsidian-project-lifecycle/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: brycewang-stanford (https://skillmd.com/u/brycewang-stanford)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/brycewang-stanford/obsidian-project-lifecycle

---


# Obsidian Project Lifecycle

Use the shared helper script for deterministic lifecycle operations.

## Role in the workflow

This is a **supporting skill** under `obsidian-project-memory`.

Use it for project-level state changes and, when needed, note-level removal or rename flows.

## Project-level commands

```bash
python3 ../obsidian-project-memory/scripts/project_kb.py lifecycle --cwd "$PWD" --mode detach
python3 ../obsidian-project-memory/scripts/project_kb.py lifecycle --cwd "$PWD" --mode archive
python3 ../obsidian-project-memory/scripts/project_kb.py lifecycle --cwd "$PWD" --mode purge
```

## Note-level command

```bash
python3 ../obsidian-project-memory/scripts/project_kb.py note-lifecycle --cwd "$PWD" --mode archive --note "Results/Old-Result.md"
python3 ../obsidian-project-memory/scripts/project_kb.py note-lifecycle --cwd "$PWD" --mode purge --note "Results/Old-Result.md"
python3 ../obsidian-project-memory/scripts/project_kb.py note-lifecycle --cwd "$PWD" --mode rename --note "Experiments/Old-Name.md" --dest "Experiments/New-Name.md"
```

## Policy

- **Detach**: stop syncing, keep vault content.
- **Archive**: default for “remove this project's knowledge”; move the project to `Archive/` and disable syncing.
- **Purge**: only when the user explicitly requests permanent deletion.
- **Rename / move**: treat as update plus link repair, not delete plus create.

Always summarize what was removed, what was preserved, and whether auto-sync remains enabled.