potiuk opened a new pull request, #56:
URL: https://github.com/apache/airflow-steward/pull/56
## Summary
The framework's adoption mechanism pivoted from git-submodule to
gitignored-snapshot (managed by `setup-steward`) on 2026-05-03; ~10 files still
carried stale "submodule" framing from the older design. This PR aligns the
prose with what the code already does.
**Files updated:**
| File | Change |
|---|---|
| `AGENTS.md` | Repository purpose paragraph; layout sketch (drop nested
`apache-steward/` line); `<framework>` placeholder description; replace the
"Always run `git submodule update`" paragraph with the snapshot/lock-file
drift-check model. |
| `README.md` | Drop the "git-submodule reference" line from the rename
note. |
| `CONTRIBUTING.md` | "consume this framework as a submodule" → "as a
gitignored snapshot managed by `setup-steward`". |
| `docs/setup/secure-agent-setup.md` | 3 hits: consume-as-submodule framing;
flatten `.apache-steward/apache-steward/` paths to `.apache-steward/`. |
| `tools/vulnogram/generate-cve-json/README.md`,
`tools/gmail/oauth-draft/README.md` | Same path flattening. |
| `.claude/skills/setup-isolated-setup-update/SKILL.md` | Drop the stale
parent-tracker submodule-pointer reference in the framework-update follow-up
bullet. |
| `.claude/skills/security-issue-sync/SKILL.md` | Reword the "framework
lives in a submodule" justification for absolute URLs to reference the snapshot
path. |
**Kept verbatim** — the three explicit "we do NOT use submodules" design
assertions: `README.md` ("No git submodules. No marketplace."),
`setup-steward/SKILL.md` ("snapshot + agentic overrides … not submodule, not
marketplace, not vendored copy"), and a new sentence in `AGENTS.md` making the
same point in the snapshot/lock-file paragraph.
## Test plan
- [x] `prek run --all-files` clean.
- [x] `grep -rnE "submodule" --include="*.md" --include="*.py"
--include="*.toml" --include="*.yaml" --include="*.yml"` across the framework
returns only the 3 deliberate assertion sites listed above.
- [x] No `.gitmodules` is tracked (`git ls-files | grep .gitmodules` empty).
- [ ] Visual review of the AGENTS.md repository-purpose / layout-sketch /
framework-placeholder / submodule-update paragraphs to confirm the snapshot
story reads cleanly.
--
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]
