@monoes/monomindcli 1.8.0 → 1.9.1

package/.claude/skills/mastermind/monotask.md

@@ -0,0 +1,350 @@
+---
+name: mastermind-monotask
+description: Authoritative monotask CLI reference for mastermind agents — boards, columns, cards (with filters, subtasks, prerequisites, scoring, attachments), spaces, GitHub/Linear sync, and common agent workflows. Version 1.1.4.
+type: reference-skill
+---
+
+# Monotask CLI — Agent Reference (v1.1.4)
+
+Monotask is a P2P local-first task manager. All data is stored in SQLite (`~/.local/share/monotask/monotask.db`). Always use `--json` for machine-readable output.
+
+---
+
+## Global Flags
+
+```
+--data-dir <PATH>   Override storage directory (must be consistent per instance)
+```
+
+---
+
+## Board
+
+```bash
+# Create — returns {id, title, deep_link}
+monotask board create "Sprint 42" --json
+
+# List — returns [{id, title}] (search by title with jq .title)
+monotask board list --json
+
+# Rename
+monotask board rename <BOARD_ID> "New Title" --json
+```
+
+---
+
+## Column
+
+```bash
+# Create — returns {id, board_id}
+monotask column create <BOARD_ID> "Todo" --json
+
+# List — returns [{id, title, card_ids:[]}]  ← field is "title", NOT "name"
+monotask column list <BOARD_ID> --json
+
+# Rename
+monotask column rename <BOARD_ID> <COL_ID> "New Title" --json
+
+# Delete (soft-deletes all cards in it)
+monotask column delete <BOARD_ID> <COL_ID> --json
+```
+
+---
+
+## Card
+
+### Listing
+
+```bash
+# All cards in board (flat, includes col_id + col_title per card)
+monotask card list <BOARD_ID> --json
+
+# Filter by column (server-side, fast)
+monotask card list <BOARD_ID> --col <COL_ID> --json
+
+# Filter by label (server-side, exact match)
+monotask card list <BOARD_ID> --label "role:writer" --json
+
+# Combine filters
+monotask card list <BOARD_ID> --col <TODO_COL> --label "role:reviewer" --json
+```
+
+JSON schema per item from `card list`:
+```json
+{ "id":"<uuid>", "title":"<str>", "col_id":"<uuid>", "col_title":"<str>",
+  "labels":[], "due_date":null, "impact":null, "effort":null, "direct_priority":null }
+```
+
+### Create / View / Move
+
+```bash
+# Create — returns {id, title, board_id, number}
+CARD=$(monotask card create <BOARD_ID> <COL_ID> "Task title" --json | jq -r .id)
+
+# View full card (includes parent + subtasks)
+monotask card view <BOARD_ID> <CARD_ID> --json
+
+# Move to different column (auto-detects current column)
+monotask card move <BOARD_ID> <CARD_ID> <TO_COL_ID> --json
+
+# Copy to another column (same board)
+monotask card copy <BOARD_ID> <CARD_ID> <TARGET_COL_ID> --json
+
+# Rename
+monotask card rename <BOARD_ID> <CARD_ID> "New title" --json
+
+# Soft-delete (hidden from all views)
+monotask card delete <BOARD_ID> <CARD_ID> --json
+
+# Soft-archive (hidden from normal views)
+monotask card archive <BOARD_ID> <CARD_ID> --json
+```
+
+### Metadata
+
+```bash
+monotask card set-description <BOARD_ID> <CARD_ID> "Markdown text" --json
+monotask card set-due-date    <BOARD_ID> <CARD_ID> "2026-06-01" --json  # "none" to clear
+monotask card set-cover       <BOARD_ID> <CARD_ID> "#e74c3c" --json     # "none" to clear
+```
+
+### Priority / Scoring
+
+```bash
+# ICE scoring: priority = floor((impact + 10 - effort) / 2), range 0–10
+monotask card set-impact  <BOARD_ID> <CARD_ID> 8 --json
+monotask card set-effort  <BOARD_ID> <CARD_ID> 3 --json
+
+# Direct priority (bypasses impact/effort)
+monotask card set-direct-priority <BOARD_ID> <CARD_ID> 9 --json
+monotask card set-direct-priority <BOARD_ID> <CARD_ID> --clear --json
+
+# Clear all scoring
+monotask card clear-priority <BOARD_ID> <CARD_ID> --json
+```
+
+### Labels
+
+```bash
+monotask card label add    <BOARD_ID> <CARD_ID> "role:writer" --json
+monotask card label remove <BOARD_ID> <CARD_ID> "role:writer" --json
+monotask card label list   <BOARD_ID> <CARD_ID> --json  # → ["str",...]
+```
+
+**Convention for org agents:**
+- `role:<role_id>` — which role should handle this card
+- `claimed` — card has been picked up by an agent (in Doing column)
+
+### Assignee
+
+```bash
+# PUBKEY = 64-char hex (get via: monotask profile show)
+monotask card set-assignee <BOARD_ID> <CARD_ID> <PUBKEY> --json
+monotask card set-assignee <BOARD_ID> <CARD_ID> none --json  # clear
+```
+
+### Comments
+
+```bash
+monotask card comment add    <BOARD_ID> <CARD_ID> "text" --json
+monotask card comment list   <BOARD_ID> <CARD_ID> --json
+monotask card comment delete <BOARD_ID> <CARD_ID> <COMMENT_ID> --json
+```
+
+### Subtasks (parent/child hierarchy)
+
+```bash
+# Create a subtask (new card linked as child of PARENT_CARD)
+monotask card subtask add <PARENT_BOARD> <PARENT_CARD> <CHILD_BOARD> <COL_ID> "Subtask title" --json
+# → returns {id, title, board_id}
+
+# List subtasks of a card
+monotask card subtask list <BOARD_ID> <CARD_ID> --json
+# → [{board_id, card_id},...]
+
+# card view includes "subtasks" and "parent" fields automatically
+```
+
+### Prerequisites (dependency ordering)
+
+```bash
+# PREREQ_CARD must be Done before CARD can be claimed
+monotask card prerequisite add    <BOARD_ID> <CARD_ID> <PREREQ_BOARD> <PREREQ_CARD_ID> --json
+monotask card prerequisite list   <BOARD_ID> <CARD_ID> --json  # → [{board_id, card_id},...]
+monotask card prerequisite remove <BOARD_ID> <CARD_ID> <PREREQ_BOARD> <PREREQ_CARD_ID> --json
+```
+
+### Attachments
+
+```bash
+# Attach image (stored as base64; returns img:<6char-id> token for markdown)
+ATT=$(monotask card attach-image <BOARD_ID> <CARD_ID> screenshot.png --json | jq -r .token)
+monotask card set-description <BOARD_ID> <CARD_ID> "See: ![$ATT]($ATT)"
+
+monotask card list-attachments <BOARD_ID> <CARD_ID> --json
+monotask card save-attachment  <BOARD_ID> <CARD_ID> <ATTACHMENT_ID> --output ./out.png
+```
+
+### Checklists
+
+```bash
+CL=$(monotask checklist add      <BOARD_ID> <CARD_ID> "Definition of Done" --json | jq -r .id)
+ITEM=$(monotask checklist item-add   <BOARD_ID> <CARD_ID> $CL "Write tests" --json | jq -r .id)
+monotask checklist item-check   <BOARD_ID> <CARD_ID> $CL $ITEM
+monotask checklist item-uncheck <BOARD_ID> <CARD_ID> $CL $ITEM
+```
+
+---
+
+## Space (Collaboration)
+
+```bash
+# Create / list
+monotask space create "Team Name"
+monotask space list   # → "<id> | <name> | <N> members"
+monotask space info <SPACE_ID>
+
+# Associate boards
+monotask space boards add    <SPACE_ID> <BOARD_ID>
+monotask space boards remove <SPACE_ID> <BOARD_ID>
+monotask space boards list   <SPACE_ID>
+
+# Invite / join
+monotask space invite export  <SPACE_ID> invite.space  # preferred (includes space doc)
+monotask space invite generate <SPACE_ID>               # token only
+monotask space invite revoke   <SPACE_ID>
+monotask space join invite.space                        # or raw token
+
+# Members
+monotask space members list <SPACE_ID>
+monotask space members kick <SPACE_ID> <PUBKEY>
+```
+
+---
+
+## GitHub Integration
+
+```bash
+monotask github connect ghp_yourtoken           # save token
+monotask github repos                           # list accessible repos
+monotask github link <BOARD_ID> <ORG> <REPO> --done-col <COL_ID>  # link repo
+monotask github unlink <BOARD_ID>
+monotask github sync <BOARD_ID>                 # bidirectional sync
+```
+
+---
+
+## Linear Integration
+
+```bash
+monotask linear connect lin_api_yourkey         # save key
+monotask linear status
+monotask linear teams                           # list teams
+monotask linear projects <TEAM_ID>
+monotask linear link <BOARD_ID> --team <TEAM_ID> --project <PROJECT_ID> [--done-col <COL_ID>]
+monotask linear unlink <BOARD_ID>
+monotask linear sync <BOARD_ID>                 # bidirectional sync
+```
+
+---
+
+## P2P Sync Daemon
+
+```bash
+monotask sync --detach --port 7272              # start background daemon
+monotask sync --status
+monotask sync --stop
+monotask sync --peer /ip4/192.168.1.10/tcp/7272 # connect to known peer
+```
+
+---
+
+## Profile
+
+```bash
+monotask profile show
+monotask profile set-name "Alice"
+monotask profile set-avatar ~/avatar.png
+monotask profile import-ssh-key ~/.ssh/id_ed25519  # changes pubkey — run before joining spaces
+```
+
+---
+
+## Common Agent Workflows
+
+### Set up an org task board
+```bash
+BOARD=$(monotask board create "org-tasks" --json | jq -r .id)
+TODO=$(monotask column create $BOARD "Todo"  --json | jq -r .id)
+DOING=$(monotask column create $BOARD "Doing" --json | jq -r .id)
+DONE=$(monotask column create $BOARD "Done"  --json | jq -r .id)
+```
+
+### Task assignment loop (boss agent pattern)
+```bash
+# List unclaimed Todo cards
+monotask card list $BOARD --col $TODO --json | jq '[.[] | select(.labels | index("claimed") | not)]'
+
+# Claim a card for a role agent
+monotask card move $BOARD $CARD_ID $DOING
+monotask card label add $BOARD $CARD_ID "claimed"
+
+# Complete a card
+monotask card move $BOARD $CARD_ID $DONE
+
+# Find all cards for a specific role across all columns
+monotask card list $BOARD --label "role:writer" --json
+```
+
+### Check prerequisites before claiming
+```bash
+# Get prereqs of a card
+PREREQS=$(monotask card prerequisite list $BOARD $CARD_ID --json)
+# Check all prereqs are in Done column
+echo "$PREREQS" | jq -r '.[].card_id' | while read PREREQ_ID; do
+  COL=$(monotask card list $BOARD --json | jq -r --arg id "$PREREQ_ID" '.[] | select(.id==$id) | .col_id')
+  [ "$COL" != "$DONE" ] && echo "BLOCKED: $PREREQ_ID not done" && exit 1
+done
+```
+
+### Find board by title
+```bash
+BOARD_ID=$(monotask board list --json | jq -r '.[] | select(.title=="org-tasks") | .id')
+```
+
+### Find column by title  (field is "title", NOT "name")
+```bash
+COLS=$(monotask column list $BOARD --json)
+TODO=$(echo "$COLS" | jq -r '.[] | select(.title=="Todo") | .id')
+DONE=$(echo "$COLS" | jq -r '.[] | select(.title=="Done") | .id')
+```
+
+---
+
+## ID Formats
+
+| Type | Format |
+|---|---|
+| Board / Column / Card / Space / Comment / Checklist | UUID v4 |
+| Attachment | 6-char hex (reference as `img:<id>` in markdown) |
+| Card number | `<prefix>-<seq>` — human display only; CLI requires full UUID |
+
+## HLC Timestamps
+
+All `created_at` fields use Hybrid Logical Clock format `<wall_ms_hex>-<logical_hex>`.
+
+```js
+ms = parseInt(hlc.split('-')[0], 16)     // → Unix ms
+new Date(ms).toISOString()               // → ISO date
+```
+
+## Error Handling
+
+All commands exit 0 on success, non-zero on error. Errors go to stderr (never mixed into `--json` stdout). Common causes: ID not found, invalid UUID, corrupted board file, invalid invite token.
+
+## Key Limitations
+
+- CLI operates on **local data only** — P2P sync requires the desktop app or `sync --detach`
+- `card create` uses placeholder prefix `"aaaa"` for card numbers (full identity wiring planned)
+- No `board delete` command — orphaned boards must be removed via SQLite directly
+- `card move` auto-detects current column — no need to specify source column

package/.claude/skills/mastermind/ops.md

@@ -0,0 +1,156 @@
+---
+name: mastermind-ops
+description: Mastermind ops domain — workflow automation, reporting, process optimization. Spawns an Ops Manager coordinating automation and reporting agents in parallel.
+type: domain-skill
+default_mode: auto
+---
+
+# Mastermind Ops Domain
+
+This skill is invoked by `mastermind:master` or directly via `/mastermind:ops`.
+
+---
+
+## Inputs
+
+- `brain_context`: BRAIN CONTEXT block (injected by master, or loaded standalone via _protocol.md brain load)
+- `prompt`: the operations goal for this run
+- `project_name`: monotask space name
+- `board_id`: monotask board ID (set by master, or created standalone)
+- `mode`: auto | confirm
+
+---
+
+## Complexity Assessment
+
+Assess the prompt to determine execution mode:
+
+**Simple (direct execution):** Single process or single report:
+- "Generate a weekly status report from the task board"
+- "Document this manual workflow as a runbook"
+→ Use a single Workflow Optimizer or Analytics Reporter agent. Skip manager delegation.
+
+**Complex (spawn Ops Manager agent):** Any of these:
+- End-to-end workflow automation design and implementation
+- Multi-system integration (CI/CD + monitoring + alerting)
+- Reporting dashboard requiring multiple data sources
+- Process audit and optimization across multiple teams
+→ Spawn Ops Manager agent with full briefing.
+
+---
+
+## Standalone Execution (when called without master)
+
+If this skill is invoked directly (not by master):
+
+1. Load brain context following _protocol.md Brain Load Procedure (namespace: `ops`)
+2. Run intake from _intake.md if prompt is vague
+3. Create or find monotask space `<project_name>`, create board `ops`
+4. Proceed with complexity assessment below
+5. At end: follow _protocol.md Brain Write Procedure (namespace: `ops`)
+
+---
+
+## Complex Execution — Ops Manager Agent
+
+Spawn an Ops Manager agent via Task tool:
+
+```javascript
+Task({
+  subagent_type: "coordinator",
+  description: `You are the Ops Manager for project <project_name>.
+
+CONTEXT: <date> | Project: <project_name> | Spawned by: mastermind:ops
+
+BRAIN CONTEXT:
+<brain_context>
+
+YOUR BOARD: <board_id>
+YOUR GOAL: <prompt>
+
+STEP 1 — PLAN
+Decompose the ops goal into parallel workstreams. For each workstream, identify:
+- What process, system, or workflow it covers
+- Whether it's automation design, reporting, or optimization
+- What tools and integrations are involved
+- Dependencies between workstreams
+
+STEP 2 — CREATE TASKS
+For each workstream, create a monotask card on the project board. First look up column IDs and assign shell variables:
+```bash
+columns=$(monotask column list "$BOARD_ID" --json)
+COL_TODO_ID=$(echo "$columns" | jq -r '.[] | select(.title == "Todo" or .title == "Backlog") | .id' | head -1)
+COL_DONE_ID=$(echo "$columns" | jq -r '.[] | select(.title == "Done") | .id' | head -1)
+```
+Then create the card:
+```bash
+result=$(monotask card create "$BOARD_ID" "$COL_TODO_ID" "<short summary of workstream goal, ≤80 chars>" --json)
+CARD_ID=$(echo "$result" | jq -r '.id // empty')
+monotask card set-description "$BOARD_ID" "$CARD_ID" "[specific ops workstream goal]"
+monotask card comment add "$BOARD_ID" "$CARD_ID" "CONTEXT: <date> | Project: <project_name> | Created by: Ops Manager
+BRAIN MEMORY: [paste most relevant 3-5 brain context excerpts]
+SCOPE: [systems, tools, processes, integrations in scope]
+CONSTRAINTS: [existing tooling to preserve, compliance requirements, access restrictions]
+SUCCESS CRITERIA:
+- [ ] [checkable item — e.g. \"automation runs without manual intervention\"]
+AGENT: [Workflow Optimizer | Analytics Reporter | DevOps Automator | cicd-engineer]
+SWARM: star 4 parallel
+DEPENDENCIES: [task IDs or \"none\"]
+OUTPUT FORMAT: unified output schema"
+```
+
+STEP 3 — EXECUTE
+Spawn one Task agent per workstream (star topology — hub aggregates independent outputs):
+- Workflow design and automation: subagent_type "Workflow Optimizer"
+- Reporting and dashboards: subagent_type "Analytics Reporter"
+- Infrastructure automation: subagent_type "DevOps Automator"
+- CI/CD pipelines: subagent_type "cicd-engineer"
+
+Also run /monomind:do --board <board_id> to track execution.
+
+STEP 4 — COLLECT AND RETURN
+Collect all agent outputs. Return to caller:
+
+domain: ops
+status: complete | partial | blocked
+artifacts:
+  - path: [automation scripts, runbooks, dashboard configs, reports]
+    type: config
+decisions:
+  - what: [automation approach, tooling decisions, process changes]
+    why: [reasoning]
+    confidence: [0.0-1.0]
+    outcome: shipped | pending
+lessons:
+  - what_worked: [what reduced toil or improved visibility most]
+  - what_didnt: [what required more manual intervention than expected]
+next_actions:
+  - [e.g. "run mastermind:review to audit the new automation"]
+  - [e.g. "run mastermind:release to deploy the ops changes"]
+board_url: monotask://<project_name>/ops
+run_id: <ISO8601-timestamp>`,
+  run_in_background: true
+})
+```
+
+---
+
+## Simple Execution
+
+For simple tasks (single agent, single deliverable):
+
+1. Spawn one Task agent with the ops request as a self-contained briefing
+2. Collect output
+3. Return unified output schema with `status: complete`
+
+---
+
+## Domain Swarm Defaults
+
+| Task Type | Agent | Swarm |
+|---|---|---|
+| Full workflow automation | coordinator + workflow + devops | star 4 parallel |
+| Reporting dashboard | Analytics Reporter + DevOps | star 3 parallel |
+| CI/CD pipeline setup | cicd-engineer | hierarchical 3 raft specialized |
+| Process audit | Workflow Optimizer | hierarchical 3 raft specialized |
+| Single report or runbook | Analytics Reporter | single agent |

package/.claude/skills/mastermind/references/copywriting-frameworks.md

@@ -0,0 +1,181 @@
+# Copywriting Frameworks Reference
+
+Headline formulas, page structure templates, CTA patterns, and writing principles for marketing pages. Use when writing or reviewing landing pages, homepages, pricing pages, feature pages, or any conversion-focused surface.
+
+---
+
+## Writing Principles
+
+### The Hierarchy
+1. **Clarity over cleverness** — If you have to choose, choose clear
+2. **Benefits over features** — Features: what it does. Benefits: what that means for the customer
+3. **Specificity over vagueness** — "Cut weekly reporting from 4 hours to 15 minutes" beats "Save time on your workflow"
+4. **Customer language over company language** — Mirror words from reviews, interviews, support tickets
+5. **Active over passive** — "We generate reports" not "Reports are generated"
+6. **Confident over qualified** — Remove "almost", "very", "really", "quite"
+7. **One idea per section** — Each section advances one argument; build a logical flow down the page
+
+### Quick Quality Check
+- Jargon that could confuse an outsider?
+- Sentences trying to do too much?
+- Passive voice constructions?
+- Exclamation points? (remove them)
+- Marketing buzzwords without substance? (streamline, optimize, innovative, leverage)
+- "We/our" dominating over "you/your"?
+
+---
+
+## Headline Formulas
+
+### Outcome-Focused
+- `{Achieve outcome} without {pain point}` → "Understand how users experience your site without drowning in numbers"
+- `{Achieve outcome} by {how product makes it possible}` → "Generate more leads by seeing which companies visit your site"
+- `Turn {input} into {outcome}` → "Turn your hard-earned sales into repeat customers"
+- `[Achieve outcome] in [timeframe]` → "Get your tax refund in 10 days"
+
+### Problem-Focused
+- `Never {unpleasant event} again` → "Never miss a sales opportunity again"
+- `{Question highlighting the main pain point}` → "Hate returning stuff to Amazon?"
+- `Stop [pain]. Start [pleasure].` → "Stop chasing invoices. Start getting paid on time."
+
+### Audience-Focused
+- `{Key feature} for {target audience}` → "Advanced analytics for Shopify stores"
+- `{Key feature} for {target audience} to {outcome}` → "An online whiteboard for teams to ideate together"
+- `You don't have to {skill} to {achieve outcome}` → "You don't have to be an SEO pro to rank higher"
+
+### Differentiation-Focused
+- `The {opposite of usual} way to {achieve outcome}` → "The easiest way to turn your passion into income"
+- `The [category] that [key differentiator]` → "The CRM that updates itself"
+
+### Proof-Focused
+- `[Number] [people] use [product] to [outcome]` → "50,000 marketers use Drip to send better emails"
+- `{Key benefit of your product}` → "Sound clear in online meetings"
+
+### Additional Formulas
+- `The simple way to {outcome}` → "The simple way to track your time"
+- `Finally, {category} that {benefit}` → "Finally, accounting software that doesn't suck"
+- `{Outcome} without {common pain}` → "Build your website without writing code"
+- `What if you could {desirable outcome}?` → "What if you could close deals 30% faster?"
+- `Everything you need to {outcome}` → "Everything you need to launch your course"
+- `The {adjective} {category} built for {audience}` → "The lightweight CRM built for startups"
+- `{Action verb} your {thing} like {admirable example}` → "Market your SaaS like a Fortune 500"
+
+---
+
+## Page Structure
+
+### Above the Fold
+**Headline** — Single most important message. Core value prop. Specific > generic.
+**Subheadline** — Expands headline. Adds specificity. 1-2 sentences max.
+**Primary CTA** — Action-oriented. Communicate what they get: "Start Free Trial" > "Sign Up"
+**Supporting element** — Social proof count, trust badge, or hero image
+
+### Core Section Types
+| Section | Purpose | Notes |
+|---|---|---|
+| Social Proof | Build credibility | Logos near CTA, stats, specific testimonials |
+| Problem / Pain | Show you understand | Mirror customer language, not company framing |
+| Solution / Benefits | Connect to outcomes | 3-5 key benefits, not feature list |
+| How It Works | Reduce complexity | 3-4 numbered steps |
+| Objection Handling | Remove hesitation | FAQ, comparison, guarantee |
+| Final CTA | Recap + action | Restate value, repeat CTA, risk reversal |
+
+### Page Templates
+
+**Compact Landing Page** (single offer, cold traffic):
+Above fold → Social proof strip → Problem → Solution/benefits → How it works → Testimonials → CTA
+
+**Feature-Heavy Product Page**:
+Above fold → Social proof → Core value → Feature 1 (problem → feature → benefit) → Feature 2 → Feature 3 → Testimonials → FAQ → CTA
+
+**Enterprise / B2B Landing Page**:
+Above fold (value + credibility) → Problem/stakes → Solution overview → Proof (logos + case study) → How it works → Security/compliance → Testimonials → CTA + Demo request
+
+**Product Launch Page**:
+Above fold (bold announcement) → Why now → What it is → Key capabilities → Social proof from beta → Pricing → FAQ → CTA
+
+---
+
+## CTA Copy Guidelines
+
+### Weak CTAs (avoid)
+Submit, Sign Up, Learn More, Click Here, Get Started, Download
+
+### Strong CTAs (use)
+- "Start Free Trial"
+- "Get [Specific Thing]" → "Get the Complete Checklist"
+- "See [Product] in Action"
+- "Create Your First [Thing]"
+- "[Action] for Free"
+
+### Formula
+`[Action Verb] + [What They Get] + [Qualifier if needed]`
+- "Start My Free Trial"
+- "See Pricing for My Team"
+- "Download the 2025 Report"
+
+---
+
+## Page-Specific Copy Guidance
+
+### Homepage
+- Serve multiple audiences without being generic
+- Lead with broadest value proposition
+- Provide clear paths for different visitor intents ("I'm a designer" / "I'm an engineer")
+- Don't try to close — guide toward the right next page or CTA
+
+### Landing Page
+- Single message, single CTA — remove navigation if possible
+- Match headline exactly to the ad or email that sent traffic here
+- Complete the argument on one page; don't assume they'll come back
+
+### Pricing Page
+- Help visitors choose the right plan — answer "which is right for me?"
+- Make recommended plan obvious (badge, highlight, preselected)
+- Address the top 3-4 objections in an FAQ
+- Annual toggle with savings stated in dollars and percentage
+
+### Feature Page
+- Connect: feature → benefit → outcome (not feature → feature → feature)
+- Show use cases and examples, not just capabilities
+- Clear path to try or buy at the bottom
+
+### About Page
+- Tell the story of why this exists (founding insight or problem)
+- Connect mission to customer benefit
+- Still include a CTA — this is often a high-intent page
+
+---
+
+## Writing for Trust
+
+### Social Proof Placement
+- Customer logos: above the fold (strip) and near primary CTA
+- Testimonials: specific quote + name + title + company + photo; near the claim they validate
+- Numbers: exact figures beat vague ("10,247 teams" not "thousands of teams")
+- Reviews: third-party star ratings add credibility you can't self-claim
+
+### Objection Handling
+Name the objection directly, then resolve it:
+- "What if it's not right for us?" → Money-back guarantee / free trial
+- "How long does setup take?" → "Live in 10 minutes, no IT required"
+- "Is my data secure?" → SOC 2 Type II, encryption at rest, specific certifications
+
+### Risk Reversals
+- "Free 14-day trial, no credit card required"
+- "Cancel anytime — no questions asked"
+- "30-day money-back guarantee"
+- "Free migration assistance"
+
+---
+
+## Copy Anti-Patterns
+
+Never:
+- Start a CTA with "Click here" or "Learn more" — be specific about the outcome
+- Use passive voice in problem statements ("An error was encountered")
+- Hedge: "This might help", "You may want to", "Perhaps consider"
+- Restate the heading in the first sentence of body copy
+- Write "Successfully saved" when "Saved" says the same in half the words
+- Use em dashes — use commas, colons, or periods instead
+- Open with "We are pleased to announce..." or "We are excited to share..."