@structured-vibe-coding/core 0.18.0 → 0.20.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,4 @@
+rules:
+  - 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/qa-testing.md

@@ -0,0 +1,11 @@
+# QA testing
+
+> **{{title}}** · `{{id}}`
+
+## Tried
+
+-
+
+## Not tried
+
+-

package/defaults/templates/review.md

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

package/defaults/templates/signoff.md

@@ -0,0 +1,7 @@
+# Sign-off
+
+> **{{title}}** · `{{id}}`
+
+## Ask
+
+-

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,293 @@
+name: team-software
+description: >
+  Software team sign-off — requirements, clarifications, high-level design,
+  low-level design, plan, test plan, development, pull-request review,
+  QA testing, QA sign-off, product-owner review, and product-owner sign-off
+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, research-assistant]
+    artifacts:
+      - id: requirements
+        path: requirements.md
+        template: requirements.md
+        required: true
+    gate:
+      type: hard
+      mode: human_approval
+      approvers: [human]
+      checklist:
+        - "The person signed the reading"
+    agent_context:
+      instructions: |
+        Write the short reading in requirements.md. Do not accept the spec.
+        The person signs this stage.
+
+  - id: clarifications
+    title: Clarifications
+    summary: Questions the reading still needs answered
+    kind: standard
+    skippable: false
+    owner: product-manager
+    collaborates: [research-assistant]
+    artifacts:
+      - id: clarifications
+        path: clarifications.md
+        template: clarify.md
+        required: true
+    gate:
+      type: hard
+      mode: human_approval
+      approvers: [human]
+      checklist:
+        - "The person signed the clarifications"
+    agent_context:
+      instructions: |
+        Write the open questions and the answers the person gave.
+        A role does not sign this stage.
+
+  - id: hld
+    title: High-level design
+    summary: Modules and the seams between them
+    kind: standard
+    skippable: false
+    owner: architect
+    collaborates: [product-manager]
+    artifacts:
+      - id: hld
+        path: hld.md
+        template: hl-design.md
+        required: true
+    gate:
+      type: hard
+      mode: human_approval
+      approvers: [human]
+      checklist:
+        - "The person signed the high-level design"
+    agent_context:
+      instructions: |
+        Name the modules. Do not accept the spec.
+        The person signs this stage.
+
+  - id: lld
+    title: Low-level design
+    summary: How one module does the change
+    kind: standard
+    skippable: false
+    owner: architect
+    collaborates: [developer]
+    artifacts:
+      - id: lld
+        path: lld.md
+        template: lld.md
+        required: true
+    gate:
+      type: hard
+      mode: human_approval
+      approvers: [human]
+      checklist:
+        - "The person signed the low-level design"
+    agent_context:
+      instructions: |
+        Name the functions and the data for this change.
+        A role does not sign this stage.
+
+  - id: plan
+    title: Plan approval
+    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
+      - id: task
+        path: tasks/T-001.md
+        template: task.md
+        required: true
+    gate:
+      type: hard
+      mode: human_approval
+      approvers: [human]
+      checklist:
+        - "The person signed the plan"
+    agent_context:
+      instructions: |
+        Write the order of work and the first task file.
+        A role does not sign this stage.
+
+  - id: test_plan
+    title: Test plan
+    summary: What QA will try before the change is called done
+    kind: standard
+    skippable: false
+    owner: qa
+    collaborates: [developer]
+    artifacts:
+      - id: test-plan
+        path: test-plan.md
+        template: local-test-plan.md
+        required: true
+    gate:
+      type: hard
+      mode: human_approval
+      approvers: [human]
+      checklist:
+        - "The person signed the test plan"
+    agent_context:
+      instructions: |
+        Write what to try. Do not record a result.
+        The person signs this stage.
+
+  - id: implement
+    title: Development
+    summary: One item for each task file
+    kind: standard
+    skippable: false
+    owner: developer
+    collaborates: [dev-lead]
+    items_from: tasks/T-*.md
+    artifacts: []
+    gate:
+      type: hard
+      mode: human_approval
+      approvers: [human]
+      checklist:
+        - "The person signed the development"
+    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.
+        The person signs this stage.
+
+  - 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: hard
+      mode: human_approval
+      approvers: [human]
+      checklist:
+        - "The person signed the pull-request review"
+    agent_context:
+      instructions: |
+        Write the review. Do not merge.
+        The person signs this stage.
+
+  - id: qa_testing
+    title: QA testing
+    summary: What QA tried on this commit
+    kind: standard
+    skippable: false
+    owner: qa
+    collaborates: [developer]
+    artifacts:
+      - id: qa-testing
+        path: qa-testing.md
+        template: qa-testing.md
+        required: true
+    gate:
+      type: hard
+      mode: human_approval
+      approvers: [human]
+      checklist:
+        - "The person signed the QA testing note"
+    agent_context:
+      instructions: |
+        Write what was tried. Do not record a pass, and do not sign.
+        The person signs this stage.
+
+  - id: qa_signoff
+    title: QA sign-off
+    summary: The person's QA words for this commit
+    kind: standard
+    skippable: false
+    owner: qa
+    collaborates: [product-owner]
+    artifacts:
+      - id: qa-signoff
+        path: qa-signoff.md
+        template: signoff.md
+        required: true
+    gate:
+      type: hard
+      mode: human_approval
+      approvers: [human]
+      checklist:
+        - "The person signed QA for this commit"
+    agent_context:
+      instructions: |
+        Prepare what the person is asked to sign.
+        A role cannot sign. The sign-off stores the person's words and the git SHA.
+
+  - id: po_review
+    title: Product-owner review
+    summary: Whether the change matches the reading
+    kind: standard
+    skippable: false
+    owner: product-owner
+    collaborates: [product-manager]
+    artifacts:
+      - id: po-review
+        path: po-review.md
+        template: review.md
+        required: true
+    gate:
+      type: hard
+      mode: human_approval
+      approvers: [human]
+      checklist:
+        - "The person signed the product-owner review"
+    agent_context:
+      instructions: |
+        Write whether the change matches the reading. Do not accept it.
+        The person signs this stage.
+
+  - id: po_signoff
+    title: Product-owner sign-off
+    summary: The person's final words for this commit
+    kind: standard
+    skippable: false
+    owner: product-owner
+    collaborates: [qa]
+    artifacts:
+      - id: po-signoff
+        path: po-signoff.md
+        template: signoff.md
+        required: true
+    gate:
+      type: hard
+      mode: human_approval
+      approvers: [human]
+      checklist:
+        - "The person signed off for this commit"
+    agent_context:
+      instructions: |
+        Prepare what the person is asked to sign.
+        A role cannot sign. The sign-off stores the person's words and the git SHA.
+        Merge stays a person action after this sign-off.
+
+on_complete:
+  archive: false
+  domain_sync: never

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

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

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

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