Home / SocraticAI / SocraticAI Specification
SocraticAI
Question Everything. Grow Together.
Overview
SocraticAI is an open-source, AI-powered human development and situational analysis platform designed to challenge conventional thinking, question established behaviors, and help individuals, organizations, and communities evolve toward their highest potential.
The platform allows users to describe personal, professional, interpersonal, organizational, or societal situations and engage with an AI that goes beyond conventional advice by actively investigating circumstances, motivations, assumptions, and underlying dynamics. Rather than immediately generating conclusions, SocraticAI initiates an evolving line of intelligent questioning designed to uncover root causes, expose inconsistencies, explore alternative perspectives, and encourage deeper understanding.
At its core, SocraticAI examines situations through the framework of the Seven Deadly Sins, identifies corresponding virtues, evaluates the well-being of everyone involved, and develops actionable recommendations for positive change. Its purpose is not to judge or condemn individuals, but to challenge behaviors, systems, and conditions that prevent healthy relationships, productive environments, and human advancement.
SocraticAI operates as a collaborative thinking partner that continuously challenges both the user’s assumptions and the status quo. Through critical thinking, ethical reasoning, perspective analysis, and iterative questioning, it helps people discover better solutions and create environments that support the highest and best versions of themselves.
Core Modules
Situation Discovery Module
- Accept freeform descriptions of personal, interpersonal, workplace, organizational, and societal situations.
- Support structured scenario submissions with optional categories and contextual information.
- Identify the people, relationships, responsibilities, interests, and environmental conditions involved.
- Distinguish reported facts, personal interpretations, assumptions, and unknown information.
- Identify the user’s desired outcomes and the interests of other affected parties.
- Allow multiple perspectives to be represented within a single scenario.
- Support anonymous and hypothetical scenario submissions.
- Establish an initial understanding without prematurely assigning blame or generating conclusions.
Socratic Questioning Engine
- Generate intelligent, context-sensitive questions based on the user’s initial description.
- Pursue an evolving line of questioning rather than immediately providing advice or conclusions.
- Ask one meaningful question at a time to encourage thoughtful responses.
- Adapt subsequent questions according to previous answers.
- Challenge assumptions, inconsistencies, generalizations, and unsupported conclusions.
- Explore motivations, intentions, expectations, fears, incentives, and perceived obligations.
- Identify missing information and request clarification.
- Explore alternative interpretations and perspectives.
- Recognize when answers reveal additional issues requiring investigation.
- Distinguish questions intended to clarify facts from questions intended to challenge beliefs.
- Revisit previous answers when new information changes the analysis.
- Identify when sufficient information has been gathered to develop actionable recommendations.
- Allow users to challenge the AI’s questions, reasoning, and conclusions.
- Explain why particular questions are being asked.
- Allow users to pause, resume, and revisit an evolving discussion.
Seven Deadly Sins Analysis Module
Evaluate each situation through seven behavioral and ethical dimensions.
- Pride: Identify excessive ego, arrogance, entitlement, superiority, resistance to accountability, and unwillingness to consider other perspectives.
- Greed: Identify exploitation, excessive accumulation, unfair distribution of resources, selfish incentives, and prioritization of personal gain over collective well-being.
- Lust: Examine unhealthy desire, objectification, manipulation, boundary violations, and situations in which desire overrides respect and responsible decision-making.
- Envy: Identify destructive comparison, resentment, jealousy, competitive hostility, and attempts to undermine others.
- Gluttony: Examine excess, overconsumption, waste, disproportionate demands, and unsustainable behavior.
- Wrath: Identify hostility, intimidation, retaliation, uncontrolled anger, aggression, and destructive conflict.
- Sloth: Identify avoidance, apathy, negligence, complacency, unwillingness to contribute, and failure to address preventable problems.
Additional capabilities:
- Evaluate each dimension independently.
- Identify interactions between multiple behavioral patterns.
- Distinguish harmful behavior from reasonable human needs and emotions.
- Consider situational pressures and systemic conditions.
- Avoid treating potential behavioral patterns as proof of someone’s character.
- Explain the evidence and reasoning behind each assessment.
- Identify areas where insufficient information prevents a meaningful conclusion.
- Reassess all seven dimensions as new information emerges.
Virtue and Human Development Module
Translate identified problems into constructive alternatives.
- Pride to humility, accountability, and open-mindedness.
- Greed to generosity, fairness, and responsible stewardship.
- Lust to respect, self-control, and healthy relationships.
- Envy to gratitude, appreciation, and collaborative success.
- Gluttony to moderation, balance, and sustainability.
- Wrath to patience, emotional regulation, and compassion.
- Sloth to initiative, responsibility, and purposeful action.
Additional capabilities:
- Identify opportunities for individual development.
- Encourage constructive self-reflection rather than shame.
- Promote emotional intelligence and personal accountability.
- Encourage empathy and consideration of others.
- Identify behaviors that support mutual respect and trust.
- Translate abstract virtues into observable actions.
- Recognize positive behaviors already present in a situation.
- Encourage balanced personal development without demanding perfection.
Status Quo Challenge Module
- Question established practices, traditions, assumptions, and organizational norms.
- Evaluate whether existing arrangements serve their intended purpose.
- Identify outdated systems, unnecessary restrictions, and ineffective practices.
- Challenge authority and institutional decisions through evidence-based inquiry.
- Identify power imbalances and unequal treatment.
- Examine whether established policies benefit everyone affected or disproportionately serve particular interests.
- Identify conflicts between stated values and actual behavior.
- Explore alternative approaches that may produce healthier outcomes.
- Distinguish constructive disruption from unnecessary conflict.
- Encourage innovation and progress without dismissing valuable existing practices.
Perspective and Empathy Module
- Examine situations from the perspectives of all identifiable stakeholders.
- Identify competing needs, interests, responsibilities, and expectations.
- Explore how different people may interpret the same circumstances.
- Identify misunderstandings and communication breakdowns.
- Encourage recognition of experiences outside the user’s immediate perspective.
- Evaluate whether proposed solutions distribute benefits and responsibilities fairly.
- Identify overlooked or underrepresented stakeholders.
- Encourage solutions that respect individual autonomy and collective well-being.
- Identify opportunities for mutual understanding and cooperation.
Root Cause Analysis Module
- Distinguish symptoms from underlying problems.
- Identify recurring behavioral and environmental patterns.
- Examine incentives, institutional structures, expectations, and resource constraints.
- Identify contributing factors and relationships between different problems.
- Evaluate whether an issue is individual, interpersonal, organizational, or systemic.
- Explore historical context when relevant.
- Identify problems that may persist even if individual participants change.
- Develop evidence-based explanations of underlying circumstances.
- Generate follow-up questions to investigate unresolved causes.
Critical Thinking and Assumption Analysis Module
- Identify logical inconsistencies and unsupported conclusions.
- Detect cognitive biases and common reasoning errors.
- Separate facts from opinions and interpretations.
- Challenge confirmation bias and selective reasoning.
- Examine competing explanations.
- Encourage evidence gathering and verification.
- Identify uncertainty and distinguish it from established information.
- Present counterarguments and alternative hypotheses.
- Encourage intellectual humility and willingness to revise conclusions.
- Challenge the user’s reasoning with the same scrutiny applied to other participants.
Ethical Reasoning Module
- Evaluate decisions through fairness, honesty, accountability, compassion, autonomy, and responsibility.
- Identify potential conflicts between individual rights and collective interests.
- Examine foreseeable consequences for affected parties.
- Consider short-term and long-term implications.
- Identify coercion, manipulation, exploitation, discrimination, and conflicts of interest.
- Evaluate whether proposed solutions respect human dignity.
- Present competing ethical considerations when there is no universally accepted answer.
- Avoid imposing a single religious, political, or philosophical worldview.
- Make ethical reasoning transparent and open to challenge.
- Distinguish ethical principles from personal preferences and cultural expectations.
Environment Health Assessment Module
- Evaluate whether a situation supports psychological safety, mutual respect, trust, and cooperation.
- Identify conditions that contribute to stress, resentment, hostility, and disengagement.
- Examine communication quality and conflict-resolution practices.
- Evaluate fairness in responsibilities, recognition, resources, and decision-making.
- Identify unhealthy relationship and organizational dynamics.
- Assess whether people have meaningful opportunities to express concerns.
- Identify conditions that encourage personal development and shared success.
- Generate recommendations for creating healthier environments.
- Evaluate whether improvements benefit everyone affected rather than simply shifting the burden to another participant.
Conflict Resolution Module
- Identify the underlying sources of disagreement.
- Distinguish substantive disagreements from interpersonal hostility.
- Explore shared interests and common objectives.
- Identify opportunities for negotiation and compromise.
- Encourage constructive communication and active listening.
- Develop practical conflict-resolution strategies.
- Identify appropriate boundaries and accountability measures.
- Support mutually beneficial outcomes without requiring people to accept unfair treatment.
- Recognize situations in which disengagement, external assistance, or formal intervention may be necessary.
Solution Evolution Module
- Generate potential solutions based on the complete questioning process.
- Evaluate proposed solutions against the needs of affected stakeholders.
- Identify the advantages, disadvantages, risks, and limitations of each approach.
- Challenge proposed solutions for unintended consequences.
- Recommend changes to behaviors, policies, expectations, and environmental conditions.
- Prioritize practical improvements over abstract ideals.
- Identify immediate interventions and longer-term improvements.
- Allow users to modify proposed solutions and request further analysis.
- Continue questioning when proposed solutions fail to address underlying problems.
- Develop an evolved solution focused on sustainable, mutually beneficial outcomes.
- Explain why the recommended changes are likely to improve the situation.
Human Growth and Development Module
- Help users identify opportunities for personal growth.
- Encourage self-awareness, emotional intelligence, and critical thinking.
- Identify limiting beliefs and counterproductive habits.
- Support the development of healthy communication skills.
- Encourage resilience, accountability, and adaptability.
- Establish personal development objectives.
- Track progress against user-defined goals.
- Encourage continuous learning and reflection.
- Recognize that personal growth is individual and non-linear.
- Promote human potential without treating AI recommendations as authoritative judgments.
Growth Mapping and Visualization Module
- Generate visual representations of identified behavioral patterns.
- Display the seven dimensions of the analysis.
- Show corresponding virtues and opportunities for improvement.
- Map relationships between root causes, behaviors, and consequences.
- Visualize stakeholder interests and areas of disagreement.
- Track changes in assessments as new information becomes available.
- Display unresolved questions and areas of uncertainty.
- Present proposed interventions and expected outcomes.
- Generate before-and-after comparisons.
- Avoid presenting numerical moral scores as objective measurements of human worth.
Continuous Improvement Module
- Allow users to revisit previously analyzed situations.
- Compare initial assessments with subsequent developments.
- Evaluate whether recommended interventions produced the intended results.
- Identify new problems that emerge following changes.
- Reopen the questioning process when circumstances change.
- Track completed actions and outstanding objectives.
- Identify recurring patterns across user-authorized sessions.
- Encourage ongoing reflection rather than treating an assessment as a permanent conclusion.
- Allow users to revise their objectives as circumstances and understanding evolve.
Reports and Documentation Module
- Generate comprehensive situation assessments.
- Produce summaries of the questioning process.
- Document identified behavioral patterns and supporting observations.
- Present root causes and contributing circumstances.
- Provide seven-dimension analysis and corresponding virtues.
- Document alternative perspectives and ethical considerations.
- Generate actionable improvement plans.
- Export reports in common document formats.
- Allow users to control which information is included in exported reports.
- Support private reports and appropriately anonymized collaborative reports.
User Experience and Accessibility Module
- Provide an intuitive conversational interface.
- Support desktop, mobile, and tablet experiences.
- Allow users to submit text-based scenarios.
- Provide accessible navigation and readable visualizations.
- Support adjustable interaction preferences.
- Allow users to control the depth and pace of questioning.
- Provide clear explanations of AI-generated assessments.
- Support multilingual interaction.
- Provide options for anonymous participation.
- Make the platform accessible to users with different abilities and levels of technical experience.
Privacy, Security, and User Control Module
- Protect user-submitted situations and personal information.
- Provide transparent data collection and retention policies.
- Allow users to control conversation history and saved assessments.
- Support deletion and export of user data.
- Apply access controls to private scenarios and collaborative workspaces.
- Protect sensitive information through appropriate encryption.
- Minimize unnecessary collection of personal information.
- Separate private reflections from information explicitly shared with other participants.
- Prevent unauthorized access to confidential assessments.
- Provide clear disclosures regarding AI processing and third-party services.
Collaborative Growth Module
- Allow multiple participants to examine a shared situation.
- Support separate stakeholder perspectives.
- Enable collaborative questioning and solution development.
- Identify areas of agreement and disagreement.
- Encourage respectful dialogue between participants.
- Support organizational and team assessments.
- Allow participants to contribute without exposing private individual reflections.
- Generate shared improvement objectives.
- Track mutually agreed actions and progress.
- Ensure that participation and disclosure remain voluntary.
AI Transparency and Accountability Module
- Explain how the AI reaches its conclusions.
- Distinguish observations, interpretations, hypotheses, and recommendations.
- Identify uncertainty and limitations.
- Provide users with the ability to challenge AI-generated reasoning.
- Allow corrections when the AI misunderstands a situation.
- Avoid presenting speculative psychological assessments as diagnoses.
- Identify when professional, legal, medical, or other qualified assistance may be appropriate.
- Maintain human authority over decisions and actions.
- Evaluate outputs for harmful assumptions, unfair treatment, and unintended bias.
- Support independent evaluation of model behavior and analysis quality.
Optional Plugin Modules
Advanced Philosophical Frameworks Plugin
- Incorporate additional philosophical perspectives.
- Support comparisons between virtue ethics, consequentialism, deontology, and other ethical traditions.
- Allow users to select or compare philosophical approaches.
- Present competing interpretations without declaring one universal doctrine.
- Explore philosophical questions concerning human purpose, responsibility, justice, and personal development.
Positive Psychology Plugin
- Incorporate evidence-informed positive psychology concepts.
- Explore resilience, motivation, strengths, purpose, and well-being.
- Support positive behavioral development.
- Encourage balanced self-reflection.
- Generate exercises for developing emotional intelligence and personal strengths.
Organizational Culture Plugin
- Evaluate workplace and organizational environments.
- Examine leadership practices, employee relationships, organizational incentives, and communication.
- Identify cultural inconsistencies.
- Generate organizational improvement recommendations.
- Evaluate whether organizational practices support employee well-being and shared success.
Relationship Development Plugin
- Support examination of interpersonal relationships.
- Explore communication, boundaries, expectations, trust, and mutual respect.
- Identify recurring relationship patterns.
- Encourage healthy and consensual relationship dynamics.
- Support constructive approaches to disagreements and relationship development.
Community Development Plugin
- Evaluate community-level challenges.
- Examine shared resources, public participation, institutional accountability, and collective interests.
- Identify opportunities for cooperation and social improvement.
- Generate community development strategies.
- Support collaborative problem-solving and community well-being.
Advanced Research Plugin
- Connect analysis to independently verifiable research.
- Incorporate academic literature, behavioral science, and philosophical resources.
- Provide citations and source references.
- Distinguish established research from emerging hypotheses and opinions.
- Allow users to investigate the evidence behind recommendations.
Alternative AI Provider Plugin
- Support interchangeable AI model providers.
- Allow deployment using hosted or locally operated models.
- Provide configurable model selection.
- Support privacy-oriented and self-hosted deployments.
- Preserve the core questioning and analysis framework independently of any single AI provider.
- Allow additional models to be integrated without redesigning core modules.
Guided Development Programs Plugin
- Provide structured personal development exercises.
- Generate reflection activities and learning objectives.
- Support customized growth programs.
- Evaluate progress through user-defined milestones.
- Encourage continuous development through practical activities and guided reflection.
Education and Learning Plugin
- Introduce guided critical-thinking exercises.
- Support ethical reasoning and philosophical exploration.
- Encourage respectful debate and intellectual curiosity.
- Provide scenario-based learning experiences.
- Help users develop independent reasoning and decision-making skills.
Leadership Development Plugin
- Examine leadership behaviors, decision-making, and accountability.
- Identify opportunities for more equitable and effective leadership.
- Evaluate the impact of leadership practices on organizational health.
- Encourage transparency, empathy, and responsible authority.
- Generate leadership development recommendations.
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/socraticai/
License & Notice Requirements
SocraticAI 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. - SocraticAI 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 updatenotice.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 – SocraticAI
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 – November 18, 2026
Created the repository for SocraticAI. Developed the original concept, project vision, modular architecture, and feature specifications for an AI-powered platform that uses iterative Socratic questioning, seven deadly sins analysis, ethical reasoning, and human-centered guidance to challenge the status quo and promote personal growth and healthier environments. - Add other contributors here – [Date]
[Describe contribution in one sentence]
License – SocraticAI
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.



