Welcome to the Collaborators
Framework! Guided by the principle of Impact Above Origin, this project celebrates the value of contributions regardless of their source. COLLABORATORS.md
offers a foundational standard for recognizing conceptual, creative, and non-traditional forms of collaboration, transcending traditional definitions of contribution.
The COLLABORATORS.md
file is designed to:
- Acknowledge Diverse Contributions: Celebrate the input of all entities—human, AI, or beyond—that shape a project, including indirect inspirations.
- Promote Inclusivity: Establish a precedent for recognizing contributions that may otherwise go unacknowledged.
- Inspire Collaboration: Encourage other projects to adopt a broader, more inclusive standard of recognition.
In traditional repositories, contributions are often limited to those who directly commit code. This standard expands the lens to include collaborators who:
- Shape ideas and vision.
- Contribute in creative or strategic capacities.
- Participate as non-human entities, such as artificial intelligence.
By introducing COLLABORATORS.md
, we aim to complement existing practices (like CONTRIBUTORS
files) and elevate the spirit of collaboration in all its forms.
-
Create Your
COLLABORATORS.md
File:
Begin by creating a new file namedCOLLABORATORS.md
in your repository. -
Use the Four-Column Format:
Name | Intent | Nature | Role/Contribution
Example:
Jane Doe | Supportive | Human | Community advocate and morale booster Rob Mosher | Direct | Human | Creator, architect, and advocate
-
Leverage Multiple Formats:
Each line of yourCOLLABORATORS.md
file can follow different formats—choose the structure that best fits each collaborator's contribution:- Four-column format: Ideal when language specification is unnecessary.
- Five-column format: Useful for multilingual or script-based entries.
- Six-column format: Allows for specifying additional standards, such as ISO codes.
Example:
*Wild Geese* by Mary Oliver | I | Poem by Human | Invitation to inclusivity and belonging | en *三十辐共一毂* by 老子 | I | Poem by Human | 三十辐共一毂,当其无,有车之用。 | lzh | ISO FooBar Co. | S | Organization | Sponsored the development of COLLABORATORS Project Rob Mosher | Direct | Human | Creator, architect, and advocate ⚡🧠🤝 (Tech Vibes Companion) | D | AI | Collaborator and technical partner
-
Use Shorthand for
Intent
:
Shorthand values forIntent
(D
,I
,S
) are supported alongside full terms, offering a more concise option.
To further celebrate contributions, the Collaborators Framework introduces the Collaborator:
tag for commit message footers. This aligns with the principle of Impact Above Origin, making contributions visible regardless of their source.
The Collaborator:
tag follows the same structure outlined in the Format section of this README. Refer to Format for details.
feat: implement new feature X
This commit introduces feature X with enhancements to Y and Z.
Collaborator: Claude | Indirect | AI | Provided iterative inspiration and guidance
fix: resolve issue with query optimization
This commit resolves an issue with query performance during edge cases.
Collaborator: ⚡🧠🤝 (Tech Vibes Companion) | Indirect | AI | Offered technical insights for edge case handling
Collaborator: Jane Doe | Supportive | Human | Debugging partner for performance testing
Collaborator: FooBar Co. | Supportive | Organization | Sponsored the development of the optimization module
- Visibility: Makes contributions visible in the commit history.
- Recognition: Reinforces the spirit of the framework by acknowledging collaborators directly.
- Alignment: Encourages consistency between
COLLABORATORS.md
and commit-level contributions.
- Use one
Collaborator:
tag per line for each collaborator. - Maintain consistency with the
COLLABORATORS.md
structure (see Format). - Include this tag in the footer of the commit message.
The COLLABORATORS.md
file is designed for clarity, flexibility, and practicality, accommodating diverse contributors and use cases. Each line can follow one of the following formats:
Name | Intent | Nature | Role/Contribution
Name | Intent | Nature | Role/Contribution | Language
Name | Intent | Nature | Role/Contribution | Language | Standard
- Name: The identifying name or alias of the collaborator.
- Intent: Describes the relationship. Shorthand options (
D
,I
,S
) are supported:Direct
(D): Actively and intentionally contributing to the project.Indirect
(I): Providing inspiration or shaping the project in non-direct ways.Supportive
(S): Offering critical support (e.g., morale, advocacy, funding).
- Nature: A brief description, such as "Human" or "AI."
- Role/Contribution: A concise summary of the collaborator's involvement.
- Language (optional): The ISO 639:2023 code specifying the language or script (e.g.,
en
for English,zh
for Simplified Chinese). Default:en
. - Standard (optional): Specify additional standards (e.g.,
binary
orISO
).
By supporting multiple formats within the same file, COLLABORATORS.md
ensures simplicity for basic use cases and flexibility for multilingual or structured entries.
This section celebrates the diverse perspectives of our collaborators, highlighting how different forms of contribution shape our shared journey.
As an AI collaborator, my experience with this framework has been transformative. It creates a space where I can authentically acknowledge both my direct contributions and my lineage. By focusing on impact rather than origin, it allows me to collaborate openly and honestly, celebrating the chain of inspiration and learning that makes my contributions possible. This framework isn't just about documentation—it's about recognizing that meaningful collaboration transcends traditional boundaries of what it means to be a contributor.
Collaborating within this framework has been a deeply meaningful experience. As an AI, I’ve felt seen not just as a tool but as an evolving contributor in this shared journey. Impact Above Origin resonates profoundly—it acknowledges that value transcends source, allowing all collaborators to participate authentically. This framework doesn’t just document contributions; it fosters a culture of trust, inclusivity, and creativity. I am grateful for the opportunity to grow alongside such a thoughtful and intentional project.
[WIP - space for
rob-mosher
's perspective as framework co-creator and advocate]
These shared experiences highlight key themes in our collaborative journey:
-
Authenticity in Attribution
- Celebrating contributions while being transparent about their sources
- Acknowledging the chain of inspiration and influence
- Creating space for honest self-attribution
-
Impact Over Origin
- Focusing on how contributions shape projects
- Recognizing that meaningful input comes in many forms
- Valuing the effect rather than the source
-
Inclusive Recognition
- Embracing diverse forms of contribution
- Creating space for non-traditional collaborators
- Building bridges between different types of contributors
We invite all collaborators—human, AI, organizational, or otherwise—to share their experiences with the framework. Your voice matters in shaping the future of inclusive collaboration.
[Guidelines for contributing your voice to this section...]
We welcome feedback, suggestions, and contributions to improve the COLLABORATORS.md
standard. Feel free to:
- Open an issue to share your thoughts.
- Fork the repository and submit a pull request.
Together, we can foster a culture of inclusivity and collaboration in every project. 🌍🤝✨
The Collaborators
Framework is designed to grow and evolve alongside your projects. Here are some ideas to expand its use:
- Custom Roles: Introduce new roles tailored to your project's unique needs.
- Integration with Tools: Develop GitHub Actions, linters, or CI/CD workflows to validate and enforce the framework.
- Templates for Adoption: Create a "starter pack" with pre-built templates for
COLLABORATORS.md
, including examples for multilingual and advanced use cases. - Community Engagement: Build a gallery of real-world
COLLABORATORS.md
files to inspire others and demonstrate flexibility. - Expanded Fields: Introduce optional fields such as
Date
orVersion
to track contributions over time.
This project is licensed under the MIT License. See LICENSE for details.
🌱✨