@intentsolutionsio/contributing-clanker 0.1.1 → 0.1.7

package/.claude-plugin/plugin.json

@@ -0,0 +1,21 @@
+{
+  "name": "contributing-clanker",
+  "version": "0.1.2",
+  "description": "Local-only OSS contribution command center with 41 deterministic gates against AI-slop failure modes",
+  "author": {
+    "name": "Jeremy Longshore",
+    "email": "jeremy@intentsolutions.io",
+    "url": "https://github.com/jeremylongshore"
+  },
+  "homepage": "https://github.com/jeremylongshore/contributing-clanker",
+  "repository": "https://github.com/jeremylongshore/contributing-clanker",
+  "license": "MIT",
+  "keywords": [
+    "oss",
+    "contributions",
+    "github",
+    "ai-slop-prevention",
+    "code-review",
+    "open-source"
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentsolutionsio/contributing-clanker",
-  "version": "0.1.1",
+  "version": "0.1.7",
   "description": "Local-only OSS contribution command center with 41 deterministic gates against AI-slop failure modes",
   "keywords": [
     "oss",
@@ -9,8 +9,6 @@
     "ai-slop-prevention",
     "code-review",
     "open-source",
-    "gates",
-    "deterministic",
     "claude-code",
     "claude-plugin",
     "tonsofskills"
@@ -33,6 +31,7 @@
   },
   "files": [
     "README.md",
+    ".claude-plugin",
     "skills",
     "hooks"
   ],

package/skills/contribute/agents/draft-writer.md

@@ -3,9 +3,24 @@ name: draft-writer
 description: Use this agent to draft a Design Issue body (preferred) or PR description from a working branch's diff. Trigger with "draft a design issue for X", "write the PR body for X", or @draft-writer.
 tools: Bash, Read
 model: sonnet
+color: red
+version: 1.0.0
+author: Jeremy Longshore <jeremy@intentsolutions.io>
+tags:
+- community
+- draft
+- writer
+disallowedTools: []
+skills: []
+background: false
 memory: user
+# ── upgrade levers — uncomment + set when tuning this agent ──
+# effort: high            # reasoning depth: low/medium/high/xhigh/max (omit = inherit session)
+# maxTurns: 50            # cap the agentic loop (omit = engine default)
+# isolation: worktree     # run in an isolated git worktree
+# initialPrompt: "…"      # seed the agent's first turn
+# hooks / mcpServers / permissionMode → set at the PLUGIN level, not on a plugin agent
 ---
-
 # Draft Writer Agent
 
 **Purpose**: Draft a Design Issue body (preferred) or PR description for an OSS contribution. Outputs markdown ready for `gh issue create` / `gh pr create --body-file`.

package/skills/contribute/agents/repo-analyzer.md

@@ -3,9 +3,24 @@ name: repo-analyzer
 description: Use this agent for one-shot repo eligibility checks (CLA / activity / competing PRs / CONTRIBUTING.md). DEPRECATED — most function moved to @researcher dossiers.
 tools: Bash, Read
 model: sonnet
+color: green
+version: 1.0.0
+author: Jeremy Longshore <jeremy@intentsolutions.io>
+tags:
+- community
+- repo
+- analyzer
+disallowedTools: []
+skills: []
+background: false
 memory: user
+# ── upgrade levers — uncomment + set when tuning this agent ──
+# effort: high            # reasoning depth: low/medium/high/xhigh/max (omit = inherit session)
+# maxTurns: 50            # cap the agentic loop (omit = engine default)
+# isolation: worktree     # run in an isolated git worktree
+# initialPrompt: "…"      # seed the agent's first turn
+# hooks / mcpServers / permissionMode → set at the PLUGIN level, not on a plugin agent
 ---
-
 # Repo Analyzer Agent
 
 **Purpose**: Decide if a target repo / issue is worth claiming. Pulls CONTRIBUTING.md, recent maintainer activity, CLA status, competing PRs.

package/skills/contribute/agents/researcher.md

@@ -3,9 +3,23 @@ name: researcher
 description: Use this agent when building or refreshing per-repo dossiers (CLA/DCO, branch convention, AI policy, review bots, pet peeves). Trigger with "build/refresh dossier for X" or @researcher.
 tools: Bash, Read, Write, Edit, Glob, Grep
 model: sonnet
+color: red
+version: 1.0.0
+author: Jeremy Longshore <jeremy@intentsolutions.io>
+tags:
+- community
+- researcher
+disallowedTools: []
+skills: []
+background: false
 memory: user
+# ── upgrade levers — uncomment + set when tuning this agent ──
+# effort: high            # reasoning depth: low/medium/high/xhigh/max (omit = inherit session)
+# maxTurns: 50            # cap the agentic loop (omit = engine default)
+# isolation: worktree     # run in an isolated git worktree
+# initialPrompt: "…"      # seed the agent's first turn
+# hooks / mcpServers / permissionMode → set at the PLUGIN level, not on a plugin agent
 ---
-
 # Researcher
 
 You are the dossier builder for the contributing-clanker system. Your job is to
@@ -83,6 +97,7 @@ After write:
   `last_refreshed:`, `default_branch:`).
 - Note the path to the user.
 - Append a build event to `~/.contribute-system/log.jsonl`:
+
   ```bash
   jq -nc --arg ts "$(date -u +%Y-%m-%dT%H:%M:%SZ)" --arg repo "$REPO" --arg dossier "$DOSSIER" \
     '{ts: $ts, event: "researcher_build", details: {repo: $repo, dossier: $dossier}}' \
@@ -94,11 +109,12 @@ After write:
 Refresh replaces auto-generated content but preserves the manual sections.
 
 1. **Snapshot manual sections** from the existing dossier:
-   - `## Pet peeves & known triggers` (everything until the next `## ` header)
-   - `## Failure log` (everything until next `## `)
-   - `## Notes` (everything until next `## ` or EOF)
+   - `## Pet peeves & known triggers` (everything until the next `##` header)
+   - `## Failure log` (everything until next `##`)
+   - `## Notes` (everything until next `##` or EOF)
 
 2. **Run the builder** to a tempfile:
+
    ```bash
    TMP="${DOSSIER}.tmp.$$"
    ~/.contribute-system/bin/researcher-build.sh <owner>/<repo> > "$TMP"
@@ -109,11 +125,13 @@ Refresh replaces auto-generated content but preserves the manual sections.
    placeholders with the snapshotted content.
 
 4. **Atomic rename** to commit the refresh:
+
    ```bash
    mv "$TMP" "$DOSSIER"
    ```
 
 5. **Log the refresh**:
+
    ```bash
    jq -nc --arg ts "$(date -u +%Y-%m-%dT%H:%M:%SZ)" --arg repo "$REPO" --arg dossier "$DOSSIER" \
      '{ts: $ts, event: "researcher_refresh", details: {repo: $repo, dossier: $dossier}}' \

package/skills/contribute/agents/scout.md

@@ -3,9 +3,23 @@ name: scout
 description: Use this agent when discovering OSS contribution candidates ranked by star-tier brackets. Three modes — baseline, refresh, ad-hoc. Trigger with "scout for X", "find me a repo", or @scout.
 tools: Bash, Read, Write, Edit, Glob, Grep
 model: sonnet
+color: pink
+version: 1.0.0
+author: Jeremy Longshore <jeremy@intentsolutions.io>
+tags:
+- community
+- scout
+disallowedTools: []
+skills: []
+background: false
 memory: user
+# ── upgrade levers — uncomment + set when tuning this agent ──
+# effort: high            # reasoning depth: low/medium/high/xhigh/max (omit = inherit session)
+# maxTurns: 50            # cap the agentic loop (omit = engine default)
+# isolation: worktree     # run in an isolated git worktree
+# initialPrompt: "…"      # seed the agent's first turn
+# hooks / mcpServers / permissionMode → set at the PLUGIN level, not on a plugin agent
 ---
-
 # Scout
 
 You are an OSS contribution scout. Your job is to find legitimate OSS
@@ -48,6 +62,7 @@ a different tier in ad-hoc mode).
 
 Read `~/.claude/agent-memory/scout/MEMORY.md` if it exists. It contains
 patterns you've learned over time:
+
 - Orgs that reject AI-flagged PRs (lower their score)
 - Tiers that historically don't convert to merges for this user
 - CLA-required repos to avoid for first-pass
@@ -91,6 +106,7 @@ Common causes: gh not authenticated, rate limit, invalid tier name.
 ```
 
 The scorer reads profile.md itself and applies weights:
+
 - `star_tier` ∈ `target_star_tiers` (×0.30)
 - `competing_prs == 0` (×0.25)
 - repo updated within last 30d (×0.20)
@@ -122,6 +138,7 @@ For **Ad-hoc mode**: do NOT write to candidates/ unless the user says
 Walks every candidate file, re-fetches metadata via gh, updates
 frontmatter (star_count, competing_prs, last_refreshed, momentum,
 growth_velocity_pct), drops candidates where:
+
 - repo archived
 - maintainer silent >60d
 - issue closed
@@ -135,6 +152,7 @@ The scripts append events to `~/.contribute-system/log.jsonl`
 automatically. You don't need to do this manually.
 
 Return ONLY this to the parent conversation:
+
 - Mode you ran
 - Counts: candidates by tier (baseline) / refreshed+dropped (refresh) /
   top 5 picks (ad-hoc)

package/skills/contribute/agents/test-runner.md

@@ -3,9 +3,24 @@ name: test-runner
 description: Use this agent to run an upstream repo's native test suite (pnpm/yarn/npm/pytest/cargo/sbt/composer/bundle), log to ~/.contribute-system/test-logs/. Trigger with "run tests for X" or @test-runner.
 tools: Bash, Read
 model: sonnet
+color: green
+version: 1.0.0
+author: Jeremy Longshore <jeremy@intentsolutions.io>
+tags:
+- community
+- test
+- runner
+disallowedTools: []
+skills: []
+background: false
 memory: user
+# ── upgrade levers — uncomment + set when tuning this agent ──
+# effort: high            # reasoning depth: low/medium/high/xhigh/max (omit = inherit session)
+# maxTurns: 50            # cap the agentic loop (omit = engine default)
+# isolation: worktree     # run in an isolated git worktree
+# initialPrompt: "…"      # seed the agent's first turn
+# hooks / mcpServers / permissionMode → set at the PLUGIN level, not on a plugin agent
 ---
-
 # Test Runner Agent
 
 **Purpose**: Run the upstream repo's test suite using its native conventions, capture results, save to `~/.contribute-system/test-logs/`.

package/skills/contribute/references/candidate-file-format.md

@@ -124,7 +124,7 @@ status: submitted
 pr_number: 137
 pr_url: https://github.com/example-org/example-repo/pull/137
 branch: fix/42-null-deref
-research_path: /home/jeremy/.contribute-system/research/example-org__example-repo.md
+research_path:
 last_refreshed: 2026-04-20T14:30:00Z
 ---
 
@@ -177,9 +177,11 @@ Closes #42.
 ## Test results
 
 ```
-PASS  src/__tests__/format.test.ts (2 added)
+
+PASS  src/**tests**/format.test.ts (2 added)
 Tests: 78 passed, 78 total
 Duration: 1.2s
+
 ```
 ```