diff --git a/docs/cpa-vs-cna-config.md b/docs/cpa-vs-cna-config.md
new file mode 100644
index 0000000..c048b91
--- /dev/null
+++ b/docs/cpa-vs-cna-config.md
@@ -0,0 +1,22 @@
+# `cpa.config.json` vs `cna.config.json`
+
+| Concern | CNA | CPA |
+|---------|-----|-----|
+| Config file | `cna.config.json` | `cpa.config.json` |
+| Manifest | `package.json` | `pyproject.toml` |
+| Installer | npm/yarn/pnpm/bun | `uv sync` |
+| Lint defaults | ESLint | Ruff |
+| Custom options | `customOptions[]` | same shape |
+
+See also [cpa-config-schema.md](./cpa-config-schema.md).
+
+## Minimal FastAPI stub example
+
+```json
+{
+  "name": "fastapi-starter",
+  "customOptions": [
+    {"key": "projectName", "type": "string", "default": "my-api"}
+  ]
+}
+```