godpowers 0.15.0

package/schema/recipe.v1.json

@@ -0,0 +1,120 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://godpowers.dev/schema/recipe.v1.json",
+  "title": "Godpowers Recipe (v1)",
+  "description": "Scenario-based recipe that agents consult to map user intent to command sequences.",
+  "type": "object",
+  "required": ["apiVersion", "kind", "metadata", "triggers", "sequences"],
+  "properties": {
+    "apiVersion": {
+      "type": "string",
+      "enum": ["godpowers/v1"]
+    },
+    "kind": {
+      "type": "string",
+      "enum": ["Recipe"]
+    },
+    "metadata": {
+      "type": "object",
+      "required": ["name", "category"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*$"
+        },
+        "category": {
+          "type": "string",
+          "enum": [
+            "starting", "planning", "building", "shipping",
+            "production", "maintaining", "recovering", "collaborating",
+            "knowledge", "feature-addition", "configuration", "meta"
+          ]
+        },
+        "description": { "type": "string" }
+      }
+    },
+    "triggers": {
+      "type": "object",
+      "properties": {
+        "intent-keywords": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Keywords/phrases that match user intent"
+        },
+        "state-conditions": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "State predicates: lifecycle-phase == X, tier-N.sub.status == Y"
+        },
+        "anti-conditions": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Conditions where this recipe does NOT apply"
+        }
+      }
+    },
+    "decision-tree": {
+      "type": "array",
+      "description": "Optional decision tree for branching based on user answers",
+      "items": {
+        "type": "object",
+        "required": ["question", "options"],
+        "properties": {
+          "question": { "type": "string" },
+          "options": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": ["answer"],
+              "properties": {
+                "answer": { "type": "string" },
+                "scope": { "type": "string" },
+                "sequence-name": { "type": "string" },
+                "sequence": {
+                  "type": "array",
+                  "items": { "$ref": "#/$defs/Step" }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "sequences": {
+      "type": "object",
+      "description": "Named command sequences that this recipe can execute",
+      "patternProperties": {
+        "^[a-z][a-z0-9-]*$": {
+          "type": "object",
+          "required": ["steps"],
+          "properties": {
+            "description": { "type": "string" },
+            "steps": {
+              "type": "array",
+              "items": { "$ref": "#/$defs/Step" }
+            }
+          }
+        }
+      }
+    },
+    "default-sequence": {
+      "type": "string",
+      "description": "Which sequence to use if no decision-tree branching"
+    }
+  },
+  "$defs": {
+    "Step": {
+      "type": "object",
+      "required": ["command"],
+      "properties": {
+        "command": {
+          "type": "string",
+          "pattern": "^/god-[a-z-]+(\\s.*)?$"
+        },
+        "why": { "type": "string", "description": "Why this step in this sequence" },
+        "wait-for": { "type": "string", "enum": ["completion", "user-confirm"], "default": "completion" },
+        "skip-when": { "type": "string", "description": "Condition to skip this step" }
+      }
+    }
+  }
+}

package/schema/routing.v1.json

@@ -0,0 +1,163 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://godpowers.dev/schema/routing.v1.json",
+  "title": "Godpowers Command Routing (v1)",
+  "description": "Defines prerequisites, execution, and routing for a single slash command.",
+  "type": "object",
+  "required": ["apiVersion", "kind", "metadata", "execution", "endoff"],
+  "properties": {
+    "apiVersion": {
+      "type": "string",
+      "enum": ["godpowers/v1"]
+    },
+    "kind": {
+      "type": "string",
+      "enum": ["CommandRouting"]
+    },
+    "metadata": {
+      "type": "object",
+      "required": ["command"],
+      "properties": {
+        "command": {
+          "type": "string",
+          "pattern": "^/god-[a-z-]+$"
+        },
+        "description": { "type": "string" },
+        "tier": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 3
+        }
+      }
+    },
+    "prerequisites": {
+      "type": "object",
+      "properties": {
+        "required": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/Prerequisite" }
+        },
+        "recommended": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/Recommendation" }
+        }
+      }
+    },
+    "execution": {
+      "type": "object",
+      "required": ["spawns"],
+      "properties": {
+        "spawns": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Agent names this skill spawns (in order or parallel)"
+        },
+        "context": { "type": "string", "enum": ["fresh", "shared"], "default": "fresh" },
+        "reads": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "writes": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "secondary-spawns": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Agents spawned by primary agent (e.g., reviewers)"
+        }
+      }
+    },
+    "standards": {
+      "type": "object",
+      "description": "Artifact discipline checks at this gate",
+      "properties": {
+        "substitution-test": { "type": "boolean", "default": false },
+        "three-label-test": { "type": "boolean", "default": false },
+        "have-nots": {
+          "type": "array",
+          "items": { "type": "string", "pattern": "^[A-Z]+-\\d{2}$" }
+        },
+        "gate-on-failure": {
+          "type": "string",
+          "enum": ["pause-for-user", "auto-fix", "warn", "block"],
+          "default": "pause-for-user"
+        }
+      }
+    },
+    "success-path": {
+      "type": "object",
+      "properties": {
+        "next-recommended": {
+          "type": "string",
+          "pattern": "^/god-[a-z-]+$"
+        },
+        "alternatives": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "command": { "type": "string" },
+              "when": { "type": "string", "description": "Condition for this alternative" }
+            }
+          }
+        }
+      }
+    },
+    "failure-path": {
+      "type": "object",
+      "properties": {
+        "on-have-nots-fail": { "type": "string", "description": "What to do if have-nots fail" },
+        "on-pause": { "type": "string", "description": "What to do on legitimate pause" },
+        "on-error": { "type": "string", "description": "What to do on unexpected error" }
+      }
+    },
+    "endoff": {
+      "type": "object",
+      "required": ["state-update"],
+      "properties": {
+        "state-update": {
+          "type": "string",
+          "description": "What changes in state.json"
+        },
+        "events": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "lifecycle-transition": {
+          "type": "string",
+          "description": "If this command transitions lifecycle phase"
+        }
+      }
+    }
+  },
+  "$defs": {
+    "Prerequisite": {
+      "type": "object",
+      "required": ["check"],
+      "properties": {
+        "check": {
+          "type": "string",
+          "description": "Predicate: e.g., 'state:tier-1.prd.done', 'file:.godpowers/state.json'"
+        },
+        "auto-complete": {
+          "type": "string",
+          "pattern": "^/god-[a-z-]+$",
+          "description": "Command to run if prerequisite missing"
+        },
+        "human-required": {
+          "type": "boolean",
+          "description": "If true, ask user before auto-completing"
+        }
+      }
+    },
+    "Recommendation": {
+      "type": "object",
+      "required": ["command"],
+      "properties": {
+        "command": { "type": "string", "pattern": "^/god-[a-z-]+$" },
+        "when": { "type": "string", "description": "Condition for this recommendation" }
+      }
+    }
+  }
+}

package/schema/state.v1.json

@@ -0,0 +1,146 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://godpowers.dev/schema/state.v1.json",
+  "title": "Godpowers Project State (v1)",
+  "description": "Machine-managed project state. The 'facts' artifact in the three load-bearing artifacts pattern.",
+  "type": "object",
+  "required": ["$schema", "version", "project", "tiers"],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "const": "https://godpowers.dev/schema/state.v1.json"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "project": {
+      "type": "object",
+      "required": ["name", "started"],
+      "properties": {
+        "name": { "type": "string" },
+        "started": { "type": "string", "format": "date-time" }
+      }
+    },
+    "active-workstream": {
+      "type": "string",
+      "default": "main"
+    },
+    "tiers": {
+      "type": "object",
+      "patternProperties": {
+        "^tier-[0-9]+$": {
+          "type": "object",
+          "patternProperties": {
+            "^[a-z][a-z0-9-]*$": {
+              "$ref": "#/$defs/SubStep"
+            }
+          }
+        }
+      }
+    },
+    "lifecycle-phase": {
+      "type": "string",
+      "enum": [
+        "pre-init",
+        "in-arc",
+        "steady-state-active",
+        "post-incident-pending",
+        "in-migration",
+        "spike-pending-followup"
+      ]
+    },
+    "mode": {
+      "type": "string",
+      "enum": ["A", "B", "C", "E"],
+      "description": "Mirror of intent.yaml mode for runtime queries. A=greenfield, B=brownfield/gap-fill, C=audit-only, E=bluefield."
+    },
+    "mode-d-suite": {
+      "type": "boolean",
+      "default": false,
+      "description": "True when this repo is part of a multi-repo suite (god-coordinator owns suite scope)."
+    },
+    "mode-detected-from": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Signals used to detect the mode (e.g. 'no-package-json-found', 'org-context-yaml-in-parent')."
+    },
+    "mode-announced-as": {
+      "type": "string",
+      "description": "Human-friendly label shown to the user (greenfield/brownfield/bluefield/audit)."
+    },
+    "linkage": {
+      "type": "object",
+      "description": "Slot for linkage map summary. Authoritative file is .godpowers/linkage.json.",
+      "additionalProperties": true
+    },
+    "yolo-decisions": {
+      "type": "array",
+      "description": "Auto-decisions made under --yolo. Mirrored to YOLO-DECISIONS.md.",
+      "items": { "type": "object", "additionalProperties": true }
+    },
+    "lock": {
+      "type": "object",
+      "description": "Cooperative advisory lock for multi-user / multi-agent concurrency. The orchestrator acquires a lock before mutating state, releases on completion or after a stale-lock timeout. Concurrent writers see the lock and pause or pick a different sub-step.",
+      "properties": {
+        "holder": {
+          "type": "string",
+          "description": "Identifier of the actor holding the lock (e.g. 'alice@laptop', 'god-orchestrator@run-abc123')."
+        },
+        "acquired": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "expires": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Lock auto-expires after this time. Stale locks (past expires) are reclaimable by any actor with a warning event."
+        },
+        "scope": {
+          "type": "string",
+          "description": "What the holder is currently mutating (e.g. 'tier-1.arch', 'linkage', 'all'). Lets concurrent actors pick non-conflicting work."
+        }
+      }
+    }
+  },
+  "$defs": {
+    "SubStep": {
+      "type": "object",
+      "required": ["status"],
+      "properties": {
+        "status": {
+          "type": "string",
+          "enum": ["pending", "in-flight", "done", "skipped", "imported", "failed", "re-invoked"]
+        },
+        "artifact": {
+          "type": "string",
+          "description": "Relative path from .godpowers/"
+        },
+        "artifact-hash": {
+          "type": "string",
+          "pattern": "^sha256:[a-f0-9]{64}$"
+        },
+        "agent-version": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*@\\d+\\.\\d+\\.\\d+$"
+        },
+        "have-nots-passed": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^[A-Z]+-\\d{2}$"
+          }
+        },
+        "updated": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "notes": {
+          "type": "string",
+          "description": "Free-form for skip reason, failure detail, etc."
+        }
+      }
+    }
+  },
+  "additionalProperties": false
+}

package/schema/workflow.v1.json

@@ -0,0 +1,96 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://godpowers.dev/schema/workflow.v1.json",
+  "title": "Godpowers Workflow (v1)",
+  "description": "Declarative workflow definition. Read by god-orchestrator.",
+  "type": "object",
+  "required": ["apiVersion", "kind", "metadata", "on", "jobs"],
+  "properties": {
+    "apiVersion": {
+      "type": "string",
+      "enum": ["godpowers/v1"]
+    },
+    "kind": {
+      "type": "string",
+      "enum": ["Workflow"]
+    },
+    "metadata": {
+      "type": "object",
+      "required": ["name", "version"],
+      "properties": {
+        "name": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+        "version": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+$" },
+        "description": { "type": "string" }
+      }
+    },
+    "on": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^/god-[a-z-]+$"
+      }
+    },
+    "jobs": {
+      "type": "object",
+      "patternProperties": {
+        "^[a-z][a-z0-9-]*$": { "$ref": "#/$defs/Job" }
+      },
+      "minProperties": 1
+    }
+  },
+  "$defs": {
+    "Job": {
+      "type": "object",
+      "required": ["uses"],
+      "properties": {
+        "tier": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 3
+        },
+        "uses": {
+          "type": "string",
+          "pattern": "^god-[a-z-]+@[\\^~]?\\d+\\.\\d+\\.\\d+$|^god-[a-z-]+@[\\^~]?\\d+\\.x$",
+          "description": "Agent reference with SemVer constraint"
+        },
+        "needs": {
+          "oneOf": [
+            { "type": "string" },
+            { "type": "array", "items": { "type": "string" } }
+          ]
+        },
+        "with": {
+          "type": "object",
+          "description": "Inputs to the agent"
+        },
+        "review": {
+          "type": "object",
+          "properties": {
+            "stages": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "required": ["uses"],
+                "properties": {
+                  "uses": { "type": "string" },
+                  "on-fail": { "type": "string" }
+                }
+              }
+            }
+          }
+        },
+        "blocks-on": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": true
+          }
+        },
+        "per": { "type": "string", "enum": ["slice", "wave"] },
+        "parallel-by": { "type": "string", "enum": ["slice", "wave"] },
+        "on-pass": { "type": "string" },
+        "skip-when": { "type": "string" }
+      }
+    }
+  }
+}

package/skills/god-add-backlog.md

@@ -0,0 +1,40 @@
+---
+name: god-add-backlog
+description: |
+  Add an idea to the backlog. Less urgent than a todo. Reviewed periodically
+  via /god-review-backlog. Captured in .godpowers/backlog/BACKLOG.md.
+
+  Triggers on: "god add backlog", "/god-add-backlog", "backlog this", "for later"
+---
+
+# /god-add-backlog
+
+Add an idea to the backlog parking lot.
+
+## Process
+
+1. Append to `.godpowers/backlog/BACKLOG.md`:
+
+```markdown
+- [date] [idea description] (source: [conversation context])
+```
+
+2. Confirm capture without ceremony.
+
+## Subcommands
+
+### `/god-add-backlog <text>`
+Add an item.
+
+### `/god-add-backlog list`
+Show items, sorted by date.
+
+### `/god-add-backlog promote <n>`
+Promote item N to a todo via /god-add-todo, or to a roadmap milestone.
+
+## Difference from /god-add-todo
+
+- Todos are things you'll work on this sprint or this quarter
+- Backlog is things you might work on someday, or might not
+- Backlog gets reviewed less often
+- Backlog items can age out

package/skills/god-add-tests.md

@@ -0,0 +1,53 @@
+---
+name: god-add-tests
+description: |
+  Generate tests for existing code based on UAT criteria and observed
+  behavior. For shoring up coverage on legacy code without rewriting.
+
+  Triggers on: "god add tests", "/god-add-tests", "test coverage", "add tests"
+---
+
+# /god-add-tests
+
+Generate tests for existing code.
+
+## When to use
+
+- Before /god-refactor on legacy code without coverage
+- Before /god-upgrade as part of pre-migration test gap-fill
+- After acquiring code from another team (combined with /god-map-codebase)
+
+## When NOT to use
+
+- New feature: use /god-build (TDD writes tests first)
+- Single bug fix: use /god-debug (writes regression test as part of fix)
+
+## Process
+
+1. Identify the surface to add tests for (file, module, or function)
+2. Spawn god-executor in test-only mode:
+   - Read the code
+   - Identify acceptance behaviors (what should this do)
+   - Identify edge cases
+   - Write tests that codify the current behavior
+   - Don't change the code (just add tests)
+3. Spawn god-quality-reviewer:
+   - Are tests meaningful (testing behavior, not implementation)?
+   - Are edge cases covered?
+4. Atomic commit: `test: add coverage for <surface>`
+
+## Have-Nots
+
+- Tests that verify the test framework runs (no actual assertions)
+- Tests that mirror the implementation 1:1 (fragile, no value)
+- Tests that pass even when bug is intentionally introduced
+
+## On Completion
+
+```
+Test coverage added: <surface>
+New tests: N
+Coverage delta: +X%
+
+Suggested next: /god-refactor or /god-upgrade now that coverage is in place
+```

package/skills/god-add-todo.md

@@ -0,0 +1,32 @@
+---
+name: god-add-todo
+description: |
+  Capture an idea or task as a todo from current conversation context. Adds
+  to .godpowers/todos/TODOS.md with priority and source.
+
+  Triggers on: "god add todo", "/god-add-todo", "remind me", "todo"
+---
+
+# /god-add-todo
+
+Capture a todo without breaking flow.
+
+## Process
+
+1. Read the current conversation context for the source of the todo
+2. Ask user (briefly): priority? (P0/P1/P2/P3, default P2)
+3. Append to `.godpowers/todos/TODOS.md`:
+
+```markdown
+- [ ] [P2] [date] [todo description] (source: [conversation summary])
+```
+
+4. Confirm: "Captured. Run /god-check-todos to see them."
+
+## On Completion
+
+```
+Todo captured: [description]
+Priority: P2
+Total open todos: 7
+```