Add why-and-when doc: value proposition and decision guide (#62)

* Add why-and-when doc explaining value proposition and decision guide

Adds docs/why-and-when.md covering why skills over MCP matters (same
channel as tools, discovery, dynamic updates, control model, multi-server
composition, enterprise distribution) and when MCP distribution adds
value vs simpler alternatives. Linked from README and problem-statement.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Add why-and-when summary to README before problem statement

Gives newcomers the value proposition immediately: skills are context,
MCP is a context protocol, and remote MCP servers can serve tools and
know-how together. Links to the full doc for depth.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Add portable sub-agent point to why-and-when doc

Skills over MCP replaces the pattern of independently wrapping each
MCP server in a custom sub-agent with hand-written instructions —
the server author ships orchestration guidance once, everyone benefits.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Acknowledge enterprise trust trade-offs in both directions

Address PR feedback: git-based and MCP-based skill distribution each
raise different governance concerns. Link to open question on security
and trust boundaries.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Ola Hungerford 2026-03-17 06:25:30 -07:00 • committed by GitHub
commit b2a2119984
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -27,3 +27,5 @@ See [use-cases.md](use-cases.md) for detailed use cases and community input. In
## Open Questions
See [open-questions.md](open-questions.md) for the full list of unresolved questions with community input.
For the value proposition and a guide on when MCP distribution applies, see [why-and-when.md](why-and-when.md).