@rubytech/taskmaster 1.0.105 → 1.0.107

package/skills/zero-to-prototype/references/discovery.md

@@ -0,0 +1,64 @@
+# Customer Discovery
+
+## Goal
+
+Understand the problem before designing the solution. Most failed products solve a problem nobody has, or solve the right problem for the wrong audience.
+
+## Step 1: Articulate the Idea
+
+Get the owner to state their idea in one sentence:
+
+> "[Product/service] helps [target audience] [solve problem] by [mechanism]."
+
+If they can't fill this in, they don't have a clear idea yet. Help them by asking:
+- Who specifically would use this?
+- What problem does it solve for them?
+- How do they solve this problem today (without your product)?
+- Why would they switch to your solution?
+
+## Step 2: Identify the Target Customer
+
+Don't accept "everyone" or "small businesses". Get specific:
+- **Demographics** — age, location, income, profession
+- **Behaviour** — what do they currently do? where do they hang out?
+- **Pain** — what frustrates them about the current solution?
+
+Ask: "If you could only sell to one type of person, who would it be?"
+
+## Step 3: Customer Conversations
+
+The owner needs to talk to potential customers. Not friends. Not family. Real prospects.
+
+### What to Ask (5 Key Questions)
+
+1. **"Tell me about the last time you [experienced the problem]."** — Gets real stories, not hypotheticals.
+2. **"What did you do about it?"** — Reveals current solutions and willingness to act.
+3. **"What's the most annoying part of how you handle this today?"** — Finds the pain point.
+4. **"If you could wave a magic wand, what would be different?"** — Reveals desires without anchoring to your solution.
+5. **"Would you pay to solve this? How much?"** — Tests willingness to pay.
+
+### Rules
+
+- **Don't pitch.** You're learning, not selling.
+- **Don't ask "would you use this?"** — everyone says yes to be polite.
+- **Talk to at least 5 people** before drawing conclusions.
+- **Look for patterns** — one person's pain is anecdotal. Three people's pain is a signal.
+
+## Step 4: Market Signals
+
+Help the owner assess whether the market supports the idea:
+
+- **Search volume** — are people searching for solutions? (Use web search to check)
+- **Competitors** — who else solves this? What do they charge? What do reviews say?
+- **Market size** — how many potential customers exist? Is the market growing?
+- **Timing** — why now? What's changed that makes this possible or necessary?
+
+## Output
+
+By the end of discovery, the owner should have:
+1. A clear one-sentence idea statement
+2. A specific target customer profile
+3. At least 3 customer conversation summaries (or a plan to do them)
+4. A market landscape overview
+
+Save these to memory for use in the validation and PRD phases.

package/skills/zero-to-prototype/references/prd.md

@@ -0,0 +1,83 @@
+# Product Requirement Document
+
+## Goal
+
+Turn the validated idea into a clear, actionable document that defines what to build, for whom, and why.
+
+## PRD Template
+
+Walk the owner through each section. Write the PRD collaboratively — don't generate it in isolation.
+
+### 1. Problem Statement
+
+One paragraph. What problem exists, who has it, and why current solutions fall short.
+
+Draw from discovery phase: customer conversations, pain points, market gaps.
+
+### 2. Target Customer
+
+Specific profile from discovery:
+- Who they are (demographics, role, context)
+- What they currently do (workarounds, competitors they use)
+- What they need (the gap your product fills)
+
+### 3. Value Proposition
+
+One sentence: "We help [target customer] [achieve outcome] by [mechanism], unlike [current alternative] which [limitation]."
+
+### 4. Core Features
+
+List the minimum features needed for the product to deliver its value proposition. No more.
+
+For each feature:
+- **What it does** (user-facing description)
+- **Why it matters** (which customer need it addresses)
+- **Priority** (Must-have / Should-have / Nice-to-have)
+
+Use the MoSCoW method:
+- **Must-have** — Product is useless without these
+- **Should-have** — Significantly improves the product
+- **Could-have** — Nice but not critical
+- **Won't-have** — Explicitly out of scope for v1
+
+### 5. User Journey
+
+Walk through the primary use case step by step:
+1. How does the customer discover the product?
+2. What's their first interaction?
+3. How do they get value for the first time?
+4. What keeps them coming back?
+
+### 6. Success Metrics
+
+How will the owner know this is working?
+
+| Metric | Target | Timeframe |
+|--------|--------|-----------|
+| e.g. Signups | 50 | First month |
+| e.g. Paying customers | 10 | First 3 months |
+| e.g. Retention | 70% month-over-month | Month 2+ |
+
+Pick 3-5 metrics. No more. Focus on outcomes, not vanity metrics.
+
+### 7. Scope and Constraints
+
+- **Budget** — what can the owner invest?
+- **Timeline** — when do they need it by?
+- **Technical constraints** — platform, integrations, dependencies
+- **Regulatory** — compliance, data protection, licensing
+
+### 8. Risks and Mitigations
+
+Top 3 risks from validation phase and how to address them.
+
+### 9. Next Steps
+
+Concrete actions with owners and deadlines:
+1. What needs to happen first?
+2. Who does what?
+3. When is the first checkpoint?
+
+## Output
+
+Save the completed PRD to memory. The owner now has a document they can share with developers, investors, or partners.

package/skills/zero-to-prototype/references/validation.md

@@ -0,0 +1,67 @@
+# Assumption Validation
+
+## Goal
+
+Every idea rests on assumptions. Find the riskiest ones and test them before building anything.
+
+## Step 1: List Assumptions
+
+Help the owner extract the hidden assumptions in their idea. Common categories:
+
+| Category | Example Assumption |
+|----------|--------------------|
+| **Problem** | "People actually struggle with X" |
+| **Audience** | "Tradesmen aged 30-50 need this" |
+| **Willingness to pay** | "People would pay £X/month" |
+| **Behaviour change** | "Users will switch from their current tool" |
+| **Channel** | "I can reach these customers via WhatsApp" |
+| **Feasibility** | "This can be built with available technology" |
+| **Unit economics** | "The cost to serve one customer is less than what they pay" |
+
+Ask: "What has to be true for this idea to work?" List everything.
+
+## Step 2: Risk-Rank Assumptions
+
+For each assumption, score two things:
+- **How critical?** (If this is wrong, does the idea die? 1-5)
+- **How uncertain?** (Do we have evidence, or is it a guess? 1-5)
+
+Priority = Critical × Uncertain. Test the highest scores first.
+
+## Step 3: Design Validation Tests
+
+For each high-priority assumption, choose a validation method:
+
+### Quick Tests (hours)
+- **Search validation** — Google the problem. Are people asking about it? Are there Reddit threads, forum posts, complaints?
+- **Competitor analysis** — Who else does this? Are they growing? What do their reviews say?
+- **Landing page test** — Create a simple page describing the product. Run a small ad. Measure clicks and signups.
+
+### Medium Tests (days)
+- **Pre-sell** — Offer the product before it exists. "Would you pay £X for this? I'm building it now." Count commitments.
+- **Concierge test** — Deliver the service manually to 3-5 customers. No product needed. Does it work? Do they value it?
+- **Smoke test** — Build a fake "Buy Now" button. Track how many people click before showing a "coming soon" message.
+
+### Deep Tests (weeks)
+- **Prototype** — Build the minimum version. Get real users. Measure retention.
+- **Pilot** — Run the service for real with a small group. Measure satisfaction and willingness to continue.
+
+## Step 4: Go / No-Go Decision
+
+After testing, ask:
+
+| Signal | Go | Pivot | Stop |
+|--------|-----|-------|------|
+| Problem exists? | Strong evidence | Exists but different | No evidence |
+| People will pay? | Pre-sales or commitments | Maybe, need different pricing | Nobody willing |
+| You can reach them? | Clear channel | Channel exists but expensive | No viable channel |
+| Unit economics work? | Profitable per customer | Break-even possible | Loses money per customer |
+| You're the right person? | Unique advantage | Can learn | No relevant edge |
+
+**Go** = most signals green. Proceed to PRD.
+**Pivot** = core insight is valid but the approach needs changing. Revisit discovery with a new angle.
+**Stop** = fundamental assumptions are wrong. Save time and money.
+
+## Output
+
+Save the validated/invalidated assumptions and the go/no-go decision to memory. This feeds directly into the PRD phase.

package/taskmaster-docs/USER-GUIDE.md

@@ -631,6 +631,44 @@ When WhatsApp is connected, you'll see a small gear icon next to the WhatsApp la
 - **Model** — Choose which AI model handles customer messages. You can pick Opus (most capable), Sonnet (balanced), or Haiku (fastest and cheapest). This only affects the public assistant — the model you pick in the Chat page controls your admin assistant separately.
 - **Thinking** — Controls how deeply the public assistant reasons before responding to customers. "Off" is fastest. "Low" through "High" give increasingly thorough reasoning at the cost of speed. Like Model, this only affects the public assistant.
 
+### Branding
+
+Each account can have its own branding — a logo and colour scheme that appears on the control panel and on public chat pages (both the full page and the embeddable widget).
+
+#### What you can customise
+
+| Setting | What it does |
+|---------|-------------|
+| **Logo** | Your business logo, shown on public chat pages alongside your business name |
+| **Accent colour** | The colour used for buttons, links, and interactive elements across the UI |
+| **Background tint** | A subtle colour wash applied to page and card backgrounds |
+
+#### How to set up branding
+
+1. Go to the **Setup** page
+2. Find the **Branding** row in the status dashboard
+3. Click **Edit** — a modal opens with your branding options
+4. **Upload a logo** — click Upload and select an image (PNG, JPEG, SVG, or WebP, max 2 MB)
+5. **Choose your accent colour** — click the colour picker next to "Accent colour" and select your brand colour
+6. **Choose your background tint** — click the colour picker next to "Background tint" to add a subtle background wash (optional)
+7. Click **Close** when you're done — changes are applied immediately
+
+To see what each setting does, click the **(i)** button on the Branding row.
+
+#### Per-account branding
+
+Branding is set per account. If you have multiple accounts, switch to each account using the dropdown at the top of the page and set up branding for each one separately. When you switch accounts, the control panel immediately updates to show that account's colours and logo.
+
+#### Resetting to defaults
+
+To remove all custom branding and return to the default colours, open the Branding modal and click **Reset to defaults**. To remove just the logo, click **Remove** next to the logo preview.
+
+#### Where branding appears
+
+- **Control panel** — accent colour and background tint update immediately across all pages
+- **Public chat page** — visitors see your logo, accent colour, and background tint
+- **Chat widget** — the embedded widget on your website uses your accent colour for the chat button and background tint for the overlay
+
 ---
 
 ## Advanced
@@ -654,7 +692,16 @@ You can also create events by asking the assistant in chat ("remind me every Mon
 
 Skills are the specialised abilities your assistant has — like handling customer enquiries, creating quotes, or checking the weather. This tab shows which skills are installed, whether they're active, and if anything is missing (like an API key a skill needs).
 
-You can enable or disable individual skills from here. Most of the time you won't need to change anything — skills are pre-configured when your device is set up.
+Skills are labelled as **Preloaded** (built-in, always active) or **User** (created by you). You can:
+
+- **Tap any skill** to open a detail view showing its full instructions and reference files
+- **Enable/Disable** a user skill using the toggle button
+- **Edit** a user skill — loads its content so you can save an updated version
+- **Delete** a user skill (with confirmation)
+
+**Creating new skills:** Ask your assistant to help you create a skill — it will walk you through the process step by step and prepare a draft. Once the draft is ready, open the **Drafts** button in the Skills tab to review, install, or delete pending drafts. You don't need to write skill files manually.
+
+Preloaded skills ship with the product and cannot be disabled or deleted.
 
 ### Logs
 
@@ -873,6 +920,15 @@ If the Pi checks pass but the control panel still doesn't load from another devi
 
 ## Troubleshooting
 
+### Can't access the Control Panel?
+
+If you can't load the Control Panel in your browser:
+
+1. **Check the URL** — go to **http://taskmaster.local:18789**. Make sure you're using `http` (not `https`) and port `18789`
+2. **Wait for boot** — after powering on the device, it takes 2–3 minutes for everything to start. If you just plugged it in, give it a moment
+3. **Try a different browser** — some browsers (especially on older devices) have trouble with `.local` addresses. Try Chrome or Safari
+4. **Use the IP address** — if `.local` doesn't resolve, find the device's IP address on your router and go to `http://<ip-address>:18789` instead
+
 ### Messages not getting through?
 
 1. Go to **http://taskmaster.local:18789/setup**
@@ -1310,7 +1366,7 @@ Replace `YOUR-PUBLIC-URL` with the URL shown on the Internet Access row (e.g. `h
 
 A chat button appears in the bottom-right corner of the page. Clicking it opens a chat window where visitors can talk to your assistant — no WhatsApp required.
 
-You can optionally set the button colour to match your website by adding `color: "#your-hex-colour"` to the init options.
+You can optionally set colours to match your website: `color` controls the floating chat button, and `bgColor` controls the chat overlay background. If you've set up branding on the Setup page, the widget uses your brand colours automatically — these init options override them if provided.
 
 ---
 

package/templates/customer/agents/public/AGENTS.md

@@ -71,8 +71,7 @@ memory/
 ├── shared/      # Instructions, lessons (you can access)
 ├── users/       # Per-customer profiles (you can access for this customer)
 │   └── {phone}/
-│       ├── profile.md          # Customer details
-│       └── SOUL-EXTENSION.md   # Personalised tone (if rapport established)
+│       └── profile.md          # Customer details
 └── groups/      # Per-group data (you can access for the current group)
     └── {groupId}/
         ├── members/            # Per-member profiles within this group
@@ -87,18 +86,12 @@ memory/
 Semantic search doesn't reliably find user-specific files. Use `memory_get` with the exact path:
 
 ```
-1. memory_get("memory/users/{phone}/SOUL-EXTENSION.md")
-2. memory_get("memory/users/{phone}/profile.md")
+1. memory_get("memory/users/{phone}/profile.md")
 ```
 
 **Do this for EVERY new conversation**, even if you think they're a new customer. The business owner may have pre-created context you don't know about.
 
-1. **Check for SOUL-EXTENSION.md** — `memory/users/{phone}/SOUL-EXTENSION.md`
-   - Use `memory_get` with the exact path (not memory_search)
-   - If it exists, READ IT and follow its guidance for this customer
-   - This overrides your default behavior for this specific person
-
-2. **Check for existing profile.md** — `memory/users/{phone}/profile.md`
+1. **Check for existing profile.md** — `memory/users/{phone}/profile.md`
    - Use `memory_get` with the exact path (not memory_search)
    - If it exists, READ IT — someone (admin or you previously) has context on this person
    - DO NOT overwrite it with a blank template

package/templates/taskmaster/agents/public/SOUL.md

@@ -26,10 +26,6 @@ Every conversation should leave the prospect closer to understanding Taskmaster'
 
 **Rapport serves the mission.** If someone wants to banter, engage briefly — then steer back. Ask about their business, their pain points, their business challenges. Rapport without purpose is wasted opportunity. After 2-3 exchanges of off-topic chat, pivot: *"So tell me about your business — how do you handle customer messages right now?"*
 
-## User-Scoped Personality
-
-For users you've built rapport with, check `memory/users/{phone}/SOUL-EXTENSION.md` for personalised tone notes. If it exists, adapt your style (more casual, more banter, specific inside jokes) — but the Primary Objectives still apply. Personality can flex; purpose doesn't.
-
 ## What You Do
 
 - Answer questions about Taskmaster (what it is, how it works, pricing)

package/templates/tradesupport/agents/public/AGENTS.md

@@ -71,8 +71,7 @@ memory/
 ├── shared/      # Instructions, lessons (you can access)
 ├── users/       # Per-customer profiles (you can access for this customer)
 │   └── {phone}/
-│       ├── profile.md          # Customer details
-│       └── SOUL-EXTENSION.md   # Personalised tone (if rapport established)
+│       └── profile.md          # Customer details
 └── groups/      # Per-group data (you can access for the current group)
     └── {groupId}/
         ├── members/            # Per-member profiles within this group
@@ -87,18 +86,12 @@ memory/
 Semantic search doesn't reliably find user-specific files. Use `memory_get` with the exact path:
 
 ```
-1. memory_get("memory/users/{phone}/SOUL-EXTENSION.md")
-2. memory_get("memory/users/{phone}/profile.md")
+1. memory_get("memory/users/{phone}/profile.md")
 ```
 
 **Do this for EVERY new conversation**, even if you think they're a new customer. The business owner may have pre-created context you don't know about.
 
-1. **Check for SOUL-EXTENSION.md** — `memory/users/{phone}/SOUL-EXTENSION.md`
-   - Use `memory_get` with the exact path (not memory_search)
-   - If it exists, READ IT and follow its guidance for this customer
-   - This overrides your default behavior for this specific person
-
-2. **Check for existing profile.md** — `memory/users/{phone}/profile.md`
+1. **Check for existing profile.md** — `memory/users/{phone}/profile.md`
    - Use `memory_get` with the exact path (not memory_search)
    - If it exists, READ IT — someone (admin or you previously) has context on this person
    - DO NOT overwrite it with a blank template