"Attack the market. Armor the business."

The Playbook is a premium AI-powered positioning intelligence platform that analyzes your business copy from both offensive and defensive perspectives. Think of it as having an elite coaching staff that gives you the plays they don't teach — and the defense they can't break.

The Playbook analyzes your positioning copy (websites, sales pages, pitch decks, etc.) through 8 specialized AI lenses — 4 offensive and 4 defensive — giving you:

• Core belief extraction from your copy
• Offensive analysis to find market attack opportunities
• Defensive analysis to identify vulnerabilities before competitors do
• Phoenix Fortress combined analysis for total market dominance

It's like having a $50,000 strategic consultant available 24/7.

"Rise. Strike. Dominate."

The Unstoppable Force. Finds opportunities others miss and turns your positioning into a weapon.

"Stand. Shield. Survive."

The Immovable Object. Protects your position from every angle of attack.

"Total. Market. Dominance."

When the Unstoppable Force meets the Immovable Object. Complete strategic command.

• ✅ AI-Powered Belief Extraction — Distills your copy into 5-7 core positioning beliefs
• ✅ 8 Strategic Lenses — 4 offensive + 4 defensive perspectives
• ✅ Clarity Scoring — 0-100 score with actionable feedback
• ✅ Phoenix Fortress Analysis — Premium combined offense + defense report
• ✅ Document Management — Upload, organize, and re-analyze your copy

• ✅ First-Run Setup Wizard — Guided initial configuration
• ✅ Tiered Access Control — Rookie → Starter → MVP
• ✅ Session-Based Auth — Secure cookie-based authentication
• ✅ Usage Tracking — Analytics for feature usage
• ✅ Responsive UI — Works on desktop and mobile

• Runtime: Deno (Val Town)
• Framework: Hono 4.4
• Database: SQLite (libSQL)
• AI: OpenAI GPT-4o
• Frontend: React 18 (CDN + Babel)
• Styling: CSS-in-JS (generated)

/playbook
├── index.ts              # Main entry point & Hono server
├── config.ts             # App constants, mascots, tiers, lenses
├── types.ts              # TypeScript interfaces & type guards
├── database.ts           # SQLite schema, migrations, CRUD operations
├── auth.ts               # Authentication service & middleware
├── engine.ts             # AI analysis engine (OpenAI integration)
├── api.ts                # REST API route handlers
├── setup.ts              # First-run setup wizard
├── utils.ts              # Helper utilities
└── ui/
    ├── pages.ts          # HTML page generators
    └── styles.ts         # CSS stylesheet generator

• Val Town account (or Deno runtime)
• OpenAI API key (configured in Val Town)

1. Clone/Import the project into Val Town

2. Run the application — On first run, you'll see the Setup Wizard

3. Complete Setup:

   • Enter your admin email
   • Optionally add your name and company
   • Accept terms and initialize

4. Start Analyzing:

   • Upload your first document (website copy, sales page, etc.)
   • View extracted positioning beliefs
   • Run offensive and defensive analyses
   • Get actionable recommendations

The following should be configured in Val Town:

Authenticate or create a user by email.

// Request
{ "email": "coach@company.com", "name": "Coach Johnson" }

// Response
{ "success": true, "message": "Welcome to The Playbook", "user": {...} }

End the current session.

Get the current authenticated user.

List all documents for the authenticated user.

Upload and analyze a new document.

// Request
{ "title": "Homepage V2", "text": "Your positioning copy here..." }

// Response
{ "success": true, "document": {...}, "beliefs": [...], "score": 75 }

Get a specific document.

Delete a document and all analyses.

Get extracted beliefs for a document.

Get all analyses run on a document.

Run an offensive (Phoenix) analysis.

// Request
{ "documentId": "doc_xxx", "lensId": "MarketDisruptor" }

// Response
{
  "success": true,
  "lens": { "id": "MarketDisruptor", "name": "The Market Disruptor", ... },
  "mascot": { "name": "The Phoenix", ... },
  "analysis": {
    "score": 72,
    "strengths": [...],
    "gaps": [...],
    "plays": [...],
    "summary": "..."
  }
}

Run a defensive (Fortress) analysis.

// Request
{ "documentId": "doc_xxx", "lensId": "SkepticalProspect" }

// Response
{
  "success": true,
  "lens": { "id": "SkepticalProspect", ... },
  "mascot": { "name": "The Fortress", ... },
  "analysis": {
    "score": 68,
    "protected": [...],
    "exposed": [...],
    "fortifications": [...],
    "summary": "..."
  }
}

Run a combined Phoenix Fortress analysis (Starter+ only).

// Request
{ "documentId": "doc_xxx" }

// Response
{
  "success": true,
  "mascot": { "name": "Phoenix Fortress", ... },
  "analysis": {
    "offensiveScore": 74,
    "defensiveScore": 68,
    "combinedScore": 71,
    "executiveSummary": "...",
    "topPlays": [...],
    "criticalFortifications": [...],
    "ultimateStrategy": "The cheat code..."
  }
}

Get available subscription tiers.

Upgrade to a new tier.

// Request
{ "tier": "tier_starter" }

// Response
{ "success": true, "message": "Welcome to Starter!", "user": {...} }

Get all lenses with access status for the current user.

Get mascot information.

Health check endpoint.

1. "Attack the market. Armor the business." — Primary
2. "Every angle. Every outcome. Every advantage." — Comprehensive
3. "The plays they don't teach. The defense they can't break." — Insider knowledge
4. "Win the deal. Survive the scrutiny." — Outcomes
5. "Tribal knowledge, weaponized." — Expert edge

• Confident — We know what we're talking about
• Direct — No fluff, no filler
• Strategic — Always thinking three moves ahead
• Empowering — We're here to help you win

# Install Deno
curl -fsSL https://deno.land/install.sh | sh

# Run the application
deno run --allow-net --allow-env index.ts

If you need to reset the database during development:

import { resetDatabase } from "./database.ts";
await resetDatabase(); // WARNING: Deletes all data

1. Add the lens definition to config.ts:

// In OFFENSIVE_LENSES or DEFENSIVE_LENSES
{
  id: "NewLensId",
  name: "The New Lens",
  emoji: "🆕",
  squad: "phoenix", // or "fortress"
  description: "What this lens does.",
  bias: "The lens's perspective quote.",
  focus: ["Focus area 1", "Focus area 2", ...],
  requiredTier: "tier_starter",
}

2. The engine will automatically pick it up — no other changes needed!

• Users → Documents (1:many)
• Documents → Analyses (1:many)
• Users → Playbook Reports (1:many)

• Session-based auth with HTTP-only cookies
• User-scoped data — users can only access their own documents
• Input validation with Zod schemas
• SQL injection protection via parameterized queries
• XSS protection via HTML entity escaping

• Add rate limiting
• Implement proper payment processing (Stripe)
• Add email verification
• Enable HTTPS only
• Add audit logging
• Implement backup strategy

• PDF export of analyses
• Document comparison tool
• Analysis history timeline
• Team collaboration features

• Custom lens creation
• Industry-specific lens packs
• API access for integrations
• White-label reporting

• Real-time collaborative editing
• Competitor tracking
• A/B test recommendations
• Automated improvement suggestions

We welcome contributions! Please:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

• Use TypeScript strict mode
• Document all functions with JSDoc
• Follow existing naming conventions
• Write meaningful commit messages

MIT License — see LICENSE for details.

• OpenAI for GPT-4o
• Val Town for the hosting platform
• Hono for the lightweight framework
• The positioning strategists who inspired the lens philosophies