forge-orkes 0.44.0 → 0.49.0

package/template/.forge/templates/plan.md

@@ -29,8 +29,29 @@ must_haves:
   truths:                            # USER-observable when plan is done. Must contain a user verb
                                      # (see, click, submit, receive, view, download, error, redirect).
                                      # Internal-only truths like "Schema applied" do NOT satisfy.
+                                     # Entry form: bare string (legacy — remains valid, no migration)
+                                     # OR object with an OPTIONAL executable check:
     - ""                             # e.g., "User submits signup form and lands on dashboard"
-    - ""                             # e.g., "Invalid email shows inline 'must be a valid email' error"
+    - truth: ""                      # e.g., "Invalid email shows inline 'must be a valid email' error"
+      check: ""                      # OPTIONAL shell command proving the truth. Semantics:
+                                     #  - exit 0 = pass; anything else = fail. The exit code, not
+                                     #    agent judgment, is the verdict (executed-evidence rule).
+                                     #  - must PRINT WHY it fails — its output feeds executing's
+                                     #    auto-fix loop and the verification report (`diff` beats
+                                     #    `diff -q`; an assert-with-message beats a bare `test`).
+                                     #  - verify content/behavior, not existence (`test -f` proves
+                                     #    existence only).
+                                     #  - safe to run repeatedly — read-only, or idempotent against
+                                     #    durable state (checks run in executing AND verifying,
+                                     #    plus auto-fix retries).
+                                     #  - authored at planning time, goal-backward, BEFORE code
+                                     #    exists — a pre-code check can't be retro-fitted to what
+                                     #    got built.
+    - truth: ""                      # A truth that can't be a command (visual, real-device,
+      manual: ""                     # external service) carries a `manual:` route INSTEAD of a
+                                     # check — e.g. "human gate" or "M9 e2e" — never a fake check.
+                                     # executing skips manual truths (no check to run); verifying
+                                     # routes them to HUMAN VERIFICATION NEEDED.
   artifacts:                         # Files that must exist and be substantive (not stubs).
                                      # Slice plans typically span 2-4 layers — paths should cross
                                      # boundaries (component + handler + repo), not cluster in one dir.
@@ -50,6 +71,19 @@ must_haves:
 
 <task type="auto">
   <name>Action-oriented task name</name>
+  <complexity>standard</complexity>       <!-- OPTIONAL (M24). complexity is trivial | standard | complex.
+                                                Routing signal → resolves a model via project.yml
+                                                models.by_complexity (see FORGE.md Model Routing).
+                                                trivial = config/docs/mechanical; standard = ordinary
+                                                feature/fix; complex = cross-layer behavior, tricky logic,
+                                                high blast radius. OMIT the field → the task falls back to
+                                                skill-level model routing, exactly as pre-M24 plans did.
+                                                No migration: a task with neither field parses unchanged. -->
+  <task_type>code-feature</task_type>      <!-- OPTIONAL (M24). code-feature | code-fix | docs | research |
+                                                config | test. The promotion-ladder BUCKET key — phases
+                                                37-38 learn "model X is proven on task_type Y". Free choice
+                                                from this controlled vocabulary; pick the dominant kind.
+                                                OMIT → task is not bucketed; no effect on legacy plans. -->
   <files>
     - src/path/to/file.tsx (create)
     - src/path/to/other.ts (modify)

package/template/.forge/templates/project.yml

@@ -90,6 +90,10 @@ models:
     securing: sonnet                   # Security analysis needs depth
     debugging: sonnet                  # Investigation needs solid reasoning
     discussing: sonnet                 # Conversation needs natural fluency
+  # by_complexity:                     # Per-task complexity -> model (M24). Overrides skills.X — see FORGE.md Model Routing Precedence.
+  #   trivial: haiku
+  #   standard: sonnet
+  #   complex: opus
 
 orchestration:                       # M10 multi-agent orchestration (experimental). Only consulted when M10 is installed.
   # auto: true                         # false = never auto-route Standard/Full through orchestrating (install = consent; set false to opt out).

package/template/.forge/templates/prototypes/prototype.md

@@ -0,0 +1,31 @@
+---
+slug: "{kebab-slug}"
+title: "{short human title}"
+created: "{ISO date}"
+status: exploring          # exploring | parked | graduated | discarded
+flag: "{how it's gated — e.g. alpha, ?alpha=1, feature:foo, settings.alphaMockups}"
+goal: "{one line — what are we trying to see before building it for real?}"
+# --- set on resolve ---
+# graduated_to: m-{id}     # when status: graduated
+# resolved: "{ISO date}"   # when graduated or discarded
+# discard_reason: "..."    # when status: discarded
+# parked: "{ISO date}"     # when status: parked
+# unpark_when: "..."       # when status: parked — what would bring this back
+---
+
+# Prototype: {title}
+
+Disposable in-app mockup, gated behind `{flag}`. Not production work — see `.claude/skills/prototyping/SKILL.md`.
+
+## Open question
+
+{The thing this iteration round is trying to answer / react to right now. Rewrite as it evolves.}
+
+## Iterations
+
+<!-- One terse line per pass. This is the loop's memory across /clear — keep it scannable, not a design doc. -->
+- {ISO date} — {what this iteration tried, and what to look at}
+
+## Notes
+
+{Optional: decisions leaning one way, dead ends, things to remember if this graduates.}