git:20260906.82c8031 to git:20260907.ae194c2

# Cognitive Phenomena Documentation Agents

## Overview

This document provides comprehensive agent scaffolding for the Cognitive Phenomena documentation subsystem. The documentation covers modeling of various cognitive processes (attention, memory, emotion, consciousness, etc.) using Active Inference principles and GNN notation.

**Status**: ✅ Production Ready

**Version**: 1.0

**Tree policy**: [SPEC.md](SPEC.md) (canonical; leaf `SPEC.md` files link here)

---

## Purpose

Comprehensive mapping of cognitive processes to Active Inference principles and GNN notation, enabling:

- **Cognitive Architecture Modeling**: Attention, memory, emotion, consciousness, executive control

- **Neuroscientific Validation**: Models grounded in cognitive neuroscience research

- **Clinical Applications**: Applications to clinical research and therapeutic interventions

- **Educational Technology**: Cognitive modeling for educational applications

- **AI Development**: Cognitive architectures for artificial intelligence systems

This subsystem is part of the broader GNN (Generalized Notation Notation) documentation ecosystem, integrated with the 25-step processing pipeline.

## Contents

**Files**: 1 | **Subdirectories**: 11

### Subdirectories

- **attention/**: Attention and perception models

- **consciousness/**: Consciousness and awareness models

- **effort/**: Cognitive effort and resource allocation

- **emotion_affect/**: Emotion and affective processing

- **executive_control/**: Executive control and decision making

- **language_processing/**: Language processing and comprehension

- **learning_adaptation/**: Learning and adaptation mechanisms

- **memory/**: Memory systems and processes

- **meta-awareness/**: Meta-awareness and metacognition

- **meta-aware-2/**: Advanced meta-awareness models

- **perception/**: Perception and sensory processing

## Quick Navigation

### This Directory

- **[README.md](README.md)**: Directory overview and comprehensive guide

- **[AGENTS.md](AGENTS.md)**: Technical documentation (this file)

### Main Documentation

- **[CROSS_REFERENCE_INDEX.md](../CROSS_REFERENCE_INDEX.md)**: Complete cross-reference index

- **[learning_paths.md](../learning_paths.md)**: Learning pathways

### Related Directories

- **[GNN Advanced Patterns](../gnn/advanced/advanced_modeling_patterns.md)**: Advanced modeling techniques

- **[Templates](../templates/README.md)**: Model templates and scaffolding

- **[Research Tools](../research/README.md)**: Research workflow tools

- **[Multi-agent Systems](../gnn/advanced/gnn_multiagent.md)**: Multi-agent cognitive modeling

### Pipeline Integration

- **[Pipeline Documentation](../gnn/operations/gnn_tools.md)**: Complete pipeline guide

- **[src/gnn/AGENTS.md](../../src/gnn/AGENTS.md)**: Implementation details

## Documentation Structure

This module is organized as follows:

- **Overview**: High-level description and purpose

- **Subdirectories**: Specialized cognitive phenomenon models

- **Integration**: Connection to the broader pipeline

- **Usage**: How to work with cognitive models

## Cognitive Phenomena Coverage

### Basic Cognitive Processes

- **Attention**: Selective attention, change blindness, attentional control

- **Perception**: Bistable perception, perceptual inference, sensory processing

- **Memory**: Working memory, episodic memory, memory consolidation

### Advanced Cognitive Processes

- **Consciousness**: Global workspace models, consciousness and awareness

- **Executive Control**: Task switching, cognitive control, decision making

- **Emotion**: Interoceptive emotion, affective processing, emotional regulation

### Meta-Cognitive Processes

- **Meta-Awareness**: Metacognition, self-awareness, introspective processes

- **Learning**: Hierarchical learning, adaptation, skill acquisition

- **Language**: Language processing, comprehension, production

## Integration with Pipeline

This documentation is integrated with the 25-step GNN processing pipeline:

1. **Core Processing** (Steps 0-9): GNN parsing, validation, export

- Cognitive models specified using GNN notation

- Validation includes cognitive architecture constraints

2. **Simulation** (Steps 10-16): Model execution and analysis

- Cognitive process simulation

- Behavioral prediction and validation

3. **Integration** (Steps 17-24): System coordination and output

- Cognitive model results integrated into comprehensive outputs

- Research applications and clinical validation

See [src/gnn/AGENTS.md](../../src/gnn/AGENTS.md) for complete pipeline documentation.

## Standards and Guidelines

All documentation in this module adheres to professional standards:

- **Clarity**: Concrete, technical writing with neuroscientific foundations

- **Functionality**: Describes actual cognitive modeling capabilities

- **Completeness**: Comprehensive coverage of cognitive phenomena

- **Consistency**: Uniform structure and style with GNN documentation ecosystem

## Related Resources

### Main GNN Documentation

- **[GNN Overview](../gnn/gnn_overview.md)**: Core GNN concepts

- **[GNN Quickstart](../gnn/tutorials/quickstart_tutorial.md)**: Getting started guide

- **[Advanced Patterns](../gnn/advanced/advanced_modeling_patterns.md)**: Advanced modeling techniques

### Research Applications

- **[Research Tools](../research/README.md)**: Research workflow tools

- **[Templates](../templates/README.md)**: Model templates

- **[Multi-agent Systems](../gnn/advanced/gnn_multiagent.md)**: Multi-agent cognitive modeling

### Pipeline Architecture

- **[Pipeline Documentation](../gnn/operations/gnn_tools.md)**: Complete pipeline guide

- **[Pipeline AGENTS](../../src/gnn/AGENTS.md)**: Implementation details

- **[Pipeline README](../../src/gnn/README.md)**: Pipeline overview

---

**Status**: ✅ Production Ready

**Compliance**: Professional documentation standards

**Maintenance**: Regular updates with new cognitive models and research applications