diff --git a/docs/portfolio-maintenance.md b/docs/portfolio-maintenance.md
new file mode 100644
index 0000000..ceb74fc
--- /dev/null
+++ b/docs/portfolio-maintenance.md
@@ -0,0 +1,19 @@
+# Portfolio Maintenance Notes
+
+Last automated review: 2026-06-22
+
+This file tracks lightweight portfolio-quality checks for this repository.
+
+## Review checklist
+
+- README explains the project quickly.
+- Setup or usage command is visible.
+- Example output or expected behavior is documented.
+- CI status should stay green.
+- Claims should stay factual and not imply production usage unless true.
+
+## Next improvement ideas
+
+- Add or refresh a screenshot/demo output.
+- Add a smoke-test command.
+- Add troubleshooting notes for common setup issues.