seed-community

name	seed-community
argument-hint	[--only <file,...>] [--force]
description	Bootstrap OSS community health files — CONTRIBUTING.md, LICENSE, SECURITY.md, CODE_OF_CONDUCT.md, README sections (Getting Started, Badges), .github/PULL_REQUEST_TEMPLATE.md, .github/ISSUE_TEMPLATE/. Reads project metadata and CLAUDE.md; generates missing files idempotently. Triggers: "seed community" | "bootstrap community files" | "add contributing" | "add license" | "add security policy" | "github community files".
version	0.1.0
allowed-tools	Bash, Read, Write, Edit, Glob, Grep, ToolSearch

Seed Community

Let: σ := .claude/stack.yml config M := project metadata (name, description, license, author, repo URL) χ := community health file θ := stub threshold (< 20 lines of real content) MISSING := χ not present or below θ GENERATED := [] — accumulator

Goal: detect MISSING χ, generate with project-specific content, leave existing populated files untouched.

Idempotent — files ≥ 20 lines skipped unless --force.

/seed-community                          → detect + generate all MISSING
/seed-community --only SECURITY,CoC     → comma-separated subset
/seed-community --force                 → overwrite even populated files

Phase 1 — Load Metadata

1a. Read σ (cat .claude/stack.yml 2>/dev/null). Extract: runtime, package_manager, commands.*, build.formatter.

1b. Read project metadata:

# JS/TS
cat package.json 2>/dev/null | grep -E '"name"|"description"|"license"|"author"|"version"|"repository"'
# Python
cat pyproject.toml 2>/dev/null | grep -E '^name|^description|^license|^authors|^version'
# Go
cat go.mod 2>/dev/null | head -5

1c. Git remote → repo URL:

gh repo view --json nameWithOwner,description,licenseInfo,url 2>/dev/null

1d. Read CLAUDE.md (∃). Extract: purpose (1–3 sentences), commit format, branch conventions, PR/review process, stack notes. Merge into M: {name, description, license, author, repo_url, commit_format, pr_process, stack}.

Phase 2 — Detect Missing Files

Check presence + line count ∀ target:

Target	Path	Stub if
README sections	README.md	Missing "Getting Started" or "Installation" heading
CONTRIBUTING	CONTRIBUTING.md	∄ or < 20 lines
LICENSE	LICENSE	∄
SECURITY	SECURITY.md	∄ or < 10 lines
Code of Conduct	CODE_OF_CONDUCT.md	∄
PR Template	.github/PULL_REQUEST_TEMPLATE.md	∄
Issue: Bug	.github/ISSUE_TEMPLATE/bug_report.md	∄
Issue: Feature	.github/ISSUE_TEMPLATE/feature_request.md	∄

--only X,Y → filter MISSING to those names. --force → include all targets regardless of line count.

Display:

Community health file audit:
  README.md                              ⚠ missing Getting Started section
  CONTRIBUTING.md                        ✅ populated (47 lines) — skip
  LICENSE                                ✅ exists — skip
  SECURITY.md                            ❌ missing
  CODE_OF_CONDUCT.md                     ❌ missing
  .github/PULL_REQUEST_TEMPLATE.md       ❌ missing
  .github/ISSUE_TEMPLATE/bug_report.md   ❌ missing
  .github/ISSUE_TEMPLATE/feature_request.md ❌ missing

5 files to generate.

MISSING = ∅ → "All community files are present. Use --force to regenerate." → exit.

Phase 3 — Confirm + Gather Options

→ present multi-select

1. License type (LICENSE ∈ MISSING) → MIT | Apache-2.0 | GPL-3.0 | Skip
2. Author / org name (∄ in M) → ask user
3. Optional extras (multiSelect) → FUNDING.yml | CODEOWNERS | Contributor Covenant v2.1 wording (for CoC)

Phase 4 — Generate Files

Process MISSING in order: LICENSE → CODE_OF_CONDUCT → SECURITY → CONTRIBUTING → PR Template → Issue Templates → README sections.

LICENSE

git log --reverse --format="%ad" --date=format:"%Y" | head -1 → year (else current year). Generate standard SPDX text. Author = M.author or org from repo URL.

CODE_OF_CONDUCT.md

Contributor Covenant v2.1. Replace [INSERT CONTACT METHOD] with M.author email if available, else leave placeholder.

SECURITY.md

# Security Policy

## Supported Versions

| Version | Supported |
|---------|-----------|
| latest  | ✅        |

## Reporting a Vulnerability

Please **do not** open a public GitHub issue for security vulnerabilities.

Report privately via GitHub Security Advisories:
[Report a vulnerability]({M.repo_url}/security/advisories/new)

Or email: {M.author_email or "[MAINTAINER EMAIL]"}

We aim to respond within 48 hours and patch within 14 days.

CONTRIBUTING.md (if stub/missing)

Pull from M + σ:

• Dev setup — clone, {commands.install}, {commands.dev}
• Tests — {commands.test}
• Commit format — M.commit_format or conventional commits default
• Branch naming — feat/, fix/, chore/ prefixes
• PR process — M.pr_process or standard checklist
• Code style — {build.formatter} + {build.formatter_fix_cmd}

.github/PULL_REQUEST_TEMPLATE.md

## Summary

<!-- What does this PR do? Link the issue: Closes #N -->

## Type of change

- [ ] Bug fix
- [ ] New feature
- [ ] Refactoring
- [ ] Documentation
- [ ] CI/Infrastructure

## Checklist

- [ ] Tests pass (`{commands.test}`)
- [ ] Lint passes (`{commands.lint}`)
- [ ] Docs updated if needed
- [ ] Commit messages follow `{commit_format}`

Issue Templates

bug_report.md — Steps to reproduce, Expected behavior, Actual behavior, Environment (OS, runtime version, plugin version), Additional context.

feature_request.md — Problem statement, Proposed solution, Alternatives considered, Additional context.

README.md — missing sections

Read existing README. Inject after first ## or at end if ¬sections:

• Getting Started — prerequisites, install command, quick usage
• Installation — if ∄ as heading
• Badges — ∄ badge lines near top → add CI status + license badge using M.repo_url

¬overwrite existing content — append missing sections or insert badges at top only.

After each file: display ✅ {path} — generated ({N} lines) and append to GENERATED.

Phase 5 — Summary + Commit

Seed Community Complete
=======================

  Generated ({|GENERATED|} files):
    LICENSE                                  ✅ MIT, 2026
    CODE_OF_CONDUCT.md                       ✅ Contributor Covenant v2.1
    SECURITY.md                              ✅ vulnerability reporting policy
    .github/PULL_REQUEST_TEMPLATE.md         ✅ PR checklist
    .github/ISSUE_TEMPLATE/bug_report.md     ✅
    .github/ISSUE_TEMPLATE/feature_request.md ✅
    README.md                                ✅ badges + Getting Started added

  Skipped (already populated):
    CONTRIBUTING.md                          ⏭ 47 lines
    LICENSE                                  ⏭ exists

→ present choice Commit generated files | Review first, commit manually | Skip

"Commit" → git add {GENERATED} + commit:

chore: add community health files (SECURITY, CoC, issue templates)

Edge Cases

Scenario	Behavior
¬git repo	Skip badges + GitHub-specific files; generate root files only
¬package.json ∧ ¬pyproject.toml	Use git remote for name; prompt for author
LICENSE already exists	Skip regardless of --force (license changes are intentional)
Private repo	Omit public security advisory link; use email only
Monorepo	Generate at root; note sub-packages may need own LICENSE
README.md has badges already	Skip badge insertion
¬.github dir	mkdir -p .github/ISSUE_TEMPLATE before writing templates

$ARGUMENTS