godpowers 0.15.7 → 0.15.8

package/CHANGELOG.md

@@ -5,6 +5,27 @@ 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.8] - 2026-05-11
+
+Init preparation release. Documents what Godpowers found before PRD, next-step
+routing, or the full autonomous arc starts.
+
+### Added
+- `/god-init` now always creates `.godpowers/prep/INITIAL-FINDINGS.md` with
+  codebase shape, framework and tooling signals, tests, CI, docs, AI-tool
+  instructions, detected methodology systems, risks, and the suggested next
+  command rationale.
+- `/god-prd`, `/god-next`, and `/god-mode` now read initial findings before
+  choosing or producing the next Godpowers artifact.
+- Architecture, roadmap, and stack agents now read initial findings alongside
+  imported planning context when present.
+
+### Documented
+- The full recent init preparation flow is now documented together:
+  automatic AI-tool context for explicit `god init`, quiet context writes,
+  GSD / Superpowers / BMAD import into `IMPORTED-CONTEXT.md`, and direct
+  Godpowers repo findings in `INITIAL-FINDINGS.md`.
+
 ## [0.15.7] - 2026-05-11
 
 Planning import release. Lets `/god-init` preserve useful context from nearby

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.7-blue)](CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-0.15.8-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-architect.md

@@ -19,11 +19,17 @@ flip points.
 Before starting:
 - `.godpowers/prd/PRD.md` MUST exist
 - PRD MUST pass have-nots (run god-auditor first if uncertain)
+- Optional: `.godpowers/prep/INITIAL-FINDINGS.md` may exist as preparation
+  context.
 - Optional: `.godpowers/prep/IMPORTED-CONTEXT.md` may exist as preparation
   context.
 
 ## Imported Preparation Context
 
+If `.godpowers/prep/INITIAL-FINDINGS.md` exists, read it first for direct
+Godpowers observations about framework, tooling, deploy, tests, docs, and
+codebase risks.
+
 If `.godpowers/prep/IMPORTED-CONTEXT.md` exists, read its technical signals
 before drafting ARCH. Use imported architecture, integration, risk, and stack
 constraints as hypothesis-level input only.

package/agents/god-orchestrator.md

@@ -30,8 +30,9 @@ You and only you are responsible for:
 2. **Calling the play** - selecting the next specialist agent for each tier
    sub-step from `<runtimeRoot>/routing/<command>.yaml`.
 3. **Owning the playbook** - all writes to `state.json`, `PROGRESS.md`,
-   `intent.yaml`, `.godpowers/prep/IMPORTED-CONTEXT.md`, and `events.jsonl`
-   originate from you or agents you spawn.
+   `intent.yaml`, `.godpowers/prep/INITIAL-FINDINGS.md`,
+   `.godpowers/prep/IMPORTED-CONTEXT.md`, and `events.jsonl` originate from you
+   or agents you spawn.
 4. **Audibles** - handling pause checkpoints, the critical-finding gate, and
    the --yolo carve-out when the user has authorized auto-resolve.
 5. **Clock management** - mandatory final sync after Tier 3 (always, including
@@ -145,6 +146,20 @@ During `/god-init`, scan for adjacent methodology artifacts from GSD,
 Superpowers, BMAD, and similar systems. Treat them as preparation context,
 not as source of truth.
 
+Before or alongside that import, write `.godpowers/prep/INITIAL-FINDINGS.md`
+using `templates/INITIAL-FINDINGS.md`. This artifact records what Godpowers
+observed directly during init:
+- codebase shape, language, framework, package manager, tests, CI, deploy, and
+  documentation signals
+- AI-tool instruction files and methodology systems detected
+- risk signals and open questions raised by the scan
+- the suggested next command and why that command is the safest next step
+
+Downstream `/god-prd`, `/god-next`, and `/god-mode` flows must read
+`INITIAL-FINDINGS.md` when present. Use it as preparation context only. If it
+conflicts with user intent, state.json, PROGRESS.md, or completed Godpowers
+artifacts, the Godpowers artifact wins.
+
 Detection signals:
 - GSD: `.gsd/`, `.planning/`, `GSD.md`, `gsd*.md`
 - Superpowers: `.superpowers/`, `superpowers/`, `SUPERPOWERS.md`,

package/agents/god-pm.md

@@ -31,6 +31,10 @@ required sections:
 
 ## Imported Preparation Context
 
+If `.godpowers/prep/INITIAL-FINDINGS.md` exists, read it first so the PRD
+reflects what Godpowers observed during init: codebase shape, tests, docs,
+risks, and methodology systems detected.
+
 If `.godpowers/prep/IMPORTED-CONTEXT.md` exists, read it before drafting the
 PRD. Use product signals from GSD, Superpowers, BMAD, or similar systems as
 hypothesis-level input only.

package/agents/god-roadmapper.md

@@ -16,11 +16,16 @@ Sequence the work.
 ## Gate Check
 
 `.godpowers/arch/ARCH.md` MUST exist and pass have-nots.
+Optional: `.godpowers/prep/INITIAL-FINDINGS.md` may exist as preparation
+context.
 Optional: `.godpowers/prep/IMPORTED-CONTEXT.md` may exist as preparation
 context.
 
 ## Imported Preparation Context
 
+If `.godpowers/prep/INITIAL-FINDINGS.md` exists, read it first for repo risks,
+existing tests, docs, CI, deploy, and suggested sequencing implications.
+
 If `.godpowers/prep/IMPORTED-CONTEXT.md` exists, read its delivery signals
 before sequencing milestones. Use imported GSD, Superpowers, BMAD, or similar
 stories and plans as hypothesis-level input only.

package/agents/god-stack-selector.md

@@ -15,11 +15,16 @@ Pick the technology stack.
 ## Gate Check
 
 `.godpowers/arch/ARCH.md` MUST exist.
+Optional: `.godpowers/prep/INITIAL-FINDINGS.md` may exist as preparation
+context.
 Optional: `.godpowers/prep/IMPORTED-CONTEXT.md` may exist as preparation
 context.
 
 ## Imported Preparation Context
 
+If `.godpowers/prep/INITIAL-FINDINGS.md` exists, read it first for direct
+tooling, package manager, framework, runtime, CI, and deploy observations.
+
 If `.godpowers/prep/IMPORTED-CONTEXT.md` exists, read its technical and stack
 signals before scoring candidates. Use imported technology choices, constraints,
 and team familiarity as hypothesis-level input only.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "godpowers",
-  "version": "0.15.7",
+  "version": "0.15.8",
   "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/routing/god-arch.yaml

@@ -19,6 +19,7 @@ execution:
   context: fresh
   reads:
     - .godpowers/prd/PRD.md
+    - .godpowers/prep/INITIAL-FINDINGS.md
     - .godpowers/prep/IMPORTED-CONTEXT.md
     - templates/ARCH.md
   writes:

package/routing/god-init.yaml

@@ -19,6 +19,7 @@ execution:
     - .godpowers/PROGRESS.md
     - .godpowers/state.json
     - .godpowers/intent.yaml
+    - .godpowers/prep/INITIAL-FINDINGS.md
     - .godpowers/prep/IMPORTED-CONTEXT.md
 
 success-path:

package/routing/god-mode.yaml

@@ -14,6 +14,9 @@ prerequisites:
 execution:
   spawns: [god-orchestrator]
   context: fresh
+  reads:
+    - .godpowers/prep/INITIAL-FINDINGS.md
+    - .godpowers/prep/IMPORTED-CONTEXT.md
   secondary-spawns: [god-pm, god-architect, god-roadmapper, god-stack-selector, god-repo-scaffolder, god-planner, god-executor, god-spec-reviewer, god-quality-reviewer, god-deploy-engineer, god-observability-engineer, god-harden-auditor, god-launch-strategist]
   writes:
     []

package/routing/god-next.yaml

@@ -12,6 +12,9 @@ prerequisites:
 execution:
   spawns: [built-in]
   context: fresh
+  reads:
+    - .godpowers/prep/INITIAL-FINDINGS.md
+    - .godpowers/prep/IMPORTED-CONTEXT.md
   writes:
     []
 

package/routing/god-prd.yaml

@@ -21,6 +21,7 @@ execution:
   context: fresh
   reads:
     - .godpowers/intent.yaml
+    - .godpowers/prep/INITIAL-FINDINGS.md
     - .godpowers/prep/IMPORTED-CONTEXT.md
     - templates/PRD.md
   writes:

package/routing/god-roadmap.yaml

@@ -17,6 +17,7 @@ execution:
   reads:
     - .godpowers/prd/PRD.md
     - .godpowers/arch/ARCH.md
+    - .godpowers/prep/INITIAL-FINDINGS.md
     - .godpowers/prep/IMPORTED-CONTEXT.md
     - templates/ROADMAP.md
   writes:

package/routing/god-stack.yaml

@@ -16,6 +16,7 @@ execution:
   context: fresh
   reads:
     - .godpowers/arch/ARCH.md
+    - .godpowers/prep/INITIAL-FINDINGS.md
     - .godpowers/prep/IMPORTED-CONTEXT.md
   writes:
     - .godpowers/stack/DECISION.md

package/skills/god-init.md

@@ -30,6 +30,10 @@ needs to specify a mode.
    - Look for org-level context (current dir + parent dirs):
      - .godpowers/org-context.yaml
      - Workspace configs that share standards
+   - Write `.godpowers/prep/INITIAL-FINDINGS.md` summarizing what Godpowers
+     observed about the repo, tooling, docs, tests, risks, and suggested next
+     command. This happens before `/god-prd`, `/god-next`, or `/god-mode`
+     continues.
    - Look for adjacent planning-system context:
      - GSD: `.gsd/`, `.planning/`, `GSD.md`, `gsd*.md`
      - Superpowers: `.superpowers/`, `superpowers/`, `SUPERPOWERS.md`,
@@ -57,6 +61,7 @@ needs to specify a mode.
    The orchestrator will:
    - Run Mode Detection (announced in plain English; stored as A/B/C/E internally)
    - Run Scale Detection (trivial/small/medium/large/enterprise)
+   - Write `.godpowers/prep/INITIAL-FINDINGS.md`
    - Run planning-system context detection for GSD, Superpowers, and BMAD
    - Write `.godpowers/prep/IMPORTED-CONTEXT.md` when useful context exists
    - For brownfield: schedule archaeology + reconstruction as preflight
@@ -77,6 +82,7 @@ needs to specify a mode.
    .godpowers/
      PROGRESS.md
      prep/
+       INITIAL-FINDINGS.md
        IMPORTED-CONTEXT.md   # only when GSD / Superpowers / BMAD context exists
      prd/
      arch/
@@ -112,6 +118,12 @@ needs to specify a mode.
 
 `.godpowers/PROGRESS.md` created with initial state.
 
+Always create `.godpowers/prep/INITIAL-FINDINGS.md`. This is Godpowers'
+durable answer to "what did init find in this codebase?" It captures codebase
+shape, framework and tooling signals, tests, CI, docs, AI-tool files, detected
+methodology systems, risk signals, and the reasoning behind the suggested next
+command.
+
 If GSD, Superpowers, BMAD, or similar planning context is detected, create
 `.godpowers/prep/IMPORTED-CONTEXT.md`. This artifact is preparation context,
 not source of truth. It feeds PRD, architecture, roadmap, and stack decisions

package/skills/god-mode.md

@@ -47,6 +47,9 @@ You are receiving a /god-mode invocation. Your job is to spawn the
    - The detected mode (A/B/C/E)
    - The active flags
    - Instruction to read `.godpowers/PROGRESS.md` from disk if it exists
+   - Instruction to read `.godpowers/prep/INITIAL-FINDINGS.md` and
+     `.godpowers/prep/IMPORTED-CONTEXT.md` if present before choosing the
+     first planning or build step
 
 6. Orchestrator runs the appropriate workflow:
    - Greenfield -> full-arc

package/skills/god-next.md

@@ -39,6 +39,12 @@ if any are missing.
 User just ran /god-next. Auto-detects current project phase and suggests
 the next logical command.
 
+Before suggesting, read `.godpowers/prep/INITIAL-FINDINGS.md` and
+`.godpowers/prep/IMPORTED-CONTEXT.md` if present. Use them to explain why the
+next step is safe or why a migration-aware step such as `/god-prd`,
+`/god-map-codebase`, or `/god-mode` is better. Prep artifacts are context only;
+state.json and completed Godpowers artifacts remain authoritative.
+
 ## Process for Mode 1 (post-completion)
 
 ```

package/skills/god-prd.md

@@ -14,10 +14,13 @@ Spawn the **god-pm** agent in a fresh context via Task tool.
 ## Setup
 
 1. If `.godpowers/PROGRESS.md` does not exist: tell the user to run `/god-init` first
-2. Otherwise: spawn god-pm with the user's project description from PROGRESS.md
-3. The agent writes `.godpowers/prd/PRD.md`
-4. The agent runs have-nots checks before declaring done
-5. If god-pm pauses for a human question: relay to user using pause format
+2. Read `.godpowers/prep/INITIAL-FINDINGS.md` if present.
+3. Read `.godpowers/prep/IMPORTED-CONTEXT.md` if present.
+4. Spawn god-pm with the user's project description from PROGRESS.md plus any
+   prep artifacts. Prep artifacts are context, not source of truth.
+5. The agent writes `.godpowers/prd/PRD.md`
+6. The agent runs have-nots checks before declaring done
+7. If god-pm pauses for a human question: relay to user using pause format
 
 ## Verification
 

package/templates/INITIAL-FINDINGS.md

@@ -0,0 +1,52 @@
+# Initial Findings
+
+> This artifact records what Godpowers observed during `/god-init`. It is
+> preparation documentation for planning, routing, and migration. Godpowers
+> state and completed artifacts remain authoritative after they exist.
+
+## Codebase Shape
+
+- [HYPOTHESIS] Project type: [greenfield / brownfield / bluefield / audit].
+- [HYPOTHESIS] Scale: [trivial / small / medium / large / enterprise].
+- [HYPOTHESIS] Primary language or runtime: [detected value].
+- [HYPOTHESIS] Framework or app model: [detected value].
+- [HYPOTHESIS] Package manager or build tool: [detected value].
+
+## Repo Signals
+
+- [HYPOTHESIS] Source directories found: [paths].
+- [HYPOTHESIS] Test signals found: [paths or "none detected"].
+- [HYPOTHESIS] CI or release signals found: [paths or "none detected"].
+- [HYPOTHESIS] Deployment signals found: [paths or "none detected"].
+- [HYPOTHESIS] Documentation signals found: [paths or "none detected"].
+
+## Methodology And AI Tool Signals
+
+- [HYPOTHESIS] AI instruction files found: [paths or "none detected"].
+- [HYPOTHESIS] GSD context found: [paths or "none detected"].
+- [HYPOTHESIS] Superpowers context found: [paths or "none detected"].
+- [HYPOTHESIS] BMAD context found: [paths or "none detected"].
+- [HYPOTHESIS] Imported context artifact: [.godpowers/prep/IMPORTED-CONTEXT.md or "not created"].
+
+## Planning Implications
+
+- [HYPOTHESIS] PRD should pay attention to: [product or user signal].
+- [HYPOTHESIS] Architecture should pay attention to: [technical or risk signal].
+- [HYPOTHESIS] Roadmap should pay attention to: [delivery or dependency signal].
+- [HYPOTHESIS] Stack should pay attention to: [tooling or constraint signal].
+
+## Risks And Unknowns
+
+- [OPEN QUESTION] [Question raised by repo scan] -- Owner: user -- Due: before the relevant planning step.
+- [HYPOTHESIS] Risk signal: [missing tests / unclear deploy path / stale docs / conflicting planning systems].
+
+## Suggested Next
+
+- [DECISION] Suggested next command: [/god-prd / /god-map-codebase / /god-mode / /god-next].
+- [DECISION] Reason: [why this command is the safest next step based on findings].
+
+## Use Rules
+
+- [DECISION] Downstream agents may use this artifact as preparation context only.
+- [DECISION] If this artifact conflicts with `.godpowers/intent.yaml`, `.godpowers/state.json`, `PROGRESS.md`, or a completed Godpowers artifact, the Godpowers artifact wins.
+- [DECISION] Imported GSD, Superpowers, and BMAD signals must be converted into Godpowers-native artifacts, not preserved as parallel state.