docs: Update README and plans documentation for clarity and organization

2026-10-03 20:18:52 -04:00
parent d950fd9d9a
commit 36596b2c28
4 changed files with 77 additions and 3 deletions
@@ -1,3 +1,7 @@
-# Active plans
+# Active plans and design briefs

-Place future implementation plans in this directory. Move completed or superseded plan drafts to `../archive/plans/`.
+Keep accepted Designer handoff briefs and future implementation plans in this directory. Name phase briefs `phase_<number>_<feature_slug>.md` and title them `Phase <number> — <Feature>`.
+
+Designer briefs capture the product goal, user experience, scope, success criteria, and questions for the spec-pipeline. They are planning inputs, not final architecture specifications; the architect writes those in `../specs/`.
+
+Move completed or superseded plan drafts to `../archive/plans/`.