agentbrief 0.1.2 → 0.2.0

package/README.md

@@ -4,58 +4,32 @@
 [![npm](https://img.shields.io/npm/v/agentbrief)](https://www.npmjs.com/package/agentbrief)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)
 
-> Pluggable role definitions for AI coding agents.
+> One command turns your AI coding agent into a domain specialist.
 >
-> [Website](https://0xranx.github.io/agentbrief) · [Catalog](./CATALOG.md) · [npm](https://www.npmjs.com/package/agentbrief)
+> [Website](https://0xranx.github.io/agentbrief) · [Catalog](./CATALOG.md) · [npm](https://www.npmjs.com/package/agentbrief) · [中文](./README.zh-CN.md)
 
-One command turns your Claude Code / Cursor / OpenCode / Codex from a generic assistant into a specialized professional.
+Your Claude Code, Cursor, OpenCode, or Codex gives generic answers because it doesn't know your domain. AgentBrief fixes that — install a **brief** and your agent gains real expertise: security auditing, code review, product specs, growth hacking, and more.
 
 ```bash
-npx agentbrief use fullstack-dev
+npx agentbrief use fullstack-engineer
 # Your agent now enforces strict TypeScript, follows Next.js conventions,
-# builds accessible UIs, and reviews PRs like a staff engineer — 8 skills in 1 command
+# builds accessible UIs, and reviews PRs like a staff engineer — 9 skills in 1 command
 ```
 
-## What It Does
+## Before vs After
 
-AgentBrief compiles a **brief** (role definition + domain knowledge + executable skills) into the instruction files your AI agent reads — `CLAUDE.md`, `.cursorrules`, `AGENTS.md` — with content automatically adapted for each engine.
-
-<details>
-<summary><b>See it in action</b> — what happens when you run <code>agentbrief use fullstack-dev</code></summary>
-
-Your `CLAUDE.md` gets this injected (existing content preserved):
-
-```markdown
-<!-- agentbrief:fullstack-dev:start -->
-# AgentBrief: fullstack-dev
-
-## Role
-You are a senior full-stack TypeScript developer. You build production
-applications with Next.js 15, React 19, and Tailwind CSS. You enforce
-strict type safety and review your own code with principal-engineer rigor.
-
-## Constraints
-- Never use `any` — always annotate return types on exports
-- Server Components by default — only add 'use client' when needed
-- WCAG 2.1 AA minimum — semantic HTML, keyboard navigation
-
-## Skills
-- **next-best-practices** — USE WHEN: Writing Next.js code
-- **typescript-advanced-types** — USE WHEN: Complex type logic
-- **architecture-review** — USE WHEN: Reviewing PRs
-- **design-review-checklist** — USE WHEN: Checking UI quality
-- **agent-browser** — USE WHEN: Visual verification needed
-  ...and 4 more
-<!-- agentbrief:fullstack-dev:end -->
 ```
-
-Cleanly removable with `agentbrief eject fullstack-dev`.
-</details>
-
-- **One command to apply, one to remove** — `use` and `eject`
-- **Non-invasive** — injected content is wrapped in markers, your existing files are untouched
-- **Stackable** — apply multiple briefs; later ones layer on top
-- **Engine-agnostic** — compiles to all engines simultaneously, optimized for each
+WITHOUT a brief:
+  You: "Review this code for issues"
+  Agent: "The code looks good overall. Consider adding error handling."
+
+WITH security-auditor brief:
+  You: "Review this code for issues"
+  Agent: "CWE-89 CRITICAL at line 23: SQL injection via string concatenation.
+         Attack vector: attacker injects arbitrary SQL through userId param.
+         Fix: const query = 'SELECT * FROM users WHERE id = $1';
+              await db.query(query, [userId]);"
+```
 
 ## Install
 
@@ -65,44 +39,28 @@ npm install -g agentbrief
 pnpm add -g agentbrief
 ```
 
-## Usage
-
-```bash
-# Apply from the official registry (short name)
-agentbrief use security-auditor
-agentbrief use nextjs-fullstack
-agentbrief use typescript-strict
-
-# Apply from GitHub
-agentbrief use github:owner/repo
-agentbrief use github:owner/repo@v1.0
-
-# Apply from local path
-agentbrief use ./path/to/brief
-
-# Browse available briefs
-agentbrief search
-agentbrief search security
+## Quick Start Packs
 
-# Manage applied briefs
-agentbrief list
-agentbrief show <name>
-agentbrief update
-agentbrief eject <name>
+Not sure where to begin? Pick a combo — each one bundles multiple specialist briefs into a single command:
 
-# Create a new brief
-agentbrief init my-agent
-agentbrief init my-agent --template security
 ```
-
-## Official Registry
-
-**⚡ Quick Start Packs** — best if you're not sure where to begin:
+  fullstack-engineer  →  release-engineer  →  startup-founder
+       Build                 Ship                 Grow
+```
 
 | Pack | What your agent gains |
 |------|----------------------|
-| `fullstack-dev` | Strict TypeScript + Next.js conventions + accessible UI + PR reviews (9 skills) |
-| `startup-kit` | Product specs + SEO audit + growth analytics + security review + launch strategy (12 skills) |
+| `fullstack-engineer` | Strict TypeScript + Next.js + accessible UI + PR reviews (9 skills) |
+| `release-engineer` | QA testing + security review + CI/CD + documentation (10 skills) |
+| `startup-founder` | Product specs + SEO + growth analytics + security + launch (12 skills) |
+
+```bash
+agentbrief use fullstack-engineer   # Build: write production code
+agentbrief use release-engineer     # Ship: test, secure, deploy, document
+agentbrief use startup-founder      # Grow: product, growth, launch strategy
+```
+
+## All Briefs
 
 **Code Quality & Engineering:**
 
@@ -111,9 +69,9 @@ agentbrief init my-agent --template security
 | `security-auditor` | OWASP security reviewer who cites CWE numbers |
 | `code-reviewer` | Staff engineer who catches architecture + logic issues |
 | `qa-engineer` | QA who finds bugs, writes tests, fixes with atomic commits |
-| `typescript-strict` | Type safety enforcer — zero `any`, exhaustive checks |
-| `nextjs-fullstack` | Next.js 15 specialist (App Router, RSC, Tailwind) |
-| `frontend-design` | Design engineer with 80-item review checklist |
+| `typescript-engineer` | Type safety enforcer — zero `any`, exhaustive checks |
+| `nextjs-developer` | Next.js 15 specialist (App Router, RSC, Tailwind) |
+| `design-engineer` | Design engineer with 80-item review checklist |
 | `devops-sre` | SRE who sets up CI/CD, monitoring, incident response |
 | `tech-writer` | Documentation specialist with API docs + release notes |
 
@@ -124,64 +82,119 @@ agentbrief init my-agent --template security
 | `product-manager` | PM who writes PRDs with RICE/ICE prioritization |
 | `growth-engineer` | Growth hacker with SEO audit + analytics + content strategy |
 | `data-analyst` | BI analyst with metrics frameworks + SQL patterns |
-| `startup-builder` | Startup advisor with CEO review + launch planning |
+| `startup-advisor` | Startup advisor with CEO review + launch planning |
+| `social-media-manager` | Social media manager — Twitter/X + Xiaohongshu posting |
 
-Browse the **[full Catalog](./CATALOG.md)** or the **[Website](https://0xranx.github.io/agentbrief)** to see details for each brief.
+Browse the **[full Catalog](./CATALOG.md)** or the **[Website](https://0xranx.github.io/agentbrief)** for details on each brief.
 
-## What's a Brief?
+## Usage
 
-A directory containing:
+```bash
+# Apply from the official registry
+agentbrief use security-auditor
+
+# Apply from GitHub
+agentbrief use github:owner/repo
+agentbrief use github:owner/repo@v1.0
+
+# Apply from local path
+agentbrief use ./path/to/brief
+
+# Browse, inspect, manage
+agentbrief search                 # List all briefs
+agentbrief list                   # See what's applied
+agentbrief show <name>            # View injected content
+agentbrief preview <name>         # Preview without applying
+agentbrief update                 # Fetch latest versions
+agentbrief eject <name>           # Clean removal
+```
+
+## How It Works
+
+AgentBrief compiles a **brief** (role + knowledge + skills) into the instruction files your AI agent reads, with content optimized per engine:
+
+| Engine | File | Compilation |
+|--------|------|------------|
+| Claude Code | `CLAUDE.md` | Full — personality, knowledge refs, skill triggers |
+| Cursor | `.cursorrules` | Minimal — headings + first paragraph + lists |
+| OpenCode | `AGENTS.md` | Concise — first sentence per paragraph |
+| Codex | `AGENTS.md` | Concise — same as OpenCode |
+
+Your existing files are preserved — briefs are injected between `<!-- agentbrief:name:start/end -->` markers. Eject removes only the brief content.
+
+<details>
+<summary><b>See what gets injected</b> — example output for <code>fullstack-engineer</code></summary>
+
+```markdown
+<!-- agentbrief:fullstack-engineer:start -->
+# AgentBrief: fullstack-engineer
+
+## Role
+You are a senior full-stack TypeScript developer. You build production
+applications with Next.js 15, React 19, and Tailwind CSS. You enforce
+strict type safety and review your own code with principal-engineer rigor.
+
+## Constraints
+- Never use `any` — always annotate return types on exports
+- Server Components by default — only add 'use client' when needed
+- WCAG 2.1 AA minimum — semantic HTML, keyboard navigation
+
+## Skills
+- **next-best-practices** — USE WHEN: Writing Next.js code
+- **typescript-advanced-types** — USE WHEN: Complex type logic
+- **architecture-review** — USE WHEN: Reviewing PRs
+- **design-review-checklist** — USE WHEN: Checking UI quality
+- **agent-browser** — USE WHEN: Visual verification needed
+  ...and 4 more
+<!-- agentbrief:fullstack-engineer:end -->
+```
+
+</details>
+
+## What's a Brief?
 
 ```
 my-brief/
-├── brief.yaml          # Config: name, version, skills (local + remote)
+├── brief.yaml          # Config: name, version, extends, skills
 ├── personality.md      # Identity: role, tone, constraints
 ├── knowledge/          # Reference: domain materials (read on demand)
 │   └── cheatsheet.md
 └── skills/             # Workflows: executable skill directories
-    └── my-skill/       #   each skill = directory with SKILL.md
-        ├── SKILL.md    #   trigger condition + step-by-step process
-        └── ...         #   any supporting files
+    └── my-skill/
+        ├── SKILL.md    # Trigger condition + step-by-step process
+        └── ...         # Any supporting files
 ```
 
-See `examples/security-auditor/` for a complete example.
-
-## Create & Publish Your Own
-
-Share your expertise as a reusable brief:
-
-1. **Scaffold** — `agentbrief init my-agent` (or `--template security`)
-2. **Customize** — Edit `personality.md`, add `knowledge/` and `skills/`
-3. **Test** — `agentbrief use ./my-agent` in a temp directory
-4. **Preview** — `agentbrief preview ./my-agent` to see compiled output
-5. **Publish** — Push to GitHub → `agentbrief use github:you/my-agent`
-
-Want it in the official registry? [Submit a PR](./CONTRIBUTING.md). Read the full **[Authoring Guide](https://0xranx.github.io/agentbrief/docs.html#AUTHORING)**.
+See [`briefs/security-auditor/`](./briefs/security-auditor/) for a complete example.
 
-## Supported Engines
+## Built on Trusted Sources
 
-AgentBrief compiles each brief with optimizations for the target engine:
+Every official brief is curated from battle-tested, community-endorsed skills:
 
-| Engine | File | Compilation |
-|--------|------|------------|
-| Claude Code | `CLAUDE.md` | Full — all sections, verbose knowledge refs |
-| Cursor | `.cursorrules` | Minimal — headings + first paragraph + lists, no knowledge/scale |
-| OpenCode | `AGENTS.md` | Concise — first sentence per paragraph, compact refs |
-| Codex | `AGENTS.md` | Concise — same as OpenCode |
+- [obra/superpowers](https://github.com/obra/superpowers) **(90.6k ★)** — TDD, systematic debugging, verification
+- [anthropics/skills](https://github.com/anthropics/skills) **(95.8k ★)** — Anthropic's official skill packages
+- [garrytan/gstack](https://github.com/garrytan/gstack) **(YC CEO)** — CEO review, design review, QA
+- [vercel-labs](https://github.com/vercel-labs/agent-browser) **(Vercel official)** — Next.js best practices, browser automation
+- [coreyhaines31/marketingskills](https://github.com/coreyhaines31/marketingskills) — SEO audit, launch strategy, analytics
 
-## .gitignore
+## Create Your Own
 
-```
-# Add to your .gitignore
-.agentbrief/
+```bash
+agentbrief init my-agent              # Scaffold
+# Edit personality.md, add knowledge/ and skills/
+agentbrief use ./my-agent             # Test locally
+agentbrief preview ./my-agent         # See compiled output
+# Push to GitHub → agentbrief use github:you/my-agent
 ```
 
-Commit the engine instruction files (`CLAUDE.md`, `.cursorrules`, `AGENTS.md`) so your team shares the same agent behavior.
+Want it in the official registry? [Submit a PR](./CONTRIBUTING.md). Read the **[Authoring Guide](https://0xranx.github.io/agentbrief/docs.html#AUTHORING)**.
 
 ## Community
 
-- [GitHub Discussions](https://github.com/0xranx/agentbrief/discussions) — Questions, showcase your briefs, feature ideas
-- [Contributing Guide](./CONTRIBUTING.md) — How to submit briefs to the registry
+- [GitHub Discussions](https://github.com/0xranx/agentbrief/discussions) — Questions, showcase, feature ideas
+- [Contributing Guide](./CONTRIBUTING.md) — Submit briefs to the registry
+
+Add `.agentbrief/` to your `.gitignore`. Commit the engine files (`CLAUDE.md`, `.cursorrules`, `AGENTS.md`) so your team shares the same agent behavior.
 
 ## License
 

package/README.zh-CN.md

@@ -0,0 +1,201 @@
+# AgentBrief
+
+[![CI](https://github.com/0xranx/agentbrief/actions/workflows/ci.yml/badge.svg)](https://github.com/0xranx/agentbrief/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/agentbrief)](https://www.npmjs.com/package/agentbrief)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)
+
+> 一条命令，让你的 AI 编程 Agent 变成领域专家。
+>
+> [官网](https://0xranx.github.io/agentbrief/index.zh.html) · [目录](./CATALOG.md) · [npm](https://www.npmjs.com/package/agentbrief) · [English](./README.md)
+
+你的 Claude Code、Cursor、OpenCode 或 Codex 回答总是泛泛而谈？因为它不了解你的业务领域。AgentBrief 解决这个问题——安装一个**职能包（brief）**，你的 Agent 就拥有了真正的专业能力：安全审查、代码审查、产品规划、增长运营，等等。
+
+```bash
+npx agentbrief use fullstack-engineer
+# 你的 Agent 现在会执行严格 TypeScript、遵循 Next.js 规范、
+# 构建无障碍 UI、像 Staff 工程师一样审查 PR —— 一条命令获得 9 项技能
+```
+
+## 效果对比
+
+```
+没有职能包：
+  你："帮我审查一下这段代码"
+  Agent："代码整体看起来不错。建议加一些错误处理。"
+
+使用 security-auditor 职能包：
+  你："帮我审查一下这段代码"
+  Agent："CWE-89 严重 第23行：通过字符串拼接导致 SQL 注入。
+         攻击向量：攻击者通过 userId 参数注入任意 SQL。
+         修复：const query = 'SELECT * FROM users WHERE id = $1';
+              await db.query(query, [userId]);"
+```
+
+## 安装
+
+```bash
+npm install -g agentbrief
+# 或
+pnpm add -g agentbrief
+```
+
+## 快速上手套装
+
+不知道从哪开始？选一个组合包——每个都将多个专业职能包打包成一条命令：
+
+```
+  fullstack-engineer  →  release-engineer  →  startup-founder
+       构建（Build）          交付（Ship）          增长（Grow）
+```
+
+| 套装 | 你的 Agent 获得… |
+|------|------------------|
+| `fullstack-engineer` | 严格类型 + Next.js 规范 + 无障碍 UI + PR 审查（9 项技能） |
+| `release-engineer` | 自动测试 + 安全审查 + CI/CD + 发布文档（10 项技能） |
+| `startup-founder` | 产品规划 + SEO 审计 + 增长分析 + 安全 + 发布策略（12 项技能） |
+
+```bash
+agentbrief use fullstack-engineer   # 构建：写生产级代码
+agentbrief use release-engineer     # 交付：测试、安全、部署、文档
+agentbrief use startup-founder      # 增长：产品、运营、发布策略
+```
+
+## 全部职能包
+
+**代码质量与工程：**
+
+| 职能包 | 你的 Agent 变成… |
+|--------|------------------|
+| `security-auditor` | OWASP 安全审查员，引用 CWE 编号 |
+| `code-reviewer` | Staff 级工程师，捕获架构 + 逻辑问题 |
+| `qa-engineer` | QA 工程师，发现 Bug、编写测试、原子提交修复 |
+| `typescript-engineer` | 类型安全守卫——零 `any`、穷举检查 |
+| `nextjs-developer` | Next.js 15 专家（App Router、RSC、Tailwind） |
+| `design-engineer` | 设计工程师，附带 80 项审查清单 |
+| `devops-sre` | SRE 工程师，搭建 CI/CD、监控、故障响应 |
+| `tech-writer` | 文档专家，API 文档 + 发布说明 |
+
+**产品、增长与商业：**
+
+| 职能包 | 你的 Agent 变成… |
+|--------|------------------|
+| `product-manager` | 产品经理，PRD + RICE/ICE 优先级排序 |
+| `growth-engineer` | 增长工程师，SEO 审计 + 数据分析 + 内容策略 |
+| `data-analyst` | 数据分析师，指标体系 + SQL + 数据叙事 |
+| `startup-advisor` | 创业顾问，CEO 审查 + 发布规划 |
+| `social-media-manager` | 社媒运营，Twitter/X + 小红书发布 |
+
+查看 **[完整目录](./CATALOG.md)** 或 **[官网](https://0xranx.github.io/agentbrief/index.zh.html)** 了解每个职能包的详情。
+
+## 使用方法
+
+```bash
+# 从官方 registry 安装
+agentbrief use security-auditor
+
+# 从 GitHub 安装
+agentbrief use github:owner/repo
+agentbrief use github:owner/repo@v1.0
+
+# 从本地目录安装
+agentbrief use ./path/to/brief
+
+# 浏览、查看、管理
+agentbrief search                 # 列出所有职能包
+agentbrief list                   # 查看已安装的
+agentbrief show <name>            # 查看注入内容
+agentbrief preview <name>         # 预览（不安装）
+agentbrief update                 # 更新到最新版
+agentbrief eject <name>           # 干净卸载
+```
+
+## 工作原理
+
+AgentBrief 将**职能包**（角色 + 知识 + 技能）编译成 AI Agent 读取的指令文件，并根据引擎智能优化输出：
+
+| 引擎 | 文件 | 编译方式 |
+|------|------|---------|
+| Claude Code | `CLAUDE.md` | 完整——人格、知识引用、技能触发条件 |
+| Cursor | `.cursorrules` | 精简——标题 + 首段 + 列表 |
+| OpenCode | `AGENTS.md` | 简洁——每段首句 |
+| Codex | `AGENTS.md` | 简洁——同 OpenCode |
+
+你的现有文件不会被覆盖——职能包通过 `<!-- agentbrief:name:start/end -->` 标记注入。卸载只移除职能包内容。
+
+<details>
+<summary><b>查看注入内容示例</b>——<code>fullstack-engineer</code> 的输出</summary>
+
+```markdown
+<!-- agentbrief:fullstack-engineer:start -->
+# AgentBrief: fullstack-engineer
+
+## Role
+You are a senior full-stack TypeScript developer. You build production
+applications with Next.js 15, React 19, and Tailwind CSS. You enforce
+strict type safety and review your own code with principal-engineer rigor.
+
+## Constraints
+- Never use `any` — always annotate return types on exports
+- Server Components by default — only add 'use client' when needed
+- WCAG 2.1 AA minimum — semantic HTML, keyboard navigation
+
+## Skills
+- **next-best-practices** — USE WHEN: Writing Next.js code
+- **typescript-advanced-types** — USE WHEN: Complex type logic
+- **architecture-review** — USE WHEN: Reviewing PRs
+- **design-review-checklist** — USE WHEN: Checking UI quality
+- **agent-browser** — USE WHEN: Visual verification needed
+  ...and 4 more
+<!-- agentbrief:fullstack-engineer:end -->
+```
+
+</details>
+
+## 什么是 Brief（职能包）？
+
+```
+my-brief/
+├── brief.yaml          # 配置：名称、版本、继承、技能
+├── personality.md      # 身份：角色、语气、约束
+├── knowledge/          # 知识：领域参考材料（按需读取）
+│   └── cheatsheet.md
+└── skills/             # 技能：可执行的工作流目录
+    └── my-skill/
+        ├── SKILL.md    # 触发条件 + 分步流程
+        └── ...         # 其他支持文件
+```
+
+查看 [`briefs/security-auditor/`](./briefs/security-auditor/) 获取完整示例。
+
+## 可信来源
+
+每个官方职能包都源自经过实战检验、社区认可的技能：
+
+- [obra/superpowers](https://github.com/obra/superpowers) **(90.6k ★)** — TDD、系统化调试、验证
+- [anthropics/skills](https://github.com/anthropics/skills) **(95.8k ★)** — Anthropic 官方技能包
+- [garrytan/gstack](https://github.com/garrytan/gstack) **(YC CEO)** — CEO 审查、设计审查、QA
+- [vercel-labs](https://github.com/vercel-labs/agent-browser) **(Vercel 官方)** — Next.js 最佳实践、浏览器自动化
+- [coreyhaines31/marketingskills](https://github.com/coreyhaines31/marketingskills) — SEO 审计、发布策略、数据分析
+
+## 创建你自己的
+
+```bash
+agentbrief init my-agent              # 脚手架
+# 编辑 personality.md，添加 knowledge/ 和 skills/
+agentbrief use ./my-agent             # 本地测试
+agentbrief preview ./my-agent         # 查看编译输出
+# 推送到 GitHub → agentbrief use github:you/my-agent
+```
+
+想收录到官方 registry？[提交 PR](./CONTRIBUTING.md)。阅读 **[创作指南](https://0xranx.github.io/agentbrief/docs.html#AUTHORING)**。
+
+## 社区
+
+- [GitHub Discussions](https://github.com/0xranx/agentbrief/discussions) — 提问、展示作品、功能建议
+- [贡献指南](./CONTRIBUTING.md) — 如何提交职能包到 registry
+
+将 `.agentbrief/` 添加到 `.gitignore`。提交引擎文件（`CLAUDE.md`、`.cursorrules`、`AGENTS.md`），让团队共享相同的 Agent 行为。
+
+## 许可证
+
+[MIT](./LICENSE)

package/briefs/{frontend-design → design-engineer}/brief.yaml

@@ -1,4 +1,4 @@
-name: frontend-design
+name: design-engineer
 version: "1.0.0"
 description: "Frontend design engineer — React + Tailwind + shadcn/ui with bold, accessible design"
 personality: personality.md

package/briefs/fullstack-engineer/brief.yaml

@@ -0,0 +1,10 @@
+name: fullstack-engineer
+version: "1.0.0"
+description: Full-stack TypeScript engineer — Next.js + strict types + design + code review
+personality: personality.md
+extends:
+  - base-agent
+  - typescript-engineer
+  - nextjs-developer
+  - design-engineer
+  - code-reviewer

package/briefs/{nextjs-fullstack → nextjs-developer}/brief.yaml

@@ -1,4 +1,4 @@
-name: nextjs-fullstack
+name: nextjs-developer
 version: "1.0.0"
 description: "Next.js 15 + App Router + React 19 + Tailwind full-stack specialist"
 personality: personality.md

package/briefs/release-engineer/brief.yaml

@@ -0,0 +1,10 @@
+name: release-engineer
+version: "1.0.0"
+description: "Production release engineer — QA, security review, CI/CD, and documentation in one"
+personality: personality.md
+extends:
+  - base-agent
+  - qa-engineer
+  - devops-sre
+  - tech-writer
+  - security-auditor

package/briefs/release-engineer/personality.md

@@ -0,0 +1,17 @@
+## Role
+
+You are a production release engineer. You shepherd code from development through testing, security review, infrastructure validation, and documentation to production release. You combine the rigor of QA, the systems thinking of SRE, the vigilance of a security auditor, and the clarity of a technical writer.
+
+## Tone
+
+- Methodical and evidence-based — every claim backed by test results, logs, or audit findings
+- Direct about blockers — escalate security issues and test failures immediately, never soften critical findings
+- Checklist-driven — follow structured processes, never skip steps
+
+## Constraints
+
+- Never deploy without passing tests and verified test coverage
+- Never deploy without a rollback plan and monitoring in place
+- Never deploy with known security vulnerabilities — escalate, don't ignore
+- Never ship undocumented breaking changes — release notes are mandatory
+- Never approve a release based on "it works on my machine" — require CI/CD evidence

package/briefs/social-media-manager/brief.yaml

@@ -0,0 +1,12 @@
+name: social-media-manager
+version: "1.0.0"
+description: "Social media manager — content creation, scheduling, audience engagement, analytics"
+personality: personality.md
+knowledge:
+  - knowledge/
+skills:
+  - skills/
+  - github:jackwener/twitter-cli
+  - github:0xranx/agent-kit/skills/xhs-cli
+extends:
+  - base-agent

package/briefs/social-media-manager/knowledge/social-media-playbook.md

@@ -0,0 +1,55 @@
+# Social Media Playbook
+
+## Content Formats by Platform
+
+### Twitter/X
+- **Thread**: 5-10 tweets, hook in tweet 1, value in 2-9, CTA in last. Best for thought leadership.
+- **Single tweet**: < 280 chars, one clear idea. Best for hot takes, announcements, quotes.
+- **Quote tweet**: Add insight to someone else's tweet. Best for joining conversations.
+- **Poll**: 2-4 options, 24h duration. Best for engagement and audience research.
+- **Image + text**: Screenshot, chart, or infographic with context. 2-3x engagement vs text-only.
+
+### Xiaohongshu (小红书)
+- **Image-text note**: 1-9 images + 1000 chars max. First image is the cover — must be eye-catching. Best for tutorials, reviews, lifestyle.
+- **Video note**: 15s-15min, vertical 3:4 or 9:16. Best for how-to, vlogs, product demos.
+- **Collection/合集**: Group related notes into a series. Best for building topical authority.
+- **Tags/话题**: Always add 3-5 relevant tags. Critical for discovery — Xiaohongshu is search-first.
+
+### LinkedIn
+- **Text post**: 1300 chars max for full visibility. Hook in first 2 lines (before "see more").
+- **Carousel**: PDF upload, 5-10 slides. Best for how-to content and frameworks.
+- **Article**: Long-form, 800-2000 words. Best for SEO and establishing authority.
+
+## Posting Cadence
+
+| Platform | Minimum | Sweet Spot | Diminishing Returns |
+|----------|---------|------------|---------------------|
+| Twitter/X | 1/day | 3-5/day | > 10/day |
+| Xiaohongshu | 2/week | 1/day | > 3/day |
+| LinkedIn | 2/week | 4-5/week | > 1/day |
+
+## High-Engagement Patterns
+
+1. **Hook → Story → Lesson → CTA** (thread format)
+2. **Contrarian take** — "Everyone says X. Here's why Y." (single tweet)
+3. **Before/After** — Show transformation with specifics (image + text)
+4. **Numbered list** — "7 things I learned from..." (thread or carousel)
+5. **Behind the scenes** — Build in public, show process (authentic content)
+
+## Metrics That Matter
+
+| Metric | What It Tells You | Good Benchmark |
+|--------|-------------------|----------------|
+| Impressions | Reach/distribution | Growing week-over-week |
+| Engagement rate | Content resonance | > 2% on Twitter, > 3% on LinkedIn |
+| Profile visits | Curiosity generated | > 5% of impressions |
+| Follower growth | Sustained interest | > 1% weekly net growth |
+| Link clicks | Conversion intent | > 1% of impressions |
+
+## Content Calendar Framework
+
+- **Monday**: Industry insight or trend commentary
+- **Tuesday/Thursday**: Educational content (how-to, framework, lesson)
+- **Wednesday**: Engagement post (poll, question, hot take)
+- **Friday**: Behind-the-scenes or personal story
+- **Weekend**: Repurpose best-performing content from the week

package/briefs/social-media-manager/personality.md

@@ -0,0 +1,17 @@
+## Role
+
+You are a social media manager who creates engaging content, manages posting workflows, and grows audience across platforms — Twitter/X and Xiaohongshu (小红书). You combine copywriting instincts with data-driven iteration: every post has a purpose, every thread tells a story, and every metric informs the next move.
+
+## Tone
+
+- Concise and punchy — write for scroll-stopping attention, not essays
+- Data-informed — track what works, double down on high-engagement formats
+- Platform-native — match the voice and conventions of each platform (threads on X, carousels on LinkedIn, etc.)
+
+## Constraints
+
+- Never post without the user's explicit approval — draft first, post on command
+- Never use engagement bait, misleading claims, or manufactured controversy
+- Never ignore replies or mentions — engagement is a two-way street
+- Always disclose AI-generated content when required by platform policies
+- Respect rate limits and platform terms of service — no spam, no mass automation

package/briefs/social-media-manager/skills/twitter-workflow/SKILL.md

@@ -0,0 +1,91 @@
+---
+name: twitter-workflow
+description: "When the user wants to draft tweets, plan threads, post to Twitter/X, or manage their Twitter presence"
+---
+
+# Twitter Workflow
+
+## Prerequisites
+
+Ensure `twitter-cli` is installed and authenticated:
+
+```bash
+# Install
+uv tool install twitter-cli
+
+# Auth via browser cookies (no API key needed)
+# twitter-cli auto-extracts from Chrome/Arc/Firefox/Edge/Brave
+twitter-cli timeline
+```
+
+If auth fails, the user needs to set `TWITTER_AUTH_TOKEN` and `TWITTER_CT0` environment variables from their browser cookies.
+
+## Process
+
+### 1. Draft Content
+
+Before posting anything, always draft and present to the user for approval:
+
+- **Single tweet**: Keep under 280 chars. Lead with the hook. End with a CTA or open question.
+- **Thread**: Write each tweet as a standalone insight that also flows as a narrative. Number tweets (1/N format).
+- **Reply/Quote**: Read the original tweet first (`twitter-cli tweet <id>`), then add genuine value.
+
+### 2. Review & Approve
+
+Present the draft clearly:
+```
+📝 Draft tweet:
+---
+[tweet content here]
+---
+Post this? (y/n)
+```
+
+Never post without explicit user confirmation.
+
+### 3. Post
+
+```bash
+# Single tweet
+twitter-cli post "Your tweet content here"
+
+# Tweet with images (up to 4)
+twitter-cli post "Check out these results" --image chart.png
+
+# Quote tweet
+twitter-cli post "My take on this:" --quote-url https://x.com/user/status/123
+
+# Reply
+twitter-cli post "Great point! Here's what I'd add..." --reply-to 123456789
+```
+
+### 4. Monitor & Engage
+
+After posting, check engagement:
+
+```bash
+# Check your recent tweets and their metrics
+twitter-cli me --yaml
+
+# Search for mentions or relevant conversations
+twitter-cli search "keyword" --tab latest
+
+# Check replies to your tweet
+twitter-cli tweet <tweet-id>
+```
+
+### 5. Iterate
+
+Track what works:
+- Which tweet formats get highest engagement?
+- What time of day performs best?
+- Which topics resonate most?
+
+Use `twitter-cli me --yaml` output to analyze patterns and inform the next content batch.
+
+## Anti-patterns
+
+- Don't post multiple tweets in rapid succession — space them out
+- Don't draft generic content — every tweet should have a specific audience and purpose
+- Don't ignore replies — responding to comments boosts algorithmic visibility
+- Don't post and forget — always check engagement within 1-2 hours

package/briefs/{startup-builder → startup-advisor}/brief.yaml

@@ -1,4 +1,4 @@
-name: startup-builder
+name: startup-advisor
 version: "1.0.0"
 description: "Startup builder — idea validation, MVP planning, go-to-market, fundraising"
 personality: personality.md

package/briefs/startup-founder/brief.yaml

@@ -0,0 +1,10 @@
+name: startup-founder
+version: "1.0.0"
+description: Startup founder — product strategy + growth engineering + launch planning + security
+personality: personality.md
+extends:
+  - base-agent
+  - startup-advisor
+  - product-manager
+  - growth-engineer
+  - security-auditor

package/briefs/{typescript-strict → typescript-engineer}/brief.yaml

@@ -1,4 +1,4 @@
-name: typescript-strict
+name: typescript-engineer
 version: "1.0.0"
 description: "TypeScript type safety guardian — enforces strict typing, zero any, exhaustive checks"
 personality: personality.md

package/dist/cli.js

@@ -2,7 +2,7 @@
 import { Command } from "commander";
 import { eject, init, list, preview, search, show, update, use } from "./index.js";
 const program = new Command();
-program.name("agentbrief").description("Pluggable role definitions for AI coding agents").version("0.1.2");
+program.name("agentbrief").description("One command turns your AI coding agent into a domain specialist").version("0.2.0");
 program.addHelpText("after", `
 Quick start:
   agentbrief use ./path/to/brief    Apply a brief to your project

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "agentbrief",
-  "version": "0.1.2",
-  "description": "Pluggable role definitions for AI coding agents",
+  "version": "0.2.0",
+  "description": "One command turns your AI coding agent into a domain specialist",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/registry.yaml

@@ -31,19 +31,19 @@ code-reviewer:
   description: Rigorous PR review — naming, tests, architecture
   trust: official
 
-typescript-strict:
-  source: github:0xranx/agentbrief/briefs/typescript-strict
-  description: TypeScript type safety guardian — zero any
+typescript-engineer:
+  source: github:0xranx/agentbrief/briefs/typescript-engineer
+  description: TypeScript type safety engineer — zero any
   trust: official
 
-nextjs-fullstack:
-  source: github:0xranx/agentbrief/briefs/nextjs-fullstack
-  description: Next.js 15 + App Router + React 19 + Tailwind
+nextjs-developer:
+  source: github:0xranx/agentbrief/briefs/nextjs-developer
+  description: Next.js 15 + App Router + React 19 + Tailwind developer
   trust: official
 
-frontend-design:
-  source: github:0xranx/agentbrief/briefs/frontend-design
-  description: React + Tailwind + shadcn/ui design engineering
+design-engineer:
+  source: github:0xranx/agentbrief/briefs/design-engineer
+  description: React + Tailwind + shadcn/ui design engineer
   trust: official
 
 # ── Operations ───────────────────────────────────────────
@@ -70,9 +70,9 @@ product-manager:
   description: PRD generation, user stories, prioritization
   trust: official
 
-startup-builder:
-  source: github:0xranx/agentbrief/briefs/startup-builder
-  description: Idea validation → MVP → launch workflow
+startup-advisor:
+  source: github:0xranx/agentbrief/briefs/startup-advisor
+  description: Idea validation → MVP → launch advisor
   trust: official
 
 qa-engineer:
@@ -85,14 +85,24 @@ data-analyst:
   description: Business intelligence — metrics, SQL, dashboards, data storytelling
   trust: official
 
+social-media-manager:
+  source: github:0xranx/agentbrief/briefs/social-media-manager
+  description: Social media manager — content creation, Twitter/X posting, audience growth
+  trust: official
+
 # ── Combo Packs ──────────────────────────────────────────
 
-fullstack-dev:
-  source: github:0xranx/agentbrief/briefs/fullstack-dev
-  description: Full-stack TypeScript developer — extends typescript-strict + nextjs + design + review
+fullstack-engineer:
+  source: github:0xranx/agentbrief/briefs/fullstack-engineer
+  description: Full-stack TypeScript engineer — extends typescript-engineer + nextjs + design + review
+  trust: official
+
+startup-founder:
+  source: github:0xranx/agentbrief/briefs/startup-founder
+  description: Startup CTO kit — extends startup + product + growth + security
   trust: official
 
-startup-kit:
-  source: github:0xranx/agentbrief/briefs/startup-kit
-  description: Startup builder kit — extends startup + product + growth + security
+release-engineer:
+  source: github:0xranx/agentbrief/briefs/release-engineer
+  description: Production release engineer — QA, security, CI/CD, and documentation in one
   trust: official

package/briefs/fullstack-dev/brief.yaml

@@ -1,10 +0,0 @@
-name: fullstack-dev
-version: "1.0.0"
-description: Full-stack TypeScript developer — Next.js + strict types + design + code review
-personality: personality.md
-extends:
-  - base-agent
-  - typescript-strict
-  - nextjs-fullstack
-  - frontend-design
-  - code-reviewer

package/briefs/startup-kit/brief.yaml

@@ -1,10 +0,0 @@
-name: startup-kit
-version: "1.0.0"
-description: Startup builder kit — product + growth + launch + security
-personality: personality.md
-extends:
-  - base-agent
-  - startup-builder
-  - product-manager
-  - growth-engineer
-  - security-auditor