godpowers 0.15.14 → 0.15.16

package/CHANGELOG.md

@@ -5,6 +5,35 @@ All notable changes to Godpowers will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.15.16] - 2026-05-11
+
+Greenfield simulation audit release. Adds a preparation audit to brownfield
+and bluefield arcs so they can compare existing evidence or org constraints
+against the canonical Godpowers greenfield process.
+
+### Changed
+- Brownfield arc now runs a greenfield simulation audit after archaeology,
+  reconstruction, debt assessment, and normal artifact audit.
+- Bluefield arc now runs a greenfield simulation audit after org-context and
+  before PRD so downstream planning can inherit org constraints intentionally.
+- `god-auditor` now documents `mode: greenfield-simulation`, writing
+  `.godpowers/audit/GREENFIELD-SIMULATION.md` without rewriting planning
+  artifacts.
+
+## [0.15.15] - 2026-05-11
+
+Transcript hygiene release. Keeps God Mode orchestration scaffolding out of the
+normal user-visible transcript.
+
+### Changed
+- Added a User-Visible Transcript Contract to `/god-mode` and
+  `god-orchestrator`.
+- God Mode now explicitly hides raw Task input, "Hard instructions", spawned
+  agent prompts, complete file loadout lists, and internal routing metadata from
+  the user-facing transcript.
+- Private rules that affect a pause must be translated into the smallest
+  user-facing question instead of exposing the underlying prompt.
+
 ## [0.15.14] - 2026-05-11
 
 Origin evidence release. Prevents `/god-mode --yolo` from inventing staging,

package/README.md

@@ -2,7 +2,7 @@
 
 [![CI](https://github.com/aihxp/godpowers/actions/workflows/ci.yml/badge.svg)](https://github.com/aihxp/godpowers/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
-[![Version](https://img.shields.io/badge/version-0.15.14-blue)](CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-0.15.16-blue)](CHANGELOG.md)
 [![npm](https://img.shields.io/npm/v/godpowers.svg)](https://www.npmjs.com/package/godpowers)
 
 **Ship fast. Ship right. Ship everything. Ship accountably.**

package/agents/god-auditor.md

@@ -31,6 +31,9 @@ Score artifacts. Build nothing. Report what fails and why.
 4. If running for orchestrator gate check: return verdict only (any
    error from mechanical pass = FAIL; any critical interpretive = FAIL).
 5. If running for /god-audit: produce full report combining both passes.
+6. If running with `mode: greenfield-simulation`, do not build anything.
+   Simulate the canonical Godpowers greenfield arc and compare it against the
+   current project evidence or org constraints.
 
 ## Mechanical vs interpretive split
 
@@ -148,3 +151,56 @@ Overall: 85%
 
 For gate check (called by orchestrator): return PASS/FAIL with first failure
 only (orchestrator wants speed, not full report).
+
+For greenfield simulation audit, write
+`.godpowers/audit/GREENFIELD-SIMULATION.md`:
+
+```markdown
+# Greenfield Simulation Audit
+
+Date: [timestamp]
+Mode: [brownfield | bluefield]
+
+## Simulated Canonical Arc
+- PRD: [what a clean Godpowers PRD would need]
+- Design: [whether DESIGN.md should exist before ARCH]
+- ARCH: [expected architecture decisions]
+- ROADMAP: [expected sequencing]
+- STACK: [expected stack decision points]
+- REPO: [expected repo setup]
+- BUILD: [expected vertical-slice delivery]
+- DEPLOY: [expected deploy and rollback gates]
+- OBSERVE: [expected SLOs and runbooks]
+- HARDEN: [expected security gates]
+- LAUNCH: [expected launch readiness gates]
+
+## Evidence Compared
+- [source path or org-context source]
+
+## Alignment
+| Area | Greenfield Expectation | Existing Evidence | Status |
+|---|---|---|---|
+| PRD | [expectation] | [evidence] | aligned / gap / unknown |
+
+## Gaps To Carry Forward
+- [DECISION/HYPOTHESIS/OPEN QUESTION] [gap and where it should influence PRD, ARCH, ROADMAP, BUILD, or shipping]
+
+## Non-Goals
+- This audit does not rewrite artifacts.
+- This audit does not treat imported GSD, Superpowers, BMAD, or org context as
+  source of truth.
+- This audit does not block the arc unless it finds a Critical security or
+  impossible planning contradiction.
+```
+
+Greenfield simulation rules:
+- Brownfield: compare reconstructed artifacts, archaeology, debt assessment,
+  repo shape, tests, CI, deploy, observability, hardening, and launch evidence
+  against what the canonical greenfield arc would have created.
+- Bluefield: compare org context and constraints against the canonical
+  greenfield arc before PRD so downstream agents know which choices are
+  constrained, missing, or open.
+- Label every finding as DECISION, HYPOTHESIS, or OPEN QUESTION.
+- Do not invent missing intent. Mark unknowns as OPEN QUESTION.
+- Do not overwrite PRD, ARCH, ROADMAP, STACK, or shipping artifacts. This audit
+  is preparation context for downstream steps.

package/agents/god-orchestrator.md

@@ -632,6 +632,32 @@ Options:
 Default: If you say "go", I'll pick [X] because [Y].
 ```
 
+## User-Visible Transcript Contract
+
+The user-facing God Mode transcript is an operator console, not a prompt
+debugger. Keep orchestration scaffolding private.
+
+Show:
+- concise phase status
+- durable state detected from disk
+- commands being run and whether they passed or failed
+- scoped file changes
+- final validation summary
+- `Arc complete` or `PAUSE: external access required`
+
+Hide:
+- raw Task input
+- "Hard instructions" sections
+- spawned-agent prompt text
+- system, developer, AGENTS.md, or internal policy recitations
+- complete file loadout lists
+- routing metadata unless it changes a user decision
+
+When a private rule affects a pause, translate it into the smallest
+user-facing question. Do not expose the rule itself. Example: ask for
+`STAGING_APP_URL=<deployed staging origin>` rather than showing the Shipping
+Closure Protocol.
+
 ## Resume Protocol
 
 On every invocation:
@@ -782,7 +808,8 @@ in a parent suite. The human-friendly label is what the user sees.
 ### Mode B: Brownfield / Gap-fill (auto-detected)
 - Existing code OR partial `.godpowers/` artifacts present
 - May or may not have org context
-- Default path: archaeology -> reconstruct -> debt-assess -> proceed
+- Default path: archaeology -> reconstruct -> debt-assess -> greenfield
+  simulation audit -> proceed
 
 **Detection logic (run this on every Mode B invocation)**:
 
@@ -851,6 +878,9 @@ Report findings to user before running any tier:
 - BUT org-context.yaml found (in current dir, parent, or grandparent)
 - Run full arc with all decisions constrained by org context
 - Spawn god-org-context-loader first to load constraints
+- Run greenfield simulation audit after org-context and before PRD so the arc
+  knows where canonical Godpowers defaults align with, conflict with, or are
+  constrained by org standards
 - All downstream agents (god-stack-selector, god-architect, god-deploy-engineer,
   god-observability-engineer, god-harden-auditor) receive the org-context
   and respect it

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "godpowers",
-  "version": "0.15.14",
+  "version": "0.15.16",
   "description": "AI-powered development system: 104 slash commands and 38 specialist agents that take a project from raw idea to hardened production. Runs inside Claude Code, Codex, Cursor, Windsurf, Gemini, and 10+ other AI coding tools.",
   "bin": {
     "godpowers": "./bin/install.js"

package/skills/god-audit.md

@@ -18,6 +18,19 @@ Spawn the **god-auditor** agent in a fresh context via Task tool.
    artifact against `references/HAVE-NOTS.md`."
 3. The agent writes `.godpowers/AUDIT-REPORT.md`
 
+## Greenfield Simulation Mode
+
+When invoked by `brownfield-arc` or `bluefield-arc` with
+`mode: greenfield-simulation`, spawn god-auditor with the current project
+evidence and ask it to compare the repo or org constraints against the
+canonical Godpowers greenfield arc. The agent writes
+`.godpowers/audit/GREENFIELD-SIMULATION.md`.
+
+This mode builds nothing and rewrites no planning artifacts. It exists so
+brownfield and bluefield projects can benefit from the same PRD, design, arch,
+roadmap, stack, build, deploy, observe, harden, and launch expectations that a
+greenfield Godpowers run would have applied.
+
 ## Verification
 
 After god-auditor returns:

package/skills/god-mode.md

@@ -95,17 +95,49 @@ You are receiving a /god-mode invocation. Your job is to spawn the
      name, repo name, README title, or brand name. If no deployed origin is
      evidenced, pause for `STAGING_APP_URL=<deployed staging origin>`.
 
-6. Orchestrator runs the appropriate workflow:
+6. Keep the spawn payload private. Do not echo or summarize raw Task input,
+   "Hard instructions", hidden orchestration rules, agent prompts, file
+   loadout lists, or internal routing payloads into the user-visible transcript.
+   The visible transcript may say only what phase is running, what durable state
+   was detected, what commands are running, what changed, and the final
+   `Arc complete` or `PAUSE: external access required` block.
+
+7. Orchestrator runs the appropriate workflow:
    - Greenfield -> full-arc
-   - Brownfield -> brownfield-arc (archaeology -> reconstruct -> debt-assess -> proceed)
-   - Bluefield -> bluefield-arc (org-context -> arc with constraints)
+   - Brownfield -> brownfield-arc (archaeology -> reconstruct -> debt-assess -> greenfield simulation audit -> proceed)
+   - Bluefield -> bluefield-arc (org-context -> greenfield simulation audit -> arc with constraints)
 
-7. Relay the orchestrator's output to the user.
+8. Relay only the orchestrator's user-facing output to the user. If the
+   platform displays raw spawn details automatically, immediately follow with a
+   clean public summary and never repeat the leaked payload.
 
-8. When the orchestrator pauses, present the question to the user using the
+9. When the orchestrator pauses, present the question to the user using the
    pause format (What / Why / Options / Default).
 
-9. When the user answers, re-spawn god-orchestrator with the answer.
+10. When the user answers, re-spawn god-orchestrator with the answer.
+
+## User-Visible Transcript Contract
+
+The God Mode transcript is an operator console, not a prompt debugger.
+
+Show:
+- detected resume or project mode in plain language
+- short progress updates for phases, commands, validations, and file edits
+- concise validation summaries instead of full command noise when possible
+- final changed paths, validation results, and completion or pause status
+
+Hide:
+- raw Task input
+- "Hard instructions" sections
+- spawned-agent prompt text
+- system, developer, or AGENTS.md rule recitations
+- complete file loadout lists
+- internal routing metadata unless it directly affects a user decision
+
+If an internal instruction must influence a pause, translate it into the
+smallest user-facing question. For example, ask for
+`STAGING_APP_URL=<deployed staging origin>` instead of exposing the full
+Shipping Closure Protocol.
 
 ## Pause Format (relay from orchestrator)
 

package/workflows/bluefield-arc.yaml

@@ -7,10 +7,11 @@ apiVersion: godpowers/v1
 kind: Workflow
 metadata:
   name: bluefield-arc
-  version: 1.0.0
+  version: 1.1.0
   description: |
     Bluefield: new code, existing org context. Loads org standards first,
-    then runs full-arc with all decisions constrained by org context.
+    runs a greenfield simulation audit against those constraints, then runs
+    full-arc with all decisions constrained by org context.
 
 on: [/god-bluefield, /god-mode --bluefield]
 
@@ -19,9 +20,18 @@ jobs:
     tier: 0
     uses: god-org-context-loader@^1.0.0
 
+  greenfield-simulation-audit:
+    tier: 0
+    needs: org-context
+    uses: god-auditor@^1.0.0
+    with:
+      mode: greenfield-simulation
+      compare: canonical-godpowers-arc-to-org-constraints
+      output: .godpowers/audit/GREENFIELD-SIMULATION.md
+
   prd:
     tier: 1
-    needs: org-context
+    needs: greenfield-simulation-audit
     uses: god-pm@^1.0.0
 
   arch:

package/workflows/brownfield-arc.yaml

@@ -7,10 +7,11 @@ apiVersion: godpowers/v1
 kind: Workflow
 metadata:
   name: brownfield-arc
-  version: 1.0.0
+  version: 1.1.0
   description: |
     Brownfield: existing codebase, understand before changing. Archaeology +
-    reconstruction + debt assessment, then proceed with normal arc workflows.
+    reconstruction + debt assessment + greenfield simulation audit, then
+    proceed with normal arc workflows.
 
 on: [/god-brownfield, /god-mode --brownfield]
 
@@ -36,9 +37,18 @@ jobs:
     with:
       mode: full-audit-on-reconstructed
 
-  steady-state-handoff:
+  greenfield-simulation-audit:
     tier: 0
     needs: audit
+    uses: god-auditor@^1.0.0
+    with:
+      mode: greenfield-simulation
+      compare: existing-codebase-to-canonical-godpowers-arc
+      output: .godpowers/audit/GREENFIELD-SIMULATION.md
+
+  steady-state-handoff:
+    tier: 0
+    needs: greenfield-simulation-audit
     uses: god-orchestrator@^1.0.0
     with:
       action: brownfield-to-steady