[PR] docs: document the extension model + allow external/own-repo organizations [magpie]

["potiuk (via GitHub)" <gi...@apache.org>]

potiuk opened a new pull request, #638:
URL: https://github.com/apache/magpie/pull/638

   ## What
   
   Makes **external / own-repo** a first-class home for organizations (it
   already was for adapters), and adds one guide explaining every way Magpie
   can be extended.
   
   ### New: `docs/extending.md`
   The map of extensibility:
   - **What** you can extend — skill, tool/adapter, capability contract,
     organization, project config, user config.
   - **Where** each can live — the **three homes**: in-tree (upstream) /
     your adopter repo (`.apache-magpie-overrides/`) / an external repo —
     with a trade-off table (travels-with, licence, best-when).
   - **Who** typically owns each — project, organization, individual.
   - Reiterates discovery-not-installation (PRINCIPLES §13).
   
   ### Convention change
   - **`AGENTS.md`** — the organization resolution order now includes an
     adopter-local / external home:
     `project.md → organizations/<org>/ (in-tree) →
     .apache-magpie-overrides/organizations/<org>/ (adopter-local/external)
     → framework default`. So `organization:` need **not** name an in-tree
     org — you can keep your org adapter in your repo or vendor it from the
     org's own repo.
   
   ### Consistency + wiring
   - `organizations/README.md` — "three homes" note for an organization +
     resolution order.
   - `docs/adapters/authoring.md` — "two homes" → "three homes" (adds the
     adopter-repo override home).
   - `docs/index.md` gains an "Extend Magpie" row; `vendor-neutrality.md`
     and the adapter registry link the new guide.
   
   ## Verification
   doctoc, markdownlint, lychee (all links/anchors resolve), placeholder
   check — green. No skill/tool/validator changes (the org resolution is a
   runtime contract agents follow; adopter-local orgs live in adopter repos,
   not validated by the framework validator).
   
   🤖 Generated with [Claude Code](https://claude.com/claude-code)


-- 
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: commits-unsubscribe@magpie.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org

Re: [PR] docs: document the extension model + allow external/own-repo organizations [magpie]

["potiuk (via GitHub)" <gi...@apache.org>]

potiuk merged PR #638:
URL: https://github.com/apache/magpie/pull/638


-- 
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: commits-unsubscribe@magpie.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org