@kontourai/flow-agents 1.1.0 → 1.3.0

package/kits/builder/flows/build.flow.json

@@ -19,12 +19,12 @@
       "expects": [
         {
           "id": "selected-work",
-          "kind": "surface.claim",
+          "kind": "trust.bundle",
           "required": true,
           "description": "A ready work item is selected with scope and acceptance context.",
-          "claim": {
-            "type": "builder.pull-work.selected",
-            "subject": "work-item",
+          "bundle_claim": {
+            "claimType": "builder.pull-work.selected",
+            "subjectType": "work-item",
             "accepted_statuses": ["trusted", "accepted"]
           }
         }
@@ -35,23 +35,23 @@
       "expects": [
         {
           "id": "pickup-probe-readiness",
-          "kind": "surface.claim",
+          "kind": "trust.bundle",
           "required": true,
           "description": "Pickup Probe evidence is recorded before planning: goal fit and scope, blockers and dependencies, dependency freshness, acceptance criteria quality, provider state, risk, stop-short risks, planning readiness, decisions, unresolved questions, accepted gaps, probe_status, probe_artifact_ref, grouping decision, expected modified files, and conflict risks.",
-          "claim": {
-            "type": "builder.design-probe.pickup-readiness",
-            "subject": "work-item",
+          "bundle_claim": {
+            "claimType": "builder.design-probe.pickup-readiness",
+            "subjectType": "work-item",
             "accepted_statuses": ["trusted", "accepted"]
           }
         },
         {
           "id": "probe-decisions-or-accepted-gaps",
-          "kind": "surface.claim",
+          "kind": "trust.bundle",
           "required": true,
           "description": "Planning is blocked until pickup Probe decisions are captured in the pull-work or plan handoff artifact, or unresolved questions are explicitly recorded as accepted gaps. Stale broad continuation language after a merge is not sufficient for planning newly selected work.",
-          "claim": {
-            "type": "builder.design-probe.decisions",
-            "subject": "decision",
+          "bundle_claim": {
+            "claimType": "builder.design-probe.decisions",
+            "subjectType": "decision",
             "accepted_statuses": ["trusted", "accepted"]
           }
         }
@@ -62,12 +62,12 @@
       "expects": [
         {
           "id": "implementation-plan",
-          "kind": "surface.claim",
+          "kind": "trust.bundle",
           "required": true,
           "description": "The implementation plan names files, changes, acceptance evidence, and sequencing.",
-          "claim": {
-            "type": "builder.plan.implementation",
-            "subject": "artifact",
+          "bundle_claim": {
+            "claimType": "builder.plan.implementation",
+            "subjectType": "artifact",
             "accepted_statuses": ["trusted", "accepted"]
           }
         }
@@ -78,12 +78,12 @@
       "expects": [
         {
           "id": "implementation-scope",
-          "kind": "surface.claim",
+          "kind": "trust.bundle",
           "required": true,
           "description": "The implementation scope records changed files and excludes unrelated work.",
-          "claim": {
-            "type": "builder.execute.scope",
-            "subject": "change",
+          "bundle_claim": {
+            "claimType": "builder.execute.scope",
+            "subjectType": "change",
             "accepted_statuses": ["trusted", "accepted"]
           }
         }
@@ -105,24 +105,24 @@
       "expects": [
         {
           "id": "tests-evidence",
-          "kind": "surface.claim",
+          "kind": "trust.bundle",
           "required": true,
           "description": "Relevant tests or checks have evidence tied to the implemented change.",
-          "claim": {
-            "type": "builder.verify.tests",
-            "subject": "flow-step",
+          "bundle_claim": {
+            "claimType": "builder.verify.tests",
+            "subjectType": "flow-step",
             "accepted_statuses": ["trusted", "accepted"]
           }
         },
         {
           "id": "policy-compliance",
-          "kind": "surface.claim",
+          "kind": "trust.bundle",
           "required": false,
           "description": "Policy compliance evidence is attached when policy gates apply.",
           "explore_hint": "Use as advisory evidence for scope, security, privacy, release, or repository policy checks.",
-          "claim": {
-            "type": "builder.verify.policy-compliance",
-            "subject": "artifact",
+          "bundle_claim": {
+            "claimType": "builder.verify.policy-compliance",
+            "subjectType": "artifact",
             "accepted_statuses": ["trusted", "accepted", "advisory"]
           }
         }
@@ -144,12 +144,12 @@
       "expects": [
         {
           "id": "merge-readiness",
-          "kind": "surface.claim",
+          "kind": "trust.bundle",
           "required": true,
           "description": "The change is ready for merge review based on scope, evidence, and unresolved risks.",
-          "claim": {
-            "type": "builder.merge-ready.readiness",
-            "subject": "change",
+          "bundle_claim": {
+            "claimType": "builder.merge-ready.readiness",
+            "subjectType": "change",
             "accepted_statuses": ["trusted", "accepted"]
           }
         }
@@ -160,12 +160,12 @@
       "expects": [
         {
           "id": "pull-request-opened",
-          "kind": "surface.claim",
+          "kind": "trust.bundle",
           "required": true,
           "description": "A pull request exists with linked work, implementation summary, and verification evidence.",
-          "claim": {
-            "type": "builder.pr-open.pull-request",
-            "subject": "pull-request",
+          "bundle_claim": {
+            "claimType": "builder.pr-open.pull-request",
+            "subjectType": "pull-request",
             "accepted_statuses": ["trusted", "accepted"]
           }
         }
@@ -176,12 +176,12 @@
       "expects": [
         {
           "id": "ci-merge-readiness",
-          "kind": "surface.claim",
+          "kind": "trust.bundle",
           "required": true,
           "description": "CI and review status support a merge-ready decision.",
-          "claim": {
-            "type": "builder.merge-ready-ci.readiness",
-            "subject": "pull-request",
+          "bundle_claim": {
+            "claimType": "builder.merge-ready-ci.readiness",
+            "subjectType": "pull-request",
             "accepted_statuses": ["trusted", "accepted"]
           }
         }
@@ -192,23 +192,23 @@
       "expects": [
         {
           "id": "decision-evidence",
-          "kind": "surface.claim",
+          "kind": "trust.bundle",
           "required": true,
           "description": "Durable decision evidence from the build is recorded.",
-          "claim": {
-            "type": "builder.learn.decisions",
-            "subject": "decision",
+          "bundle_claim": {
+            "claimType": "builder.learn.decisions",
+            "subjectType": "decision",
             "accepted_statuses": ["trusted", "accepted"]
           }
         },
         {
           "id": "learning-evidence",
-          "kind": "surface.claim",
+          "kind": "trust.bundle",
           "required": true,
           "description": "Learning evidence from delivery is recorded for future work.",
-          "claim": {
-            "type": "builder.learn.evidence",
-            "subject": "release",
+          "bundle_claim": {
+            "claimType": "builder.learn.evidence",
+            "subjectType": "release",
             "accepted_statuses": ["trusted", "accepted"]
           }
         }

package/kits/builder/flows/shape.flow.json

@@ -13,79 +13,79 @@
       "expects": [
         {
           "id": "shaped-problem",
-          "kind": "surface.claim",
+          "kind": "trust.bundle",
           "required": true,
           "description": "The problem is stated in terms a builder can act on.",
-          "claim": {
-            "type": "builder.shape.problem",
-            "subject": "decision",
+          "bundle_claim": {
+            "claimType": "builder.shape.problem",
+            "subjectType": "decision",
             "accepted_statuses": ["trusted", "accepted"]
           }
         },
         {
           "id": "shaped-outcome",
-          "kind": "surface.claim",
+          "kind": "trust.bundle",
           "required": true,
           "description": "The intended outcome is explicit enough to evaluate later.",
-          "claim": {
-            "type": "builder.shape.outcome",
-            "subject": "flow-run",
+          "bundle_claim": {
+            "claimType": "builder.shape.outcome",
+            "subjectType": "flow-run",
             "accepted_statuses": ["trusted", "accepted"]
           }
         },
         {
           "id": "shaped-constraints",
-          "kind": "surface.claim",
+          "kind": "trust.bundle",
           "required": true,
           "description": "Constraints that affect implementation are captured.",
-          "claim": {
-            "type": "builder.shape.constraints",
-            "subject": "decision",
+          "bundle_claim": {
+            "claimType": "builder.shape.constraints",
+            "subjectType": "decision",
             "accepted_statuses": ["trusted", "accepted"]
           }
         },
         {
           "id": "shaped-non-goals",
-          "kind": "surface.claim",
+          "kind": "trust.bundle",
           "required": true,
           "description": "Non-goals are named so the build stays scoped.",
-          "claim": {
-            "type": "builder.shape.non-goals",
-            "subject": "decision",
+          "bundle_claim": {
+            "claimType": "builder.shape.non-goals",
+            "subjectType": "decision",
             "accepted_statuses": ["trusted", "accepted"]
           }
         },
         {
           "id": "shaped-success",
-          "kind": "surface.claim",
+          "kind": "trust.bundle",
           "required": true,
           "description": "Success criteria are concrete enough for verification.",
-          "claim": {
-            "type": "builder.shape.success",
-            "subject": "artifact",
+          "bundle_claim": {
+            "claimType": "builder.shape.success",
+            "subjectType": "artifact",
             "accepted_statuses": ["trusted", "accepted"]
           }
         },
         {
           "id": "shaped-risk",
-          "kind": "surface.claim",
+          "kind": "trust.bundle",
           "required": true,
           "description": "Material delivery risks are recorded before breakdown.",
-          "claim": {
-            "type": "builder.shape.risk",
-            "subject": "decision",
+          "bundle_claim": {
+            "claimType": "builder.shape.risk",
+            "subjectType": "decision",
             "accepted_statuses": ["trusted", "accepted"]
           }
         },
         {
           "id": "open-decisions",
-          "kind": "surface.claim",
+          "kind": "trust.bundle",
           "required": false,
           "description": "Open decisions are recorded when the shape is not fully settled.",
           "explore_hint": "Attach when unresolved choices could affect slices or issue boundaries.",
-          "claim": {
-            "type": "builder.shape.open-decisions",
-            "subject": "decision",
+          "bundle_claim": {
+            "claimType": "builder.shape.open-decisions",
+            "subjectType": "decision",
             "accepted_statuses": ["trusted", "accepted", "advisory"]
           }
         }
@@ -96,12 +96,12 @@
       "expects": [
         {
           "id": "slices-defined",
-          "kind": "surface.claim",
+          "kind": "trust.bundle",
           "required": true,
           "description": "The shaped work is split into independently useful slices.",
-          "claim": {
-            "type": "builder.breakdown.slices",
-            "subject": "work-item",
+          "bundle_claim": {
+            "claimType": "builder.breakdown.slices",
+            "subjectType": "work-item",
             "accepted_statuses": ["trusted", "accepted"]
           }
         }
@@ -112,12 +112,12 @@
       "expects": [
         {
           "id": "work-items-filed",
-          "kind": "surface.claim",
+          "kind": "trust.bundle",
           "required": true,
           "description": "Work items are filed or otherwise recorded with enough context to pull later.",
-          "claim": {
-            "type": "builder.file-issues.work-items",
-            "subject": "work-item",
+          "bundle_claim": {
+            "claimType": "builder.file-issues.work-items",
+            "subjectType": "work-item",
             "accepted_statuses": ["trusted", "accepted"]
           }
         }

package/kits/builder/kit.json

@@ -15,5 +15,22 @@
       "path": "flows/build.flow.json",
       "description": "Pull ready work through design probing, planning, implementation, verification, pull request readiness, merge readiness, and learning."
     }
+  ],
+  "skills": [
+    { "id": "builder.builder-shape", "path": "skills/builder-shape/SKILL.md", "description": "Invoke Builder Kit shape from a raw idea or the current conversation context." },
+    { "id": "builder.deliver", "path": "skills/deliver/SKILL.md", "description": "Delivery workflow — selected work to delivered code." },
+    { "id": "builder.design-probe", "path": "skills/design-probe/SKILL.md", "description": "One-question-at-a-time design probing interview." },
+    { "id": "builder.evidence-gate", "path": "skills/evidence-gate/SKILL.md", "description": "Evaluate whether completed work is trustworthy enough for human review, merge, or release." },
+    { "id": "builder.execute-plan", "path": "skills/execute-plan/SKILL.md", "description": "Parallel execution primitive — plan artifact path to implemented code." },
+    { "id": "builder.fix-bug", "path": "skills/fix-bug/SKILL.md", "description": "Bug fix orchestrator — diagnose, plan, execute, review, verify, loop." },
+    { "id": "builder.idea-to-backlog", "path": "skills/idea-to-backlog/SKILL.md", "description": "Turn raw ideas into shaped, prioritized, executable GitHub issue backlog." },
+    { "id": "builder.learning-review", "path": "skills/learning-review/SKILL.md", "description": "Capture post-merge learnings and feed them back into backlog, skills, tests, or knowledge." },
+    { "id": "builder.pickup-probe", "path": "skills/pickup-probe/SKILL.md", "description": "Builder Kit work-item/docs/provider-grounded Probe specialization before plan-work." },
+    { "id": "builder.plan-work", "path": "skills/plan-work/SKILL.md", "description": "Code planning primitive — goal + directory to structured execution plan." },
+    { "id": "builder.pull-work", "path": "skills/pull-work/SKILL.md", "description": "Select ready GitHub issues from the executable backlog for implementation." },
+    { "id": "builder.release-readiness", "path": "skills/release-readiness/SKILL.md", "description": "Decide whether evidence-backed work is ready to merge, release, deploy, or hold." },
+    { "id": "builder.review-work", "path": "skills/review-work/SKILL.md", "description": "Review primitive — code, security, dependency, architecture critique before verification." },
+    { "id": "builder.tdd-workflow", "path": "skills/tdd-workflow/SKILL.md", "description": "Test-driven development — RED, GREEN, REFACTOR with git checkpoints." },
+    { "id": "builder.verify-work", "path": "skills/verify-work/SKILL.md", "description": "Verification primitive — session file path to structured evidence verdict." }
   ]
 }

package/{skills → kits/builder/skills}/builder-shape/SKILL.md

@@ -11,7 +11,7 @@ Invoke the Builder Kit `shape` flow for raw product ideas, vague build goals, cu
 
 - Product surface: let the user ask for "Builder Kit shape", "builder shape", or "shape this with Builder Kit" without naming `idea-to-backlog`.
 - Proactive suggestion: when a user starts planning a feature, product, PRD, roadmap item, or vague build idea without naming a workflow, briefly suggest Builder Kit shape as the structured path before implementation. Phrase it as an option, not a forced gate, unless the request is too ambiguous to plan responsibly.
-- Delegation: use `skills/idea-to-backlog/SKILL.md` as the shaping primitive. Do not duplicate or replace its workflow, artifact contract, issue shape, or gate rules.
+- Delegation: use `kits/builder/skills/idea-to-backlog/SKILL.md` as the shaping primitive. Do not duplicate or replace its workflow, artifact contract, issue shape, or gate rules.
 - Product-level auto-guidance: when the user invokes Builder Kit shape, guide them through `design-probe` alignment and then the `idea-to-backlog` workflow directly; do not require them to type `design-probe` or `idea-to-backlog` as additional skill names.
 - do not require them to type `idea-to-backlog`; Builder Kit shape owns the user-facing route into that primitive.
 - Flow reference: link every Builder Kit shape artifact to the Builder Kit Flow Definition at `kits/builder/flows/shape.flow.json`.
@@ -19,7 +19,7 @@ Invoke the Builder Kit `shape` flow for raw product ideas, vague build goals, cu
 - Probe/alignment: when the idea, user outcome, constraints, non-goals, success signal, risk, or bundle relationship is unclear, run `design-probe` style alignment before continuing.
 - Default stop: stop at the backlog gate by default. Do not create GitHub issues, sync to a project, or hand off to `pull-work` unless the user explicitly asks for that next step.
 - Boundary: do not run Builder Kit build execution, remote kit install, package extraction, downstream delivery workflows, `plan-work`, `execute-plan`, `review-work`, `verify-work`, `evidence-gate`, or release workflows from this invocation.
-- Compatibility: Direct `idea-to-backlog` usage remains valid and should behave exactly as described in `skills/idea-to-backlog/SKILL.md`.
+- Compatibility: Direct `idea-to-backlog` usage remains valid and should behave exactly as described in `kits/builder/skills/idea-to-backlog/SKILL.md`.
 - Primitive recovery: if a user invokes `idea-to-backlog` or another primitive with missing shaping context and appears to want the product flow, explain that Builder Kit shape is the entry point and offer to route there.
 
 ## Invocation
@@ -33,7 +33,7 @@ Use this skill when the user says things like:
 
 When activated:
 
-1. Read `skills/idea-to-backlog/SKILL.md`.
+1. Read `kits/builder/skills/idea-to-backlog/SKILL.md`.
 2. State that Builder Kit shape delegates to `idea-to-backlog` and uses `kits/builder/flows/shape.flow.json`.
 3. Gather the raw idea or current conversation context.
 4. If needed, use `design-probe`: ask one Probe/alignment question at a time before shaping. Prefer questions that clarify user outcome, constraints, non-goals, success criteria, risk, or whether bundled ideas truly belong together.
@@ -72,5 +72,5 @@ For Builder Kit shape invocations, also include:
 Issue sync is explicit-only.
 
 - If the user did not ask to create or sync issues, set `backlog_links` to `not_requested` or an empty recorded status and stop at the backlog gate.
-- If the user asks to create or sync issues, follow the GitHub issue rules in `skills/idea-to-backlog/SKILL.md`.
+- If the user asks to create or sync issues, follow the GitHub issue rules in `kits/builder/skills/idea-to-backlog/SKILL.md`.
 - If provider details are missing, ask for them instead of assuming a GitHub repository, project, labels, milestone, or assignee.

package/{skills → kits/builder/skills}/idea-to-backlog/SKILL.md

@@ -217,7 +217,7 @@ Provider-neutral marker example:
       "planned_at": "2026-06-03T03:23:14Z",
       "planning_artifact_ref": ".flow-agents/example/example--idea-to-backlog.md",
       "planning_scope_refs": [
-        "skills/idea-to-backlog/SKILL.md",
+        "kits/builder/skills/idea-to-backlog/SKILL.md",
         "context/contracts/work-item-contract.md"
       ]
     }