godpowers 0.15.0

package/INSPIRATION.md

@@ -0,0 +1,52 @@
+# Inspiration
+
+> The single canonical place where godpowers acknowledges its
+> intellectual ancestry. Outside this file, the rest of the repo
+> reads as standalone work.
+
+Godpowers was shaped by ideas from several existing AI coding workflow
+systems. The four direct ancestors were:
+
+- **GSD** by Hanns Princivil ([github.com/aihxp/gsd](https://github.com/aihxp/gsd)) - pure-skill model, slash commands inside AI tools, TDD enforcement, critical-finding gate with autonomous-mode carve-out
+- **Superpowers** by Anthropic ([github.com/anthropics/skills](https://github.com/anthropics/skills)) - subagent specialization with strict hand-off contracts, fresh-context isolation, two-stage review pipelines
+- **BMAD-METHOD** ([github.com/bmad-code-org/BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD)) - story-file workflow for incremental delivery, multi-phase methodology
+- **arc-ready / arc-anything** - artifact-quality discipline (substitution test, three-label test, named have-nots catalog)
+
+Beyond what was inherited, godpowers added:
+
+- **Bidirectional linkage** between artifact elements and code files,
+  with 8 stable ID types and 6 discovery mechanisms
+- **Reverse-sync** that writes fenced "Implementation Linkage"
+  footers back to artifacts after code changes
+- **Three-axis verification system**: static (mechanical lint),
+  linkage (drift detection), runtime (headless browser audit +
+  PRD acceptance flow assertions)
+- **Conditional design pipeline**: DESIGN.md (Google Labs spec) +
+  PRODUCT.md, gated through a two-stage design review
+- **Multi-repo coordination** (Mode D) via a Tier-0 peer agent,
+  preserving the per-repo single-orchestrator rule
+- **Detect-and-delegate philosophy** for external tools (currently
+  Google Labs design.md, Impeccable, awesome-design-md, SkillUI,
+  vercel-labs/agent-browser + Playwright; never vendored)
+- **Story-file workflow** as a finer slice between feature and commit
+- **Light-impeccable internal references** (7 design domain refs)
+  for the case where Impeccable is not installed
+- **AI-tool context writer** that maintains fenced sections in
+  AGENTS.md / CLAUDE.md / GEMINI.md and 11 other tool-specific paths
+
+## Why this is the only mention
+
+Acknowledging influences once, in a single dedicated file, keeps the
+rest of the repo focused on what godpowers IS rather than what it
+came from. New contributors and AI agents reading the codebase don't
+need a context-load of comparative history every time they open a
+docs file.
+
+## License posture
+
+Godpowers itself: MIT (see LICENSE).
+
+External integrations are detected at runtime and never vendored;
+each retains its own license. Catalogs (e.g., the 71-site catalog
+metadata in `lib/awesome-design.js`) are derivative facts; the
+upstream repos stay authoritative for content.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Godpowers
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,232 @@
+# Godpowers
+
+[![CI](https://github.com/aihxp/godpowers/actions/workflows/ci.yml/badge.svg)](https://github.com/aihxp/godpowers/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Version](https://img.shields.io/badge/version-0.14.0-blue)](CHANGELOG.md)
+
+**Ship fast. Ship right. Ship everything. Ship accountably.**
+
+Godpowers is an AI-powered development system that takes a project from raw
+idea to hardened production. It runs as **slash commands inside your AI coding
+tool** (Claude Code, Codex, Cursor, etc.) that orchestrate **specialist agents**
+in fresh contexts to do the work.
+
+It fuses four disciplines into one unified workflow:
+
+- **Artifact discipline** - every sentence in every document is a labeled
+  decision, hypothesis, or open question. Mechanically verified failure modes.
+- **Execution engine** - fresh-context agents in parallel waves with atomic
+  commits. No context rot. No sequential bottlenecks.
+- **Quality immune system** - TDD enforcement, two-stage code review (spec
+  compliance + code quality), verification before completion.
+- **Team intelligence** - scale-adaptive complexity, specialized agent personas
+  (PM, Architect, Executor, Reviewer, Harden Auditor, etc.).
+
+## Install
+
+```bash
+npx godpowers --claude --global
+```
+
+Other targets: `--codex`, `--cursor`, `--windsurf`, `--opencode`, `--gemini`,
+`--copilot`, `--augment`, `--trae`, `--cline`, `--kilo`, `--antigravity`,
+`--qwen`, `--codebuddy`, `--pi`. Or `--all` for everything (15 runtimes).
+T3 Code is transparently supported through the underlying agent.
+
+The installer copies:
+- Slash command skills to `<runtime>/skills/`
+- Specialist agents to `<runtime>/agents/`
+- SessionStart hook (Claude Code only) to `<runtime>/hooks/`
+
+## Usage
+
+Open your AI coding tool in any project directory and type:
+
+```
+/god-mode
+```
+
+That's the autonomous arc. It will run all tiers from idea to hardened
+production, pausing only when it has a real question for you.
+
+### Just describe what you want
+
+If you don't know which command to run, type free text after `/god`:
+
+```
+/god production is broken
+/god add a feature without breaking the current arc
+/god I'm coming back after a week
+```
+
+The front door matches your intent against scenario recipes and proposes the
+right command sequence. Confirmation is always required before anything
+destructive runs. See `skills/god.md`.
+
+### Don't want full autonomy?
+
+Run individual commands. After each one finishes, Godpowers tells you what to
+run next based on disk state:
+
+```
+PRD complete: .godpowers/prd/PRD.md
+
+Suggested next: /god-arch (design the architecture)
+```
+
+You can also ask any time:
+
+```
+/god-next
+```
+
+This reads `.godpowers/PROGRESS.md`, scans disk, reconciles any drift, and
+suggests the next logical command. The SessionStart hook does the same thing
+when you open a new session in a Godpowers project.
+
+### Slash Commands
+
+| Command | What it does | Spawns agent |
+|---------|--------------|--------------|
+| `/god` | Front door: match free-text intent to a command sequence | (built-in) |
+| `/god-mode` | Full autonomous arc | god-orchestrator |
+| `/god-next` | Auto-detect and suggest the next command | (built-in) |
+| `/god-init` | Start a project, detect mode and scale | (built-in) |
+| `/god-prd` | Write the PRD | god-pm |
+| `/god-arch` | Design architecture | god-architect |
+| `/god-roadmap` | Sequence the work | god-roadmapper |
+| `/god-stack` | Pick the technology stack | god-stack-selector |
+| `/god-design` | Visual design system (DESIGN.md + PRODUCT.md) | god-designer + god-design-reviewer |
+| `/god-repo` | Scaffold the repository | god-repo-scaffolder |
+| `/god-build` | Build it (TDD, parallel waves) | god-planner + god-executor + reviewers |
+| `/god-deploy` | Set up deploy pipeline | god-deploy-engineer |
+| `/god-observe` | Wire observability | god-observability-engineer |
+| `/god-launch` | Launch (gated on harden) | god-launch-strategist |
+| `/god-harden` | Adversarial security review | god-harden-auditor |
+| `/god-status` | Re-derive state from disk | (built-in) |
+| `/god-audit` | Score artifacts against have-nots | god-auditor |
+| `/god-debug` | 4-phase systematic debug | god-debugger |
+| `/god-review` | Two-stage code review | god-spec-reviewer + god-quality-reviewer |
+| `/god-lint` | Mechanically validate artifacts against have-nots | (built-in) |
+| `/god-scan` | Rebuild linkage map from code; run reverse-sync | (built-in) |
+| `/god-link` | Manually add or remove a code-artifact link | (built-in) |
+| `/god-design-impact` | What-if analysis on DESIGN.md changes | (built-in) |
+| `/god-review-changes` | Walk REVIEW-REQUIRED.md interactively | (built-in) |
+| `/god-context` | Manage AGENTS.md / CLAUDE.md / GEMINI.md fences | god-context-writer |
+| `/god-test-runtime` | Headless browser audit + functional tests | god-browser-tester |
+
+### Other Workflows
+
+For real-world scenarios beyond greenfield:
+
+| Command | When to use | Spawns |
+|---------|-------------|--------|
+| `/god-feature` | Add a feature to an existing project | god-pm + god-architect (delta) + executor chain |
+| `/god-hotfix` | Urgent production bug fix | god-debugger + god-executor + reviewers + deploy |
+| `/god-refactor` | Safe refactor with TDD (no behavior change) | god-explorer + god-planner + executor chain |
+| `/god-spike` | Time-boxed research with throwaway POC | god-spike-runner |
+| `/god-postmortem` | Post-incident investigation | god-incident-investigator |
+| `/god-upgrade` | Framework/version migration with expand-contract | god-migration-strategist |
+| `/god-docs` | Write/update docs verified against code | god-docs-writer |
+| `/god-update-deps` | Audit and update dependencies safely | god-deps-auditor |
+
+### God Mode Flags
+
+```
+/god-mode                # Standard: pauses for real questions only
+/god-mode --yolo         # Zero pauses. Picks every default. Full send.
+/god-mode --conservative # More checkpoints
+/god-mode --from=arch    # Resume from a specific tier
+/god-mode --audit        # Score existing artifacts. Build nothing.
+/god-mode --dry-run      # Plan everything. Build nothing.
+```
+
+## Architecture
+
+### Slash Command + Specialist Agent Pattern
+
+Each slash command is a **thin orchestrator**. It does NOT do the work itself.
+It spawns the right specialist agent in a **fresh context** to do the work.
+
+```
+You type:        /god-prd
+Skill loads:     skills/god-prd.md
+Skill spawns:    god-pm agent (fresh 200K context)
+Agent reads:     .godpowers/PROGRESS.md
+Agent writes:    .godpowers/prd/PRD.md
+Skill verifies:  artifact exists, have-nots pass
+Skill updates:   PROGRESS.md
+```
+
+### The Four Tiers
+
+| Tier | Sub-steps | Specialists |
+|------|-----------|-------------|
+| 0: Orchestration | mode detection, scale, progress | god-orchestrator |
+| 1: Planning | PRD, ARCH, ROADMAP, STACK | god-pm, god-architect, god-roadmapper, god-stack-selector |
+| 2: Building | repo, plan, execute, review | god-repo-scaffolder, god-planner, god-executor, god-spec-reviewer, god-quality-reviewer |
+| 3: Shipping | deploy, observe, launch, harden | god-deploy-engineer, god-observability-engineer, god-launch-strategist, god-harden-auditor |
+
+### Artifact Paths
+
+```
+.godpowers/PROGRESS.md         Cross-tier progress ledger
+.godpowers/prd/PRD.md          Product Requirements Document
+.godpowers/arch/ARCH.md        System Architecture
+.godpowers/arch/adr/           Architecture Decision Records
+.godpowers/roadmap/ROADMAP.md  Sequenced Roadmap
+.godpowers/stack/DECISION.md   Stack Decision (with flip points)
+.godpowers/repo/AUDIT.md       Repo Scaffold Audit
+.godpowers/build/PLAN.md       Build Plan (slices, waves)
+.godpowers/build/STATE.md      Build State
+.godpowers/deploy/STATE.md     Deploy Pipeline State
+.godpowers/observe/STATE.md    Observability State
+.godpowers/launch/STATE.md     Launch State
+.godpowers/harden/FINDINGS.md  Security Findings
+```
+
+## Quality Guarantees
+
+Every artifact passes these mechanical checks:
+
+| Check | What it catches |
+|---|---|
+| Substitution test | AI-slop (generic output that reads the same for any product) |
+| Three-label test | Unlabeled assumptions hiding as decisions |
+| Have-nots | Named failure modes, grep-testable per tier |
+| Artifact-on-disk | Phantom resume (agent claims done, file does not exist) |
+| Critical-finding gate | Shipping with known security holes |
+| TDD enforcement | Code without tests |
+| Two-stage review | Code that passes tests but violates spec or quality |
+
+## Pause Philosophy
+
+God Mode pauses only when:
+
+1. User intent is genuinely ambiguous (two valid directions)
+2. A flip-point depends on human-only constraints (team size, budget)
+3. Two options score within 10% with no objective tiebreaker
+4. A Critical security finding needs human judgment
+5. Brand/copy decisions require the human's voice
+
+Every pause includes: what the question is, why only the human can answer,
+options with tradeoffs, and a default if the user just says "go".
+
+## Supported Tools
+
+15 first-class runtimes: Claude Code, Codex, Cursor, Windsurf, Gemini CLI,
+OpenCode, Copilot, Augment, Trae, Cline, Kilo, Antigravity, Qwen, CodeBuddy,
+Pi. T3 Code inherits from the underlying agent (Codex / Claude / OpenCode).
+
+## Full reference
+
+- [Getting Started](docs/getting-started.md)
+- [Concepts](docs/concepts.md)
+- [Command reference (all 82 skills + 38 agents)](docs/reference.md)
+- [Roadmap](docs/ROADMAP.md)
+- [Changelog](CHANGELOG.md)
+- [Inspiration](INSPIRATION.md)
+
+## License
+
+MIT