ln-910-community-engagement

Paths: File paths (references/, ../ln-*) are relative to this skill directory.

ln-910-community-engagement

Type: L2 Coordinator (active) Category: 9XX Community Engagement

Analyzes current community health and repository state, consults the engagement strategy, and delegates to the appropriate worker. Each worker is also invocable standalone.

---

Overview

Aspect	Details
Input	$ARGUMENTS (optional): topic, action keyword, or empty for auto-analysis
Output	Situation report + delegated action via worker skill
Workers	ln-911 (triager), ln-912 (announcer), ln-913 (debater), ln-914 (responder)

---

Phase 0: GitHub Discovery

MANDATORY READ: Load references/community_github_discovery.md

Execute the discovery protocol. Extract:

• {owner}/{repo} for all GitHub operations
• repo.id for GraphQL mutations (passed to workers)
• maintainer login (authenticated user)
• Discussion category IDs

Gate checks: gh authenticated? Discussions enabled?

Load strategy: check docs/community_engagement_strategy.md in target project, fallback to references/community_strategy_template.md.

---

Phase 1: Situation Analysis

If $ARGUMENTS contains a direct action keyword (announce, debate, triage, respond), skip analysis and jump to Phase 3 (Direct Delegation).

Otherwise, gather context from multiple sources in parallel:

1a. Community Health

Delegate to triager in summary mode (no interactive preview):

Skill(skill: "ln-911-github-triager", args: "summary")

Extract from triager output: red flags, priority counts (P0/P1/P2), health metrics.

1b. Unreleased Changes

# Last announcement date: most recent Announcements discussion
gh api graphql -f query='query($owner: String!, $name: String!) {
  repository(owner: $owner, name: $name) {
    discussions(first: 1, categoryId: "{categories.Announcements}", orderBy: {field: CREATED_AT, direction: DESC}) {
      nodes { createdAt title }
    }
  }
}' -f owner="{owner}" -f name="{repo}"

Then check what changed since:

git log --oneline --since="{last_announcement_date}"

Read CHANGELOG.md — any entries newer than the last announcement?

1c. Cadence Check

From strategy Section 4:

• Days since last announcement → monthly digest overdue if >30 days?
• Any pending architectural decisions that need RFC?

---

Phase 2: Decision Matrix

Apply strategy Section 1 (Announcement vs Debate) to the gathered context:

Condition	Priority	Action	Worker
Red flags: unanswered discussions >7d	P0	Respond to unanswered items	→ ln-914
Red flags: PRs needing review	P0	List PRs needing review	Recommendations only
Unreleased changes in CHANGELOG	P1	Announce: new features/fixes	→ ln-912
$ARGUMENTS contains RFC/debate topic	P1	Debate: launch RFC	→ ln-913
Monthly digest overdue (>30d)	P2	Monthly digest announcement	→ ln-912
Design questions identified in Phase 1	P2	Debate: RFC for open decisions	→ ln-913
Community health OK, nothing unreleased	—	Report "all clear"	No delegation

Output: Situation Report

Present to user:

## Community Status — {YYYY-MM-DD}

**Repo:** {owner}/{repo}
**Last announcement:** {date} ({days} days ago)
**Open items:** {issues} issues, {prs} PRs, {discussions} discussions

### Red Flags
{list or "None"}

### Recommended Action
{One of: Announce / Debate / Respond to items / No action needed}

**Reason:** {brief explanation based on strategy criteria}

Wait for user approval before proceeding.

---

Phase 3: Delegate

After user approves the recommended action:

Direct Delegation (when $ARGUMENTS specifies action)

Argument	Delegation
announce or announce {topic}	Skill(skill: "ln-912-community-announcer", args: "{topic}")
debate or debate {topic}	Skill(skill: "ln-913-community-debater", args: "{topic}")
triage or triage {scope}	Skill(skill: "ln-911-github-triager", args: "{scope}")
respond or respond {#number}	Skill(skill: "ln-914-community-responder", args: "{#number or batch}")

Analysis-Based Delegation

Recommended action	Delegation
Announce	Skill(skill: "ln-912-community-announcer") — worker gathers its own context
Debate	Skill(skill: "ln-913-community-debater", args: "{identified topic}")
Respond to items	Skill(skill: "ln-914-community-responder", args: "batch")
No action needed	Report status, done

---

Shared References

File	Purpose
references/community_github_discovery.md	Phase 0: dynamic repo/category/user discovery
references/community_strategy_template.md	Default engagement strategy (fallback)
references/community_discussion_formatting.md	GitHub Discussion formatting rules

---

Strategy Override

Each target project can override the default strategy by creating docs/community_engagement_strategy.md. All skills check project-local first, then fall back to the template in references/.

---

Phase 4: Meta-Analysis

Optional reference: load references/meta_analysis_protocol.md only when the user asks for post-run meta-analysis or protocol-formatted run reflection.

Skill type: planning-coordinator. When requested, run after Phase 3 completes. Output to chat using the planning-coordinator format.

---

TodoWrite format (mandatory):

- GitHub discovery (in_progress)
- Situation analysis (pending)
- Apply decision matrix (pending)
- Invoke ln-911-github-triager (pending)
- Invoke ln-912-community-announcer (pending)
- Invoke ln-913-community-debater (pending)
- Invoke ln-914-community-responder (pending)
- Report outcome to user (pending)

Worker Invocation (MANDATORY)

Host Skill Invocation: Skill(skill: "...", args: "...") is mandatory delegation.

• Claude: call the Skill tool exactly as shown.
• Codex: if no Skill tool exists, locate the named skill in available skills, read its SKILL.md, treat args as $ARGUMENTS, execute that skill workflow, then return here with its result/artifact.
• Do not inline worker logic or mark the worker complete without executing the target skill.

Phase	Worker	Context
1	ln-911-github-triager	Shared (Skill tool) — community health summary
3	ln-912-community-announcer	Shared (Skill tool) — feature/release announcements
3	ln-913-community-debater	Shared (Skill tool) — RFC / architectural debates
3	ln-914-community-responder	Shared (Skill tool) — respond to unanswered items

All workers: Invoke via Skill tool — workers see coordinator context.

Definition of Done

• GitHub discovery complete (owner/repo, categories, maintainer extracted)
• Situation analyzed (health + unreleased changes + cadence) OR direct delegation triggered
• Decision matrix applied with priority-based action selection
• Worker delegated or recommendations shown to user
• User informed of outcome

---

Version: 1.0.0 Last Updated: 2026-03-13