aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2026-06-15 11:15:58 -0500
committerCraig Jennings <c@cjennings.net>2026-06-15 11:15:58 -0500
commit7bcf6dad2b1078994346b61531bce281a75519f9 (patch)
tree3bb7f507c339fc73343d22c54a303786a3585408 /docs
parent45e0f6e896b2c34de25d5c3aa18474c79d6a1e72 (diff)
downloaddotemacs-7bcf6dad2b1078994346b61531bce281a75519f9.tar.gz
dotemacs-7bcf6dad2b1078994346b61531bce281a75519f9.zip
docs: move the two docs-root specs into docs/specs/
Finish the reorg: theme-studio-palette-generator (doing — core planner, UI, and generatortest gate shipped, one refinement open) and theme-studio-semantic-theme-architecture (not-started) lived in docs/ root. Moved both into docs/specs/ with status filenames, ID and STATUS drawers, and id-linked references. Fixed their Related links from ../todo.org to ../../todo.org for the deeper path.
Diffstat (limited to 'docs')
-rw-r--r--docs/specs/theme-studio-palette-generator-spec-doing.org (renamed from docs/theme-studio-palette-generator-spec.org)16
-rw-r--r--docs/specs/theme-studio-semantic-theme-architecture-spec.org (renamed from docs/theme-studio-semantic-theme-architecture-spec.org)8
2 files changed, 16 insertions, 8 deletions
diff --git a/docs/theme-studio-palette-generator-spec.org b/docs/specs/theme-studio-palette-generator-spec-doing.org
index fca76b9c1..b98e10789 100644
--- a/docs/theme-studio-palette-generator-spec.org
+++ b/docs/specs/theme-studio-palette-generator-spec-doing.org
@@ -1,16 +1,20 @@
+:PROPERTIES:
+:ID: 2df157b8-c7c1-47a9-b080-d9586c6f424c
+:STATUS: doing
+:END:
#+TITLE: Theme Studio Palette Generator -- Spec
#+AUTHOR: Craig Jennings
#+DATE: 2026-06-14
#+TODO: TODO | DONE SUPERSEDED CANCELLED
* Metadata
-| Status | draft |
+| Status | doing |
|----------+-------|
| Owner | Craig |
|----------+-------|
| Reviewer | Craig |
|----------+-------|
-| Related | [[file:../todo.org::*theme-studio palette generator][theme-studio palette generator task]] |
+| Related | [[file:../../todo.org::*theme-studio palette generator][theme-studio palette generator task]] |
|----------+-------|
* Summary
@@ -275,20 +279,20 @@ Use the existing Theme Studio test stack:
- [[id:15db8ae3-fc14-49f3-9ed5-d5ff59790904][perceptual color metrics spec]]
- [[file:theme-studio-palette-ramps-spec.org][palette ramps and contrast safety spec]]
- [[file:theme-studio-palette-columns-spec.org][palette columns spec]]
-- [[file:../todo.org::*theme-studio import organization workflow needs a spec][import organization task]]
+- [[file:../../todo.org::*theme-studio import organization workflow needs a spec][import organization task]]
* Review and iteration history
** 2026-06-13 Saturday @ 16:31:01 -0500 -- Craig -- author
- What: Initial draft using the spec-create workflow.
- Why: Palette generation has real design trade-offs around color space, preview/apply behavior, assignment boundaries, and how much generator state should persist.
-- Artifacts: [[file:../todo.org::*theme-studio palette generator][theme-studio palette generator task]].
+- Artifacts: [[file:../../todo.org::*theme-studio palette generator][theme-studio palette generator task]].
** 2026-06-14 Sunday @ 00:44:00 -0500 -- Craig -- author
- What: Reworked the draft around preview-first generation, existing color selector integration, generated tile add-as-column behavior, and source-mode defaults.
- Why: Craig clarified the desired UX: generated colors should be inspectable/tunable through the existing selector, and committing one generated color should create a normal base column.
-- Artifacts: [[file:../todo.org::*theme-studio palette generator][theme-studio palette generator task]].
+- Artifacts: [[file:../../todo.org::*theme-studio palette generator][theme-studio palette generator task]].
** 2026-06-14 Sunday @ 01:07:00 -0500 -- Craig -- author
- What: Folded Craig's inline comments into the design, clarifying source/scheme controls, guidance text, the meaning of schemes, configurable accent count, and rejected-candidate behavior. Removed the comment/source blocks.
- Why: The generator UI needed to say what the user actually sees before implementation can proceed.
-- Artifacts: [[file:../todo.org::*theme-studio palette generator][theme-studio palette generator task]].
+- Artifacts: [[file:../../todo.org::*theme-studio palette generator][theme-studio palette generator task]].
diff --git a/docs/theme-studio-semantic-theme-architecture-spec.org b/docs/specs/theme-studio-semantic-theme-architecture-spec.org
index 25bafe9ea..01ef1902c 100644
--- a/docs/theme-studio-semantic-theme-architecture-spec.org
+++ b/docs/specs/theme-studio-semantic-theme-architecture-spec.org
@@ -1,16 +1,20 @@
+:PROPERTIES:
+:ID: fe980b12-451a-4d8b-a550-d99f9ec49f45
+:STATUS: not-started
+:END:
#+TITLE: Theme Studio Semantic Theme Architecture -- Spec
#+AUTHOR: Craig Jennings
#+DATE: 2026-06-14
#+TODO: TODO | DONE SUPERSEDED CANCELLED
* Metadata
-| Status | draft |
+| Status | not-started |
|----------+-------|
| Owner | Craig |
|----------+-------|
| Reviewer | Craig |
|----------+-------|
-| Related | [[file:../todo.org::*theme-studio semantic theme architecture][theme-studio semantic theme architecture task]] |
+| Related | [[file:../../todo.org::*theme-studio semantic theme architecture][theme-studio semantic theme architecture task]] |
|----------+-------|
* Summary