Changes for page Requirements

Last modified by Robert Schaub on 2025/12/24 20:34

From version 1.1
edited by Robert Schaub
on 2025/12/16 20:34
Change comment: Imported from XAR
To version 1.3
edited by Robert Schaub
on 2025/12/16 20:40
Change comment: Update document after refactoring.

Summary

Details

Page properties
Parent
... ... @@ -1,1 +1,1 @@
1 -Test.FactHarborV09.Specification.WebHome
1 +Test.FactHarbor V0\.9\.23 Lost Data.Specification.WebHome
Content
... ... @@ -9,6 +9,7 @@
9 9  **Who**: Anyone (no login required).
10 10  
11 11  **Can**:
12 +
12 12  * Browse and search claims
13 13  * View scenarios, evidence, verdicts, and timelines
14 14  * Compare scenarios and explore assumptions
... ... @@ -18,6 +18,7 @@
18 18  * **Submit claims automatically** by providing text to analyze - new claims are added automatically unless equal claims already exist in the system
19 19  
20 20  **Cannot**:
22 +
21 21  * Modify existing content
22 22  * Access draft content
23 23  * Participate in governance decisions
... ... @@ -29,6 +29,7 @@
29 29  **Who**: Registered and logged-in users (extends Reader capabilities).
30 30  
31 31  **Can**:
34 +
32 32  * Everything a Reader can do
33 33  * Submit claims
34 34  * Submit evidence
... ... @@ -38,6 +38,7 @@
38 38  * Request human review of AI-generated content
39 39  
40 40  **Cannot**:
44 +
41 41  * Publish or mark content as "reviewed" or "approved"
42 42  * Override expert or maintainer decisions
43 43  * Directly modify AKEL or quality gate configurations
... ... @@ -47,6 +47,7 @@
47 47  **Who**: Trusted community members, appointed by maintainers.
48 48  
49 49  **Can**:
54 +
50 50  * Review contributions from Contributors and AKEL drafts
51 51  * Validate AI-generated content (Mode 2 → Mode 3 transition)
52 52  * Edit claims, scenarios, and evidence
... ... @@ -57,6 +57,7 @@
57 57  * Participate in audit sampling
58 58  
59 59  **Cannot**:
65 +
60 60  * Approve Tier A content for "Human-Reviewed" status (requires Expert)
61 61  * Change governance rules
62 62  * Unilaterally change expert conclusions without process
... ... @@ -63,6 +63,7 @@
63 63  * Bypass quality gates
64 64  
65 65  **Note on AI-Drafted Content**:
72 +
66 66  * Reviewers can validate AI-generated content (Mode 2) to promote it to "Human-Reviewed" (Mode 3)
67 67  * For Tier B and C, Reviewers have approval authority
68 68  * For Tier A, only Experts can grant "Human-Reviewed" status
... ... @@ -72,6 +72,7 @@
72 72  **Who**: Subject-matter specialists in specific domains (medicine, law, science, etc.).
73 73  
74 74  **Can**:
82 +
75 75  * Everything a Reviewer can do
76 76  * **Final authority** on Tier A content "Human-Reviewed" status
77 77  * Validate complex or controversial claims in their domain
... ... @@ -81,11 +81,13 @@
81 81  * Override AKEL suggestions in their domain (with documentation)
82 82  
83 83  **Cannot**:
92 +
84 84  * Change platform governance policies
85 85  * Approve content outside their expertise domain
86 86  * Bypass technical quality gates (but can flag for adjustment)
87 87  
88 88  **Specialization**:
98 +
89 89  * Experts are domain-specific (e.g., "Medical Expert", "Legal Expert", "Climate Science Expert")
90 90  * Cross-domain claims may require multiple expert reviews
91 91  
... ... @@ -94,6 +94,7 @@
94 94  **Who**: Reviewers or Experts assigned to sampling audit duties.
95 95  
96 96  **Can**:
107 +
97 97  * Review sampled AI-generated content against quality standards
98 98  * Validate quality gate enforcement
99 99  * Identify patterns in AI errors or hallucinations
... ... @@ -102,16 +102,19 @@
102 102  * Contribute to audit statistics and transparency reports
103 103  
104 104  **Cannot**:
116 +
105 105  * Change audit sampling algorithms (maintainer responsibility)
106 106  * Bypass normal review workflows
107 107  * Audit content they personally created
108 108  
109 109  **Selection**:
122 +
110 110  * Auditors selected based on domain expertise and review quality
111 111  * Rotation to prevent audit fatigue
112 112  * Stratified assignment (Tier A auditors need higher expertise)
113 113  
114 114  **Audit Focus**:
128 +
115 115  * Tier A: Recommendation 30-50% sampling rate, expert auditors
116 116  * Tier B: Recommendation 10-20% sampling rate, reviewer/expert auditors
117 117  * Tier C: Recommendation 5-10% sampling rate, reviewer auditors
... ... @@ -121,6 +121,7 @@
121 121  **Who**: Maintainers or trusted long-term contributors.
122 122  
123 123  **Can**:
138 +
124 124  * All Reviewer and Expert capabilities (cross-domain)
125 125  * Manage user accounts and permissions
126 126  * Handle disputes and conflicts
... ... @@ -131,6 +131,7 @@
131 131  * Oversee audit system performance
132 132  
133 133  **Cannot**:
149 +
134 134  * Change core data model or architecture
135 135  * Override technical system constraints
136 136  * Make unilateral governance decisions without consensus
... ... @@ -140,6 +140,7 @@
140 140  **Who**: Core team members responsible for the platform.
141 141  
142 142  **Can**:
159 +
143 143  * All Moderator capabilities
144 144  * Change data model, architecture, and technical systems
145 145  * Configure quality gates and AKEL parameters
... ... @@ -151,14 +151,15 @@
151 151  * Grant and revoke roles
152 152  
153 153  **Governance**:
171 +
154 154  * Maintainers operate under organizational governance rules
155 155  * Major policy changes require Governing Team approval
156 156  * Technical decisions made collaboratively
157 157  
158 -
159 159  == 2. Content Publication States ==
160 160  
161 161  === 2.1 Mode 1: Draft ===
179 +
162 162  * Not visible to public
163 163  * Visible to contributor and reviewers
164 164  * Can be edited by contributor or reviewers
... ... @@ -165,18 +165,20 @@
165 165  * Default state for failed quality gates
166 166  
167 167  === 2.2 Mode 2: AI-Generated (Published) ===
186 +
168 168  * **Public** and visible to all users
169 169  * Clearly labeled as "AI-Generated, Awaiting Human Review"
170 170  * Passed all automated quality gates
171 171  * Risk tier displayed (A/B/C)
172 172  * Users can:
173 - ** Read and use content
174 - ** Request human review
175 - ** Flag for expert attention
192 +** Read and use content
193 +** Request human review
194 +** Flag for expert attention
176 176  * Subject to sampling audits
177 177  * Can be promoted to Mode 3 by reviewer/expert validation
178 178  
179 179  === 2.3 Mode 3: Human-Reviewed (Published) ===
199 +
180 180  * **Public** and visible to all users
181 181  * Labeled as "Human-Reviewed" with reviewer/expert attribution
182 182  * Passed quality gates + human validation
... ... @@ -185,15 +185,16 @@
185 185  * For Tier B/C, Reviewer approval sufficient
186 186  
187 187  === 2.4 Rejected ===
208 +
188 188  * Not visible to public
189 189  * Visible to contributor with rejection reason
190 190  * Can be resubmitted after addressing issues
191 191  * Rejection logged for transparency
192 192  
193 -
194 194  == 3. Contribution Rules ==
195 195  
196 196  === 3.1 All Contributors Must: ===
217 +
197 197  * Provide sources for claims
198 198  * Use clear, neutral language
199 199  * Avoid personal attacks or insults
... ... @@ -201,6 +201,7 @@
201 201  * Accept community feedback gracefully
202 202  
203 203  === 3.2 AKEL (AI) Must: ===
225 +
204 204  * Mark all outputs with `AuthorType = AI`
205 205  * Pass quality gates before Mode 2 publication
206 206  * Perform mandatory contradiction search
... ... @@ -210,6 +210,7 @@
210 210  * Submit to audit sampling
211 211  
212 212  === 3.3 Reviewers Must: ===
235 +
213 213  * Be impartial and evidence-based
214 214  * Document reasoning for decisions
215 215  * Escalate to experts when appropriate
... ... @@ -217,6 +217,7 @@
217 217  * Provide constructive feedback
218 218  
219 219  === 3.4 Experts Must: ===
243 +
220 220  * Stay within domain expertise
221 221  * Disclose conflicts of interest
222 222  * Document specialized terminology
... ... @@ -223,10 +223,10 @@
223 223  * Provide reasoning for domain-specific decisions
224 224  * Participate in Tier A audits
225 225  
226 -
227 227  == 4. Quality Standards ==
228 228  
229 229  === 4.1 Source Requirements ===
253 +
230 230  * Primary sources preferred over secondary
231 231  * Publication date and author must be identifiable
232 232  * Sources must be accessible (not paywalled when possible)
... ... @@ -234,6 +234,7 @@
234 234  * Echo chamber sources must be flagged
235 235  
236 236  === 4.2 Claim Requirements ===
261 +
237 237  * Falsifiable or evaluable
238 238  * Clear definitions of key terms
239 239  * Boundaries and scope stated
... ... @@ -241,6 +241,7 @@
241 241  * Uncertainty acknowledged
242 242  
243 243  === 4.3 Evidence Requirements ===
269 +
244 244  * Relevant to the claim and scenario
245 245  * Reliability assessment provided
246 246  * Methodology described (for studies)
... ... @@ -247,7 +247,6 @@
247 247  * Limitations noted
248 248  * Conflicting evidence acknowledged
249 249  
250 -
251 251  == 5. Risk Tier Assignment ==
252 252  
253 253  **Automated (AKEL)**: Initial tier suggested based on domain, keywords, impact
... ... @@ -255,6 +255,7 @@
255 255  **Review**: Risk tiers periodically reviewed based on audit outcomes
256 256  
257 257  **Tier A Indicators**:
283 +
258 258  * Medical diagnosis or treatment advice
259 259  * Legal interpretation or advice
260 260  * Election or voting information
... ... @@ -263,6 +263,7 @@
263 263  * Potential for significant harm
264 264  
265 265  **Tier B Indicators**:
292 +
266 266  * Complex scientific causality
267 267  * Contested policy domains
268 268  * Historical interpretation with political implications
... ... @@ -269,6 +269,7 @@
269 269  * Significant economic impact claims
270 270  
271 271  **Tier C Indicators**:
299 +
272 272  * Established historical facts
273 273  * Simple definitions
274 274  * Well-documented scientific consensus
... ... @@ -281,7 +281,7 @@
281 281  
282 282  The following diagram visualizes the complete role hierarchy:
283 283  
284 -{{include reference="Test.FactHarborV09.Specification.Diagrams.User Class Diagram.WebHome"}}
312 +{{include reference="Test.FactHarbor V0\.9\.23 Lost Data.Specification.Diagrams.User Class Diagram.WebHome"}}
285 285  
286 286  
287 287  
... ... @@ -620,4 +620,4 @@
620 620  * [[Automation>>Test.FactHarborV09.Specification.Automation.WebHome]]
621 621  * [[Workflows>>Test.FactHarborV09.Specification.Workflows.WebHome]]
622 622  * [[Governance>>Test.FactHarborV09.Organisation.Governance]]
623 -
651 +{{/include}}