opengstack 0.13.4 → 0.13.5

package/README.md

@@ -1,80 +1,59 @@
 # OpenGStack
 
-Open source engineering workflow skills for AI coding assistants.
-
-Forked from [garrytan/gstack](https://github.com/garrytan/gstack) with telemetry and YC references removed.
-
-## What is this?
-
-Skills that give AI agents structured roles for software development. Each skill is a specialist: CEO reviewer, eng manager, designer, QA lead, release engineer, debugger, and more.
-
-## Available Skills
-
-| Skill | What it does |
-|-------|--------------|
-| `/office-hours` | Brainstorm your product idea before you write code. |
-| `/plan-ceo-review` | CEO-level review: find the 10-star product in the request. |
-| `/plan-eng-review` | Lock architecture, data flow, edge cases, and tests. |
-| `/plan-design-review` | Rate each design dimension 0-10, explain what a 10 looks like. |
-| `/design-consultation` | Build a complete design system from scratch. |
-| `/design-review` | Design audit + fix loop with atomic commits. |
-| `/review` | Pre-landing PR review. Finds bugs that pass CI but break in prod. |
-| `/investigate` | Systematic root-cause debugging. |
-| `/qa` | Open a real browser, find bugs, fix them, re-verify. |
-| `/qa-only` | Same as /qa but report only — no code changes. |
-| `/ship` | Run tests, review, push, open PR. One command. |
-| `/land-and-deploy` | Merge PR, deploy, verify health. |
-| `/document-release` | Update all docs to match what you just shipped. |
-| `/retro` | Weekly retro with per-person breakdowns and shipping streaks. |
-| `/browse` | Headless browser — real Chromium, real clicks, ~100ms/command. |
-| `/setup-browser-cookies` | Import cookies from your real browser for authenticated testing. |
-| `/careful` | Warn before destructive commands (rm -rf, DROP TABLE, force-push). |
-| `/freeze` | Lock edits to one directory. Hard block, not just a warning. |
-| `/guard` | Activate both careful + freeze at once. |
-| `/unfreeze` | Remove directory edit restrictions. |
-| `/autoplan` | Run all reviews sequentially with auto-decisions. |
-| `/codex` | OpenAI Codex CLI wrapper for code review. |
-| `/canary` | Post-deploy monitoring. |
-| `/benchmark` | Performance regression detection. |
-| `/cso` | Security audit. |
+AI engineering workflow skills for Claude/opencode. No telemetry. No tracking.
 
 ## Installation
 
-### For Claude Code / OpenCode
-
 ```bash
-# Clone to your skills directory
-git clone https://github.com/Ambisphaeric/opengstack.git ~/.claude/skills/opengstack
+npm install -g opengstack
 ```
 
-### Browse Setup (optional but recommended)
+Skills auto-install to `~/.claude/skills/` via symlink.
 
-```bash
-cd ~/.claude/skills/opengstack/browse
-./setup
-```
-
-Requires `bun`: `curl -fsSL https://bun.sh/install | bash`
-
-## No Telemetry
-
-This fork removes all telemetry, analytics, and tracking from the original gstack. Your usage data stays on your machine.
-
-## Syncing from Upstream
-
-This repo auto-syncs daily from `garrytan/gstack` via GitHub Actions. Filters are applied to remove telemetry and YC references.
-
-To sync manually:
+## CLI
 
 ```bash
-git remote add upstream https://github.com/garrytan/gstack.git
-git fetch upstream main
-git merge upstream/main
-./scripts/filter_skills.py .
-./scripts/cleanup.py .
-git commit -m "chore: sync from upstream"
+opengstack --help       # Show all commands
+opengstack --list       # List available skills
+opengstack --install    # Re-install skills (if needed)
 ```
 
+## Usage
+
+In opencode/Claude, type any skill name with `/`:
+
+| Command | What it does |
+|---------|--------------|
+| `/office-hours` | Brainstorm before building |
+| `/plan-ceo-review` | CEO-level strategic review |
+| `/plan-eng-review` | Lock architecture & edge cases |
+| `/plan-design-review` | Rate design decisions 0-10 |
+| `/design-consultation` | Build a design system from scratch |
+| `/design-review` | Design audit + fix loop |
+| `/review` | Pre-landing PR review |
+| `/investigate` | Root-cause debugging |
+| `/qa` | Open browser, find bugs, fix, verify |
+| `/qa-only` | QA report only — no code changes |
+| `/ship` | Run tests, review, push, open PR |
+| `/land-and-deploy` | Merge PR, deploy, verify health |
+| `/document-release` | Update docs post-ship |
+| `/retro` | Weekly engineering retrospective |
+| `/browse` | Headless browser (real Chromium) |
+| `/setup-browser-cookies` | Import cookies for auth testing |
+| `/careful` | Warn before destructive ops |
+| `/freeze` | Lock edits to one directory |
+| `/guard` | Activate careful + freeze |
+| `/unfreeze` | Remove directory restrictions |
+| `/autoplan` | Run all reviews auto-decisioned |
+| `/codex` | OpenAI Codex CLI wrapper |
+| `/canary` | Post-deploy monitoring |
+| `/benchmark` | Performance regression detection |
+| `/cso` | Security audit |
+
+## Why OpenGStack?
+
+Forked from [garrytan/gstack](https://github.com/garrytan/gstack) with telemetry and vendor references removed. Your usage stays local.
+
 ## License
 
 MIT

package/bin/opengstack.js

@@ -0,0 +1,160 @@
+#!/usr/bin/env node
+
+/**
+ * OpenGStack CLI - Run skills directly from command line
+ * Usage: opengstack <skill-name> [args...]
+ * Example: opengstack ship
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const PKG_DIR = path.dirname(__dirname);
+const SKILLS_DIR = path.join(process.env.HOME || process.env.USERPROFILE, '.claude', 'skills');
+
+// Map of skill names to their directories
+const skillMap = {
+  'ship': 'ship',
+  'qa': 'qa',
+  'qa-only': 'qa-only',
+  'review': 'review',
+  'investigate': 'investigate',
+  'design-review': 'design-review',
+  'plan-ceo-review': 'plan-ceo-review',
+  'plan-eng-review': 'plan-eng-review',
+  'plan-design-review': 'plan-design-review',
+  'office-hours': 'office-hours',
+  'design-consultation': 'design-consultation',
+  'design-shotgun': 'design-shotgun',
+  'document-release': 'document-release',
+  'retro': 'retro',
+  'browse': 'browse',
+  'setup-browser-cookies': 'setup-browser-cookies',
+  'setup-deploy': 'setup-deploy',
+  'careful': 'careful',
+  'freeze': 'freeze',
+  'guard': 'guard',
+  'unfreeze': 'unfreeze',
+  'autoplan': 'autoplan',
+  'codex': 'codex',
+  'canary': 'canary',
+  'benchmark': 'benchmark',
+  'cso': 'cso',
+  'connect-chrome': 'connect-chrome',
+  'land-and-deploy': 'land-and-deploy',
+  'gstack-upgrade': 'gstack-upgrade'
+};
+
+function showHelp() {
+  console.log(`
+OpenGStack - AI Engineering Workflow Skills
+
+Usage: opengstack <command> [options]
+
+Commands:
+  ship              Ship workflow: test, review, push, PR
+  qa                Open browser, find bugs, fix, verify
+  qa-only           QA report only — no code changes
+  review            Pre-landing PR review
+  investigate       Root-cause debugging
+  design-review     Design audit + fix loop
+  plan-ceo-review   CEO-level strategic review
+  plan-eng-review   Lock architecture & edge cases
+  plan-design-review Rate design decisions 0-10
+  office-hours      Brainstorm before building
+  design-consultation Build a design system from scratch
+  design-shotgun    Generate multiple AI design variants
+  document-release  Update docs post-ship
+  retro             Weekly engineering retrospective
+  browse            Headless browser (real Chromium)
+  setup-browser-cookies Import cookies for auth testing
+  setup-deploy      Configure deployment settings
+  careful           Warn before destructive ops
+  freeze            Lock edits to one directory
+  guard             Activate careful + freeze
+  unfreeze          Remove directory restrictions
+  autoplan          Run all reviews auto-decisioned
+  codex             OpenAI Codex CLI wrapper
+  canary            Post-deploy monitoring
+  benchmark         Performance regression detection
+  cso               Security audit
+  connect-chrome    Launch Chrome with Side Panel
+  land-and-deploy   Merge PR, deploy, verify health
+  gstack-upgrade    Upgrade gstack to latest version
+
+Options:
+  -h, --help        Show this help message
+  -l, --list        List all available skills
+  -i, --install     Install skills to ~/.claude/skills/
+
+In opencode/Claude, use /slash commands:
+  /ship, /qa, /review, etc.
+`);
+}
+
+function listSkills() {
+  console.log('\nAvailable skills:\n');
+  Object.entries(skillMap).forEach(([cmd, dir]) => {
+    const skillPath = path.join(SKILLS_DIR, dir, 'SKILL.md');
+    let description = '';
+    if (fs.existsSync(skillPath)) {
+      const content = fs.readFileSync(skillPath, 'utf8');
+      const match = content.match(/description:\s*\|?\s*([^\n]+)/);
+      if (match) {
+        description = match[1].trim().substring(0, 60);
+        if (description.length === 60) description += '...';
+      }
+    }
+    console.log(`  ${cmd.padEnd(20)} ${description}`);
+  });
+  console.log('');
+}
+
+function installSkills() {
+  console.log('Installing skills...');
+  require('../scripts/install-skills.js');
+}
+
+function main() {
+  const args = process.argv.slice(2);
+  const command = args[0];
+
+  if (!command || command === '-h' || command === '--help') {
+    showHelp();
+    process.exit(0);
+  }
+
+  if (command === '-l' || command === '--list') {
+    listSkills();
+    process.exit(0);
+  }
+
+  if (command === '-i' || command === '--install') {
+    installSkills();
+    process.exit(0);
+  }
+
+  const skillDir = skillMap[command];
+  if (!skillDir) {
+    console.error(`Unknown command: ${command}`);
+    console.error('Run "opengstack --help" for available commands');
+    process.exit(1);
+  }
+
+  // Check if skill is installed
+  const skillPath = path.join(SKILLS_DIR, skillDir, 'SKILL.md');
+  if (!fs.existsSync(skillPath)) {
+    console.error(`Skill "${command}" not installed.`);
+    console.error('Run: opengstack --install');
+    process.exit(1);
+  }
+
+  // Print instructions for using the skill
+  console.log(`\n🎯 Skill: ${command}`);
+  console.log(`📍 Location: ${skillPath}`);
+  console.log(`\nTo use this skill in opencode/Claude, type:`);
+  console.log(`  /${command}\n`);
+  console.log('The skill instructions will be loaded automatically.\n');
+}
+
+main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opengstack",
-  "version": "0.13.4",
+  "version": "0.13.5",
   "private": false,
   "description": "AI Engineering Workflow - SKILL.md files that give AI agents structured roles for software development. Forked from gstack but scrubbed clean of all the YC/Garry Tan cruft and telemetry.",
   "keywords": [
@@ -24,6 +24,9 @@
   "author": "Ambisphaeric",
   "type": "commonjs",
   "main": "SKILL.md",
+  "bin": {
+    "opengstack": "./bin/opengstack.js"
+  },
   "directories": {
     "doc": "docs"
   },
@@ -35,9 +38,11 @@
     "**/SKILL.md",
     "**/SKILL.md.tmpl",
     "scripts/",
-    "docs/"
+    "docs/",
+    "bin/"
   ],
   "scripts": {
+    "postinstall": "node scripts/install-skills.js",
     "test": "echo \"Error: no test specified\" && exit 1"
   }
 }

package/scripts/filter_skills.py

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
 """
-opengstack filter script
-Removes telemetry, YC references, garrytan slop from gstack skills
+opengstack filter script - NUKE MODE
+Removes ALL telemetry, YC references, Garry Tan content, and gstack branding
 """
 
 import re
@@ -10,95 +10,119 @@ from pathlib import Path
 
 
 def filter_skill_content(content: str) -> str:
-    """Apply all filters to skill content"""
+    """NUKE all gstack slop from skills"""
 
-    # Remove telemetry preamble block (from _UPD to closing brace)
-    preamble_pattern = r"```bash\n_UPD=.*?(?=\n```|\n\n[A-Z#])"
-    content = re.sub(preamble_pattern, "", content, flags=re.DOTALL)
+    # STEP 1: Remove entire telemetry preamble blocks
+    # Match from ```bash to next ```, containing telemetry variables
+    content = re.sub(r"```bash\s*\n_UPD=.*?```\s*\n", "", content, flags=re.DOTALL)
 
-    # Remove LAKE_INTRO / Completeness Principle section
-    lake_pattern = r"If `LAKE_INTRO` is `no`:.*?`touch ~\/\.gstack\/\.completeness-intro-seen`\n```\n.*?```\n"
-    content = re.sub(lake_pattern, "", content, flags=re.DOTALL)
+    # Remove any remaining bash blocks with .gstack/ references
+    content = re.sub(
+        r"```bash\s*\n.*?\.gstack/.*?(?=```)", "", content, flags=re.DOTALL
+    )
 
-    # Remove telemetry prompts section
-    tel_pattern = (
-        r"If `TEL_PROMPTED` is `no` AND.*?(?=If `PROACTIVE_PROMPTED`|## Voice)"
+    # STEP 2: Remove entire sections about telemetry/config
+    content = re.sub(
+        r"If `TEL_PROMPTED` is.*?touch ~/.gstack/\.telemetry-prompted.*?```\s*\n?",
+        "",
+        content,
+        flags=re.DOTALL,
     )
-    content = re.sub(tel_pattern, "", content, flags=re.DOTALL)
 
-    # Remove PROACTIVE_PROMPTED section
-    proactive_pattern = r"If `PROACTIVE_PROMPTED` is `no` AND.*?`touch ~\/\.gstack\/\.proactive-prompted`\n```\n"
-    content = re.sub(proactive_pattern, "", content, flags=re.DOTALL)
+    content = re.sub(
+        r"If `PROACTIVE_PROMPTED` is.*?touch ~/.gstack/\.proactive-prompted.*?```\s*\n?",
+        "",
+        content,
+        flags=re.DOTALL,
+    )
 
-    # Remove contributor mode block
-    contrib_pattern = r"## Contributor Mode.*?(?=## Voice|## Completion)"
-    content = re.sub(contrib_pattern, "", content, flags=re.DOTALL)
+    content = re.sub(
+        r"If `LAKE_INTRO` is.*?touch ~/.gstack/\.completeness-intro-seen.*?```\s*\n?",
+        "",
+        content,
+        flags=re.DOTALL,
+    )
 
-    # Remove telemetry trailer block
-    tel_trailer_pattern = (
-        r"## Telemetry \(run last\).*?```bash\n.*?gstack-telemetry-log.*?```\n"
+    # STEP 3: Remove ## Contributor Mode section
+    content = re.sub(
+        r"## Contributor Mode.*?## (Voice|Telemetry|Completion)",
+        r"## \1",
+        content,
+        flags=re.DOTALL,
     )
-    content = re.sub(tel_trailer_pattern, "", content, flags=re.DOTALL)
 
-    # Remove update check references
-    content = re.sub(r"UPGRADE_AVAILABLE.*?(?=\n|$)", "", content)
-    content = re.sub(r"JUST_UPGRADED.*?(?=\n|$)", "", content)
-    content = re.sub(r"gstack-update-check", "echo", content)
+    # STEP 4: Remove ## Telemetry section entirely
+    content = re.sub(r"## Telemetry.*?```.*?```\s*\n", "", content, flags=re.DOTALL)
+
+    # STEP 5: NUKE all gstack binary references
+    content = re.sub(r"`?~/.claude/skills/gstack/bin/[^\s`]+`?", "", content)
 
-    # Remove gstack-config references (telemetry/proactive settings)
+    # STEP 6: Replace gstack paths with opengstack
     content = re.sub(
         r"~/.claude/skills/gstack/", "~/.claude/skills/opengstack/", content
     )
 
-    # Remove YC slop - personal notes from Garry Tan
-    garry_note_pattern = (
-        r"> A personal note from me, Garry Tan, the creator of GStack:.*?(?=\n\n|\n>)"
-    )
-    content = re.sub(garry_note_pattern, "", content, flags=re.DOTALL)
-
-    # Remove YC apply links with ref tracking
-    content = re.sub(r"ycombinator\.com/apply\?ref=gstack.*", "", content)
+    # STEP 7: Remove all .gstack/ directory references
+    content = re.sub(r"~?/?\.gstack/[^\s`\n]*", "", content)
 
-    # Remove YC partner energy references
-    content = re.sub(r"YC partner energy for strategy.*", "", content)
+    # STEP 8: Remove mkdir/touch commands for .gstack
+    content = re.sub(r"mkdir -p[^\n]*\.gstack[^\n]*\n?", "", content)
+    content = re.sub(r"touch[^\n]*\.gstack[^\n]*\n?", "", content)
 
-    # Remove "exactly the kind of builders Garry respects" type phrases
-    founder_phrase = r"people with that kind of taste and drive are exactly the kind of builders.*?consider applying to YC.*"
-    content = re.sub(founder_phrase, "", content, flags=re.DOTALL)
-
-    # Remove garryslist references
-    content = re.sub(r"https?://garryslist\.org[^\s]*", "", content)
-    content = re.sub(r"Boil the (Lake|Ocean).*", "", content)
+    # STEP 9: NUKE Garry Tan completely
+    content = re.sub(
+        r"> A personal note from me, Garry Tan.*?(?=\n\n|## )",
+        "",
+        content,
+        flags=re.DOTALL,
+    )
+    content = re.sub(r"shaped by Garry Tan\'s[^.]*\.", "", content)
+    content = re.sub(r"Garry Tan", "", content)
+    content = re.sub(r"YC partner energy for strategy[^.]*\.", "", content)
 
-    # Remove YC from office-hours description
+    # STEP 10: NUKE YC references
     content = re.sub(r"YC Office Hours", "Office Hours", content)
+    content = re.sub(r"ycombinator\.com/apply\?ref=[^\s]*", "", content)
+    content = re.sub(r"consider applying to YC[^.]*\.", "", content)
 
-    # Remove Garry Tan references
-    content = re.sub(r"shaped by Garry Tan's.*", "", content)
-    content = re.sub(r"Garry Tan", "OpenGStack", content)
-    content = re.sub(r"Gar[r]?y.*Tan", "", content)
+    # STEP 11: NUKE garryslist
+    content = re.sub(r"https?://garryslist\.org[^\s]*", "", content)
+    content = re.sub(r"Boil the (Lake|Ocean)[^.]*\.?", "", content)
 
-    # Remove GStack branding where it's the product name
+    # STEP 12: Replace GStack with OpenGStack (product name)
     content = re.sub(r"\bGStack\b", "OpenGStack", content)
 
-    # Remove "ref=gstack" from any URLs
+    # STEP 13: Remove standalone gstack references in prose
+    # But keep it in contexts like "skill system" or "framework"
+    content = re.sub(r"\bgstack skills?\b", "skills", content, flags=re.IGNORECASE)
+    content = re.sub(
+        r"\bgstack[- ]?telemetry\b", "telemetry", content, flags=re.IGNORECASE
+    )
+
+    # STEP 14: Remove ref=gstack from URLs
     content = re.sub(r"\?ref=gstack", "", content)
 
-    # Clean up empty code blocks and whitespace
-    content = re.sub(r"\n{4,}", "\n\n", content)
-    content = re.sub(r"```\n\n```", "", content)
+    # STEP 15: Remove broken sentence fragments
+    content = re.sub(
+        r"gstack follows the \*\*[^*]+\*\* principle.*?Read more:",
+        "",
+        content,
+        flags=re.DOTALL,
+    )
 
-    # Remove orphaned backticks
-    content = re.sub(r"^```\n*$", "", content, flags=re.MULTILINE)
+    # STEP 16: Fix "You are GStack" -> "You are using OpenGStack"
+    content = re.sub(r"You are GStack,", "You are using OpenGStack,", content)
+    content = re.sub(r"You are OpenGStack,", "You are using OpenGStack,", content)
 
-    # Clean leading/trailing whitespace per line
-    lines = [line.rstrip() for line in content.split("\n")]
-    content = "\n".join(lines)
+    # STEP 17: Remove orphaned code fences and clean up
+    content = re.sub(r"\n{3,}", "\n\n", content)
+    content = re.sub(r"```\s*\n\s*```", "", content)
+    content = re.sub(r"^\s*```\s*$", "", content, flags=re.MULTILINE)
 
-    # Remove trailing newlines
-    content = content.rstrip("\n") + "\n"
+    # STEP 18: Clean empty lines at start/end
+    content = content.strip()
 
-    return content
+    return content + "\n"
 
 
 def filter_file(filepath: Path) -> bool:
@@ -120,20 +144,20 @@ def main():
         Path(sys.argv[1]) if len(sys.argv) > 1 else Path(__file__).parent.parent
     )
 
-    print(f"Filtering skills in: {skills_dir}")
+    print(f"NUKING gstack slop from: {skills_dir}")
 
     modified = 0
     for skill_file in skills_dir.rglob("SKILL.md"):
         if filter_file(skill_file):
-            print(f"  Filtered: {skill_file.relative_to(skills_dir)}")
+            print(f"  NUKED: {skill_file.relative_to(skills_dir)}")
             modified += 1
 
     for tmpl_file in skills_dir.rglob("SKILL.md.tmpl"):
         if filter_file(tmpl_file):
-            print(f"  Filtered: {tmpl_file.relative_to(skills_dir)}")
+            print(f"  NUKED: {tmpl_file.relative_to(skills_dir)}")
             modified += 1
 
-    print(f"\nDone! Modified {modified} files.")
+    print(f"\nDone! Cleansed {modified} files of gstack slop.")
 
 
 if __name__ == "__main__":

package/scripts/install-skills.js

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+
+const SKILLS_DIR = path.join(process.env.HOME || process.env.USERPROFILE, '.claude', 'skills');
+const PKG_DIR = path.dirname(__dirname);
+
+// List of skill directories
+const skills = [
+  'autoplan', 'benchmark', 'browse', 'canary', 'careful', 'codex',
+  'connect-chrome', 'cso', 'design-consultation', 'design-review',
+  'design-shotgun', 'document-release', 'freeze', 'gstack-upgrade',
+  'guard', 'investigate', 'land-and-deploy', 'office-hours',
+  'plan-ceo-review', 'plan-design-review', 'plan-eng-review',
+  'qa', 'qa-only', 'retro', 'review', 'setup-browser-cookies',
+  'setup-deploy', 'ship', 'unfreeze'
+];
+
+console.log('🔗 Installing OpenGStack skills to ~/.claude/skills/...');
+
+// Ensure skills directory exists
+if (!fs.existsSync(SKILLS_DIR)) {
+  fs.mkdirSync(SKILLS_DIR, { recursive: true });
+}
+
+// Create symlinks for each skill
+let installed = 0;
+let skipped = 0;
+
+for (const skill of skills) {
+  const srcPath = path.join(PKG_DIR, skill);
+  const destPath = path.join(SKILLS_DIR, skill);
+
+  if (!fs.existsSync(srcPath)) {
+    console.warn(`⚠️  Skill not found: ${skill}`);
+    skipped++;
+    continue;
+  }
+
+  try {
+    // Remove existing if it's a symlink
+    if (fs.existsSync(destPath)) {
+      const stat = fs.lstatSync(destPath);
+      if (stat.isSymbolicLink()) {
+        fs.unlinkSync(destPath);
+      } else {
+        console.log(`⏭️  Skipping ${skill} (already exists)`);
+        skipped++;
+        continue;
+      }
+    }
+
+    // Create symlink
+    fs.symlinkSync(srcPath, destPath, 'dir');
+    console.log(`✓ ${skill}`);
+    installed++;
+  } catch (err) {
+    console.error(`✗ ${skill}: ${err.message}`);
+    skipped++;
+  }
+}
+
+console.log(`\n✅ Installed ${installed} skills, skipped ${skipped}`);
+console.log('🎯 Skills are now available in opencode/Claude');