docs(training): Allium training curriculum with Session 3 slide deck - #137
Merged
Merged
Conversation
Six-session training program (basics through contributing) with labs, cheat sheets, facilitator guide, and exercises anchored to the Mother specs, the MCT product map, and the team's CI/obligation pipeline. Exercise specs validated against allium-cli 3.5.0: starters and solutions for a toy-grant lifecycle build and an anti-pattern refactor (the 03 starter is deliberately flawed and documents its expected diagnostics). Claude-Session: https://claude.ai/code/session_012N1BtddmBbe6LPpe5apcww
36 slides with speaker notes, live-demo scripts, and cumulative timing, built as one progressive ladder: a one-sentence library-book behavior grown construct by construct into production patterns (mother-lifecycle, mct-product-map) and toolchain internals. Building the deck's running example surfaced two more real CLI behaviors, now folded into the deck (Act III) and the curriculum: allium.status.noExit (transition exits only credited for direct equality guards, not in-sets or derived fields) and analyse conflict findings for cross-trigger races on one state (same-trigger contradictions remain silent). Cheat sheets, Session 3 outline, and the exercise 03 answer key updated to match; the validated running example ships as slides/library.allium (check/analyse clean, 18 obligations). Claude-Session: https://claude.ai/code/session_012N1BtddmBbe6LPpe5apcww
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a complete Allium training curriculum under
docs/training/allium/:slides/library.allium.The material is anchored to real Patina/MCT artifacts:
layer/allium/mother/*.allium,patina-mct/layer/allium/mct-product-map.allium, the obligation-tagging convention, Patina plan-drift CI, and MCT's pinned Allium tier-0 gate.Linked Issue
Fixes #138
Validation
allium checkandallium analysewere run against the exercise and slide specs withallium-cli3.5.0.docs/training/allium/exercises/03-spec-refactor/starter/child-approval.alliumintentionally remains failing and documents its expected diagnostics.Require Linked IssueLintTestReleaseNotes
Docs-only training material. No Rust code paths are changed. CI's canonical Allium gates remain scoped to production specs under
layer/allium/, so the intentionally flawed training starter underdocs/is not swept by production spec checks.A companion MCT pointer doc is tracked in
nicabarnimble/patina-mct#17.