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

docs(linkedin-studio): M0-15 — repoint remaining prose families + route ab-tests/plans

Browse source
This commit is contained in:
Kjell Tore Guttormsen 2026-06-18 13:04:18 +02:00
commit 6bd263144f
35 changed files with 167 additions and 130 deletions
Download patch file Download diff file Expand all files Collapse all files

36
commands/setup.md
View file

@ -27,13 +27,13 @@ Read these 8 asset files and detect placeholder patterns to calculate the curren
| Category | Weight | File/Directory | Placeholder Detection |
|----------|--------|----------------|----------------------|
| Voice samples | 25 | `${LINKEDIN_STUDIO_DATA:-$HOME/.claude/linkedin-studio}/voice-samples/authentic-voice-samples.md` | Placeholder if it contains the `<!-- VOICE_PLACEHOLDER -->` sentinel (or has <50 lines) |
| User profile | 20 | `config/user-profile.local.md` | Check if file exists; count `[Your ` placeholders |
| Case studies | 15 | `assets/case-studies/*.md` | Count non-template `.md` files (exclude `case-study-template.md`) |
| Frameworks | 10 | `assets/frameworks/*.md` | Count non-template `.md` files (exclude `framework-template.md`) |
| High-engagement posts | 10 | `assets/examples/high-engagement-posts.md` | Count `## Post N:` headers |
| Demographics | 8 | `assets/audience-insights/demographics.md` | Count `[Industry name]`, `[Function]`, `[Country]`, `[X]%` |
| Engagement patterns | 7 | `assets/audience-insights/engagement-patterns.md` | Count `[Day]`, `[Time]`, `[Topic]`, `[Format]`, `[Hook type]` |
| Post templates | 5 | `assets/templates/my-post-templates.md` | Count `[Name - e.g.` vs total `## Template N:` headers |
| User profile | 20 | `${LINKEDIN_STUDIO_DATA:-$HOME/.claude/linkedin-studio}/profile/user-profile.md` | Check if file exists; count `[Your ` placeholders |
| Case studies | 15 | `${LINKEDIN_STUDIO_DATA:-$HOME/.claude/linkedin-studio}/case-studies/*.md` | Count non-template `.md` files (exclude `case-study-template.md`) |
| Frameworks | 10 | `${LINKEDIN_STUDIO_DATA:-$HOME/.claude/linkedin-studio}/frameworks/*.md` | Count non-template `.md` files (exclude `framework-template.md`) |
| High-engagement posts | 10 | `${LINKEDIN_STUDIO_DATA:-$HOME/.claude/linkedin-studio}/examples/high-engagement-posts.md` | Count `## Post N:` headers |
| Demographics | 8 | `${LINKEDIN_STUDIO_DATA:-$HOME/.claude/linkedin-studio}/audience-insights/demographics.md` | Count `[Industry name]`, `[Function]`, `[Country]`, `[X]%` |
| Engagement patterns | 7 | `${LINKEDIN_STUDIO_DATA:-$HOME/.claude/linkedin-studio}/audience-insights/engagement-patterns.md` | Count `[Day]`, `[Time]`, `[Topic]`, `[Format]`, `[Hook type]` |
| Post templates | 5 | `${LINKEDIN_STUDIO_DATA:-$HOME/.claude/linkedin-studio}/templates/my-post-templates.md` | Count `[Name - e.g.` vs total `## Template N:` headers |
**Scoring rules:**
- Full points: Asset has real data (few/no placeholders remaining)
@ -117,7 +117,7 @@ Based on their answer, run the corresponding sub-workflow below.
## Step 3b: Case Study Builder
**Goal:** Create a new case study file in `assets/case-studies/`.
**Goal:** Create a new case study file in `${LINKEDIN_STUDIO_DATA:-$HOME/.claude/linkedin-studio}/case-studies/`.
Conduct a 6-question interview:
@ -130,7 +130,7 @@ Conduct a 6-question interview:
After the interview, read `assets/case-studies/case-study-template.md` for structure reference, then create a new file:
**Filename:** `assets/case-studies/[slug].md` (derive slug from the challenge topic, e.g., `ai-procurement-transformation.md`)
**Filename:** `${LINKEDIN_STUDIO_DATA:-$HOME/.claude/linkedin-studio}/case-studies/[slug].md` (derive slug from the challenge topic, e.g., `ai-procurement-transformation.md`)
**File structure:**
```markdown
@ -172,7 +172,7 @@ Ask "Would you like to document another case study?" when done.
## Step 3c: Framework Documenter
**Goal:** Create a new framework file in `assets/frameworks/`.
**Goal:** Create a new framework file in `${LINKEDIN_STUDIO_DATA:-$HOME/.claude/linkedin-studio}/frameworks/`.
Conduct a 5-question interview:
@ -184,7 +184,7 @@ Conduct a 5-question interview:
After the interview, read `assets/frameworks/framework-template.md` for structure reference, then create:
**Filename:** `assets/frameworks/[slug].md` (e.g., `ai-maturity-model.md`)
**Filename:** `${LINKEDIN_STUDIO_DATA:-$HOME/.claude/linkedin-studio}/frameworks/[slug].md` (e.g., `ai-maturity-model.md`)
**File structure:**
```markdown
@ -228,12 +228,12 @@ Ask "Would you like to document another framework?" when done.
## Step 3d: Post Analysis
**Goal:** Document high-engagement posts in `assets/examples/high-engagement-posts.md`.
**Goal:** Document high-engagement posts in `${LINKEDIN_STUDIO_DATA:-$HOME/.claude/linkedin-studio}/examples/high-engagement-posts.md`.
Two approaches — ask which they prefer:
### Option A: Analytics Data Available
If the user has imported analytics data (check `assets/analytics/posts/` for JSON files):
If the user has imported analytics data (check `${LINKEDIN_STUDIO_DATA:-$HOME/.claude/linkedin-studio}/analytics/posts/` for JSON files):
1. Read the most recent analytics data files
2. Identify the top 3-5 posts by engagement rate
@ -257,7 +257,7 @@ If no analytics data available:
- **Pattern extraction:** What's replicable?
- **Mistakes identified:** What could be improved?
3. Read the existing `assets/examples/high-engagement-posts.md`
3. Read the existing `${LINKEDIN_STUDIO_DATA:-$HOME/.claude/linkedin-studio}/examples/high-engagement-posts.md`
4. **Append** new posts after existing entries (don't overwrite)
5. Update the "Patterns Across All High-Performing Posts" section based on all posts
@ -265,7 +265,7 @@ Ask "Would you like to add more posts?" when done.
## Step 3e: Demographics Sync
**Goal:** Populate `assets/audience-insights/demographics.md` with real LinkedIn Analytics data.
**Goal:** Populate `${LINKEDIN_STUDIO_DATA:-$HOME/.claude/linkedin-studio}/audience-insights/demographics.md` with real LinkedIn Analytics data.
Guide the user step by step through the LinkedIn Analytics UI:
@ -286,7 +286,7 @@ Guide the user step by step through the LinkedIn Analytics UI:
- Record the actual data
- Ask about trends ("Is this similar to previous months?")
5. Read the existing `assets/audience-insights/demographics.md`
5. Read the existing `${LINKEDIN_STUDIO_DATA:-$HOME/.claude/linkedin-studio}/audience-insights/demographics.md`
6. Replace the placeholder tables with real data
7. Fill in the "Key insights" sections based on the data patterns
8. Update the "Last Updated" date
@ -300,7 +300,7 @@ If the user says they don't have LinkedIn Analytics access or data yet, suggest:
## Step 3f: User Profile Setup
**Goal:** Create or update `config/user-profile.local.md`.
**Goal:** Create or update `${LINKEDIN_STUDIO_DATA:-$HOME/.claude/linkedin-studio}/profile/user-profile.md`.
Guide through each section of the profile:
@ -337,7 +337,7 @@ Guide through each section of the profile:
- "90-day growth goal?"
7. Read `config/user-profile.template.md` for structure
8. Write the completed profile to `config/user-profile.local.md`
8. Write the completed profile to `${LINKEDIN_STUDIO_DATA:-$HOME/.claude/linkedin-studio}/profile/user-profile.md`
**Important:** This file is gitignored (`.local.md` pattern), so personal data stays private.