godpowers 0.15.18 → 1.6.0

package/skills/god-preflight.md

@@ -0,0 +1,147 @@
+---
+name: god-preflight
+description: |
+  Run a read-only intake audit before arc-ready, pillars, archaeology, or
+  reconstruction work. Inventory the codebase, surface blockers, and recommend
+  the safest next pass without changing project code.
+
+  Triggers on: "god preflight", "/god-preflight", "preflight audit",
+  "audit before arc-ready", "audit before pillars", "intake audit"
+---
+
+# /god-preflight
+
+Read-only intake audit for an existing codebase.
+
+## When to use
+
+- Before applying arc-ready direction to an existing repo
+- Before scoring the repo against pillars
+- Before brownfield archaeology or reconstruction
+- When deciding whether to restructure, refactor, initialize Godpowers, or pause
+
+## Purpose
+
+This command diagnoses the repo before stronger workflows touch it.
+
+It answers:
+
+- What kind of project is this?
+- What structure, tooling, tests, docs, CI, deploy paths, and agent instructions exist?
+- What is missing before arc-ready can make good decisions?
+- Which pillar weaknesses are already visible?
+- What areas are risky to refactor before more evidence exists?
+- What is the safest next pass?
+
+## Process
+
+1. Verify the target directory contains code or project configuration.
+2. Create `.godpowers/preflight/` if needed.
+3. Inspect the repo read-only:
+   - package manifests, lockfiles, build files, test config, CI config
+   - source tree shape, entry points, module boundaries, scripts
+   - README, docs, ADRs, architecture notes, env examples, AGENTS.md
+   - test presence, test command discoverability, coverage signals
+   - deploy, observability, security, dependency, and ownership signals
+4. Produce `.godpowers/preflight/PREFLIGHT.md`.
+5. Do not edit source files, planning artifacts, configs, or docs outside
+   `.godpowers/preflight/`.
+
+## Scoring
+
+Score only what can be supported by repo evidence.
+
+Use these dimensions:
+
+| Dimension | Looks for |
+|---|---|
+| Repo shape | Project type, framework, package manager, entry points, source layout |
+| Arc readiness | Product direction, architecture notes, roadmap, deploy story, decision records |
+| Pillar readiness | Tests, security, docs, observability, maintainability, UX, deployability |
+| Godpowers readiness | Disk artifacts, AGENTS.md, commands, progress state, safe agent boundaries |
+| Refactor risk | Coupling, missing tests, unclear ownership, ambiguous runtime paths |
+| Suite signals | Multi-package or multi-repo structure, shared packages, release coordination |
+
+Scores are directional, not final quality grades. The value is the evidence and
+the sequence.
+
+## Output
+
+The report must be plain and evidence-backed. Every recommendation must explain
+why it comes before the next one.
+
+Write `.godpowers/preflight/PREFLIGHT.md`:
+
+```markdown
+# Godpowers Preflight
+
+Date: [timestamp]
+Target: [path]
+
+## Snapshot
+
+- DECISION: Project type is [type] because [files or commands].
+- HYPOTHESIS: Primary runtime appears to be [runtime] because [evidence].
+- OPEN QUESTION: [question that blocks confident planning].
+
+## Readiness Scores
+
+| Lens | Score | Evidence | Main blocker |
+|---|---:|---|---|
+| Arc-ready | [0-100] | [specific files or absence] | [blocker] |
+| Pillars | [0-100] | [specific files or absence] | [blocker] |
+| Godpowers | [0-100] | [specific files or absence] | [blocker] |
+| Ready-suite | [0-100 or N/A] | [specific files or absence] | [blocker] |
+
+## Inventory
+
+- DECISION: [thing found] at `[path]`.
+- HYPOTHESIS: [thing inferred] from `[path]`.
+
+## Blockers Before Arc-Ready
+
+1. DECISION: [blocker].
+   Evidence: `[path]` or missing `[path]`.
+   Next move: [specific command or artifact].
+
+## Pillar Weaknesses
+
+1. DECISION: [weakness].
+   Evidence: `[path]` or missing `[path]`.
+   Impact: [why it matters].
+
+## Refactor Risk
+
+1. HYPOTHESIS: [risk].
+   Evidence: `[path]`.
+   Avoid until: [needed proof or test].
+
+## Recommended Sequence
+
+1. DECISION: Run [next command or task] first because [reason].
+2. DECISION: Run [next command or task] second because [reason].
+3. DECISION: Defer [task] until [condition].
+```
+
+## Routing Guidance
+
+Use the report to choose the next pass:
+
+| Finding | Suggested next |
+|---|---|
+| Missing basic project state | `/god-init` |
+| Unknown legacy structure | `/god-archaeology` |
+| Existing code lacks planning artifacts | `/god-reconstruct` |
+| Debt dominates delivery risk | `/god-tech-debt` |
+| Artifacts exist but quality is unknown | `/god-audit` |
+| Tests are absent before refactor | `/god-add-tests` |
+| Refactor path is obvious and bounded | `/god-refactor` |
+
+## Guardrails
+
+- Build nothing.
+- Do not modify application code.
+- Do not normalize formatting.
+- Do not create roadmap, PRD, architecture, or pillar artifacts.
+- Do not score by vibe. Tie every score to evidence.
+- Prefer "unknown" over confident invention.

package/skills/god-version.md

@@ -14,9 +14,9 @@ Print version and a short capability summary.
 ## Output
 
 ```
-Godpowers v0.15.18
+Godpowers v1.6.0
 Install: /Users/.../.claude/  (matches package.json)
-Surface: 105 skills, 39 agents, 13 workflows, 36 recipes
+Surface: 106 skills, 39 agents, 13 workflows, 36 recipes
 Schema: intent.v1, state.v1, events.v1, workflow.v1, routing.v1, recipe.v1
 External integrations available: impeccable, agent-browser (others lazy)
 ```

package/templates/ARCH.md

@@ -34,6 +34,9 @@
 
 ## Architecture Decision Records
 
+Only create an ADR when all three are true: the decision is hard to reverse,
+surprising without context, and the result of a real tradeoff.
+
 ### ADR-001: [Decision Title]
 - **Context**: [What forced this decision]
 - **Decision**: [What was chosen]

package/templates/DOMAIN-GLOSSARY.md

@@ -0,0 +1,50 @@
+# Domain Glossary
+
+> [DECISION] This artifact records project-specific language that planning,
+> architecture, roadmap, stack, build, and docs agents must use consistently.
+> [DECISION] This artifact contains domain language only, not implementation
+> details, product requirements, stack choices, or scratch notes.
+
+## Language
+
+### [Domain Area]
+
+**[Canonical Term]**: [DECISION] [One sentence defining what the term is.]
+_Avoid_: [alias one], [alias two], [overloaded word to avoid]
+
+**[Second Canonical Term]**: [DECISION] [One sentence defining what the term is.]
+_Avoid_: [alias one], [alias two]
+
+## Relationships
+
+- [DECISION] **[Canonical Term]** belongs to exactly one **[Other Term]**.
+- [DECISION] **[Other Term]** can contain zero or more **[Canonical Term]** records.
+
+## Example Dialogue
+
+> [DECISION] Dev: "When a **[Canonical Term]** changes, do we update the
+> **[Other Term]** immediately?"
+> [DECISION] Domain expert: "No, **[Other Term]** only changes after
+> **[Third Term]** is confirmed."
+
+## Flagged Ambiguities
+
+- [OPEN QUESTION] [Ambiguous word] has been used to mean [meaning A] and
+  [meaning B]. Owner: user. Due: before [next command].
+
+## Source Notes
+
+- [HYPOTHESIS] [Term] came from [conversation, code path, imported context, or
+  existing docs]. Validation: confirm during [next command or user review].
+
+---
+
+## Have-Nots Checklist
+
+- [ ] Every term is specific to this project domain.
+- [ ] Every term has one canonical spelling.
+- [ ] Every term has avoided aliases listed.
+- [ ] Every definition is one sentence.
+- [ ] Relationships use canonical terms.
+- [ ] Ambiguities are resolved or captured as `[OPEN QUESTION]` with owner and due date.
+- [ ] No implementation details are stored here.

package/workflows/bluefield-arc.yaml

@@ -7,10 +7,11 @@ apiVersion: godpowers/v1
 kind: Workflow
 metadata:
   name: bluefield-arc
-  version: 1.2.0
+  version: 1.3.0
   description: |
     Bluefield: new code, existing org context. Loads org standards first,
-    runs a greenfield simulation audit against those constraints, then runs a
+    runs a preflight intake against the surrounding environment, runs a
+    greenfield simulation audit against those constraints, then runs a
     user-approved greenfieldification pass before the full arc.
 
 on: [/god-bluefield, /god-mode --bluefield]
@@ -20,10 +21,19 @@ jobs:
     tier: 0
     uses: god-org-context-loader@^1.0.0
 
-  greenfield-simulation-audit:
+  preflight:
     tier: 0
     needs: org-context
     uses: god-auditor@^1.0.0
+    with:
+      mode: preflight
+      scope: org-context-and-surrounding-repo
+      output: .godpowers/preflight/PREFLIGHT.md
+
+  greenfield-simulation-audit:
+    tier: 0
+    needs: preflight
+    uses: god-auditor@^1.0.0
     with:
       mode: greenfield-simulation
       compare: canonical-godpowers-arc-to-org-constraints

package/workflows/brownfield-arc.yaml

@@ -7,17 +7,26 @@ apiVersion: godpowers/v1
 kind: Workflow
 metadata:
   name: brownfield-arc
-  version: 1.2.0
+  version: 1.3.0
   description: |
-    Brownfield: existing codebase, understand before changing. Archaeology +
-    reconstruction + debt assessment + greenfield simulation audit, then a
-    user-approved greenfieldification pass before normal arc workflows.
+    Brownfield: existing codebase, inspect before prescribing. Preflight +
+    archaeology + reconstruction + debt assessment + greenfield simulation
+    audit, then a user-approved greenfieldification pass before normal arc
+    workflows.
 
 on: [/god-brownfield, /god-mode --brownfield]
 
 jobs:
+  preflight:
+    tier: 0
+    uses: god-auditor@^1.0.0
+    with:
+      mode: preflight
+      output: .godpowers/preflight/PREFLIGHT.md
+
   archaeology:
     tier: 0
+    needs: preflight
     uses: god-archaeologist@^1.0.0
 
   reconstruct: