obsidian-board-hygiene — Claude Code command: kanban triage
obsidian-board-hygiene identifies stale and overdue cards across Obsidian kanban boards to reschedule, archive, or close them in a single guided pass.
MIT ★ 5,412 updated 2026-10-24
/plugin marketplace add eugeniughelbur/obsidian-second-brain
/plugin install obsidian-second-brain@obsidian-second-brainWhat obsidian-board-hygiene does
This command performs bulk triage on kanban boards within an Obsidian vault. It begins by reading _CLAUDE.md to locate the boards directory and determine kanban conventions, including the @{date} syntax. It parses open items across every column and calculates task age against today's date. The command categorizes items into overdue entries, stale cards sitting past the 14-day threshold, and unscheduled tasks lacking date tags.
For every item flagged, the agent proposes a single action accompanied by a brief rationale. Choices include marking a task completed with strikethrough styling, assigning a new date, shifting it to an archive section, or retaining it in place. Changes apply directly to the markdown file only after user confirmation, followed by an audit entry logged inside Logs/YYYY-MM-DD.md or log.md.
The routine expects the obsidian-second-brain skill and references/ai-first-rules.md to be present. In board files, the heading ## For future agent is strictly forbidden because the Obsidian Kanban plugin would render it as a ghost column.
What it helps with
- clear overloaded columns on an Obsidian kanban board
- surface overdue items and cards untouched for over 14 days
- batch reschedule, drop, or finish tasks under explicit review
- record board cleanup actions into daily vault logs
Example prompts for the agent
- /obsidian-board-hygiene Projects
- Triage overdue cards on my sprint board
- Run board hygiene on
Backlog
How to install obsidian-board-hygiene
1Plugin marketplace
/plugin marketplace add eugeniughelbur/obsidian-second-brain/plugin install obsidian-second-brain@obsidian-second-brain2Manually: put the files in place
.claude/commands/obsidian-board-hygiene.mdCall it with /obsidian-board-hygiene. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/obsidian-board-hygiene.mdCall it with /prompts:obsidian-board-hygiene. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/obsidian-board-hygiene.prompt.mdManually: put the files in place
.gemini/commands/obsidian-board-hygiene.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about obsidian-board-hygiene
How to install obsidian-board-hygiene in Claude Code?
First run /plugin marketplace add eugeniughelbur/obsidian-second-brain, then execute /plugin install obsidian-second-brain@obsidian-second-brain. Alternatively, place the command into .claude/commands/obsidian-board-hygiene.md.
What does obsidian-board-hygiene do?
It scans an Obsidian kanban board for outdated task markers, tabulates the bloat per column, and generates a review batch to archive, postpone, or complete tasks in place.
Does this command permanently delete tasks from the board?
No, modifications are strictly additive. Tasks receive strikethroughs or move to archive headers, and the agent never commits changes without your explicit approval.
Source text
obsidian-board-hygiene.md · MIT
---
description: Bulk-triage a kanban board - surface stale items and archive, reschedule, or mark them done in one pass
category: vault
triggers_en: ["clean up my board", "triage my board", "board hygiene", "archive stale tasks", "my board is a mess"]
triggers_de: ["mein Board aufräumen", "mein Board priorisieren", "Board-Pflege", "veraltete Aufgaben archivieren", "mein Board ist ein Chaos"]
triggers_es: ["limpia mi tablero", "haz triaje de mi tablero", "ordena el tablero", "archiva las tareas viejas", "mi tablero es un desastre"]
triggers_pt: ["limpe meu board", "faça a triagem do meu board", "higiene do board", "arquive tarefas paradas", "meu board está uma bagunça"]
triggers_zh: ["整理我的看板", "清理过期任务", "帮我归档看板上的旧任务", "我的看板太乱了", "批量梳理看板"]
---
Use the obsidian-second-brain skill. Execute `/obsidian-board-hygiene [board]`:
The board's "This Week" column has quietly become a graveyard - this clears it. The board equivalent of the wanted-notes triage: surface what's stale, then keep / reschedule / done / archive in one guided pass.
1. Read `_CLAUDE.md` first if it exists in the vault root, to find the boards folder and kanban convention (columns, priority markers, `@{date}` format).
2. Read the target board (fuzzy-match the argument; if none given, list boards and ask). Parse every open item per column, extract its `@{date}` if present, and compute age vs today.
3. Group the open items by staleness: **overdue** (`@{date}` in the past), **stale** (in the same column with a date older than N days, default 14), and **undated** (no `@{date}` - can't be scheduled, flag separately). Show counts per column so the bloat is visible at a glance.
4. For each stale/overdue item, propose ONE verdict with a one-line reason: **done** (looks completed elsewhere - move to Done with strikethrough), **reschedule** (still real - set a new `@{date}` or move to Backlog/Next Week), **archive** (dead - move to an `_archived` section or Done with a "dropped" note), or **keep** (genuinely active, leave it). Present as a batch the user can approve, edit, or override - never auto-move destructively without confirmation.
5. Apply the approved verdicts to the board in place (additive moves + strikethrough, never silent deletion), then report what moved where and append a one-line entry to the operation log the operation log (`Logs/YYYY-MM-DD.md` if the vault uses a `Logs/` folder - create today's file if needed - else `log.md`).
A board only means something if "This Week" means this week. Run this whenever a column stops being trustworthy; pairs with `/obsidian-board` (which only flags) by actually clearing the backlog.
---
**AI-first rule:** Board files follow the kanban exception in `references/ai-first-rules.md`: `kanban-plugin` frontmatter, NO `## For future agent` heading (the plugin would render it as a phantom column). Every NON-board note this command creates or updates (task notes, project notes) MUST follow the full rule - preamble, rich frontmatter (`type`, `date`, `tags`, `ai-first: true`), `[[wikilinks]]`, sources verbatim. If that path does not resolve from your working directory, search upward for it; if you still cannot read it, say so before writing rather than producing a note that silently skips the rule.
**Anti-fabrication:** Search exhaustively before claiming any note, person, or file is absent - false absence is the most common failure mode - and never invent facts, entities, or dates (mark unknowns as `TBD`). See the anti-fabrication and search-completeness hard rules in `references/ai-first-rules.md`.
© Eugeniu Ghelbur · MIT · eugeniughelbur/obsidian-second-brain