@sniper.ai/core 3.1.1 → 3.2.0

package/checklists/plan.yaml

@@ -20,11 +20,6 @@ checks:
     blocking: true
     description: Architecture plan includes Data Model section
 
-  - id: ears_criteria
-    description: All stories have EARS acceptance criteria
-    check: grep:.sniper/artifacts/{protocol_id}/stories/:"shall"
-    blocking: true
-
   - id: open_questions
     description: No unresolved open questions remain
     check: "!grep:.sniper/artifacts/{protocol_id}/:\\*\\*TBD\\*\\*|\\*\\*TODO\\*\\*|\\*\\*OPEN\\*\\*"

package/checklists/solve.yaml

@@ -0,0 +1,29 @@
+name: solve
+description: Story sharding quality gate
+# Note: {protocol_id} is resolved at gate-review time from the active checkpoint
+
+checks:
+  - id: stories_exist
+    description: At least one story file exists
+    check: glob:.sniper/artifacts/{protocol_id}/stories/:*.md
+    blocking: true
+
+  - id: ears_criteria
+    description: All stories have EARS acceptance criteria
+    check: grep:.sniper/artifacts/{protocol_id}/stories/:"shall"
+    blocking: true
+
+  - id: stories_have_status
+    description: All stories have a status field in frontmatter
+    check: grep:.sniper/artifacts/{protocol_id}/stories/:"status:"
+    blocking: true
+
+  - id: stories_reference_architecture
+    description: Stories reference the architecture plan
+    check: grep:.sniper/artifacts/{protocol_id}/stories/:"plan.md"
+    blocking: false
+
+  - id: open_questions
+    description: No unresolved open questions in stories
+    check: "!grep:.sniper/artifacts/{protocol_id}/stories/:\\*\\*TBD\\*\\*|\\*\\*TODO\\*\\*|\\*\\*OPEN\\*\\*"
+    blocking: false

package/hooks/settings-hooks.json

@@ -2,7 +2,7 @@
   "hooks": {
     "PreToolUse": [
       {
-        "matcher": { "tools": ["Write"] },
+        "matcher": "Write",
         "hooks": [
           {
             "type": "command",
@@ -14,7 +14,7 @@
     ],
     "PostToolUse": [
       {
-        "matcher": { "tools": ["Bash"] },
+        "matcher": "Bash",
         "hooks": [
           {
             "type": "command",
@@ -26,7 +26,6 @@
     ],
     "Stop": [
       {
-        "matcher": {},
         "hooks": [
           {
             "type": "command",

package/hooks/signal-hooks.json

@@ -2,7 +2,7 @@
   "hooks": {
     "PostToolUse": [
       {
-        "matcher": { "tools": ["Bash"] },
+        "matcher": "Bash",
         "hooks": [
           {
             "type": "command",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sniper.ai/core",
-  "version": "3.1.1",
+  "version": "3.2.0",
   "description": "SNIPER framework core — agents, skills, protocols, checklists, templates, and hooks",
   "type": "module",
   "exports": {

package/protocols/feature.yaml

@@ -4,18 +4,28 @@ budget: 800000  # 800K tokens
 
 phases:
   - name: plan
-    description: Feature design and story creation
+    description: Feature design and architecture
     agents:
       - architect
       - product-manager
-    spawn_strategy: sequential  # Architect designs first, PM writes stories from that
-    interactive_review: true  # Present plan to user for review/feedback before proceeding
+    spawn_strategy: sequential  # Architect designs first, PM refines PRD from that
+    interactive_review: true  # User reviews architecture before story sharding
     gate:
       checklist: plan
       human_approval: true
     outputs:
       - .sniper/artifacts/{protocol_id}/plan.md
       - .sniper/artifacts/{protocol_id}/prd.md
+
+  - name: solve
+    description: Story creation from approved architecture
+    agents:
+      - product-manager
+    spawn_strategy: single
+    gate:
+      checklist: solve
+      human_approval: false
+    outputs:
       - .sniper/artifacts/{protocol_id}/stories/
 
   - name: implement

package/protocols/full.yaml

@@ -4,33 +4,44 @@ budget: 2000000  # 2M tokens
 
 phases:
   - name: discover
-    description: Research, analyze codebase, produce discovery spec
+    description: Research, analyze codebase, produce discovery spec and PRD
     agents:
       - analyst
     spawn_strategy: single  # One agent, no team needed
+    interactive_review: true  # User reviews spec/PRD before architecture begins
     gate:
       checklist: discover
-      human_approval: false
+      human_approval: true
     outputs:
       - .sniper/artifacts/spec.md  # Living master doc
       - .sniper/artifacts/codebase-overview.md  # Living master doc
 
   - name: plan
-    description: Architecture design, PRD creation, story breakdown
+    description: Architecture design and PRD refinement
     agents:
       - architect
       - product-manager
     spawn_strategy: team  # Multiple agents, use TeamCreate
-    interactive_review: true  # Present plan to user for review/feedback before proceeding
+    interactive_review: true  # User reviews architecture before story sharding
     coordination:
       - between: [architect, product-manager]
-        topic: Architecture must be approved before stories reference it
+        topic: Architecture must be finalized before PRD is updated
     gate:
       checklist: plan
-      human_approval: true  # Human reviews the plan before implementation
+      human_approval: true  # Human reviews architecture before stories are created
     outputs:
       - .sniper/artifacts/{protocol_id}/plan.md
       - .sniper/artifacts/{protocol_id}/prd.md
+
+  - name: solve
+    description: Epic sharding and story creation from approved architecture
+    agents:
+      - product-manager
+    spawn_strategy: single
+    gate:
+      checklist: solve
+      human_approval: false
+    outputs:
       - .sniper/artifacts/{protocol_id}/stories/
 
   - name: implement

package/schemas/live-status.schema.yaml

@@ -76,6 +76,33 @@ properties:
           minimum: 0
           maximum: 100
           description: Phase completion percentage.
+  stories:
+    type: array
+    description: Per-story status tracking for the current protocol run.
+    items:
+      type: object
+      required:
+        - id
+        - title
+        - status
+      properties:
+        id:
+          type: string
+          description: Story identifier (e.g., "001", "002").
+        title:
+          type: string
+          description: Story title.
+        status:
+          type: string
+          enum:
+            - pending
+            - in_progress
+            - completed
+            - skipped
+          description: Current status of the story.
+        assigned_agent:
+          type: string
+          description: Agent assigned to implement this story.
   gate_results:
     type: array
     description: Results from completed gate reviews.

package/skills/sniper-flow/SKILL.md

@@ -84,6 +84,8 @@ commits: [git SHAs produced]
 
 Update `.sniper/live-status.yaml` with current phase, agent statuses, and cost percentage.
 
+After the `solve` phase completes, populate the `stories` array in `.sniper/live-status.yaml` by reading story files from `.sniper/artifacts/{protocol_id}/stories/`. During `implement`, update each story's status (`in_progress` → `completed`) as agents finish work on it.
+
 ### Gate
 
 1. Write `.sniper/pending-gate.yaml` with phase name and checklist reference
@@ -180,8 +182,10 @@ For agents working in worktrees (after all implementation agents complete):
 
 When a phase has `interactive_review: true`:
 
-1. Read produced artifacts from `.sniper/artifacts/{protocol_id}/` (e.g., `plan.md`, `prd.md`, `stories/`)
-2. Present a structured summary: key architectural decisions, component overview, story count, open questions
+1. Read produced artifacts from `.sniper/artifacts/{protocol_id}/` (e.g., `spec.md`, `plan.md`, `prd.md`)
+2. Present a structured summary appropriate to the phase:
+   - **discover:** scope, requirements, key findings, open questions
+   - **plan:** key architectural decisions, component overview, data model, trade-offs
 3. Offer options:
    - **Approve** — continue to next phase
    - **Request changes** — describe changes (architect/PM will revise, then re-present)

package/templates/live-status.yaml

@@ -13,6 +13,12 @@ phases:
     #   status: active | completed | failed
     progress: 0  # percentage
 
+stories: []
+# - id: "001"
+#   title: ""
+#   status: pending  # pending | in_progress | completed | skipped
+#   assigned_agent: ""
+
 gate_results: []
 # - phase: discover
 #   result: pass

package/templates/story.md

@@ -1,3 +1,10 @@
+---
+status: pending  # pending | in_progress | completed | skipped
+assigned_agent:
+started_at:
+completed_at:
+---
+
 # Story: [TITLE]
 <!-- Budget: 1500 tokens max -->