feat: buffer-squad — single-agent Buffer scheduling via @bufferapp/cli - #32
Open
0xthc wants to merge 1 commit into
Open
feat: buffer-squad — single-agent Buffer scheduling via @bufferapp/cli#320xthc wants to merge 1 commit into
0xthc wants to merge 1 commit into
Conversation
…icial Buffer CLI Deploys Buffer-agent: a focused operator that drives a Buffer account through @bufferapp/cli authenticated by BUFFER_API_KEY. Eleven skills cover the full loop — CLI surface (commands + enums + IDs + safe-publish), per-channel Tone Profile extraction (the gate before any drafting), channel discovery, strategy & goals (≤3 outcomes, 3–5 pillars as Buffer tags), per-service playbooks, cadence + posting-limit discipline, post drafter, evening queue audit, weekly output report, ideas capture, and an engagement-advisory honesty layer for the parts of social ops Buffer's API does not expose (no analytics, no comments, no DMs). Crons: evening queue audit (17:00 PT daily) + weekly output report (Mon 09:00 PT). Vault: team.buffer_api_key. Tools: vault, cron, image-generation, web_search, web_fetch. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
There was a problem hiding this comment.
Pull request overview
This PR introduces a new deployable squad bundle, buffer-squad@0.3.0, that adds a single dedicated agent (buffer-agent) for social media scheduling through the official @bufferapp/cli, including onboarding guidance, two scheduled crons, and a set of operational skills (tone profiling, drafting, queue audits, weekly reporting, ideas capture) with an explicit “no analytics via Buffer” boundary.
Changes:
- Adds the
buffer-squadbundle scaffolding (manifest, docs, memory index) and thebuffer-agentdefinition (identity/soul/memory). - Adds two cron jobs (evening queue audit + weekly output report) targeting
buffer-agent. - Adds 11 Buffer-focused skills covering CLI usage, discovery, tone profiling, drafting/scheduling with
--dry-run, audits/reports, and engagement/analytics scope boundaries.
Reviewed changes
Copilot reviewed 20 out of 20 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
| squads/buffer-squad/SQUAD.md | User-facing squad description and scope boundaries. |
| squads/buffer-squad/ONBOARD.md | Step-by-step onboarding runbook for the co-founder. |
| squads/buffer-squad/MEMORY.md | Squad-level memory/index pointers and filing conventions. |
| squads/buffer-squad/manifest.json | Bundle metadata + required vault secret + tool permissions. |
| squads/buffer-squad/crons/jobs.json | Two scheduled jobs targeting buffer-agent with detailed payload instructions. |
| squads/buffer-squad/agents/buffer-agent/agent.json | Declares the buffer-agent and its loaded skills. |
| squads/buffer-squad/agents/buffer-agent/IDENTITY.md | Agent role, scope, and operating constraints. |
| squads/buffer-squad/agents/buffer-agent/SOUL.md | Agent behavioral rules, boundaries, escalation policy, and output discipline. |
| squads/buffer-squad/agents/buffer-agent/MEMORY.md | Agent-specific memory template for channels/pillars/cadence/tone-profile pointers. |
| squads/buffer-squad/agents/buffer-agent/skills/buffer-cli-toolkit.md | Reference for installing/authing/operating the Buffer CLI safely. |
| squads/buffer-squad/agents/buffer-agent/skills/buffer-channel-discovery.md | Procedure for org/channel/tag discovery and MEMORY stamping. |
| squads/buffer-squad/agents/buffer-agent/skills/buffer-channel-tone-extraction.md | Procedure to build per-channel Tone Profiles from recent sent posts. |
| squads/buffer-squad/agents/buffer-agent/skills/buffer-strategy-and-goals.md | Procedure to define goals/pillars/cadence and map pillars to Buffer tags. |
| squads/buffer-squad/agents/buffer-agent/skills/buffer-platform-playbooks.md | Service-specific PostType/metadata/publishing-mode guidance. |
| squads/buffer-squad/agents/buffer-agent/skills/buffer-cadence-and-timing.md | Scheduling mode/timing guidance plus limit-check discipline. |
| squads/buffer-squad/agents/buffer-agent/skills/buffer-post-drafter.md | End-to-end drafting/scheduling workflow with Tone Profile + --dry-run gating. |
| squads/buffer-squad/agents/buffer-agent/skills/buffer-queue-health.md | Evening queue-depth audit procedure and gap-filling workflow. |
| squads/buffer-squad/agents/buffer-agent/skills/buffer-weekly-audit.md | Weekly output report procedure (volume/pillars/errors/tone drift/queue health). |
| squads/buffer-squad/agents/buffer-agent/skills/buffer-ideas-capture.md | Procedure to capture angles into Buffer Ideas + local wiki audit trail. |
| squads/buffer-squad/agents/buffer-agent/skills/buffer-engagement-advisory.md | Honest redirect for engagement/analytics asks + what the agent can do instead. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
|
|
||
| Required only for `--mode customScheduled`. ISO 8601, timezone-aware (e.g. `2026-06-10T09:00:00-07:00`). Rules: | ||
|
|
||
| - Minimum: `now() + 60 seconds`. Buffer rejects schedules in the past. |
Comment on lines
+90
to
+98
| | Service | Reference best time | Best post type | Reference engagement rate | | ||
| |---|---|---|---| | ||
| | Facebook | ~5 a.m. Mondays | Picture | ~3.6% | | ||
| | Instagram | ~3 p.m. Fridays | Reels (reach) | ~4.3% | | ||
| | TikTok | ~8 p.m. Sundays | Video | ~4.86% | | ||
| | X / Twitter | ~9 a.m. Wednesdays | Text | ~2.15% | | ||
| | LinkedIn | ~11 a.m. Thursdays | Carousel / PDF | ~6.5% | | ||
|
|
||
| These rates are **measured outside Buffer**. Buffer-agent cannot verify or report them. The user (or the monthly review) folds in native-analytics numbers; we only choose the schedule. |
Contributor
🤖 Triage Assessment — P3 (Low Priority)Classification: New squad feature, deferred This PR introduces Rationale for P3: This is a net-new capability addition with no blocking urgency. The test plan is reasonable but requires a live Buffer account for validation. No existing squad bundles are modified. Merge when the test plan is cleared on a real pod. Action items:
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
buffer-squad@0.3.0— single-agent social media scheduling that drives a Buffer account through the official@bufferapp/cli, authenticated byBUFFER_API_KEYfrom the vault.--dry-runmandatory), evening queue audit, weekly output report, ideas capture, and an engagement-advisory honesty layer for what Buffer's API does not expose.What you'll need
publish.buffer.com/settings/api→ vaultteam.buffer_api_keynpm install -g @bufferapp/cli)Test plan
node scripts/validate.mjs squads/buffer-squadexits 0 (verified locally)wiki/Knowledge/Buffer/ToneProfiles/agent_idisbuffer-agent--dry-runprecedes anybuffer posts create🤖 Generated with Claude Code