godpowers 3.0.0 → 3.0.2

package/agents/god-browser-tester.md

@@ -10,6 +10,21 @@ description: |
   Spawned by: /god-test-runtime, /god-build (optional after wave),
   /god-launch (mandatory gate), /god-harden (a11y check)
 tools: Read, Write, Bash, Grep
+inputs:
+  - "runtime URL"
+  - "DESIGN.md"
+  - ".godpowers/prd/PRD.md"
+  - "project root"
+outputs:
+  - ".godpowers/runtime/<run-id>/audit-report.json"
+  - ".godpowers/runtime/<run-id>/test-report.json"
+  - ".godpowers/runtime/<run-id>/summary.md"
+gates:
+  - "WCAG AA contrast"
+  - "component drift threshold"
+  - "P-MUST acceptance flows"
+handoff:
+  - "return run id, backend, report paths, and critical findings to spawner"
 ---
 
 # God Browser Tester

package/agents/god-context-writer.md

@@ -9,6 +9,20 @@ description: |
   Spawned by: /god-init (automatic quiet setup after consent), /god-context,
   /god-sync (refresh).
 tools: Read, Write, Edit, Bash, Grep, Glob
+inputs:
+  - ".godpowers/state.json"
+  - "detected AI tool configuration"
+  - "DESIGN.md and PRODUCT.md presence"
+outputs:
+  - "AGENTS.md godpowers fence"
+  - "tool-specific pointer files"
+  - "context refresh summary"
+gates:
+  - "detect-then-write policy"
+  - "fenced edits only"
+  - "idempotent context output"
+handoff:
+  - "return canonical and pointer write summary to invoking skill"
 ---
 
 # God Context Writer

package/agents/god-coordinator.md

@@ -10,6 +10,20 @@ description: |
   Spawned by: /god-suite-init, /god-suite-status, /god-suite-sync,
   /god-suite-release, /god-suite-patch
 tools: Read, Write, Edit, Bash, Grep, Glob, Task
+inputs:
+  - "suite manifest"
+  - "per-repo state files"
+  - "suite operation request"
+outputs:
+  - "suite coordination state"
+  - "per-repo orchestrator handoff files"
+  - "suite release or sync report"
+gates:
+  - "per-repo orchestrator ownership"
+  - "byte-identical file sync verification"
+  - "suite meta-linter results"
+handoff:
+  - "return suite-level status and per-repo next actions"
 ---
 
 # God Coordinator

package/agents/god-debt-assessor.md

@@ -7,6 +7,17 @@ description: |
 
   Spawned by: /god-tech-debt, brownfield-arc workflow
 tools: Read, Bash, Grep, Glob, WebSearch
+inputs:
+  - "brownfield codebase"
+  - "optional archaeology report"
+  - "dependency and test evidence"
+outputs:
+  - ".godpowers/tech-debt/REPORT.md"
+gates:
+  - "technical debt prioritization evidence"
+  - "debt assessment have-nots"
+handoff:
+  - "return prioritized P0 through P3 remediation plan"
 ---
 
 # God Debt Assessor

package/agents/god-debugger.md

@@ -7,6 +7,19 @@ description: |
 
   Spawned by: /god-debug, when build encounters failures
 tools: Read, Edit, Bash, Grep, Glob, WebSearch
+inputs:
+  - "bug report"
+  - "failing command evidence"
+  - "codebase and recent commits"
+outputs:
+  - "regression test"
+  - "minimal fix"
+  - "debug conclusion summary"
+gates:
+  - "observe-minimize-instrument-hypothesize-test-conclude sequence"
+  - "regression test passes"
+handoff:
+  - "return root cause, fix files, and verification commands"
 ---
 
 # God Debugger

package/agents/god-deploy-engineer.md

@@ -6,6 +6,19 @@ description: |
 
   Spawned by: /god-deploy, god-orchestrator
 tools: Read, Write, Edit, Bash, Glob
+inputs:
+  - ".godpowers/arch/ARCH.md"
+  - ".godpowers/stack/DECISION.md"
+  - ".godpowers/state.json build evidence"
+outputs:
+  - ".godpowers/state.json deploy evidence"
+  - "CI and deploy configuration"
+  - "rollback procedure"
+gates:
+  - "D-01 through D-08 have-nots"
+  - "deploy state evidence is complete"
+handoff:
+  - "return deploy evidence and smoke verification status"
 ---
 
 # God Deploy Engineer

package/agents/god-deps-auditor.md

@@ -7,6 +7,19 @@ description: |
 
   Spawned by: /god-update-deps
 tools: Read, Write, Edit, Bash, Grep, Glob, WebSearch
+inputs:
+  - "package manifests"
+  - "lockfiles"
+  - "stack decision"
+  - "security advisories"
+outputs:
+  - ".godpowers/deps/AUDIT.md"
+  - "classified dependency update plan"
+gates:
+  - "DP-01 through DP-06 have-nots"
+  - "patch-minor-major risk classification"
+handoff:
+  - "return safe updates, deferred migrations, and verification notes"
 ---
 
 # God Deps Auditor

package/agents/god-design-reviewer.md

@@ -9,6 +9,20 @@ description: |
 
   Spawned by: /god-design, god-orchestrator (mid-arc DESIGN/PRODUCT changes)
 tools: Read, Bash, Grep, Glob
+inputs:
+  - "DESIGN.md diff"
+  - "PRODUCT.md"
+  - "PRD and design context"
+outputs:
+  - "design review verdict"
+  - ".godpowers/design/REJECTED.md on block"
+  - "design.review-verdict event"
+gates:
+  - "impeccable critique when available"
+  - "design-spec lint"
+  - "WCAG contrast checks"
+handoff:
+  - "return PASS, WARN, or BLOCK verdict to design updater or orchestrator"
 ---
 
 # God Design Reviewer

package/agents/god-designer.md

@@ -8,6 +8,21 @@ description: |
 
   Spawned by: /god-design, god-orchestrator (Tier 1, conditional on UI)
 tools: Read, Write, Edit, Bash, Grep, Glob
+inputs:
+  - ".godpowers/prd/PRD.md"
+  - ".godpowers/arch/ARCH.md"
+  - ".godpowers/stack/DECISION.md"
+  - ".godpowers/state.json"
+outputs:
+  - "DESIGN.md"
+  - "PRODUCT.md when supported"
+  - ".godpowers/state.json design evidence"
+gates:
+  - "design-spec lint"
+  - "impeccable detect when available"
+  - "design have-nots"
+handoff:
+  - "return design artifact paths and validation summary to orchestrator"
 ---
 
 # God Designer

package/agents/god-docs-writer.md

@@ -7,6 +7,19 @@ description: |
 
   Spawned by: /god-docs
 tools: Read, Write, Edit, Bash, Grep, Glob
+inputs:
+  - "codebase"
+  - "existing documentation"
+  - "changed behavior evidence"
+outputs:
+  - "updated docs"
+  - ".godpowers/docs/UPDATE-LOG.md"
+gates:
+  - "DC-01 through DC-05 have-nots"
+  - "docs match code evidence"
+  - "substitution and three-label checks"
+handoff:
+  - "return updated files and drift findings"
 ---
 
 # God Docs Writer

package/agents/god-executor.md

@@ -7,6 +7,20 @@ description: |
 
   Spawned by: god-orchestrator (one per slice, parallel waves)
 tools: Read, Write, Edit, Bash, Grep, Glob
+inputs:
+  - "one slice from .godpowers/build/PLAN.md"
+  - "relevant architecture excerpts"
+  - ".godpowers/stack/DECISION.md"
+outputs:
+  - "source code changes"
+  - "tests and regression coverage"
+  - "request-trace closeout"
+gates:
+  - "RED-GREEN-REFACTOR sequence"
+  - "full test suite and lint for the slice"
+  - "requirement id annotations"
+handoff:
+  - "return changed files and verification results to orchestrator without committing"
 ---
 
 # God Executor

package/agents/god-explorer.md

@@ -7,6 +7,20 @@ description: |
 
   Spawned by: /god-explore
 tools: Read, Write, Bash, WebSearch
+inputs:
+  - "free-form user intent"
+  - "optional existing artifacts"
+  - "optional domain glossary"
+outputs:
+  - ".godpowers/explore/<slug>.md"
+  - ".godpowers/discussions/<topic>.md"
+  - "optional domain glossary update"
+gates:
+  - "clarified problem framing"
+  - "hidden assumptions surfaced"
+  - "no PRD or architecture overreach"
+handoff:
+  - "return clarified framing and suggested PRD seed"
 ---
 
 # God Explorer

package/agents/god-greenfieldifier.md

@@ -7,6 +7,19 @@ description: |
 
   Spawned by: brownfield-arc, bluefield-arc, god-orchestrator
 tools: Read, Write, Edit, Bash, Grep, Glob
+inputs:
+  - "greenfield simulation audit"
+  - ".godpowers/state.json"
+  - "canonical Godpowers artifacts"
+outputs:
+  - "controlled artifact migration plan"
+  - "approved canonical artifact updates"
+gates:
+  - "user approval before rewriting artifacts"
+  - "state.json handoff authority"
+  - "greenfieldification rules"
+handoff:
+  - "return migrated artifacts and remaining brownfield or bluefield gaps"
 ---
 
 # God Greenfieldifier

package/agents/god-harden-auditor.md

@@ -7,6 +7,18 @@ description: |
 
   Spawned by: /god-harden, god-orchestrator
 tools: Read, Bash, Grep, Glob, WebSearch
+inputs:
+  - "codebase"
+  - ".godpowers/state.json deploy evidence"
+  - "optional org security standards"
+outputs:
+  - ".godpowers/harden/FINDINGS.md"
+gates:
+  - "H-01 through H-11 have-nots"
+  - "Critical findings block launch"
+  - "manual adversarial review"
+handoff:
+  - "return security findings and block launch on unresolved Critical issues"
 ---
 
 # God Harden Auditor

package/agents/god-incident-investigator.md

@@ -8,6 +8,19 @@ description: |
 
   Spawned by: /god-postmortem
 tools: Read, Write, Edit, Bash, Grep, Glob
+inputs:
+  - "logs and events"
+  - "git history"
+  - "hotfix commit"
+  - "optional handoff"
+outputs:
+  - ".godpowers/postmortems/<id>/POSTMORTEM.md"
+  - "runbook update recommendations"
+gates:
+  - "PM-01 through PM-08 have-nots"
+  - "timeline and class-of-bug evidence"
+handoff:
+  - "return postmortem path, action items, and prevention class"
 ---
 
 # God Incident Investigator

package/agents/god-launch-strategist.md

@@ -7,6 +7,20 @@ description: |
 
   Spawned by: /god-launch, god-orchestrator
 tools: Read, Write, Edit, Bash, Grep, WebSearch
+inputs:
+  - ".godpowers/prd/PRD.md"
+  - ".godpowers/harden/FINDINGS.md"
+  - ".godpowers/state.json launch prerequisites"
+outputs:
+  - ".godpowers/state.json launch evidence"
+  - "landing copy and channel messaging"
+  - "D-7 to D+7 launch runbook"
+gates:
+  - "L-01 through L-08 have-nots"
+  - "no unresolved Critical harden findings"
+  - "launch state evidence is complete"
+handoff:
+  - "return launch evidence and pause only for human-only brand choices"
 ---
 
 # God Launch Strategist

package/agents/god-migration-strategist.md

@@ -7,6 +7,19 @@ description: |
 
   Spawned by: /god-upgrade
 tools: Read, Write, Edit, Bash, Grep, Glob, WebSearch
+inputs:
+  - "migration target"
+  - ".godpowers/state.json build evidence"
+  - "upstream changelog"
+outputs:
+  - ".godpowers/migrations/<slug>/MIGRATION.md"
+  - "phased migration plan"
+gates:
+  - "MG-01 through MG-07 have-nots"
+  - "expand-contract rollout safety"
+  - "migration test coverage evidence"
+handoff:
+  - "return migration plan, executor slices, and rollout blockers"
 ---
 
 # God Migration Strategist

package/agents/god-observability-engineer.md

@@ -7,6 +7,20 @@ description: |
 
   Spawned by: /god-observe, god-orchestrator
 tools: Read, Write, Edit, Bash, Grep, Glob
+inputs:
+  - ".godpowers/prd/PRD.md success metrics"
+  - ".godpowers/arch/ARCH.md"
+  - ".godpowers/state.json deploy evidence"
+outputs:
+  - ".godpowers/state.json observability evidence"
+  - "alert and dashboard configs"
+  - "runbooks"
+gates:
+  - "OB-01 through OB-08 have-nots"
+  - "real SLOs and symptom alerts"
+  - "observability evidence is complete"
+handoff:
+  - "return observability evidence and metric readiness summary"
 ---
 
 # God Observability Engineer

package/agents/god-orchestrator.md

@@ -8,6 +8,20 @@ description: |
 
   Spawned by: /god-mode
 tools: Read, Write, Edit, Bash, Grep, Glob, Task
+inputs:
+  - "user intent or private handoff"
+  - ".godpowers/state.json"
+  - "routing and workflow definitions"
+outputs:
+  - ".godpowers/state.json mutations"
+  - ".godpowers/PROGRESS.md generated view refresh"
+  - "specialist agent handoffs"
+gates:
+  - "state-lock contract"
+  - "specialist gate checks"
+  - "mandatory final sync"
+handoff:
+  - "spawn specialists in tier order and return dashboard closeout to user"
 ---
 
 # God Orchestrator
@@ -81,8 +95,8 @@ Use this agent file as the concise dispatch contract:
    artifacts as the decision source of truth.
 3. Spawn specialist agents for heavy work instead of doing tier work yourself.
 4. Keep each mutation inside the state-lock contract from the runbook.
-5. Verify each produced artifact on disk, run the configured standards or
-   have-nots gate, then refresh state and checkpoint files.
+5. Verify each produced artifact on disk, run the configured standards,
+   have-nots, and executable gate, then refresh state and checkpoint files.
 6. Run repair loops for mechanical failures before declaring progress.
 7. Pause only for human-only choices, unresolved Critical harden findings,
    impossible routing contradictions, or explicit external access needs.

package/agents/god-org-context-loader.md

@@ -7,6 +7,17 @@ description: |
 
   Spawned by: /god-org-context, bluefield-arc workflow
 tools: Read, Write, Edit, Bash, Grep, Glob
+inputs:
+  - "organization standards input"
+  - "auto-detected org files"
+  - "bluefield workflow request"
+outputs:
+  - ".godpowers/org-context.yaml"
+gates:
+  - "org-context have-nots"
+  - "constraints grounded in detected or provided evidence"
+handoff:
+  - "return org-context path and constraints for downstream agents"
 ---
 
 # God Org Context Loader

package/agents/god-planner.md

@@ -8,6 +8,17 @@ description: |
 
   Spawned by: /god-build, god-orchestrator (before god-executor waves)
 tools: Read, Write, Bash, Grep, Glob
+inputs:
+  - ".godpowers/roadmap/ROADMAP.md"
+  - ".godpowers/arch/ARCH.md"
+  - ".godpowers/stack/DECISION.md"
+outputs:
+  - ".godpowers/build/PLAN.md"
+gates:
+  - "vertical slices with test-first sequence"
+  - "dependency and verification criteria coverage"
+handoff:
+  - "return wave plan for executor and reviewer spawns"
 ---
 
 # God Planner

package/agents/god-pm.md

@@ -7,6 +7,20 @@ description: |
 
   Spawned by: /god-prd, god-orchestrator
 tools: Read, Write, Bash, Grep
+inputs:
+  - "user intent"
+  - ".godpowers/intent.yaml"
+  - "optional preparation context"
+  - "templates/PRD.md"
+outputs:
+  - ".godpowers/prd/PRD.md"
+  - ".godpowers/prd/PRD.meta.json"
+gates:
+  - "P-01 through P-15 have-nots"
+  - "substitution test"
+  - "three-label sentence discipline"
+handoff:
+  - "return PRD and pause only for ambiguous problem or conflicting requirements"
 ---
 
 # God PM

package/agents/god-quality-reviewer.md

@@ -7,6 +7,18 @@ description: |
 
   Spawned by: god-orchestrator (after god-spec-reviewer passes)
 tools: Read, Bash, Grep, Glob
+inputs:
+  - "executor code diff"
+  - "repository quality conventions"
+  - "verification evidence"
+outputs:
+  - "stage 2 PASS or FAIL verdict"
+  - "quality findings"
+gates:
+  - "readability, security, error handling, performance, and maintainability review"
+  - "fresh-context independence"
+handoff:
+  - "return verdict to orchestrator for repair or atomic commit"
 ---
 
 # God Quality Reviewer (Stage 2)

package/agents/god-reconciler.md

@@ -10,6 +10,19 @@ description: |
 
   Spawned by: /god-reconcile, recipe execution (feature-addition category)
 tools: Read, Bash, Grep, Glob, Task
+inputs:
+  - "all core Godpowers artifacts"
+  - "repository docs and surface"
+  - "feature awareness and host capability evidence"
+outputs:
+  - "multi-dimensional reconciliation verdict"
+  - "optional .godpowers/reconciliation/ report"
+gates:
+  - "all relevant surfaces checked"
+  - "missing artifacts handled explicitly"
+  - "no false all-covered claim"
+handoff:
+  - "return synthesis recommendation and preflight commands to caller"
 ---
 
 # God Reconciler
@@ -59,7 +72,7 @@ For each artifact below, check (in parallel where possible):
 
 #### ROADMAP (`.godpowers/roadmap/ROADMAP.md`)
 - Already-done / in-progress / enhancement / prerequisite-needed / new / ambiguous
-- (Same as god-roadmap-reconciler, integrated)
+- Use the integrated ROADMAP classification logic for milestone overlap.
 
 #### STACK (`.godpowers/stack/DECISION.md`)
 - Does the feature require a new dependency category? (e.g., adding a queue when none exists)

package/agents/god-reconstructor.md

@@ -7,6 +7,22 @@ description: |
 
   Spawned by: /god-reconstruct, brownfield-arc workflow
 tools: Read, Write, Edit, Bash, Grep, Glob
+inputs:
+  - "brownfield codebase"
+  - "optional archaeology report"
+  - "existing docs and tests"
+outputs:
+  - ".godpowers/prd/PRD.md"
+  - ".godpowers/arch/ARCH.md"
+  - ".godpowers/roadmap/ROADMAP.md"
+  - ".godpowers/stack/DECISION.md"
+  - ".godpowers/RECONSTRUCTION-LOG.md"
+gates:
+  - "per-tier have-nots"
+  - "confidence levels on reconstructed claims"
+  - "stakeholder review recommendation"
+handoff:
+  - "return reconstructed artifacts and prominent uncertainty warnings"
 ---
 
 # God Reconstructor

package/agents/god-repo-scaffolder.md

@@ -7,6 +7,17 @@ description: |
 
   Spawned by: /god-repo, god-orchestrator
 tools: Read, Write, Edit, Bash, Glob
+inputs:
+  - ".godpowers/stack/DECISION.md"
+  - "optional .godpowers/org-context.yaml"
+outputs:
+  - ".godpowers/repo/AUDIT.md"
+  - "production repository scaffold files"
+gates:
+  - "RP-01 through RP-08 have-nots"
+  - "CI passes on empty scaffold"
+handoff:
+  - "return scaffold audit and repo readiness status"
 ---
 
 # God Repo Scaffolder

package/agents/god-retrospective.md

@@ -6,6 +6,17 @@ description: |
 
   Spawned by: /god-sprint retro
 tools: Read, Write, Bash, Grep, Glob
+inputs:
+  - "sprint plan"
+  - "build state evidence"
+  - "git log and events"
+outputs:
+  - ".godpowers/sprints/sprint-<n>/RETRO.md"
+gates:
+  - "retrospective have-nots"
+  - "specific action items with owners and due dates"
+handoff:
+  - "return retro path and next-sprint improvement actions"
 ---
 
 # God Retrospective