Yaml Gotchas

---
name: orcaflex-yaml-gotchas
description: Production-proven OrcaFlex YAML traps and solutions covering dormant
  properties, boolean mismatches, section ordering, Pydantic integration, and section
  name aliases.
type: reference
version: 1.0.0
updated: 2026-02-10
category: engineering
triggers:
- OrcaFlex YAML error
- Change not allowed OrcaFlex
- OrcaFlex property error
- dormant property
- OrcaFlex section order
- Pydantic OrcaFlex
- OrcaFlex YAML gotcha
- OrcaFlex SaveData
capabilities: []
requires: []
tags: []
scripts_exempt: true
---

# Orcaflex Yaml Gotchas

## Related Skills

- [orcaflex-monolithic-to-modular](../orcaflex-monolithic-to-modular/SKILL.md) - Extraction pipeline
- [orcaflex-model-generator](../orcaflex-model-generator/SKILL.md) - Builder architecture
- [orcaflex-environment-config](../orcaflex-environment-config/SKILL.md) - Environment setup

## References

- Source: `src/digitalmodel/solvers/orcaflex/modular_generator/`
- Memory: `memory/semantic-validation.md`
- OrcaFlex YAML documentation

---

## Version History

- **1.0.0** (2026-02-10): Initial release consolidating all production-proven OrcaFlex YAML gotchas from modular generator development (10+ fixes across 5 models).

## Sub-Skills

- [Symptom (+2)](symptom/SKILL.md)
- [Symptom (+2)](symptom/SKILL.md)
- [Symptom (+2)](symptom/SKILL.md)
- [Symptom (+2)](symptom/SKILL.md)
- [Symptom (+2)](symptom/SKILL.md)
- [Symptom (+3)](symptom/SKILL.md)
- [Symptom (+2)](symptom/SKILL.md)
- [Symptom (+2)](symptom/SKILL.md)
- [Symptom (+2)](symptom/SKILL.md)
- [Symptom (+2)](symptom/SKILL.md)
- [Symptom (+2)](symptom/SKILL.md)
- [Symptom (+2)](symptom/SKILL.md)
- [Symptom (+2)](symptom/SKILL.md)
- [Symptom (+2)](symptom/SKILL.md)
- [Symptom (+2)](symptom/SKILL.md)
- [Symptom (+2)](symptom/SKILL.md)
- [Safe YAML Builder Pattern (+1)](safe-yaml-builder-pattern/SKILL.md)
- [Execution: Validating Generated YAML](execution-validating-generated-yaml/SKILL.md)