feat: TF3 Productivity Plugin — adapted from anthropics/knowledge-wor…

.claude-plugin/marketplace.json

@@ -1,7 +1,7 @@
 {
-  "name": "knowledge-work-plugins",
+  "name": "tf3-knowledge-work-plugins",
   "owner": {
-    "name": "Anthropic"
+    "name": "TF3 Trifecta Solutions"
   },
   "plugins": [
     {

README.md

@@ -1,3 +1,11 @@
+# TF3 Productivity Plugin
+Adapted from `anthropics/knowledge-work-plugins` for TF3 Trifecta Solutions.
+Connectors: Notion + ClickUp only.
+Install: `claude plugin install ./tf3-productivity-plugin`
+Requires env vars: NOTION_TOKEN, CLICKUP_API_KEY
+
+---
+
 # Knowledge Work Plugins
 
 Plugins that turn Claude into a specialist for your role, team, and company. Built for [Claude Cowork](https://claude.com/product/cowork), also compatible with [Claude Code](https://claude.com/product/claude-code).

productivity/.mcp.json

@@ -1,48 +1,14 @@
 {
   "mcpServers": {
-    "slack": {
-      "type": "http",
-      "url": "https://mcp.slack.com/mcp",
-      "oauth": {
-        "clientId": "1601185624273.8899143856786",
-        "callbackPort": 3118
-      }
-    },
     "notion": {
       "type": "http",
-      "url": "https://mcp.notion.com/mcp"
-    },
-    "asana": {
-      "type": "http",
-      "url": "https://mcp.asana.com/v2/mcp"
-    },
-    "linear": {
-      "type": "http",
-      "url": "https://mcp.linear.app/mcp"
-    },
-    "atlassian": {
-      "type": "http",
-      "url": "https://mcp.atlassian.com/v1/mcp"
-    },
-    "ms365": {
-      "type": "http",
-      "url": "https://microsoft365.mcp.claude.com/mcp"
-    },
-    "monday": {
-      "type": "http",
-      "url": "https://mcp.monday.com/mcp"
+      "url": "https://mcp.notion.com/mcp",
+      "authorization_token": "${NOTION_TOKEN}"
     },
     "clickup": {
       "type": "http",
-      "url": "https://mcp.clickup.com/mcp"
-    },
-    "google calendar": {
-      "type": "http",
-      "url": ""
-    },
-    "gmail": {
-      "type": "http",
-      "url": ""
+      "url": "https://mcp.clickup.com/mcp",
+      "authorization_token": "${CLICKUP_API_KEY}"
     }
   }
 }

productivity/CONNECTORS.md

@@ -8,11 +8,11 @@ Plugins are **tool-agnostic** — they describe workflows in terms of categories
 
 ## Connectors for this plugin
 
+TF3 stack only — Notion + ClickUp.
+
 | Category | Placeholder | Included servers | Other options |
 |----------|-------------|-----------------|---------------|
-| Chat | `~~chat` | Slack | Microsoft Teams, Discord |
-| Email | `~~email` | Microsoft 365 | — |
-| Calendar | `~~calendar` | Microsoft 365 | — |
-| Knowledge base | `~~knowledge base` | Notion | Confluence, Guru, Coda |
-| Project tracker | `~~project tracker` | Asana, Linear, Atlassian (Jira/Confluence), monday.com, ClickUp | Shortcut, Basecamp, Wrike |
-| Office suite | `~~office suite` | Microsoft 365 | — |
+| Knowledge base | `~~knowledge base` | Notion | — |
+| Project tracker | `~~project tracker` | ClickUp | — |
+
+Tokens are sourced from Claude Code environment variables: `NOTION_TOKEN`, `CLICKUP_API_KEY`.

productivity/commands/brief.md

@@ -0,0 +1,15 @@
+---
+description: Scaffold a Forge brief page in Notion
+argument-hint: "[CC number] [one-line objective]"
+---
+
+# /brief — Scaffold Forge Brief Page
+Usage: /brief [CC number] [one-line objective]
+1. Create child page under Notion page 364871f7633d81e9b91bfc0c6f545e40
+2. Title: CC-[number] — Cipher Brief — [objective] ([date])
+3. Pre-fill with standard pre-flight block:
+   - Repo: Tr1f3cta-cloud/tf3-agent-room · branch: master
+   - ESM only — import/export, no require/module.exports
+   - Do NOT change access codes or model strings
+4. Leave Implementation Steps section blank for Forge to complete
+5. Return page URL

productivity/commands/handoff.md

@@ -0,0 +1,10 @@
+---
+description: Write a Handoff Log entry to Notion
+argument-hint: "[from] [to] [context] [action required]"
+---
+
+# /handoff — Write Handoff Log Entry
+Usage: /handoff [from] [to] [context] [action required]
+1. Confirm the four fields with the user
+2. Append to Notion page 364871f7633d81a5be74f181d076278c in format: [From → To] · [Date] · [context] | [action] | [url if any] | [priority]
+3. Confirm written with page URL

productivity/commands/log.md

@@ -0,0 +1,11 @@
+---
+description: Write a Session Log entry to Notion
+argument-hint: "[agent name] [one-line summary]"
+---
+
+# /log — Write Session Log Entry
+Usage: /log [agent name] [one-line summary]
+1. Ask: completed items, decisions confirmed, ClickUp tasks to close, CLAUDE.md updated yes/no
+2. Create a child page under Notion page 34f871f7633d815b8f2bf0dbbe6ed5df
+3. Title format: [AgentName] · [Date] · [summary]
+4. Confirm written with page URL

productivity/commands/sweep.md

@@ -0,0 +1,14 @@
+---
+description: TF3 morning sweep — prioritised brief from ClickUp + Notion on demand
+---
+
+# /sweep — TF3 Morning Sweep
+Replicate Rex's morning sweep on demand.
+1. Fetch open tasks via the ClickUp `clickup_filter_tasks` tool over spaces 90166324362 and 90166324354 and list 901614493497. The tool has no priority parameter, so filter client-side:
+   - Keep only tasks whose priority is Urgent (1) or High (2).
+   - Skip any task whose list name contains `[LEGACY]`.
+   - Take the top 5 remaining.
+2. Read the Session Log's recent entries: enumerate the child pages of Notion page 34f871f7633d815b8f2bf0dbbe6ed5df, take the 5 most recently updated, and read each one individually (do not fetch the parent page whole — it is too large).
+3. Read pending entries from Notion page 364871f7633d81a5be74f181d076278c
+4. Produce: today's date, top 3 priorities, pending handoffs, decisions needed
+5. Ask: "Anything to add before I write the session log?"

productivity/commands/task.md

@@ -0,0 +1,11 @@
+---
+description: Create a ClickUp task in the correct TF3 list
+argument-hint: "[list] [name] [details]"
+---
+
+# /task — Create ClickUp Task
+Usage: /task [list] [name] [details]
+List options: management (901613539484), pillar2 (901614558872), marketing (901614558870), active-projects (901614408179), smb-pipeline (901614491515), community-pipeline (901614491517), live-retainer (901614478854)
+1. Resolve list name to list ID
+2. Create task with name and details in description (keep description under 300 characters)
+3. Return task URL

productivity/skills/productivity.md

@@ -0,0 +1,19 @@
+# Productivity — TF3 Configuration
+See tf3-context.md for full company context, ClickUp list IDs, and Notion page IDs.
+See rex-protocols.md for session log format and signal protocol.
+
+## Tools
+This plugin connects to TF3's stack only:
+- **ClickUp** — all tasks (full details in the description). Never create Notion pages for tasks.
+- **Notion** — session logs, briefs, specs, and knowledge.
+
+## Skills
+- `start` — initialize the task and memory systems and open the dashboard
+- `update` — sync ClickUp tasks, read the Ops Note and Handoff Log, summarise what needs Paskal today
+
+## Commands
+- `/productivity:sweep` — replicate Rex's morning sweep on demand
+- `/productivity:handoff` — write a Handoff Log entry
+- `/productivity:log` — write a Session Log entry
+- `/productivity:task` — create a ClickUp task in the correct list
+- `/productivity:brief` — scaffold a Forge brief page in Notion

productivity/skills/rex-protocols.md

@@ -0,0 +1,30 @@
+# Rex Protocols — TF3 Operational Standards
+
+## Morning Sweep Protocol
+1. Fetch open tasks via the ClickUp `clickup_filter_tasks` tool over spaces 90166324362 and 90166324354 and list 901614493497. The tool has no priority parameter — filter client-side: keep only Urgent (1) or High (2) priority, skip any task whose list name contains `[LEGACY]`, take the top 5.
+2. Read the Session Log (34f871f7633d815b8f2bf0dbbe6ed5df): enumerate its child pages, take the 5 most recently updated, and read each individually — do not fetch the parent page whole (it is too large).
+3. Read Handoff Log (364871f7633d81a5be74f181d076278c) — pending items only
+4. Produce: date, top 3 priorities, pending handoffs, decisions needed
+5. Ask Paskal if anything to add before writing the session log entry
+
+## Session Log Format
+[AgentName] · [Date] · One-line summary
+Completed: list
+Decisions confirmed: list
+For Rex: what to sync
+CLAUDE.md updated: yes/no
+ClickUp tasks to close: list
+
+## Handoff Log Format
+[From → To] · [Date] · Context | Action required | Reference URL | Priority
+
+## Signal Protocol
+[STATE:working/idle/blocked/waiting:description]
+[HANDOFF:agent] context | action | url | priority
+[DECISION:title] body | context | priority
+[ACTIVITY:action description]
+
+## Standing Rules
+- Tasks in ClickUp — descriptions under 300 characters
+- Escalate enterprise commitments to Paskal always
+- Never send external comms without Paskal confirmation

productivity/skills/tf3-context.md

@@ -0,0 +1,40 @@
+# TF3 Trifecta Solutions — Context
+
+## Company
+- TF3 Trifecta Solutions Pty Ltd · Melbourne, Australia
+- Pillar 1: Web Hosting & Digital Growth (SMBs)
+- Pillar 2: AI, Automation & Governance (enterprise)
+- Pillar 3: Sustainable Future / GHT Partnership (community)
+
+## Team
+- Paskal Glavinov — Director
+- JC — Social Content
+- Raphael — Engagement VA (SMB inbound + community outbound only)
+- Christian Riconalla — Dev / GCP Admin
+- Tony Kocankovski — Solutions Architect
+
+## Active Clients
+Nature Insights, TopNotch, Butterflies Daycare, Planet Zero Waste, GreenHeart Trust, Elite BioCode, PA Real Solutions, Flowerdale Community House, Dhiv Naidoo
+
+## Key Rules
+- Tasks go in ClickUp with full details in description. Never create Notion pages for tasks.
+- Notion is for session logs, briefs, specs, and knowledge only.
+- Australian data sovereignty: hard requirement on all client data.
+- Brand tone: Engineered Authority (TF3) / Community Warmth (GHT). Never mix.
+
+## ClickUp Lists
+- Management: 901613539484
+- Pillar 2 / AI: 901614558872
+- Marketing: 901614558870
+- Active Projects: 901614408179
+- SMB Pipeline: 901614491515
+- Community Pipeline: 901614491517
+- Live & Retainer: 901614478854
+- Team ID: 42662559
+
+## Notion Pages
+- Session Log: 34f871f7633d815b8f2bf0dbbe6ed5df
+- Ops Note: 347871f7633d8113a73bf24a4e7ee9e9
+- Handoff Log: 364871f7633d81a5be74f181d076278c
+- Agent Wiki: 346871f7633d81f0a11bf976525fd0ed
+- Forge Briefs: 364871f7633d81e9b91bfc0c6f545e40