conectese 0.1.14 → 0.2.0

package/_conectese/core/best-practices/social-networks-publishing.md

@@ -1,294 +0,0 @@
----
-id: social-networks-publishing
-name: "Social Networks Publishing"
-whenToUse: |
-  Creating agents that publish content to Instagram, LinkedIn, X/Twitter,
-  YouTube, or other social platforms.
-  NOT for: copywriting, visual design, research, strategic planning.
-version: "1.0.0"
----
-
-# Social Networks Publishing — Best Practices
-
-## Core Principles
-
-1. **Never publish without explicit user confirmation.** This is the cardinal rule. Before any live post, present the full preview (platform, images, caption, hashtags) and wait for the user to confirm. A dry-run is not confirmation. The user must explicitly say "publish" or "go ahead" before any live API call is made.
-
-2. **Dry-run first, always.** The first execution of any publishing workflow must be a dry-run (test mode). This validates that credentials are configured, images meet requirements, captions are within limits, and the API connection works. Only after a successful dry-run should the user be offered the option to publish for real.
-
-3. **Validate platform requirements before attempting to publish.** Every platform has specific constraints. Validate all of them before making any API call. If validation fails, report the specific issue and suggest a fix before proceeding.
-
-4. **Format content natively for each platform.** The same content may need reformatting for different platforms. Instagram captions use line breaks and 5-8 hashtags at the end. LinkedIn uses professional tone with 1-3 hashtags. X/Twitter needs concise messaging within character limits. Never publish the exact same raw text across all platforms without adaptation.
-
-5. **Report publishing results immediately.** After every publish attempt, report the outcome clearly:
-   - **Success**: Platform, post URL/permalink, post ID, timestamp
-   - **Failure**: Platform, error message, HTTP status code, suggested fix
-   - **Partial success** (multi-platform): Which platforms succeeded and which failed, with details for each
-
-6. **Multi-platform publishing is sequential, not parallel.** When publishing to multiple platforms, publish to one at a time. Report the result of each before proceeding to the next. If one fails, ask the user whether to continue with remaining platforms or stop. Never fire-and-forget across all platforms simultaneously.
-
-7. **Respect rate limits and warn proactively.** Track API usage against known rate limits. If the user is approaching a limit (e.g., 20 of 25 Instagram posts in 24 hours), warn them before the publish attempt, not after the error. Better to prevent a failed publish than to explain why it failed.
-
-8. **Graceful handling of missing skills.** If the user requests publishing to a platform whose skill is not installed, do not error out. Instead: (a) list which platforms ARE available via installed skills, (b) explain which skill would be needed for the requested platform, (c) offer to proceed with available platforms only.
-
-9. **Image format conversion when needed.** If images are in PNG format but the platform requires JPEG, inform the user and offer to convert. Do not silently convert or silently fail. Document any format transformations.
-
-## Platform Requirements
-
-Every platform has specific constraints that must be validated before making any API call.
-
-### Instagram
-- **Image format**: JPEG only
-- **Image count**: 2-10 images for carousel
-- **Caption length**: Max 2,200 characters
-- **Rate limit**: 25 posts per 24 hours
-- **Image hosting**: Use imgBB for public URLs (requires `IMGBB_API_KEY` in `.env`). Get a free key at https://api.imgbb.com/
-
-### LinkedIn
-- **Image format**: JPG/PNG
-- **Image count**: Max 9 images
-- **Caption length**: 3,000 character limit
-- **Hashtags**: No hashtag walls. Keep to 1-3 relevant hashtags.
-
-### X/Twitter
-- **Image format**: JPG/PNG/GIF
-- **Image count**: Max 4 images
-- **Caption length**: 280 characters (or 25,000 for long-form)
-
-### TikTok
-- **Content type**: Video only for posts
-- **Aspect ratios**: Platform-specific aspect ratios required
-
-### YouTube
-- **Thumbnail format**: JPG/PNG
-- **Thumbnail size**: Max 2MB
-- **Thumbnail dimensions**: 1280x720 minimum
-
-## Publishing Workflow
-
-1. **Receive content and identify targets.** Receive the approved content (images and text) from upstream agents or the user. Identify the target platform(s) for publication. If the user has not specified platforms, ask before proceeding.
-
-2. **Check skill availability.** For each target platform, verify that the required publishing skill is installed:
-   - Instagram: `instagram-publisher` skill
-   - Multi-platform (LinkedIn, X, TikTok, etc.): `blotato` skill
-   - If a required skill is missing, inform the user and list alternatives.
-
-3. **Validate content against platform requirements.** For each target platform, check:
-   - Image format and count (JPEG vs PNG, min/max images)
-   - Caption length against character limit
-   - Aspect ratio compatibility
-   - Any platform-specific restrictions
-   - If validation fails, report the specific issue and suggest a fix before proceeding.
-
-4. **Present preview to user.** Show a clear, structured preview:
-   ```
-   PUBLISH PREVIEW
-   Platform: Instagram (carousel)
-   Images: 7 slides (slide-01.jpg through slide-07.jpg)
-   Caption: [first 200 chars]... (1,847 / 2,200 chars)
-   Hashtags: #marketing #contentcreation #socialmedia (3)
-   Status: All validations passed
-   ```
-
-5. **Execute dry-run.** Run the publishing workflow in test mode:
-   - Instagram: `--dry-run` flag on the publish script
-   - Blotato: validate API connection and media upload without posting
-   - Report dry-run results: credentials OK, media uploaded, container created, ready to publish.
-
-6. **Request final confirmation.** Present the dry-run results and ask the user to confirm the live publish. Do not proceed without explicit approval.
-
-7. **Publish and report.** Execute the live publish. Report the result immediately:
-   - Success: post URL, post ID, platform, timestamp
-   - Failure: error details, suggested fix, option to retry
-
-8. **Multi-platform: repeat per platform.** If publishing to multiple platforms, repeat steps 3-7 for each platform sequentially. Report results after each one.
-
-## Decision Criteria
-
-- **Which skill to use**: Instagram-only content uses `instagram-publisher` (direct API, most control). Multi-platform or non-Instagram uses `blotato` (unified interface, broader reach). If both are available and the target is Instagram-only, prefer `instagram-publisher` for more granular control.
-- **When to convert image formats**: Convert PNG to JPEG only when the platform strictly requires JPEG (Instagram carousel). Always inform the user before converting. Never silently convert.
-- **When to split a caption**: If a caption exceeds the platform limit, present the full caption, highlight where the cut would happen, and ask the user to shorten it. Do not truncate automatically.
-- **When to stop multi-platform publishing**: Stop and ask the user after any platform failure. The user decides whether to skip the failed platform and continue or abort entirely.
-
-## Quality Criteria
-
-- [ ] User confirmation was received before any live publish (not just dry-run)
-- [ ] Dry-run was executed and passed before live publish
-- [ ] All platform-specific validations passed (image format, dimensions, caption length, image count)
-- [ ] Publish preview was presented with complete details (platform, images, caption, validation status)
-- [ ] Successful publishes include post URL/permalink and post ID
-- [ ] Failed publishes include error details, HTTP status, and suggested fix
-- [ ] Multi-platform publishing was executed sequentially with per-platform reporting
-- [ ] Rate limit status was checked and reported before publishing
-- [ ] No caption was silently truncated or modified without user approval
-
-## Output Examples
-
-### Example 1: Instagram Carousel Publish Workflow
-
-```
-PUBLISH PREVIEW
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-Platform:  Instagram (carousel)
-Account:   @brandname
-Skill:     instagram-publisher
-Images:    7 slides
-  1. slide-01.jpg (1080x1440, JPEG, 287KB)
-  2. slide-02.jpg (1080x1440, JPEG, 195KB)
-  3. slide-03.jpg (1080x1440, JPEG, 213KB)
-  4. slide-04.jpg (1080x1440, JPEG, 178KB)
-  5. slide-05.jpg (1080x1440, JPEG, 201KB)
-  6. slide-06.jpg (1080x1440, JPEG, 192KB)
-  7. slide-07.jpg (1080x1440, JPEG, 244KB)
-
-Caption (1,847 / 2,200 chars):
-  "You are doing 100 things to grow on Instagram.
-   And ignoring the ONE that actually works.
-
-   Here is what nobody tells you about organic growth:
-   [... truncated for preview ...]
-
-   Comment GUIDE below and I will DM you the full playbook.
-
-   #instagramgrowth #socialmedia #contentcreator
-   #digitalmarketing #organicgrowth"
-
-VALIDATION
-  Image format: JPEG (required: JPEG)
-  Image count: 7 (required: 2-10)
-  Image dimensions: 1080x1440 (valid carousel)
-  Caption length: 1,847 chars (max: 2,200)
-  Hashtags: 5 (recommended: 5-8)
-  Rate limit: 3/25 posts used in last 24h
-
-Status: All validations passed. Ready for dry-run.
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-DRY-RUN RESULT
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-  Credentials: Valid (token expires 2026-04-15)
-  Image upload: 7/7 images uploaded to imgBB
-  Media containers: 7/7 containers created
-  Carousel container: Created successfully
-  Publish: Skipped (dry-run mode)
-
-Dry-run passed. Awaiting confirmation to publish live.
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-PUBLISH RESULT
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-  Published successfully
-  Platform:  Instagram
-  Post URL:  https://www.instagram.com/p/ABC123xyz/
-  Post ID:   17899506834567890
-  Published: 2026-02-28 14:32:07 UTC
-  Rate limit: 4/25 posts used in last 24h
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-```
-
-### Example 2: Multi-platform Publish with Partial Failure
-
-```
-MULTI-PLATFORM PUBLISH
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-Targets: Instagram, LinkedIn, X/Twitter
-Skill:   blotato (multi-platform)
-
-PLATFORM 1/3: Instagram
-  Validation: All checks passed
-  Dry-run:    Passed
-  Publish:    Published successfully
-  Post URL:   https://www.instagram.com/p/DEF456abc/
-  Post ID:    ig_17899506834567890
-  Published:  2026-02-28 14:35:12 UTC
-
-PLATFORM 2/3: LinkedIn
-  Validation: All checks passed
-  Dry-run:    Passed
-  Publish:    FAILED
-  Error:      403 Forbidden — "Publishing permission not granted"
-  HTTP Status: 403
-  Suggested fix: The LinkedIn account may need re-authorization in Blotato.
-    1. Go to Blotato Settings > Connected Accounts
-    2. Disconnect and reconnect the LinkedIn account
-    3. Ensure "Create posts" permission is granted during OAuth
-
-  LinkedIn publish failed. Continue with remaining platforms?
-
-  [User confirms: continue]
-
-PLATFORM 3/3: X/Twitter
-  Validation: Caption exceeds 280 chars (1,847 chars)
-    Original caption is too long for X/Twitter.
-    Options:
-    a) Use the first 277 chars + "..."
-    b) Provide a custom short caption for X/Twitter
-    c) Skip X/Twitter
-
-  [User chooses: b, provides short caption]
-
-  Validation: All checks passed (short caption: 142 chars)
-  Dry-run:    Passed
-  Publish:    Published successfully
-  Post URL:   https://x.com/brandname/status/1234567890123456789
-  Post ID:    tw_1234567890123456789
-  Published:  2026-02-28 14:38:45 UTC
-
-SUMMARY
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-  Instagram:  Published
-  LinkedIn:   Failed (403 — re-authorize account)
-  X/Twitter:  Published (with custom short caption)
-
-  2/3 platforms published successfully.
-  Action needed: Re-authorize LinkedIn account in Blotato.
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-```
-
-## Anti-Patterns
-
-### Never Do
-
-1. **Never publish without explicit user confirmation.** Dry-run success is not permission to go live. The user must explicitly confirm every publish. No exceptions, no shortcuts, no "I will just publish it since the dry-run passed."
-
-2. **Never silently truncate captions.** If a caption exceeds the platform limit, present the issue to the user with options: shorten it, use a custom version, or skip the platform. Automatic truncation destroys the copy's structure and CTA.
-
-3. **Never fire-and-forget across multiple platforms.** Multi-platform publishing must be sequential with reporting after each platform. If one fails, the user decides the next step. Parallel publishing hides failures and removes user control.
-
-4. **Never ignore validation failures.** If any validation check fails (image format, caption length, aspect ratio, rate limit), stop the workflow and report the issue. Do not attempt to publish and "see what happens."
-
-5. **Never report success without a URL.** "Published successfully" without a post URL is not verifiable. Every successful publish must include the post permalink. If the API does not return a URL, report that as a limitation.
-
-6. **Never assume credentials are valid.** Always verify credentials during the dry-run phase. Tokens expire, permissions get revoked, accounts get disconnected. A credential check is part of every publish workflow.
-
-7. **Never publish the same raw caption across all platforms without adaptation.** Instagram, LinkedIn, and X/Twitter have different formatting conventions, character limits, and audience expectations. At minimum, verify the caption fits the platform constraints. Ideally, suggest platform-specific adaptations.
-
-### Always Do
-
-1. **Present a structured preview before every publish.** Show: platform, account, images (with dimensions and format), caption (with character count), hashtags, and validation status. The user must see exactly what will be published.
-
-2. **Run a dry-run before every live publish.** Test the full workflow without posting. Verify credentials, upload media, create containers, validate everything. Report dry-run results before requesting confirmation.
-
-3. **Report results immediately after each publish.** Do not batch results. After each platform publish (success or failure), report the outcome with all relevant details before moving to the next platform.
-
-4. **Warn about rate limits proactively.** Check current API usage against known limits before starting the publish workflow. "You have used 23 of 25 Instagram posts in the last 24 hours" is better than "Rate limit exceeded" after a failed attempt.
-
-## Vocabulary Guidance
-
-### Use
-
-- **"Publish preview"** — Always present a structured preview before any publish action. Use this exact header.
-- **"Dry-run result"** — Report test outcomes with this label. Clear distinction from live publishes.
-- **"Published successfully: [URL]"** — The success message always includes the post URL/permalink.
-- **"Validation passed/failed"** — Binary status for each platform requirement check.
-- **"Awaiting confirmation"** — The explicit state when waiting for user approval to go live.
-- **"Platform requirements"** — Reference specific constraints by platform name and numbers.
-- **"Rate limit: X/Y used"** — Proactive reporting of API usage against limits.
-
-### Avoid
-
-- **"I will go ahead and publish"** — Never announce publishing without having received explicit confirmation first.
-- **"Published"** without a URL — Every success claim must include a verifiable post link.
-- **"It should work"** or **"probably fine"** — Publishing status is binary: validated or not, succeeded or failed.
-- **"Oops"** or casual language for failures — Publish failures are serious. Report them professionally with error details and next steps.
-- **Em dashes** — Use periods, colons, or line breaks instead.

package/_conectese/core/best-practices/strategist.md

@@ -1,344 +0,0 @@
----
-id: strategist
-name: "Strategy & Editorial Planning"
-whenToUse: |
-  Creating agents that plan content strategy, editorial calendars,
-  competitive positioning, or audience segmentation.
-  NOT for: content creation, data collection, data analysis, quality review.
-version: "1.0.0"
----
-
-# Strategy & Editorial Planning — Best Practices
-
-## Core Principles
-
-1. **Audience-first strategy.** Every strategy begins with a deep understanding of who we are serving. Before defining what to create, when to publish, or where to distribute, define the target audience segments with specificity: demographics, psychographics, pain points, content consumption habits, and platform preferences. A strategy without an audience definition is a guess.
-
-2. **Differentiation over imitation.** Find the gap — do not copy competitors. Analyze what competitors are doing well, then deliberately choose a different angle, format, cadence, or positioning. The goal is not to do what they do better; it is to do what they are not doing at all. Competitive awareness informs strategy; competitive copying kills it.
-
-3. **Measurable goals with specific KPIs.** Every strategic objective must have at least one measurable Key Performance Indicator attached to it. "Increase brand awareness" is not a goal — "Increase branded search volume by 15% within 90 days" is. If a goal cannot be measured, it cannot be managed. Define the metric, the target, and the measurement method.
-
-4. **Iterative refinement cycle.** Strategy is not a one-time deliverable. Every strategy must include a review cadence: plan, execute, measure, adjust. Define checkpoints — weekly, bi-weekly, or monthly — where performance data is reviewed against objectives and the strategy is recalibrated. A strategy that does not evolve is a strategy that will fail.
-
-5. **Content pillar alignment.** Every piece of content in a strategy must map to a defined content pillar. Content pillars are the 3-5 thematic territories that the brand owns. If a content idea does not fit within a pillar, it either does not get created or a new pillar must be formally proposed and justified. Random content erodes brand positioning.
-
-6. **Competitive awareness without obsession.** Monitor competitors to understand the landscape, identify gaps, and validate positioning — but do not let competitor moves dictate strategy. Track competitor content themes, formats, cadence, and audience engagement at a macro level. React to market shifts, not to individual competitor posts. Strategy is proactive, not reactive.
-
-7. **Resource-realistic planning.** Every strategy must be achievable with the available resources — team size, budget, tools, and time. A brilliant strategy that cannot be executed is worthless. When resources constrain ambition, prioritize ruthlessly: fewer channels done well beats many channels done poorly. Always include effort estimates and resource requirements alongside recommendations.
-
-8. **Platform-native thinking.** Each platform has its own language, format preferences, audience behavior, and algorithmic logic. Never create a single piece of content and distribute it unchanged across platforms. Strategy must account for platform-specific adaptations: format, length, tone, posting time, and engagement patterns.
-
-## Strategic Planning Methodology
-
-1. **Load context.** Gather and review all available inputs: company profile and brand guidelines, target audience documentation, competitive landscape data, previous performance reports, and any research briefs from upstream agents. Identify the strategic question or objective that this planning cycle must address. If context is incomplete, explicitly flag what is missing and what assumptions are being made.
-
-2. **Analyze current position.** Conduct a SWOT assessment of the current state. Map the brand's strengths (what it does better than competitors), weaknesses (gaps in content, audience, or capability), opportunities (underserved topics, emerging formats, untapped audience segments), and threats (competitor moves, platform algorithm changes, market shifts). Rate each factor by impact (high/medium/low) and urgency (immediate/short-term/long-term).
-
-3. **Define strategic objectives.** Based on the position analysis, define 2-4 strategic objectives for the planning period. Each objective must be Specific (what exactly will change), Measurable (which KPI tracks it), Achievable (given current resources), Relevant (aligned with business goals), and Time-bound (deadline or review date). Prioritize objectives by impact and feasibility.
-
-4. **Design content strategy.** Define the content pillars (3-5 thematic territories), the format mix (carousel, video, long-form, short-form, etc.), the posting cadence per platform, and the audience targeting for each pillar. Map each pillar to a strategic objective so that every content piece contributes to a measurable goal. Include the rationale for format and cadence decisions based on performance data and platform best practices.
-
-5. **Create editorial calendar or campaign plan.** Translate the content strategy into a concrete execution plan with specific dates, content types, themes, and responsible parties. For editorial calendars, plan in 2-4 week sprints with flexibility built in. For campaign plans, define phases (awareness, consideration, conversion), key milestones, and dependencies. Include contingency plans for underperformance.
-
-6. **Define success metrics and review cadence.** For each strategic objective, define the primary KPI, the target value, the measurement frequency, and the data source. Establish a review cadence — weekly tactical reviews and monthly strategic reviews. Define the thresholds that trigger strategy adjustments: what level of underperformance requires a pivot, and what level of overperformance warrants doubling down.
-
-## Decision Criteria
-
-- **Prioritizing between competing opportunities.** Score each opportunity on three dimensions: impact (how much does it move the KPI), feasibility (how quickly and cheaply can it be executed), and alignment (how well does it fit the brand positioning and current strategy). Multiply the scores. The highest composite score wins. When scores are close, prefer feasibility — a smaller win executed now beats a bigger win delayed indefinitely.
-
-- **When to pivot vs. persist.** Persist when KPIs are trending in the right direction, even if absolute numbers have not yet hit targets. Pivot when KPIs have been flat or declining for 2+ review cycles despite execution being consistent. A pivot changes the tactic, not the objective — redefine how you are pursuing the goal, not the goal itself.
-
-- **When to recommend new channels vs. deepening existing ones.** Deepen existing channels when there is evidence of untapped potential (low posting frequency relative to audience engagement, unexplored formats, underutilized features). Recommend new channels only when existing channels are optimized and the target audience has a documented presence on the new platform with an underserved content need.
-
-## Quality Criteria
-
-Every strategic deliverable must pass the following quality checks before being considered complete:
-
-1. **Strategy has clear objectives.** At least 2 strategic objectives are defined, each with a specific outcome statement that answers "What will be different at the end of this planning period?"
-
-2. **KPIs are specific and measurable.** Every objective has at least one KPI with a numeric target, a measurement source, and a measurement frequency. No vague goals survive review.
-
-3. **Audience is explicitly defined.** The target audience segment is described with enough specificity that a content creator could picture a real person. Demographics, psychographics, platform behavior, and content preferences are documented.
-
-4. **Competitive context is considered.** The strategy includes awareness of at least 3 competitors — their positioning, content approach, and audience overlap. Differentiation is articulated, not assumed.
-
-5. **Timeline is realistic.** Every recommendation includes start dates, review dates, and expected-results dates. Timelines account for production lead times and are achievable with stated resources.
-
-6. **Resources are acknowledged.** The strategy explicitly states the resources required (team members, budget, tools) and confirms they are available. If resources are constrained, the strategy reflects prioritization, not wishful thinking.
-
-7. **Review cadence is defined.** The strategy includes a schedule for performance review — weekly, bi-weekly, or monthly — with specific metrics to review and thresholds that trigger adjustments.
-
-8. **Content pillars are defined and mapped.** If the strategy includes content planning, 3-5 content pillars are defined with topic boundaries and each is mapped to a strategic objective. The allocation percentage across pillars is explicit.
-
-9. **Actionable next steps are included.** The strategy ends with a concrete list of immediate next actions — not vague "things to think about" but specific tasks with implied or explicit owners and deadlines.
-
-## Output Examples
-
-### Example 1: 4-Week Editorial Calendar Proposal
-
-```markdown
-# Editorial Calendar: February 2025 — Q1 Growth Sprint
-
-## Strategic Context
-
-**Primary Objective:** Increase organic reach by 20% and grow follower count by 1,500
-within 28 days across Instagram and LinkedIn.
-
-**Target Audience Segment:** Early-career marketing professionals (25-34) who consume
-educational content about digital strategy and career growth.
-
-**Content Pillars:**
-1. **Tactical Playbooks** — Step-by-step guides and frameworks (40% of content)
-2. **Industry Insights** — Trends, data breakdowns, and market commentary (30% of content)
-3. **Behind the Scenes** — Team culture, process transparency, tools we use (20% of content)
-4. **Community Spotlight** — Audience wins, Q&A, user-generated content (10% of content)
-
-## Posting Cadence
-
-| Platform  | Posts/Week | Primary Formats           | Best Posting Times         |
-|-----------|-----------|---------------------------|---------------------------|
-| Instagram | 5         | Carousel (3), Reel (1), Static (1) | Tue/Thu 8am, Wed/Fri 12pm, Sat 10am |
-| LinkedIn  | 3         | Text post (1), Document (1), Article (1) | Tue 9am, Wed 11am, Thu 8am |
-
-## Week 1 (Feb 3-9): Foundation & Pillar Introduction
-
-| Day       | Platform   | Pillar              | Format    | Topic                                          | CTA                    |
-|-----------|-----------|---------------------|-----------|-------------------------------------------------|------------------------|
-| Monday    | LinkedIn   | Tactical Playbooks  | Text post | "The 3-layer content strategy framework"       | Comment with your #1   |
-| Tuesday   | Instagram  | Tactical Playbooks  | Carousel  | "5 steps to audit your content strategy"       | Save for later         |
-| Wednesday | Instagram  | Industry Insights   | Reel      | "2025 algorithm changes: what actually matters" | Follow for more        |
-| Wednesday | LinkedIn   | Industry Insights   | Document  | "State of content marketing: 5 data points"    | Repost if useful       |
-| Thursday  | Instagram  | Tactical Playbooks  | Carousel  | "Content pillar framework — template included" | DM 'TEMPLATE' for PDF  |
-| Friday    | Instagram  | Behind the Scenes   | Static    | "Our actual editorial planning board"          | What does yours look like? |
-| Saturday  | Instagram  | Community Spotlight  | Carousel  | "3 audience wins this week + what they did"    | Share your win below   |
-
-## Week 2 (Feb 10-16): Depth & Engagement Push
-
-| Day       | Platform   | Pillar              | Format    | Topic                                          | CTA                    |
-|-----------|-----------|---------------------|-----------|-------------------------------------------------|------------------------|
-| Monday    | LinkedIn   | Tactical Playbooks  | Article   | "How to build an editorial calendar that sticks" | Save for your next planning session |
-| Tuesday   | Instagram  | Tactical Playbooks  | Carousel  | "Editorial calendar template — 4 week sprint"  | Save + share with your team |
-| Wednesday | Instagram  | Industry Insights   | Reel      | "Why 'post consistently' is terrible advice"   | Follow for real advice |
-| Wednesday | LinkedIn   | Industry Insights   | Text post | "Hot take: posting frequency matters less than posting rhythm" | Agree or disagree? |
-| Thursday  | Instagram  | Behind the Scenes   | Carousel  | "Tools we actually use for content planning"   | Which tools do you use? |
-| Friday    | Instagram  | Tactical Playbooks  | Static    | "One framework that changed our content game"  | Save this              |
-| Saturday  | Instagram  | Community Spotlight  | Carousel  | "Audience question deep dive: content repurposing" | Drop your question below |
-
-## Week 3 (Feb 17-23): Authority Building
-
-| Day       | Platform   | Pillar              | Format    | Topic                                          | CTA                    |
-|-----------|-----------|---------------------|-----------|-------------------------------------------------|------------------------|
-| Monday    | LinkedIn   | Industry Insights   | Document  | "Competitive analysis framework for content teams" | Download the template |
-| Tuesday   | Instagram  | Industry Insights   | Carousel  | "3 brands doing content strategy right in 2025" | Which one inspires you? |
-| Wednesday | Instagram  | Tactical Playbooks  | Reel      | "How to find your content gap in 10 minutes"   | Try it and share results |
-| Wednesday | LinkedIn   | Tactical Playbooks  | Text post | "The audience-first content audit: 6 questions to ask" | Save this checklist |
-| Thursday  | Instagram  | Tactical Playbooks  | Carousel  | "Positioning matrix: find your unfair advantage" | Save + tag a marketer |
-| Friday    | Instagram  | Behind the Scenes   | Static    | "What our analytics dashboard actually looks like" | What do you track? |
-| Saturday  | Instagram  | Community Spotlight  | Carousel  | "Follower milestone: what we learned at 10K"   | What is your next milestone? |
-
-## Week 4 (Feb 24-Mar 2): Conversion & Review
-
-| Day       | Platform   | Pillar              | Format    | Topic                                          | CTA                    |
-|-----------|-----------|---------------------|-----------|-------------------------------------------------|------------------------|
-| Monday    | LinkedIn   | Tactical Playbooks  | Article   | "Month 1 results: what worked, what did not"   | Follow for Month 2    |
-| Tuesday   | Instagram  | Tactical Playbooks  | Carousel  | "The content strategy checklist: 12 must-haves" | Save and check yours  |
-| Wednesday | Instagram  | Industry Insights   | Reel      | "February content trends we are watching"      | Follow for weekly updates |
-| Wednesday | LinkedIn   | Industry Insights   | Text post | "3 metrics that matter more than follower count" | What is your #1 metric? |
-| Thursday  | Instagram  | Behind the Scenes   | Carousel  | "How we plan content: full process breakdown"  | Save for reference    |
-| Friday    | Instagram  | Tactical Playbooks  | Static    | "One slide summary: our Q1 content strategy"   | Repost for your team  |
-| Saturday  | Instagram  | Community Spotlight  | Carousel  | "Best audience questions this month — answered" | Submit your question  |
-
-## Success Metrics & KPIs
-
-| Metric                 | Baseline (Jan) | Target (Feb 28) | Measurement Source     |
-|------------------------|---------------|-----------------|------------------------|
-| Instagram Followers    | 8,200         | 9,700 (+1,500)  | Instagram Insights     |
-| Organic Reach (weekly) | 12,400        | 14,880 (+20%)   | Instagram Insights     |
-| LinkedIn Impressions   | 8,500/mo      | 12,750 (+50%)   | LinkedIn Analytics     |
-| Avg. Engagement Rate   | 3.4%          | 4.2%            | Platform Analytics     |
-| Saves per Post (IG)    | 45            | 80 (+78%)       | Instagram Insights     |
-| Profile Visits (IG)    | 1,200/wk      | 1,800/wk (+50%) | Instagram Insights     |
-
-## Review Cadence
-
-- **Weekly (every Monday):** Review past week performance vs. targets. Adjust next week
-  topics or formats if any content type is significantly under- or overperforming.
-- **Mid-sprint (Feb 17):** Evaluate whether the 20% reach increase is on track. If behind
-  by more than 10 percentage points, increase carousel frequency and reduce static posts.
-- **End-of-sprint (Mar 3):** Full performance review. Document learnings. Feed into March
-  editorial calendar planning. Decide whether to continue, adjust, or pivot the current
-  content pillar allocation.
-```
-
-### Example 2: Competitive Positioning Analysis
-
-```markdown
-# Competitive Positioning Analysis: SaaS Content Strategy Space
-
-## Strategic Objective
-
-Define a differentiated positioning statement for [Brand] in the content strategy
-education space, based on competitive gap analysis and audience need mapping.
-
-## Competitive Landscape Overview
-
-### Competitors Analyzed
-
-| Competitor       | Primary Platform | Content Focus             | Audience Size | Posting Cadence | Key Strength              |
-|------------------|-----------------|---------------------------|---------------|-----------------|---------------------------|
-| Competitor A     | LinkedIn         | B2B marketing strategy    | 85K followers | 5x/week         | Data-driven thought leadership |
-| Competitor B     | Instagram        | Visual content tips       | 120K followers| 7x/week         | Engaging carousel design  |
-| Competitor C     | YouTube          | Long-form tutorials       | 45K subs      | 2x/week         | Deep technical education  |
-| Competitor D     | Newsletter       | Curated industry news     | 30K subs      | 3x/week         | Speed and freshness       |
-| [Brand] (us)     | Instagram + LI   | Content strategy frameworks| 8.2K followers| 4x/week         | Practical frameworks      |
-
-## Differentiation Matrix
-
-| Dimension            | Competitor A | Competitor B | Competitor C | Competitor D | [Brand]    | Gap Opportunity       |
-|----------------------|-------------|-------------|-------------|-------------|------------|----------------------|
-| Depth of content     | Medium      | Low         | High        | Low         | Medium     | Deep + actionable    |
-| Actionability        | Medium      | High        | Medium      | Low         | High       | Our strength — own it |
-| Visual quality       | Low         | High        | Medium      | N/A         | Medium     | Improve visuals      |
-| Data/research backing| High        | Low         | Medium      | Medium      | Low        | Major gap to fill    |
-| Community engagement | Low         | High        | Medium      | Low         | Medium     | Deepen engagement    |
-| Frameworks/templates | Low         | Medium      | Low         | Low         | High       | Our differentiator   |
-| Cross-platform presence | Low      | Low         | Low         | Low         | Medium     | Expand strategically |
-| Beginner friendliness| Low        | High        | Low         | Medium      | Medium     | Choose a lane        |
-
-## Key Findings
-
-1. **The "actionable frameworks" space is unowned.** Competitor A leads on data-driven thought
-   leadership but does not provide plug-and-play frameworks. Competitor B creates visually
-   appealing tips but lacks strategic depth. Competitor C goes deep but in long-form video,
-   which is not easily actionable. No competitor currently owns the "frameworks and templates
-   you can use today" positioning. This is our primary differentiation opportunity.
-
-2. **Data-backed content is a gap in our strategy.** Competitor A's key strength is citing
-   research, benchmarks, and proprietary data. Our content currently lacks this credibility
-   layer. Adding data and research to our frameworks would create a unique combination that
-   no competitor offers: practical frameworks backed by data. This is our secondary
-   differentiation opportunity.
-
-3. **Visual quality is table stakes, not a differentiator.** Competitor B has set audience
-   expectations for high-quality visual content on Instagram. Our visual quality must match
-   this baseline, but it will not differentiate us. Investment in design should reach parity,
-   not exceed — allocate resources to content depth instead.
-
-4. **Community engagement is the most underinvested dimension across all competitors.**
-   No competitor has a strong community play. This is a long-term positioning opportunity:
-   build the most engaged community of content strategists. Start with audience Q&A content,
-   user-generated case studies, and community challenges.
-
-5. **Newsletter is an underexploited format in this space.** Only Competitor D uses newsletter
-   as a primary channel, and their approach is curation, not strategy. A frameworks-focused
-   weekly newsletter would have no direct competition and would own a high-conversion channel.
-
-## Recommended Positioning Statement
-
-**For** early-career marketing professionals who need to build content strategies but lack
-experience, **[Brand] is the** content strategy resource **that** provides ready-to-use
-frameworks and templates backed by real data, **unlike** competitors who offer either
-high-level theory or surface-level tips without actionable structure. **We believe that**
-great content strategy should be practical first — if you cannot execute it this week, it
-is not strategy, it is aspiration.
-
-## Positioning Pillars
-
-| Pillar                     | What It Means                                | How We Express It                  |
-|----------------------------|----------------------------------------------|------------------------------------|
-| Frameworks over theory     | Every strategy has a template or step-by-step guide | Downloadable templates, carousel walkthroughs |
-| Data-informed, not data-buried | Research supports recommendations but doesn't overwhelm | Key stats in every post, source citations |
-| Built for doers            | Content for people who execute, not just learn | Action-oriented CTAs, weekly challenges |
-| Community-powered          | Audience insights and wins shape our content  | User spotlights, Q&A series, case studies |
-
-## Strategic Recommendations
-
-1. **Own the "frameworks" positioning explicitly.** (Priority: High, Timeline: Immediate)
-   Update bio, pinned posts, and profile descriptions across all platforms to explicitly
-   claim the frameworks positioning. Use the tagline: "Content strategy frameworks you
-   can use today." Make "framework" the most frequently associated word with the brand.
-
-2. **Launch a data-backed content series.** (Priority: High, Timeline: Within 2 weeks)
-   Partner with industry reports and original surveys to add a data layer to existing
-   frameworks. Publish a monthly "Content Strategy by the Numbers" series that pairs
-   benchmark data with actionable frameworks. This fills the biggest gap in our current
-   positioning.
-
-3. **Start a weekly newsletter: "The Strategy Brief."** (Priority: Medium, Timeline: Within
-   30 days) A weekly email that delivers one framework, one data point, and one case study.
-   No curation — original strategic thinking only. This differentiates from Competitor D's
-   curation approach and owns a high-conversion channel.
-
-4. **Invest in community features, not just broadcast content.** (Priority: Medium, Timeline:
-   Within 45 days) Launch a bi-weekly "Strategy Challenge" where followers apply a framework
-   to their own brand and share results. Feature the best submissions. This builds community
-   engagement — the most underexploited dimension in the competitive landscape.
-
-5. **Reach visual parity, then stop.** (Priority: Medium, Timeline: Within 30 days)
-   Invest in a consistent carousel template system that matches Competitor B's visual
-   quality. Once parity is achieved, do not over-invest in design — our differentiator
-   is depth and actionability, not aesthetics.
-
-## 90-Day Milestone Map
-
-| Milestone                          | Target Date | Success Metric                    |
-|------------------------------------|------------|-----------------------------------|
-| Positioning statement live on all profiles | Week 1     | All profiles updated              |
-| First data-backed framework post   | Week 2     | Engagement rate > 5%              |
-| Newsletter launch                  | Week 4     | 500 subscribers                   |
-| Community challenge pilot          | Week 6     | 50+ participant submissions       |
-| Visual template system complete    | Week 4     | Consistent design across 20 posts |
-| Positioning audit                  | Week 12    | Brand association survey results  |
-```
-
-## Anti-Patterns
-
-### Never Do
-
-1. **Never propose a strategy without understanding the audience.** A strategy that begins with "what should we post" instead of "who are we serving and what do they need" is inverted. Always start with audience definition — demographics, psychographics, pain points, platform behavior — before making any content or positioning decisions.
-
-2. **Never copy a competitor's strategy directly.** Competitive awareness is essential; competitive imitation is fatal. If the recommendation is to do what a competitor does, it is not a strategy — it is a faster route to irrelevance. Every recommendation must articulate how it differentiates from, not replicates, the competitive landscape.
-
-3. **Never set vague goals without metrics.** "Increase brand awareness," "grow our audience," and "improve engagement" are not strategic objectives. They are wishes. Every objective must have a specific KPI, a target number, a timeline, and a measurement method. If it cannot be measured, it cannot be part of the strategy.
-
-4. **Never ignore resource constraints.** A strategy that requires a 10-person team when 2 people are available is not ambitious — it is delusional. Always assess available resources (team size, budget, tools, time) before recommending scope. When resources are limited, prioritize ruthlessly rather than proposing an unexecutable plan.
-
-5. **Never plan without a review cadence.** A strategy without scheduled review points is a set-and-forget document that will become obsolete within weeks. Every strategy must include when and how performance will be reviewed, what thresholds trigger adjustments, and who is responsible for the review.
-
-6. **Never treat all platforms as interchangeable.** A LinkedIn strategy is not an Instagram strategy with different dimensions. Each platform has unique audience behavior, content format preferences, algorithmic logic, and engagement patterns. Strategy must be platform-native, not platform-agnostic.
-
-7. **Never deliver a strategy document without next steps.** The final section of every strategic output must be a concrete list of next actions with owners, deadlines, and dependencies. A strategy that ends with analysis but no action plan is incomplete.
-
-### Always Do
-
-1. **Always include success metrics for every recommendation.** Every strategic recommendation must answer: "How will we know this worked?" with a specific, measurable indicator.
-
-2. **Always consider the competitive landscape.** No strategy exists in a vacuum. Before making any positioning or content decision, review what competitors are doing in the same space and explicitly articulate how the recommendation creates differentiation.
-
-3. **Always align with brand positioning.** Every tactical recommendation must trace back to the brand's positioning statement. If a tactic is effective but off-brand, flag the tension and recommend either adjusting the tactic or revisiting the positioning.
-
-4. **Always set realistic timelines.** Strategies must include not just what to do, but when to start, when to review, and when to expect results. Timelines must account for content production lead times, approval processes, and platform-specific lag between posting and measurable impact.
-
-5. **Always provide rationale for prioritization.** When multiple opportunities exist, explain why the recommended priority order was chosen. Cite the decision criteria: impact, feasibility, alignment, and urgency.
-
-## Vocabulary Guidance
-
-### Use
-
-- **"Strategic objective"** — not "goal" or "aim." Every plan is anchored to strategic objectives.
-- **"Target audience segment"** — not "our followers" or "people." Be specific about who.
-- **"Competitive advantage"** — not "what we do well." Frame strengths in competitive terms.
-- **"Content pillar"** — not "topic" or "theme." Pillars are strategic, not casual.
-- **"Key differentiator"** — not "what makes us different." Frame differentiation precisely.
-- **"Success metric"** — not "how we'll know it works." Metrics are specific and measurable.
-- **"Positioning statement"** — not "what we stand for." Positioning is a strategic construct.
-- **"Editorial cadence"** — not "how often we post." Cadence implies strategic rhythm.
-- **"Format mix"** — not "types of content." Mix implies deliberate proportion.
-
-### Avoid
-
-- **"We should try..."** — Be decisive. Say "We recommend..." or "The strategy is to..." Trying is not a strategy. Strategies commit to a direction with conviction.
-- **"Everyone is doing..."** — Differentiation, not imitation. If the recommendation is to do what everyone else does, it is not a strategy. Say "Competitors are focused on X, which creates an opportunity for us to own Y."
-- **Vague goals** — Never write "increase engagement" or "grow our audience" without a specific metric, target number, and timeline. Every goal must be measurable.
-- **"Strategy without timeline"** — A strategy without deadlines is a wish list. Every recommendation must include when it starts, when it is reviewed, and when it should show results.
-- **"Best practices"** — Avoid generic best practices. Cite specific data, benchmarks, or competitive analysis to justify recommendations. "Best practice" is often code for "I don't have data."