Skip to content

lean-core: encode naming and single-source-of-truth rules in lean-contribute#12

Merged
mkucharski17 merged 1 commit into
mainfrom
feat/lean-contribute-rules
May 18, 2026
Merged

lean-core: encode naming and single-source-of-truth rules in lean-contribute#12
mkucharski17 merged 1 commit into
mainfrom
feat/lean-contribute-rules

Conversation

@mkucharski17
Copy link
Copy Markdown
Contributor

Summary

Follow-up to #11 (lean-anti-ai-slop) per @wzslr321's review. Two new rules in lean-contribute so the next contributor does not have to guess:

  • Naming. Path 3 step 1 now mandates a prefix — <vertical>-<scope> for vertical-bound plugins (backend, flutter, pmo, …) or lean-<scope> for cross-vertical / vertical-agnostic plugins (matching lean-core, lean-anti-ai-slop). Bare slugs are no longer acceptable. The previous text suggested vertical-<scope> as "a good shape" without addressing what to do for cross-vertical plugins.
  • Single source of truth. New explicit note under Plugin shape: setup/configuration docs live canonically in the plugin README.md; other surfaces (usage SKILL, workhorse skills, top-level README) reference it rather than restating it. Inline copies are allowed only for runtime-printed setup and must declare that intent. This closes the three-way drift that bit PR anti-ai-slop: add new plugin for voice-matched writing #11 across README.md / <plugin>-usage/SKILL.md / the drafting SKILL.

Env-var naming guidance was deliberately left out per Wiktor's clarification on PR #11 — it is a per-plugin consistency concern, not systemic guidance.

lean-core bumped to 0.3.0 (MINOR: new behavioral rules added to an existing skill).

Plugin shape

  • plugins/lean-core/.claude-plugin/plugin.json and .cursor-plugin/plugin.json — version 0.3.0 in sync
  • plugins/lean-core/CHANGELOG.md — new 0.3.0 entry
  • plugins/lean-core/skills/lean-contribute/SKILL.md — Path 3 step 1 expanded; new bullet in Plugin shape notes

🤖 Generated with Claude Code

…tribute

Two new rules in `lean-contribute` Path 3 / Plugin shape notes,
prompted by review feedback on the lean-anti-ai-slop PR (#11):

- Naming: kebab-case slug must carry a prefix. `<vertical>-<scope>` for
  plugins tied to a vertical (backend, flutter, pmo, …); `lean-<scope>`
  for cross-vertical or vertical-agnostic plugins (matching `lean-core`,
  `lean-anti-ai-slop`). Bare slugs are no longer acceptable.
- Single source of truth: setup/configuration docs live canonically in
  the plugin README; other surfaces reference it rather than restating
  it. Inline copies are allowed only for runtime-printed setup, and
  must declare that intent.

Both rules close gaps that contributors (including me, on PR #11) hit
because the previous guidance was suggestive rather than prescriptive.

Bumps `lean-core` to 0.3.0 (MINOR: new behavioral rules added to an
existing skill).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@mkucharski17 mkucharski17 merged commit c9d4960 into main May 18, 2026
3 checks passed
@wzslr321 wzslr321 deleted the feat/lean-contribute-rules branch May 19, 2026 09:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants