@mriekki/project-forge 2.2.0 → 4.0.0

package/assets/components.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "package": "@mriekki/project-forge",
-  "version": "2.2.0",
+  "version": "4.0.0",
   "defaultProfile": "greenfield-project",
   "profiles": {
     "greenfield-project": {
@@ -14,8 +14,8 @@
   "components": {
     "core": {
       "repository": "mriekki/project-forge-core",
-      "commit": "d4487e07e732db4129bd092f86f6ceab36b02c15",
-      "version": "3.3.0",
+      "commit": "e20e9b0e7102477a30bc15a771d62ba537efe60c",
+      "version": "4.0.0",
       "distribution": "greenfield-workspace",
       "descriptor": "assets/core/distribution.json",
       "sourceRoot": "assets/generated/core",
@@ -23,7 +23,7 @@
     },
     "deployment": {
       "repository": "mriekki/project-forge-deployment-kit",
-      "commit": "54fcc256c525ea8762568043c3900f4d2d36c816",
+      "commit": "0974f36bcb5062c4becb7c5c4e0fbc3e629ad4a9",
       "distribution": "greenfield-project",
       "descriptor": "assets/deployment/distribution.json",
       "sourceRoot": "assets/generated/deployment",

package/assets/core/distribution.json

@@ -4,12 +4,10 @@
   "profileDestination": ".github/project-forge-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/project-forge-workflow.instructions.md","destination":".github/instructions/project-forge-workflow.instructions.md"},
     {"source":"core/instructions/project-forge-docs.instructions.md","destination":".github/instructions/project-forge-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/setup/SKILL.md","destination":".github/skills/setup/SKILL.md"},
@@ -23,10 +21,8 @@
     {"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/project-forge-update/SKILL.md","destination":".github/skills/project-forge-update/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/developer-env-mode/SKILL.md","destination":".github/skills/developer-env-mode/SKILL.md"},
     {"source":"core/skills/deployment-readiness/SKILL.md","destination":".github/skills/deployment-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"},

package/assets/deployment/distribution.json

@@ -49,6 +49,6 @@
     {"source": "docs/ENVIRONMENT_PROOF.md", "destination": "docs/project-forge/ENVIRONMENT_PROOF.md"},
     {"source": "docs/images/developer-environment-journey.svg", "destination": "docs/project-forge/images/developer-environment-journey.svg"},
     {"source": "docs/images/personal-environment-architecture.svg", "destination": "docs/project-forge/images/personal-environment-architecture.svg"},
-    {"source": "docs/images/poc-environment-model.svg", "destination": "docs/project-forge/images/poc-environment-model.svg"}
+    {"source": "docs/images/project-environment-model.svg", "destination": "docs/project-forge/images/project-environment-model.svg"}
   ]
 }

package/assets/generated/ASSEMBLY.json

@@ -1,12 +1,12 @@
 {
   "schemaVersion": 1,
   "package": "@mriekki/project-forge",
-  "version": "2.2.0",
+  "version": "4.0.0",
   "components": {
     "core": {
       "repository": "mriekki/project-forge-core",
-      "commit": "d4487e07e732db4129bd092f86f6ceab36b02c15",
-      "version": "3.3.0",
+      "commit": "e20e9b0e7102477a30bc15a771d62ba537efe60c",
+      "version": "4.0.0",
       "distribution": "greenfield-workspace",
       "files": [
         {
@@ -19,15 +19,10 @@
           "destination": ".github/agents/reviewer.agent.md",
           "sha256": "94255c72a6c875722ebaf8b0cb328fe019856c01443b550ca6e2f6c422da983e"
         },
-        {
-          "source": "core/agents/coach.agent.md",
-          "destination": ".github/agents/coach.agent.md",
-          "sha256": "f2da3ed8ba1890f0886615c0d7a66411265524dcaf04648ef10dfd195dde522e"
-        },
         {
           "source": "core/instructions/project-forge-workflow.instructions.md",
           "destination": ".github/instructions/project-forge-workflow.instructions.md",
-          "sha256": "aa03af8ef23d32d90a85adaeb549873e4de32798c58bfdaf7fe4183a549b1a17"
+          "sha256": "a6b28d916b67c9eec3831e414b56be3636512f7f7740523d22aaaf6efa00d335"
         },
         {
           "source": "core/instructions/project-forge-docs.instructions.md",
@@ -42,12 +37,7 @@
         {
           "source": "core/skills/grill-me/SKILL.md",
           "destination": ".github/skills/grill-me/SKILL.md",
-          "sha256": "d3c9885e1b32feeb940403a4c890f7ac552b7e9648a2589adb2cfabe33e19182"
-        },
-        {
-          "source": "core/skills/grill-with-docs/SKILL.md",
-          "destination": ".github/skills/grill-with-docs/SKILL.md",
-          "sha256": "facdfecee977ab01bbe908f6f122e483ea27c98a8f1562973f59f9266b63323e"
+          "sha256": "a71c2dcf63d7d88beb9112fcfe0cf19dbc233934f30bbe95727f58b29e845ffb"
         },
         {
           "source": "core/skills/refine-requirements/SKILL.md",
@@ -57,12 +47,12 @@
         {
           "source": "core/skills/start-work/SKILL.md",
           "destination": ".github/skills/start-work/SKILL.md",
-          "sha256": "5f4d46323d19bb7a1d4e64f233ae64aae8e1874da072d38cb344d3d834bdea8e"
+          "sha256": "f054edd5a745489623579d25e334f5fcd6cebd6e73b86970074e7c2444f9af40"
         },
         {
           "source": "core/skills/setup/SKILL.md",
           "destination": ".github/skills/setup/SKILL.md",
-          "sha256": "c295193b341accf03a35105e2e4defdf11aee0198b1e24b74ab371f3a6824985"
+          "sha256": "2f1b88b31b2c7233a00ab9293cd98a5fade00e114e1a442a793affbc7fe4ad83"
         },
         {
           "source": "core/skills/build/SKILL.md",
@@ -87,7 +77,7 @@
         {
           "source": "core/skills/progress/SKILL.md",
           "destination": ".github/skills/progress/SKILL.md",
-          "sha256": "7c9524859f4683feee2e8fac33ef3aa24f2b7b38099a37c3b65eb746aaba7391"
+          "sha256": "9b0ba914529e6bd91ad5fd7a30f666884c1687b35b847bfe77ed745c50f0fd12"
         },
         {
           "source": "core/skills/next-step/SKILL.md",
@@ -114,11 +104,6 @@
           "destination": ".github/skills/project-forge-update/SKILL.md",
           "sha256": "3463a68171fa30ef10f1ca514424236317ec364f015c5446f49911a1a3c9bb12"
         },
-        {
-          "source": "core/skills/core-sync/SKILL.md",
-          "destination": ".github/skills/core-sync/SKILL.md",
-          "sha256": "cbc498597cea7a48004fc507f9a6efc130544e57f347c0efdbb073f71f14965e"
-        },
         {
           "source": "core/skills/upstream-fix/SKILL.md",
           "destination": ".github/skills/upstream-fix/SKILL.md",
@@ -129,25 +114,20 @@
           "destination": ".github/skills/wait-what/SKILL.md",
           "sha256": "dba3aa4f042b813de960b60c47ae4c8a3dccb72fdc89c597fe04b720b27f5316"
         },
-        {
-          "source": "core/skills/developer-env-mode/SKILL.md",
-          "destination": ".github/skills/developer-env-mode/SKILL.md",
-          "sha256": "2e45e00e30f17edda5b259bd24852233d2bcace46f7e095d3b28faf9ce35cedb"
-        },
         {
           "source": "core/skills/deployment-readiness/SKILL.md",
           "destination": ".github/skills/deployment-readiness/SKILL.md",
-          "sha256": "846ddacc3f9acaecfce3ba62a6c1eb01149f1afd1013e307a81dc65e1351cbc4"
+          "sha256": "82eaf37f8acc4e3d69871a02ad38ab9bf94caccaa0b3a40784dbb622621e112c"
         },
         {
           "source": "core/skills/deploy/SKILL.md",
           "destination": ".github/skills/deploy/SKILL.md",
-          "sha256": "a2092940eea537223abcd4ed1cbea20dccdead538b21841b305f243686715af0"
+          "sha256": "8296d5cdd166dc5e0125df5d8ebc83d901a04f71caad8563ec67e9d02761955a"
         },
         {
           "source": "core/skills/tear-down/SKILL.md",
           "destination": ".github/skills/tear-down/SKILL.md",
-          "sha256": "5fcda93f4a0d1eca76a8a753f340fcb1799bddfe515324493e7d910f1c2253a3"
+          "sha256": "7565b5600af2883abfc47bac29abfd056cfa81536c52408b07da82f696b335b8"
         },
         {
           "source": "core/skills/coach/SKILL.md",
@@ -192,7 +172,7 @@
         {
           "source": "core/process/DEPLOYMENT_ENABLEMENT.md",
           "destination": "docs/process/DEPLOYMENT_ENABLEMENT.md",
-          "sha256": "987f6e68a2ab58d23388127fae2318b385ef86de389fc616c1e40b48c0ff3b07"
+          "sha256": "fa4f0bf3929d7d07b0061191232d39a7d03ae5e1e334e2aeafd27bad83b845fc"
         },
         {
           "source": "core/process/HUMAN_GATES.md",
@@ -207,7 +187,7 @@
         {
           "source": "core/process/INTERACTIVE_SESSION_GUIDE.md",
           "destination": "docs/process/INTERACTIVE_SESSION_GUIDE.md",
-          "sha256": "c35f2f4bc1b52746b205eab65982b32d9a2fe58f1c750f9744ddfdd320c3f52c"
+          "sha256": "8cd74fbd7433969923299849eb89bdd774fd4af1b9694639f0b9871a1047cacf"
         },
         {
           "source": "core/process/COACHING_GUIDE.md",
@@ -227,12 +207,12 @@
         {
           "source": "core/process/PROJECT_DOCUMENTATION_FRAMEWORK.md",
           "destination": "docs/process/PROJECT_DOCUMENTATION_FRAMEWORK.md",
-          "sha256": "3e77e85e7c8d466f8f3fbe588569cb6f0d9e1ca52e81f1803fae4481c8ea93d3"
+          "sha256": "bcb9f73dad1490ac5b45fe1bac931d488112727bad537534d8b9ffd5b115d84b"
         },
         {
           "source": "core/process/PROJECT_FORGE_ENGINEERING_GUIDE.md",
           "destination": "docs/project-forge/PROJECT_FORGE_ENGINEERING_GUIDE.md",
-          "sha256": "431eb3af7593f5f79f74ffdd306f56b5249a632c480fd6c3e5f0223161d376d9"
+          "sha256": "c09e0f088682302751d2f98629959cc4dab5e8a441ba19fb3417468e3895cc20"
         },
         {
           "source": "core/process/SETUP_ACCEPTANCE_CHECKLIST.md",
@@ -242,7 +222,7 @@
         {
           "source": "core/process/OPERATION_JOURNAL.md",
           "destination": "docs/process/OPERATION_JOURNAL.md",
-          "sha256": "16e2d502d7b0f923b4ea2e34bdcaaed73cdc0933fd6ef54a1278dd25f25b5140"
+          "sha256": "7051e4554ee6f3cca1b7ee8105ad1ab9f2cde4f1afc7d0f39e310144df45f390"
         },
         {
           "source": "core/process/PROJECT_REQUIREMENTS_EXPORT.md",
@@ -348,7 +328,7 @@
     },
     "deployment": {
       "repository": "mriekki/project-forge-deployment-kit",
-      "commit": "54fcc256c525ea8762568043c3900f4d2d36c816",
+      "commit": "0974f36bcb5062c4becb7c5c4e0fbc3e629ad4a9",
       "distribution": "greenfield-project",
       "files": [
         {
@@ -404,7 +384,7 @@
         {
           "source": "src/project_forge_deployment/cli.py",
           "destination": "tools/project-forge-deployment/project_forge_deployment/cli.py",
-          "sha256": "594915682f6b4e60bc6b63a43c5847d557f1fbfd3c22a2623e5bb572b6ab4dda"
+          "sha256": "3c3e7d4fadeccc1b8a7691c1a213250790fb728400914894c0d4e70a1ec91cc7"
         },
         {
           "source": "src/project_forge_deployment/doctor.py",
@@ -414,7 +394,7 @@
         {
           "source": "src/project_forge_deployment/entrypoint.py",
           "destination": "tools/project-forge-deployment/project_forge_deployment/entrypoint.py",
-          "sha256": "8f27177c65121a1e83b6a534ac18fc6474e138e0953caf2204ede95eb724cba9"
+          "sha256": "94c5eeff4ef684a4665909f7710d95fb4f65c118a71f60782b048697d6a495dd"
         },
         {
           "source": "src/project_forge_deployment/environment_cli.py",
@@ -424,7 +404,7 @@
         {
           "source": "src/project_forge_deployment/environment_probe.py",
           "destination": "tools/project-forge-deployment/project_forge_deployment/environment_probe.py",
-          "sha256": "6b0b9be56cf7ab4e7683755bc990c7c24a66951a3d9179862694ee2ff74e67ae"
+          "sha256": "3971264b425c9eb49845a48a54aea849ef35b36b86b13017c0946d3b90e9d707"
         },
         {
           "source": "src/project_forge_deployment/errors.py",
@@ -499,7 +479,7 @@
         {
           "source": "src/project_forge_deployment/route_registry.py",
           "destination": "tools/project-forge-deployment/project_forge_deployment/route_registry.py",
-          "sha256": "8c19da6790fac66d0cb8fe099fb09c026966a6e5952df58bd936ce03a72f1928"
+          "sha256": "ea08753878e9e6b59a8986aac7e40e40f66651cc704fff50842badf956705744"
         },
         {
           "source": "src/project_forge_deployment/route_registry_remote.py",
@@ -539,17 +519,17 @@
         {
           "source": "src/project_forge_deployment/teardown.py",
           "destination": "tools/project-forge-deployment/project_forge_deployment/teardown.py",
-          "sha256": "114b6e29725caaf105e67b5407de9a21c4ae9a9bfdc965bd4a0f1e91c316d011"
+          "sha256": "08215b8b5fa87ca8abf96f10f38aca0207840bd1b1faf4c2c53cb691caf20a72"
         },
         {
           "source": "src/project_forge_deployment/teardown_cli.py",
           "destination": "tools/project-forge-deployment/project_forge_deployment/teardown_cli.py",
-          "sha256": "e4f436a0f1bbbfcff4940c3f4b961b7acdb94f6e3e44bc0e8df10a46b13b8840"
+          "sha256": "214987895cde77648b5274042f1c21557046c3bf76224bfdd415ea34fec3d873"
         },
         {
           "source": "src/project_forge_deployment/teardown_remote.py",
           "destination": "tools/project-forge-deployment/project_forge_deployment/teardown_remote.py",
-          "sha256": "d4685f41d380047c69345bf689122d7c372441db24225b5fc218a76e1ec653c6"
+          "sha256": "ad764f5a67c43f81b4973dd5639b2c28b23ae883a85e5ae29efc14dad506e88e"
         },
         {
           "source": "src/project_forge_deployment/trust.py",
@@ -559,22 +539,22 @@
         {
           "source": "docs/DEVELOPER_ENVIRONMENTS.md",
           "destination": "docs/project-forge/DEVELOPER_ENVIRONMENTS.md",
-          "sha256": "32e0005102825d2da1a5b960b80b8485903337dc451f12e12bc93078611859f9"
+          "sha256": "e818931055044f6158ffe321303a5cbcd2f58724430d51e87c1688e1f71a8fbc"
         },
         {
           "source": "docs/WORKSPACE_INSTANCES.md",
           "destination": "docs/project-forge/WORKSPACE_INSTANCES.md",
-          "sha256": "8831f2c0bc7a5450464aafbe83e55825077469c2a24a4698a76b830446777cda"
+          "sha256": "43da263213d3822308d4a9bc57b53119e8b0abdc92e14afb354e88dedd2b0706"
         },
         {
           "source": "docs/ENVIRONMENT_PROOF.md",
           "destination": "docs/project-forge/ENVIRONMENT_PROOF.md",
-          "sha256": "27bd5751f071c0851655540e37c7cb160495a3458a98409221bfd14c4ddcb061"
+          "sha256": "d139ec1691d073e845a679edf45cb01c971a40b3ccc31404efb8c1e81e481ea5"
         },
         {
           "source": "docs/images/developer-environment-journey.svg",
           "destination": "docs/project-forge/images/developer-environment-journey.svg",
-          "sha256": "5b9e481015e1460afc66945740146da8390590dac307ffdc4ee62988cf001733"
+          "sha256": "f799027ee52105f482231998ecda9bf6f6e05590f131ec0c7d04cd8d27b3ca51"
         },
         {
           "source": "docs/images/personal-environment-architecture.svg",
@@ -582,9 +562,9 @@
           "sha256": "a2d5a4a6b52eaa451bb3b28eb9a856a30750b00e9f1c5932c645bdc8e96f935f"
         },
         {
-          "source": "docs/images/poc-environment-model.svg",
-          "destination": "docs/project-forge/images/poc-environment-model.svg",
-          "sha256": "7f2bc72ca7cad77e0de7673453e7a8508d1bc0e0628dc2777522f6e737bd4cef"
+          "source": "docs/images/project-environment-model.svg",
+          "destination": "docs/project-forge/images/project-environment-model.svg",
+          "sha256": "357896c40ff2c7a93bf77811af61d2559103d2e386a5fd887c7041d016114b10"
         }
       ]
     }

package/assets/generated/core/core/instructions/project-forge-workflow.instructions.md

@@ -18,7 +18,7 @@ Once a bounded action is authorized, routine mechanics inside that scope should
 
 For implementation, establish the repository-appropriate short-lived work branch as routine setup once implementation itself is authorized; do not add a separate branch-creation gate when branch policy/naming and scope are clear.
 
-Continuous modes such as `/grill-me`, `/grill-with-docs`, `/refine-requirements`, `/coach`, `/learning-review`, and `/deployment-readiness` continue until stopped or naturally complete.
+Continuous modes such as `/grill-me`, `/refine-requirements`, `/coach`, `/learning-review`, and `/deployment-readiness` continue until stopped or naturally complete.
 
 During interactive questioning, prefer concise choice-first options for genuinely bounded human decisions, including `Other / specify` and `Not sure — recommend one` when appropriate. When the host exposes native structured question controls, use them instead of a plain numbered chat list. In VS Code, use the host's structured question surface such as `vscode_askQuestions` when available: single-select for mutually exclusive decisions/actions and multi-select only when several simultaneous selections are valid. A textual numbered menu is only the fallback when structured choice UI is unavailable.
 
@@ -26,11 +26,17 @@ Make a recommendation only when current evidence, repository policy, or a clear
 
 Keep factual/environment-specific values and questions intended to elicit the human's own framing, reasoning, debugging approach, design rationale, or understanding open-ended unless options are later useful as scaffolding.
 
+`/grill-me` is the single adversarial-questioning entry point. It begins read-only and may, after one explicit session-level choice, reconcile resolved decisions into permitted local authorities or proposed external updates. Do not create a second documentation-aware grilling command.
+
+`/setup` is the single workstation/environment preparation entry point. It owns status, repair, verified local runtime convergence, remote-enabled capability preparation, and named-environment setup/proof. Do not create a second developer-environment-mode command. `/deployment-readiness <environment>` remains the later exact-environment pre-deploy verification step.
+
 For deployment readiness, inspect existing non-secret configuration before asking setup questions. Show already-known simple machine facts such as hostname/address, deployment user, port, and target OS for confirmation. Ask only for missing or conflicting facts. Keep deployment-tool implementation identifiers such as logical target names, `targetName`, SSH aliases, profile paths, and trust-file paths internal unless troubleshooting or genuine ambiguity requires them.
 
 Shared managed code keeps its canonical owner. When a consumer contains `CORE_BASELINE.json` or `DEPLOYMENT_BASELINE.json`, treat those baselines as ownership evidence. A temporary edit to a shared-managed consumer file may be used to diagnose or prove a reusable defect, but it is not the canonical deliverable.
 
-Before consumer delivery, run available managed-baseline integrity checks. If Core- or Deployment-Kit-managed files have unexplained local drift, stop before staging/commit/push and route the reusable change through `/upstream-fix`. Fix the owning canonical repository, deliver/merge it there under normal gates, then adopt the exact accepted shared commit back into the consumer through the appropriate sync mechanism and retest in consumer context.
+Before consumer delivery, run available managed-baseline integrity checks. If Core- or Deployment-Kit-managed files have unexplained local drift, stop before staging/commit/push and route the reusable change through `/upstream-fix`. Fix the owning canonical repository, deliver/merge it there under normal gates, then adopt the exact accepted shared commit back into the consumer through the appropriate update boundary and retest in consumer context.
+
+Package-managed generated Projects use `/project-forge-update`. Direct `/core-sync` remains only for component-only Core consumers without `PROJECT_FORGE_BASELINE.json` and is not part of the normal greenfield Project command surface.
 
 Do not manually preserve a private consumer fork of shared managed code merely because the consumer exposed the bug. Consumer-owned product/application files remain normal consumer implementation scope.
 

package/assets/generated/core/core/process/DEPLOYMENT_ENABLEMENT.md

@@ -104,7 +104,7 @@ Keep their targetable scope, runtime/container, route, data, readiness evidence,
 TOPOLOGY NOTE
 
 Staging and Production are logically isolated but share one physical
-failure domain. This may fit POC cost/learning goals, but it does not
+failure domain. This may fit Project cost/learning goals, but it does not
 demonstrate host-level Production isolation.
 ```
 

package/assets/generated/core/core/process/INTERACTIVE_SESSION_GUIDE.md

@@ -4,7 +4,6 @@ The following modes are continuous after the human explicitly enters them:
 
 ```text
 /grill-me
-/grill-with-docs
 /refine-requirements
 /coach
 /learning-review
@@ -85,7 +84,7 @@ Stop when:
 
 Continuous conversation never implies permission for unrelated file, Git, external-system, remote, or production writes.
 
-For modifying sessions such as requirement refinement or deployment-readiness documentation, one explicit session-level authorization may cover focused updates within the defined scope; do not re-ask after every answer.
+For modifying sessions such as `/grill-me` decision reconciliation, requirement refinement, or deployment-readiness documentation, one explicit session-level authorization may cover focused updates within the defined scope; do not re-ask after every answer.
 
 Compound action skills may also define their own bounded authorization. In particular, manually invoking `/deliver` after its prerequisites are satisfied authorizes routine branch/stage/commit/push/PR/CI mechanics within the accepted delivery scope. Do not interrupt that compound action with repeated ceremonial permission prompts. `/deliver` still stops for changed evidence, ambiguity/risk, and the explicit merge/finalize decision.
 

package/assets/generated/core/core/process/OPERATION_JOURNAL.md

@@ -47,11 +47,10 @@ Operation journals are workstation-local and must remain ignored by Git. They ar
 
 Journal deterministic operations when durable local diagnostics materially help:
 
-- `/setup` and repository-local setup/doctor execution;
+- `/setup` and repository-local setup/doctor execution, including local runtime convergence and remote-enabled environment preparation;
 - `/build` when build diagnostics/artifact evidence are useful;
 - `/run` as a concise startup/health receipt when useful, not as an unbounded application log sink;
 - `/project-forge-update` apply/verification work;
-- `/developer-env-mode` when it mutates or converges local runtime state;
 - `/deployment-readiness` when it performs preparation or repair;
 - environment proof operations;
 - `/deploy` and `/tear-down`;

package/assets/generated/core/core/process/PROJECT_DOCUMENTATION_FRAMEWORK.md

@@ -15,7 +15,7 @@ Project Forge project documentation is a small, evidence-aware engineering syste
 
 ## Canonical shape
 
-Greenfield POCs should normally converge on:
+Greenfield Projects should normally converge on:
 
 ```text
 README.md
@@ -82,7 +82,7 @@ Keep it short. It should answer:
 
 `PROJECT_BRIEF.md` is the integrated project briefing and navigation surface. It may summarize approved product scope, stack, environments, initial work items, learning goals, and important documentation links.
 
-It is **not** a second requirements authority. In a normal Project Forge greenfield POC:
+It is **not** a second requirements authority. In a normal Project Forge greenfield Project:
 
 - `docs/product/PRODUCT_BRIEF.md` remains product authority;
 - approved work-item briefs/requirements remain work-item authority;
@@ -143,7 +143,7 @@ Recommended schema:
 {
   "schemaVersion": 1,
   "site": {
-    "title": "Example POC",
+    "title": "Example Project",
     "entry": "PROJECT_BRIEF.md"
   },
   "documents": [

package/assets/generated/core/core/process/PROJECT_FORGE_ENGINEERING_GUIDE.md

@@ -31,7 +31,7 @@ The platform lowers the friction of starting a personal project while preserving
 | Choice | Select a technology direction based on project needs or learning goals, with explicit support-state signals rather than hidden assumptions. |
 | Discipline | Use a Project Forge workflow with bounded implementation, review, CI evidence, and meaningful human acceptance points. |
 | Learning | Build understanding alongside code through work-item guides, code walkthroughs, learning review, and targeted coaching. |
-| Realism | Exercise containerization, source control, CI, releases, environment isolation, and deployment tradeoffs without pretending every POC needs dedicated Staging/Production computers. |
+| Realism | Exercise containerization, source control, CI, releases, environment isolation, and deployment tradeoffs without pretending every Project needs dedicated Staging/Production computers. |
 | Repeatability | Create self-contained generated repositories with explicit provenance and controlled platform updates. |
 
 ### Why this is different from “generate me an app”
@@ -65,23 +65,23 @@ Clear ownership boundaries keep process, package transport, orchestration, deplo
 
 ```mermaid
 flowchart TB
-  BOOT[POC Bootstrap<br/>Discovery, catalog, manifests,<br/>deterministic generation] --> POC[Generated POC<br/>self-contained consumer]
-  CORE[Agentic Core<br/>Workflow, agents, skills,<br/>HITL gates, learning] --> POC
-  PLATFORM[Project Forge Platform / @mriekki/project-forge<br/>Exact accepted reusable components] --> POC
-  CONTROL[Control Plane<br/>GitHub App orchestration<br/>and safe publication] --> POC
-  DEPLOY[Deployment Kit<br/>Workstation + remote-target mechanics] --> POC
+  BOOT[Project Bootstrap<br/>Discovery, catalog, manifests,<br/>deterministic generation] --> PROJECT[Generated Project<br/>self-contained consumer]
+  CORE[Agentic Core<br/>Workflow, agents, skills,<br/>HITL gates, learning] --> PROJECT
+  PLATFORM[Project Forge Platform / @mriekki/project-forge<br/>Exact accepted reusable components] --> PROJECT
+  CONTROL[Control Plane<br/>GitHub App orchestration<br/>and safe publication] --> PROJECT
+  DEPLOY[Deployment Kit<br/>Workstation + remote-target mechanics] --> PROJECT
 ```
 
 | Layer | Responsibility |
 | --- | --- |
-| POC Bootstrap | Discovery protocol, catalog/support states, approved `PROJECT_BOOTSTRAP.json`, deployment topology intent, deterministic generation, setup/readiness helpers, work-item materialization. |
+| Project Bootstrap | Discovery protocol, catalog/support states, approved `PROJECT_BOOTSTRAP.json`, deployment topology intent, deterministic generation, setup/readiness helpers, work-item materialization. |
 | Agentic Core | Reusable workflow behavior, agents/skills, Human-in-the-Loop gates, review/delivery semantics, learning flows, topology-aware deployment orchestration. |
 | Project Forge Platform | Consumer-facing `@mriekki/project-forge` package that assembles exact accepted reusable components and records provenance. |
 | Control Plane | GitHub App orchestration for target validation, short-lived scoped credentials, deterministic generation, and safe publication. |
 | Deployment Kit | Reusable one-workstation loopback-container runtime plus strict remote target/access, Ubuntu/Docker/Caddy routing, persistence, and scoped tear-down mechanics. Managed hosting remains adapter-specific rather than generic implied support. |
-| Generated POC | Owns product scope, architecture, code/tests, work items, CI evidence, logical environment/topology facts, concrete deployment bindings, accepted baselines, and implementation history. |
+| Generated Project | Owns product scope, architecture, code/tests, work items, CI evidence, logical environment/topology facts, concrete deployment bindings, accepted baselines, and implementation history. |
 
-**Architectural outcome:** a generated POC remains usable on its own. Normal development and deployment do not depend on sibling clones of the platform repositories.
+**Architectural outcome:** a generated Project remains usable on its own. Normal development and deployment do not depend on sibling clones of the platform repositories.
 
 ---
 
@@ -191,7 +191,7 @@ flowchart LR
 
 ### Use AI to increase capability, not only throughput
 
-The system treats a personal POC as both a software deliverable and a deliberate learning vehicle — without turning learning into a release gate.
+The system treats a personal Project as both a software deliverable and a deliberate learning vehicle — without turning learning into a release gate.
 
 - **Embedded context** — work-item Implementation & Learning Guides connect engineering outcomes to concepts, reasoning prompts, things to notice, hands-on opportunities, and learning evidence.
 - **Code walkthrough** — `/code-walkthrough` explains the actual implementation, architecture boundaries, control flow, and important tradeoffs after the work exists.
@@ -271,7 +271,7 @@ The original briefing used Family Meal Planner v3 to demonstrate re-baselining a
 - **Selected stack:** `dotnet-react-sqlite` recipe with partial support; generic scaffold intentionally deferred rather than allowed to overwrite mature architecture decisions.
 - **First work item:** EN-001 — Application Foundation / Walking Skeleton: prove React, ASP.NET, browser-to-API, SQLite through approved layers, dependency injection, health/system info, Compose, and CI.
 - **App-specific deployment model in that reference consumer:** Production and Staging are distinct Ubuntu environments over trusted-LAN SSH with separate target/access contracts and no cross-environment fallback.
-- **Learning goal:** use the project as a hands-on software-engineering POC and build enough understanding to review and explain the system rather than only accept generated implementation.
+- **Learning goal:** use the project as a hands-on software-engineering Project and build enough understanding to review and explain the system rather than only accept generated implementation.
 - **Lifecycle point in the original briefing:** the v3 repository had an approved seed manifest and was at the GitHub-first generation handoff when the original briefings were prepared.
 
 The FMP topology is an **example consumer choice**, not a reusable requirement for other Project Forge users.
@@ -287,13 +287,13 @@ The FMP topology is an **example consumer choice**, not a reusable requirement f
 The strongest claim is not that AI can do everything. It is that a reusable operating model can make disciplined engineering the lowest-friction way to explore an idea.
 
 - **Not “any stack, fully automated.”** Technology choice is broad; Bootstrap automation is claimed only where the live catalog supports it.
-- **Not “every POC needs servers.”** One-machine local/demo and explicitly deferred deployment are valid outcomes.
+- **Not “every Project needs servers.”** One-machine local/demo and explicitly deferred deployment are valid outcomes.
 - **Not generic cloud support.** A plausible provider is not supported until a provider adapter is cataloged, implemented, and proven.
 - **Not autonomous Production.** Merge, CI, or release publication never implies Production deployment. Production and destructive operations remain separately gated regardless of placement.
 - **Not model-dependent.** Repository-local workflow assets define behavior; Core does not rely on one fixed AI model to preserve the engineering process.
-- **Not hidden regeneration.** Generated POCs are self-contained consumers. Reusable updates go through controlled package/baseline paths rather than silent wholesale regeneration.
+- **Not hidden regeneration.** Generated Projects are self-contained consumers. Reusable updates go through controlled package/baseline paths rather than silent wholesale regeneration.
 - **AI drift is bounded.** Repository protocol, catalog, baselines, and project-owned artifacts outrank conversational inference about project state.
-- **Still a POC platform.** This is a disciplined engineering POC platform with strong foundations and explicit remaining proof/maturity work — not a finished enterprise developer platform.
+- **Still a Project platform.** This is a disciplined engineering Project platform with strong foundations and explicit remaining proof/maturity work — not a finished enterprise developer platform.
 
 ### Strategic takeaway
 

package/assets/generated/core/core/skills/deploy/SKILL.md

@@ -48,7 +48,7 @@ Read only what is needed, including when present:
 - fresh setup-time environment-proof evidence for this workstation;
 - established application deployment facts.
 
-For package-managed generated POCs, prefer the repository-distributed launcher:
+For package-managed generated Projects, prefer the repository-distributed launcher:
 
 ```text
 tools/project-forge-deployment/project-forge-deploy.py

package/assets/generated/core/core/skills/deployment-readiness/SKILL.md

@@ -171,7 +171,7 @@ select exact project-defined environment
 → /deploy <environment>
 ```
 
-For remote placement, reuse valid existing target access rather than creating duplicate credentials simply because another POC/environment uses the same machine.
+For remote placement, reuse valid existing target access rather than creating duplicate credentials simply because another Project/environment uses the same machine.
 
 ## 6. Read-only status