Bootstrap project and safe work-item workflow

README.md

@@ -0,0 +1,32 @@
+# Photo Analyzer
+
+Integrated, restart-safe photo analysis, duplicate review, metadata, upload, and
+archive workflow. Planning lives in `INTEGRATED_PIPELINE_CONCEPT.md` and
+`delivery_backlog/`.
+
+## Agent workflow helper
+
+Requirements: Python 3.11+, Git, and an authenticated `tea` login named `domverse`.
+
+```bash
+scripts/work-item next
+scripts/work-item claim
+scripts/work-item status
+scripts/work-item submit --test "python3 -m unittest discover -s tests -v"
+scripts/work-item submit --test "python3 -m unittest discover -s tests -v" --yes
+scripts/work-item complete --merge
+scripts/work-item block --reason "precise blocking condition"
+```
+
+The helper selects the lowest numbered open story whose dependencies are closed,
+creates a story branch, runs required tests, rejects private or unsafe files, creates a
+pull request, and closes the issue only after the merge is verified.
+
+Workflow state is stored inside `.git/` and is never committed. Status labels are the
+machine-readable source of truth; the Gitea Project board is the visual view.
+
+## Tests
+
+```bash
+python3 -m unittest discover -s tests -v
+```