Skip to content

refactor(skills): migrate config/user.md to .apache-steward-overrides/user.md#45

Merged
potiuk merged 1 commit into
apache:mainfrom
andreahlert:fix/config-user-md-migration
May 4, 2026
Merged

refactor(skills): migrate config/user.md to .apache-steward-overrides/user.md#45
potiuk merged 1 commit into
apache:mainfrom
andreahlert:fix/config-user-md-migration

Conversation

@andreahlert

Copy link
Copy Markdown
Collaborator

Summary

Migrates the 4 security skills from the legacy config/user.md path (pre-snapshot architecture) to .apache-steward-overrides/user.md, aligning with the snapshot+overrides adoption model introduced in #38.

The config/ directory was never created in the framework repo under the new architecture, and the .gitignore explicitly states that per-user files live in the adopter repo. This PR closes the gap between the architectural intention and the skill implementation.

Changes

  • 4 security skills now read .apache-steward-overrides/user.md instead of config/user.md
  • setup-steward/adopt.md gains Step 9b, scaffolding a user.md template during first-time adoption
  • Docs and tool adapters updated to reference the new path
  • Fallback-interactive behaviour is preserved

Test plan

  • prek run --all-files passes (check-placeholders + markdownlint)
  • No hardcoded project references introduced

…d-overrides/user.md

The framework adopted a snapshot+overrides architecture in PR apache#38.
Under that design, per-user configuration (PMC status, local clone
paths, optional tool backends) lives in the adopter repo, not in the
framework. The security skills, however, still referenced the legacy
config/user.md path from the pre-snapshot architecture.

Changes:
- Update 4 security skills (sync, import, fix, cve-allocate) to read
  from .apache-steward-overrides/user.md instead of config/user.md.
- Add Step 9b to setup-steward/adopt.md to scaffold a user.md
  template during first-time adoption.
- Update docs and tool adapters that referenced config/user.md:
  onboarding, prerequisites, gmail, ponymail, fix-workflow template.

The fallback-interactive behaviour is preserved: when the file is
missing, skills ask the user and offer to save the answer back.

Fixes the structural gap where the framework docs described a config/
layer that was never created in the snapshot-based architecture.

Signed-off-by: André Ahlert <andre@aex.partners>

@potiuk potiuk left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice!

@potiuk potiuk merged commit e501d82 into apache:main May 4, 2026
7 checks passed
@andreahlert andreahlert deleted the fix/config-user-md-migration branch May 4, 2026 14:57
@andreahlert andreahlert added the mode:platform Substrate / infra — not a mode (sandbox, CI, validators) label May 7, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

mode:platform Substrate / infra — not a mode (sandbox, CI, validators)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants