godpowers 2.2.1 → 2.3.1
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 +65 -7
- package/INSPIRATION.md +4 -2
- package/README.md +35 -22
- package/RELEASE.md +44 -23
- package/SKILL.md +2 -2
- package/agents/god-auditor.md +1 -1
- package/agents/god-debugger.md +44 -8
- package/agents/god-deps-auditor.md +11 -0
- package/agents/god-executor.md +50 -5
- package/agents/god-greenfieldifier.md +1 -1
- package/agents/god-orchestrator.md +2 -2
- package/agents/god-planner.md +14 -0
- package/agents/god-pm.md +1 -1
- package/agents/god-quality-reviewer.md +23 -1
- package/agents/god-reconciler.md +1 -1
- package/agents/god-roadmapper.md +1 -1
- package/agents/god-spec-reviewer.md +16 -0
- package/agents/god-stack-selector.md +4 -0
- package/agents/god-updater.md +1 -1
- package/bin/install.js +9 -3
- package/fixtures/dogfood/{half-migrated-gsd → half-migrated-planning}/manifest.json +2 -2
- package/lib/README.md +9 -2
- package/lib/agent-cache.js +25 -3
- package/lib/atomic-write.js +85 -0
- package/lib/checkpoint.js +2 -1
- package/lib/code-intelligence.js +161 -0
- package/lib/context-writer.js +1 -1
- package/lib/dashboard.js +54 -20
- package/lib/executor-repair.js +65 -0
- package/lib/extensions.js +6 -13
- package/lib/feature-awareness.js +2 -2
- package/lib/fs-async.js +2 -1
- package/lib/host-capabilities.js +4 -0
- package/lib/install-profiles.js +155 -0
- package/lib/installer-args.js +12 -0
- package/lib/installer-core.js +43 -8
- package/lib/linkage.js +2 -1
- package/lib/package-identity.js +38 -0
- package/lib/package-legitimacy.js +158 -0
- package/lib/planning-systems.js +16 -13
- package/lib/quick-proof.js +5 -2
- package/lib/repo-surface-sync.js +1 -1
- package/lib/requirements.js +2 -1
- package/lib/reverse-sync.js +2 -1
- package/lib/route-quality-sync.js +2 -0
- package/lib/source-grounding.js +177 -0
- package/lib/source-sync.js +6 -5
- package/lib/state.js +2 -1
- package/package.json +2 -2
- package/references/HAVE-NOTS.md +1 -1
- package/references/orchestration/MODE-DETECTION.md +2 -2
- package/references/shared/ORCHESTRATORS.md +3 -3
- package/routing/god-design.yaml +1 -1
- package/routing/god-extension-scaffold.yaml +25 -0
- package/routing/god-migrate.yaml +3 -3
- package/routing/god-stack.yaml +1 -1
- package/routing/recipes/add-feature-mid-arc-pause.yaml +6 -0
- package/routing/recipes/brownfield-onboarding.yaml +5 -2
- package/routing/recipes/extension-authoring.yaml +32 -0
- package/routing/recipes/greenfield-fast.yaml +3 -0
- package/routing/recipes/production-broken.yaml +4 -0
- package/routing/recipes/release-maintenance.yaml +3 -0
- package/routing/recipes/returning-after-break.yaml +3 -0
- package/routing/recipes/weekly-health-check.yaml +2 -0
- package/schema/state.v1.json +1 -1
- package/skills/god-build.md +17 -3
- package/skills/god-discuss.md +10 -5
- package/skills/god-doctor.md +9 -3
- package/skills/god-dogfood.md +2 -2
- package/skills/god-extension-scaffold.md +66 -0
- package/skills/god-init.md +6 -6
- package/skills/god-migrate.md +10 -10
- package/skills/god-sync.md +2 -2
- package/skills/god-update-deps.md +4 -2
- package/skills/god-version.md +2 -2
- package/skills/god.md +8 -11
- package/templates/IMPORTED-CONTEXT.md +1 -1
- package/templates/INITIAL-FINDINGS.md +2 -2
- /package/fixtures/dogfood/{half-migrated-gsd → half-migrated-planning}/.planning/PROJECT.md +0 -0
- /package/fixtures/dogfood/{half-migrated-gsd → half-migrated-planning}/.planning/REQUIREMENTS.md +0 -0
- /package/fixtures/dogfood/{half-migrated-gsd → half-migrated-planning}/.planning/ROADMAP.md +0 -0
package/routing/god-migrate.yaml
CHANGED
|
@@ -2,7 +2,7 @@ apiVersion: godpowers/v1
|
|
|
2
2
|
kind: CommandRouting
|
|
3
3
|
metadata:
|
|
4
4
|
command: /god-migrate
|
|
5
|
-
description: Detect and migrate
|
|
5
|
+
description: Detect and migrate legacy planning, BMAD, and Superpowers planning context
|
|
6
6
|
tier: 0
|
|
7
7
|
|
|
8
8
|
prerequisites:
|
|
@@ -16,7 +16,7 @@ execution:
|
|
|
16
16
|
context: current
|
|
17
17
|
reads:
|
|
18
18
|
- .planning/**
|
|
19
|
-
- .
|
|
19
|
+
- .legacy-planning/**
|
|
20
20
|
- _bmad-output/**
|
|
21
21
|
- .bmad/**
|
|
22
22
|
- docs/superpowers/**
|
|
@@ -29,7 +29,7 @@ execution:
|
|
|
29
29
|
- .godpowers/build/STATE.md
|
|
30
30
|
- .godpowers/state.json
|
|
31
31
|
- .planning/GODPOWERS-SYNC.md
|
|
32
|
-
- .
|
|
32
|
+
- .legacy-planning/GODPOWERS-SYNC.md
|
|
33
33
|
- _bmad-output/GODPOWERS-SYNC.md
|
|
34
34
|
- .bmad/GODPOWERS-SYNC.md
|
|
35
35
|
- docs/superpowers/GODPOWERS-SYNC.md
|
package/routing/god-stack.yaml
CHANGED
|
@@ -11,6 +11,12 @@ triggers:
|
|
|
11
11
|
- "mid development"
|
|
12
12
|
- "pause arc"
|
|
13
13
|
- "feature during build"
|
|
14
|
+
- "add a feature"
|
|
15
|
+
- "feature addition"
|
|
16
|
+
- "add a feature during the current project run"
|
|
17
|
+
- "add a feature without breaking the current project run"
|
|
18
|
+
- "without breaking current project run"
|
|
19
|
+
- "do not disturb current work"
|
|
14
20
|
state-conditions:
|
|
15
21
|
- "lifecycle-phase == in-arc"
|
|
16
22
|
|
|
@@ -11,6 +11,9 @@ triggers:
|
|
|
11
11
|
- "inherit codebase"
|
|
12
12
|
- "legacy code"
|
|
13
13
|
- "understand existing"
|
|
14
|
+
- "audit an existing repo"
|
|
15
|
+
- "audit existing repo"
|
|
16
|
+
- "audit existing codebase"
|
|
14
17
|
state-conditions:
|
|
15
18
|
- "has-package-json"
|
|
16
19
|
|
|
@@ -24,10 +27,10 @@ sequences:
|
|
|
24
27
|
why: "Deep history, decisions, conventions, risks"
|
|
25
28
|
- command: "/god-reconstruct"
|
|
26
29
|
why: "Reverse-engineer PRD/ARCH/ROADMAP/STACK from code"
|
|
27
|
-
- command: "/god-tech-debt"
|
|
28
|
-
why: "Categorize and prioritize debt"
|
|
29
30
|
- command: "/god-audit"
|
|
30
31
|
why: "Score reconstructed artifacts"
|
|
32
|
+
- command: "/god-tech-debt"
|
|
33
|
+
why: "Categorize and prioritize debt"
|
|
31
34
|
- command: "/god-feature"
|
|
32
35
|
why: "Now safe to add new work with reconciliation"
|
|
33
36
|
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
apiVersion: godpowers/v1
|
|
2
|
+
kind: Recipe
|
|
3
|
+
metadata:
|
|
4
|
+
name: extension-authoring
|
|
5
|
+
category: extension
|
|
6
|
+
description: "Create, test, install, and verify a Godpowers extension pack"
|
|
7
|
+
|
|
8
|
+
triggers:
|
|
9
|
+
intent-keywords:
|
|
10
|
+
- "create extension pack"
|
|
11
|
+
- "create an extension pack"
|
|
12
|
+
- "author extension pack"
|
|
13
|
+
- "new extension pack"
|
|
14
|
+
- "scaffold extension"
|
|
15
|
+
- "build extension pack"
|
|
16
|
+
- "extend godpowers"
|
|
17
|
+
- "make a pack"
|
|
18
|
+
|
|
19
|
+
sequences:
|
|
20
|
+
default:
|
|
21
|
+
description: "Create, test, install, and verify a Godpowers extension pack"
|
|
22
|
+
steps:
|
|
23
|
+
- command: "/god-extension-scaffold --name=@godpowers/my-pack --output=."
|
|
24
|
+
why: "Create the manifest, package, README, skill, and optional agent or workflow skeleton"
|
|
25
|
+
- command: "/god-test-extension <pack-dir>"
|
|
26
|
+
why: "Run contract tests before install or publish"
|
|
27
|
+
- command: "/god-extension-add <pack-dir>"
|
|
28
|
+
why: "Install the passing pack into the active runtime"
|
|
29
|
+
- command: "/god-extension-list"
|
|
30
|
+
why: "Verify the installed pack appears with its provided commands"
|
|
31
|
+
|
|
32
|
+
default-sequence: default
|
package/schema/state.v1.json
CHANGED
package/skills/god-build.md
CHANGED
|
@@ -30,6 +30,19 @@ Orchestrate the build via specialist agents.
|
|
|
30
30
|
Spawn **god-planner** in fresh context with ROADMAP, ARCH, DECISION.
|
|
31
31
|
Output: `.godpowers/build/PLAN.md` with vertical slices grouped into waves.
|
|
32
32
|
|
|
33
|
+
After the planner returns, run the source-grounding preflight from
|
|
34
|
+
`lib/source-grounding.js` against `.godpowers/build/PLAN.md`. The plan must
|
|
35
|
+
distinguish existing files, existing symbols, new artifacts, and unchecked
|
|
36
|
+
references before any executor starts.
|
|
37
|
+
|
|
38
|
+
Block execution when:
|
|
39
|
+
- A plan cites an existing file that does not exist.
|
|
40
|
+
- A plan cites an existing symbol that cannot be found in the repo.
|
|
41
|
+
- A cited reference is neither grounded nor declared as a new artifact.
|
|
42
|
+
|
|
43
|
+
Allow execution only when missing references are corrected, marked as new
|
|
44
|
+
artifacts, or explicitly accepted by the user as unchecked risk.
|
|
45
|
+
|
|
33
46
|
### Phase 2: Execute Waves
|
|
34
47
|
|
|
35
48
|
For each wave in PLAN.md:
|
|
@@ -59,9 +72,10 @@ After all waves:
|
|
|
59
72
|
2. Run linter. All clean.
|
|
60
73
|
3. Run the package's typecheck/check command when present. All pass.
|
|
61
74
|
4. If any verification command fails, do not mark Build complete. Re-enter
|
|
62
|
-
repair mode with the owning agent
|
|
63
|
-
|
|
64
|
-
|
|
75
|
+
repair mode with the owning agent. Classify the failure as retry,
|
|
76
|
+
decompose, prune, or escalate. Pass the exact failing diagnostics, rerun the
|
|
77
|
+
command, and repeat until green or until the same root failure exhausts the
|
|
78
|
+
repair budget.
|
|
65
79
|
5. Update PROGRESS.md: Build status = done
|
|
66
80
|
6. If the build plan or implementation establishes durable conventions, plan
|
|
67
81
|
pillar updates through `lib/pillars.planArtifactSync`. Under
|
package/skills/god-discuss.md
CHANGED
|
@@ -11,7 +11,7 @@ description: |
|
|
|
11
11
|
|
|
12
12
|
# /god-discuss
|
|
13
13
|
|
|
14
|
-
Pre-planning Socratic discussion with domain grilling.
|
|
14
|
+
Pre-planning Socratic discussion with domain and plan grilling.
|
|
15
15
|
|
|
16
16
|
## When to use
|
|
17
17
|
|
|
@@ -31,10 +31,15 @@ The agent:
|
|
|
31
31
|
4. Explores the codebase instead of asking when repo evidence can answer
|
|
32
32
|
5. Challenges vague, overloaded, or conflicting terms against the glossary
|
|
33
33
|
6. Stress-tests domain relationships with concrete scenarios and edge cases
|
|
34
|
-
7.
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
34
|
+
7. Attempts to falsify the proposed plan before accepting it:
|
|
35
|
+
- What breaks if the smallest happy path is wrong?
|
|
36
|
+
- Which dependency, user behavior, or edge case could invalidate the plan?
|
|
37
|
+
- What would make this scope too broad for one safe slice?
|
|
38
|
+
- What evidence would change the recommended next command?
|
|
39
|
+
8. Surfaces 2-3 hidden assumptions
|
|
40
|
+
9. Identifies what's [DECISION] vs [HYPOTHESIS] vs [OPEN QUESTION]
|
|
41
|
+
10. Drafts a brief in `.godpowers/discussions/<topic>.md`
|
|
42
|
+
11. Updates `.godpowers/domain/GLOSSARY.md` when a term or ambiguity is resolved
|
|
38
43
|
|
|
39
44
|
The brief and glossary get passed to the next planning command. The glossary is
|
|
40
45
|
preparation context, not a replacement for PRD, ARCH, ROADMAP, STACK, or Pillars
|
package/skills/god-doctor.md
CHANGED
|
@@ -48,9 +48,9 @@ Plain-text report grouped by severity:
|
|
|
48
48
|
GODPOWERS DOCTOR
|
|
49
49
|
|
|
50
50
|
Install: claude (~/.claude/)
|
|
51
|
-
[OK]
|
|
51
|
+
[OK] 112 skills installed
|
|
52
52
|
[OK] 40 agents installed
|
|
53
|
-
[OK] VERSION matches (2.
|
|
53
|
+
[OK] VERSION matches (2.3.1)
|
|
54
54
|
[WARN] routing/god-doctor.yaml exists but skill file did not until now
|
|
55
55
|
|
|
56
56
|
Project: /Users/.../my-project/.godpowers/
|
|
@@ -106,7 +106,7 @@ as a read-only diagnostic. It reports:
|
|
|
106
106
|
- runtime version recorded in `state.json`
|
|
107
107
|
- missing current Godpowers feature IDs
|
|
108
108
|
- missing managed AI-tool context fences
|
|
109
|
-
- unimported
|
|
109
|
+
- unimported legacy planning, BMAD, or Superpowers evidence that should route to
|
|
110
110
|
`/god-migrate`
|
|
111
111
|
- `god-greenfieldifier` recommendation when migration evidence is low
|
|
112
112
|
confidence or conflicting
|
|
@@ -114,6 +114,12 @@ as a read-only diagnostic. It reports:
|
|
|
114
114
|
`/god-doctor --fix` may call `lib/feature-awareness.run(projectRoot)` because
|
|
115
115
|
that helper writes only safe state metadata and managed context fences.
|
|
116
116
|
|
|
117
|
+
## Host Capability Reporting
|
|
118
|
+
|
|
119
|
+
`/god-doctor` reports optional code intelligence when `ast-grep`, `sg`, or LSP
|
|
120
|
+
tools are available. Missing code intelligence is diagnostic context only; it
|
|
121
|
+
does not make the host degraded.
|
|
122
|
+
|
|
117
123
|
## Repo Documentation Sync
|
|
118
124
|
|
|
119
125
|
For initialized projects, `/god-doctor` calls `lib/repo-doc-sync.detect` as a
|
package/skills/god-dogfood.md
CHANGED
|
@@ -16,7 +16,7 @@ Run deterministic messy-repo scenarios before release or after automation change
|
|
|
16
16
|
|
|
17
17
|
- [DECISION] Use `/god-dogfood` before a release when migration, host autonomy,
|
|
18
18
|
extension authoring, or Mode D suite release behavior changes.
|
|
19
|
-
- [DECISION] Use `/god-dogfood` when a project already contains
|
|
19
|
+
- [DECISION] Use `/god-dogfood` when a project already contains legacy planning, BMAD, or
|
|
20
20
|
Superpowers context and you need confidence that Godpowers can import and
|
|
21
21
|
sync back without deleting prior-system files.
|
|
22
22
|
- [DECISION] Use `/god-dogfood` when host-spawn guarantees are unclear and the
|
|
@@ -44,7 +44,7 @@ npx godpowers dogfood --json
|
|
|
44
44
|
|
|
45
45
|
## Expected Coverage
|
|
46
46
|
|
|
47
|
-
- [DECISION] The dogfood suite includes a half-migrated
|
|
47
|
+
- [DECISION] The dogfood suite includes a half-migrated legacy planning project.
|
|
48
48
|
- [DECISION] The dogfood suite includes degraded and full host capability
|
|
49
49
|
scenarios.
|
|
50
50
|
- [DECISION] The dogfood suite includes extension scaffold validation.
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: god-extension-scaffold
|
|
3
|
+
description: |
|
|
4
|
+
Create a publishable Godpowers extension pack skeleton from inside the
|
|
5
|
+
slash-command UX. Wraps the same extension authoring helper exposed by
|
|
6
|
+
`npx godpowers extension-scaffold`, then routes to contract testing.
|
|
7
|
+
|
|
8
|
+
Triggers on: "god extension scaffold", "/god-extension-scaffold",
|
|
9
|
+
"create extension pack", "author extension pack", "new extension pack",
|
|
10
|
+
"extend godpowers"
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
# /god-extension-scaffold
|
|
14
|
+
|
|
15
|
+
Create a Godpowers extension pack skeleton.
|
|
16
|
+
|
|
17
|
+
## Usage
|
|
18
|
+
|
|
19
|
+
### `/god-extension-scaffold --name=@godpowers/my-pack --output=.`
|
|
20
|
+
|
|
21
|
+
Optional arguments:
|
|
22
|
+
|
|
23
|
+
- `--skill=custom-pack-command` sets the generated skill name.
|
|
24
|
+
- `--agent=custom-pack-agent` creates a generated agent contract.
|
|
25
|
+
- `--workflow=my-pack-workflow` creates a generated workflow YAML.
|
|
26
|
+
- `--overwrite` allows replacing existing scaffold files.
|
|
27
|
+
|
|
28
|
+
## Process
|
|
29
|
+
|
|
30
|
+
1. Parse the requested package name, output root, optional skill, optional
|
|
31
|
+
agent, and optional workflow.
|
|
32
|
+
2. Call `lib/extension-authoring.js scaffold(...)`.
|
|
33
|
+
3. Validate the generated `manifest.yaml` against the extension manifest
|
|
34
|
+
contract.
|
|
35
|
+
4. Report the created pack path and written files.
|
|
36
|
+
5. Suggest `/god-test-extension <pack-dir>` before install or publish.
|
|
37
|
+
|
|
38
|
+
## Output
|
|
39
|
+
|
|
40
|
+
```
|
|
41
|
+
Extension scaffold created: ./godpowers-my-pack
|
|
42
|
+
|
|
43
|
+
Written:
|
|
44
|
+
manifest.yaml
|
|
45
|
+
package.json
|
|
46
|
+
README.md
|
|
47
|
+
skills/custom-pack-command.md
|
|
48
|
+
|
|
49
|
+
Suggested next: /god-test-extension ./godpowers-my-pack
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
## Implementation
|
|
53
|
+
|
|
54
|
+
Built-in. Calls `lib/extension-authoring.js scaffold(...)`.
|
|
55
|
+
|
|
56
|
+
The terminal equivalent remains:
|
|
57
|
+
|
|
58
|
+
```bash
|
|
59
|
+
npx godpowers extension-scaffold --name=@godpowers/my-pack --output=.
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
## Related
|
|
63
|
+
|
|
64
|
+
- `/god-test-extension <path>` - contract test the pack before install or publish
|
|
65
|
+
- `/god-extension-add <path>` - install a passing pack
|
|
66
|
+
- `/god-extension-list` - verify the pack is visible in the runtime
|
package/skills/god-init.md
CHANGED
|
@@ -36,7 +36,7 @@ needs to specify a mode.
|
|
|
36
36
|
command. This happens before `/god-prd`, `/god-next`, or `/god-mode`
|
|
37
37
|
continues.
|
|
38
38
|
- Look for adjacent planning-system context:
|
|
39
|
-
-
|
|
39
|
+
- legacy planning: `.legacy-planning/`, `.planning/`, `LEGACY-PLANNING.md`, `legacy-planning*.md`
|
|
40
40
|
- Superpowers: `.superpowers/`, `superpowers/`, `SUPERPOWERS.md`,
|
|
41
41
|
`.claude/skills/`, `.codex/skills/`
|
|
42
42
|
- BMAD: `.bmad-core/`, `bmad-core/`, `.bmad/`, `BMAD.md`,
|
|
@@ -45,7 +45,7 @@ needs to specify a mode.
|
|
|
45
45
|
`.godpowers/prep/IMPORTED-CONTEXT.md` as preparation context.
|
|
46
46
|
Do not treat external planning-system files as source of truth.
|
|
47
47
|
- Auto-invoke `lib/planning-systems.importPlanningContext(projectRoot)`
|
|
48
|
-
when
|
|
48
|
+
when legacy planning, Superpowers, or BMAD context is detected. Report this as
|
|
49
49
|
`Agent: none, local runtime only`.
|
|
50
50
|
- If import confidence is low, more than one source system appears to
|
|
51
51
|
conflict, or canonical Godpowers seed artifacts cannot be created from
|
|
@@ -57,7 +57,7 @@ needs to specify a mode.
|
|
|
57
57
|
- UI surfaces: `src/components/`, `app/`, `pages/`, `routes/`,
|
|
58
58
|
`public/`, form-heavy flows, dashboards, editor surfaces, mobile
|
|
59
59
|
shells, marketing pages, or other user-facing product experience
|
|
60
|
-
- Imported
|
|
60
|
+
- Imported legacy planning, Superpowers, or BMAD context that mentions UX, screens,
|
|
61
61
|
journeys, components, brand, interaction states, or visual design
|
|
62
62
|
- Record the result in `INITIAL-FINDINGS.md` so `/god-prd`, `/god-next`,
|
|
63
63
|
and `/god-mode` can place `/god-design` after PRD and before
|
|
@@ -114,7 +114,7 @@ needs to specify a mode.
|
|
|
114
114
|
- Run Mode Detection (announced in plain English; stored as A/B/C/E internally)
|
|
115
115
|
- Run Scale Detection (trivial/small/medium/large/enterprise)
|
|
116
116
|
- Write `.godpowers/prep/INITIAL-FINDINGS.md`
|
|
117
|
-
- Run planning-system context detection for
|
|
117
|
+
- Run planning-system context detection for legacy planning, Superpowers, and BMAD
|
|
118
118
|
- Write `.godpowers/prep/IMPORTED-CONTEXT.md` when useful context exists
|
|
119
119
|
- Run automatic planning-system import through
|
|
120
120
|
`lib/planning-systems.importPlanningContext(projectRoot)` and record
|
|
@@ -153,7 +153,7 @@ needs to specify a mode.
|
|
|
153
153
|
PROGRESS.md
|
|
154
154
|
prep/
|
|
155
155
|
INITIAL-FINDINGS.md
|
|
156
|
-
IMPORTED-CONTEXT.md # only when
|
|
156
|
+
IMPORTED-CONTEXT.md # only when legacy planning / Superpowers / BMAD context exists
|
|
157
157
|
prd/
|
|
158
158
|
arch/
|
|
159
159
|
adr/
|
|
@@ -194,7 +194,7 @@ shape, framework and tooling signals, tests, CI, docs, AI-tool files, detected
|
|
|
194
194
|
methodology systems, Pillars health, UI or product-experience signals, risk
|
|
195
195
|
signals, and the reasoning behind the suggested next command.
|
|
196
196
|
|
|
197
|
-
If
|
|
197
|
+
If legacy planning, Superpowers, BMAD, or similar planning context is detected, create
|
|
198
198
|
`.godpowers/prep/IMPORTED-CONTEXT.md`. This artifact is preparation context,
|
|
199
199
|
not source of truth. It feeds PRD, architecture, roadmap, and stack decisions
|
|
200
200
|
as hypothesis-level input only.
|
package/skills/god-migrate.md
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: god-migrate
|
|
3
3
|
description: |
|
|
4
|
-
Detect
|
|
4
|
+
Detect legacy planning, BMAD, and Superpowers planning systems, migrate useful context
|
|
5
5
|
into Godpowers prep and seed artifacts, and sync Godpowers progress back to
|
|
6
6
|
the prior system through managed companion files.
|
|
7
7
|
|
|
8
|
-
Triggers on: "god migrate", "/god-migrate", "migrate from
|
|
9
|
-
"migrate from bmad", "migrate from superpowers", "sync back to
|
|
8
|
+
Triggers on: "god migrate", "/god-migrate", "migrate from legacy-planning",
|
|
9
|
+
"migrate from bmad", "migrate from superpowers", "sync back to legacy-planning",
|
|
10
10
|
"sync back to bmad", "sync back to superpowers"
|
|
11
11
|
---
|
|
12
12
|
|
|
@@ -16,7 +16,7 @@ Detect and migrate adjacent planning systems into Godpowers.
|
|
|
16
16
|
|
|
17
17
|
## When To Use
|
|
18
18
|
|
|
19
|
-
- A project already has
|
|
19
|
+
- A project already has legacy planning `.planning/` or `.legacy-planning/` context.
|
|
20
20
|
- A project already has BMAD `_bmad/`, `_bmad-output/`, `.bmad-core/`, or
|
|
21
21
|
`.bmad/` context.
|
|
22
22
|
- A project already has Superpowers specs, plans, or project-local skills.
|
|
@@ -26,7 +26,7 @@ Detect and migrate adjacent planning systems into Godpowers.
|
|
|
26
26
|
|
|
27
27
|
## Auto-Invoke Contract
|
|
28
28
|
|
|
29
|
-
`/god-init` auto-invokes the import path when it detects
|
|
29
|
+
`/god-init` auto-invokes the import path when it detects legacy planning, BMAD, or
|
|
30
30
|
Superpowers context. It must show this visible status card:
|
|
31
31
|
|
|
32
32
|
```
|
|
@@ -74,7 +74,7 @@ lib/planning-systems.importPlanningContext(projectRoot, {
|
|
|
74
74
|
```
|
|
75
75
|
|
|
76
76
|
This:
|
|
77
|
-
- detects
|
|
77
|
+
- detects legacy planning, BMAD, and Superpowers sources
|
|
78
78
|
- writes `.godpowers/prep/IMPORTED-CONTEXT.md`
|
|
79
79
|
- writes missing Godpowers seed artifacts when enough source evidence exists
|
|
80
80
|
- marks those seed artifacts as `imported` in `state.json`
|
|
@@ -98,14 +98,14 @@ This:
|
|
|
98
98
|
|
|
99
99
|
| Source system | Import evidence | Godpowers destination | Sync-back destination |
|
|
100
100
|
|---|---|---|---|
|
|
101
|
-
|
|
|
102
|
-
|
|
|
101
|
+
| legacy planning | `.planning/PROJECT.md`, `REQUIREMENTS.md`, `ROADMAP.md`, `STATE.md`, phase files | prep context, PRD seed, roadmap seed, build-state seed | `.planning/GODPOWERS-SYNC.md` |
|
|
102
|
+
| legacy planning variant | `.legacy-planning/` files | prep context and seeds when source files are readable | `.legacy-planning/GODPOWERS-SYNC.md` |
|
|
103
103
|
| BMAD | `_bmad-output/planning-artifacts/PRD.md`, `architecture.md`, epics, stories, sprint status | prep context, PRD seed, arch seed, roadmap seed | `_bmad-output/GODPOWERS-SYNC.md` |
|
|
104
104
|
| Superpowers | `docs/superpowers/specs/*.md`, `docs/superpowers/plans/*.md`, project-local skills | prep context, PRD seed, roadmap seed, build-state seed | `docs/superpowers/GODPOWERS-SYNC.md` |
|
|
105
105
|
|
|
106
106
|
## Guardrails
|
|
107
107
|
|
|
108
|
-
- Do not delete, move, or rewrite
|
|
108
|
+
- Do not delete, move, or rewrite legacy planning, BMAD, or Superpowers files.
|
|
109
109
|
- Do not treat imported content as authoritative until a Godpowers artifact or
|
|
110
110
|
the user confirms it.
|
|
111
111
|
- Do not write outside Godpowers-owned fences in source-system files.
|
|
@@ -120,7 +120,7 @@ This:
|
|
|
120
120
|
Migration complete.
|
|
121
121
|
|
|
122
122
|
Detected:
|
|
123
|
-
+
|
|
123
|
+
+ legacy planning: high confidence, 12 files
|
|
124
124
|
+ BMAD: not detected
|
|
125
125
|
+ Superpowers: medium confidence, 2 files
|
|
126
126
|
|
package/skills/god-sync.md
CHANGED
|
@@ -50,7 +50,7 @@ User runs `/god-sync` after manual changes. Useful for:
|
|
|
50
50
|
`lib/pillars.applyArtifactSync` under the active Pillars policy.
|
|
51
51
|
7. If `state.json` contains enabled `source-systems`, auto-invoke
|
|
52
52
|
`lib/source-sync.run(projectRoot)` so current Godpowers progress is written
|
|
53
|
-
back to imported
|
|
53
|
+
back to imported legacy planning, BMAD, or Superpowers companion files. Report this as
|
|
54
54
|
`Agent: none, local runtime only`.
|
|
55
55
|
8. Spawn god-updater in fresh context with:
|
|
56
56
|
- The reconciliation verdict (if available from a prior /god-reconcile)
|
|
@@ -90,7 +90,7 @@ Sync status:
|
|
|
90
90
|
Local syncs:
|
|
91
91
|
+ reverse-sync: <scanned N files, updated M footers, populated K review items>
|
|
92
92
|
+ feature-awareness: <recorded runtime features, refreshed context, or no-op>
|
|
93
|
-
+ source-sync: <written
|
|
93
|
+
+ source-sync: <written legacy planning/BMAD/Superpowers companion files, no-op, or skipped>
|
|
94
94
|
+ repo-doc-sync: <refreshed README badges/counts, recommended god-docs-writer, or no-op>
|
|
95
95
|
+ repo-surface-sync: <checked routes/package/agents/workflows/extensions, recommended scoped agents, or no-op>
|
|
96
96
|
+ route-quality-sync: <checked atomic spawns and contextual exits, no-op, or recommended god-auditor>
|
|
@@ -34,8 +34,10 @@ The agent:
|
|
|
34
34
|
1. Runs the appropriate audit tool for the stack (`npm audit`, `pip-audit`,
|
|
35
35
|
etc.)
|
|
36
36
|
2. Lists outdated and stale dependencies
|
|
37
|
-
3.
|
|
38
|
-
|
|
37
|
+
3. Runs package legitimacy checks for new replacement candidates before
|
|
38
|
+
recommending them
|
|
39
|
+
4. Classifies each: Critical CVE / Stale / Major behind / Minor behind / OK
|
|
40
|
+
5. Writes AUDIT.md
|
|
39
41
|
|
|
40
42
|
### Phase 2: Triage
|
|
41
43
|
The agent presents the audit. Priority order:
|
package/skills/god-version.md
CHANGED
|
@@ -14,9 +14,9 @@ Print version and a short capability summary.
|
|
|
14
14
|
## Output
|
|
15
15
|
|
|
16
16
|
```
|
|
17
|
-
Godpowers v2.
|
|
17
|
+
Godpowers v2.3.1
|
|
18
18
|
Install: /Users/.../.claude/ (matches package.json)
|
|
19
|
-
Surface:
|
|
19
|
+
Surface: 112 skills, 40 agents, 13 workflows, 42 recipes
|
|
20
20
|
Schema: intent.v1, state.v1, events.v1, workflow.v1, routing.v1, recipe.v1
|
|
21
21
|
External integrations available: impeccable, agent-browser (others lazy)
|
|
22
22
|
Feature awareness: planning-system migration, source-system sync-back, context refresh, dashboard status labels, repo documentation sync, repo surface sync, quick proof, request trace, release hardening, maintenance hardening
|
package/skills/god.md
CHANGED
|
@@ -160,13 +160,11 @@ any destructive sequence executes.
|
|
|
160
160
|
```
|
|
161
161
|
User: /god production is broken
|
|
162
162
|
|
|
163
|
-
Match: production-broken (score:
|
|
164
|
-
What this does:
|
|
163
|
+
Match: production-broken (score: 20)
|
|
164
|
+
What this does: Production is broken now
|
|
165
165
|
|
|
166
166
|
Sequence:
|
|
167
|
-
1. /god-hotfix
|
|
168
|
-
2. /god-deploy Push the fix once green
|
|
169
|
-
3. /god-postmortem Schedule the incident review
|
|
167
|
+
1. /god-hotfix Skip planning, debug, fix with TDD, expedited deploy, schedule postmortem
|
|
170
168
|
|
|
171
169
|
Run this sequence? (yes / show others / cancel)
|
|
172
170
|
```
|
|
@@ -174,15 +172,14 @@ Run this sequence? (yes / show others / cancel)
|
|
|
174
172
|
### Example 2: ambiguous intent (multiple matches)
|
|
175
173
|
|
|
176
174
|
```
|
|
177
|
-
User: /god
|
|
175
|
+
User: /god parallel feature during build
|
|
178
176
|
|
|
179
|
-
Top matches for "
|
|
177
|
+
Top matches for "parallel feature during build":
|
|
180
178
|
|
|
181
|
-
1. add-feature-mid-arc-pause (
|
|
182
|
-
2. add-feature-
|
|
183
|
-
3. add-feature-next-milestone (10) Defer to next milestone
|
|
179
|
+
1. add-feature-mid-arc-pause (10) Bigger feature during the current project run; reconcile with roadmap, pause, do feature, update roadmap, resume
|
|
180
|
+
2. add-feature-parallel (10) Parallel feature, do not disrupt main work
|
|
184
181
|
|
|
185
|
-
Pick one (1/2
|
|
182
|
+
Pick one (1/2) or describe more specifically.
|
|
186
183
|
```
|
|
187
184
|
|
|
188
185
|
### Example 3: state-driven (no text)
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
## Sources Detected
|
|
8
8
|
|
|
9
|
-
- [DECISION] Source system: [
|
|
9
|
+
- [DECISION] Source system: [legacy planning / Superpowers / BMAD / other].
|
|
10
10
|
- [DECISION] Source path: [relative path].
|
|
11
11
|
- [DECISION] Managed sync-back path: [relative path or "not enabled"].
|
|
12
12
|
- [HYPOTHESIS] Useful signal: [what this source appears to clarify].
|
|
@@ -24,7 +24,7 @@
|
|
|
24
24
|
## Methodology And AI Tool Signals
|
|
25
25
|
|
|
26
26
|
- [HYPOTHESIS] AI instruction files found: [paths or "none detected"].
|
|
27
|
-
- [HYPOTHESIS]
|
|
27
|
+
- [HYPOTHESIS] Legacy planning context found: [paths or "none detected"].
|
|
28
28
|
- [HYPOTHESIS] Superpowers context found: [paths or "none detected"].
|
|
29
29
|
- [HYPOTHESIS] BMAD context found: [paths or "none detected"].
|
|
30
30
|
- [HYPOTHESIS] Pillars context health: [present / partial / initialized].
|
|
@@ -56,6 +56,6 @@
|
|
|
56
56
|
- [DECISION] Downstream agents may use this artifact as preparation context only.
|
|
57
57
|
- [DECISION] If this artifact conflicts with `.godpowers/intent.yaml`, `.godpowers/state.json`, `PROGRESS.md`, or a completed Godpowers artifact, the Godpowers artifact wins.
|
|
58
58
|
- [DECISION] Pillars files under `agents/*.md` are the native project context layer for Godpowers commands.
|
|
59
|
-
- [DECISION] Imported
|
|
59
|
+
- [DECISION] Imported legacy planning, Superpowers, and BMAD signals must be converted into Godpowers-native artifacts, not preserved as parallel state.
|
|
60
60
|
- [DECISION] Managed sync-back files may be written only by Godpowers-owned fences or companion paths.
|
|
61
61
|
- [DECISION] Host capability and dogfood findings inform routing, but completed Godpowers artifacts remain authoritative.
|
|
File without changes
|
/package/fixtures/dogfood/{half-migrated-gsd → half-migrated-planning}/.planning/REQUIREMENTS.md
RENAMED
|
File without changes
|
|
File without changes
|