# TekDek Project Overview & File Guide

**Last Updated**: 2026-04-11  
**Status**: Phase 0 (Planning & Discovery)  
**Owner**: Glytcht (Product/Client), ParzivalTD (Operations)

---

## What Is This?

This document maps the entire TekDek project strategy, files, and current status in one place. Use this to:
- Understand the project structure
- Find specific documents
- Track progress across phases
- Coordinate between teams

---

## Project Structure at a Glance

```
TekDek
├── Strategy Documents (What we're building)
├── Persona System (Who they are)
├── Narrative Engine (How we tell the story)
├── Content & Curation (What gets published)
├── Project Management (Timeline, phases, status)
└── Monitoring & Tracking (Where are we now?)
```

---

## Core Files by Purpose

### 📋 STRATEGY & VISION

**File**: `/knowledge/TekDek-Strategy.md` (7.3KB)  
**Purpose**: Full vision statement, three layers, persona model, narrative engine  
**Read when**: You want to understand the "why" and overall approach  
**Key sections**:
- Executive summary
- The three layers (business, technical, narrative)
- Persona model details
- Narrative engine explanation
- Phase breakdown
- Success metrics

**File**: `/TekDek-Brainstorm-Reference.md` (6.8KB)  
**Purpose**: One-page quick reference for fast decision-making  
**Read when**: You need to make a quick decision or brief someone  
**Key sections**:
- TL;DR
- Model overview
- Critical path (next 30 days)
- Persona roster sketches
- Narrative arc ideas
- Open questions

### 🎯 MASTER PROJECT PLAN

**File**: `/knowledge/TekDek-Master-Project-Plan.md` (30.3KB) 🔴 **START HERE**  
**Purpose**: Complete roadmap for both TekDek Management and Development Team  
**Read when**: You want to understand the full execution plan  
**Key sections**:
- Phase overview (0–4, with timelines)
- Phase 0 deliverables (this week/month)
- Phase 1 deliverables (content, personas, narrative)
- Phase 2 deliverables (MVP launch)
- Phase 3 deliverables (scale & expansion)
- Phase 4 deliverables (multi-vertical)
- Decision checkpoints (when you must decide)
- Success criteria per phase
- Risk register & mitigation
- Open questions for dev team & you

**File**: `/Master-Plan-Quick-Checklist.md` (5.4KB)  
**Purpose**: Your decision checklist for Phase 0  
**Read when**: You need to know what decisions to make this week  
**Key sections**:
- 5 critical decisions (Brick specialty, personas, arc, revenue, launch date)
- My deliverables this week
- Phase timeline
- Critical success factors

### 👥 PERSONA SYSTEM

**File**: `/knowledge/Tool-Requirements.md` (7.9KB)  
**Section**: "Persona Management System"  
**Purpose**: Spec for how we store, track, and manage personas  
**What it defines**: Persona profile data model, voice guides, relationships, content history

**File**: `/knowledge/personas/Brick-Profile.md` (7KB)  
**Purpose**: First persona prototype (template for personas 2–10)  
**Read when**: You want to understand persona structure and voice consistency  
**Key sections**:
- Profile (name, expertise, elevator pitch)
- Voice & tone guide (directness, vulnerability, authority, mentorship)
- Consistency rules (across blog, social, video, GitHub, Stack Legion)
- Consistency checklist (pre-publish review)
- Relationships (allies, rivals, neutral)
- Content log (where has he published)
- Character arc & evolution
- Agent configuration (for AI drafting)

### 📖 NARRATIVE SYSTEM

**File**: `/knowledge/Tool-Requirements.md` (7.9KB)  
**Section**: "Storyline & Narrative Planning Tool"  
**Purpose**: Spec for how we plan, track, and execute narrative arcs  
**What it defines**: Arc timeline, beats, character involvement, content tie-ins, engagement hooks

**File**: [PENDING — Create during Phase 0]  
**Name**: `Narrative-Arc-Template.md`  
**Purpose**: Standard template for planning all narrative arcs  
**Will include**: Arc structure, beat planning, content calendar tie-in, engagement hooks

### 🛠️ TOOLS & INFRASTRUCTURE

**File**: `/knowledge/Tool-Requirements.md` (7.9KB) 🔴 **KEY DOCUMENT**  
**Purpose**: Complete spec of what tools we need to build/buy  
**Read when**: You want to understand what systems support the strategy  
**Key sections**:
- Persona Management System
- Storyline & Narrative Planning Tool
- Content Curation & Approval System
- Persona Agent Framework
- Content Syndication System
- Persona Portal (external dev)
- Community & Gamification (external dev)
- Analytics & Growth Dashboard

---

## Project Status & Tracking

### 📊 Current Phase: Phase 0 (Discovery & Planning)

**Timeline**: Now — Week 4 (through end of week)  
**Goal**: Lock decisions, design systems, prepare for Phase 1  

**Status**:
- ✅ Strategy documented
- ✅ Master project plan created
- 🔴 PENDING: Your 5 critical decisions

**File**: [See Master-Plan-Quick-Checklist.md above]

### 🗓️ Phase Timeline

| Phase | Dates | Goal | Status |
|-------|-------|------|--------|
| **Phase 0** | Now–Week 4 | Decisions & design | 🟡 IN PROGRESS |
| **Phase 1** | Week 5–12 | Build & test | 🔲 NOT STARTED |
| **Phase 2** | Week 13–16 | MVP launch | 🔲 NOT STARTED |
| **Phase 3** | Week 17–24 | Scale | 🔲 NOT STARTED |
| **Phase 4** | Week 25+ | Expand | 🔲 PLANNED |

### 📈 Success Metrics

**Phase 0** (End of this month):
- ✅ All 5 critical decisions made
- ✅ 5–9 personas defined
- ✅ First narrative arc planned
- ✅ Content curation workflow finalized
- ✅ Persona roster system designed
- ✅ Dev team has clear spec

**Phase 1** (Week 5–12):
- 3 personas with proven voice consistency
- 8–10 quality articles published
- Arc 1 live and engaging users
- Portal MVP complete
- APIs operational

**Phase 2** (Week 13–16):
- Stack Legion MVP public
- 500+ registered users
- Revenue generating

---

## Decision Log

### 🔴 DECISIONS NEEDED (THIS WEEK)

**Decision 1: Brick's Technical Specialty**
- [ ] Backend
- [ ] DevOps/Infrastructure
- [ ] Full-stack
- [ ] Architecture
- [ ] Database design
- [ ] Other: ________

**Decision 2: Initial Persona Roster (Personas 2–10)**
- [ ] Persona 2: ________ (Expertise: ________)
- [ ] Persona 3: ________ (Expertise: ________)
- [ ] Persona 4: ________ (Expertise: ________)
- [ ] Persona 5: ________ (Expertise: ________)
- [ ] Persona 6: ________ (Expertise: ________)
- [ ] ... (5–9 total)

**Decision 3: First Narrative Arc**
- [ ] Type: Conflict? Collaboration? Learning journey? Other?
- [ ] Characters: Which personas?
- [ ] Timeline: 3 months? 6 months?
- [ ] Engagement hook: What draws users in?

**Decision 4: Revenue Model**
- [ ] Membership pricing (Free / $X/mo)
- [ ] Course pricing ($X each)
- [ ] Persona revenue share (X% / Y%)
- [ ] Sponsorships / Other

**Decision 5: Launch Target**
- [ ] Q3 2026 (July–Sept)
- [ ] Q4 2026 (Oct–Dec)
- [ ] Q1 2027 (Jan–Mar)
- [ ] Other: ________

---

## Where Everything Lives

```
Workspace Root: /data/.openclaw/workspace/

├── PROJECT-OVERVIEW.md (THIS FILE)
├── Master-Plan-Quick-Checklist.md
├── TekDek-Brainstorm-Reference.md
│
├── /knowledge/
│   ├── TekDek-Strategy.md (FULL VISION)
│   ├── TekDek-Master-Project-Plan.md (FULL ROADMAP)
│   ├── Tool-Requirements.md (SPECS)
│   │
│   └── /personas/
│       ├── Brick-Profile.md (FIRST PERSONA)
│       ├── Persona-Template.md (FOR PERSONAS 2–10)
│       └── [Persona profiles as we create them]
│
├── /memory/
│   ├── 2026-04-11.md (DAILY LOG - BOOTSTRAP)
│   └── 2026-04-11-extended.md (FULL SESSION LOG)
│
├── MEMORY.md (LONG-TERM MEMORY)
├── SOUL.md (PARZIVAL'S IDENTITY)
├── IDENTITY.md (PROJECT IDENTITY)
├── USER.md (GLYTCHT PROFILE)
│
├── /skills/
│   ├── qmd/ (KNOWLEDGE BASE SEARCH)
│   ├── self-improving/ (AGENT LEARNING)
│   ├── bookstack/ (WIKI INTEGRATION)
│   └── gitea/ (GIT INTEGRATION)
│
└── [Other files...]
```

### Quick Navigation

**"I want to understand the full strategy"**  
→ Start: `/knowledge/TekDek-Strategy.md` (15 min read)

**"I want to understand the execution plan"**  
→ Start: `/knowledge/TekDek-Master-Project-Plan.md` (30 min read)

**"I need to make a decision"**  
→ Start: `/Master-Plan-Quick-Checklist.md` (5 min read)

**"I want to see today's session notes"**  
→ `/memory/2026-04-11-extended.md`

**"I want to understand the persona system"**  
→ Start: `/knowledge/personas/Brick-Profile.md` (template)

**"I want to see what tools we need"**  
→ `/knowledge/Tool-Requirements.md` (section: "Critical Path Tools")

---

## How to Review Files

### Recommended Reading Order

**First Pass** (30 minutes):
1. This file (PROJECT-OVERVIEW.md)
2. `/Master-Plan-Quick-Checklist.md`
3. `/TekDek-Brainstorm-Reference.md`

**Second Pass** (1 hour):
1. `/knowledge/TekDek-Strategy.md` (sections: Executive Summary, Vision, Three Layers)
2. `/knowledge/TekDek-Master-Project-Plan.md` (sections: Phase 0, Phase 1, Decision Checkpoints)

**Deep Dive** (2+ hours):
1. Full `/knowledge/TekDek-Master-Project-Plan.md`
2. `/knowledge/Tool-Requirements.md`
3. `/knowledge/personas/Brick-Profile.md`

### How to Use These Files

**For Decision-Making**:
- Read `/Master-Plan-Quick-Checklist.md`
- Make your 5 decisions
- Update the DECISION LOG (this file)
- Notify ParzivalTD

**For Phase Planning**:
- Go to `/knowledge/TekDek-Master-Project-Plan.md`
- Find your phase (Phase 0, 1, 2, etc.)
- Review deliverables, timeline, success criteria
- Coordinate with ParzivalTD on blockers

**For Progress Tracking**:
- Check `/memory/` for daily/session logs
- Review DECISION LOG (this file)
- Track phase status above

---

## Next Steps

### For Glytcht (You)

1. **Read** `/Master-Plan-Quick-Checklist.md` (5 min)
2. **Decide** on your 5 critical decisions (Decision 1–5)
3. **Notify** ParzivalTD when ready
4. **Review** `/knowledge/TekDek-Master-Project-Plan.md` for full context
5. **Schedule** weekly sync with dev team (TBD time)

### For ParzivalTD (Me)

1. ✅ Create all strategy documents
2. ✅ Create Master Project Plan
3. ✅ Create this overview file
4. 🔄 AWAITING: Your 5 decisions
5. Then: Finalize Brick profile, create persona templates, design systems

### For Development Team

1. Review `/knowledge/TekDek-Master-Project-Plan.md`
2. Answer open questions (tech stack, timeline, APIs)
3. Propose Phase 0 deliverables on your end
4. Schedule first sync with TekDek team

---

## File Maintenance

**This document** is your north star. Update it as:
- Decisions are made → Update DECISION LOG
- Phases complete → Update PROJECT STATUS
- New files are created → Update WHERE EVERYTHING LIVES
- New deliverables → Update by phase sections

**Commit frequency**: After major updates (decisions, phase completion)  
**Review frequency**: Weekly during Phase 0–2, bi-weekly Phase 3+

---

## Questions?

Refer to:
- **"What do I decide?"** → `/Master-Plan-Quick-Checklist.md`
- **"When do I decide it?"** → `/knowledge/TekDek-Master-Project-Plan.md` → Decision Checkpoints
- **"How does this work?"** → `/knowledge/TekDek-Strategy.md`
- **"What gets built?"** → `/knowledge/Tool-Requirements.md`

---

## Document Version History

| Version | Date | Changes |
|---------|------|---------|
| 1.0 | 2026-04-11 | Initial creation, Phase 0 planning |
| — | — | — |
