foundation-godot-version-doc-alignment

name: foundation-godot-version-doc-alignment description: Tier 1 foundation for strict Godot version/documentation alignment using local pinned docs as source of truth and explicit churn checkpoints. tier: core godot_version: 4.6+ doc_anchors: - godot-docs/about/release_policy.rst - godot-docs/about/docs_changelog.rst - godot-docs/tutorials/migrating/index.rst - godot-docs/engine_details/file_formats/tscn.rst tags: - versioning - docs - governance depends_on: []

Foundation Godot Version and Docs Alignment

Use When

• Starting any Godot task where API/version mismatch risk exists.
• Upgrading engine versions or validating skill/tooling guidance.

Outcomes

• Active engine/doc version assumptions are explicit before implementation.
• Conflicting guidance is resolved against local pinned docs.
• High-churn areas are reviewed with documented decisions.

Required Rules

• Treat the project-pinned local godot-docs/ snapshot as implementation source of truth.
• Use official online docs/source as secondary validation when needed.
• Reject guidance that conflicts with pinned local snapshot unless an explicit migration decision is made.
• Recheck high-churn areas first (plugins, migration, performance, file formats, navigation/networking).

Workflow

1. Record current engine target and pinned docs snapshot assumptions.
2. Validate each planned API/workflow claim against local docs anchors.
3. Flag conflicts between existing skill guidance and local docs.
4. For unresolved conflicts, create migration decision note before coding.
5. Track resolved decisions and affected skill files.

Validation

• Every Godot/API claim in modified skills has at least one local .rst anchor.
• Conflict log exists for any guidance that differed from pinned docs.
• Version assumptions are visible in frontmatter for affected tiers.

Failure Modes

• Unpinned online guidance overrides local project constraints.
• Version assumptions remain implicit and drift between contributors.
• Migration decisions happen ad hoc during implementation.

Local Doc Anchors

• godot-docs/about/release_policy.rst
• godot-docs/about/docs_changelog.rst
• godot-docs/tutorials/migrating/index.rst
• godot-docs/engine_details/file_formats/tscn.rst