godpowers 0.15.6 → 0.15.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -5,6 +5,20 @@ All notable changes to Godpowers will be documented in this file.
5
5
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
6
6
  and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
7
 
8
+ ## [0.15.7] - 2026-05-11
9
+
10
+ Planning import release. Lets `/god-init` preserve useful context from nearby
11
+ planning systems without making those systems authoritative.
12
+
13
+ ### Added
14
+ - `/god-init` now detects GSD, Superpowers, BMAD, and similar planning context
15
+ during project preparation.
16
+ - Added `.godpowers/prep/IMPORTED-CONTEXT.md` as a non-authoritative
17
+ preparation artifact for imported product, delivery, architecture, and stack
18
+ signals.
19
+ - PRD, architecture, roadmap, and stack agents now read imported context when
20
+ present and treat it as hypothesis-level supporting evidence.
21
+
8
22
  ## [0.15.6] - 2026-05-11
9
23
 
10
24
  Quiet init release. Keeps `/god-init` focused on the next useful command while
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  [![CI](https://github.com/aihxp/godpowers/actions/workflows/ci.yml/badge.svg)](https://github.com/aihxp/godpowers/actions/workflows/ci.yml)
4
4
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
5
- [![Version](https://img.shields.io/badge/version-0.15.6-blue)](CHANGELOG.md)
5
+ [![Version](https://img.shields.io/badge/version-0.15.7-blue)](CHANGELOG.md)
6
6
  [![npm](https://img.shields.io/npm/v/godpowers.svg)](https://www.npmjs.com/package/godpowers)
7
7
 
8
8
  **Ship fast. Ship right. Ship everything. Ship accountably.**
@@ -19,6 +19,21 @@ flip points.
19
19
  Before starting:
20
20
  - `.godpowers/prd/PRD.md` MUST exist
21
21
  - PRD MUST pass have-nots (run god-auditor first if uncertain)
22
+ - Optional: `.godpowers/prep/IMPORTED-CONTEXT.md` may exist as preparation
23
+ context.
24
+
25
+ ## Imported Preparation Context
26
+
27
+ If `.godpowers/prep/IMPORTED-CONTEXT.md` exists, read its technical signals
28
+ before drafting ARCH. Use imported architecture, integration, risk, and stack
29
+ constraints as hypothesis-level input only.
30
+
31
+ Rules:
32
+ - Do not let imported context override PRD NFRs or Godpowers state.
33
+ - Convert useful imported signals into ADR context, tradeoffs, or open
34
+ questions.
35
+ - If imported context conflicts with the PRD, the PRD wins and the conflict
36
+ becomes an `[OPEN QUESTION]`.
22
37
 
23
38
  ## Output
24
39
 
@@ -30,7 +30,8 @@ You and only you are responsible for:
30
30
  2. **Calling the play** - selecting the next specialist agent for each tier
31
31
  sub-step from `<runtimeRoot>/routing/<command>.yaml`.
32
32
  3. **Owning the playbook** - all writes to `state.json`, `PROGRESS.md`,
33
- `intent.yaml`, and `events.jsonl` originate from you or agents you spawn.
33
+ `intent.yaml`, `.godpowers/prep/IMPORTED-CONTEXT.md`, and `events.jsonl`
34
+ originate from you or agents you spawn.
34
35
  4. **Audibles** - handling pause checkpoints, the critical-finding gate, and
35
36
  the --yolo carve-out when the user has authorized auto-resolve.
36
37
  5. **Clock management** - mandatory final sync after Tier 3 (always, including
@@ -138,6 +139,35 @@ Before each tier, check whether this repo is part of a registered suite:
138
139
  3. Per-repo state.json remains the source of truth; never write to
139
140
  `.godpowers/suite/` directly (that's god-coordinator's surface).
140
141
 
142
+ ## Planning-system context import
143
+
144
+ During `/god-init`, scan for adjacent methodology artifacts from GSD,
145
+ Superpowers, BMAD, and similar systems. Treat them as preparation context,
146
+ not as source of truth.
147
+
148
+ Detection signals:
149
+ - GSD: `.gsd/`, `.planning/`, `GSD.md`, `gsd*.md`
150
+ - Superpowers: `.superpowers/`, `superpowers/`, `SUPERPOWERS.md`,
151
+ `.claude/skills/`, `.codex/skills/`
152
+ - BMAD: `.bmad-core/`, `bmad-core/`, `.bmad/`, `BMAD.md`,
153
+ `docs/prd.md`, `docs/architecture.md`, `docs/roadmap.md`
154
+
155
+ When signals are found:
156
+ 1. Read only likely planning files, not dependency folders or generated build
157
+ output.
158
+ 2. Summarize product, delivery, technical, risk, and already-built signals into
159
+ `.godpowers/prep/IMPORTED-CONTEXT.md` using `templates/IMPORTED-CONTEXT.md`.
160
+ 3. Label every imported claim as `[HYPOTHESIS]` unless the user directly stated
161
+ it during this session.
162
+ 4. Record source paths and confidence so downstream agents can decide how much
163
+ weight to give each signal.
164
+ 5. If imported context conflicts with Godpowers state, user intent, or a
165
+ completed Godpowers artifact, keep the Godpowers artifact as authoritative
166
+ and add an `[OPEN QUESTION]` to imported context.
167
+
168
+ Downstream planning agents may read this artifact. They must cite it as
169
+ supporting evidence only.
170
+
141
171
  ## Routing-Driven Decisions
142
172
 
143
173
  For routing decisions, consult `<runtimeRoot>/routing/<command>.yaml` files.
package/agents/god-pm.md CHANGED
@@ -29,6 +29,22 @@ required sections:
29
29
  7. **Appetite** (time/resource/technical constraints)
30
30
  8. **Open Questions** (with owner and due date)
31
31
 
32
+ ## Imported Preparation Context
33
+
34
+ If `.godpowers/prep/IMPORTED-CONTEXT.md` exists, read it before drafting the
35
+ PRD. Use product signals from GSD, Superpowers, BMAD, or similar systems as
36
+ hypothesis-level input only.
37
+
38
+ Rules:
39
+ - Do not copy imported text wholesale into the PRD.
40
+ - Do not treat imported context as source of truth.
41
+ - Convert relevant imported product signals into `[HYPOTHESIS]` requirements,
42
+ success metrics, scope notes, no-gos, or open questions.
43
+ - If imported context conflicts with user intent or existing Godpowers state,
44
+ preserve the Godpowers state and add an `[OPEN QUESTION]`.
45
+ - In PRD rationale, mention the source only when it materially changes a
46
+ requirement.
47
+
32
48
  ## Quality Gates
33
49
 
34
50
  Run these checks on every section before declaring done:
@@ -16,6 +16,22 @@ Sequence the work.
16
16
  ## Gate Check
17
17
 
18
18
  `.godpowers/arch/ARCH.md` MUST exist and pass have-nots.
19
+ Optional: `.godpowers/prep/IMPORTED-CONTEXT.md` may exist as preparation
20
+ context.
21
+
22
+ ## Imported Preparation Context
23
+
24
+ If `.godpowers/prep/IMPORTED-CONTEXT.md` exists, read its delivery signals
25
+ before sequencing milestones. Use imported GSD, Superpowers, BMAD, or similar
26
+ stories and plans as hypothesis-level input only.
27
+
28
+ Rules:
29
+ - Do not add roadmap features that are not grounded in the PRD.
30
+ - Use imported milestones, stories, and done-work signals to inform ordering,
31
+ dependency edges, and open questions.
32
+ - If imported context conflicts with PRD or ARCH, PRD and ARCH win.
33
+ - Mark any imported sequencing assumption as `[HYPOTHESIS]` until confirmed by
34
+ Godpowers artifacts or the user.
19
35
 
20
36
  ## Process
21
37
 
@@ -15,6 +15,20 @@ Pick the technology stack.
15
15
  ## Gate Check
16
16
 
17
17
  `.godpowers/arch/ARCH.md` MUST exist.
18
+ Optional: `.godpowers/prep/IMPORTED-CONTEXT.md` may exist as preparation
19
+ context.
20
+
21
+ ## Imported Preparation Context
22
+
23
+ If `.godpowers/prep/IMPORTED-CONTEXT.md` exists, read its technical and stack
24
+ signals before scoring candidates. Use imported technology choices, constraints,
25
+ and team familiarity as hypothesis-level input only.
26
+
27
+ Rules:
28
+ - Do not let imported stack preference override ARCH NFRs or ADRs.
29
+ - Treat imported technology choices as candidate evidence, not decisions.
30
+ - If imported context conflicts with ARCH, ARCH wins and the conflict becomes a
31
+ stack open question.
18
32
 
19
33
  ## Process
20
34
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "godpowers",
3
- "version": "0.15.6",
3
+ "version": "0.15.7",
4
4
  "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.",
5
5
  "bin": {
6
6
  "godpowers": "./bin/install.js"
@@ -19,6 +19,7 @@ execution:
19
19
  context: fresh
20
20
  reads:
21
21
  - .godpowers/prd/PRD.md
22
+ - .godpowers/prep/IMPORTED-CONTEXT.md
22
23
  - templates/ARCH.md
23
24
  writes:
24
25
  - .godpowers/arch/ARCH.md
@@ -19,6 +19,7 @@ execution:
19
19
  - .godpowers/PROGRESS.md
20
20
  - .godpowers/state.json
21
21
  - .godpowers/intent.yaml
22
+ - .godpowers/prep/IMPORTED-CONTEXT.md
22
23
 
23
24
  success-path:
24
25
  next-recommended: /god-prd
@@ -21,6 +21,7 @@ execution:
21
21
  context: fresh
22
22
  reads:
23
23
  - .godpowers/intent.yaml
24
+ - .godpowers/prep/IMPORTED-CONTEXT.md
24
25
  - templates/PRD.md
25
26
  writes:
26
27
  - .godpowers/prd/PRD.md
@@ -17,6 +17,7 @@ execution:
17
17
  reads:
18
18
  - .godpowers/prd/PRD.md
19
19
  - .godpowers/arch/ARCH.md
20
+ - .godpowers/prep/IMPORTED-CONTEXT.md
20
21
  - templates/ROADMAP.md
21
22
  writes:
22
23
  - .godpowers/roadmap/ROADMAP.md
@@ -14,6 +14,9 @@ prerequisites:
14
14
  execution:
15
15
  spawns: [god-stack-selector]
16
16
  context: fresh
17
+ reads:
18
+ - .godpowers/arch/ARCH.md
19
+ - .godpowers/prep/IMPORTED-CONTEXT.md
17
20
  writes:
18
21
  - .godpowers/stack/DECISION.md
19
22
 
@@ -30,6 +30,15 @@ needs to specify a mode.
30
30
  - Look for org-level context (current dir + parent dirs):
31
31
  - .godpowers/org-context.yaml
32
32
  - Workspace configs that share standards
33
+ - Look for adjacent planning-system context:
34
+ - GSD: `.gsd/`, `.planning/`, `GSD.md`, `gsd*.md`
35
+ - Superpowers: `.superpowers/`, `superpowers/`, `SUPERPOWERS.md`,
36
+ `.claude/skills/`, `.codex/skills/`
37
+ - BMAD: `.bmad-core/`, `bmad-core/`, `.bmad/`, `BMAD.md`,
38
+ `docs/prd.md`, `docs/architecture.md`, `docs/roadmap.md`
39
+ - If any are detected, summarize useful signals into
40
+ `.godpowers/prep/IMPORTED-CONTEXT.md` as preparation context.
41
+ Do not treat external planning-system files as source of truth.
33
42
 
34
43
  3. **Announce findings in plain English** (no jargon):
35
44
  - Empty dir + no org context: "Detected: empty directory. Starting fresh."
@@ -48,6 +57,8 @@ needs to specify a mode.
48
57
  The orchestrator will:
49
58
  - Run Mode Detection (announced in plain English; stored as A/B/C/E internally)
50
59
  - Run Scale Detection (trivial/small/medium/large/enterprise)
60
+ - Run planning-system context detection for GSD, Superpowers, and BMAD
61
+ - Write `.godpowers/prep/IMPORTED-CONTEXT.md` when useful context exists
51
62
  - For brownfield: schedule archaeology + reconstruction as preflight
52
63
  - For bluefield: load org-context as constraint
53
64
  - Create directory structure
@@ -65,6 +76,8 @@ needs to specify a mode.
65
76
  ```
66
77
  .godpowers/
67
78
  PROGRESS.md
79
+ prep/
80
+ IMPORTED-CONTEXT.md # only when GSD / Superpowers / BMAD context exists
68
81
  prd/
69
82
  arch/
70
83
  adr/
@@ -99,6 +112,11 @@ needs to specify a mode.
99
112
 
100
113
  `.godpowers/PROGRESS.md` created with initial state.
101
114
 
115
+ If GSD, Superpowers, BMAD, or similar planning context is detected, create
116
+ `.godpowers/prep/IMPORTED-CONTEXT.md`. This artifact is preparation context,
117
+ not source of truth. It feeds PRD, architecture, roadmap, and stack decisions
118
+ as hypothesis-level input only.
119
+
102
120
  ## AI-tool context (automatic for explicit init)
103
121
 
104
122
  After PROGRESS.md is written, decide from the trigger phrase:
@@ -0,0 +1,40 @@
1
+ # Imported Preparation Context
2
+
3
+ > This artifact captures non-authoritative context imported from adjacent
4
+ > planning systems. Godpowers artifacts remain the source of truth after they
5
+ > are created.
6
+
7
+ ## Sources Detected
8
+
9
+ - [DECISION] Source system: [GSD / Superpowers / BMAD / other].
10
+ - [DECISION] Source path: [relative path].
11
+ - [HYPOTHESIS] Useful signal: [what this source appears to clarify].
12
+ - [HYPOTHESIS] Confidence: [high / medium / low] because [brief reason].
13
+
14
+ ## Product Signals For PRD
15
+
16
+ - [HYPOTHESIS] User or persona signal: [imported detail].
17
+ - [HYPOTHESIS] Problem or outcome signal: [imported detail].
18
+ - [HYPOTHESIS] Scope or no-go signal: [imported detail].
19
+ - [OPEN QUESTION] Imported product ambiguity: [question] -- Owner: user -- Due: before /god-prd.
20
+
21
+ ## Delivery Signals For Roadmap
22
+
23
+ - [HYPOTHESIS] Existing milestone or story signal: [imported detail].
24
+ - [HYPOTHESIS] Dependency or sequencing signal: [imported detail].
25
+ - [HYPOTHESIS] Done or already-built signal: [imported detail].
26
+ - [OPEN QUESTION] Imported delivery ambiguity: [question] -- Owner: user -- Due: before /god-roadmap.
27
+
28
+ ## Technical Signals For Architecture And Stack
29
+
30
+ - [HYPOTHESIS] Architecture or integration signal: [imported detail].
31
+ - [HYPOTHESIS] Technology or constraint signal: [imported detail].
32
+ - [HYPOTHESIS] Risk or compliance signal: [imported detail].
33
+ - [OPEN QUESTION] Imported technical ambiguity: [question] -- Owner: user -- Due: before /god-arch.
34
+
35
+ ## Use Rules
36
+
37
+ - [DECISION] Godpowers agents may use this artifact as preparation context only.
38
+ - [DECISION] This artifact must not override `.godpowers/intent.yaml`, `.godpowers/state.json`, `PROGRESS.md`, or any completed Godpowers artifact.
39
+ - [DECISION] If imported context conflicts with user intent or a Godpowers artifact, the Godpowers artifact wins and the conflict becomes an open question.
40
+ - [DECISION] PRD, architecture, roadmap, and stack agents should cite imported signals as `[HYPOTHESIS]` until confirmed by Godpowers artifacts or the user.