potiuk opened a new pull request, #111:
URL: https://github.com/apache/airflow-steward/pull/111
## Summary
- `setup-steward/adopt.md` **Step 11** (project doc updates) previously said
only "add a brief paragraph to README.md or CONTRIBUTING.md noting three
things", leaving every adopter to reinvent the wording. Replace it with:
- copy-pasteable `## Agent-assisted contribution (apache-steward)`
template for `README.md`, with substitution guidance for the picked skill
families and the flat-vs-double-symlinked path convention;
- explicit note about PyPI sync markers (avoid leaking the adoption blurb
into the published PyPI description on projects that round-trip README.md to
PyPI);
- separate `AGENTS.md` template that agent harnesses see first, with a
cross-reference back to the README section;
- "do not create `AGENTS.md` if it does not already exist" guardrail
(empty file is noise);
- doctoc/TOC-hook note so adopters expect a second commit touching
auto-updated TOC;
- `CONTRIBUTING.md` as a documented fallback for projects where
`README.md` is off-limits.
- `setup-steward/verify.md` **check 9** updated in parallel: grep for both
`apache-steward` and `/setup-steward` tokens in `README.md` (and the
cross-reference link in `AGENTS.md` if it exists) rather than the previous
"mentions the framework somewhere" hand-wave. Stays at ⚠ severity.
Motivated by the apache/airflow adoption PR
([apache/airflow#66677](https://github.com/apache/airflow/pull/66677)) which
added both files by hand; the templates here capture what landed there so the
next adopter gets it from the skill rather than reverse-engineering the airflow
diff.
## Test plan
- [x] `prek run --files .claude/skills/setup-steward/adopt.md
.claude/skills/setup-steward/verify.md` — all relevant hooks (markdownlint,
typos, EOF/whitespace, skill-validate) pass.
- [x] Verified the README template I'm baking in matches the section that
actually landed in apache/airflow#66677.
---
##### Was generative AI tooling used to co-author this PR?
- [X] Yes — Claude Opus 4.7 (1M context)
Generated-by: Claude Opus 4.7 (1M context) following the framework's
agent-authored-fixes pattern.
--
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]
