HARDIK-WEB-OSS commented on issue #62500:
URL: https://github.com/apache/airflow/issues/62500#issuecomment-4029670557

   The 'Local-first' flow Jarek mentioned is exactly what I faced during my 
recent work on the translation agent skills—where local SQLite/Pydantic drift 
forced a Breeze fallback for verification. It’s a real-world edge case that 
proves why environment-awareness is key.
   
   Regarding Jason’s question on maintainability: I propose using a `prek` hook 
as the primary sync mechanism. Instead of a separate YAML (which adds 
maintenance debt), the hook can parse structured sections or markers in 
`CONTRIBUTING.rst` using a lightweight RST parser like` docutils`.
   
   This ensures that documentation and agent skills are updated in the same 
atomic git commit. If the generator detects drift between the docs and the 
skill JSON, `prek` fails the pre-commit check. This solves the long-term 
maintainability issue by making synchronization an enforced part of the 
standard contributor workflow.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to