subhash-0000 commented on issue #62500: URL: https://github.com/apache/airflow/issues/62500#issuecomment-4072812501
Hi @jason810496, I've completed a PoC for issue #62500 and would appreciate your feedback. PoC Branch: https://github.com/subhash-0000/airflow/tree/feat/executable-doc-agent-skills What I implemented: Executable document pattern: agent-skill directives embedded directly in contributing docs (same source humans read). Extraction pipeline: extract_agent_skills.py parses RST and generates skills.json. Drift detection: prek hook fails CI if skills.json diverges from source docs. Runtime context API: 3-tier detection (AIRFLOW_BREEZE_CONTAINER -> /.dockerenv -> /opt/airflow). 3 initial workflows: static-checks, run-tests, system-verify. 28 passing pytest tests: parsing, extraction, drift, context detection, integration. DX report: documents failure modes without this system. Key design choice: Following your guidance that contributor docs should be the source of truth, I used contributing-docs/*.rst as the single source rather than a separate skill spec file. This keeps human docs and agent-executable structure aligned, with CI enforcing synchronization. I started with a small, robust core (3 workflows, 28 tests) so it can be extended incrementally. Thanks for reviewing! -- 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]
