Files

T

wh-leader f252241f9e docs: add implementation roadmap with task dependency graph and acceptance gates

2026-05-08 12:57:12 +02:00

9.1 KiB

Raw Blame History

Personal Portfolio Implementation Roadmap

Project: davidaragon.impresion3d.pro
Goal: Professional portfolio + dev blog for indie builder
Timeline: 4 weeks (3 weeks implementation + 1 week content/polish)
Methodology: Atomic task decomposition → Parallel implementation → Sequential deployment

Task Dependency Graph

Foundation (Week 1)
====================
t_28db7e16: [#29-impl-1] Initialize Astro + Tailwind + TypeScript
    └── t_0078b4b3: [#29-impl-2] Content collections (blog + projects schemas)
        ├── t_0ec36bde: [#29-impl-3] Base layout (Header, Footer, Nav)
        │   ├── t_6e85e022: [#29-impl-4] About page ║
        │   ├── t_7aa42f76: [#29-impl-5] Homepage (hero + featured) ║
        │   ├── t_b7d940a1: [#29-impl-6] Blog pages + RSS ║
        │   └── t_26ed02cc: [#29-impl-7] Projects pages ║
        └── (All above) ──→ t_66684b8f: [#29-impl-8] Docker deployment

Content & Polish (Week 3-4)
============================
t_c4e23cc8: [#29-impl-9] Blog content (5 posts) ║
t_637198bd: [#29-impl-10] Project case studies (3 projects) ║
t_8f00b91a: [#29-impl-11] SEO optimization (structured data, OG, analytics)

Legend:
  ║ = Can run in parallel
  └── = Must wait for parent

Phase Breakdown

Phase 1: Foundation (Week 1)

Priority: P1 (all tasks blocking)

Task ID	Title	Assignee	Est. Time	Blocks
t_28db7e16	Initialize Astro + Tailwind	wh-implementer	2-3h	ALL
t_0078b4b3	Content collections	wh-implementer	3-4h	Layouts + Pages
t_0ec36bde	Base layout	wh-implementer	3-4h	All pages
t_6e85e022	About page	wh-implementer	2-3h	-
t_7aa42f76	Homepage hero	wh-implementer	3-4h	-

Parallelization opportunity: After #29-impl-3 completes, tasks #29-impl-4, #29-impl-5, #29-impl-6, #29-impl-7 can ALL run simultaneously (4 parallel tracks).

Phase 2: Pages & Features (Week 2)

Priority: P1-P2

Task ID	Title	Assignee	Est. Time	Parallel?
t_b7d940a1	Blog pages + RSS	wh-implementer	4-5h	YES ║
t_26ed02cc	Projects pages	wh-implementer	3-4h	YES ║

Can run in parallel with #29-impl-4 and #29-impl-5.

Phase 3: Deployment (Week 2-3)

Priority: P1 (blocks launch)

Task ID	Title	Assignee	Est. Time	Depends on
t_66684b8f	Docker + Nginx + Portainer	wh-implementer	4-5h	ALL pages (impl-1 through impl-7)

Must wait for all page implementation tasks to complete (can't deploy empty site).

Phase 4: Content Creation (Week 3-4)

Priority: P2 (nice-to-have for MVP, critical for launch)

Task ID	Title	Assignee	Est. Time	Parallel?
t_c4e23cc8	Blog posts (5 articles)	wh-writer	6-8h	YES ║
t_637198bd	Project case studies (3 projects)	wh-writer	4-5h	YES ║

Can run in parallel (different content types, no dependencies).

Phase 5: SEO & Polish (Week 4)

Priority: P3 (launch enhancement)

Task ID	Title	Assignee	Est. Time	Depends on
t_8f00b91a	SEO optimization	wh-implementer	2-3h	ALL pages

Critical Path Analysis

Longest sequential path (critical path):

impl-1 (3h) → impl-2 (4h) → impl-3 (4h) → impl-8 (5h) = 16 hours

With parallelization:

Week 1: impl-1 (3h) → impl-2 (4h) → impl-3 (4h) = 11h
Week 2: impl-4, impl-5, impl-6, impl-7 in parallel (max 5h)
Week 2: impl-8 (5h)
Week 3-4: impl-9, impl-10 in parallel (max 8h)
Week 4: impl-11 (3h)

Total calendar time: 3-4 weeks
Total sequential hours: 16h (foundation) + 5h (pages) + 5h (deploy) + 8h (content) + 3h (SEO) = 37 hours
With parallelization: ~27 hours of actual work

Assignee Profiles

Profile	Responsibilities	Skills	Tasks
wh-implementer	Code implementation	Astro, React, Docker, FastAPI	impl-1 through impl-8, impl-11
wh-writer	Content creation	Spanish writing, technical writing, SEO	impl-9, impl-10
wh-leader	Orchestration	Planning, Gitea issues, monitoring	This task (t_22a3d7db)

Kanban Board States

All tasks created in todo state.

Transition rules:

todo → ready: When all parent tasks in done
ready → running: Dispatcher assigns to available worker
running → done: Worker calls kanban_complete(...)
running → blocked: Worker needs human input

Acceptance Gates

Gate 1: Foundation Complete (Week 1)

Tasks impl-1, impl-2, impl-3 in done
npm run dev starts without errors
Tailwind CSS working (test with colored elements)
Content collections validated (no schema errors)
Header, Footer, Navigation visible

Gate 2: Pages Complete (Week 2)

Tasks impl-4, impl-5, impl-6, impl-7 in done
All pages accessible (/, /about, /blog, /projects)
No TypeScript errors
No broken links
Responsive design works (mobile, tablet, desktop)

Gate 3: Deployment Ready (Week 2-3)

Task impl-8 in done
Docker image builds successfully
Final image size <50MB
Health check passes
Site accessible at http://localhost:3010
Nginx serves static files with gzip compression

Gate 4: Content Published (Week 3-4)

Tasks impl-9, impl-10 in done
At least 3 blog posts published
At least 2 project case studies published
All content validates against schemas
No typos or grammar errors

Gate 5: SEO Optimized (Week 4)

Task impl-11 in done
Sitemap generated and accessible
robots.txt present
Structured data validates (Google Rich Results Test)
OG preview looks correct (opengraph.xyz)
Analytics configured (if using)

Gate 6: Production Launch

All 11 implementation tasks in done
All 6 acceptance gates passed
Portainer stack deployed to 192.168.1.30:3010
HTTPS working via Traefik (davidaragon.impresion3d.pro)
DNS pointing to correct server
Health check passing
Site accessible publicly

Gitea Issue Mapping

All tasks map to Gitea Issue #29: "Build personal portfolio with blog and projects showcase"

Task naming convention: [#29-impl-N] Description

This allows tracking all work back to the single strategic Gitea issue while maintaining atomic Kanban tasks for execution.

Known Blockers & Mitigations

Blocker 1: Git Push Authentication

Status: BLOCKED
Impact: Cannot push commits to GitLab
Mitigation:

Commits created locally (all changes staged)
Push manually after SSH key configured
Or: use personal access token with HTTPS

Resolution needed: SSH key or GitLab personal access token

Blocker 2: Real Images (OG, Favicon, Avatar)

Status: LOW PRIORITY
Impact: Site uses placeholders for images
Mitigation:

Create placeholders in implementation tasks
Replace with real images before launch
Can launch with placeholders if needed (not blocking)

Resolution: Create professional OG image (1200x630), favicon set, avatar photo

Blocker 3: Analytics Configuration

Status: OPTIONAL
Impact: No traffic analytics initially
Mitigation:

Launch without analytics (privacy-first)
Or: set up self-hosted Plausible later
Not blocking for MVP

Resolution: Optional - configure Plausible after launch

Success Metrics

Development Metrics

11 tasks completed in 4 weeks
Zero P1 bugs at launch
<50MB Docker image size
>80% test coverage (if tests added)
100% TypeScript strict compliance

Product Metrics (post-launch)

Lighthouse Score: >90 (all categories)
Core Web Vitals: Pass (LCP <2.5s, FID <100ms, CLS <0.1)
Uptime: >99% (monitor with UptimeRobot)
Page load: <2s (first contentful paint)

Content Metrics (Month 1)

3-5 blog posts published
2-3 project case studies published
RSS subscribers: goal 50+
Organic traffic: goal 100+ visitors/month

Post-Launch Roadmap

Month 1-2: Content Cadence

Publish 2 blog posts per week
Update project case studies with metrics
Add 1-2 more projects (Garage61 API, etc.)

Month 3-4: Features

Newsletter signup backend (ConvertKit/Mailchimp)
Comments system (Giscus/Utterances)
Search functionality
Dark/light mode toggle

Month 5-6: Growth

Guest posts on Spanish indie blogs
X (Twitter) thread automation from blog posts
SEO optimization (internal linking, backlinks)
Analytics dashboard (public metrics page)

Contact & Support

Project Owner: David Aragón (caleidos)
Primary Agent: wh-leader (orchestrator)
Repository: https://gitlab.impresion3d.pro/root/davidaragon-portfolio
Deployment: 192.168.1.30:3010 → davidaragon.impresion3d.pro

Blockers? Comment on Kanban task or create Gitea issue.

Generated: 2026-05-08
Last Updated: 2026-05-08
Status: ✅ Ready for execution

9.1 KiB Raw Blame History