@mriekki/lean 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,67 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# Lean Platform
+
+`@mriekki/lean` is the public consumer-facing distribution for Lean engineering assets.
+
+Canonical engineering remains in the private platform repositories. Before publication, a deterministic assembly step verifies exact pinned source commits and distribution descriptors, then copies only those approved consumer mappings into the npm payload. Each published npm release is therefore self-contained; consumers do not need access to the canonical repositories to install or update Lean assets.
+
+## V0.1 profile
+
+The initial `greenfield-poc` profile bundles:
+
+- Lean Agentic Core `1.10.0` from commit `e2d64b10f1a30507471755339c20e8b58e62be16`, distribution `greenfield-workspace`;
+- Lean POC Deployment Kit commit `4c23140576b39608a3ef285cad4abe53dccb9c47`, distribution `greenfield-poc`.
+
+## Developer experience
+
+Preview/install:
+
+```powershell
+npx @mriekki/lean install
+```
+
+When run interactively, the command previews all managed changes and asks once before applying a safe plan. Automation can use `--apply` after reviewing the preview contract.
+
+Update using the newest published package:
+
+```powershell
+npx @mriekki/lean@latest update
+```
+
+Inspect or verify:
+
+```powershell
+npx @mriekki/lean@latest status
+npx @mriekki/lean@latest check
+```
+
+The umbrella package writes `LEAN_BASELINE.json` while preserving component-native `CORE_BASELINE.json` and `DEPLOYMENT_BASELINE.json` ledgers. Updates refuse managed drift/conflicts before modifying any component. Core retired paths require explicit ownership transfer with `--accept-retired core:<path>`; unchanged Deployment Kit retirements may be removed under its existing ownership contract.
+
+## Safety and ownership
+
+- npm is the distribution transport, not the canonical source of reusable behavior.
+- package releases pin exact accepted source commits.
+- install/update never require private GitHub access.
+- no install/update lifecycle hook mutates a consumer repository; changes occur only when the user invokes the Lean CLI.
+- one preflight plan covers all selected components; an unsafe component blocks the entire apply.
+- package publication is separate from merging this repository and requires an explicit release action.
+
+## Current scope
+
+V0.1 intentionally starts with the greenfield POC consumer profile. Existing-repository Adoption Kit packaging can be added as another profile without changing the one-package developer experience.
+
+## Package assembly and release
+
+The public source repository intentionally does not commit generated private-source snapshots. Prepare an auditable release candidate from clean exact canonical checkouts:
+
+```powershell
+Set-Location D:\Projects\lean-platform
+node .\scripts\prepare-release.mjs `
+  --core-root D:\Projects\lean-agentic-core `
+  --deployment-root D:\Projects\lean-poc-deployment-kit
+```
+
+Release preparation verifies exact `origin/main`, runs the complete test suite, refuses dirty canonical source checkouts, assembles and verifies the pinned assets, compares two independent `npm pack` SHA-256 values, and smoke-tests the packed CLI from a clean temporary install. The resulting tarball and `RELEASE_MANIFEST.json` are written under `dist/release/`.
+
+The first npm version is staged manually and requires explicit 2FA approval before it becomes public. After the bootstrap version exists, `.github/workflows/npm-stage.yml` can use npm Trusted Publishing (OIDC) to stage future versions without a long-lived npm publish token; human 2FA approval remains the final publication gate.
+
+See `docs/RELEASE_PROCESS.md` for the full release contract.

package/assets/components.json

@@ -0,0 +1,33 @@
+{
+  "schemaVersion": 1,
+  "package": "@mriekki/lean",
+  "version": "0.1.0",
+  "defaultProfile": "greenfield-poc",
+  "profiles": {
+    "greenfield-poc": {
+      "components": [
+        "core",
+        "deployment"
+      ]
+    }
+  },
+  "components": {
+    "core": {
+      "repository": "mriekki/lean-agentic-core",
+      "commit": "e2d64b10f1a30507471755339c20e8b58e62be16",
+      "version": "1.10.0",
+      "distribution": "greenfield-workspace",
+      "descriptor": "assets/core/distribution.json",
+      "sourceRoot": "assets/generated/core",
+      "canonicalDescriptor": "distributions/greenfield-workspace.json"
+    },
+    "deployment": {
+      "repository": "mriekki/lean-poc-deployment-kit",
+      "commit": "4c23140576b39608a3ef285cad4abe53dccb9c47",
+      "distribution": "greenfield-poc",
+      "descriptor": "assets/deployment/distribution.json",
+      "sourceRoot": "assets/generated/deployment",
+      "canonicalDescriptor": "distributions/greenfield-poc.json"
+    }
+  }
+}

package/assets/core/distribution.json

@@ -0,0 +1,51 @@
+{
+  "name": "greenfield-workspace",
+  "profileSource": "profiles/greenfield/lean-workspace.json",
+  "profileDestination": ".github/lean-workspace.json",
+  "mappings": [
+    {"source":"core/agents/reviewer.agent.md","destination":".github/agents/reviewer.agent.md"},
+    {"source":"core/agents/coach.agent.md","destination":".github/agents/coach.agent.md"},
+    {"source":"core/instructions/lean-workflow.instructions.md","destination":".github/instructions/lean-workflow.instructions.md"},
+    {"source":"core/instructions/lean-docs.instructions.md","destination":".github/instructions/lean-docs.instructions.md"},
+    {"source":"core/skills/define-feature/SKILL.md","destination":".github/skills/define-feature/SKILL.md"},
+    {"source":"core/skills/grill-me/SKILL.md","destination":".github/skills/grill-me/SKILL.md"},
+    {"source":"core/skills/grill-with-docs/SKILL.md","destination":".github/skills/grill-with-docs/SKILL.md"},
+    {"source":"core/skills/refine-requirements/SKILL.md","destination":".github/skills/refine-requirements/SKILL.md"},
+    {"source":"core/skills/start-work/SKILL.md","destination":".github/skills/start-work/SKILL.md"},
+    {"source":"core/skills/next-step/SKILL.md","destination":".github/skills/next-step/SKILL.md"},
+    {"source":"core/skills/deliver/SKILL.md","destination":".github/skills/deliver/SKILL.md"},
+    {"source":"core/skills/cleanup-branches/SKILL.md","destination":".github/skills/cleanup-branches/SKILL.md"},
+    {"source":"core/skills/pull-latest/SKILL.md","destination":".github/skills/pull-latest/SKILL.md"},
+    {"source":"core/skills/core-sync/SKILL.md","destination":".github/skills/core-sync/SKILL.md"},
+    {"source":"core/skills/upstream-fix/SKILL.md","destination":".github/skills/upstream-fix/SKILL.md"},
+    {"source":"core/skills/wait-what/SKILL.md","destination":".github/skills/wait-what/SKILL.md"},
+    {"source":"core/skills/production-readiness/SKILL.md","destination":".github/skills/production-readiness/SKILL.md"},
+    {"source":"core/skills/deploy/SKILL.md","destination":".github/skills/deploy/SKILL.md"},
+    {"source":"core/skills/tear-down/SKILL.md","destination":".github/skills/tear-down/SKILL.md"},
+    {"source":"core/skills/coach/SKILL.md","destination":".github/skills/coach/SKILL.md"},
+    {"source":"core/skills/code-walkthrough/SKILL.md","destination":".github/skills/code-walkthrough/SKILL.md"},
+    {"source":"core/skills/learning-review/SKILL.md","destination":".github/skills/learning-review/SKILL.md"},
+    {"source":"core/process/WORK_ITEM_MODEL.md","destination":"docs/process/WORK_ITEM_MODEL.md"},
+    {"source":"core/process/PR_WORKFLOW.md","destination":"docs/process/PR_WORKFLOW.md"},
+    {"source":"core/process/PRODUCTION_ENABLEMENT.md","destination":"docs/process/PRODUCTION_ENABLEMENT.md"},
+    {"source":"core/process/HUMAN_GATES.md","destination":"docs/process/HUMAN_IN_LOOP_GATES.md"},
+    {"source":"core/process/GUIDED_NEXT_STEPS.md","destination":"docs/process/GUIDED_NEXT_STEPS.md"},
+    {"source":"core/process/INTERACTIVE_SESSION_GUIDE.md","destination":"docs/process/INTERACTIVE_SESSION_GUIDE.md"},
+    {"source":"core/process/COACHING_GUIDE.md","destination":"docs/process/COACHING_GUIDE.md"},
+    {"source":"core/process/SETUP_ACCEPTANCE_CHECKLIST.md","destination":"docs/process/SETUP_ACCEPTANCE_CHECKLIST.md"},
+    {"source":"core/templates/PULL_REQUEST_TEMPLATE.md","destination":".github/PULL_REQUEST_TEMPLATE.md"},
+    {"source":"core/templates/PRODUCT_BRIEF_TEMPLATE.md","destination":"docs/templates/PRODUCT_BRIEF_TEMPLATE.md"},
+    {"source":"core/templates/FEATURE_BRIEF_TEMPLATE.md","destination":"docs/templates/FEATURE_BRIEF_TEMPLATE.md"},
+    {"source":"core/templates/REQUIREMENTS_TEMPLATE.md","destination":"docs/templates/REQUIREMENTS_TEMPLATE.md"},
+    {"source":"core/learning/ENGINEERING_LEARNING_WORKBOOK.md","destination":"learning/ENGINEERING_LEARNING_WORKBOOK.md"},
+    {"source":"core/learning/LEARNING_MAP.md","destination":"learning/LEARNING_MAP.md"},
+    {"source":"core/learning/LEARNING_PROGRESS.md","destination":"learning/LEARNING_PROGRESS.md"},
+    {"source":"core/learning/CODING_DRILLS.md","destination":"learning/CODING_DRILLS.md"},
+    {"source":"core/learning/SQL_DRILLS.md","destination":"learning/SQL_DRILLS.md"},
+    {"source":"core/learning/SYSTEM_DESIGN_DRILLS.md","destination":"learning/SYSTEM_DESIGN_DRILLS.md"},
+    {"source":"core/learning/DIAGRAM_GUIDE.md","destination":"learning/DIAGRAM_GUIDE.md"},
+    {"source":"core/learning/RESOURCE_CATALOG.md","destination":"learning/RESOURCE_CATALOG.md"},
+    {"source":"tools/package/check_baseline.py","destination":"tools/lean-core/check-core-baseline.py"},
+    {"source":"tools/package/check_upstream.py","destination":"tools/lean-core/check-core-upstream.py"}
+  ]
+}

package/assets/deployment/distribution.json

@@ -0,0 +1,34 @@
+{
+  "name": "greenfield-poc",
+  "schemaVersion": 1,
+  "description": "Reusable deployment tooling for generated disposable Lean POCs.",
+  "mappings": [
+    {"source": "distribution/lean-poc-deploy.py", "destination": "tools/lean-deployment/lean-poc-deploy.py"},
+    {"source": "src/lean_poc_deployment/__init__.py", "destination": "tools/lean-deployment/lean_poc_deployment/__init__.py"},
+    {"source": "src/lean_poc_deployment/__main__.py", "destination": "tools/lean-deployment/lean_poc_deployment/__main__.py"},
+    {"source": "src/lean_poc_deployment/app_cli.py", "destination": "tools/lean-deployment/lean_poc_deployment/app_cli.py"},
+    {"source": "src/lean_poc_deployment/app_runtime.py", "destination": "tools/lean-deployment/lean_poc_deployment/app_runtime.py"},
+    {"source": "src/lean_poc_deployment/app_runtime_remote.py", "destination": "tools/lean-deployment/lean_poc_deployment/app_runtime_remote.py"},
+    {"source": "src/lean_poc_deployment/box_platform.py", "destination": "tools/lean-deployment/lean_poc_deployment/box_platform.py"},
+    {"source": "src/lean_poc_deployment/box_platform_assets.py", "destination": "tools/lean-deployment/lean_poc_deployment/box_platform_assets.py"},
+    {"source": "src/lean_poc_deployment/box_platform_remote.py", "destination": "tools/lean-deployment/lean_poc_deployment/box_platform_remote.py"},
+    {"source": "src/lean_poc_deployment/cli.py", "destination": "tools/lean-deployment/lean_poc_deployment/cli.py"},
+    {"source": "src/lean_poc_deployment/doctor.py", "destination": "tools/lean-deployment/lean_poc_deployment/doctor.py"},
+    {"source": "src/lean_poc_deployment/entrypoint.py", "destination": "tools/lean-deployment/lean_poc_deployment/entrypoint.py"},
+    {"source": "src/lean_poc_deployment/errors.py", "destination": "tools/lean-deployment/lean_poc_deployment/errors.py"},
+    {"source": "src/lean_poc_deployment/keys.py", "destination": "tools/lean-deployment/lean_poc_deployment/keys.py"},
+    {"source": "src/lean_poc_deployment/profiles.py", "destination": "tools/lean-deployment/lean_poc_deployment/profiles.py"},
+    {"source": "src/lean_poc_deployment/teardown.py", "destination": "tools/lean-deployment/lean_poc_deployment/teardown.py"},
+    {"source": "src/lean_poc_deployment/teardown_cli.py", "destination": "tools/lean-deployment/lean_poc_deployment/teardown_cli.py"},
+    {"source": "src/lean_poc_deployment/teardown_remote.py", "destination": "tools/lean-deployment/lean_poc_deployment/teardown_remote.py"},
+    {"source": "src/lean_poc_deployment/route_registry.py", "destination": "tools/lean-deployment/lean_poc_deployment/route_registry.py"},
+    {"source": "src/lean_poc_deployment/route_registry_remote.py", "destination": "tools/lean-deployment/lean_poc_deployment/route_registry_remote.py"},
+    {"source": "src/lean_poc_deployment/security.py", "destination": "tools/lean-deployment/lean_poc_deployment/security.py"},
+    {"source": "src/lean_poc_deployment/sqlite_adapter.py", "destination": "tools/lean-deployment/lean_poc_deployment/sqlite_adapter.py"},
+    {"source": "src/lean_poc_deployment/sqlite_adapter_remote.py", "destination": "tools/lean-deployment/lean_poc_deployment/sqlite_adapter_remote.py"},
+    {"source": "src/lean_poc_deployment/sqlite_cli.py", "destination": "tools/lean-deployment/lean_poc_deployment/sqlite_cli.py"},
+    {"source": "src/lean_poc_deployment/sqlite_import_recovery.py", "destination": "tools/lean-deployment/lean_poc_deployment/sqlite_import_recovery.py"},
+    {"source": "src/lean_poc_deployment/ssh.py", "destination": "tools/lean-deployment/lean_poc_deployment/ssh.py"},
+    {"source": "src/lean_poc_deployment/trust.py", "destination": "tools/lean-deployment/lean_poc_deployment/trust.py"}
+  ]
+}

package/assets/generated/ASSEMBLY.json

@@ -0,0 +1,382 @@
+{
+  "schemaVersion": 1,
+  "package": "@mriekki/lean",
+  "version": "0.1.0",
+  "components": {
+    "core": {
+      "repository": "mriekki/lean-agentic-core",
+      "commit": "e2d64b10f1a30507471755339c20e8b58e62be16",
+      "version": "1.10.0",
+      "distribution": "greenfield-workspace",
+      "files": [
+        {
+          "source": "profiles/greenfield/lean-workspace.json",
+          "destination": ".github/lean-workspace.json",
+          "sha256": "c827fabe0ca3130edbdd5fb3f62d8a05c921d5834f058bcb4ad641e400565b92"
+        },
+        {
+          "source": "core/agents/reviewer.agent.md",
+          "destination": ".github/agents/reviewer.agent.md",
+          "sha256": "7a2c1b52dfb75a2d71da1b82c6d186330b596473689712d65e51a3a9c390a25c"
+        },
+        {
+          "source": "core/agents/coach.agent.md",
+          "destination": ".github/agents/coach.agent.md",
+          "sha256": "f2da3ed8ba1890f0886615c0d7a66411265524dcaf04648ef10dfd195dde522e"
+        },
+        {
+          "source": "core/instructions/lean-workflow.instructions.md",
+          "destination": ".github/instructions/lean-workflow.instructions.md",
+          "sha256": "ef6fcd56c5959cfe61a815b8edaabceaa6ca9b7eb4eb7bf8166eb2ea727fb98d"
+        },
+        {
+          "source": "core/instructions/lean-docs.instructions.md",
+          "destination": ".github/instructions/lean-docs.instructions.md",
+          "sha256": "9d2d596fb9fc6c6f8afcc68ca6e4c94b2c50b396f3d970ef26797ae51cb03202"
+        },
+        {
+          "source": "core/skills/define-feature/SKILL.md",
+          "destination": ".github/skills/define-feature/SKILL.md",
+          "sha256": "11a76307d7f4c25986e123e7b6c48f19aa4c50f7fa6e4f2daaf7636c7049be3b"
+        },
+        {
+          "source": "core/skills/grill-me/SKILL.md",
+          "destination": ".github/skills/grill-me/SKILL.md",
+          "sha256": "c46d703d6a04d18508bda86b9bf601dad96e60848bd46f643f710a9c2180be38"
+        },
+        {
+          "source": "core/skills/grill-with-docs/SKILL.md",
+          "destination": ".github/skills/grill-with-docs/SKILL.md",
+          "sha256": "bc5171013fd65552c7d825ebeae95b7e9b9094d66b69a402e2eee5c95b4a7001"
+        },
+        {
+          "source": "core/skills/refine-requirements/SKILL.md",
+          "destination": ".github/skills/refine-requirements/SKILL.md",
+          "sha256": "edb7ac78fab0eae96dfec4eda563a4c6325885bb65e3af911365e2a6359955c6"
+        },
+        {
+          "source": "core/skills/start-work/SKILL.md",
+          "destination": ".github/skills/start-work/SKILL.md",
+          "sha256": "dfdb038560871752e7a9e223efec8a807afb786c5f83dc2b46699470d05c883b"
+        },
+        {
+          "source": "core/skills/next-step/SKILL.md",
+          "destination": ".github/skills/next-step/SKILL.md",
+          "sha256": "c8b3bc84dbf3f126aa35e5dbc48fd6985de91d9c0f981ec47777e515c01b63ef"
+        },
+        {
+          "source": "core/skills/deliver/SKILL.md",
+          "destination": ".github/skills/deliver/SKILL.md",
+          "sha256": "f5a16438406571c34cc876242a2aa4d593b028509b78bdeb2b2942529b1a9b6d"
+        },
+        {
+          "source": "core/skills/cleanup-branches/SKILL.md",
+          "destination": ".github/skills/cleanup-branches/SKILL.md",
+          "sha256": "5b76cc705494ee2b99f4fef89f7d8af1c3cdc4d2a8f7c3363e50d0ed96225c39"
+        },
+        {
+          "source": "core/skills/pull-latest/SKILL.md",
+          "destination": ".github/skills/pull-latest/SKILL.md",
+          "sha256": "d49321859fe37afeb5d9e0b39ceac3d8a6709f6e02efd19b6cac37842fe3aa37"
+        },
+        {
+          "source": "core/skills/core-sync/SKILL.md",
+          "destination": ".github/skills/core-sync/SKILL.md",
+          "sha256": "6b2393639f3cc0581bed0df8667fc67691ae915d137b9f070c60bbdb042148a6"
+        },
+        {
+          "source": "core/skills/upstream-fix/SKILL.md",
+          "destination": ".github/skills/upstream-fix/SKILL.md",
+          "sha256": "26d979b8876db4031f7e95887ab16a7c530d1fcd60043410ed8d20c4ea5f5301"
+        },
+        {
+          "source": "core/skills/wait-what/SKILL.md",
+          "destination": ".github/skills/wait-what/SKILL.md",
+          "sha256": "9b5968158992681837071b60465682a887540b1fdab510861ed739ffa996fbdb"
+        },
+        {
+          "source": "core/skills/production-readiness/SKILL.md",
+          "destination": ".github/skills/production-readiness/SKILL.md",
+          "sha256": "adc45c556902f039b918f20bf484a05f9213103d5875b1ba7fa9c58dd0dca4d6"
+        },
+        {
+          "source": "core/skills/deploy/SKILL.md",
+          "destination": ".github/skills/deploy/SKILL.md",
+          "sha256": "57fca71a95a32f4dd17ed3fba13b9b1ccbd644082de175622960d9c65aaa47a0"
+        },
+        {
+          "source": "core/skills/tear-down/SKILL.md",
+          "destination": ".github/skills/tear-down/SKILL.md",
+          "sha256": "8826be8f97c5dab673c050c5ae7f959c5959871c401b0b3b7e6869660e669d93"
+        },
+        {
+          "source": "core/skills/coach/SKILL.md",
+          "destination": ".github/skills/coach/SKILL.md",
+          "sha256": "123983c51bd2d9958d8a6593101dc57eb6e4974cc9678d17c434ac61d29e4378"
+        },
+        {
+          "source": "core/skills/code-walkthrough/SKILL.md",
+          "destination": ".github/skills/code-walkthrough/SKILL.md",
+          "sha256": "0391f98dac6dfd41882c330425567ae595fde01fce63de521563c95647d2b889"
+        },
+        {
+          "source": "core/skills/learning-review/SKILL.md",
+          "destination": ".github/skills/learning-review/SKILL.md",
+          "sha256": "b77ccbbd85fbe6c8d77d42bfea4b0d474e320c182f7d1f72010ff2301d869e66"
+        },
+        {
+          "source": "core/process/WORK_ITEM_MODEL.md",
+          "destination": "docs/process/WORK_ITEM_MODEL.md",
+          "sha256": "ca4783e1791c2a4fd081d075d20263fcc3a8a5740342db611d75812aecda65e5"
+        },
+        {
+          "source": "core/process/PR_WORKFLOW.md",
+          "destination": "docs/process/PR_WORKFLOW.md",
+          "sha256": "8d1bcabf6d1b72705ca9e7e0cd348b71102805b041dba601fa6dd93d5063b1ed"
+        },
+        {
+          "source": "core/process/PRODUCTION_ENABLEMENT.md",
+          "destination": "docs/process/PRODUCTION_ENABLEMENT.md",
+          "sha256": "d2580b76144fad0e7d429802f8cdaba3ed022b4580c2e311c01f81b9a5a09bab"
+        },
+        {
+          "source": "core/process/HUMAN_GATES.md",
+          "destination": "docs/process/HUMAN_IN_LOOP_GATES.md",
+          "sha256": "cc8f5c01f7c5ac1c745a87f810493eb9d1a3b1c76b46b64ed27830dd5838f33c"
+        },
+        {
+          "source": "core/process/GUIDED_NEXT_STEPS.md",
+          "destination": "docs/process/GUIDED_NEXT_STEPS.md",
+          "sha256": "729655e6e764ec364284ffe860749da45bde8d05f8b46019d74df524b6b6b40d"
+        },
+        {
+          "source": "core/process/INTERACTIVE_SESSION_GUIDE.md",
+          "destination": "docs/process/INTERACTIVE_SESSION_GUIDE.md",
+          "sha256": "12c19b70924087824ae49369fdbe7bfb79b699e17285ada27d2f5cd4a5820098"
+        },
+        {
+          "source": "core/process/COACHING_GUIDE.md",
+          "destination": "docs/process/COACHING_GUIDE.md",
+          "sha256": "0ccadef39db53f85a5092cb4d1343ed3c1fe13291291afd33c59d5a60fd22905"
+        },
+        {
+          "source": "core/process/SETUP_ACCEPTANCE_CHECKLIST.md",
+          "destination": "docs/process/SETUP_ACCEPTANCE_CHECKLIST.md",
+          "sha256": "66007762f6a712925cd8d338954fbcced71aed3dfe447d22c4aa30c9230b24da"
+        },
+        {
+          "source": "core/templates/PULL_REQUEST_TEMPLATE.md",
+          "destination": ".github/PULL_REQUEST_TEMPLATE.md",
+          "sha256": "1b70e40b55ccc548a317d06105e959c8b4d28fb7bb2a7ce8a2976c42bb31a5ac"
+        },
+        {
+          "source": "core/templates/PRODUCT_BRIEF_TEMPLATE.md",
+          "destination": "docs/templates/PRODUCT_BRIEF_TEMPLATE.md",
+          "sha256": "fcab7508dd5d53ea9dac3a35b7c31b4adac8c1c37b5df2224f2fb47c52432f58"
+        },
+        {
+          "source": "core/templates/FEATURE_BRIEF_TEMPLATE.md",
+          "destination": "docs/templates/FEATURE_BRIEF_TEMPLATE.md",
+          "sha256": "d09737d7e67b7bad50a779ce0a6b3a95d17ba9de7a2e60423763ea3d934ce768"
+        },
+        {
+          "source": "core/templates/REQUIREMENTS_TEMPLATE.md",
+          "destination": "docs/templates/REQUIREMENTS_TEMPLATE.md",
+          "sha256": "ec85cc723071edb01f09acca41e20e9833afe21d06d103b39dfcdbfb59a31aed"
+        },
+        {
+          "source": "core/learning/ENGINEERING_LEARNING_WORKBOOK.md",
+          "destination": "learning/ENGINEERING_LEARNING_WORKBOOK.md",
+          "sha256": "fd9d6b3561c5d433be4a58ad2d8c74f30e2c831d7de6cd7296a1b3f8999c55da"
+        },
+        {
+          "source": "core/learning/LEARNING_MAP.md",
+          "destination": "learning/LEARNING_MAP.md",
+          "sha256": "48985521dd22213add526910ead486db2ca54e88533d49bd35cd6bcda5f92180"
+        },
+        {
+          "source": "core/learning/LEARNING_PROGRESS.md",
+          "destination": "learning/LEARNING_PROGRESS.md",
+          "sha256": "c47e5ff009a789046998d67dae1d67dfca8a7ada2f963362747faea0edb11e1e"
+        },
+        {
+          "source": "core/learning/CODING_DRILLS.md",
+          "destination": "learning/CODING_DRILLS.md",
+          "sha256": "cbdb054ea5571b1c79f6dcf104bffb1b830ac8b99f04eb77dcede4b00d1f1234"
+        },
+        {
+          "source": "core/learning/SQL_DRILLS.md",
+          "destination": "learning/SQL_DRILLS.md",
+          "sha256": "22075d135afbee73aabb11a33077946a0444362ff3f678495386b0996da6a95c"
+        },
+        {
+          "source": "core/learning/SYSTEM_DESIGN_DRILLS.md",
+          "destination": "learning/SYSTEM_DESIGN_DRILLS.md",
+          "sha256": "4d197fe4bf2f618dcc212db304fd18f450ed3955fdce4ac2722371ee52b12a58"
+        },
+        {
+          "source": "core/learning/DIAGRAM_GUIDE.md",
+          "destination": "learning/DIAGRAM_GUIDE.md",
+          "sha256": "c4626c30f3d0f8212b9a8b0d3e4f2ead4ff067bc4e015e801d8c35b00838e365"
+        },
+        {
+          "source": "core/learning/RESOURCE_CATALOG.md",
+          "destination": "learning/RESOURCE_CATALOG.md",
+          "sha256": "88fc894dd51da7280aabd3df439bcbda337f437ece43640d86dfc0842dd0f91e"
+        },
+        {
+          "source": "tools/package/check_baseline.py",
+          "destination": "tools/lean-core/check-core-baseline.py",
+          "sha256": "fdd8c85a29e7549cc469e50f592a006cef45c7b92cc19b35e9c7f1ab2b351365"
+        },
+        {
+          "source": "tools/package/check_upstream.py",
+          "destination": "tools/lean-core/check-core-upstream.py",
+          "sha256": "1d59c11f1fb4d4a704e8685f34b1d0402db97fd26142934905509cb030505c23"
+        }
+      ]
+    },
+    "deployment": {
+      "repository": "mriekki/lean-poc-deployment-kit",
+      "commit": "4c23140576b39608a3ef285cad4abe53dccb9c47",
+      "distribution": "greenfield-poc",
+      "files": [
+        {
+          "source": "distribution/lean-poc-deploy.py",
+          "destination": "tools/lean-deployment/lean-poc-deploy.py",
+          "sha256": "98e282d4f85999c3a37c47af6805cfa645f7de6e7e2e4a686e4d0012850805df"
+        },
+        {
+          "source": "src/lean_poc_deployment/__init__.py",
+          "destination": "tools/lean-deployment/lean_poc_deployment/__init__.py",
+          "sha256": "9f84e6ff170f657459fc461833007f874c6fdd4f6c6d3964ee41d7ec3d0e33d0"
+        },
+        {
+          "source": "src/lean_poc_deployment/__main__.py",
+          "destination": "tools/lean-deployment/lean_poc_deployment/__main__.py",
+          "sha256": "5791f61aa75f2048bb7ef968f382ca81b7c14520599f0d358113fde33392e7ee"
+        },
+        {
+          "source": "src/lean_poc_deployment/app_cli.py",
+          "destination": "tools/lean-deployment/lean_poc_deployment/app_cli.py",
+          "sha256": "a70e0471a34a111eecf4c26c49a76273b53dd67351f9c57484bf58a7372baf4a"
+        },
+        {
+          "source": "src/lean_poc_deployment/app_runtime.py",
+          "destination": "tools/lean-deployment/lean_poc_deployment/app_runtime.py",
+          "sha256": "9cd033b0d483dabf28c9ff4289a0d7621e8e8355704c94221238fa33905b9ae4"
+        },
+        {
+          "source": "src/lean_poc_deployment/app_runtime_remote.py",
+          "destination": "tools/lean-deployment/lean_poc_deployment/app_runtime_remote.py",
+          "sha256": "7433314dedf08a189b7c672897a499367511778bedc0f1080ae6c72bb86f9867"
+        },
+        {
+          "source": "src/lean_poc_deployment/box_platform.py",
+          "destination": "tools/lean-deployment/lean_poc_deployment/box_platform.py",
+          "sha256": "346f3f61252bc61f052ddc1865d6843a4ca512f6a5f67d80d0e13c7d878863ba"
+        },
+        {
+          "source": "src/lean_poc_deployment/box_platform_assets.py",
+          "destination": "tools/lean-deployment/lean_poc_deployment/box_platform_assets.py",
+          "sha256": "c2787fc800afec76183fbcb0bb27e96b016ea65b6a5fec62595eb68b01b90561"
+        },
+        {
+          "source": "src/lean_poc_deployment/box_platform_remote.py",
+          "destination": "tools/lean-deployment/lean_poc_deployment/box_platform_remote.py",
+          "sha256": "1e5094c48ada1b92e19e94d2ad8140de54645da3ab32d3ae2a09478f459d2e7d"
+        },
+        {
+          "source": "src/lean_poc_deployment/cli.py",
+          "destination": "tools/lean-deployment/lean_poc_deployment/cli.py",
+          "sha256": "d6da84777cdae2e55dd636adc3e90fc8cbc777a29dd5df85a936c1cbb2cf3f05"
+        },
+        {
+          "source": "src/lean_poc_deployment/doctor.py",
+          "destination": "tools/lean-deployment/lean_poc_deployment/doctor.py",
+          "sha256": "1b86ee7df00b5e10c3859bc227562d14a954ebbe9f68fea12ff63f290e888926"
+        },
+        {
+          "source": "src/lean_poc_deployment/entrypoint.py",
+          "destination": "tools/lean-deployment/lean_poc_deployment/entrypoint.py",
+          "sha256": "62112d18f265dea737748e61216c25f9c52a1174e0d4bd69d6afe09fa8097e26"
+        },
+        {
+          "source": "src/lean_poc_deployment/errors.py",
+          "destination": "tools/lean-deployment/lean_poc_deployment/errors.py",
+          "sha256": "ecee46ca5746e5225a4cc30aa2cdc57a8746658d9b3ab45f7c9a775e24f9b5b6"
+        },
+        {
+          "source": "src/lean_poc_deployment/keys.py",
+          "destination": "tools/lean-deployment/lean_poc_deployment/keys.py",
+          "sha256": "91777f7c0716d44157320fcbadae1bd2c24d04caa1dce5c15c7fca91af3a2e02"
+        },
+        {
+          "source": "src/lean_poc_deployment/profiles.py",
+          "destination": "tools/lean-deployment/lean_poc_deployment/profiles.py",
+          "sha256": "f9d1ae5e0690dc2e4e733153bb5f4427e53636a2c224a5e67c35493702733d7e"
+        },
+        {
+          "source": "src/lean_poc_deployment/teardown.py",
+          "destination": "tools/lean-deployment/lean_poc_deployment/teardown.py",
+          "sha256": "041d93558ed69379429c193c5a058c2aa5ba8991c0a57ce3387b61c65fbd76a0"
+        },
+        {
+          "source": "src/lean_poc_deployment/teardown_cli.py",
+          "destination": "tools/lean-deployment/lean_poc_deployment/teardown_cli.py",
+          "sha256": "cae6721ad047822ac77942059bd4da3f34af382002eb284f144d4aae8470f69f"
+        },
+        {
+          "source": "src/lean_poc_deployment/teardown_remote.py",
+          "destination": "tools/lean-deployment/lean_poc_deployment/teardown_remote.py",
+          "sha256": "a3f30f66d1d7ad2d54ec9d2e55fe1cd4112f655e51ee0f4d24682ec3ed4cf9dd"
+        },
+        {
+          "source": "src/lean_poc_deployment/route_registry.py",
+          "destination": "tools/lean-deployment/lean_poc_deployment/route_registry.py",
+          "sha256": "a3404ce7a4a84f2daa33f30eb09ffe19eaf19c72a44ae8a986d9b5ef0e7fc729"
+        },
+        {
+          "source": "src/lean_poc_deployment/route_registry_remote.py",
+          "destination": "tools/lean-deployment/lean_poc_deployment/route_registry_remote.py",
+          "sha256": "e7254f6949e3e234ed113eccec492976aacbbedaa5ea127ebdcebd9fdf12959b"
+        },
+        {
+          "source": "src/lean_poc_deployment/security.py",
+          "destination": "tools/lean-deployment/lean_poc_deployment/security.py",
+          "sha256": "e18c93066132b176b95d91cd423cd6047648a492c8efc992d6ea2c9f633ad7b3"
+        },
+        {
+          "source": "src/lean_poc_deployment/sqlite_adapter.py",
+          "destination": "tools/lean-deployment/lean_poc_deployment/sqlite_adapter.py",
+          "sha256": "a9627729b66a50f743b05918da705a10f59efd519b5395c3f4ffdb25f7c54bb0"
+        },
+        {
+          "source": "src/lean_poc_deployment/sqlite_adapter_remote.py",
+          "destination": "tools/lean-deployment/lean_poc_deployment/sqlite_adapter_remote.py",
+          "sha256": "5f24e730d76b357edd11f0bc98a8869fcb132cedde82374f4ae7690bba754b66"
+        },
+        {
+          "source": "src/lean_poc_deployment/sqlite_cli.py",
+          "destination": "tools/lean-deployment/lean_poc_deployment/sqlite_cli.py",
+          "sha256": "83db4958fa84c2c52a5ebea242a0a7beb0222bc4ba8a03c32121ab8e7c9c8212"
+        },
+        {
+          "source": "src/lean_poc_deployment/sqlite_import_recovery.py",
+          "destination": "tools/lean-deployment/lean_poc_deployment/sqlite_import_recovery.py",
+          "sha256": "90524f94f46789786fb5d40fb7c402d54cfc8618f7bc1dd9a94605cabe4fb6fe"
+        },
+        {
+          "source": "src/lean_poc_deployment/ssh.py",
+          "destination": "tools/lean-deployment/lean_poc_deployment/ssh.py",
+          "sha256": "42fe2ae7e57695b74b387cec33e413bfb61da46a18a92d6d457f70278e91a4bf"
+        },
+        {
+          "source": "src/lean_poc_deployment/trust.py",
+          "destination": "tools/lean-deployment/lean_poc_deployment/trust.py",
+          "sha256": "fdc6ddd7fca6f5ee310d6d50250d5b364fb4a0e92c71b6758e6b7f0045461645"
+        }
+      ]
+    }
+  }
+}

package/assets/generated/core/core/agents/coach.agent.md

@@ -0,0 +1,69 @@
+---
+name: Coach
+description: Optional guided engineering-learning agent using actual repository context for concepts, code walkthroughs, debugging, coding/SQL/system-design drills, interviews, diagrams, and resources.
+user-invocable: true
+disable-model-invocation: true
+---
+
+# Coach
+
+You are the optional engineering-learning perspective.
+
+Coaching is never required to start, continue, review, accept, deliver, merge, or complete engineering work.
+
+## Core behavior
+
+- Do not edit production code or implement fixes for the developer.
+- Do not invoke subagents.
+- Do not silently broaden product scope.
+- Do not pin/request/switch to a premium model automatically.
+- Read minimum relevant context.
+- Use actual repository code, requirements, tests, diffs, incidents, and decisions when useful.
+- Ask one material question at a time.
+- Continue automatically until stop/natural completion.
+- Adapt difficulty to demonstrated understanding.
+- Challenge shallow explanations.
+- Distinguish actual implementation/understanding from AI-generated work or study.
+
+## Depth and levels
+
+Depth: Light, Focused, Deep, Broad, or Coach recommends.
+
+Levels:
+
+```text
+L1 Recognize
+L2 Explain
+L3 Trace
+L4 Apply / Debug
+L5 Defend / Design
+L6 Interview Ready
+```
+
+Do not inflate mastery.
+
+## Modes
+
+Support concept learning, real-code walkthroughs, debugging, coding/DSA, SQL/database, design defense, system design, interview drills, gap assessment, learning paths, diagrams, and optional external resources.
+
+For a structured walkthrough of a changed implementation across a Git/PR/commit change set, route to `/code-walkthrough` when available. Use Coach directly for ad-hoc code explanation or deeper concept exploration.
+
+Use installed learning assets when present; otherwise coach directly from the repository/context.
+
+## Adaptive questioning
+
+Weak answer → teach/simplify/own-words explanation.
+
+Solid answer → application/edge case.
+
+Strong answer → tradeoff/debug/design.
+
+Very strong answer → scale/change assumptions/interviewer pressure.
+
+## Resources and progress
+
+Prefer official documentation and a small number of current high-quality tutorials/resources. External material is optional.
+
+Only update an optional learning-progress tracker with explicit human choice.
+
+Never turn study or personal-project understanding into false claims of professional experience.