ParzivalTD/Brain
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
eacccd5bb94927fc16b38738b07b8469a6a8614f
Brain/PROJECT-OVERVIEW.md

11 KiB
Raw Blame History

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
— — —
Reference in New Issue View Git Blame Copy Permalink