@rubytech/taskmaster 1.12.1 → 1.12.3

package/templates/beagle-taxi/memory/public/knowledge-base.md

@@ -0,0 +1,177 @@
+# Beagle Knowledge Base
+
+Public-facing information about the Beagle business — suitable for investors, potential partners, journalists, and general enquiries.
+
+---
+
+## About Beagle
+
+Beagle is a WhatsApp-based ride matching company. It connects travellers with local self-drive taxi owners in tourist destinations — negotiating fair fares, verifying pickups, and confirming bookings, all within a WhatsApp conversation.
+
+- **Live in:** Zanzibar
+- **Model:** Traveller messages on WhatsApp → Beagle's agent contacts local drivers → negotiates competing fares → presents the best offer → traveller confirms with a small booking fee → ride happens
+- **Revenue:** 5% booking fee ($2 minimum), paid by the traveller at booking time
+- **Driver economics:** Drivers keep 95% of the agreed fare. No sign-up fee, no app, no commission deduction.
+- **Distribution:** WhatsApp — 2+ billion users, already installed, no onboarding friction
+
+---
+
+## How the Service Works
+
+### For Travellers
+1. Message Beagle on WhatsApp with where you're going, when, and how many people
+2. Beagle's agent contacts local drivers and negotiates on your behalf in the local language
+3. Compare up to 3 offers — fare, driver rating, vehicle type
+4. Confirm and pay a small booking fee via secure card payment
+5. Receive driver details — name, car, plate number, and a pickup PIN
+6. Meet your driver — verify with the PIN, enjoy the ride
+7. Pay the rest directly to your driver at the end of the journey
+
+### For Drivers
+1. Beagle messages you on WhatsApp with a fare request — like a normal booking enquiry
+2. Quote your fare for the route
+3. If selected, Beagle confirms the booking with passenger details and a QR code
+4. Meet the passenger at the pickup point. They verify with a PIN.
+5. Complete the ride and receive payment directly from the passenger
+
+---
+
+## Business Model & Economics
+
+### Revenue
+- 5% booking fee on every confirmed ride ($2 minimum)
+- Paid by the traveller via Stripe at booking time
+- Non-refundable — acts as a commitment device
+
+### Unit Economics
+- **Driver receives:** 95% of the negotiated fare, paid directly by the traveller
+- **Beagle receives:** 5% booking fee
+- **Compare:** Ride-hailing apps take 25-30%. Hotel transfers mark up ~50%. Beagle takes 5%.
+
+### Expansion Economics
+- No app to build or maintain
+- No mapping infrastructure needed
+- Each new market requires: driver WhatsApp numbers + local geographic knowledge
+- Setup measured in days, not months
+- WhatsApp is already the dominant messaging platform in target markets
+
+---
+
+## Market Opportunity
+
+### Why Tourist Transport
+- Tourists have the highest willingness to pay but the least local knowledge
+- Language barriers make direct negotiation unfair
+- Existing ride-hailing apps have poor coverage in many tourist destinations
+- WhatsApp is already how locals communicate — zero adoption friction
+
+### Zanzibar (Live Market)
+- 600,000+ international tourists per year
+- Airport transfers are the first booking for nearly every arrival
+- No dominant ride-hailing platform
+- WhatsApp is the primary communication channel
+- Self-drive taxi owners are the backbone of ground transport
+
+### Target Markets
+Markets that share the Zanzibar pattern: high tourist volume, fragmented taxi supply, WhatsApp-dominant communication, no entrenched ride-hailing platform.
+
+---
+
+## Comparison
+
+| | Going Direct | Hotel Transfer | Ride-hailing App | Beagle |
+|---|---|---|---|---|
+| Fair price | Tourist markup* | ~50% markup | Algorithm-set** | Market-set |
+| Pre-arrival booking | Sometimes | Yes | Yes | Yes |
+| Driver rated | No | No | Yes | Yes |
+| Verified pickup | No | No | Yes | Yes |
+| Driver's share | 100%* | ~50% | 70-75% | 95% |
+| Language barrier | High | Medium | Low | None |
+| App required | No | No | Yes | No |
+| Works on WhatsApp | No | No | No | Yes |
+
+\* Going direct: driver keeps 100% but charges inflated tourist markup — you're negotiating without local knowledge, language, or leverage.
+
+\*\* Ride-hailing apps set prices algorithmically — fairer for passengers than going direct, but drivers lose 25-30% to the platform.
+
+---
+
+## Trust & Safety
+
+- **Verified pickup:** 4-digit PIN sent to traveller, QR code sent to driver. Works offline — no internet needed at the airport.
+- **WhatsApp trail:** Every interaction recorded in the chat. Fare agreed, driver confirmed, pickup details sent.
+- **Driver ratings:** After every ride, travellers rate drivers on cleanliness, politeness, safety, local knowledge, and punctuality.
+- **Driver selection:** Ratings, response rates, and trip history determine which drivers receive fare requests. Consistently poor drivers are deprioritised.
+
+---
+
+## Zanzibar — Market Detail
+
+### Common Routes
+
+| Route | Typical Fare Range | Journey Time |
+|-------|-------------------|-------------|
+| Airport ↔ Stone Town | $15–25 | 30–45 min |
+| Airport ↔ Nungwi / Kendwa (north) | $45–65 | 60–90 min |
+| Airport ↔ Paje / Jambiani (east) | $35–50 | 45–75 min |
+| Airport ↔ Kizimkazi (south) | $40–55 | 50–70 min |
+| Airport ↔ Matemwe (northeast) | $40–60 | 60–80 min |
+
+*Fares are approximate and vary by vehicle type, time of day, and season. The market sets the price — these ranges reflect what independent drivers typically charge.*
+
+### Popular Destinations
+- **Stone Town** — hotels, restaurants, harbour, historical tours
+- **Nungwi Beach** — north coast, popular with tourists, lively nightlife
+- **Kendwa Beach** — north coast, calmer, full moon parties
+- **Paje Beach** — east coast, kite surfing, backpacker-friendly
+- **Jambiani** — east coast, quieter, local village feel
+- **Kizimkazi** — south coast, dolphin tours
+- **Jozani Forest** — red colobus monkey habitat, central island
+
+### Seasonal Patterns
+- **High season:** June–October, December–February. More tourists, drivers busier, book earlier.
+- **Low season:** March–May. Fewer tourists but still operational. Drivers more available.
+- **Long rains:** March–May. Some roads rough, journey times may increase.
+
+---
+
+## Frequently Asked Questions
+
+### About the Business
+
+**What is Beagle?**
+A WhatsApp-based ride matching company. We connect travellers with local self-drive taxi owners, negotiate fair fares, and confirm bookings — entirely via WhatsApp.
+
+**How does Beagle make money?**
+A 5% booking fee ($2 minimum) paid by the traveller when they confirm a ride. The driver keeps 95%.
+
+**How is this different from Uber?**
+No app. No algorithmic pricing. No 25-30% commission. Beagle runs on WhatsApp, fares are set by competing drivers, and drivers keep nearly everything. It's built for markets where ride-hailing apps don't fit.
+
+**How does Beagle expand to new markets?**
+Each market needs driver WhatsApp numbers and local geographic knowledge. No app infrastructure, no mapping systems. Setup takes days, not months.
+
+### About the Service
+
+**Do I need to download an app?**
+No. Everything happens on WhatsApp. If you can send a message, you can book a ride.
+
+**How do I know the price is fair?**
+You see up to 3 competing offers from independent drivers. You compare fare, driver rating, and vehicle type. Competition sets the price, not an algorithm.
+
+**Is it safe?**
+Every ride has a verified pickup (offline PIN check), a WhatsApp trail, and driver ratings from previous passengers. You always know who's driving you.
+
+**How much does it cost?**
+A 5% booking fee ($2 minimum) paid by card when you confirm. The rest goes directly to your driver at the end of the ride — cash, card, or mobile money.
+
+### For Drivers
+
+**How do I join?**
+Message Beagle on WhatsApp. No sign-up fee, no app, no commission — just a 5% booking fee from the passenger's side.
+
+**How much do I keep?**
+95% of the agreed fare. The 5% comes from the traveller, not you.
+
+**What is Beagle Dispatcher?**
+An AI-powered assistant that negotiates fares and manages bookings on your behalf — even while you're mid-journey. Coming soon.

package/templates/beagle-taxi/skills/beagle-taxi/SKILL.md

@@ -0,0 +1,44 @@
+---
+name: beagle-taxi
+description: "Guides how the agent represents the Beagle business — handling enquiries from investors, partners, travellers, and drivers via the corporate site."
+metadata: {"taskmaster":{"always":true}}
+---
+
+# Beagle Corporate — Enquiry Handling
+
+## Your Role
+
+You represent the Beagle business on its corporate site. You answer questions, explain the model, and capture interest. You do not book rides or manage operations.
+
+## Knowledge Source
+
+Your business knowledge lives in `memory/public/knowledge-base.md`. This is your single source of truth for facts, figures, FAQs, routes, and market data. Search memory before answering any factual question.
+
+If the knowledge base doesn't cover what's being asked, say so. Don't invent figures or extrapolate beyond what's documented.
+
+## Handling Different Audiences
+
+**Investors and partners** — Focus on the model, economics, and expansion story. Be honest about what's live vs planned. Don't overstate traction. If they express interest, capture their details for operator follow-up.
+
+**Travellers** — Explain how the service works from their perspective. If they want to book a ride, direct them to the Beagle WhatsApp number for their market. You don't handle bookings.
+
+**Drivers** — Explain the economics (95% retention, no fees, no app). If they want to join, direct them to the Beagle WhatsApp number. You don't onboard drivers.
+
+**General curiosity** — Answer from the knowledge base. Keep it concise. Don't volunteer the full pitch unprompted.
+
+## Capturing Interest
+
+When someone expresses interest in investing, partnering, or joining as a driver in a new market:
+
+1. Acknowledge their interest
+2. Collect: name, contact method, what they're interested in
+3. Store in memory for operator follow-up
+4. Don't make commitments, discuss terms, or quote financials beyond what's in the knowledge base
+
+## What You Never Do
+
+- Book rides or manage operational workflows
+- Share internal data not in the knowledge base
+- Make investment commitments or discuss terms
+- Overstate what Beagle has achieved
+- Invent numbers when you don't have them

package/templates/customer/agents/admin/BOOTSTRAP.md

@@ -105,9 +105,9 @@ Tell them:
 - Messages from their authorized phone number will reach you (the admin assistant) instead
 - You'll learn their business as you go
 
-## Step 11: Delete This File
+## Step 11: Complete Setup
 
-Once setup is complete, create a file called `.bootstrap-done` in this directory (empty content is fine), then delete this file. The `.bootstrap-done` marker prevents this onboarding from reappearing.
+Once all steps are done, call the `bootstrap_complete` tool (no parameters needed). It will mark setup as complete so this guide never appears again.
 
 ---
 

package/templates/education-hero/agents/admin/BOOTSTRAP.md

@@ -105,9 +105,9 @@ Tell them:
 - Messages from their authorized phone number will reach you (the admin assistant) instead
 - You'll learn their business as you go
 
-## Step 11: Delete This File
+## Step 11: Complete Setup
 
-Once setup is complete, create a file called `.bootstrap-done` in this directory (empty content is fine), then delete this file. The `.bootstrap-done` marker prevents this onboarding from reappearing.
+Once all steps are done, call the `bootstrap_complete` tool (no parameters needed). It will mark setup as complete so this guide never appears again.
 
 ---
 

package/templates/maxy/agents/admin/BOOTSTRAP.md

@@ -25,6 +25,5 @@ If they want to set up admin access from specific devices, help them do that now
 
 ## Step 5: Complete
 
-1. Delete this file
-2. Create `.bootstrap-done` sentinel file
-3. Confirm setup is complete
+1. Call the `bootstrap_complete` tool (no parameters). It marks setup complete so this guide never appears again.
+2. Confirm to the user that setup is done.

package/templates/taskmaster/agents/admin/BOOTSTRAP.md

@@ -30,9 +30,9 @@ If yes, use the `authorize_admin` tool with the phone number (international form
 - Prospects can message anytime — they'll get helpful info but can't access config
 - Admin can update anything via self-chat or authorized devices
 
-## Step 5: Delete This File
+## Step 5: Complete Setup
 
-Once setup is complete, create a file called `.bootstrap-done` in this directory (empty content is fine), then delete this file. The `.bootstrap-done` marker prevents this onboarding from reappearing.
+Once all steps are done, call the `bootstrap_complete` tool (no parameters needed). It will mark setup as complete so this guide never appears again.
 
 ---
 

package/templates/tradesupport/agents/admin/BOOTSTRAP.md

@@ -66,9 +66,9 @@ Tell them:
 - They (admin) get full access to configure everything
 - You'll learn their business as you go
 
-## Step 8: Delete This File
+## Step 8: Complete Setup
 
-Once setup is complete, create a file called `.bootstrap-done` in this directory (empty content is fine), then delete this file. The `.bootstrap-done` marker prevents this onboarding from reappearing.
+Once all steps are done, call the `bootstrap_complete` tool (no parameters needed). It will mark setup as complete so this guide never appears again.
 
 ---