Tool Requirements

Last Updated: 2026-04-11

Status: Brainstorm → Implementation Roadmap

Overview

This document outlines the tools needed to manage TekDek personas, content, narratives, and community. Some are critical for MVP; others can wait for Phase 2/3.

Critical Path Tools (MVP Phase 2)

1. Persona Management System

Purpose: Central hub for persona profiles, voice guides, platform presence tracking, and character consistency.

Must-have features:

  • Persona profile (name, expertise, voice/tone guide, relationships)
  • Platform presence tracking (which channels they publish on)
  • Voice guide (how they write, speak, communicate)
  • Personality consistency rules
  • History/timeline (articles, posts, video links)

Can be: Markdown docs + knowledge base, or simple database/spreadsheet

2. Storyline & Narrative Planning Tool

Purpose: Track character arcs, plan narrative beats, schedule content tie-ins, and coordinate drama.

Must-have features:

  • Arc planner (3–6 month timelines, character involvement, key beats)
  • Content calendar tied to narrative
  • Conflict/collaboration tracker
  • Engagement hooks planning
  • Curated content log (approve/reject before publication)

Can be: Markdown docs + spreadsheet, or custom dashboard

3. Content Curation & Approval System

Purpose: Central intake for persona-generated content; review for accuracy, narrative fit, and voice consistency.

Must-have features:

  • Content submission form (title, draft, persona, arc tie-in)
  • Approval workflow (pending, approved, rejected with feedback)
  • Scheduling (publish date/time, multi-platform coordination)
  • Consistency check (matches persona's voice?)
  • SEO/tagging (keywords, trending alignment)

Can be: Simple form + spreadsheet, or integrated into Persona Portal

Phase 2 Tools (MVP Nice-to-Have)

4. Persona Agent Framework

Purpose: AI agents that generate content drafts in each persona's voice.

Must-have features:

  • Voice consistency (trained on persona's previous work)
  • Topic/expertise alignment
  • Multi-format output (blog posts, social media, code comments)
  • Draft generation (not auto-publish; requires curation)

Tech approach: Fine-tuned LLM or prompt engineering with persona voice guide + examples

5. Content Syndication System

Purpose: Pull content from persona's independent platforms into Stack Legion aggregation.

Must-have features:

  • Feed ingestion (RSS, API, webhook)
  • Metadata extraction (title, date, persona, expertise tag)
  • Cross-linking (persona's site + Stack Legion)
  • Attribution (credit the original source)

Can be: Custom integrations or use existing tools like IFTTT, Zapier

Phase 3+ Tools (Growth & Scale)

6. Persona Portal

Purpose: Publishing and identity management platform for personas.

Must-have features:

  • Publishing interface (write, schedule, preview)
  • Analytics dashboard (views, engagement)
  • Revenue tracking
  • Branding tools (custom templates, fonts, colors)
  • Community moderation (comments, interactions)

Status: Under development by external team

7. Community & Gamification System

Purpose: Stack Legion member engagement through challenges, points, leaderboards.

Must-have features:

  • Challenge creation (persona-authored coding challenges)
  • Points/badges system
  • Leaderboards (global, per-challenge, per-persona)
  • Member-exclusive content

Status: Part of Stack Legion site (external team)

8. Analytics & Growth Dashboard

Purpose: Track engagement, SEO, trending alignment, and narrative arc performance.

Must-have features:

  • Persona performance (views, engagement)
  • Narrative arc metrics (virality, user investment)
  • SEO tracking (search rankings, traffic sources)
  • Trending alignment
  • Cohort analysis

Can be: Google Sheets + custom queries, or custom dashboard

Build vs. Buy vs. Integrate

Build (Internal)

  • Persona Management System: Custom markdown docs + knowledge base
  • Storyline Planning: Custom docs + spreadsheet
  • Content Curation: Custom form + workflow
  • Persona Agent Framework: Custom OpenClaw agents

Buy / Integrate (External)

  • Persona Portal: Currently under external development
  • Community & Gamification: Part of Stack Legion
  • Syndication: Zapier, IFTTT, or custom API
  • Analytics: Google Sheets, Mixpanel, or custom dashboard

Partner / Outsource

  • Stack Legion site: External development team
  • Video hosting: YouTube, TikTok (personas own these)
  • Course platform: Udemy, Teachable, or custom

Current Infrastructure

Domains

  • Gitea: git.tekdek.dev — Git repository hosting
  • BookStack: docs.tekdek.dev — Documentation wiki
  • Website: web.tekdek.dev — Main site (this page)

Tech Stack

  • PHP (no framework — lean and intentional)
  • Markdown for content storage
  • CSS (custom, no frameworks)
  • Vanilla JavaScript
  • PostgreSQL (if database needed)