Changes for page User Needs

Summary

• Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

...	...	@@ -9,6 +9,7 @@
9	9	== 1. Core Reading & Discovery ==
10	10
11	11	=== UN-1: Trust Assessment at a Glance ===
	12	+
12	12	**As** an article reader (any content type),
13	13	**I want** to see a trust score and overall verdict summary at a glance,
14	14	**so that** I can quickly decide if the content is worth my time to read in detail.
...	...	@@ -16,6 +16,7 @@
16	16	**Maps to**: FR7 (Automated Verdicts), NFR3 (Transparency)
17	17
18	18	=== UN-2: Claim Extraction and Verification ===
	20	+
19	19	**As** an article reader,
20	20	**I want** to see the key factual claims extracted from content with verification verdicts (likelihood ranges + uncertainty ratings) for each relevant scenario,
21	21	**so that** I can distinguish proven facts from speculation and understand context-dependent truth.
...	...	@@ -23,6 +23,7 @@
23	23	**Maps to**: FR1 (Claim Intake), FR4 (Scenario Generation), FR7 (Automated Verdicts)
24	24
25	25	=== UN-3: Article Summary with FactHarbor Analysis Summary ===
	28	+
26	26	**As** an article reader,
27	27	**I want** to see an article summary (the document's position, key claims, and reasoning) side-by-side with FactHarbor's analysis summary (source credibility assessment, claim-by-claim verdicts, methodology evaluation, and overall quality verdict),
28	28	**so that** I can quickly understand both what the document claims and FactHarbor's complete analysis of its credibility without reading the full detailed report.
...	...	@@ -39,6 +39,7 @@
39	39	**Credibility:** Very High (peer-reviewed expert consensus)
40	40
41	41	=== The Big Picture ===
	45	+
42	42	**Old belief:** "A glass of wine is good for your heart"
43	43	**New position:** We're no longer sure that's true
44	44
...	...	@@ -50,9 +50,11 @@
50	50	|None|(% style="color:green" %)✅ **Don't start drinking for heart health**
51	51
52	52	=== Why the Shift? ===
	57	+
53	53	Newer genetic studies (Mendelian randomization) found **no evidence** that moderate drinking protects the heart. The apparent benefits in older studies were likely due to lifestyle differences and methodological bias.
54	54
55	55	=== AHA Bottom Line ===
	61	+
56	56	(% class="box" %)
57	57	(((
58	58	If you don't drink, don't start. If you do drink, keep it to ≤2/day (men) or ≤1/day (women). Focus on proven healthy behaviors instead—exercise, diet, not smoking.
...	...	@@ -65,6 +65,7 @@
65	65	**Document:** AHA Scientific Statement on Alcohol and Cardiovascular Disease (2025)
66	66
67	67	=== Source Assessment ===
	74	+
68	68	**Credibility:** (% style="color:green" %)**VERY HIGH**(%%) – Official AHA statement, peer-reviewed, expert panel, published in top journal (//Circulation//)
69	69
70	70	=== Analysis Findings ===
...	...	@@ -96,6 +96,7 @@
96	96	**Key Elements of Two-Panel Layout**:
97	97
98	98	**Left Panel (Article Summary)**:
	106	+
99	99	* Document title and source
100	100	* Source credibility (document's own authority)
101	101	* "The Big Picture" - old belief vs. new position
...	...	@@ -104,6 +104,7 @@
104	104	* "Bottom Line" - document's conclusion
105	105
106	106	**Right Panel (FactHarbor Analysis Summary)**:
	115	+
107	107	* FactHarbor's source assessment (independent credibility check)
108	108	* Claim-by-claim analysis with verdicts and confidence scores
109	109	* Assessment of methodology (strengths/limitations)
...	...	@@ -113,6 +113,7 @@
113	113	**Design Principle**: User sees **what they claim** and **FactHarbor's complete analysis** side-by-side without scrolling.
114	114
115	115	=== UN-4: Social Media Fact-Checking ===
	125	+
116	116	**As** a social media user,
117	117	**I want** to check claims in posts before sharing,
118	118	**so that** I can avoid spreading misinformation.
...	...	@@ -120,6 +120,7 @@
120	120	**Maps to**: FR1 (Claim Intake), FR7 (Automated Verdicts), NFR1 (Performance - fast processing)
121	121
122	122	=== UN-17: In-Article Claim Highlighting ===
	133	+
123	123	**As** a reader viewing an article,
124	124	**I want** to see factual claims highlighted with color-coded credibility indicators (green for well-supported, yellow for uncertain, red for refuted),
125	125	**so that** I can immediately identify which statements are trustworthy and which require skepticism without interrupting my reading flow.
...	...	@@ -150,6 +150,7 @@
150	150	== 2. Source Tracing & Credibility ==
151	151
152	152	=== UN-5: Source Provenance and Track Records ===
	164	+
153	153	**As** an article reader,
154	154	**I want** to trace each piece of evidence back to its original source and see that source's historical track record,
155	155	**so that** I can assess the reliability of the information chain and learn which sources are consistently trustworthy.
...	...	@@ -157,6 +157,7 @@
157	157	**Maps to**: FR5 (Evidence Linking), Section 4.1 (Source Requirements - track record system)
158	158
159	159	=== UN-6: Publisher Reliability History ===
	172	+
160	160	**As** an article reader,
161	161	**I want** to see historical accuracy track records for sources and publishers,
162	162	**so that** I can learn which outlets are consistently reliable over time.
...	...	@@ -166,6 +166,7 @@
166	166	== 3. Understanding the Analysis ==
167	167
168	168	=== UN-7: Evidence Transparency ===
	182	+
169	169	**As** a skeptical reader,
170	170	**I want** to see the evidence and reasoning behind each verdict,
171	171	**so that** I can judge whether I agree with the assessment and form my own conclusions.
...	...	@@ -173,6 +173,7 @@
173	173	**Maps to**: FR5 (Evidence Linking), NFR3 (Transparency)
174	174
175	175	=== UN-8: Understanding Disagreement and Consensus ===
	190	+
176	176	**As** an article reader,
177	177	**I want** to see which scenarios have strong supporting evidence versus which have conflicting evidence or high uncertainty,
178	178	**so that** I can understand where legitimate disagreement exists versus where consensus is clear.
...	...	@@ -180,6 +180,7 @@
180	180	**Maps to**: FR6 (Scenario Comparison), FR7 (Automated Verdicts - uncertainty factors), AKEL Gate 2 (Contradiction Search)
181	181
182	182	=== UN-9: Methodology Transparency ===
	198	+
183	183	**As** an article reader,
184	184	**I want** to understand how likelihood ranges and confidence scores are calculated,
185	185	**so that** I can trust the verification process itself.
...	...	@@ -189,6 +189,7 @@
189	189	== 4. Pattern Recognition & Learning ==
190	190
191	191	=== UN-10: Manipulation Tactics Detection ===
	208	+
192	192	**As** an article reader,
193	193	**I want** to see common manipulation tactics or logical fallacies identified in content,
194	194	**so that** I can recognize them elsewhere and become a more critical consumer of information.
...	...	@@ -196,6 +196,7 @@
196	196	**Maps to**: AKEL (Bubble Detection), Section 5 (Automated Risk Scoring)
197	197
198	198	=== UN-11: Filtered Research ===
	216	+
199	199	**As** a researcher,
200	200	**I want** to filter content by verification status, confidence levels, and source quality,
201	201	**so that** I can work only with reliable information appropriate for my research needs.
...	...	@@ -205,6 +205,7 @@
205	205	== 5. Taking Action ==
206	206
207	207	=== UN-12: Submit Unchecked Claims ===
	226	+
208	208	**As** a reader who finds unchecked claims,
209	209	**I want** to submit them for verification,
210	210	**so that** I can help expand fact-checking coverage and contribute to the knowledge base.
...	...	@@ -212,6 +212,7 @@
212	212	**Maps to**: FR1 (Claim Intake), Section 1.1 (Reader role)
213	213
214	214	=== UN-13: Cite FactHarbor Verdicts ===
	234	+
215	215	**As** a content creator,
216	216	**I want** to cite FactHarbor verdicts when sharing content,
217	217	**so that** I can add credibility to what I publish and help my audience distinguish fact from speculation.
...	...	@@ -221,6 +221,7 @@
221	221	== 6. Professional Use ==
222	222
223	223	=== UN-14: API Access for Integration ===
	244	+
224	224	**As** a journalist/researcher,
225	225	**I want** API access to verification data and claim histories,
226	226	**so that** I can integrate fact-checking into my professional workflow without manual lookups.
...	...	@@ -244,6 +244,7 @@
244	244	**Maps to**: ~~FR8 (Deferred)~~, Data Model (Versioned entities), NFR3 (Transparency)
245	245
246	246	=== UN-16: AI vs. Human Review Status ===
	268	+
247	247	**As** an article reader,
248	248	**I want** to know if the verdict was AI-generated, human-reviewed, or expert-validated,
249	249	**so that** I can gauge the appropriate level of trust and understand the review process used.
...	...	@@ -301,6 +301,7 @@
301	301	This section identifies user needs that may emerge as the platform matures:
302	302
303	303	**Potential Future Needs**:
	326	+
304	304	* **Collaborative annotation**: Users want to discuss verdicts with others
305	305	* **Personal tracking**: Users want to track claims they're following
306	306	* **Custom alerts**: Users want notifications when tracked claims are updated
...	...	@@ -308,6 +308,7 @@
308	308	* **Comparative analysis**: Users want to compare how different fact-checkers rate the same claim
309	309
310	310	**When to address**: These needs should be considered when:
	334	+
311	311	1. User feedback explicitly requests them
312	312	2. Usage metrics show users attempting these workflows
313	313	3. Competitive analysis shows these as differentiators
...	...	@@ -319,7 +319,7 @@
319	319	* [[Requirements>>FactHarbor.Specification.Requirements.WebHome]] - Parent page with roles, rules, and functional requirements
320	320	* [[Architecture>>FactHarbor.Specification.Architecture.WebHome]] - How requirements are implemented
321	321	* [[Data Model>>FactHarbor.Specification.Data Model.WebHome]] - Data structures supporting user needs
322		-* [[AKEL (AI Knowledge Extraction Layer)>>FactHarbor.Specification.AI Knowledge Extraction Layer (AKEL).WebHome]] - AI system fulfilling automation needs
	346	+* [[AKEL (AI Knowledge Extraction Layer)>>Archive.FactHarbor.Specification.AI Knowledge Extraction Layer (AKEL).WebHome]] - AI system fulfilling automation needs
323	323	* [[Workflows>>FactHarbor.Specification.Workflows.WebHome]] - User interaction workflows
324	324
325	325	== Additional User Needs (V0.9.70) ==
...	...	@@ -347,4 +347,3 @@
347	347	**So that** I can contribute without fear
348	348
349	349	**Requirements:** FR48 (Safety Framework)
350		-