diff --git a/specs/llm-types-design.md b/docs/1-llm-types-design.md
similarity index 100%
rename from specs/llm-types-design.md
rename to docs/1-llm-types-design.md
diff --git a/specs/llm-call-lifecycle.md b/docs/2-llm-call-lifecycle.md
similarity index 100%
rename from specs/llm-call-lifecycle.md
rename to docs/2-llm-call-lifecycle.md
diff --git a/specs/roadmap.md b/docs/roadmap.md
similarity index 100%
rename from specs/roadmap.md
rename to docs/roadmap.md