Skip to content

Commit f62c1ef

Browse files
committed
Add community engagement plan
1 parent 019afef commit f62c1ef

8 files changed

Lines changed: 166 additions & 6 deletions

README.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -61,6 +61,7 @@ Use these starter artifacts:
6161
- [Twelve month milestone plan](docs/TWELVE_MONTH_MILESTONE_PLAN.md)
6262
- [Spec change process](docs/SPEC_CHANGE_PROCESS.md)
6363
- [Security posture plan](docs/SECURITY_POSTURE_PLAN.md)
64+
- [Community engagement plan](docs/COMMUNITY_ENGAGEMENT_PLAN.md)
6465
- [AAIF proposal readiness self-audit](docs/AAIF_PROPOSAL_READINESS.md)
6566
- [AAIF portfolio recognition roadmap](docs/AAIF_PORTFOLIO_RECOGNITION_ROADMAP.md)
6667
- [Ecosystem contribution ledger](docs/ECOSYSTEM_CONTRIBUTION_LEDGER.md)
@@ -124,8 +125,8 @@ Bad use:
124125

125126
## Current Status
126127

127-
Version: `0.5.13`
128+
Version: `0.5.14`
128129

129-
Status: early OSS profile with public flagship examples, adopter guide, boundary template, scoring guide, ecosystem alignment brief, compatibility policy, adoption registry, external review guide, maintainer review kit, AAIF proposal readiness self-audit, ecosystem contribution ledger, security posture plan, and static docs portal.
130+
Status: early OSS profile with public flagship examples, adopter guide, boundary template, scoring guide, ecosystem alignment brief, compatibility policy, adoption registry, external review guide, maintainer review kit, AAIF proposal readiness self-audit, ecosystem contribution ledger, security posture plan, static docs portal, and community engagement plan.
130131

131132
Next target: external technical feedback from agentic AI maintainers and AAIF/LF-style community forums.

ROADMAP.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -86,6 +86,10 @@
8686

8787
- Add GitHub Pages-ready docs portal for profile discovery, reviewer entry points, SEO metadata, sitemap, and public review links.
8888

89+
## 0.5.14
90+
91+
- Add community engagement plan for AAIF/LF-style forum participation, GitHub review issues, adoption-trial outreach, human-reviewed posting, response cadence, and anti-endorsement boundaries.
92+
8993
## 0.6.0
9094

9195
- Add first external adoption example if a maintainer opts in.

docs/AAIF_PROPOSAL_READINESS.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -71,7 +71,7 @@ The correct current route is external technical feedback, small upstream contrib
7171
| Portfolio recognition path | `docs/AAIF_PORTFOLIO_RECOGNITION_ROADMAP.md` | Partial | Turn the 90-day plan into external review and adoption evidence. |
7272
| Security posture | `SECURITY.md`, `docs/SECURITY_POSTURE_PLAN.md`, no sensitive runtime, dependency inventory | Partial | Enable OpenSSF Scorecard or Best Practices evidence after external review; keep current posture documented without certification claims. |
7373
| Website or docs portal | GitHub Pages static docs portal and repository docs | Ready | Keep the portal current with releases, reviewer links, and adoption evidence. |
74-
| Communications channels | GitHub issues and discussion | Partial | Keep Discord/LinkedIn activity as pointers back to GitHub evidence. |
74+
| Communications channels | GitHub issues, public review comments, docs portal, `docs/COMMUNITY_ENGAGEMENT_PLAN.md` | Partial | Use the engagement plan for AAIF Discord, LinkedIn, and forum posts; keep all outreach as pointers back to GitHub evidence. |
7575
| Trademark and account transfer | No decision | Missing | User decision required before any formal proposal. |
7676
| Contact and signatory | Not public | Missing | User decision required before any formal proposal. |
7777

docs/COMMUNITY_ENGAGEMENT_PLAN.md

Lines changed: 148 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,148 @@
1+
# Community Engagement Plan
2+
3+
## Purpose
4+
5+
This plan explains how the Agentic Enterprise Readiness Profile should participate in public OSS communities, AAIF/LF-style forums, GitHub issues, GitHub discussions, Discord, LinkedIn, and adjacent maintainer spaces.
6+
7+
The goal is to earn technical feedback through useful artifacts and careful follow-up. The goal is not volume, promotion, endorsement, or artificial visibility.
8+
9+
This is an independent OSS profile. It is not an Agentic AI Foundation project, not a Linux Foundation project, and not endorsed by either organization.
10+
11+
## Engagement Principles
12+
13+
- Lead with a concrete artifact, not a pitch.
14+
- Ask for technical correction before asking for attention.
15+
- Keep every public claim linked to repository evidence.
16+
- Prefer one thoughtful follow-up over repeated reminders.
17+
- Do not tag maintainers cold unless they already engaged or are the documented owner of the specific issue.
18+
- Treat open PRs and issues as work under review, not accepted contribution.
19+
- Keep AI-assisted drafting human-reviewed before posting.
20+
- Do not post private customer, employer, security, credential, or proprietary material.
21+
22+
## Canonical Public Links
23+
24+
Use these links as the public evidence spine:
25+
26+
- Docs portal: https://kmishra1204.github.io/agentic-enterprise-readiness-profile/
27+
- Repository: https://github.com/kmishra1204/agentic-enterprise-readiness-profile
28+
- Current review issue: https://github.com/kmishra1204/agentic-enterprise-readiness-profile/issues/4
29+
- Current adoption trial issue: https://github.com/kmishra1204/agentic-enterprise-readiness-profile/issues/5
30+
- AAIF proposal readiness self-audit: https://github.com/kmishra1204/agentic-enterprise-readiness-profile/blob/main/docs/AAIF_PROPOSAL_READINESS.md
31+
- Ecosystem contribution ledger: https://github.com/kmishra1204/agentic-enterprise-readiness-profile/blob/main/docs/ECOSYSTEM_CONTRIBUTION_LEDGER.md
32+
- Security posture plan: https://github.com/kmishra1204/agentic-enterprise-readiness-profile/blob/main/docs/SECURITY_POSTURE_PLAN.md
33+
- Adoption trial protocol: https://github.com/kmishra1204/agentic-enterprise-readiness-profile/blob/main/docs/ADOPTION_TRIAL_PROTOCOL.md
34+
35+
## Community Surfaces
36+
37+
| Surface | Use | Frequency | Boundary |
38+
| --- | --- | --- | --- |
39+
| GitHub issues in this repository | canonical review, adoption trials, and change requests | ongoing | public, evidence-first |
40+
| GitHub discussions in this repository | open-ended ecosystem-fit questions | low cadence | no endorsement claims |
41+
| AAIF Discord or forum spaces | ask where the profile is useful or duplicative | one initial post, then only reply to engagement | no cold repetition |
42+
| LinkedIn | human summary that points back to GitHub evidence | occasional, after repository evidence exists | no inflated contributor or foundation claims |
43+
| Upstream AAIF-adjacent repositories | focused issues or PRs against existing maintainer needs | only when a concrete issue exists | no generic promotion |
44+
45+
## First AAIF-Style Forum Ask
46+
47+
Use this shape when posting in a community forum:
48+
49+
```text
50+
I am looking for technical feedback, not endorsement.
51+
52+
I maintain an independent OSS Agentic Enterprise Readiness Profile for repositories that need clearer evidence around AGENTS.md instructions, tool/action boundaries, human approval, identity assumptions, audit events, OSS fallbacks, security posture, and reproducible validation.
53+
54+
Docs portal:
55+
https://kmishra1204.github.io/agentic-enterprise-readiness-profile/
56+
57+
Review issue:
58+
https://github.com/kmishra1204/agentic-enterprise-readiness-profile/issues/4
59+
60+
I am trying to understand whether this is useful beside AGENTS.md guidance, MCP/server readiness, agent gateway governance use cases, or whether it should stay independent. If there is a better existing effort, I would rather align than create another checklist.
61+
```
62+
63+
## Response Rules
64+
65+
When someone replies:
66+
67+
- thank them once
68+
- restate the technical point in neutral language
69+
- open a follow-up issue only if a concrete change is needed
70+
- avoid debating endorsement, status, or affiliation
71+
- update the profile only when the feedback improves the artifact
72+
- link release notes when a feedback-driven change ships
73+
74+
When nobody replies:
75+
76+
- wait at least seven days before any follow-up in the same venue
77+
- improve the profile through examples, docs, or accepted upstream work instead of reposting
78+
- do not tag additional people just to force attention
79+
80+
## Adoption Trial Rules
81+
82+
An adoption trial must be opt-in.
83+
84+
Do not list a repository as an adopter unless a maintainer publicly agrees.
85+
86+
A valid trial can be small:
87+
88+
- one read-only review comment
89+
- one branch with a boundary model
90+
- one draft `agentic-readiness.json`
91+
- one issue explaining why the profile is too heavy or not useful
92+
93+
The adoption registry should record only public links and should distinguish trial, review, and adoption.
94+
95+
## AI-Assisted Posting Boundary
96+
97+
AI assistance may be used to draft a post, summarize feedback, or prepare release notes.
98+
99+
Human review is required before posting.
100+
101+
Do not use automation to:
102+
103+
- mass-post across communities
104+
- scrape people for outreach
105+
- impersonate a maintainer
106+
- claim contributor credit before merge
107+
- infer endorsement from silence
108+
- paste private material into public issues or prompts
109+
110+
## Quality Metrics
111+
112+
Useful signals:
113+
114+
- external reviewer comments
115+
- concrete issue feedback
116+
- accepted upstream PRs
117+
- profile changes based on public feedback
118+
- opt-in adoption trials
119+
- maintainers reusing an artifact
120+
121+
Weak signals:
122+
123+
- post impressions
124+
- generic likes
125+
- open PR count without reviews
126+
- reposting the same ask
127+
- self-claimed affiliation
128+
129+
## Escalation Gates
130+
131+
Do not prepare a formal AAIF project or working-group proposal until there is public evidence of:
132+
133+
- external reviewers
134+
- opt-in adoption trials
135+
- maintainer engagement
136+
- a stable governance path
137+
- clear relation to AGENTS.md, MCP, agentgateway, or another existing effort
138+
- user decision on trademark, account, signatory, and contribution implications
139+
140+
## Review Cadence
141+
142+
Review this plan after:
143+
144+
- two public external feedback signals
145+
- one adoption trial
146+
- a major release
147+
- a maintainer asks for different engagement behavior
148+
- a community moderator requests changes

docs/TWELVE_MONTH_MILESTONE_PLAN.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ It is not a commitment from AAIF, the Linux Foundation, or any external maintain
1818

1919
| Window | Milestone | Evidence required | Recognition posture |
2020
| --- | --- | --- | --- |
21-
| Month 1 | External trial readiness | Adoption trial protocol, issue template, public trial issue, release checklist, dependency inventory, security posture plan, docs portal | Independent review request only |
21+
| Month 1 | External trial readiness | Adoption trial protocol, issue template, public trial issue, release checklist, dependency inventory, security posture plan, docs portal, community engagement plan | Independent review request only |
2222
| Months 2-3 | First external feedback | At least two external comments, issues, or trial responses | Feedback received, not adoption |
2323
| Months 3-4 | Portfolio evidence expansion | Four more portfolio repositories with boundary models or readiness JSON | Testbed expansion, not production proof |
2424
| Months 4-6 | Spec stabilization pass | Spec-change process used for at least one profile or schema change | Process maturity, not standardization |
@@ -35,6 +35,7 @@ Current focus:
3535
- ask for external trials through issue `#5`
3636
- keep security posture, secret-safety, and release-gate evidence current
3737
- keep the docs portal current with release and review links
38+
- use the community engagement plan before any AAIF/LF-style forum post
3839
- avoid cold-tagging maintainers
3940
- convert feedback into profile changes
4041

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "agentic-enterprise-readiness-profile",
3-
"version": "0.5.13",
3+
"version": "0.5.14",
44
"private": false,
55
"type": "module",
66
"description": "Evidence-first readiness profile for agentic AI repositories.",

scripts/validate-readiness.mjs

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,7 @@ const requiredDocs = [
2121
"docs/TWELVE_MONTH_MILESTONE_PLAN.md",
2222
"docs/SPEC_CHANGE_PROCESS.md",
2323
"docs/SECURITY_POSTURE_PLAN.md",
24+
"docs/COMMUNITY_ENGAGEMENT_PLAN.md",
2425
"docs/SCORING_GUIDE.md",
2526
".github/ISSUE_TEMPLATE/adoption_review.md",
2627
".github/ISSUE_TEMPLATE/adoption_trial.md",
@@ -71,6 +72,7 @@ for (const snippet of [
7172
"https://kmishra1204.github.io/agentic-enterprise-readiness-profile/",
7273
"SECURITY_POSTURE_PLAN.md",
7374
"AAIF_PROPOSAL_READINESS.md",
75+
"COMMUNITY_ENGAGEMENT_PLAN.md",
7476
"not an Agentic AI Foundation project"
7577
]) {
7678
assert(siteText.includes(snippet), `Docs portal missing snippet: ${snippet}`);

site/index.html

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -62,7 +62,7 @@ <h1>Make agentic AI repositories easier to review, trust, and extend.</h1>
6262
<img class="readiness-flow" src="./assets/readiness-flow.svg" alt="Five connected readiness levels from scaffold to foundation candidate.">
6363
<div class="signal-row">
6464
<span>Current release</span>
65-
<strong>v0.5.13</strong>
65+
<strong>v0.5.14</strong>
6666
</div>
6767
<div class="signal-row">
6868
<span>Validation</span>
@@ -145,6 +145,10 @@ <h2>Start from the artifacts reviewers usually ask for first.</h2>
145145
<span>Security</span>
146146
<strong>Posture Plan</strong>
147147
</a>
148+
<a href="https://github.com/kmishra1204/agentic-enterprise-readiness-profile/blob/main/docs/COMMUNITY_ENGAGEMENT_PLAN.md">
149+
<span>Community</span>
150+
<strong>Engagement Plan</strong>
151+
</a>
148152
<a href="https://github.com/kmishra1204/agentic-enterprise-readiness-profile/blob/main/docs/MAINTAINER_REVIEW_KIT.md">
149153
<span>Maintainers</span>
150154
<strong>Review Kit</strong>

0 commit comments

Comments
 (0)