godpowers 0.15.6 → 0.15.8

package/CHANGELOG.md

@@ -5,6 +5,41 @@ 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
+planning systems without making those systems authoritative.
+
+### Added
+- `/god-init` now detects GSD, Superpowers, BMAD, and similar planning context
+  during project preparation.
+- Added `.godpowers/prep/IMPORTED-CONTEXT.md` as a non-authoritative
+  preparation artifact for imported product, delivery, architecture, and stack
+  signals.
+- PRD, architecture, roadmap, and stack agents now read imported context when
+  present and treat it as hypothesis-level supporting evidence.
+
 ## [0.15.6] - 2026-05-11
 
 Quiet init release. Keeps `/god-init` focused on the next useful command while

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.6-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,6 +19,27 @@ 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.
+
+Rules:
+- Do not let imported context override PRD NFRs or Godpowers state.
+- Convert useful imported signals into ADR context, tradeoffs, or open
+  questions.
+- If imported context conflicts with the PRD, the PRD wins and the conflict
+  becomes an `[OPEN QUESTION]`.
 
 ## Output
 

package/agents/god-orchestrator.md

@@ -30,7 +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`, 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
@@ -138,6 +140,49 @@ Before each tier, check whether this repo is part of a registered suite:
 3. Per-repo state.json remains the source of truth; never write to
    `.godpowers/suite/` directly (that's god-coordinator's surface).
 
+## Planning-system context import
+
+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`,
+  `.claude/skills/`, `.codex/skills/`
+- BMAD: `.bmad-core/`, `bmad-core/`, `.bmad/`, `BMAD.md`,
+  `docs/prd.md`, `docs/architecture.md`, `docs/roadmap.md`
+
+When signals are found:
+1. Read only likely planning files, not dependency folders or generated build
+   output.
+2. Summarize product, delivery, technical, risk, and already-built signals into
+   `.godpowers/prep/IMPORTED-CONTEXT.md` using `templates/IMPORTED-CONTEXT.md`.
+3. Label every imported claim as `[HYPOTHESIS]` unless the user directly stated
+   it during this session.
+4. Record source paths and confidence so downstream agents can decide how much
+   weight to give each signal.
+5. If imported context conflicts with Godpowers state, user intent, or a
+   completed Godpowers artifact, keep the Godpowers artifact as authoritative
+   and add an `[OPEN QUESTION]` to imported context.
+
+Downstream planning agents may read this artifact. They must cite it as
+supporting evidence only.
+
 ## Routing-Driven Decisions
 
 For routing decisions, consult `<runtimeRoot>/routing/<command>.yaml` files.

package/agents/god-pm.md

@@ -29,6 +29,26 @@ required sections:
 7. **Appetite** (time/resource/technical constraints)
 8. **Open Questions** (with owner and due date)
 
+## 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.
+
+Rules:
+- Do not copy imported text wholesale into the PRD.
+- Do not treat imported context as source of truth.
+- Convert relevant imported product signals into `[HYPOTHESIS]` requirements,
+  success metrics, scope notes, no-gos, or open questions.
+- If imported context conflicts with user intent or existing Godpowers state,
+  preserve the Godpowers state and add an `[OPEN QUESTION]`.
+- In PRD rationale, mention the source only when it materially changes a
+  requirement.
+
 ## Quality Gates
 
 Run these checks on every section before declaring done:

package/agents/god-roadmapper.md

@@ -16,6 +16,27 @@ 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.
+
+Rules:
+- Do not add roadmap features that are not grounded in the PRD.
+- Use imported milestones, stories, and done-work signals to inform ordering,
+  dependency edges, and open questions.
+- If imported context conflicts with PRD or ARCH, PRD and ARCH win.
+- Mark any imported sequencing assumption as `[HYPOTHESIS]` until confirmed by
+  Godpowers artifacts or the user.
 
 ## Process
 

package/agents/god-stack-selector.md

@@ -15,6 +15,25 @@ 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.
+
+Rules:
+- Do not let imported stack preference override ARCH NFRs or ADRs.
+- Treat imported technology choices as candidate evidence, not decisions.
+- If imported context conflicts with ARCH, ARCH wins and the conflict becomes a
+  stack open question.
 
 ## Process
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "godpowers",
-  "version": "0.15.6",
+  "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,8 @@ execution:
   context: fresh
   reads:
     - .godpowers/prd/PRD.md
+    - .godpowers/prep/INITIAL-FINDINGS.md
+    - .godpowers/prep/IMPORTED-CONTEXT.md
     - templates/ARCH.md
   writes:
     - .godpowers/arch/ARCH.md

package/routing/god-init.yaml

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

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,8 @@ execution:
   context: fresh
   reads:
     - .godpowers/intent.yaml
+    - .godpowers/prep/INITIAL-FINDINGS.md
+    - .godpowers/prep/IMPORTED-CONTEXT.md
     - templates/PRD.md
   writes:
     - .godpowers/prd/PRD.md

package/routing/god-roadmap.yaml

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

package/routing/god-stack.yaml

@@ -14,6 +14,10 @@ prerequisites:
 execution:
   spawns: [god-stack-selector]
   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,19 @@ 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`,
+       `.claude/skills/`, `.codex/skills/`
+     - BMAD: `.bmad-core/`, `bmad-core/`, `.bmad/`, `BMAD.md`,
+       `docs/prd.md`, `docs/architecture.md`, `docs/roadmap.md`
+   - If any are detected, summarize useful signals into
+     `.godpowers/prep/IMPORTED-CONTEXT.md` as preparation context.
+     Do not treat external planning-system files as source of truth.
 
 3. **Announce findings in plain English** (no jargon):
    - Empty dir + no org context: "Detected: empty directory. Starting fresh."
@@ -48,6 +61,9 @@ 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
    - For bluefield: load org-context as constraint
    - Create directory structure
@@ -65,6 +81,9 @@ needs to specify a mode.
    ```
    .godpowers/
      PROGRESS.md
+     prep/
+       INITIAL-FINDINGS.md
+       IMPORTED-CONTEXT.md   # only when GSD / Superpowers / BMAD context exists
      prd/
      arch/
        adr/
@@ -99,6 +118,17 @@ 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
+as hypothesis-level input only.
+
 ## AI-tool context (automatic for explicit init)
 
 After PROGRESS.md is written, decide from the trigger phrase:

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/IMPORTED-CONTEXT.md

@@ -0,0 +1,40 @@
+# Imported Preparation Context
+
+> This artifact captures non-authoritative context imported from adjacent
+> planning systems. Godpowers artifacts remain the source of truth after they
+> are created.
+
+## Sources Detected
+
+- [DECISION] Source system: [GSD / Superpowers / BMAD / other].
+- [DECISION] Source path: [relative path].
+- [HYPOTHESIS] Useful signal: [what this source appears to clarify].
+- [HYPOTHESIS] Confidence: [high / medium / low] because [brief reason].
+
+## Product Signals For PRD
+
+- [HYPOTHESIS] User or persona signal: [imported detail].
+- [HYPOTHESIS] Problem or outcome signal: [imported detail].
+- [HYPOTHESIS] Scope or no-go signal: [imported detail].
+- [OPEN QUESTION] Imported product ambiguity: [question] -- Owner: user -- Due: before /god-prd.
+
+## Delivery Signals For Roadmap
+
+- [HYPOTHESIS] Existing milestone or story signal: [imported detail].
+- [HYPOTHESIS] Dependency or sequencing signal: [imported detail].
+- [HYPOTHESIS] Done or already-built signal: [imported detail].
+- [OPEN QUESTION] Imported delivery ambiguity: [question] -- Owner: user -- Due: before /god-roadmap.
+
+## Technical Signals For Architecture And Stack
+
+- [HYPOTHESIS] Architecture or integration signal: [imported detail].
+- [HYPOTHESIS] Technology or constraint signal: [imported detail].
+- [HYPOTHESIS] Risk or compliance signal: [imported detail].
+- [OPEN QUESTION] Imported technical ambiguity: [question] -- Owner: user -- Due: before /god-arch.
+
+## Use Rules
+
+- [DECISION] Godpowers agents may use this artifact as preparation context only.
+- [DECISION] This artifact must not override `.godpowers/intent.yaml`, `.godpowers/state.json`, `PROGRESS.md`, or any completed Godpowers artifact.
+- [DECISION] If imported context conflicts with user intent or a Godpowers artifact, the Godpowers artifact wins and the conflict becomes an open question.
+- [DECISION] PRD, architecture, roadmap, and stack agents should cite imported signals as `[HYPOTHESIS]` until confirmed by Godpowers artifacts or the user.

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.