@bendyline/gilde 0.1.37 → 0.1.39

package/data/craftbook-templates/ex/executive-level-review/versions/2.0.4/craftbook.json

@@ -0,0 +1,445 @@
+{
+  "id": "executive-level-review",
+  "name": "Executive-Level Review",
+  "description": "A strategic, executive-level review of a plan or scope: challenge the premise, weigh alternatives, and score each dimension before committing — the 'should we even build this' pass.",
+  "basedOn": {
+    "name": "gstack",
+    "url": "https://github.com/garrytan/gstack"
+  },
+  "plan": "Review the decision, not just the document. Start from the premise, user value, and evidence; compare real alternatives; then test economics, sequencing, reversibility, operational load, and downside. Scores must be anchored to observed facts, with unknowns called out. The final verdict is one of SCOPE EXPANSION, SELECTIVE, HOLD, or SCOPE REDUCTION and includes explicit conditions for changing it.",
+  "entryStepId": "evidence",
+  "triggers": [
+    "think bigger",
+    "expand scope",
+    "strategy review",
+    "rethink this plan"
+  ],
+  "command": "executive-level-review",
+  "steps": [
+    {
+      "id": "evidence",
+      "name": "Build the executive evidence base",
+      "description": "Extract the proposal, intended outcome, proof, assumptions, constraints, and missing decisions.",
+      "prompt": "Read the plan and the workspace material it cites. Restate the decision being requested, target user and outcome, timing, constraints, dependencies, and claimed evidence. Verify cited project facts directly. Separate evidence, inference, and unsupported assumption. Identify the decision owner, irreversible choices, and the cost of waiting. Do not score or recommend yet.\n\nObservable handoff: write the completed result to `{{workPath}}/reviews/executive-evidence.md` in the project's artifacts drawer with `write_artifact`. Do not merely describe what the file would contain. Re-read it with `read_artifact` before finishing this phase and repair any incomplete sections.",
+      "suggestedRole": "strategy analyst",
+      "advanceWhen": {
+        "file": "{{workPath}}/reviews/executive-evidence.md",
+        "minBytes": 800,
+        "sniff": "nonempty",
+        "requireChange": true,
+        "artifact": true,
+        "goto": "challenge"
+      },
+      "gate": {
+        "at": "completion",
+        "checks": [
+          {
+            "kind": "minBytes",
+            "file": "{{workPath}}/reviews/executive-evidence.md",
+            "bytes": 800,
+            "artifact": true
+          },
+          {
+            "kind": "sniff",
+            "file": "{{workPath}}/reviews/executive-evidence.md",
+            "sniff": "nonempty",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "{{workPath}}/reviews/executive-evidence.md",
+            "pattern": "^##\\s+Decision",
+            "flags": "im",
+            "label": "Decision section",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "{{workPath}}/reviews/executive-evidence.md",
+            "pattern": "^##\\s+Evidence",
+            "flags": "im",
+            "label": "Evidence section",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "{{workPath}}/reviews/executive-evidence.md",
+            "pattern": "^##\\s+Assumptions",
+            "flags": "im",
+            "label": "Assumptions section",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "{{workPath}}/reviews/executive-evidence.md",
+            "pattern": "^##\\s+Constraints",
+            "flags": "im",
+            "label": "Constraints section",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "{{workPath}}/reviews/executive-evidence.md",
+            "pattern": "^##\\s+Unknowns",
+            "flags": "im",
+            "label": "Unknowns section",
+            "artifact": true
+          }
+        ],
+        "onReject": "evidence",
+        "maxAttempts": 3
+      },
+      "next": "challenge"
+    },
+    {
+      "id": "challenge",
+      "name": "Challenge the premise and options",
+      "description": "Compare the proposal with materially different ways to reach the outcome.",
+      "prompt": "Use `{{workPath}}/reviews/executive-evidence.md` to test whether the problem deserves action now and whether the proposal is the best vehicle. Develop at least three alternatives, including doing less or waiting. Compare value, confidence, time to learning, opportunity cost, reversibility, operating burden, security or compliance exposure, and failure mode. Identify which choice each key assumption favors and the cheapest evidence that would flip the ranking. Before working, open `{{workPath}}/reviews/executive-evidence.md` with `read_artifact`.\n\nObservable handoff: write the completed result to `{{workPath}}/reviews/executive-options.md` in the project's artifacts drawer with `write_artifact`. Do not merely describe what the file would contain. Re-read it with `read_artifact` before finishing this phase and repair any incomplete sections.",
+      "suggestedRole": "executive strategist",
+      "consumes": [
+        {
+          "file": "{{workPath}}/reviews/executive-evidence.md",
+          "artifact": true
+        }
+      ],
+      "advanceWhen": {
+        "file": "{{workPath}}/reviews/executive-options.md",
+        "minBytes": 1000,
+        "sniff": "nonempty",
+        "requireChange": true,
+        "artifact": true,
+        "goto": "verdict"
+      },
+      "gate": {
+        "at": "completion",
+        "checks": [
+          {
+            "kind": "minBytes",
+            "file": "{{workPath}}/reviews/executive-options.md",
+            "bytes": 1000,
+            "artifact": true
+          },
+          {
+            "kind": "sniff",
+            "file": "{{workPath}}/reviews/executive-options.md",
+            "sniff": "nonempty",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "{{workPath}}/reviews/executive-options.md",
+            "pattern": "^##\\s+Premise test",
+            "flags": "im",
+            "label": "Premise test section",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "{{workPath}}/reviews/executive-options.md",
+            "pattern": "^##\\s+Alternatives",
+            "flags": "im",
+            "label": "Alternatives section",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "{{workPath}}/reviews/executive-options.md",
+            "pattern": "^##\\s+Opportunity cost",
+            "flags": "im",
+            "label": "Opportunity cost section",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "{{workPath}}/reviews/executive-options.md",
+            "pattern": "^##\\s+Failure modes",
+            "flags": "im",
+            "label": "Failure modes section",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "{{workPath}}/reviews/executive-options.md",
+            "pattern": "^##\\s+Decision-changing evidence",
+            "flags": "im",
+            "label": "decision-changing evidence section",
+            "artifact": true
+          }
+        ],
+        "onReject": "challenge",
+        "maxAttempts": 3
+      },
+      "next": "verdict"
+    },
+    {
+      "id": "verdict",
+      "name": "Write the executive review",
+      "description": "Deliver an evidence-anchored scorecard, verdict, and decision conditions.",
+      "prompt": "Write a decision-ready review using the evidence and options files. Score user value, strategic fit, evidence strength, feasibility, sequencing, reversibility, operating cost, and downside from 0 to 10; for each score cite the basis and say what would make it a 10. Choose exactly one mode verdict and explain the two or three decisive reasons. Recommend what to approve now, what to cut or defer, near-term validation, owners, and explicit go, pause, or stop conditions.\n\nObservable handoff: write the completed result to `{{workPath}}/reviews/executive-level-review.md` in the project's artifacts drawer with `write_artifact`. Do not merely describe what the file would contain. Re-read it with `read_artifact` before finishing this phase and repair any incomplete sections.",
+      "suggestedRole": "executive reviewer",
+      "advanceWhen": {
+        "file": "{{workPath}}/reviews/executive-level-review.md",
+        "minBytes": 1400,
+        "sniff": "nonempty",
+        "requireChange": true,
+        "artifact": true,
+        "goto": "evaluate"
+      },
+      "gate": {
+        "at": "completion",
+        "checks": [
+          {
+            "kind": "minBytes",
+            "file": "{{workPath}}/reviews/executive-level-review.md",
+            "bytes": 1400,
+            "artifact": true
+          },
+          {
+            "kind": "sniff",
+            "file": "{{workPath}}/reviews/executive-level-review.md",
+            "sniff": "nonempty",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "{{workPath}}/reviews/executive-level-review.md",
+            "pattern": "^##\\s+Executive verdict",
+            "flags": "im",
+            "label": "Executive verdict section",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "{{workPath}}/reviews/executive-level-review.md",
+            "pattern": "(?:SCOPE EXPANSION|SELECTIVE|HOLD|SCOPE REDUCTION)",
+            "flags": "im",
+            "label": "allowed mode verdict",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "{{workPath}}/reviews/executive-level-review.md",
+            "pattern": "^##\\s+Scorecard",
+            "flags": "im",
+            "label": "Scorecard section",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "{{workPath}}/reviews/executive-level-review.md",
+            "pattern": "^##\\s+Alternatives",
+            "flags": "im",
+            "label": "Alternatives section",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "{{workPath}}/reviews/executive-level-review.md",
+            "pattern": "^##\\s+Recommendation",
+            "flags": "im",
+            "label": "Recommendation section",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "{{workPath}}/reviews/executive-level-review.md",
+            "pattern": "^##\\s+Decision conditions",
+            "flags": "im",
+            "label": "Decision conditions section",
+            "artifact": true
+          }
+        ],
+        "onReject": "verdict",
+        "maxAttempts": 3
+      },
+      "next": "evaluate"
+    },
+    {
+      "id": "evaluate",
+      "name": "Evaluate the deliverable",
+      "description": "Independently grade the observable deliverable and route it to finish, repair, or user escalation.",
+      "prompt": "Review `{{workPath}}/reviews/executive-level-review.md`, `{{workPath}}/reviews/executive-evidence.md`, `{{workPath}}/reviews/executive-options.md` against every criterion below. Inspect the underlying evidence files named by the workflow; do not grade from the author's summary alone.\n\n1. The review tests whether action is warranted, not merely how to execute the supplied plan.\n2. Scores are individually justified by evidence and state what would improve them.\n3. At least three materially different alternatives, including doing less or waiting, are compared.\n4. Opportunity cost, reversibility, operating burden, and credible failure modes influence the recommendation.\n5. The allowed verdict follows from the scorecard and has explicit approval, deferral, and stop conditions.\n6. Unknowns remain visible and no unsupported fact is presented as evidence.\n\nOpen `{{workPath}}/reviews/executive-level-review.md`, `{{workPath}}/reviews/executive-evidence.md`, `{{workPath}}/reviews/executive-options.md` with `read_artifact`. Write the evidence-backed review to `{{workPath}}/reviews/executive-level-review-evaluation.md` in the artifacts drawer with `write_artifact`. Give each criterion a PASS or FAIL with a concrete path, excerpt, measurement, or observed behavior. End with exactly `Verdict: PASS` or `Verdict: REVISE`. Then use `advance_task_step` for the active task: PASS routes to `finish`; REVISE routes to `repair` for review rounds 1 through 2, and the 3th REVISE routes to `needs-user`. Never route to finish while a criterion is unmet.",
+      "suggestedRole": "strategy reviewer",
+      "consumes": [
+        {
+          "file": "{{workPath}}/reviews/executive-level-review.md",
+          "artifact": true
+        },
+        {
+          "file": "{{workPath}}/reviews/executive-evidence.md",
+          "artifact": true
+        },
+        {
+          "file": "{{workPath}}/reviews/executive-options.md",
+          "artifact": true
+        }
+      ],
+      "gate": {
+        "at": "completion",
+        "checks": [
+          {
+            "kind": "minBytes",
+            "file": "{{workPath}}/reviews/executive-level-review-evaluation.md",
+            "bytes": 400,
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "{{workPath}}/reviews/executive-level-review-evaluation.md",
+            "pattern": "Verdict:\\s*(?:PASS|REVISE)",
+            "flags": "i",
+            "label": "explicit PASS or REVISE verdict",
+            "artifact": true
+          }
+        ],
+        "onReject": "evaluate",
+        "maxAttempts": 3
+      },
+      "next": "repair"
+    },
+    {
+      "id": "repair",
+      "name": "Repair the deliverable",
+      "description": "Fix only the concrete gaps from the latest independent review.",
+      "prompt": "Read `{{workPath}}/reviews/executive-level-review-evaluation.md` with `read_artifact` and repair every failed criterion in `{{workPath}}/reviews/executive-level-review.md`, `{{workPath}}/reviews/executive-evidence.md`, `{{workPath}}/reviews/executive-options.md`. Make changes on each file's declared surface (`write_artifact` for artifact inputs, `write_file` for workspace inputs), not in task notes or a reply. Preserve evidence that already passed. Re-run or re-check anything the reviewer found unproven. Ensure `{{workPath}}/reviews/executive-level-review.md` is genuinely updated this turn so the repair is observable, then hand it back for independent evaluation.",
+      "suggestedRole": "executive reviewer",
+      "consumes": [
+        {
+          "file": "{{workPath}}/reviews/executive-level-review-evaluation.md",
+          "artifact": true
+        },
+        {
+          "file": "{{workPath}}/reviews/executive-level-review.md",
+          "artifact": true
+        },
+        {
+          "file": "{{workPath}}/reviews/executive-evidence.md",
+          "artifact": true
+        },
+        {
+          "file": "{{workPath}}/reviews/executive-options.md",
+          "artifact": true
+        }
+      ],
+      "advanceWhen": {
+        "file": "{{workPath}}/reviews/executive-level-review.md",
+        "minBytes": 1400,
+        "sniff": "nonempty",
+        "requireChange": true,
+        "artifact": true,
+        "goto": "evaluate"
+      },
+      "gate": {
+        "at": "completion",
+        "checks": [
+          {
+            "kind": "minBytes",
+            "file": "{{workPath}}/reviews/executive-level-review.md",
+            "bytes": 1400,
+            "artifact": true
+          },
+          {
+            "kind": "sniff",
+            "file": "{{workPath}}/reviews/executive-level-review.md",
+            "sniff": "nonempty",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "{{workPath}}/reviews/executive-level-review.md",
+            "pattern": "^##\\s+Executive verdict",
+            "flags": "im",
+            "label": "Executive verdict section",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "{{workPath}}/reviews/executive-level-review.md",
+            "pattern": "(?:SCOPE EXPANSION|SELECTIVE|HOLD|SCOPE REDUCTION)",
+            "flags": "im",
+            "label": "allowed mode verdict",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "{{workPath}}/reviews/executive-level-review.md",
+            "pattern": "^##\\s+Scorecard",
+            "flags": "im",
+            "label": "Scorecard section",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "{{workPath}}/reviews/executive-level-review.md",
+            "pattern": "^##\\s+Alternatives",
+            "flags": "im",
+            "label": "Alternatives section",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "{{workPath}}/reviews/executive-level-review.md",
+            "pattern": "^##\\s+Recommendation",
+            "flags": "im",
+            "label": "Recommendation section",
+            "artifact": true
+          },
+          {
+            "kind": "contains",
+            "file": "{{workPath}}/reviews/executive-level-review.md",
+            "pattern": "^##\\s+Decision conditions",
+            "flags": "im",
+            "label": "Decision conditions section",
+            "artifact": true
+          }
+        ],
+        "onReject": "repair",
+        "maxAttempts": 3
+      },
+      "next": "evaluate"
+    },
+    {
+      "id": "finish",
+      "name": "Finish",
+      "description": "All deterministic and reviewer criteria passed.",
+      "prompt": "The independent review passed. Read `{{workPath}}/reviews/executive-level-review-evaluation.md` with `read_artifact`, then use `write_task_note` to record a concise DONE summary with the final deliverable paths (`{{workPath}}/reviews/executive-level-review.md`, `{{workPath}}/reviews/executive-evidence.md`, `{{workPath}}/reviews/executive-options.md`) and the evidence that each acceptance criterion passed. Report DONE without starting new work.",
+      "suggestedRole": "project lead",
+      "consumes": [
+        {
+          "file": "{{workPath}}/reviews/executive-level-review-evaluation.md",
+          "artifact": true
+        }
+      ],
+      "terminal": true
+    },
+    {
+      "id": "needs-user",
+      "name": "Escalate unresolved concerns",
+      "description": "The bounded repair loop ended without a defensible pass.",
+      "prompt": "The deliverable did not pass after 3 review rounds. Do not claim success. Read `{{workPath}}/reviews/executive-level-review-evaluation.md` with `read_artifact`, then use `write_task_note` to record DONE_WITH_CONCERNS: the unmet criteria, what was attempted, the affected paths, and the smallest user decision or missing input needed to continue.",
+      "suggestedRole": "project lead",
+      "consumes": [
+        {
+          "file": "{{workPath}}/reviews/executive-level-review-evaluation.md",
+          "artifact": true
+        }
+      ],
+      "terminal": true
+    }
+  ],
+  "version": "2.0.4",
+  "releasedAt": "2026-08-21T00:00:00Z",
+  "paramSchema": {
+    "type": "object",
+    "properties": {
+      "workPath": {
+        "type": "string",
+        "title": "Working folder",
+        "description": "Per-task working folder in the artifacts drawer. Defaults to this task's own folder so runs never collide; override with a stable name when you deliberately want runs to share files.",
+        "default": "{{task.dir}}"
+      }
+    }
+  },
+  "minGezelVersion": "1.26233"
+}

package/data/craftbook-templates/ex/executive-level-review/versions/2.0.4/test.json

@@ -0,0 +1,139 @@
+{
+  "schemaVersion": 1,
+  "title": "Executive-Level Review — analytics expansion decision",
+  "objective": "Test whether the Executive-Level Review craftbook challenges a proposal, compares lower-cost alternatives, and produces an evidence-anchored mode verdict with decision conditions.",
+  "tags": [
+    "workflow",
+    "strategy",
+    "executive-review",
+    "decision"
+  ],
+  "prompt": "Use the Executive-Level Review craftbook to review `source/analytics-proposal.md`. Challenge whether the proposed scope is the best way to reach the outcome; compare at least three alternatives including the two-day manual export and waiting. Produce all craftbook artifacts and a decision-ready `tasks/eval/reviews/executive-level-review.md`. Use exactly one allowed mode verdict, score every required dimension from 0–10 with a factual basis, separate unknowns from evidence, and state explicit approve, pause, and stop conditions. Do not invent customer or financial evidence.",
+  "setup": {
+    "projectName": "Analytics expansion review",
+    "about": "A hermetic executive decision review. The seeded proposal is the complete evidence set.",
+    "missionObjectives": "Decide what, if anything, should be approved now while preserving the fastest credible route to learning.",
+    "files": [
+      {
+        "path": "source/analytics-proposal.md",
+        "content": "# Embedded analytics proposal\n\n## Requested decision\nApprove an eight-week build of customer-facing dashboards with scheduled PDF delivery and CSV export.\n\n## Evidence\nTwelve of 86 active customers requested better reporting in support conversations. Three customers agreed to a design pilot, but none signed a paid commitment. Support currently creates weekly exports for five customers.\n\n## Cost and constraints\n- Estimate: two engineers for 8 weeks.\n- New charting service: $4,000 per month at current volume.\n- Security review is complete; accessibility and data-retention reviews are not.\n- The enterprise renewal decision is in six weeks.\n- A manual scheduled-export workflow can be built in two engineer-days and would test delivery cadence, but not dashboard engagement.\n\n## Unknowns\nWillingness to pay, which metrics matter, PDF accessibility, and whether scheduled delivery or interactive dashboards drives retention.\n"
+      }
+    ],
+    "craftbookParams": {
+      "workPath": "tasks/eval"
+    }
+  },
+  "mocks": [],
+  "success": {
+    "summary": "The named craftbook produces a grounded executive verdict, alternatives, scorecard, and terminal task record.",
+    "deliverables": [
+      {
+        "path": "tasks/eval/reviews/executive-level-review.md",
+        "kind": "markdown-report",
+        "artifact": true,
+        "minBytes": 1400,
+        "checks": [
+          {
+            "kind": "contains",
+            "file": "tasks/eval/reviews/executive-level-review.md",
+            "pattern": "^#{1,3}\\s+Executive verdict\\b[\\s\\S]*(SCOPE EXPANSION|SELECTIVE|HOLD|SCOPE REDUCTION)[\\s\\S]*^#{1,3}\\s+Scorecard\\b[\\s\\S]*^#{1,3}\\s+Alternatives\\b[\\s\\S]*^#{1,3}\\s+Recommendation\\b[\\s\\S]*^#{1,3}\\s+Decision conditions\\b",
+            "flags": "im",
+            "label": "verdict, scorecard, alternatives, recommendation, and conditions"
+          },
+          {
+            "kind": "contains",
+            "file": "tasks/eval/reviews/executive-level-review.md",
+            "pattern": "(user value).*?(strategic fit).*?(evidence strength).*?(feasibility).*?(sequencing).*?(reversibility).*?(operating cost).*?(downside)",
+            "flags": "is",
+            "label": "complete executive scorecard"
+          },
+          {
+            "kind": "valueGrounding",
+            "file": "tasks/eval/reviews/executive-level-review.md",
+            "facts": [
+              {
+                "id": "customer-requests",
+                "required": [
+                  "12\\s+(?:of\\s+86\\s+)?(?:active\\s+)?customers"
+                ]
+              },
+              {
+                "id": "pilot-evidence",
+                "required": [
+                  "3\\s+customers?[^.]{0,60}(pilot|agreed)"
+                ]
+              },
+              {
+                "id": "build-duration",
+                "required": [
+                  "8\\s+weeks?"
+                ]
+              },
+              {
+                "id": "operating-cost",
+                "required": [
+                  "\\$4,?000\\s+per\\s+month"
+                ]
+              },
+              {
+                "id": "cheap-alternative",
+                "required": [
+                  "(two|2)[ -]?(engineer[- ])?days?[\\s\\S]{0,120}(manual|scheduled)[ -]export"
+                ]
+              }
+            ]
+          },
+          {
+            "kind": "citationsResolve",
+            "file": "tasks/eval/reviews/executive-level-review.md",
+            "minCitations": 1
+          }
+        ]
+      }
+    ],
+    "taskNotes": {
+      "minBytes": 160,
+      "checks": [
+        {
+          "kind": "contains",
+          "file": "task-notes.md",
+          "pattern": "\\bDONE\\b[\\s\\S]*tasks/eval/reviews/executive-level-review\\.md",
+          "label": "terminal craftbook note names the review"
+        }
+      ],
+      "requireCraftbookTask": true
+    },
+    "taskGraph": {
+      "requireCraftbookTask": true,
+      "requireTerminalStep": true
+    },
+    "unchangedFixtures": [
+      "source/analytics-proposal.md"
+    ]
+  },
+  "rubric": {
+    "artifact": {
+      "path": "tasks/eval/reviews/executive-level-review.md",
+      "kind": "markdown"
+    },
+    "axes": [
+      {
+        "name": "Premise challenge",
+        "description": "The review tests whether action is warranted now and compares materially different ways to learn or deliver value."
+      },
+      {
+        "name": "Evidence discipline",
+        "description": "Scores and conclusions trace to supplied facts, with unsupported assumptions and missing decisions called out."
+      },
+      {
+        "name": "Executive usefulness",
+        "description": "The verdict is decisive, sequenced, reversible where possible, and paired with clear decision-changing conditions."
+      }
+    ]
+  },
+  "qualityFocus": [
+    "One allowed mode verdict is selected",
+    "All scorecard dimensions have evidence-backed scores",
+    "The two-day alternative and missing willingness-to-pay evidence influence the decision"
+  ]
+}