fogserv.cloud fogserv.cloud

Knowledge Base Build Plan — Sequential Execution Roadmap

Status: Active — Ready for Sequential Session Launch
Predecessor: KB Audit (see conversation history)
Goal: Transform 5 stub sections + expand 6 minimal sections into complete, production-quality articles

How to Use This Document

Each Task Group is designed as a single agent session. Execute them in order. Each group's output is the input state for the next — do not skip or reorder unless a prior task was completed but marked incomplete here.

Session Discipline (for every task)

  1. Read this file first to understand where you are in the sequence
  2. Read the section README/syllabus for the target directory
  3. Check tasks.md and update it with your session's work
  4. Follow the article format below — every new article MUST use it
  5. Update the section README when articles are added (move from planned → created)
  6. Append a change-log entry to this file under "Session Log"

Article Format Governance

Every new article in any KB section follows this structure:

# [Title]

**Status**: Draft | Active  
**Last Updated**: YYYY-MM-DD  
**Category**: [Section Name]  
**Prerequisites**: [linked articles, relative paths]  
**Tags**: tag1, tag2, tag3  

## Summary
[2-3 sentence overview.]

## Context / Why This Matters
[1-2 paragraphs; connect to prerequisites.]

## Implementation / Core Content
[Concepts, code examples, config snippets. 3-10KB per article.]

## Practical Examples
[Concrete working examples with expected output.]

## Common Pitfalls & Troubleshooting
[Bullet list of failure modes and fixes.]

## Next Steps / Ops Actions
[Follow-ups and link to next article in sequence.]

## Sources & Related Articles
- External references, official docs
- Related KB articles (relative links)

## Change Log

### YYYY-MM-DD
- Initial creation by [session name/agent]

Quality bar: The infrastructure/ and containers/ sections are the benchmark.

TASK SEQUENCE

Task 0 — Foundation: Consistency Fixes & Template Creation (~30 min)

# Action File(s)
0.1 Create missing section README fogserv/README.md
0.2 Verify root-level workflows doc workflows.md (exists ✅ as of 2026-08-26)
0.3 Create article template .templates/article-template.md
0.4 Update root README navigation README.md

Task 1 — CI/CD Section: Complete Learning Path (21 Articles, 4–6 h)

Phases: CI/CD concepts (cicd-concepts, manual-vs-automated, self-hosted-ci-cd) → Forgejo setup (installation ✅, user-management, repository-setup, webhooks) → Woodpecker CI (installation, first-pipeline, pipeline-testing, ci-secrets-management) → Advanced pipelines (multi-stage-builds, matrix-builds, deployment-automation, gitops-pipelines) → Production CI/CD (ci-monitoring, security-scanning, caching-strategies, branch-protection) → rollback-procedures.

Task 2 — Networking Section: Complete Learning Path (24 Articles, 5–6 h)

Phases: TCP/IP fundamentals (tcp-ip-fundamentals ✅, network-topologies, dns-explained) → DNS management (dns-management, cloudflare-dns, dynamic-dns) → Reverse proxies & LB (reverse-proxy-basics, caddy-reverse-proxy, nginx-configuration, load-balancing) → Firewalls & security (ufw-firewall, nftables-advanced, dhcp-dns-split-horizon) → Virtual networks & VPNs (virtual-networks, wireguard-setup) → Production patterns (network-segmentation, monitoring-networks).

Task 3 — Cloud Section: Complete Learning Path (24 Articles, 5–6 h)

Phases: storage concepts (cloud-storage-concepts ✅, storage-backup-strategies) → file sync (nextcloud-setup ✅, nextcloud-administration, syncthing-peer-to-peer) → object storage (minio-setup, s3-api-usage, backup-to-object-storage) → media/collab (jellyfin-media-server, immich-photo-backup) → backup automation (backup-automation).

Task 4 — Observability Section: Complete Learning Path (24 Articles, 5–6 h)

Phases: fundamentals (why-monitor ✅, metrics-vs-logs) → Prometheus ecosystem (prometheus-installation, node-exporter-setup, grafana-dashboards) → logging/tracing (loki-logging, jaeger-tracing) → alerting/incident response (alertmanager-config). Phase 1 basics already exist: uptime-kuma-setup ✅, netdata-basics ✅, simple-alerts ✅.

Task 5 — AI/ML Section: Complete Learning Path (24 Articles, 6–8 h)

Phases: LLM fundamentals (llm-introduction ✅, ollama-setup ✅, model-selection-guide ✅, ollama-cli-basics ✅) → LLM integration (ollama-api ✅, python-llm-integration, prompt-engineering, context-and-tokens) → vector DBs (embeddings-explained, qdrant-setup) → RAG (rag-introduction, document-chunking, langchain-integration) → advanced (model-quantization, agent-frameworks).

Task 6 — Expand Databases + Frontend (3–4 h)

Task 7 — Expand GitOps, Sysadmin, Agentic, Research (3–4 h)

Task 8 — Cross-Section Reference Audit & Polish (2–3 h)

Link audit (grep -r "](\.\./" kb/ --include="*.md"), README sync, index.md sync, TELOS alignment, final tasks.md entry. Exit: zero broken relative links across all kb/*.md.

Session Log

Append one entry per completed task: ### YYYY-MM-DD — Task N Complete — Section(s) + counts + gaps.

2026-08-26 — Partial progress across Tasks 1–5 (headless-browser DDG research session)

Last Updated: 2026-08-26 — Plan persisted into KB; parallel build session launched for Tasks 1–5 slices.

2026-08-26 — Task 2 Complete + Task 1 Complete (gap-fill session)

2026-08-27 — Task 8 / Section Expansion Complete — All Sections

2026-08-26 — fogserv Section Complete + Task 8 Link Audit (partial)

Choose Theme

Your selection is saved locally.

Neural Cacophony
Aperture v2
Flux v1
Mosaic Chaos
Nexus v1
Nexus Zest
Prism v2
Synapse