Merge branch 'main' into dependabot/github_actions/actions/setup-python-6.2.0

Author: MariusStorhaug

.github/workflows/Docs.yml

@@ -45,9 +45,9 @@ jobs:
       - name: Build Zensical project
         run: zensical build --clean
 
-      - uses: actions/upload-pages-artifact@7b1f4a764d45c48632c6b24a0339c27f5614fb0b # v4.0.0
+      - uses: actions/upload-pages-artifact@fc324d3547104276b827a68afc52ff2a11cc49c9 # v5.0.0
         with:
           path: site
 
-      - uses: actions/deploy-pages@d6db90164ac5ed86f2b6aed7e0febac5b3c0c03e # v4.0.5
+      - uses: actions/deploy-pages@cd2ce8fcbc39b97be8ca5fce6e763baed58fa128 # v5.0.0
         id: deployment

docs/Agents/Principles.md

@@ -35,6 +35,14 @@ A good OKR is one that anyone — contributor, user, or agent — can read and i
 
 We are building something for people who should **want** to use it. Without users, we are nothing. Every decision is filtered through: does this make the product more wanted, or less?
 
+## Build for all developers
+
+We target all platforms and all shells. Our code, scripts, workflows, and documentation must work regardless of whether the developer is on Windows, macOS, or Linux. Line endings, path separators, shell assumptions — none of these should silently break someone's experience. Repository configuration (`.gitattributes`, CI matrices, test environments) must reflect this.
+
+## Build for the modern engineer
+
+We build for engineers using the latest tools and platforms. We do not support deprecated or end-of-life software. Concretely: we target **PowerShell** (cross-platform, actively developed) — not Windows PowerShell (legacy, frozen at 5.1). The same applies across the stack: latest stable releases, current LTS versions, modern APIs. If a tool has a successor, use the successor.
+
 ## Dogfooding
 
 Be the first customer of every service we build. But avoid full self-dependency on a service before it is proven — explore and use it in non-critical contexts first, then promote it as confidence grows.

docs/Agents/index.md

@@ -24,11 +24,11 @@ This matters because:
 
 Each role is a focused agent. Standards are referenced, not embedded.
 
-| Role        | Phase            | Purpose                                                                 |
-| ----------- | ---------------- | ----------------------------------------------------------------------- |
+| Role        | Phase                   | Purpose                                                                 |
+| ----------- | ----------------------- | ----------------------------------------------------------------------- |
 | Define      | Capture + Refine + Plan | Capture a desire, ground it, and produce a planned issue or sub-issues. |
 | Implement   | Build + Ship + Respond  | Branch, draft PR, code, micro-commit, track progress, finalize PR.      |
-| Reviewer    | Review           | Review someone else's PR for delivery, taste, and security.             |
+| Reviewer    | Review                  | Review someone else's PR for delivery, taste, and security.             |
 
 ## What lives here