godpowers 1.0.0 → 1.6.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/templates/ARCH.md CHANGED
@@ -34,6 +34,9 @@
34
34
 
35
35
  ## Architecture Decision Records
36
36
 
37
+ Only create an ADR when all three are true: the decision is hard to reverse,
38
+ surprising without context, and the result of a real tradeoff.
39
+
37
40
  ### ADR-001: [Decision Title]
38
41
  - **Context**: [What forced this decision]
39
42
  - **Decision**: [What was chosen]
@@ -0,0 +1,50 @@
1
+ # Domain Glossary
2
+
3
+ > [DECISION] This artifact records project-specific language that planning,
4
+ > architecture, roadmap, stack, build, and docs agents must use consistently.
5
+ > [DECISION] This artifact contains domain language only, not implementation
6
+ > details, product requirements, stack choices, or scratch notes.
7
+
8
+ ## Language
9
+
10
+ ### [Domain Area]
11
+
12
+ **[Canonical Term]**: [DECISION] [One sentence defining what the term is.]
13
+ _Avoid_: [alias one], [alias two], [overloaded word to avoid]
14
+
15
+ **[Second Canonical Term]**: [DECISION] [One sentence defining what the term is.]
16
+ _Avoid_: [alias one], [alias two]
17
+
18
+ ## Relationships
19
+
20
+ - [DECISION] **[Canonical Term]** belongs to exactly one **[Other Term]**.
21
+ - [DECISION] **[Other Term]** can contain zero or more **[Canonical Term]** records.
22
+
23
+ ## Example Dialogue
24
+
25
+ > [DECISION] Dev: "When a **[Canonical Term]** changes, do we update the
26
+ > **[Other Term]** immediately?"
27
+ > [DECISION] Domain expert: "No, **[Other Term]** only changes after
28
+ > **[Third Term]** is confirmed."
29
+
30
+ ## Flagged Ambiguities
31
+
32
+ - [OPEN QUESTION] [Ambiguous word] has been used to mean [meaning A] and
33
+ [meaning B]. Owner: user. Due: before [next command].
34
+
35
+ ## Source Notes
36
+
37
+ - [HYPOTHESIS] [Term] came from [conversation, code path, imported context, or
38
+ existing docs]. Validation: confirm during [next command or user review].
39
+
40
+ ---
41
+
42
+ ## Have-Nots Checklist
43
+
44
+ - [ ] Every term is specific to this project domain.
45
+ - [ ] Every term has one canonical spelling.
46
+ - [ ] Every term has avoided aliases listed.
47
+ - [ ] Every definition is one sentence.
48
+ - [ ] Relationships use canonical terms.
49
+ - [ ] Ambiguities are resolved or captured as `[OPEN QUESTION]` with owner and due date.
50
+ - [ ] No implementation details are stored here.
@@ -7,10 +7,11 @@ apiVersion: godpowers/v1
7
7
  kind: Workflow
8
8
  metadata:
9
9
  name: bluefield-arc
10
- version: 1.2.0
10
+ version: 1.3.0
11
11
  description: |
12
12
  Bluefield: new code, existing org context. Loads org standards first,
13
- runs a greenfield simulation audit against those constraints, then runs a
13
+ runs a preflight intake against the surrounding environment, runs a
14
+ greenfield simulation audit against those constraints, then runs a
14
15
  user-approved greenfieldification pass before the full arc.
15
16
 
16
17
  on: [/god-bluefield, /god-mode --bluefield]
@@ -20,10 +21,19 @@ jobs:
20
21
  tier: 0
21
22
  uses: god-org-context-loader@^1.0.0
22
23
 
23
- greenfield-simulation-audit:
24
+ preflight:
24
25
  tier: 0
25
26
  needs: org-context
26
27
  uses: god-auditor@^1.0.0
28
+ with:
29
+ mode: preflight
30
+ scope: org-context-and-surrounding-repo
31
+ output: .godpowers/preflight/PREFLIGHT.md
32
+
33
+ greenfield-simulation-audit:
34
+ tier: 0
35
+ needs: preflight
36
+ uses: god-auditor@^1.0.0
27
37
  with:
28
38
  mode: greenfield-simulation
29
39
  compare: canonical-godpowers-arc-to-org-constraints
@@ -7,17 +7,26 @@ apiVersion: godpowers/v1
7
7
  kind: Workflow
8
8
  metadata:
9
9
  name: brownfield-arc
10
- version: 1.2.0
10
+ version: 1.3.0
11
11
  description: |
12
- Brownfield: existing codebase, understand before changing. Archaeology +
13
- reconstruction + debt assessment + greenfield simulation audit, then a
14
- user-approved greenfieldification pass before normal arc workflows.
12
+ Brownfield: existing codebase, inspect before prescribing. Preflight +
13
+ archaeology + reconstruction + debt assessment + greenfield simulation
14
+ audit, then a user-approved greenfieldification pass before normal arc
15
+ workflows.
15
16
 
16
17
  on: [/god-brownfield, /god-mode --brownfield]
17
18
 
18
19
  jobs:
20
+ preflight:
21
+ tier: 0
22
+ uses: god-auditor@^1.0.0
23
+ with:
24
+ mode: preflight
25
+ output: .godpowers/preflight/PREFLIGHT.md
26
+
19
27
  archaeology:
20
28
  tier: 0
29
+ needs: preflight
21
30
  uses: god-archaeologist@^1.0.0
22
31
 
23
32
  reconstruct: