Skip to content

Commit 4765d11

Browse files
cliffhallcliffhall
committed
Add .gitignore, README.md, and other docs/* files with menu-linked template
1 parent ed4987f commit 4765d11

9 files changed

Lines changed: 206 additions & 1 deletion

‎.gitignore‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
.claude/settings.local.json
2+
.idea
3+
.vscode
4+
dist
5+
node_modules
6+
.DS_Store

‎CONTRIBUTING.md‎

Lines changed: 68 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
1+
# Contributing
2+
[Problem Statement](docs/problem-statement.md) |
3+
[Use Cases](docs/use-cases.md) |
4+
[Approaches](docs/approaches.md) |
5+
[Open Questions](docs/open-questions.md) |
6+
[Experimental Findings](docs/experimental-findings.md) |
7+
[Related Work](docs/related-work.md) |
8+
Contributing
9+
## How to Participate
10+
11+
This Interest Group welcomes contributions from anyone interested in organization of MCP primitives. You can participate by:
12+
13+
- Joining discussions in the [#primitive-grouping-ig](https://discord.com/channels/1358869848138059966/1425903819186770064) (info on joining the Discord server [here](https://modelcontextprotocol.io/community/communication#discord))
14+
- Opening or commenting on GitHub Discussions in this repo
15+
- Sharing experimental findings from your own implementations
16+
- Contributing to documentation and pattern evaluation
17+
18+
## Communication Channels
19+
20+
| Channel | Purpose | Response Expectation |
21+
|:-------------------------------------------------------------------------------------------------------| :--- | :--- |
22+
| [Discord #primitive-grouping-ig](https://discord.com/channels/1358869848138059966/1425903819186770064) | Quick questions, coordination, async discussion | Best effort |
23+
| GitHub Discussions | Long-form technical proposals, experimental findings | Weekly triage |
24+
| This repository | Living reference for approaches, findings, and decisions | Updated after meetings |
25+
26+
## Meetings
27+
28+
*To be scheduled* — likely biweekly working sessions once the group establishes momentum.
29+
30+
Meeting norms:
31+
32+
- Agendas published 24 hours in advance
33+
- Notes published within 48 hours
34+
35+
## Decision-Making
36+
37+
As an Interest Group, we operate by **rough consensus** — we're exploring and recommending, not deciding. Outputs include:
38+
39+
- Documented requirements and use cases
40+
- Evaluated approaches with findings
41+
- Recommendations to relevant WGs or as SEP proposals
42+
43+
## Contribution Guidelines
44+
45+
### Documenting Approaches and Findings
46+
47+
When adding experimental findings or new approaches:
48+
49+
- Include enough detail for others to reproduce or evaluate
50+
- Note which clients and servers were tested
51+
- Be explicit about what worked, what didn't, and what remains untested
52+
- Attribute community input with GitHub handles and link to the source where possible
53+
54+
### Community Input
55+
56+
When adding quotes or input from community discussions:
57+
58+
- Attribute to the contributor by name and GitHub handle
59+
- Link to the original source (Discord thread, GitHub comment, etc.) where possible
60+
- Present input as blockquotes to distinguish it from editorial content
61+
62+
### Filing Issues
63+
64+
Use GitHub Issues for:
65+
66+
- Proposing new approaches or use cases
67+
- Reporting gaps in documentation
68+
- Tracking action items from meetings

‎README.md‎

Lines changed: 84 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,84 @@
1-
# experimental-ext-grouping
1+
# Primitive Grouping Interest Group
2+
3+
> ⚠️ **Experimental** — This repository is an incubation space for the Primitive Grouping Interest Group. Contents are exploratory and do not represent official MCP specifications or recommendations.
4+
5+
## Mission
6+
7+
This Interest Group explores how MCP Primitives (Tools, Resources, Prompts, Tasks) might be organized, beyond the flat lists that are maintained by the protocol, and how such organization might benefit both MCP servers and clients.
8+
9+
## Scope
10+
11+
### In Scope
12+
13+
- **Requirements gathering:** Documenting use cases and constraints
14+
- **Pattern exploration:** Testing and evaluating various approaches
15+
- **Proof of concepts:** Maintaining a shared repo of reference implementations and experimental findings
16+
17+
### Out of Scope
18+
19+
- **Approving spec changes:** This IG does not have authority to approve protocol changes; recommendations flow through the SEP process
20+
- **Implementation mandates:** We can document patterns but not require specific client or server behavior
21+
22+
## Problem Statement
23+
24+
Flat lists of MCP primitives can be long and cumbersome to work with.
25+
26+
- **Context overload** — When loaded into the context of an LLM, a primitive list can overwhelm the model and lead to confusion and poor selection
27+
- **Costly operation** - Long lists can consume many tokens, leading to higher costs for users.
28+
- **Poor developer experience** — Lack of organizational tools for primitives makes them harder to manage and maintain
29+
30+
See [problem-statement.md](docs/problem-statement.md) for full details.
31+
32+
## Repository Contents
33+
34+
| Document | Description |
35+
| :--- | :--- |
36+
| [Problem Statement](docs/problem-statement.md) | Current limitations and gaps |
37+
| [Use Cases](docs/use-cases.md) | Key use cases driving this work |
38+
| [Approaches](docs/approaches.md) | Approaches being explored (not mutually exclusive) |
39+
| [Open Questions](docs/open-questions.md) | Unresolved questions with community input |
40+
| [Experimental Findings](docs/experimental-findings.md) | Results from implementations and testing |
41+
| [Related Work](docs/related-work.md) | SEPs, implementations, and external resources |
42+
| [Contributing](CONTRIBUTING.md) | How to participate |
43+
44+
45+
## Facilitators
46+
47+
| Role | Name | Organization | GitHub |
48+
| :--- |:------------|:-----------------------------------------------------------|:-----------------------------------------------|
49+
| Facilitator | Tapan Chugh | CS PhD student at University of Washington | [@chughtapan](https://github.com/chughtapan) |
50+
| Maintainer | Cliff Hall | Futurescale / MCP Maintainer | [@cliffhall](https://github.com/cliffhall) |
51+
| Facilitator | Sam Morrow | Senior Software Engineer at GitHub | [@SamMorrowDrums](https://github.com/SamMorrowDrums) |
52+
53+
## Lifecycle
54+
55+
**Current Status: Active Exploration**
56+
57+
### Graduation Criteria (IG → WG)
58+
59+
This IG may propose becoming a Working Group if:
60+
61+
- Clear consensus emerges on an approach requiring sustained spec work
62+
- Cross-cutting coordination requires formal authority delegation
63+
- At least two Core Maintainers sponsor WG formation
64+
65+
### Retirement Criteria
66+
67+
- Problem space resolved (conventions established, absorbed into other WGs)
68+
- Insufficient participation to maintain momentum
69+
- Community consensus that grouping doesn't belong in MCP protocol scope
70+
71+
## Work Tracking
72+
73+
| Item | Status | Champion | Notes |
74+
|:-----------------------------------| :--- |:-----------------|:------------------------------------------------------------------|
75+
| Requirements alignment | In Progress | All facilitators | Review approaches, identify common requirements and gaps |
76+
| Experimental findings repo section | Proposed | TBD | Dedicated repo section for implementations and evaluation results |
77+
| MCP Grouping Convention v0.1 | Proposed | TBD | Documented pattern (not spec) for grouping of primitives |
78+
79+
## Success Criteria
80+
81+
- **Short-term:** Documented consensus on requirements and evaluation of existing approaches
82+
- **Medium-term:** Clear recommendation (convention vs. protocol extension vs. both)
83+
- **Long-term:** Interoperable grouping convention across MCP servers and clients
84+

‎docs/approaches.md‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
# Approaches Being Explored
2+
[Problem Statement](problem-statement.md) |
3+
[Use Cases](use-cases.md) |
4+
Approaches |
5+
[Open Questions](open-questions.md) |
6+
[Experimental Findings](experimental-findings.md) |
7+
[Related Work](related-work.md) |
8+
[Contributing](../CONTRIBUTING.md)

‎docs/experimental-findings.md‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
# Experimental Findings
2+
[Problem Statement](problem-statement.md) |
3+
[Use Cases](use-cases.md) |
4+
[Approaches](approaches.md) |
5+
[Open Questions](open-questions.md) |
6+
Experimental Findings |
7+
[Related Work](related-work.md) |
8+
[Contributing](../CONTRIBUTING.md)

‎docs/open-questions.md‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
# Open Questions
2+
[Problem Statement](problem-statement.md) |
3+
[Use Cases](use-cases.md) |
4+
[Approaches](approaches.md) |
5+
Open Questions |
6+
[Experimental Findings](experimental-findings.md) |
7+
[Related Work](related-work.md) |
8+
[Contributing](../CONTRIBUTING.md)

‎docs/problem-statement.md‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
# Problem Statement
2+
Problem Statement |
3+
[Use Cases](use-cases.md) |
4+
[Approaches](approaches.md) |
5+
[Open Questions](open-questions.md) |
6+
[Experimental Findings](experimental-findings.md) |
7+
[Related Work](related-work.md) |
8+
[Contributing](../CONTRIBUTING.md)

‎docs/related-work.md‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
# Related Work
2+
[Problem Statement](problem-statement.md) |
3+
[Use Cases](use-cases.md) |
4+
[Approaches](approaches.md) |
5+
[Open Questions](open-questions.md) |
6+
[Experimental Findings](experimental-findings.md) |
7+
Related Work |
8+
[Contributing](../CONTRIBUTING.md)

‎docs/use-cases.md‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
# Use Cases
2+
[Problem Statement](problem-statement.md) |
3+
Use Cases |
4+
[Approaches](approaches.md) |
5+
[Open Questions](open-questions.md) |
6+
[Experimental Findings](experimental-findings.md) |
7+
[Related Work](related-work.md) |
8+
[Contributing](../CONTRIBUTING.md)

0 commit comments

Comments
 (0)