Platform Guide

How AIR-SPJ Works

Visual reference for all user types — from first-time visitors to platform authors and admins. Each section explains a workflow, role, or structural concept in the AIR-SPJ evidence platform.

Section 1

Who Uses the Platform

The platform serves four distinct user types, each with progressively more access. Public visitors can explore without logging in. Contributors are approved researchers who submit evidence. Authors are the three-member core team who vote on submissions. Admins manage the platform.

AIR-SPJEvidence Platform12 Domains · 87 ElementsTiered Evidence BasePUBLIC VISITORNo login requiredBrowse elements & evidenceSearch connectionsRead sitreps & updatesExplore evidence mapCONTRIBUTORApproved researcher / practitionerSubmit evidence (PDF/URL/text)Submit observationsReview AI element mappingTrack submission statusContributor leaderboardAUTHORCore team — 3 membersAll contributor capabilitiesReview evidence queueVote approve / reject / flagEdit metadata (type / tier)Final approval decisionManage elements & frameworkADMINPlatform managementAll author capabilitiesUser role managementApprove contributor applicationsKnowledge base & audit logApply at /contributeInvite only · /admin
Section 2

Evidence Submission — 3-Step Wizard

Contributors submit evidence through a guided three-step wizard. The AI assists throughout — extracting metadata from PDFs, suggesting element connections, and classifying source type and tier. Only the title is required; everything else is AI-suggested and can be corrected.

1Document InfoMetadata & AI ExtractionOption AUpload PDF → AI fills all fields including abs…tract, source type, tier, citation, key find…Option BPaste URL or DOI → AI fetches and extracts met…adataOption CPaste abstract text → AI classifiesOnly title requiredAll other fields are AI-suggested — you can co…rrect them2Document ContentFull text for AI element analysisUpload PDF/DOCXText extracted automaticallyOr paste textUp to 300,000 characters analyzedAuto-loadedIf PDF uploaded in Step 1, text is pre-filled …hereMin 50 charsRequired to run AI element mapping3Review ConnectionsAI maps to 87 SPJ elementsAI suggestionsEach shows element code, excerpt, confidence s…core, and reasoningYour decisionsAccept · Decline · Flag each connection indivi…duallyAdd manualCreate your own connections not caught by AISubmitEnters Author Review Queue — no auto-publish

Step 1 goal

Capture document identity — title, authors, abstract, source type, evidence tier, and citation. AI fills these from a PDF upload.

Step 2 goal

Provide the full document text so the AI can map it to the 87 SPJ elements with passage-level citations.

Step 3 goal

Review every AI-suggested element connection. Accept the ones that fit, decline the ones that don't, and add any the AI missed.

Section 3

Contributor Journey

Becoming a contributor starts with creating a free account, then applying at /contribute. Any author or admin can approve an application — approval immediately grants the requested role on your existing account, and you'll get an email the moment it happens. No separate invite link required; just sign back in and start submitting.

DiscoverVisit airspj.comBrowse frameworkApplyFill out /contributeDescribe your backgroundApprovedAdmin reviewAccount createdSubmitEvidence wizard3-step guided flowReview3 authors voteMetadata verifiedPublishedLive in libraryCredit on profile
Section 4

Review & Voting — Author Decision Process

Every submission is reviewed by up to three platform authors. As soon as two of the three agree (approve or reject), the item resolves automatically and — if approved — is published to the public Evidence Library and Evidence Map immediately, no further step required. The site admin can also override at any point to finalize a decision immediately, for example when consensus can't be reached in time. Approving or rejecting an evidence item automatically cascades that status to all of its element connections.

SUBMITTEDEnters queueAll 3 authors notifiedAUTHOR VOTESUp to 3 votesEach with rationale2/3 CONSENSUSResolves automaticallyNo manual step neededPUBLISHEDLibrary + Evidence MapConnections auto-approvedAuthor vote typesApproveRejectFlagRequest changes⚡ Admin Override — parallel path, any timeSite admin can approve/reject directly, bypassing the votecount — publishes immediately, same as 2/3 consensus
Section 5

Framework Architecture — Domains, Elements & Evidence

The AIR-SPJ framework is organized into 12 clinical domains with 87 total elements. Each element is a discrete behavioral risk indicator assessed in cases where AI interaction is a contributing factor. Evidence connections tie peer-reviewed and practitioner literature directly to individual elements, passage by passage.

SPJ FRAMEWORKStructured Professional Judgment — assessed when AI interaction is a contributing case factorEach element rated: Present · Possibly Present · Not Present · Not ApplicableD01AI Interaction Profile6–8 elementsD02Dependency6–8 elementsD03Attachment6–8 elementsD04Grievance Amplification6–8 elementsD05Delusional Fusion6–8 elementsD06Radicalization6–8 elementsD07Tactical Planning6–8 elementsD08Anti-AI Grievance6–8 elementsD09Self-Harm6–8 elementsD10Targeted Violence6–8 elementsD11Protective Factors6–8 elementsD12Data Reliability6–8 elementsEVIDENCE CONNECTIONSPassage-level citations linking each source document to specific framework elements14 source types · 6 evidence tiers · direction · strength · AI reasoning · author decision — all publicly browsable
Section 6

Source Type Taxonomy & Evidence Tiers

The platform recognizes 14 distinct source types and a 6-level evidence tier hierarchy. AI classifies both automatically during submission; authors can correct them during review. Tier 1–2 represents the strongest evidence (systematic reviews, RCTs). Tier 5–6 captures expert opinion and practitioner field observations.

SOURCE TYPES (14)Systematic review / meta-analysisT1–2Randomized controlled trial (RCT)T1–2Quasi-experimental studyT2–3Prospective cohort studyT3Cross-sectional surveyT3–4Case-control studyT3Retrospective analysisT3–4Case report / case seriesT4–5Practitioner survey / field studyT4Commentary / editorialT5Theoretical / conceptual paperT4–5Practitioner observationT5–6News / investigative reportT5Technical / industry reportT4–5EVIDENCE TIERS (6)1Systematic review / meta-analysisStrongest — highest confidence2RCT · Quasi-experimentalStrongest — highest confidence3Observational (cohort, survey, case-control)Moderate — good research design4Case series · practitioner survey · technical reportModerate — good research design5Expert opinion · commentary · editorialSupporting — expert opinion or field observation6Anecdotal · practitioner observationSupporting — expert opinion or field observation
Section 7

Admin Queues — What Authors Review

The admin console contains four review queues. The Evidence Queue is the primary workflow — every vote and metadata correction happens there. The Connection Queue is read-only status tracking (connections are decided automatically when parent evidence is decided). The Observation Queue handles practitioner field submissions. The Application Queue manages contributor onboarding.

Evidence QueueNew submissionsReview metadataVote approve/rejectEdit source type/tierFinal decision → auto-cascade to connectionsConnection QueueAuto-managedStatus view onlyConnections auto-approvedwhen parent evidence decidedLink → review parent itemObservation QueueField submissionsReview practitioner notesVote approve/rejectLink to elements if applicableNotify contributorApplication QueueContributor applicantsReview background statementApprove → account createdSend invite emailRole assignment

⚡ Final Approval Needed badge

When 2 of 3 authors have voted the same way on an evidence item, an amber badge appears in the Evidence Queue table. This signals that the lead author (Jameson) can now make the final binding decision. The badge disappears once the item is approved or rejected.

Section 9

Practitioner Observations — Field Submission Flow

Practitioner observations are a distinct submission type from evidence. They don't require a published source document — they capture anonymized field experiences from threat assessment professionals who have encountered AI interaction as a case factor. They go through the same 3-author review process but use a lighter form tied directly to a single framework element.

1Select ElementBrowse 12 domainsFind the specific element your observation relates toEach element has a code (e.g. D03-E02)2Describe ObservationCase context (anonymized)What AI behavior was observedHow it related to the elementPractitioner role & setting3Submit for ReviewEnters Observation QueueAuthors vote independentlyRationale & element fit assessedNo PDF required4PublishedLinked to element in libraryAnonymized & attributedCounted in evidence coverageCredited on your profileObservations differ from evidence: no PDF required · connects directly to one element · lighter form · same 3-author review process
Section 10

SPJ Assessment Model — How Practitioners Apply the Framework

The AIR-SPJ is a structured professional judgment tool — not a checklist or scoring instrument. Practitioners use it to systematically consider AI-mediated risk factors within a broader clinical or threat assessment formulation. The four-step model below describes the intended workflow for professionals using the framework in active cases.

SPJ Assessment Model — How Practitioners Use the AIR-SPJ FrameworkSTEP 1Identify AI RoleIs AI interaction a factor in this case?What platform(s) were involved?What was the nature of interaction?Duration, frequency, intensity?Subject's reported relationship to AI?Any AI-generated content involved?STEP 2Rate ElementsFor each relevant domain:PPresentClear evidence in case materialPPPossibly PresentSuggestive but uncertainNPNot PresentNo evidence of this factorNANot ApplicableCannot assess / no dataSTEP 3ContextualizeReview D11 protective factorsConsider pre-existing conditionsAssess data reliability (D12)Weigh pattern vs. single itemsNote gaps in available dataDistinguish correlation vs. causationSTEP 4Formulate & ActDocument rated elementsNarrative summary of AI roleManagement recommendationsMonitoring indicatorsReferral considerationsContribute observations⚠ AIR-SPJ is a structured professional judgment tool — not a checklist score. Clinical expertise is required for all risk formulations.

Not a validated instrument

The AIR-SPJ framework is under active development and has not yet undergone formal psychometric validation. It should not be used as a standalone risk assessment tool. All formulations require the clinical judgment of a qualified threat assessment professional.

Section 11

AI Copilot — Research Assistant

The Copilot at /copilot is a RAG-powered research assistant that answers questions about the AIR-SPJ framework, its evidence base, and AI-mediated risk topics. It draws exclusively from the platform's approved content — it does not search the open web — and cites specific evidence items and element codes in every response. No login required.

YOU ASK"What evidence exists for D04?""Summarize attachment domain""Find studies on AI dependency""How is Tier 2 defined?"AI COPILOTRAG — Retrieval Augmented GenerationKnowledge sources searched:Approved evidence librarySPJ element descriptionsAdmin knowledge base docsPublished practitioner observationsCites source items in every responseNo hallucinated citationsYOU RECEIVESynthesized answer with citationsElement code references (D04-E02)Tier + source type per citationLinks to full evidence itemsWHO CAN USE ITPublic visitorsNo login neededContributorsResearch supportAuthorsReview assistancePractitionersCase researchResearchersLiterature queries
Section 12

Data & Privacy — What's Public vs. Private

The platform is built on a principle of radical transparency for the evidence base and strict privacy for individuals. All approved research and connections are public by design — the goal is an open, auditable record of how the framework is built. Contributor identities, review deliberations, and rejected submissions are never exposed.

PUBLIC — No Login RequiredVisible to anyone at airspj.comAll approved evidence items (title, abstract, citation, source type, tier)All approved element connections (element code, excerpt, strength, direction)Framework elements and domain descriptionsContributor display names / aliasesEvidence coverage analytics and gap mapsPractitioner observation summaries (anonymized)PRIVATE — Login / Admin OnlyNever exposed publiclyContributor real names (alias used publicly unless opt-in)Email addresses (never displayed)Review votes, rationales, and internal deliberationsRejected or draft submissionsApplication details for prospective contributorsAdmin audit logs and internal notes
Section 13

Public Pages — No Login Required

Most of the platform is publicly accessible. Anyone can browse the framework, read evidence, explore the network map, and use the AI Copilot. Login is only required to submit evidence or access admin functions.