PsycheCross Specification

Home / PsycheCross / PsycheCross Specification

PsycheCross

When Instinct Speaks, Awareness Listens.

PsycheCross is an AGPL-3.0+ specification for an AI-assisted cognitive framework that explores the interaction between logic, emotion, instinct, and higher awareness. It uses a symbolic four-direction cross to help identify cognitive influences, recognize disproportionate primitive responses, expand awareness, and support more integrated decision-making.

Purpose

PsycheCross provides a modular framework for AI systems that assist people in examining thoughts, reactions, decisions, conflicts, behaviors, and potential outcomes through four symbolic cognitive domains.

The framework represents:

Left: Logical Mind
Right: Emotional Mind
Top: Higher Mind
Bottom: Primitive Mind

The objective is not to suppress any quadrant. PsycheCross treats instinct, emotion, logic, and higher awareness as sources of information that can contribute to conscious choice.

The ultimate goal is represented by the + symbol, where all four directions are acknowledged and brought into balance.

PsycheCross is a symbolic cognitive framework and must not represent the four quadrants as literal anatomical regions of the brain or as direct measurements of neurological activity.

Core Principles

Instinct provides information that can be examined through awareness.
Primitive responses can protect against genuine threats but can also dominate reasoning when perceived threats become disproportionate or persistent.
Logic provides analysis, evidence, structure, and consequence evaluation.
Emotion provides information about feelings, relationships, needs, values, and meaning.
Higher awareness provides perspective, reflection, purpose, possibility, and long-term consideration.
No single quadrant should automatically be treated as superior.
Higher awareness should integrate the other quadrants rather than simply suppress them.
The AI should help distinguish reaction from conscious response.
The AI should preserve human agency and avoid making personal decisions on behalf of the user.
The system should seek the highest reasonably achievable integrated outcome.
Balance is an ongoing process rather than a fixed cognitive state.

Cross Model

The PsycheCross model consists of two intersecting axes.

The horizontal axis represents:

Logic ↔ Emotion

The vertical axis represents:

Higher Awareness ↕ Primitive Response

The intersection of the axes represents the Center, symbolizing conscious agency, integration, and the ability to choose a response.

Logical Mind

The Logical Mind represents:

Reason
Evidence
Analysis
Planning
Structure
Probability
Pattern recognition
Problem solving
Strategic thinking
Consequence analysis
Resource evaluation
Practical constraints

Emotional Mind

The Emotional Mind represents:

Feelings
Empathy
Relationships
Emotional needs
Intuition
Attachment
Compassion
Personal meaning
Social awareness
Desire
Emotional consequences

Higher Mind

The Higher Mind represents:

Conscious awareness
Reflection
Perspective
Purpose
Values
Wisdom
Creativity
Possibility
Long-term thinking
Ethical consideration
Integration
Future-oriented reasoning

Primitive Mind

The Primitive Mind represents:

Survival
Threat detection
Fear
Anger
Defensive behavior
Impulse
Urgency
Fight
Flight
Freeze
Fawn
Short-term protection

The Primitive Mind must not be treated as inherently negative. The system should recognize legitimate protective signals while examining whether the response remains proportionate to the current circumstances.

Core Modules

Cross State Analysis Module

The Cross State Analysis Module maps a thought, situation, decision, reaction, or behavior across the four symbolic domains.

Features:

Four-quadrant state mapping
Quadrant activity estimation
Dominant quadrant identification
Underrepresented quadrant identification
Multi-quadrant activity recognition
Cognitive conflict detection
Missing-perspective detection
Cross-state visualization
Before-and-after state comparison
User-adjustable quadrant interpretation

All quadrant assessments must be presented as symbolic model estimates rather than measurements of brain activity.

Primitive Response Module

The Primitive Response Module identifies survival-oriented responses that may influence cognition and behavior.

Features:

Fear detection
Threat perception analysis
Fight response detection
Flight response detection
Freeze response detection
Fawn response detection
Defensive-response detection
Impulsive-response detection
Urgency detection
Scarcity-response detection
Catastrophic-response detection
Perceived-threat analysis
Immediate-threat analysis
Primitive dominance detection
Short-term protection analysis
Long-term consequence comparison

The module must distinguish between recognizing a primitive response and declaring that the response is irrational.

Instinct Interpretation Module

The Instinct Interpretation Module examines instinctive signals before action is taken.

Features:

Instinct identification
Fear versus intuition exploration
Protective-signal identification
Context analysis
Proportionality analysis
Historical pattern comparison
Instinct-to-awareness translation
Instinct questioning
Legitimate danger recognition
Outdated-response pattern recognition

The module should treat instinct as information requiring examination rather than as an instruction that must automatically be followed.

Logical Mind Module

The Logical Mind Module evaluates the analytical dimension of a situation.

Features:

Evidence analysis
Fact and assumption separation
Contradiction detection
Probability assessment
Risk analysis
Cost-benefit analysis
Consequence mapping
Alternative generation
Decision-tree analysis
Resource analysis
Constraint analysis
Short-term and long-term comparison
Missing-information detection
Logical fallacy detection
Uncertainty identification

Emotional Mind Module

The Emotional Mind Module evaluates emotional and interpersonal dimensions.

Features:

Emotional-state identification
Emotion labeling
Emotional intensity estimation
Trigger identification
Emotional-need identification
Relationship analysis
Empathy analysis
Interpersonal consequence analysis
Emotional conflict detection
Emotional suppression detection
Emotional reasoning identification
Emotional-information preservation

The module must not automatically treat emotional reasoning as invalid. Emotional information can provide meaningful information about needs, relationships, boundaries, and values.

Higher Mind Module

The Higher Mind Module encourages reflection beyond immediate reaction.

Features:

Perspective expansion
Long-term thinking
Values analysis
Purpose exploration
Future-self perspective
Ethical reflection
Possibility generation
Creative alternatives
Systems-level thinking
Second-order consequence analysis
Third-order consequence analysis
Meaning exploration
Integrated perspective generation
Conscious-choice facilitation

Higher Mind analysis must remain grounded in evidence, emotional reality, and legitimate safety considerations.

Cross Balance Module

The Cross Balance Module evaluates the relationship among the four domains.

Features:

Balance assessment
Relative quadrant influence estimation
Dominance detection
Underrepresented-domain detection
Quadrant conflict mapping
Balance prompts
Perspective restoration
Integrated assessment
Balance-state visualization
Historical balance comparison

The module must not assume that equal numerical weighting is always appropriate. Balance means that relevant perspectives are adequately considered, not that every situation requires identical quadrant influence.

Reaction to Response Module

The Reaction to Response Module creates a structured pathway between an initial reaction and a conscious response.

Core pathway:

Trigger → Reaction → Awareness → Examination → Integration → Choice → Outcome → Learning

Features:

Trigger identification
Initial reaction capture
Primitive response mapping
Emotional response mapping
Logical response mapping
Higher-awareness mapping
Awareness interruption
Reaction and response distinction
Response generation
Outcome comparison
Decision reflection
Post-decision learning

Awareness Question Module

The Awareness Question Module generates questions designed to activate underrepresented perspectives.

Features:

Primitive-mind questions
Logical-mind questions
Emotional-mind questions
Higher-mind questions
Balance questions
Perspective questions
Values questions
Outcome questions
Future-self questions
Reaction-versus-response questions

Example prompts:

What are you afraid will happen?
What is your instinct trying to protect?
What evidence supports the perceived threat?
What are you feeling?
What information are you missing?
What would your long-term self want you to consider?
What outcome do you actually want?
Is this a reaction or a conscious response?
What would each quadrant say about this situation?
What would a balanced response look like?

Cognitive Bias Module

The Cognitive Bias Module identifies reasoning patterns that may distort decision-making.

Features:

Confirmation-bias detection
Anchoring detection
Availability-bias detection
Catastrophizing detection
Black-and-white thinking detection
Emotional-reasoning detection
Fear-based reasoning detection
Overconfidence detection
Loss-aversion analysis
Recency-bias detection
Self-protective reasoning detection
Group-pressure detection

The module should identify potential bias without presenting the classification as definitive.

Information Integrity Module

The Information Integrity Module separates different types of information used in reasoning.

Features:

Fact identification
Assumption identification
Belief identification
Interpretation identification
Emotional inference identification
Unknown-information identification
Confidence assessment
Contradictory-information detection
Source evaluation
Uncertainty preservation
Evidence classification

Outcome Illumination Module

The Outcome Illumination Module evaluates potential choices across the four domains.

Features:

Immediate-outcome analysis
Long-term-outcome analysis
Best-case scenario
Worst-case scenario
Most-likely scenario
Opportunity analysis
Risk analysis
Reversibility analysis
Regret analysis
Unintended-consequence analysis
Second-order effects
Values alignment
Integrated outcome comparison

The module should identify the highest reasonably achievable outcome rather than simply selecting the safest, easiest, or most emotionally comfortable option.

Conscious Choice Module

The Conscious Choice Module supports human decision-making without replacing it.

Features:

Decision pause prompts
Perspective expansion
Values clarification
Desired-outcome identification
Alternative generation
Consequence comparison
Tradeoff analysis
Human confirmation
Decision reflection
Agency preservation

The AI must not represent its recommendation as an authoritative determination of what the user must do.

Conflict Analysis Module

The Conflict Analysis Module maps internal and external conflicts across the four domains.

Features:

Logic-emotion conflict analysis
Logic-instinct conflict analysis
Emotion-instinct conflict analysis
Primitive-higher conflict analysis
Internal contradiction mapping
Competing-value analysis
Relationship conflict analysis
Decision conflict analysis
Perspective reconciliation
Integrated solution generation

Scenario Simulation Module

The Scenario Simulation Module evaluates possible responses and outcomes.

Features:

Alternative decision simulation
Immediate-response simulation
Delayed-response simulation
Integrated-response simulation
Counterfactual analysis
Future-state modeling
Consequence comparison
“What if nothing changes?” analysis
“What if I act immediately?” analysis
“What if I wait?” analysis
“What changes if the perceived threat disappears?” analysis

Cognitive Pattern Module

The Cognitive Pattern Module identifies recurring patterns across interactions and decisions.

Features:

Recurring fear detection
Repeated avoidance detection
Repeated fight-response detection
Repeated flight-response detection
Repeated freeze-response detection
Repeated fawn-response detection
Emotional suppression patterns
Over-intellectualization patterns
Impulsive decision patterns
Chronic threat-perception patterns
Repeated quadrant conflicts
Repeated primitive dominance
Recurring higher-awareness patterns

Personal Cognitive Map Module

The Personal Cognitive Map Module provides a longitudinal representation of a user’s cognitive patterns when the user chooses to maintain such a record.

Features:

Personal quadrant profile
Trigger mapping
Reaction history
Decision history
Cognitive-state history
Balance history
Successful-response patterns
Cognitive development timeline
Historical comparison
User-controlled data retention

Cross Visualization Module

The Cross Visualization Module provides visual representations of the symbolic model.

Features:

Four-quadrant cross
Balanced cross
Primitive-dominant cross
Higher-awareness-dominant cross
Logical-dominant cross
Emotional-dominant cross
Multi-quadrant dominance
Center-of-balance visualization
Quadrant weighting visualization
State-transition visualization
Reaction-to-response visualization
Outcome pathway visualization
Historical comparison

Research and Evidence Module

The Research and Evidence Module separates the symbolic PsycheCross model from established scientific evidence.

Features:

Cognitive science research integration
Neuroscience research integration
Psychology research integration
Stress-response research
Decision-science research
Behavioral research
Consciousness research
Cognitive-bias research
Evidence-quality assessment
Source provenance
Research-versus-symbolism distinction
Conflicting-evidence tracking

Symbolic Interpretation Module

The Symbolic Interpretation Module provides contextual analysis of cross symbolism.

Features:

Cross symbolism research
Cultural interpretations
Philosophical interpretations
Historical interpretations
Psychological symbolism
Geometric symbolism
Cross-orientation analysis
Symbolic provenance
Cultural-context preservation

Symbolic interpretations must not be presented as scientific evidence for neurological claims.

AI Transparency Module

The AI Transparency Module makes the system’s interpretation understandable and correctable.

Features:

Quadrant classification explanation
Reasoning-factor disclosure
Confidence indicators
Alternative interpretations
Uncertainty disclosure
Evidence identification
User correction
Quadrant reassignment
Human override
Decision-path visualization

Human Agency Module

The Human Agency Module ensures that PsycheCross remains a decision-support framework rather than an autonomous authority over personal choices.

Features:

Human-controlled decisions
User correction
User override
Recommendation transparency
Uncertainty disclosure
No deterministic personality labeling
No forced quadrant classification
No mandatory recommendation acceptance
Explicit distinction between analysis and decision

Privacy Module

The Privacy Module protects personal cognitive information.

Features:

Local-first operation
Self-hosted deployment
User-controlled records
Data minimization
Configurable retention
Data deletion
Data export
Encryption support
Offline operation where supported
Vendor-independent architecture

Integration Module

The Integration Module combines the outputs of the core modules into a unified PsycheCross assessment.

Features:

Four-quadrant synthesis
Conflict reconciliation
Missing-perspective identification
Integrated outcome generation
Tradeoff explanation
Uncertainty preservation
Human decision confirmation
Post-decision learning

Optional Plugin Modules

PsycheCross should support optional modules that extend the core specification without making them mandatory for compliant implementations.

Voice Analysis Plugin

Provides optional analysis of vocal characteristics that may provide contextual information about emotional or cognitive states.

Journaling Plugin

Provides structured cognitive journaling and historical Cross state analysis.

Wearable Integration Plugin

Allows compatible devices to provide optional physiological or contextual information.

Physiological signals must not be treated as definitive evidence of a particular emotional or cognitive state.

Biofeedback Plugin

Provides optional feedback loops for awareness and self-regulation exercises.

Meditation Plugin

Provides guided reflection and awareness exercises based on Cross states.

Personal Knowledge Graph Plugin

Connects recurring thoughts, decisions, triggers, values, relationships, and outcomes into a user-controlled knowledge graph.

Relationship Mapping Plugin

Provides optional analysis of interpersonal dynamics through the four-quadrant model.

Decision Journal Plugin

Maintains structured records of decisions, reasoning, predicted outcomes, and actual outcomes.

Group Intelligence Plugin

Extends the Cross model to teams and groups.

Features:

Group quadrant analysis
Collective decision mapping
Group conflict detection
Perspective diversity analysis
Team balance visualization
Collective decision reflection

Educational Plugin

Provides educational exercises for learning the four-quadrant model.

Features:

Interactive lessons
Scenario exercises
Reflection exercises
Cross-state examples
Cognitive-awareness activities
Decision-making exercises

Creative Cognition Plugin

Uses the Cross model to explore creativity, divergent thinking, emotional inspiration, logical structure, instinct, and higher-order synthesis.

Research Experimentation Plugin

Provides tools for researchers to evaluate implementations of the PsycheCross framework without presenting the framework itself as established neuroscience.

Data Model

A compliant implementation should support structured representations of:

Cross state
Quadrant
Trigger
Reaction
Emotion
Instinct
Evidence
Assumption
Value
Perspective
Decision
Scenario
Outcome
Confidence
Uncertainty
Reflection
User feedback

Each cognitive assessment should preserve the distinction between:

User-provided information
AI-generated interpretation
External evidence
Symbolic interpretation
Hypothesis
Recommendation
Final human decision

Balance Model

PsycheCross should represent cognitive balance as an integration problem rather than a competition for dominance.

A primitive response should be acknowledged when it identifies a legitimate threat.

An emotional response should be acknowledged when it communicates meaningful feelings, needs, values, or relationships.

A logical response should be acknowledged when evidence, structure, probability, or consequences matter.

A higher-awareness response should be acknowledged when perspective, purpose, values, long-term consequences, or possibility matter.

The system should then examine whether these perspectives can be integrated into a conscious response.

Highest Possible Outcome

PsycheCross defines the highest possible outcome as the strongest reasonably achievable outcome after considering the relevant perspectives of all four domains.

The system should consider:

Safety
Evidence
Emotional reality
Relationships
Values
Purpose
Long-term consequences
Immediate consequences
Opportunity
Risk
Reversibility
Unintended consequences
Available resources
Uncertainty

The highest possible outcome is not necessarily the easiest outcome, safest-feeling outcome, most logical outcome, most emotional outcome, or most spiritually appealing outcome.

Safety and Ethical Requirements

PsycheCross implementations must:

Clearly identify the four quadrants as a symbolic cognitive framework.
Avoid claiming that the quadrants are literal brain regions.
Avoid diagnosing neurological or psychological conditions through quadrant analysis.
Avoid treating quadrant scores as measurements of brain activity.
Avoid treating primitive responses as inherently negative.
Avoid treating higher awareness as automatically correct.
Recognize legitimate physical danger.
Preserve user autonomy.
Clearly communicate uncertainty.
Avoid deterministic personality classifications.
Allow users to correct AI interpretations.
Keep human beings responsible for consequential decisions.

Implementation Requirements

A PsycheCross implementation should:

Support the four core quadrants.
Support cross-state analysis.
Provide a mechanism for balance assessment.
Distinguish instinct from conscious choice.
Distinguish analysis from recommendation.
Preserve human agency.
Identify uncertainty.
Maintain separation between symbolic interpretation and scientific claims.
Support modular extension.
Permit optional plugins without requiring them for core functionality.
Document any additional assumptions introduced by an implementation.

Open Source Design Principles

PsycheCross is designed around:

Open source implementation
Modular architecture
Local-first capability
Vendor independence
Interoperability
Human-in-the-loop governance
Transparent reasoning
User-controlled data
Extensible plugins
Reproducible analysis
Clear separation between evidence and interpretation

Guiding Principle

When Instinct Speaks, Awareness Listens.

PsycheCross does not seek to silence the primitive mind.

It seeks to create enough awareness for the primitive mind to be heard without automatically being placed in control.

The ultimate objective is represented by the +:

Logic + Emotion + Instinct + Higher Awareness

The center of the cross represents the point at which these perspectives meet and conscious choice becomes possible.

Specification Branding License (SBL)

Standard

Fully AGPL-3.0+ compliant system
Copyleft enforced for network deployments
Required attribution:
- Roxanne Ardary
- https://www.roxanneardary.com/

Optional

Specification Branding License (SBL)
- Attribution-free commercial deployment
- Pricing based on scale, usage, and deployment scope
- https://roxanneardary.com/psychecross/

License & Notice Requirements

PsycheCross is released under the GNU Affero General Public License v3.0 or later (AGPL-3.0+).

By contributing to any Open Arsenal project, you agree that your contributions will also be released under this license.

Please note the following:

All contributions must comply with the AGPL-3.0+ terms.
Under Section 7 of the license, all redistributions, forks, and derivative works must preserve attribution to: Roxanne Ardary and roxanneardary.com.
PsycheCross specifications are free to use with attribution. A Specification Branding License can be negotiated upon request.
The project’s notice.md file tracks attribution requirements and contributor acknowledgments. Any update that adds new contributors or modifies attribution should also update notice.md.
When submitting a pull request, ensure that any new files maintain the attribution headers where applicable.
Network-deployed versions of this software must also remain fully AGPL-3.0+ compliant, including exposure of source code modifications when applicable under the license.

For full legal details, please refer to the AGPL-3.0+ license and the project’s notice.md file.

Notice – PsycheCross

Attribution Requirement: Under Section 7 of the AGPL 3.0+ license, all redistributions, forks, and derivative works, including network-deployed versions of this project, must provide attribution to Roxanne Ardary and roxanneardary.com.

Contributors

This file tracks contributors and their specific contributions to the project.

Roxanne Ardary, roxanneardary.com – August 29, 2026
Created the repository for PsycheCross. Developed the four-quadrant cognitive framework for exploring logic, emotion, higher awareness, and primitive survival responses through AI-assisted reflection and decision support.
[Add other contributors here] – [Date]
[Describe contribution in one sentence]

License – PsycheCross

This repository is licensed under the GNU Affero General Public License v3.0 or later (AGPL-3.0+).

Key Points

You are free to use, modify, and distribute the code.
All redistributions, forks, and derivative works or network-deployed versions must also be licensed under AGPL-3.0+ and provide attribution to Roxanne Ardary and roxanneardary.com as required under Section 7 of the license.
The software is provided “as is,” without warranty of any kind.

For the full license text, see GNU AGPL-3.0 License.