feat: buffer-squad — single-agent Buffer scheduling via @bufferapp/cli

[0xthc]

Summary

• New squad buffer-squad@0.3.0 — single-agent social media scheduling that drives a Buffer account through the official @bufferapp/cli, authenticated by BUFFER_API_KEY from the vault.
• Eleven skills covering the full loop: CLI surface reference (commands + enums + IDs + safe-publish), per-channel Tone Profile extraction (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 (--dry-run mandatory), evening queue audit, weekly output report, ideas capture, and an engagement-advisory honesty layer for what Buffer's API does not expose.
• Crons: evening queue audit (17:00 PT daily) + weekly output report (Mon 09:00 PT).
• Honest scope: Buffer's API has no analytics / engagement / impressions / follower / comment / DM surface. Buffer-agent reports volume, consistency, pillar mix, errors, and tone drift — and redirects to native analytics for the rest. It does not invent metrics.

What you'll need

• Buffer account with channels connected
• API token from publish.buffer.com/settings/api → vault team.buffer_api_key
• Node.js 18+ in the pod (CLI installs via npm install -g @bufferapp/cli)

Test plan

• node scripts/validate.mjs squads/buffer-squad exits 0 (verified locally)
• Install the squad on a test pod and run onboarding through Step 4 (channel discovery)
• Verify Tone Profile generation produces one file per connected channel under wiki/Knowledge/Buffer/ToneProfiles/
• Dispatch a baseline audit and confirm the spawned session's agent_id is buffer-agent
• Trigger the evening queue audit cron manually and confirm --dry-run precedes any buffer posts create
• Confirm the weekly output report does not surface engagement / impression numbers
• Smoke-test an on-demand drafting brief ("draft 2 LinkedIn posts about X") end to end

🤖 Generated with Claude Code

[Copilot]

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-squad bundle scaffolding (manifest, docs, memory index) and the buffer-agent definition (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.