.agents/skills/aip-user-stories/references/playbook-template.md
Airflow version: {version} Required packages: {packages, if any beyond core}
{Version requirements, installation steps for provider packages if needed, configuration prerequisites.}
{2-3 paragraphs drawn from the AIP motivation section. What problem does this feature solve? What was the previous state? What changes for the user? Written for a practitioner, not a committee.}
{Repeat this section for each recipe.}
Goal: {One sentence — what the user accomplishes with this recipe.}
Prerequisites: {Anything specific to this recipe beyond the global prerequisites — a provider package, a configuration flag, an external service.}
{Code block — verified, adapted, or placeholder per the three-tier system.}
{If adapted, note below the block: "Adapted from [source file path]"}
{Explanation: WHY this pattern works, not line-by-line narration. What makes this the right approach for this use case.}
{Repeat this section for each user story.}
Goal: {One sentence — the user's objective.}
# PROPOSED API — not yet implemented
{Speculative code based on the AIP's proposed API.}
{Brief explanation of what this code would accomplish and why the AIP proposes this approach.}
Open Design Questions:
{Include only if the user chose to skip unimplemented features during the Propose phase. List each skipped feature with a one-line description. Omit this entire section if all features were covered.}