# Orcaflex Monolithic To Modular Common Issues And Fixes

> Sub-skill of orcaflex-monolithic-to-modular: Common Issues and Fixes.

- Skill: `vamseeachanta/orcaflex-monolithic-to-modular-common-issues-and-fixes` (Agent Skill)
- Install (CLI): `npx skillmds@latest add vamseeachanta/orcaflex-monolithic-to-modular-common-issues-and-fixes`
- Raw SKILL.md: https://api.skillmd.com/api/skills/vamseeachanta/orcaflex-monolithic-to-modular-common-issues-and-fixes/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: vamseeachanta (https://skillmd.com/u/vamseeachanta)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/vamseeachanta/orcaflex-monolithic-to-modular-common-issues-and-fixes

---


# Common Issues and Fixes

## Common Issues and Fixes


| Issue | Root Cause | Fix |
|-------|-----------|-----|
| Missing section in modular | Extractor doesn't map the YAML key | Add to `FIELD_TO_SECTION` or `SINGLETON_SECTIONS` |
| Property value lost | GenericObject subclass lacks typed field | Add field to schema class (Pydantic silent drop) |
| `None` vs missing diff | Builder skips None values | Use `model_fields_set` in `_merge_object()` |
| Boolean mismatch | SaveData() exports `True`/`False`, builder uses `"Yes"`/`"No"` | Use Python booleans in builder defaults |
| "Change not allowed" error | Dormant properties in re-loaded YAML | Use hardcoded safe defaults, not raw pass-through |