Skip to content

docs: document local override precedence - #1112

Merged
potiuk merged 1 commit into
apache:mainfrom
Whxuan0701:docs/issue-1003-local-override-order
Aug 25, 2026
Merged

docs: document local override precedence#1112
potiuk merged 1 commit into
apache:mainfrom
Whxuan0701:docs/issue-1003-local-override-order

Conversation

@Whxuan0701

Copy link
Copy Markdown

Summary

  • Document .apache-magpie-local/ as the personal, gitignored per-skill override layer and place it ahead of .apache-magpie-overrides/.
  • Explain how the per-skill override chain relates to the existing <project-config>/project.md configuration-key chain.
  • Record the additive-only guardrail for safety, confidentiality, privacy, and external-content-as-data requirements.

Validation

  • uv run prek run --all-files
  • git diff --check

All hooks passed, including doctoc, markdownlint, typos, lychee, placeholder checks, type checks, and tests.

Known limitations

  • Documentation-only change; runtime behavior is unchanged.
  • prek is not installed as a global executable in the local environment, so the repository check was invoked through uv run.

Closes #1003

@potiuk
potiuk merged commit 32b97c4 into apache:main Aug 25, 2026
9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add the .apache-magpie-local override layer to the AGENTS.md resolution order

2 participants