From b38220e8c05e11301679fb9e259626bc21ea0a4e Mon Sep 17 00:00:00 2001
From: Stable Genius <259448942+stablegenius49@users.noreply.github.com>
Date: Thu, 5 Mar 2026 21:24:07 -0800
Subject: [PATCH] fix(writing-plans): use cross-platform safe plan filename
 slug

---
 skills/writing-plans/SKILL.md | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/skills/writing-plans/SKILL.md b/skills/writing-plans/SKILL.md
index 5fc45b6ff..1a9398a0a 100644
--- a/skills/writing-plans/SKILL.md
+++ b/skills/writing-plans/SKILL.md
@@ -15,7 +15,12 @@ Assume they are a skilled developer, but know almost nothing about our toolset o
 
 **Context:** This should be run in a dedicated worktree (created by brainstorming skill).
 
-**Save plans to:** `docs/plans/YYYY-MM-DD-<feature-name>.md`
+**Save plans to:** `docs/plans/YYYY-MM-DD-feature-name.md`
+
+Filename rules (to avoid tool/path errors across macOS/Linux/Windows):
+- Replace `feature-name` with a real lowercase slug (e.g., `oauth-login`, `invoice-export`)
+- Use only: `a-z`, `0-9`, and hyphens (`-`)
+- Never leave placeholder characters like `<` `>` in the actual filename
 
 ## Bite-Sized Task Granularity