open/linkedin-studio
1
0
Fork 0
Code Issues Pull requests Releases Wiki Activity Actions

fix(linkedin-studio): S27 ref-consistency A — "penalty/penalizes" framing → SSOT

Browse source 
Reconcile external-link and topic-relevance reach-loss framing to the algorithm-signals
SSOT across 6 files (10 edits): body links "correlate with lower reach" (LinkedIn denies
an intentional penalty), topic relevance is a positive ranking input with no quantified
off-topic figure. 3 plan-cited lines + 7 same-class siblings surfaced during verify.

Bucket B (link-penalty lines in linkedin-formats.md) folded into S28; Bucket D (other
unsourced reach-coefficients: -68%/-25%/-15-25%/-30-50%/55%) queued as new S30. Engagement-
pod + AI-slop "penalized" framing left intact (officially confirmed). Gate 81/0/0; counts
29/19 unchanged.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016qgzo6rxthw7KuxHjn5vyE
This commit is contained in:
Kjell Tore Guttormsen 2026-06-19 22:06:39 +02:00
commit 2b9ed1cf0b
8 changed files with 75 additions and 17 deletions
Download patch file Download diff file Expand all files Collapse all files

6
references/first-comment-strategy.md
View file

@ -1,13 +1,13 @@
# First Comment Strategy
Your first comment is a strategic tool, not an afterthought. Used correctly, it extends your post's value without triggering algorithm penalties. Used poorly, it looks like spam.
Your first comment is a strategic tool, not an afterthought. Used correctly, it extends your post's value without the lower-reach correlation of body links. Used poorly, it looks like spam.
## Why First Comments Matter
External links in the post body correlate with lower reach (correlational, ~38% in 2026; LinkedIn denies an intentional penalty — see `references/algorithm-signals-reference.md`). A first comment is a common hedge — but lead with standalone value either way; it's much more than a link dump.
**First comment benefits:**
- Avoids link penalty while still providing resources
- Avoids the body-link reach correlation while still providing resources
- Adds a second engagement surface (people reply to comments)
- Signals to the algorithm that the post is generating conversation
- Lets you add context that didn't fit the post's character limit
@ -144,7 +144,7 @@ Commenting on your own post is not just for adding links. Strategic self-comment
| Time | Action | Purpose |
|------|--------|---------|
| 0 min | Post goes live | — |
| 0-1 min | First comment (if link/resource) | Avoid link penalty |
| 0-1 min | First comment (if link/resource) | Avoid body-link reach hit |
| 15-30 min | Reply to first 3-5 commenters | Build early engagement momentum |
| 1-2 hours | Add additional perspective or data | Re-ignite algorithm distribution |
| 4-6 hours | Respond to remaining comments | Maintain conversation signal |

4
references/troubleshooting-guide.md
View file

@ -12,7 +12,7 @@ Understanding why content fails is as important as knowing what works.
- Posted at wrong time for YOUR audience
- No pre-posting engagement (cold start)
- Topic drift confusing algorithm about your expertise
- External link penalizing reach
- External links correlate with lower reach
- Inconsistent posting breaking topical authority signal
**Solutions:**
@ -124,7 +124,7 @@ Understanding how to recover from algorithmic suppression is critical for long-t
1. **Profile-content mismatch (profile/topic mismatch)** - Algorithm validates profile before distributing content
2. **Topic inconsistency** - Confused algorithm about your expertise
3. **Engagement pod detection** - Artificial engagement patterns flagged
4. **External link overuse** - LinkedIn penalizes directing traffic away
4. **External link overuse** - body links correlate with lower reach (LinkedIn denies an intentional penalty; lead with value)
5. **Posting frequency gap** - More than 5 days without posting
6. **Shadow ban from policy violation** - Content flagged for misinformation, spam, or harassment

2
references/url-processing-templates.md
View file

@ -393,7 +393,7 @@ Before publishing URL-based content:
| Copying structure | Looks like plagiarism | Restructure for LinkedIn |
| Burying the source | Appears deceptive | Credit early |
| Over-quoting | Looks lazy | Paraphrase more |
| Link in post body | Reach penalty | Move to comment |
| Link in post body | Correlates with lower reach | Move to comment |
| Missing CTA | Lower engagement | Add discussion question |
| Wrong angle | Doesn't fit expertise | Choose relevant angle |
| Too timely | Loses relevance fast | Add evergreen insight |