Phase 0: Complete strategy docs, project overview, status tracker, memory update
This commit is contained in:
OpenClaw
375
PROJECT-OVERVIEW.md
Normal file
375
PROJECT-OVERVIEW.md
Normal file
@@ -0,0 +1,375 @@
|
||||
# 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
Block a user