docs(okf): record learning contract and boss-facing German plan

learning contract: 2 h company time per week plus evenings, 6-month learning phase, German one-pager per module, repo goes public; add lern-und-entwicklungsplan.md and modul-zusammenfassung.md template; language model fixed browser-only; resolve open questions
This commit is contained in:
Noel Sabia committed 2026-10-15 14:44:49 +02:00
1 parent f0a9d58cff
commit 6ab76c2a36
6 files changed
+197 -3

No files matched your search

+39
View File
@@ -0,0 +1,39 @@
---
type: Decision
title: Learning contract with PreZero
description: 2 hours of company time per week plus evenings on this project during a 6-month learning phase; a German one-pager per finished module; the repo goes public so the boss can follow by link.
tags: [decision, learning, prezero]
status: stable
generated: { by: claude-code/claude-opus-5-5, at: 2026-10-15T00:00:00Z }
verified: { by: human:noel, at: 2026-10-15T00:00:00Z }
---
# Decision
Noel, developer in the AI & Digitalization department, runs this project as a
personal learning project within an agreed **6-month learning phase**:
- **2 hours of company time per week**, the rest in the evenings, on Noel's
own server. No company data, no company secrets, no company cost.
- **No hard delivery promise.** After 6 months both sides review how far the
work has come; the follow-up phase is decided then.
- **One German one-pager per finished module** (template:
[`modul-zusammenfassung.md`](/modul-zusammenfassung.md)): what was built,
what was learned, relevance for the team, and proof.
- **The Gitea repository becomes public**, so the boss can follow progress by
link. The [Lern- und Entwicklungsplan](/lern-und-entwicklungsplan.md) in
this bundle is the document he reads.
# Why
- The AI & Digitalization department builds webapps and missing tooling.
This project exercises exactly that delivery path: containers, orchestration,
infrastructure as code, CI/CD and observability — on a day job's real stack.
- The boss explicitly wants the team to get better; this makes the learning
visible and reviewable instead of invisible.
- Direction to senior developer: demonstrating ownership across the full
delivery chain, not only writing features.
# Revisit when
The 6-month review happens, or company time availability changes.
+6 -3
View File
@@ -4,7 +4,7 @@ title: Open questions
description: Decisions still to make, with the release that needs each answer.
tags: [decision, open]
status: draft
generated: { by: claude-code/claude-opus-5-5, at: 2026-10-11T12:15:30Z }
generated: { by: claude-code/claude-opus-5-5, at: 2026-10-15T00:00:00Z }
---
| Question | Needed by | Default if nobody decides |
@@ -12,10 +12,13 @@ generated: { by: claude-code/claude-opus-5-5, at: 2026-10-11T12:15:30Z }
| Final chapter list and the state of each chapter | 0.3.0 (placeholders), 1.0.0 (final) | Four placeholder chapters: one completed, one active, one unfinished, one failed |
| Story card text per chapter | 0.9.0 | None, Noel writes it |
| Life map visual form: timeline, graph or map | 0.9.0 | Vertical timeline |
| Approve Terraform for server provisioning | 0.2.0 | Do it, infra as code is the point |
| Which Gitea release-please action, exact name | 0.1.0 | None, Noel names it |
| How the server is reachable: router port-forward, static IP or DDNS | 0.4.0 | DDNS + port-forward 80/443 |
| k6 staging target: namespace or separate cluster | 1.2.0 | Namespace `cv-staging` on the same cluster |
| WebMCP scope: state read-only, or state plus push | 1.1.0 | State plus push, same limits as visitors |
| Approve PyTorch for the language model | 1.5.0 | None, needs Noel |
| Approve NumPy (or similar) for the own autograd engine | 1.13.0 | None, needs Noel |
Resolved since the last review: Terraform approved (0.2.0), WebMCP scope
decided — state plus push, exposed from the Nuxt page, same limits as
visitors (1.1.0), Caddy instead of nginx (0.4.0), browser-only language
model (after 1.7.0), and the [learning contract](/decisions/learning-contract.md).