Home / Body-Mind Awareness / Body-Mind Awareness Specification
Body-Mind Awareness
Overview
The Body-Mind Awareness Specification defines a modular framework for connecting physical observations, emotional experiences, lifestyle patterns, and personal reflections within a unified wellness-awareness system.
The specification is designed to help individuals record observations about their bodies, minds, routines, energy, sleep, stress, and overall well-being while identifying relationships and patterns over time. It is intended to support personal awareness and reflection rather than provide medical diagnosis or replace professional medical care.
The specification is designed to be privacy-conscious, extensible, vendor-neutral, and suitable for local-first implementations. Implementations may use the complete specification or adopt individual modules according to their needs.
Goals
The Body-Mind Awareness Specification is designed to:
- Connect physical and emotional observations.
- Provide structured personal wellness journaling.
- Track changes in sleep, energy, stress, and body sensations.
- Identify recurring lifestyle patterns.
- Map relationships between physical and emotional observations.
- Maintain longitudinal personal wellness timelines.
- Support user-controlled reflection and interpretation.
- Provide extensible interfaces for optional integrations.
- Encourage portable and interoperable wellness data.
- Preserve user ownership and control of personal observations.
Core Capabilities
Observation Tracking
The specification provides a common framework for recording observations about physical states, emotional states, activities, environments, and personal experiences.
Observations may include:
- Timestamp
- Observation category
- Description
- Intensity
- Duration
- Context
- Tags
- User-defined metadata
- Related observations
The observation model is extensible so implementations can introduce additional observation categories without modifying the underlying specification.
Sleep Tracking
The Sleep Awareness capability provides structured recording of sleep-related observations.
Supported information may include:
- Sleep duration
- Sleep and wake times
- Sleep quality
- Sleep interruptions
- Restfulness
- Sleep-related notes
- Sleep patterns over time
Sleep observations can be connected with other observations to help users explore relationships between sleep and their daily experiences.
Energy Tracking
The Energy Awareness capability records perceived physical and mental energy.
Features include:
- Physical energy levels
- Mental energy levels
- Energy fluctuations
- Time-of-day observations
- Activity-related energy changes
- Energy trends
- Energy timeline integration
Body Sensation Journaling
The Body Sensation capability provides a structured method for recording physical sensations.
Features include:
- Body-area identification
- Sensation descriptions
- Intensity
- Duration
- Frequency
- Context
- Potential triggers recorded by the user
- Historical observation
The specification does not require an implementation to interpret a sensation as a medical condition.
Wellness Reflection
The Wellness Reflection capability provides tools for documenting personal experiences and reflections.
Features include:
- Free-form journaling
- Guided reflections
- Daily reflections
- Weekly reflections
- Personal observations
- Positive and challenging experiences
- Links between reflections and recorded observations
Stress Awareness
The Stress Awareness capability provides a framework for recording perceived stress and contextual factors.
Features include:
- Stress levels
- Stressor observations
- Stress responses
- Contextual information
- Recovery observations
- Stress trends
- Stress-related timeline events
Lifestyle Pattern Recognition
The Lifestyle Pattern capability helps organize recurring behaviors and contextual observations.
Potential observation categories include:
- Daily routines
- Work and rest
- Physical activity
- Food and hydration
- Social activity
- Environmental conditions
- Sleep routines
- Personal habits
Implementations may use these observations to identify recurring patterns while clearly distinguishing observed patterns from assumptions about causation.
Mind-Body Correlation Mapping
The Mind-Body Correlation capability provides a framework for connecting observations across physical, emotional, behavioral, and contextual categories.
Features include:
- Observation relationships
- Temporal relationships
- Pattern mapping
- User-confirmed relationships
- Correlation histories
- Relationship visualization
- Confidence indicators
The specification requires implementations to distinguish correlation from causation. An observed relationship must not automatically be presented as proof that one observation caused another.
Personal Wellness Timelines
The Personal Wellness Timeline capability provides a chronological view of recorded observations.
Timeline events may include:
- Sleep
- Energy
- Body sensations
- Emotional observations
- Stress
- Lifestyle activities
- Reflections
- Identified patterns
- User annotations
Users should be able to filter and review timeline information according to the implementation’s supported capabilities.
Optional Plugin Modules
The specification supports optional plugins that extend functionality without making those capabilities mandatory.
Wearable Integration Plugin
Provides optional connections to wearable devices and sensors.
Possible data sources include:
- Sleep information
- Activity
- Movement
- Heart-rate observations
- Temperature observations
- Other user-authorized sensor information
Mood Tracking Plugin
Provides more detailed emotional-state tracking.
Features may include:
- Mood scales
- Emotion categories
- Mood journaling
- Emotional trends
- Mood-event relationships
- Custom emotional taxonomies
Habit Tracking Plugin
Provides structured tracking of recurring behaviors.
Features may include:
- Habit creation
- Habit completion
- Habit history
- Streak tracking
- Routine analysis
- Habit-to-wellness relationships
Environmental Awareness Plugin
Adds environmental context to wellness observations.
Potential information includes:
- Weather
- Indoor or outdoor context
- Environmental conditions
- Noise observations
- User-defined environmental factors
Nutrition & Hydration Plugin
Provides optional tracking of food and hydration observations.
Features may include:
- Meal observations
- Hydration
- Meal timing
- Food-related reflections
- Dietary patterns
- Food-to-energy observations
Activity & Movement Plugin
Provides structured physical activity tracking.
Features may include:
- Activity logging
- Exercise observations
- Activity duration
- Activity intensity
- Recovery observations
- Activity-to-energy relationships
AI Pattern Analysis Plugin
Provides optional AI-assisted analysis of accumulated observations.
Features may include:
- Pattern discovery
- Natural-language summaries
- Observation clustering
- Timeline summaries
- Potential relationship identification
- Natural-language data exploration
- Explainable pattern reports
AI-generated observations should remain clearly identified as analytical outputs and should not be presented as medical diagnoses or definitive causal conclusions.
Personal Insights Plugin
Provides higher-level summaries of accumulated observations.
Features may include:
- Weekly wellness summaries
- Monthly wellness summaries
- Recurring-pattern reports
- Trend identification
- Reflection summaries
- Personalized dashboards
Privacy & Data Control Plugin
Provides enhanced controls for sensitive personal wellness information.
Features may include:
- Data export
- Data deletion
- Selective sharing
- Privacy controls
- Encryption support
- Access records
- Consent management
- Data portability
Visualization Plugin
Provides graphical representations of wellness information.
Features may include:
- Energy trends
- Sleep trends
- Stress trends
- Body-sensation visualization
- Mind-body relationship maps
- Wellness timelines
- Pattern overlays
- Custom dashboards
Integration API Plugin
Provides optional interfaces for external applications and services.
Potential capabilities include:
- API access
- Data import
- Data export
- Webhooks
- Event-based integrations
- Authentication
- Data synchronization
- External application integration
Privacy & Data Ownership
Body-mind observations can contain highly personal information. Implementations should prioritize user control, privacy, and data portability.
Recommended principles include:
- Personal data should remain under user control.
- Local-first storage should be supported where practical.
- Data should be exportable in documented formats.
- Users should be able to delete their information.
- External integrations should require explicit authorization.
- Implementations should minimize unnecessary data collection.
- Sensitive information should not be shared without user authorization.
- AI processing should be optional where practical.
- Implementations should clearly identify externally processed data.
Correlation and Interpretation
The specification is designed to help users observe relationships within their own data.
A system may identify that two observations repeatedly occur near one another. However, the system should distinguish between:
- Recorded observation
- Statistical association
- User-reported relationship
- Potential correlation
- Causal claim
The specification does not establish medical causation from personal observations.
Implementations that provide analytical features should communicate uncertainty appropriately and avoid presenting automated pattern recognition as professional medical advice.
Interoperability
Implementations should use portable, documented data structures whenever practical.
The specification encourages:
- Structured observation records
- Stable identifiers
- Timestamped events
- Extensible metadata
- Documented import/export formats
- Vendor-neutral data models
- Plugin interoperability
- User-controlled data migration
No proprietary application, wearable manufacturer, cloud provider, AI provider, or database system is required by this specification.
Extensibility
The Body-Mind Awareness Specification is designed to support future capabilities.
New modules and plugins may introduce:
- New observation categories
- New integrations
- New visualization methods
- New analytical capabilities
- New journaling methods
- New interoperability formats
- New privacy controls
Extensions should preserve the core principles of user ownership, modularity, privacy, interoperability, and clear separation between observation and interpretation.
Human-Centered Design
Implementations should treat the user as the primary authority over their personal observations.
The specification encourages systems that:
- Allow users to correct observations.
- Allow users to add context.
- Preserve the distinction between user observations and automated analysis.
- Avoid unnecessary behavioral assumptions.
- Make patterns understandable.
- Provide transparent explanations for automated insights.
- Avoid presenting wellness observations as definitive medical conclusions.
Use Cases
The Body-Mind Awareness Specification can support applications such as:
- Personal wellness journals
- Body-awareness applications
- Sleep and energy journals
- Stress-awareness systems
- Reflective journaling platforms
- Personal pattern-analysis tools
- Wellness dashboards
- Local-first personal data systems
- Wearable-integrated wellness applications
- AI-assisted personal reflection systems
Non-Goals
The specification does not inherently provide:
- Medical diagnosis
- Medical treatment recommendations
- Emergency medical monitoring
- Clinical decision-making
- Guaranteed causal explanations
- Replacement for licensed healthcare professionals
Implementations may integrate with regulated healthcare systems where appropriate, but such functionality is outside the basic scope of this specification.
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/body-mind-awareness/
License & Notice Requirements
Body-Mind Awareness Specification 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.
- Body-Mind Awareness Specification is 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 – HerOneiros Specification
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 – July 8, 2026
Created the repository for HerOneiros Specification. Designed the modular open-source specification framework for AI-powered, women-centered inner awareness systems, including journaling, emotional intelligence, dream intelligence, cyclical awareness, communication assistance, privacy, and future AI expansion modules. - [Add other contributors here] – [Date]
[Describe contribution in one sentence]
License – HerOneiros Specification
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 specification.
- All redistributions, forks, derivative works, and 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 specification is provided “as is,” without warranty of any kind.
For the full license text, see GNU AGPL-3.0 License.