Skip to content

config: publish Magpie's project configuration and AI contribution policy - #1412

Merged
potiuk merged 1 commit into
apache:mainfrom
potiuk:config/promote-magpie-project-config
Sep 26, 2026
Merged

potiuk merged 1 commit into
apache:mainfrom
potiuk:config/promote-magpie-project-config

Conversation

@potiuk

@potiuk potiuk commented Sep 26, 2026

Copy link
Copy Markdown
Member

Summary

  • Publish the Magpie checkout's own project configuration under .apache-magpie-overrides/, so pr-management, release-management, issue, repo-health and contributor-growth skills work on a fresh clone without each contributor running /magpie-setup config.
    44 of 54 in-repo skills now have their full requires_config set; the 10 that do not are security-family skills, which need a private tracker Magpie does not run.
  • Add docs/ai-contribution-policy.md, restating the ASF Generative Tooling Guidance for this project, and link it from CONTRIBUTING.md → Authoring with an agent.
    contributor-to-committer and contributor-nomination judge AI-assisted contributions against it; pr-management-code-review links to it.

What the configuration records:

  • Identity and lists — apache/magpie on main; dev@, users@, commits@, private@magpie.apache.org.
  • Security — no project security tracker, CNA queue, board or mail backend: reports follow the ASF default process via security@apache.org. Those fields say "not used" with that reason rather than carrying placeholders.
  • PMC roster — the 21 members from projects.apache.org.
  • Releases — main is the only release train (0.1.0, RM @potiuk); git archive source zip, sha512 only, RAT via .rat-excludes; no backport labels.
  • Issues — GitHub Issues; the untriaged pool is open issues with no labels, since the repo has no needs triage label.
  • Reviewer roster — @potiuk, @justinmclean and @shahar1, derived from the last six months of commits per area.
  • Commit trailer — Generated-by:, as commit-attribution.toml already sets.

Type of change

  • Skill change (.claude/skills/<name>/) — eval fixtures updated below
  • Tool / bridge contract (tools/<system>/*.md)
  • Python package (tools/*/ with pyproject.toml)
  • Groovy reference impl
  • Cross-cutting (RFC, AGENTS.md, sandbox, privacy-LLM)
  • Documentation (docs/, README.md, CONTRIBUTING.md)
  • Project template (projects/_template/)
  • CI / dev loop (prek, workflows, validators)
  • Other: project configuration for the framework checkout (.apache-magpie-overrides/)

Test plan

  • prek run --all-files passes
  • lychee --offline --include-fragments over .apache-magpie-overrides/*.md, the policy doc and CONTRIBUTING.md: 0 errors.
    Run explicitly because the lychee hook skips hidden directories, so the override files are otherwise unchecked.
    The templates' relative links assumed a deeper directory; they were re-pointed at targets that exist from .apache-magpie-overrides/.
  • Each in-repo skill's requires_config: resolved against the committed files: 44/54 complete, the 10 remaining all security-family.
  • Other:

RFC-AI-0004 compliance

  • HITL — any new mutation is gated on explicit user confirmation
  • Sandbox — no new unrestricted host access; network reach declared in the adapter
  • Vendor neutrality — placeholders (<PROJECT>, <tracker>, <upstream>, <security-list>) used in all skill / tool prose (the check-placeholders prek hook is the mechanical gate)
  • Conversational + correctable — agentic-override path documented if behaviour is adopter-tunable
  • Write-access discipline — no autonomous outbound messages; drafts only, sent on confirmation
  • Privacy LLM — private content does not reach a non-approved LLM; redactor invoked where needed

None apply: no skill or tool prose changes. Concrete Magpie values live only in the adopter-config layer, which is where they belong.

Linked issues

None.

Notes for reviewers (optional)

  • The AI contribution policy is new project policy, not only configuration — it deserves a read on its own, and may warrant a [DISCUSS] on dev@ before merge.
  • The reviewer roster is derived from commit counts only; add or remove people as you see fit.
  • The remaining TODO strings in these files are the templates' own instructions ("replace every TODO"), not unfilled values.

Generative AI disclosure: this change was authored with Claude Code (Claude Opus 5); every value was reviewed by the author, and the commit carries a Generated-by: trailer.

🤖 Generated with Claude Code

…tion policy

Commit the framework checkout's own project configuration under
.apache-magpie-overrides/ so every contributor gets working
pr-management, release-management, issue, repo-health and
contributor-growth skills on clone, without running
/magpie-setup config.

- project.md: identity, repositories, mailing lists
  (dev@, users@, commits@, private@magpie.apache.org); security
  tracker, CNA queue, project board and mail backends marked as not
  used, since reports follow the ASF default process via
  security@apache.org.
- pmc-roster.md: the 21 PMC members from projects.apache.org.
- release-trains.md / release-build.md: main is the only release
  train; git-archive source zip with sha512, RAT via .rat-excludes.
- issue-tracker-config.md / reassess-pool-defaults.md: GitHub Issues
  on apache/magpie, with the triage, reassess and stale queries.
- fix-workflow.md: no backport labels; Generated-by trailer.
- reviewer-roster.md: derived from the last six months of history.
- Contributor-growth configs: template thresholds, six-month window.

Add docs/ai-contribution-policy.md, which restates the ASF
Generative Tooling Guidance for this project, and link it from
CONTRIBUTING.md. The contributor-growth skills judge AI-assisted
contributions against it, and code review links to it.

Generated-by: Claude Opus 5
@potiuk
potiuk merged commit b9014ba into apache:main Sep 26, 2026
9 checks passed
@potiuk potiuk mentioned this pull request Sep 28, 2026
4 tasks done
@potiuk potiuk added family:docs Docs, MISSION.md, READMEs family:setup setup-* skills labels Oct 5, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

family:docs Docs, MISSION.md, READMEs family:setup setup-* skills

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant