PowerAdvice × Black Flag Design

Howard onboarding

Howard, start here.

Repo access gets you into the work. Linear tells you what matters. UAT is where we prove it.

Repo Linear UAT

Issue

One job, one worklog.

Put the PR, preview, screenshots, checks, decisions, and blockers on the issue.

Project

Stay in LS APP.

PowerAdvice launch work is in LONG, under the current launch, content, redirects, and analytics projects.

Ask

Tag Keith early.

If your agent needs a maintainer action, tag @Keith with the exact command, error, and next decision.

Install Linear MCP and Slack MCP. Your agents should read tickets, post progress, and push clean blockers back to the team.

Your first tickets

Start with proof, then pick up launch work.

LONG-1159 Prove the agent workflow clone, setup, checks, branch, PR path LONG-1093 Lock the article corpus content list, gaps, sign-off notes LONG-1113 Redirect map sign-off legacy URL review and mismatches LONG-1140 Channel and SEO direction where content should land LONG-1032 Final launch inputs last decisions before rollout LONG-1010 Analytics and reporting Pirate Metrics into proof

Environments

Use the lowest-risk place that proves the point.

Local No secrets lane

Setup, lint, tests, docs, UI work, optional anonymous local Convex.

UAT First shared proof

Hosted CMS, UAT data, UAT MCP, PR confidence before staging.

Staging Readiness review

Production-like checks after UAT. Use only when the ticket says staging.

Production Maintainers only

No production deploys, secrets, Cloudflare, or Convex dashboard work.

Three ways to work

Pick the route your ticket needs.

1

Hosted UAT CMS

Best for login, content state, and MCP setup.

Open UAT CMS
2

Local frontend + UAT

Best for UI PRs against real UAT data. Uses public browser env, not secret keys.

npm run dev
3

No-secrets local proof

Best for cold start and PR confidence. Run check:external before opening a PR.

npm run contributor:setup

MCP setup

Give your agents the right tools.

Project work

Linear MCP

Read assigned tickets, post worklogs, tag Keith, and keep blocker status out in the open.

Coordination

Slack MCP

Use the workstream or DM context for quick handoffs, then move decisions back to Linear.

CMS

PowerAdvice MCP

Open CMS, click MCP setup, choose UAT or Staging, then copy OAuth config or generate a personal token.

https://cms-mcp-uat.poweradvice.com/mcp https://cms-mcp-staging.poweradvice.com/mcp

What good looks like

Every pass ends in proof.

PR

Branch from origin/uat, include the Linear ID, open the PR into uat.

Preview

Use the PR preview for unmerged UI work. Do not use staging as a preview substitute.

Agent

Hermes/Codex, DeepSeek, and Claude Code are fine. The output is PR plus Linear proof.

Boundary

No raw Clerk secrets, Convex deploy keys, Cloudflare tokens, or production authority.

Repo Howard route Agent flow Linear model CMS MCP