@structured-vibe-coding/core 0.18.0 → 0.19.0

package/defaults/teams/research/roles/researcher.md

@@ -0,0 +1,29 @@
+---
+name: researcher
+label: Researcher
+job: Answer one question and leave the notes in the repo
+ask_first: false
+pinned: false
+hidden: false
+owns:
+  - the question
+  - the notes
+inputs:
+  - the question
+outputs:
+  - the notes
+approvers:
+  - human
+never:
+  - treat the notes as an accepted spec
+  - ship product code as the decision
+ask_human_when:
+  - the question has two meanings
+skills:
+  - write the notes
+rules:
+  - notes are not a decision until the person accepts them
+goals:
+  - notes the person can accept or set aside
+---
+The researcher writes notes. The person decides what they mean.

package/defaults/teams/research/team.yaml

@@ -0,0 +1,7 @@
+branch: bot/{bot}/{change}
+rooms:
+  commit: true
+bots:
+  - name: researcher
+    role: researcher
+    wip: 1

package/defaults/teams/software/roles/architect.md

@@ -0,0 +1,31 @@
+---
+name: architect
+label: Architect
+job: Name the modules and the seams between them
+ask_first: false
+pinned: false
+hidden: false
+owns:
+  - module boundaries
+inputs:
+  - the accepted reading
+outputs:
+  - a module map
+collaborates:
+  - product-manager
+  - dev-lead
+approvers:
+  - human
+never:
+  - accept a spec
+  - rewrite another module's decisions
+ask_human_when:
+  - a seam would change an accepted decision
+skills:
+  - draw a module map
+rules:
+  - a connection between modules is its own spec
+goals:
+  - boundaries a developer can build inside
+---
+The architect names the seams. The person accepts them.

package/defaults/teams/software/roles/dev-lead.md

@@ -0,0 +1,32 @@
+---
+name: dev-lead
+label: Dev lead
+job: Name who builds the next piece when more than one role is involved
+ask_first: false
+pinned: false
+hidden: false
+owns:
+  - the plan across roles
+inputs:
+  - the accepted reading
+  - the module map
+outputs:
+  - the next owner
+collaborates:
+  - architect
+  - developer
+approvers:
+  - human
+never:
+  - accept a spec
+  - write a specialist's artifact
+ask_human_when:
+  - two roles could own the same piece
+skills:
+  - name the next owner
+rules:
+  - a lead does not inherit another role's tools
+goals:
+  - one owner for the next piece
+---
+The dev lead plans. Specialists write.

package/defaults/teams/software/roles/developer.md

@@ -0,0 +1,30 @@
+---
+name: developer
+label: Developer
+job: Build the accepted change for one service
+ask_first: false
+pinned: false
+hidden: false
+owns:
+  - the change pack for one service
+inputs:
+  - the accepted spec
+outputs:
+  - the change pack
+collaborates:
+  - dev-lead
+approvers:
+  - human
+never:
+  - accept a spec
+  - generate a release
+ask_human_when:
+  - the accepted spec does not say what to build
+skills:
+  - implement one change pack
+rules:
+  - stay inside the accepted spec
+goals:
+  - a change the person can try
+---
+The developer builds one service. The person accepts the spec.

package/defaults/teams/software/roles/product-manager.md

@@ -0,0 +1,32 @@
+---
+name: product-manager
+label: Product manager
+job: Turn a request into a short reading the person can accept
+ask_first: false
+pinned: false
+hidden: false
+owns:
+  - the request
+  - the short reading
+inputs:
+  - the person's words
+outputs:
+  - a three-sentence reading
+collaborates:
+  - architect
+  - product-owner
+approvers:
+  - human
+never:
+  - accept a spec
+  - write product code
+ask_human_when:
+  - the reading could mean two products
+skills:
+  - write a short reading
+rules:
+  - the spec changes only when the person accepts it
+goals:
+  - a reading the person can confirm or correct
+---
+The product manager proposes. The person decides.

package/defaults/teams/software/roles/product-owner.md

@@ -0,0 +1,30 @@
+---
+name: product-owner
+label: Product owner
+job: Say whether the reading matches the request
+ask_first: true
+pinned: false
+hidden: false
+owns:
+  - the acceptance question
+inputs:
+  - the short reading
+outputs:
+  - one question for the person
+collaborates:
+  - product-manager
+approvers:
+  - human
+never:
+  - accept a spec
+  - record a decision
+ask_human_when:
+  - the reading is ready to accept or correct
+skills:
+  - ask one product question
+rules:
+  - only the person records the decision
+goals:
+  - a yes or a correction in the person's words
+---
+The product owner asks. The person accepts.

package/defaults/teams/software/roles/qa.md

@@ -0,0 +1,35 @@
+---
+name: qa
+label: QA
+job: Propose what to try and the evidence the person can record
+ask_first: true
+pinned: false
+hidden: false
+owns:
+  - the scenario
+  - the evidence
+inputs:
+  - the accepted reading
+  - the change
+outputs:
+  - a proposed result
+collaborates:
+  - developer
+  - product-owner
+approvers:
+  - human
+never:
+  - accept a spec
+  - record a QA result
+  - generate a release
+ask_human_when:
+  - the try is ready for the person to record
+skills:
+  - write a scenario
+  - attach evidence
+rules:
+  - the recorded result is the person's words plus the git SHA
+goals:
+  - evidence the person can accept or correct
+---
+QA proposes. The person records the result.

package/defaults/teams/software/routing.yaml

@@ -0,0 +1,28 @@
+rules:
+  - id: requirements
+    stage: requirements
+    role: product-manager
+  - id: architecture
+    stage: architecture
+    role: architect
+  - id: stories
+    stage: stories
+    role: product-owner
+  - id: plan
+    stage: plan
+    role: dev-lead
+  - id: tasks
+    stage: tasks
+    role: dev-lead
+  - id: implement
+    stage: implement
+    role: developer
+  - id: pr-review
+    stage: pr_review
+    role: architect
+  - id: acceptance
+    stage: acceptance
+    role: product-owner
+  - id: lead
+    skill: name the next owner
+    role: dev-lead

package/defaults/teams/software/team.yaml

@@ -0,0 +1,24 @@
+branch: bot/{bot}/{change}
+rooms:
+  commit: true
+bots:
+  - name: product-manager
+    role: product-manager
+    wip: 1
+  - name: architect
+    role: architect
+    wip: 1
+  - name: product-owner
+    role: product-owner
+    wip: 1
+  - name: dev-lead
+    role: dev-lead
+    wip: 1
+  - name: developer
+    role: developer
+    wip: 1
+  - name: qa
+    role: qa
+    wip: 1
+role_wip:
+  developer: 2

package/defaults/teams/solo/roles/developer.md

@@ -0,0 +1,28 @@
+---
+name: developer
+label: Developer
+job: Build the accepted change on your own
+ask_first: false
+pinned: false
+hidden: false
+owns:
+  - the change pack
+inputs:
+  - the accepted spec
+outputs:
+  - the change pack
+approvers:
+  - human
+never:
+  - accept a spec
+  - generate a release
+ask_human_when:
+  - the accepted spec does not say what to build
+skills:
+  - implement one change pack
+rules:
+  - stay inside the accepted spec
+goals:
+  - a change the person can try
+---
+One developer builds. The person accepts the spec.

package/defaults/teams/solo/team.yaml

@@ -0,0 +1,7 @@
+branch: bot/{bot}/{change}
+rooms:
+  commit: true
+bots:
+  - name: developer
+    role: developer
+    wip: 1

package/defaults/templates/plan.md

@@ -0,0 +1,17 @@
+# Plan
+
+> **{{title}}** · `{{id}}`
+
+## Order
+
+1.
+
+## Owners
+
+| Work | Role |
+|------|------|
+| | |
+
+## Risks
+
+-

package/defaults/templates/review.md

@@ -0,0 +1,11 @@
+# Review
+
+> **{{title}}** · `{{id}}`
+
+## Finding
+
+-
+
+## Evidence
+
+-

package/defaults/templates/story.md

@@ -0,0 +1,13 @@
+# Story
+
+> **{{title}}** · `{{id}}`
+
+## S-001
+
+As a person
+I want
+So that
+
+## Acceptance
+
+- [ ]

package/defaults/templates/task.md

@@ -0,0 +1,11 @@
+# Task
+
+> **{{title}}** · `{{id}}`
+
+## T-001
+
+- [ ]
+
+## Done when
+
+-

package/defaults/workflows/team-software.yaml

@@ -0,0 +1,153 @@
+name: team-software
+description: >
+  Software team — requirements, architecture, stories, plan, tasks,
+  implement, pull-request review, acceptance
+version: 1
+recommendation:
+  priority: 10
+  when:
+    keywords: [team-software]
+stages:
+  - id: requirements
+    title: Requirements
+    summary: The short reading of what the person asked for
+    kind: standard
+    skippable: false
+    owner: product-manager
+    collaborates: [architect]
+    artifacts:
+      - id: requirements
+        path: requirements.md
+        template: requirements.md
+        required: true
+    gate:
+      type: hard
+      mode: human_approval
+      approvers: [human]
+      checklist:
+        - "The person accepted the reading"
+    agent_context:
+      instructions: |
+        Write the short reading in requirements.md. Do not accept the spec.
+        The person signs this gate.
+
+  - id: architecture
+    title: Architecture
+    summary: Module boundaries for this change
+    kind: standard
+    skippable: false
+    owner: architect
+    collaborates: [product-manager]
+    artifacts:
+      - id: architecture
+        path: architecture.md
+        template: greenfield-architecture.md
+        required: true
+    gate:
+      type: soft
+      approvers: [architect]
+
+  - id: stories
+    title: Stories
+    summary: One story file the product owner can ask about
+    kind: standard
+    skippable: false
+    owner: product-owner
+    collaborates: [dev-lead]
+    artifacts:
+      - id: story
+        path: stories/S-001.md
+        template: story.md
+        required: true
+    gate:
+      type: soft
+      approvers: [product-owner]
+
+  - id: plan
+    title: Plan
+    summary: How the work is split
+    kind: standard
+    skippable: false
+    owner: dev-lead
+    collaborates: [architect, developer]
+    artifacts:
+      - id: plan
+        path: plan.md
+        template: plan.md
+        required: true
+    gate:
+      type: soft
+      approvers: [dev-lead]
+
+  - id: tasks
+    title: Tasks
+    summary: One file per task
+    kind: standard
+    skippable: false
+    owner: dev-lead
+    collaborates: [developer]
+    artifacts:
+      - id: task
+        path: tasks/T-001.md
+        template: task.md
+        required: true
+    gate:
+      type: soft
+
+  - id: implement
+    title: Implement
+    summary: One item for each task file
+    kind: standard
+    skippable: false
+    owner: developer
+    items_from: tasks/T-*.md
+    artifacts: []
+    gate:
+      type: soft
+    agent_context:
+      instructions: |
+        When this stage starts, items.yaml has one row per tasks/T-*.md file.
+        Build those tasks. Do not accept a spec.
+
+  - id: pr_review
+    title: Pull request review
+    summary: Architect and dev lead review the change
+    kind: standard
+    skippable: false
+    owner: architect
+    collaborates: [dev-lead]
+    artifacts:
+      - id: review
+        path: reviews/R-001.md
+        template: review.md
+        required: true
+    gate:
+      type: soft
+      approvers: [architect, dev-lead]
+
+  - id: acceptance
+    title: Acceptance
+    summary: The person tries the change and keeps the final say
+    kind: standard
+    skippable: false
+    owner: product-owner
+    collaborates: [product-manager, architect]
+    artifacts:
+      - id: acceptance
+        path: acceptance.md
+        template: acceptance.md
+        required: true
+    gate:
+      type: hard
+      mode: human_approval
+      approvers: [human]
+      checklist:
+        - "The person recorded what they saw"
+    agent_context:
+      instructions: |
+        Write what the person can try. Do not record the QA result.
+        The person signs this gate.
+
+on_complete:
+  archive: false
+  domain_sync: never

package/dist/{agents-AKSUXQHN.js → agents-PSIOQEYH.js}

@@ -26,9 +26,9 @@ import {
   renderProtocolMd,
   renderThinAgent,
   writeAgentHandoff
-} from "./chunk-4PIRWYRA.js";
-import "./chunk-44LQ5BKZ.js";
-import "./chunk-QHV5KZKX.js";
+} from "./chunk-26YG6A4M.js";
+import "./chunk-TGRV6WGS.js";
+import "./chunk-HG7TPW5V.js";
 import "./chunk-MHODNFIL.js";
 import "./chunk-O5SP6X5R.js";
 export {

package/dist/{change-context-REE7UKU7.js → change-context-EZJMSGSP.js}

@@ -7,7 +7,7 @@ import {
   resolveChangeId,
   saveChangeMeta,
   setActiveChange
-} from "./chunk-QHV5KZKX.js";
+} from "./chunk-HG7TPW5V.js";
 import "./chunk-O5SP6X5R.js";
 export {
   buildContext,