godpowers 0.15.17 → 1.0.0

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,59 @@ 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
+ ## [1.0.0] - 2026-05-14
9
+
10
+ Public adoption freeze release. Promotes the shipped Godpowers surface to the
11
+ stable 1.0 line so real users can adopt it without the project moving under
12
+ them.
13
+
14
+ ### Added
15
+ - Added 1.0 release notes and public adoption language.
16
+ - Added greenfield Pillars seeding so new Godpowers projects write the project
17
+ name into `agents/context.md` during initialization.
18
+
19
+ ### Changed
20
+ - Bumped the package and public documentation version to 1.0.0.
21
+ - Generated `AGENTS.md` now names Godpowers first, then explains that Pillars is
22
+ the native project context layer and `.godpowers/` remains the workflow state
23
+ and artifact layer.
24
+ - Release documentation now frames the project as stable for public adoption
25
+ freeze rather than pre-launch expansion.
26
+ - The release script now checks the installer version through `package.json`,
27
+ matching the dynamic installer implementation.
28
+
29
+ ### Frozen
30
+ - Public slash-command, agent, workflow, routing, recipe, and schema surfaces are
31
+ frozen except for critical fixes and adoption feedback.
32
+ - New command families, schema churn, and Pillars format changes are deferred
33
+ until adoption produces evidence.
34
+
35
+ ## [0.15.18] - 2026-05-14
36
+
37
+ Native Pillars context release. Makes Pillars the default project context
38
+ layer for Godpowers projects and keeps existing `.godpowers` artifacts aligned
39
+ with portable `agents/*.md` pillar files.
40
+
41
+ ### Added
42
+ - Added `lib/pillars.js` for Pillars detection, initialization, load-set
43
+ routing, existing-project Pillar-ization, artifact sync planning, and
44
+ semantic signal extraction from labeled Godpowers artifacts.
45
+ - Added `scripts/test-pillars.js` and `npm run test:pillars` to cover the
46
+ `agents/` collision risk, Pillars initialization, routed load sets,
47
+ existing `.godpowers` conversion, artifact-to-pillar sync, `--yolo`
48
+ auto-apply behavior, and restricted-character sanitization.
49
+
50
+ ### Changed
51
+ - `/god-init`, `/god-mode`, `/god-context`, and `/god-sync` now treat every
52
+ Godpowers project as a Pillars project by default.
53
+ - Existing `.godpowers` projects are Pillar-ized on resume or sync, with PRD,
54
+ ARCH, STACK, ROADMAP, BUILD, DEPLOY, OBSERVE, HARDEN, DESIGN, and PRODUCT
55
+ artifacts linked into relevant pillar files.
56
+ - `/god-feature`, `/god-build`, `/god-review`, PRD, architecture, roadmap,
57
+ orchestrator, and updater flows now document Pillars-first context loading.
58
+ - Under `/god-mode --yolo`, durable artifact changes auto-apply managed
59
+ pillar sync sections and log the decision.
60
+
8
61
  ## [0.15.17] - 2026-05-12
9
62
 
10
63
  Greenfieldification release. Turns the brownfield and bluefield simulation
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.17-blue)](CHANGELOG.md)
5
+ [![Version](https://img.shields.io/badge/version-1.0.0-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.**
@@ -12,8 +12,15 @@ idea to hardened production. It runs as **slash commands inside your AI coding
12
12
  tool** (Claude Code, Codex, Cursor, etc.) that orchestrate **specialist agents**
13
13
  in fresh contexts to do the work.
14
14
 
15
+ Version 1.0.0 is the public adoption freeze: the command, agent, workflow,
16
+ schema, artifact, and native Pillars context surfaces are stable while real
17
+ projects shape the next release train.
18
+
15
19
  It fuses four disciplines into one unified workflow:
16
20
 
21
+ - **Native project context** - every Godpowers project is a Pillars project:
22
+ root `AGENTS.md` plus task-routed `agents/*.md` files carry durable project
23
+ truth before commands touch code.
17
24
  - **Artifact discipline** - every sentence in every document is a labeled
18
25
  decision, hypothesis, or open question. Mechanically verified failure modes.
19
26
  - **Execution engine** - fresh-context agents in parallel waves with atomic
@@ -156,6 +163,10 @@ reported as the final result.
156
163
  If `.godpowers` state already exists, `/god-mode --yolo` resumes from disk
157
164
  instead of asking for the project description again.
158
165
 
166
+ Under `--yolo`, Godpowers also auto-applies Pillars sync proposals when
167
+ durable `.godpowers` artifacts change project truth. The decision is logged to
168
+ `.godpowers/YOLO-DECISIONS.md`.
169
+
159
170
  For existing codebases and org-constrained new projects, God Mode now runs a
160
171
  greenfield simulation audit and then actions it through a greenfieldification
161
172
  plan. It pauses before risky artifact rewrites because that process can change
@@ -206,6 +217,20 @@ Skill updates: PROGRESS.md
206
217
  .godpowers/harden/FINDINGS.md Security Findings
207
218
  ```
208
219
 
220
+ Godpowers projects also include native Pillars context:
221
+
222
+ ```
223
+ AGENTS.md Pillars loading protocol plus Godpowers managed fence
224
+ agents/context.md Always-loaded project identity and invariants
225
+ agents/repo.md Always-loaded repository layout and naming
226
+ agents/*.md Task-routed domain pillars
227
+ ```
228
+
229
+ Existing `.godpowers` projects are Pillar-ized on resume or sync. Current PRD,
230
+ ARCH, STACK, ROADMAP, BUILD, DEPLOY, OBSERVE, HARDEN, DESIGN, and PRODUCT
231
+ artifacts become managed source references in the relevant pillar files, with
232
+ labeled decisions, hypotheses, and open questions extracted when available.
233
+
209
234
  ## Quality Guardrails
210
235
 
211
236
  Every artifact passes these mechanical checks before it is treated as complete:
@@ -265,6 +290,7 @@ Pi. T3 Code inherits from the underlying agent (Codex / Claude / OpenCode).
265
290
  - [Concepts](docs/concepts.md)
266
291
  - [Command reference (all 105 skills + 39 agents)](docs/reference.md)
267
292
  - [Roadmap](docs/ROADMAP.md)
293
+ - [1.0 Release Notes](RELEASE.md)
268
294
  - [Changelog](CHANGELOG.md)
269
295
  - [Inspiration](INSPIRATION.md)
270
296
 
package/RELEASE.md ADDED
@@ -0,0 +1,61 @@
1
+ # Godpowers 1.0.0 Release
2
+
3
+ Date: 2026-05-14
4
+
5
+ Godpowers 1.0.0 is the public adoption freeze. The goal of this release is not
6
+ to add another layer of capability, but to stop the ground from moving so real
7
+ projects can try the system, report friction, and shape the next cycle from
8
+ evidence.
9
+
10
+ ## What is stable
11
+
12
+ - 105 slash commands
13
+ - 39 specialist agents
14
+ - 13 executable workflows
15
+ - 36 intent recipes
16
+ - 15-runtime installer
17
+ - Native Pillars project context through `AGENTS.md` and `agents/*.md`
18
+ - `.godpowers/` workflow state and artifact layout
19
+ - Core schemas: intent, state, events, workflow, routing, recipes, extension
20
+ manifests
21
+ - Extension pack compatibility range for the 1.x line
22
+
23
+ ## What 1.0 means
24
+
25
+ Godpowers is the product users invoke. Pillars is the native project context
26
+ layer Godpowers installs, reads, and keeps current.
27
+
28
+ New projects get Godpowers-branded `AGENTS.md` protocol text, always-loaded
29
+ `agents/context.md` and `agents/repo.md`, and routed pillar files for stack,
30
+ architecture, data, API, UI, auth, quality, deploy, and observe concerns.
31
+
32
+ Existing `.godpowers` projects are Pillar-ized on resume or sync. Durable
33
+ signals from PRD, architecture, stack, roadmap, build, deploy, observe, harden,
34
+ design, and product artifacts are linked back into relevant pillars.
35
+
36
+ ## Freeze policy
37
+
38
+ During the adoption freeze, do not add new command families, change schema
39
+ formats, or rename public artifacts without evidence from real use.
40
+
41
+ Allowed changes:
42
+
43
+ - Critical bug fixes
44
+ - Documentation clarity
45
+ - Test coverage for frozen behavior
46
+ - Compatibility fixes for supported AI coding tools
47
+ - Small fixes that make existing 1.0 behavior work as documented
48
+
49
+ Deferred changes:
50
+
51
+ - New lifecycle phases
52
+ - New schema versions
53
+ - Pillars format changes
54
+ - Major routing semantics
55
+ - Large extension API changes
56
+
57
+ ## Adoption ask
58
+
59
+ Use Godpowers on real projects and report what breaks, what feels too heavy,
60
+ what feels magical, and what needs sharper defaults. The next release train
61
+ should be shaped by those reports rather than by more speculative surface area.
@@ -29,6 +29,11 @@ Before starting:
29
29
 
30
30
  ## Imported Preparation Context
31
31
 
32
+ Before drafting, compute the Pillars load set for the architecture task with
33
+ `lib/pillars.computeLoadSet(projectRoot, taskText)`. Read `agents/context.md`
34
+ and `agents/repo.md` first, then routed pillars such as `arch`, `stack`,
35
+ `data`, `api`, `auth`, `deploy`, or `observe` when relevant.
36
+
32
37
  If `.godpowers/prep/INITIAL-FINDINGS.md` exists, read it first for direct
33
38
  Godpowers observations about framework, tooling, deploy, tests, docs, and
34
39
  codebase risks.
@@ -50,6 +55,9 @@ Rules:
50
55
  descriptions, or open questions.
51
56
  - If imported context conflicts with the PRD, the PRD wins and the conflict
52
57
  becomes an `[OPEN QUESTION]`.
58
+ - If ARCH or ADRs create durable architectural truth, plan updates for
59
+ `agents/arch.md` and related pillars. In `--yolo`, apply those updates and
60
+ log them to `.godpowers/YOLO-DECISIONS.md`.
53
61
 
54
62
  ## Output
55
63
 
@@ -146,6 +146,31 @@ During `/god-init`, scan for adjacent methodology artifacts from GSD,
146
146
  Superpowers, BMAD, and similar systems. Treat them as preparation context,
147
147
  not as source of truth.
148
148
 
149
+ ## Native Pillars context
150
+
151
+ Every Godpowers project is also a Pillars project. During `/god-init` and
152
+ `/god-mode`, call `lib/pillars.detect(projectRoot)`. If Pillars is absent or
153
+ partial, call `lib/pillars.init(projectRoot)` before planning or build work
154
+ continues.
155
+
156
+ If `.godpowers/` already exists, call
157
+ `lib/pillars.pillarizeExisting(projectRoot)` before resume work continues.
158
+ This converts existing Godpowers artifacts into managed source references in
159
+ the relevant pillar files, so old projects are Pillar-ized as part of being
160
+ Godpower-ized.
161
+
162
+ Before each major command, compute the task-specific Pillars load set with
163
+ `lib/pillars.computeLoadSet(projectRoot, taskText)`. Load `agents/context.md`
164
+ and `agents/repo.md` first, then the routed primary pillars and their direct
165
+ `must_read_with` dependencies. Do not read every file in `agents/`; Godpowers
166
+ specialist agents also live there and are not project pillars.
167
+
168
+ When a Godpowers artifact changes durable project truth, map the artifact to
169
+ pillar sync work with `lib/pillars.planArtifactSync(projectRoot, artifacts,
170
+ { yolo })`. Default mode proposes pillar updates for review. Under `--yolo`,
171
+ apply the pillar updates immediately and log the action to
172
+ `.godpowers/YOLO-DECISIONS.md`.
173
+
149
174
  Before or alongside that import, write `.godpowers/prep/INITIAL-FINDINGS.md`
150
175
  using `templates/INITIAL-FINDINGS.md`. This artifact records what Godpowers
151
176
  observed directly during init:
@@ -407,6 +432,7 @@ for `STAGING_APP_URL=<deployed staging origin>` before deployed staging smoke.
407
432
  | Drift (breaking) | Pause | Pause anyway |
408
433
  | Impeccable critical at /god-launch | Pause | Pause anyway |
409
434
  | Impeccable warnings at launch | Pause to ack | Auto-ack with justification |
435
+ | Pillars durable context sync | Propose updates | Auto-apply and log |
410
436
  | REVIEW-REQUIRED.md auto-clear | No | No anyway |
411
437
  | Reverse-sync between tiers | Yes | Yes |
412
438
  | Mandatory final /god-sync | Always | Always |
package/agents/god-pm.md CHANGED
@@ -31,6 +31,11 @@ required sections:
31
31
 
32
32
  ## Imported Preparation Context
33
33
 
34
+ Before drafting, compute the Pillars load set for the PRD task with
35
+ `lib/pillars.computeLoadSet(projectRoot, taskText)`. Read `agents/context.md`
36
+ and `agents/repo.md` first, then any task-routed pillars. Pillars is native
37
+ project truth for Godpowers; use it before broader repo archaeology.
38
+
34
39
  If `.godpowers/prep/INITIAL-FINDINGS.md` exists, read it first so the PRD
35
40
  reflects what Godpowers observed during init: codebase shape, tests, docs,
36
41
  risks, and methodology systems detected.
@@ -48,6 +53,9 @@ Rules:
48
53
  preserve the Godpowers state and add an `[OPEN QUESTION]`.
49
54
  - In PRD rationale, mention the source only when it materially changes a
50
55
  requirement.
56
+ - If the PRD creates durable product truth, plan corresponding updates for
57
+ `agents/context.md`. In `--yolo`, apply those updates and log them to
58
+ `.godpowers/YOLO-DECISIONS.md`.
51
59
 
52
60
  ## Quality Gates
53
61
 
@@ -25,6 +25,11 @@ may exist as early product-experience preparation.
25
25
 
26
26
  ## Imported Preparation Context
27
27
 
28
+ Before sequencing, compute the Pillars load set for the roadmap task with
29
+ `lib/pillars.computeLoadSet(projectRoot, taskText)`. Read `agents/context.md`
30
+ and `agents/repo.md` first, then routed pillars that affect delivery,
31
+ quality, deploy, or observability.
32
+
28
33
  If `.godpowers/prep/INITIAL-FINDINGS.md` exists, read it first for repo risks,
29
34
  existing tests, docs, CI, deploy, and suggested sequencing implications.
30
35
 
@@ -47,6 +52,9 @@ Rules:
47
52
  - Mark any imported sequencing assumption as `[HYPOTHESIS]` until confirmed by
48
53
  Godpowers artifacts or the user.
49
54
  - Keep design-derived delivery increments grounded in the PRD and ARCH.
55
+ - If ROADMAP creates durable delivery or sequencing truth, plan updates for
56
+ relevant pillars. In `--yolo`, apply those updates and log them to
57
+ `.godpowers/YOLO-DECISIONS.md`.
50
58
 
51
59
  ## Process
52
60
 
@@ -112,6 +112,17 @@ After feature work, every artifact that was impacted needs to reflect reality.
112
112
  - Emit events: `linkage.snapshot`, `drift.detected` (per finding),
113
113
  `review-required.populated`
114
114
 
115
+ ### Pillars sync (native context)
116
+ - Call `lib/pillars.pillarizeExisting(projectRoot)` if Pillars is absent or
117
+ partial.
118
+ - For every durable Godpowers artifact changed during this sync, call
119
+ `lib/pillars.applyArtifactSync(projectRoot, changedArtifacts, { yolo })`.
120
+ - Default mode may report the pillar updates as proposed review items when the
121
+ change is interpretive. Under `--yolo`, apply the managed source sections
122
+ immediately and log the decision to `.godpowers/YOLO-DECISIONS.md`.
123
+ - Never read every file in `agents/` as project context. Only files with
124
+ `pillar:` frontmatter are Pillars files.
125
+
115
126
  ### AI-tool context refresh (always, unless never-ask)
116
127
  - Read `state.json` for `project.context-prompt-answered`
117
128
  - If `never-ask`: skip; do not touch AGENTS.md / CLAUDE.md / others