feat(arch): finalize Universal Literate Note transition for all projects and skills

notes/zotero-org-import-tool.org

@@ -0,0 +1,50 @@
+#+TITLE: PROJECT: Zotero Org Import Tool (Universal Literate Note)
+#+ID: project-zotero-org-import-tool
+#+STARTUP: content
+#+FILETAGS: :research:zettelkasten:zotero:import:psf:
+
+* Overview
+The **Zotero Org Import Tool** is a "makeshift" utility designed to bridge the gap between academic research management (Zotero) and the personal knowledge base (Org-mode). It focuses on two critical priorities: accurate linking to academic PDFs and creating persistent web snapshots for bookmarks.
+
+* Phase A: Demand (PRD)
+:PROPERTIES:
+:STATUS: FROZEN
+:END:
+
+** 1. Purpose
+Define the requirements for a high-fidelity import of research artifacts from Zotero to Org-mode.
+
+** 2. User Needs
+- **BibTeX/JSON Parsing:** Ingest Zotero libraries via standard export formats.
+- **Attachment Linking:** Maintain durable links to local PDF attachments.
+- **Web Persistence:** Generate local or service-based snapshots of imported URLs.
+- **Org-Native Schema:** Map Zotero metadata fields to appropriate Org properties.
+
+** 3. Success Criteria
+*** TODO Successful parsing of Zotero JSON export
+*** TODO Verification of direct PDF file links in Org headlines
+*** TODO Snapshot generation for at least one web bookmark
+*** TODO Automated :CREATED: property injection based on Zotero "Date Added"
+
+* Phase B: Blueprint (PROTOCOL)
+:PROPERTIES:
+:STATUS: SIGNED
+:END:
+
+** 1. Architectural Intent
+Interfaces for data transformation and snapshot retrieval. Source of truth is the Zotero SQLite database/export and the local filesystem.
+
+** 2. Semantic Interfaces
+#+begin_src bash
+(defun zotero-import-library (export-path)
+  "Parses the export and appends new entries to library.org.")
+
+(defun zotero-resolve-attachment (zotero-key)
+  "Locates the physical PDF associated with a Zotero record.")
+#+end_src
+
+* Phase D: Build (Implementation)
+Current implementation status is "Demand Phase." Placeholder for future Lisp/Python logic.
+
+* Phase E: Chaos (Verification)
+Verification involves importing a test collection and ensuring all PDFs are openable and all web links have valid snapshots.