diff --git a/packages/create-awesome-python-app/README.md b/packages/create-awesome-python-app/README.md
new file mode 100644
index 0000000..f09e3f2
--- /dev/null
+++ b/packages/create-awesome-python-app/README.md
@@ -0,0 +1,5 @@
+# create-awesome-python-app
+
+CLI package (stub). Entry point: `create-awesome-python-app`.
+
+Depends on workspace member `create-python-app-core`.
diff --git a/packages/create-awesome-python-app/pyproject.toml b/packages/create-awesome-python-app/pyproject.toml
index fea79df..4655243 100644
--- a/packages/create-awesome-python-app/pyproject.toml
+++ b/packages/create-awesome-python-app/pyproject.toml
@@ -2,11 +2,15 @@
 name = "create-awesome-python-app"
 version = "0.0.0"
 description = "Composable scaffolding CLI for production-ready Python apps (stub)"
+readme = "README.md"
 requires-python = ">=3.12"
 dependencies = [
     "create-python-app-core",
 ]
 
+[project.scripts]
+create-awesome-python-app = "create_awesome_python_app.cli:main"
+
 [tool.uv.sources]
 create-python-app-core = { workspace = true }
 
diff --git a/packages/create-awesome-python-app/src/create_awesome_python_app/cli.py b/packages/create-awesome-python-app/src/create_awesome_python_app/cli.py
new file mode 100644
index 0000000..6bd53bb
--- /dev/null
+++ b/packages/create-awesome-python-app/src/create_awesome_python_app/cli.py
@@ -0,0 +1,5 @@
+"""CLI entrypoint placeholder (full Typer app lands in Epic 4)."""
+
+
+def main() -> None:
+    print("create-awesome-python-app stub — see roadmap issue #1")
diff --git a/packages/create-python-app-core/README.md b/packages/create-python-app-core/README.md
new file mode 100644
index 0000000..4e8427e
--- /dev/null
+++ b/packages/create-python-app-core/README.md
@@ -0,0 +1,3 @@
+# create-python-app-core
+
+Programmatic scaffolding engine (stub). Consumed by `create-awesome-python-app`.
diff --git a/packages/create-python-app-core/pyproject.toml b/packages/create-python-app-core/pyproject.toml
index 7972ad0..d2087b6 100644
--- a/packages/create-python-app-core/pyproject.toml
+++ b/packages/create-python-app-core/pyproject.toml
@@ -2,6 +2,7 @@
 name = "create-python-app-core"
 version = "0.0.0"
 description = "Scaffolding engine for Create Awesome Python App (stub)"
+readme = "README.md"
 requires-python = ">=3.12"
 dependencies = []