AGENTS.md@docs/configuration · diff
git:20260907.ae194c2 to git:20261021.5446ac1
15 added, 62 removed. Audit A to A.
- # configuration
+ # Configuration documentation — agent guide
## Overview
- This directory contains documentation and resources for the configuration subsystem.
-
- **Status**: ✅ Documentation Module
- **Version**: 1.0
-
- ---
-
- ## Purpose
-
- Configuration patterns and best practices for GNN models
-
- This subsystem is part of the broader GNN (Generalized Notation Notation) documentation ecosystem, integrated with the 25-step processing pipeline.
+ Document actual configuration consumers, CLI precedence and explicit backend options. Do not invent profiles or universal YAML switches.
## Contents
- **Files**: 2 | **Subdirectories**: 1
-
- ## Quick Navigation
-
- - **README.md**: [Directory overview](README.md)
- - **GNN Documentation**: [gnn/AGENTS.md](../gnn/AGENTS.md)
- - **Main Documentation**: [docs/README.md](../README.md)
- - **Pipeline Reference**: [src/gnn/AGENTS.md](../../src/gnn/AGENTS.md)
-
- ## Documentation Structure
-
- This module is organized as follows:
-
- - **Overview**: High-level description and purpose
- - **Contents**: Files and subdirectories
- - **Integration**: Connection to the broader pipeline
- - **Usage**: How to work with this subsystem
-
- ## Integration with Pipeline
-
- This documentation is integrated with the 25-step GNN processing pipeline:
-
- 1. **Core Processing** (Steps 0-9): GNN parsing, validation, export
- 2. **Simulation** (Steps 10-16): Model execution and analysis
- 3. **Integration** (Steps 17-24): System coordination and output
-
- 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
- - **Functionality**: Describes actual capabilities
- - **Completeness**: Comprehensive coverage
- - **Consistency**: Uniform structure and style
-
- ## Related Resources
+ - [Configuration contract](README.md)
+ - [Supported examples](examples.md)
+ - [Checked-in configuration](../../input/config.yaml)
+ - [Argument parser](../../src/gnn/utils/arguments/arg_parsing.py)
- **Main GNN Documentation**: [gnn/](../gnn/)
- - [GNN Overview](../gnn/gnn_overview.md)
- - [GNN Quickstart](../gnn/tutorials/quickstart_tutorial.md)
- - [GNN Examples](../gnn/tutorials/gnn_examples_doc.md)
+ ## Verification
- **Pipeline Architecture**: [src/](../../src/)
- - [Pipeline AGENTS](../../src/gnn/AGENTS.md)
- - [Pipeline README](../../src/gnn/README.md)
+ Follow the [documentation specification](SPEC.md) and
+ [repository documentation rules](../../.agent_rules/documentation.md). Run the
+ affected examples and consumer tests, preserve historical receipts, and report
+ actual source/runtime scope. Never infer completion from a status badge or a
+ partial test count.
- ---
+ ## Related resources
- **Status**: ✅ Production Ready
- **Compliance**: Professional documentation standards
- **Maintenance**: Regular updates with new features
+ - [Documentation hub](../README.md)
+ - [Canonical roadmap](../../TO-DO.md)