@mriekki/project-forge 2.2.0 → 3.0.0

package/assets/components.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "package": "@mriekki/project-forge",
-  "version": "2.2.0",
+  "version": "3.0.0",
   "defaultProfile": "greenfield-project",
   "profiles": {
     "greenfield-project": {
@@ -14,7 +14,7 @@
   "components": {
     "core": {
       "repository": "mriekki/project-forge-core",
-      "commit": "d4487e07e732db4129bd092f86f6ceab36b02c15",
+      "commit": "17a09fc913a12902c4a9172e53bc70d421f5b0d5",
       "version": "3.3.0",
       "distribution": "greenfield-workspace",
       "descriptor": "assets/core/distribution.json",
@@ -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/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,11 +1,11 @@
 {
   "schemaVersion": 1,
   "package": "@mriekki/project-forge",
-  "version": "2.2.0",
+  "version": "3.0.0",
   "components": {
     "core": {
       "repository": "mriekki/project-forge-core",
-      "commit": "d4487e07e732db4129bd092f86f6ceab36b02c15",
+      "commit": "17a09fc913a12902c4a9172e53bc70d421f5b0d5",
       "version": "3.3.0",
       "distribution": "greenfield-workspace",
       "files": [
@@ -62,7 +62,7 @@
         {
           "source": "core/skills/setup/SKILL.md",
           "destination": ".github/skills/setup/SKILL.md",
-          "sha256": "c295193b341accf03a35105e2e4defdf11aee0198b1e24b74ab371f3a6824985"
+          "sha256": "60dcb93e98f6f00177e9e2d406c55f15bd59ebf8607c3f79ae464fe7c00616b6"
         },
         {
           "source": "core/skills/build/SKILL.md",
@@ -87,7 +87,7 @@
         {
           "source": "core/skills/progress/SKILL.md",
           "destination": ".github/skills/progress/SKILL.md",
-          "sha256": "7c9524859f4683feee2e8fac33ef3aa24f2b7b38099a37c3b65eb746aaba7391"
+          "sha256": "9b0ba914529e6bd91ad5fd7a30f666884c1687b35b847bfe77ed745c50f0fd12"
         },
         {
           "source": "core/skills/next-step/SKILL.md",
@@ -137,17 +137,17 @@
         {
           "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 +192,7 @@
         {
           "source": "core/process/DEPLOYMENT_ENABLEMENT.md",
           "destination": "docs/process/DEPLOYMENT_ENABLEMENT.md",
-          "sha256": "987f6e68a2ab58d23388127fae2318b385ef86de389fc616c1e40b48c0ff3b07"
+          "sha256": "fa4f0bf3929d7d07b0061191232d39a7d03ae5e1e334e2aeafd27bad83b845fc"
         },
         {
           "source": "core/process/HUMAN_GATES.md",
@@ -227,12 +227,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",
@@ -348,7 +348,7 @@
     },
     "deployment": {
       "repository": "mriekki/project-forge-deployment-kit",
-      "commit": "54fcc256c525ea8762568043c3900f4d2d36c816",
+      "commit": "0974f36bcb5062c4becb7c5c4e0fbc3e629ad4a9",
       "distribution": "greenfield-project",
       "files": [
         {
@@ -404,7 +404,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 +414,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 +424,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 +499,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 +539,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 +559,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 +582,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/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/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
 

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

@@ -1,6 +1,6 @@
 ---
 name: progress
-description: "Read-only developer-facing progress view across POC creation, this workspace instance, work-item/delivery state, and exact project-defined environment capabilities."
+description: "Read-only developer-facing progress view across Project creation, this workspace instance, work-item/delivery state, and exact project-defined environment capabilities."
 argument-hint: "[optional work-item ID or environment]"
 user-invocable: true
 disable-model-invocation: true

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

@@ -8,7 +8,7 @@ disable-model-invocation: true
 
 # Setup
 
-Purpose: give the developer one obvious entry point after cloning/opening a Project Forge workspace, whether this is the first workstation for the project or an additional independent workstation for an existing POC.
+Purpose: give the developer one obvious entry point after cloning/opening a Project Forge workspace, whether this is the first workstation for the project or an additional independent workstation for an existing Project.
 
 Normal first use is simply:
 
@@ -107,7 +107,7 @@ Each workstation normally owns independent local development data. Reproduce sch
 
 ## 4. Establish/sync the developer's personal Project Forge profile
 
-When the installed Deployment Kit exposes personal-profile operations, `/setup` should establish the authenticated developer's portable non-secret profile as routine setup state. This repo is per developer, not per POC or workstation.
+When the installed Deployment Kit exposes personal-profile operations, `/setup` should establish the authenticated developer's portable non-secret profile as routine setup state. This repo is per developer, not per Project or workstation.
 
 First inspect profile status and authenticated GitHub login. If the expected private repository is missing, tell the developer what will happen before writing:
 
@@ -170,7 +170,7 @@ Use `PROJECT_BOOTSTRAP.json` deployment topology only as the initial topology fa
 
 `PROJECT_BOOTSTRAP.json` is generation/provenance evidence and should not be casually rewritten merely because a developer adds an environment later.
 
-If an older POC has no `DEPLOYMENT_TOPOLOGY.json` and the developer chooses to add/change a logical environment, first materialize the currently approved deployment topology into the project-owned file, then make the scoped project configuration change there. Preserve the original Bootstrap provenance file.
+If an older Project has no `DEPLOYMENT_TOPOLOGY.json` and the developer chooses to add/change a logical environment, first materialize the currently approved deployment topology into the project-owned file, then make the scoped project configuration change there. Preserve the original Bootstrap provenance file.
 
 A topology entry should keep logical identity distinct from purpose and placement. A name such as `demo`, `qa`, or `prod-east` is the command-facing environment identity. Its purpose remains one of the project-supported semantic roles such as development/demo/staging/production.
 
@@ -220,7 +220,7 @@ If host prerequisites cannot yet be prepared automatically, report the exact pre
 
 When the installed Deployment Kit exposes environment proof operations, a selected remote environment should normally be taken through an end-to-end **environment proof deployment** during setup.
 
-The proof is not the POC application. It is a tiny disposable Project Forge-owned probe that should:
+The proof is not the Project application. It is a tiny disposable Project Forge-owned probe that should:
 
 ```text
 acquire a small stable probe image on this workstation
@@ -349,7 +349,7 @@ When the installed Deployment Kit exposes profile migration and this workstation
 
 Never ask the developer to paste passwords, PATs, private SSH keys, or other credentials into chat.
 
-When a repository/tool needs a credential, direct the deterministic local tool to prompt in the local terminal using a hidden/secure prompt. Secrets remain workstation-local and must not be committed to the POC repository or portable profile.
+When a repository/tool needs a credential, direct the deterministic local tool to prompt in the local terminal using a hidden/secure prompt. Secrets remain workstation-local and must not be committed to the Project repository or portable profile.
 
 ## 13. Relationship to other Project Forge commands
 

package/assets/generated/core/core/skills/tear-down/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: tear-down
-description: "Guided destructive cleanup for local state, one exact repository-defined named environment, or all explicitly configured POC environments. Preserves ownership boundaries and resolved Production-data authorization."
+description: "Guided destructive cleanup for local state, one exact repository-defined named environment, or all explicitly configured Project environments. Preserves ownership boundaries and resolved Production-data authorization."
 argument-hint: "[local|<environment>|all]"
 user-invocable: true
 disable-model-invocation: true
@@ -8,7 +8,7 @@ disable-model-invocation: true
 
 # Tear Down
 
-`/tear-down` is the human-facing destructive cleanup workflow for repository-owned POC state.
+`/tear-down` is the human-facing destructive cleanup workflow for repository-owned Project state.
 
 Logical environment names are data-driven and are not limited to Staging/Production:
 
@@ -47,7 +47,7 @@ all
 
 If no scope is named, present only scopes the repository actually supports; never silently default to a Production environment or `all`.
 
-`all` means only all explicitly configured scopes for this POC; it never means machine-wide cleanup.
+`all` means only all explicitly configured scopes for this Project; it never means machine-wide cleanup.
 
 Selecting scope does not authorize deletion. Physical colocation never merges ownership: deleting `demo` must not remove `staging` or `prod-east` merely because they share hardware.
 
@@ -99,7 +99,7 @@ Do not promise deletion of named/shared Docker volumes unless the installed dete
 Every modifying tear-down requires the installed normal authorization, conceptually:
 
 ```text
-[POC TEAR DOWN]
+[PROJECT TEAR DOWN]
 ```
 
 whenever **any selected environment is Production-class**, require the stronger Production-data deletion authorization, conceptually:

package/assets/generated/deployment/docs/DEVELOPER_ENVIRONMENTS.md

@@ -13,7 +13,7 @@ The happy path intentionally hides Bootstrap/package/control-plane plumbing. Dev
 The normal progression is:
 
 ```text
-generated POC repository
+generated Project repository
 → clone/open workspace
 → /setup
 → LOCAL READY
@@ -42,7 +42,7 @@ The normal conversational entry point is:
 
 `/setup` explains the current state/options and invokes the correct repository-local setup launcher. Direct script invocation remains the non-AI/automation fallback.
 
-The first local success target is `LOCAL WORKSPACE READY`. Remote access must not block it unless the POC explicitly requires a remote dependency for local development.
+The first local success target is `LOCAL WORKSPACE READY`. Remote access must not block it unless the Project explicitly requires a remote dependency for local development.
 
 ## Progress and next action
 
@@ -156,11 +156,11 @@ A changed previously pinned host key remains a blocker and requires explicit tru
 
 ## Docker and host preparation
 
-Docker is a workstation/target capability, not something every POC should reinstall.
+Docker is a workstation/target capability, not something every Project should reinstall.
 
 ### Developer workstation
 
-The first POC on a computer may install/verify required local tools and Docker through the generated setup contract. Later POCs reuse the ready workstation.
+The first Project on a computer may install/verify required local tools and Docker through the generated setup contract. Later Projects reuse the ready workstation.
 
 ### Remote Ubuntu target
 
@@ -209,17 +209,17 @@ A credential needed to acquire a private image is entered only through the local
 
 If the exact immutable image is already cached locally, registry authentication is not required merely to transfer it to the remote target.
 
-## POC environment model
+## Project environment model
 
-![POC environment model](images/poc-environment-model.svg)
+![Project environment model](images/project-environment-model.svg)
 
-The POC owns project-specific facts such as environment identities/roles, placement, target binding, application image, runtime/health contract, persistence, routes/exposure, and Production classification/authorization.
+The Project owns project-specific facts such as environment identities/roles, placement, target binding, application image, runtime/health contract, persistence, routes/exposure, and Production classification/authorization.
 
-The reusable workstation/target layer owns machine mechanics. A POC references targets; it does not own or duplicate a developer's private credentials.
+The reusable workstation/target layer owns machine mechanics. A Project references targets; it does not own or duplicate a developer's private credentials.
 
 ## New workstation
 
-A developer normally starts from any generated POC:
+A developer normally starts from any generated Project:
 
 ```text
 clone repository
@@ -233,7 +233,7 @@ When GitHub is reachable, personal profile sync supplies portable target definit
 
 ## New remote box
 
-Adding a new remote target is a workstation-driven onboarding operation, not a POC implementation step:
+Adding a new remote target is a workstation-driven onboarding operation, not a Project implementation step:
 
 ```text
 add/import portable target definition
@@ -243,7 +243,7 @@ add/import portable target definition
 → TARGET READY
 ```
 
-Once ready, multiple POCs can bind logical environments to that target without repeating host bootstrap.
+Once ready, multiple Projects can bind logical environments to that target without repeating host bootstrap.
 
 ## Portable export/import fallback
 

package/assets/generated/deployment/docs/ENVIRONMENT_PROOF.md

@@ -1,6 +1,6 @@
 # Environment Proof Deployment
 
-A Project Forge environment proof verifies that one developer workstation can exercise the real remote deployment path for one exact named logical environment before the POC application exists or before its first real deployment.
+A Project Forge environment proof verifies that one developer workstation can exercise the real remote deployment path for one exact named logical environment before the Project application exists or before its first real deployment.
 
 It is intentionally **not** the project application.
 
@@ -84,7 +84,7 @@ The proof attempts cleanup even when deployment raises after mutation begins.
 
 Successful completion requires terminal cleanup evidence (`removed` or already `absent`) for the reserved probe runtime. If deployment succeeds but cleanup cannot be verified, the command fails rather than reporting a clean proof.
 
-The probe must not delete another POC, another application, another logical environment, or shared host platform state.
+The probe must not delete another Project, another application, another logical environment, or shared host platform state.
 
 ## Relationship to `/setup` and `/deploy`
 

package/assets/generated/deployment/docs/WORKSPACE_INSTANCES.md

@@ -63,7 +63,7 @@ Local mutable application data is not synchronized between workstations by Proje
 
 ## Setup on another workstation
 
-The normal flow for an existing generated POC is:
+The normal flow for an existing generated Project is:
 
 ```text
 clone repository

package/assets/generated/deployment/docs/images/developer-environment-journey.svg

@@ -1,6 +1,6 @@
 <svg xmlns="http://www.w3.org/2000/svg" width="1200" height="520" viewBox="0 0 1200 520" role="img" aria-labelledby="title desc">
   <title id="title">Project Forge developer environment journey</title>
-  <desc id="desc">Generated POC repository progresses through clone and setup to local ready, then optionally to staging ready and production ready.</desc>
+  <desc id="desc">Generated Project repository progresses through clone and setup to local ready, then optionally to staging ready and production ready.</desc>
   <defs>
     <linearGradient id="bg" x1="0" y1="0" x2="1" y2="1">
       <stop offset="0" stop-color="#0b1220"/>
@@ -20,7 +20,7 @@
   <g filter="url(#shadow)" font-family="Inter,Segoe UI,Arial,sans-serif">
     <rect x="70" y="180" width="205" height="128" rx="18" fill="#1e2a40" stroke="#405274" stroke-width="2"/>
     <text x="172" y="222" text-anchor="middle" font-size="15" font-weight="700" fill="#91a4c4">PROJECT</text>
-    <text x="172" y="254" text-anchor="middle" font-size="22" font-weight="700" fill="#ffffff">Generated POC</text>
+    <text x="172" y="254" text-anchor="middle" font-size="22" font-weight="700" fill="#ffffff">Generated Project</text>
     <text x="172" y="282" text-anchor="middle" font-size="15" fill="#b8c5d8">clone + open workspace</text>
 
     <rect x="360" y="180" width="205" height="128" rx="18" fill="#1f3440" stroke="#3b7584" stroke-width="2"/>

package/assets/generated/deployment/docs/images/{poc-environment-model.svg → project-environment-model.svg}

@@ -1,6 +1,6 @@
 <svg xmlns="http://www.w3.org/2000/svg" width="1200" height="720" viewBox="0 0 1200 720" role="img" aria-labelledby="title desc">
   <title id="title">Project Forge environment model</title>
-  <desc id="desc">A POC uses local workstation runtime and optional remote logical staging and production environments bound to reusable remote targets and shared host platform infrastructure.</desc>
+  <desc id="desc">A Project uses local workstation runtime and optional remote logical staging and production environments bound to reusable remote targets and shared host platform infrastructure.</desc>
   <defs>
     <linearGradient id="bg" x1="0" y1="0" x2="1" y2="1">
       <stop offset="0" stop-color="#0b1220"/>
@@ -14,12 +14,12 @@
     </marker>
   </defs>
   <rect width="1200" height="720" rx="24" fill="url(#bg)"/>
-  <text x="70" y="70" font-family="Inter,Segoe UI,Arial,sans-serif" font-size="30" font-weight="700" fill="#f7f9fc">POC Environment Model</text>
-  <text x="70" y="102" font-family="Inter,Segoe UI,Arial,sans-serif" font-size="17" fill="#aebbd0">The POC owns application/environment facts; reusable workstation and target layers own machine mechanics.</text>
+  <text x="70" y="70" font-family="Inter,Segoe UI,Arial,sans-serif" font-size="30" font-weight="700" fill="#f7f9fc">Project Environment Model</text>
+  <text x="70" y="102" font-family="Inter,Segoe UI,Arial,sans-serif" font-size="17" fill="#aebbd0">The Project owns application/environment facts; reusable workstation and target layers own machine mechanics.</text>
 
   <g filter="url(#shadow)" font-family="Inter,Segoe UI,Arial,sans-serif">
     <rect x="390" y="135" width="420" height="106" rx="20" fill="#25294a" stroke="#7277c9" stroke-width="2"/>
-    <text x="600" y="176" text-anchor="middle" font-size="15" font-weight="700" fill="#aaaef1">GENERATED POC</text>
+    <text x="600" y="176" text-anchor="middle" font-size="15" font-weight="700" fill="#aaaef1">GENERATED Project</text>
     <text x="600" y="209" text-anchor="middle" font-size="21" font-weight="700" fill="#ffffff">Environment bindings + app runtime facts</text>
 
     <rect x="95" y="330" width="300" height="190" rx="20" fill="#173c35" stroke="#3a9d82" stroke-width="2"/>

package/assets/generated/deployment/src/project_forge_deployment/cli.py

@@ -283,7 +283,7 @@ def build_parser() -> argparse.ArgumentParser:
     route_inventory_parser.add_argument("--json", action="store_true")
 
     route_register = route_sub.add_parser(
-        "register", help="Create or update one POC/environment-owned Caddy + mDNS route"
+        "register", help="Create or update one Project/environment-owned Caddy + mDNS route"
     )
     route_register.add_argument("name")
     route_register.add_argument("--owner-repo", required=True)

package/assets/generated/deployment/src/project_forge_deployment/entrypoint.py

@@ -33,5 +33,5 @@ def main(argv: list[str] | None = None) -> int:
         print("Command group: local  Loopback-only workstation application runtime")
         print("Command group: registry  Read-only exact-image registry access verification")
         print("Command group: sqlite  SQLite persistence import/backup/migration/rollback checks")
-        print("Command group: tear-down  Scoped destructive POC environment/local cleanup")
+        print("Command group: tear-down  Scoped destructive Project environment/local cleanup")
     return core_main(args)

package/assets/generated/deployment/src/project_forge_deployment/environment_probe.py

@@ -14,7 +14,7 @@ from .app_runtime_workstation import apply_app_deploy_from_workstation
 from .box_platform import platform_status
 from .errors import DeploymentKitError
 from .registry_access import normalize_registry_image
-from .teardown import tear_down_poc
+from .teardown import tear_down_project
 
 ENVIRONMENT_PROOF_WRITE_PHRASE = "[ENVIRONMENT PROOF WRITE]"
 PRODUCTION_ENVIRONMENT_PROOF_WRITE_PHRASE = "[PRODUCTION ENVIRONMENT PROOF]"
@@ -171,7 +171,7 @@ def run_environment_proof(plan: dict[str, Any]) -> dict[str, Any]:
         deploy_error = error
     finally:
         try:
-            cleanup = tear_down_poc(
+            cleanup = tear_down_project(
                 {
                     "ownerRepo": plan["ownerRepo"],
                     "appSlug": plan["probeAppSlug"],

package/assets/generated/deployment/src/project_forge_deployment/route_registry.py

@@ -270,7 +270,7 @@ def plan_route_registration(
         owner_fields = ("ownerRepo", "environment", "appSlug")
         if any(existing[field] != spec[field] for field in owner_fields):
             raise DeploymentKitError(
-                f"Route ID {spec['routeId']} is already owned by another POC/environment; refusing takeover."
+                f"Route ID {spec['routeId']} is already owned by another Project/environment; refusing takeover."
             )
     requested = set(spec["hostnames"])
     for route in inventory["managedRoutes"]:
@@ -312,7 +312,7 @@ def plan_route_removal(
     if existing is None:
         raise DeploymentKitError(f"Managed route does not exist: {route_id}")
     if existing["ownerRepo"] != owner_repo or existing["environment"] != environment or existing["appSlug"] != app_slug:
-        raise DeploymentKitError("Route removal ownership does not match the registered POC/environment.")
+        raise DeploymentKitError("Route removal ownership does not match the registered Project/environment.")
     return {
         "targetName": name,
         "action": "remove",

package/assets/generated/deployment/src/project_forge_deployment/teardown.py

@@ -15,7 +15,7 @@ from .route_registry import apply_route_change, plan_route_removal, route_invent
 from .ssh import ssh_args, verify_access
 from .teardown_remote import REMOTE_SCRIPT
 
-TEAR_DOWN_WRITE_PHRASE = "[POC TEAR DOWN]"
+TEAR_DOWN_WRITE_PHRASE = "[PROJECT TEAR DOWN]"
 PRODUCTION_DATA_DELETE_PHRASE = "[PRODUCTION DATA DELETE]"
 RESERVED_SCOPES = ("local", "all")
 
@@ -167,13 +167,13 @@ def _tear_down_remote_environment(
     stderr = completed.stderr.decode("utf-8", errors="replace").strip()
     if completed.returncode != 0:
         raise DeploymentKitError(
-            "Remote POC tear-down failed: " + (stderr or stdout or f"exit {completed.returncode}")
+            "Remote Project tear-down failed: " + (stderr or stdout or f"exit {completed.returncode}")
         )
     parts = stdout.split("\t")
     if len(parts) not in {4, 5} or parts[0] != "TEAR_DOWN" or parts[1] not in {"absent", "removed"}:
-        raise DeploymentKitError("Remote POC tear-down returned malformed evidence.")
+        raise DeploymentKitError("Remote Project tear-down returned malformed evidence.")
     if parts[2] != app_slug or parts[3] != environment:
-        raise DeploymentKitError("Remote POC tear-down returned mismatched app/environment evidence.")
+        raise DeploymentKitError("Remote Project tear-down returned mismatched app/environment evidence.")
     result: dict[str, Any] = {"state": parts[1], "mutated": parts[1] == "removed"}
     if len(parts) == 5:
         result["containerName"] = parts[4]
@@ -219,7 +219,7 @@ def tear_down_workstation_package(package: str) -> dict[str, Any]:
         removed = _run_local([docker, "rm", "-f", "-v", *containers])
         if removed.returncode != 0:
             raise DeploymentKitError(
-                "Local POC container removal failed: " + (removed.stderr or removed.stdout).strip()
+                "Local Project container removal failed: " + (removed.stderr or removed.stdout).strip()
             )
 
     images_result = _run_local([docker, "images", "--format", "{{.Repository}}:{{.Tag}}"])
@@ -238,7 +238,7 @@ def tear_down_workstation_package(package: str) -> dict[str, Any]:
         removed = _run_local([docker, "image", "rm", "-f", *image_refs])
         if removed.returncode != 0:
             raise DeploymentKitError(
-                "Local POC image removal failed: " + (removed.stderr or removed.stdout).strip()
+                "Local Project image removal failed: " + (removed.stderr or removed.stdout).strip()
             )
     return {
         "state": "removed" if containers or image_refs else "absent",
@@ -248,7 +248,7 @@ def tear_down_workstation_package(package: str) -> dict[str, Any]:
     }
 
 
-def tear_down_poc(spec: dict[str, Any]) -> dict[str, Any]:
+def tear_down_project(spec: dict[str, Any]) -> dict[str, Any]:
     normalized = normalize_teardown_spec(
         owner_repo=spec.get("ownerRepo"),
         app_slug=spec.get("appSlug"),

package/assets/generated/deployment/src/project_forge_deployment/teardown_cli.py

@@ -1,4 +1,4 @@
-"""CLI for scoped destructive POC tear-down."""
+"""CLI for scoped destructive Project tear-down."""
 
 from __future__ import annotations
 
@@ -12,7 +12,7 @@ from .teardown import (
     normalize_teardown_spec,
     parse_environment_targets,
     render_teardown_summary,
-    tear_down_poc,
+    tear_down_project,
 )
 
 
@@ -83,7 +83,7 @@ def _preview(spec: dict[str, object]) -> dict[str, object]:
         "deletesPersistentData": bool(spec["environmentTargets"]),
         "deletesProductionData": production,
         "preservesSharedPlatform": True,
-        "preservesUnrelatedPocs": True,
+        "preservesUnrelatedProjects": True,
         "deletesGhcrPackage": False,
         "requiredAuthorization": TEAR_DOWN_WRITE_PHRASE,
         "requiredProductionDataAuthorization": PRODUCTION_DATA_DELETE_PHRASE if production else None,
@@ -111,7 +111,7 @@ def main(argv: list[str] | None = None) -> int:
             and args.production_data_authorization != PRODUCTION_DATA_DELETE_PHRASE
         )
         if missing_general or missing_production:
-            print("POC TEAR-DOWN PREVIEW")
+            print("PROJECT TEAR-DOWN PREVIEW")
             print(render_teardown_summary(preview))
             if missing_general:
                 print(
@@ -126,8 +126,8 @@ def main(argv: list[str] | None = None) -> int:
                 )
             return 2
 
-        result = tear_down_poc(spec)
-        print("POC TEAR-DOWN COMPLETE")
+        result = tear_down_project(spec)
+        print("PROJECT TEAR-DOWN COMPLETE")
         print(render_teardown_summary(result))
         return 0
     except DeploymentKitError as exc:

package/assets/generated/deployment/src/project_forge_deployment/teardown_remote.py

@@ -1,4 +1,4 @@
-"""Remote destructive tear-down for one Kit-managed POC environment."""
+"""Remote destructive tear-down for one Kit-managed Project environment."""
 
 REMOTE_SCRIPT = r'''#!/usr/bin/env bash
 set -Eeuo pipefail
@@ -37,7 +37,7 @@ if [[ ! -e "$ROOT" ]]; then
 fi
 
 [[ -d "$ROOT" && ! -L "$ROOT" ]] || {
-    echo "POC environment root is not a safe managed directory: $ROOT" >&2
+    echo "Project environment root is not a safe managed directory: $ROOT" >&2
     exit 21
 }
 
@@ -46,16 +46,16 @@ HAS_PERSISTENCE=false
 [[ -f "$STATE" && ! -L "$STATE" ]] && HAS_STATE=true
 [[ -f "$PERSISTENCE" && ! -L "$PERSISTENCE" ]] && HAS_PERSISTENCE=true
 [[ "$HAS_STATE" == true || "$HAS_PERSISTENCE" == true ]] || {
-    echo "POC environment root has no managed ownership marker: $ROOT" >&2
+    echo "Project environment root has no managed ownership marker: $ROOT" >&2
     exit 21
 }
 
 if [[ "$HAS_STATE" == true ]] && ! assert_owned_marker "$STATE"; then
-    echo "POC deployment ownership mismatch for $ROOT" >&2
+    echo "Project deployment ownership mismatch for $ROOT" >&2
     exit 22
 fi
 if [[ "$HAS_PERSISTENCE" == true ]] && ! assert_owned_marker "$PERSISTENCE"; then
-    echo "POC persistence ownership mismatch for $ROOT" >&2
+    echo "Project persistence ownership mismatch for $ROOT" >&2
     exit 22
 fi
 
@@ -87,7 +87,7 @@ if [[ "$HAS_STATE" == true ]]; then
     fi
 fi
 
-# The verified environment root is owned by this POC/environment. Tear-down
+# The verified environment root is owned by this Project/environment. Tear-down
 # removes releases, evidence, persistent data, and backups together.
 rm -rf --one-file-system -- "$ROOT"
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mriekki/project-forge",
-  "version": "2.2.0",
+  "version": "3.0.0",
   "description": "Public consumer distribution and updater for Project Forge engineering assets.",
   "type": "module",
   "bin": {