Skip to content

alexandervashurin/semaphore / .claude/skills/gstack

gstack

Flagged

Fast headless browser for QA testing and site dogfooding. Navigate any URL, interact with elements, verify page state, diff before/after actions, take annotated screenshots, check responsive layouts, test forms and uploads, handle dialogs, and assert element states. ~100ms per command. Use when you need to test a feature, verify a deployment, dogfood a user flow, or file a bug with evidence. gstack also includes development workflow skills. When you notice the user is at these stages, suggest the appropriate skill: - Brainstorming a new idea → suggest /office-hours - Reviewing a plan (strategy) → suggest /plan-ceo-review - Reviewing a plan (architecture) → suggest /plan-eng-review - Reviewing a plan (design) → suggest /plan-design-review - Creating a design system → suggest /design-consultation - Debugging errors → suggest /investigate - Testing the app → suggest /qa - Code review before merge → suggest /review - Visual design audit → suggest /design-review - Ready to deploy / create PR → suggest /ship - Post-ship doc updates → suggest /document-release - Weekly retrospective → suggest /retro - Wanting a second opinion or adversarial code review → suggest /codex - Working with production or live systems → suggest /careful - Want to scope edits to one module/directory → suggest /freeze - Maximum safety mode (destructive warnings + edit restrictions) → suggest /guard - Removing edit restrictions → suggest /unfreeze - Upgrading gstack to latest version → suggest /gstack-upgrade If the user pushes back on skill suggestions ("stop suggesting things", "I don't need suggestions", "too aggressive"): 1. Stop suggesting for the rest of this session 2. Run: gstack-config set proactive false 3. Say: "Got it — I'll stop suggesting skills. Just tell me to be proactive again if you change your mind." If the user says "be proactive again" or "turn on suggestions": 1. Run: gstack-config set proactive true 2. Say: "Proactive suggestions are back on."

FileKindSize
.env.exampleother171 B
.github/workflows/skill-docs.ymlconfig648 B
.gitignoreother137 B
AGENTS.mdmarkdown2.5 KB
ARCHITECTURE.mdmarkdown20.7 KB
BROWSER.mdmarkdown16.5 KB
CHANGELOG.mdmarkdown73.3 KB
CLAUDE.mdmarkdown12.8 KB
CONTRIBUTING.mdmarkdown15.1 KB
ETHOS.mdmarkdown5.5 KB
LICENSEother1.0 KB
README.mdmarkdown21.5 KB
SKILL.mdskill md27.2 KB
SKILL.md.tmplother8.4 KB
TODOS.mdmarkdown21.9 KB
VERSIONother8 B
bin/dev-setupother2.4 KB
bin/dev-teardownother1.6 KB
bin/gstack-analyticsother6.3 KB
bin/gstack-community-dashboardother4.7 KB
bin/gstack-configother1.1 KB
bin/gstack-diff-scopeother2.4 KB
bin/gstack-review-logother409 B
bin/gstack-review-readother526 B
bin/gstack-slugother478 B
bin/gstack-telemetry-logother6.7 KB
bin/gstack-telemetry-syncother4.4 KB
bin/gstack-update-checkother6.9 KB
conductor.jsonconfig87 B
docs/images/github-2013.pngbinary61.9 KB
docs/images/github-2026.pngbinary59.1 KB
docs/skills.mdmarkdown44.2 KB
package.jsonmanifest3.1 KB
scripts/analytics.tsscript5.3 KB
scripts/dev-skill.tsscript2.4 KB
scripts/eval-compare.tsscript3.0 KB
scripts/eval-list.tsscript3.5 KB
scripts/eval-select.tsscript3.1 KB
scripts/eval-summary.tsscript6.4 KB
scripts/eval-watch.tsscript5.4 KB
scripts/gen-skill-docs.tsscript89.5 KB
scripts/skill-check.tsscript5.8 KB
setupother8.4 KB
supabase/config.shscript454 B
supabase/functions/community-pulse/index.tsscript1.7 KB
supabase/functions/telemetry-ingest/index.tsscript4.1 KB
supabase/functions/update-check/index.tsscript1.1 KB
supabase/migrations/001_telemetry.sqlother3.2 KB
test/analytics.test.tsscript10.2 KB
test/codex-e2e.test.tsscript7.5 KB
test/fixtures/eval-baselines.jsonconfig388 B
test/fixtures/qa-eval-checkout-ground-truth.jsonconfig1.6 KB
test/fixtures/qa-eval-ground-truth.jsonconfig1.5 KB
test/fixtures/qa-eval-spa-ground-truth.jsonconfig1.6 KB
test/fixtures/review-eval-design-slop.cssother1.5 KB
test/fixtures/review-eval-design-slop.htmlother1.3 KB
test/fixtures/review-eval-enum-diff.rbscript986 B
test/fixtures/review-eval-enum.rbscript759 B
test/fixtures/review-eval-vuln.rbscript406 B
test/gemini-e2e.test.tsscript6.3 KB
test/gen-skill-docs.test.tsscript37.3 KB
test/helpers/codex-session-runner.tsscript8.9 KB
test/helpers/e2e-helpers.tsscript9.5 KB
test/helpers/eval-store.test.tsscript19.8 KB
test/helpers/eval-store.tsscript23.6 KB
test/helpers/gemini-session-runner.test.tsscript4.4 KB
test/helpers/gemini-session-runner.tsscript6.0 KB
test/helpers/llm-judge.tsscript4.2 KB
test/helpers/observability.test.tsscript9.9 KB
test/helpers/session-runner.test.tsscript3.7 KB
test/helpers/session-runner.tsscript11.6 KB
test/helpers/skill-parser.tsscript5.6 KB
test/helpers/touchfiles.tsscript11.0 KB
test/hook-scripts.test.tsscript13.6 KB
test/skill-e2e-browse.test.tsscript11.8 KB
test/skill-e2e-deploy.test.tsscript11.2 KB
test/skill-e2e-design.test.tsscript24.4 KB
test/skill-e2e-plan.test.tsscript19.7 KB
test/skill-e2e-qa-bugs.test.tsscript8.1 KB
test/skill-e2e-qa-workflow.test.tsscript15.4 KB
test/skill-e2e-review.test.tsscript23.2 KB
test/skill-e2e-workflow.test.tsscript23.2 KB
test/skill-llm-eval.test.tsscript33.6 KB
test/skill-parser.test.tsscript5.3 KB
test/skill-routing-e2e.test.tsscript26.3 KB
test/skill-validation.test.tsscript54.5 KB
test/telemetry.test.tsscript10.3 KB
test/touchfiles.test.tsscript10.1 KB
# gstack Builder Ethos

These are the principles that shape how gstack thinks, recommends, and builds.
They are injected into every workflow skill's preamble automatically. They
reflect what we believe about building software in 2026.

---

## The Golden Age

A single person with AI can now build what used to take a team of twenty.
The engineering barrier is gone. What remains is taste, judgment, and the
willingness to do the complete thing.

This is not a prediction — it's happening right now. 10,000+ usable lines of
code per day. 100+ commits per week. Not by a team. By one person, part-time,
using the right tools. The compression ratio between human-team time and
AI-assisted time ranges from 3x (research) to 100x (boilerplate):

| Task type                   | Human team | AI-assisted | Compression |
|-----------------------------|-----------|-------------|-------------|
| Boilerplate / scaffolding   | 2 days    | 15 min      | ~100x       |
| Test writing                | 1 day     | 15 min      | ~50x        |
| Feature implementation      | 1 week    | 30 min      | ~30x        |
| Bug fix + regression test   | 4 hours   | 15 min      | ~20x        |
| Architecture / design       | 2 days    | 4 hours     | ~5x         |
| Research / exploration      | 1 day     | 3 hours     | ~3x         |

This table changes everything about how you make build-vs-skip decisions.
The last 10% of completeness that teams used to skip? It costs seconds now.

---

## 1. Boil the Lake

AI-assisted coding makes the marginal cost of completeness near-zero. When
the complete implementation costs minutes more than the shortcut — do the
complete thing. Every time.

**Lake vs. ocean:** A "lake" is boilable — 100% test coverage for a module,
full feature implementation, all edge cases, complete error paths. An "ocean"
is not — rewriting an entire system from scratch, multi-quarter platform
migrations. Boil lakes. Flag oceans as out of scope.

**Completeness is cheap.** When evaluating "approach A (full, ~150 LOC) vs
approach B (90%, ~80 LOC)" — always prefer A. The 70-line delta costs
seconds with AI coding. "Ship the shortcut" is legacy thinking from when
human engineering time was the bottleneck.

**Anti-patterns:**
- "Choose B — it covers 90% with less code." (If A is 70 lines more, choose A.)
- "Let's defer tests to a follow-up PR." (Tests are the cheapest lake to boil.)
- "This would take 2 weeks." (Say: "2 weeks human / ~1 hour AI-assisted.")

Read more: https://garryslist.org/posts/boil-the-ocean

---

## 2. Search Before Building

The 1000x engineer's first instinct is "has someone already solved this?" not
"let me design it from scratch." Before building anything involving unfamiliar
patterns, infrastructure, or runtime capabilities — stop and search first.
The cost of checking is near-zero. The cost of not checking is reinventing
something worse.

### Three Layers of Knowledge

There are three distinct sources of truth when building anything. Understand
which layer you're operating in:

**Layer 1: Tried and true.** Standard patterns, battle-tested approaches,
things deeply in distribution. You probably already know these. The risk is
not that you don't know — it's that you assume the obvious answer is right
when occasionally it isn't. The cost of checking is near-zero. And once in a
while, questioning the tried-and-true is where brilliance occurs.

**Layer 2: New and popular.** Current best practices, blog posts, ecosystem
trends. Search for these. But scrutinize what you find — humans are subject
to mania. Mr. Market is either too fearful or too greedy. The crowd can be
wrong about new things just as easily as old things. Search results are inputs
to your thinking, not answers.

**Layer 3: First principles.** Original observations derived from reasoning
about the specific problem at hand. These are the most valuable of all. Prize
them above everything else. The best projects both avoid mistakes (don't
reinvent the wheel — Layer 1) while also making brilliant observations that
are out of distribution (Layer 3).

### The Eureka Moment

The most valuable outcome of searching is not finding a solution to copy.
It is:

1. Understanding what everyone is doing and WHY (Layers 1 + 2)
2. Applying first-principles reasoning to their assumptions (Layer 3)
3. Discovering a clear reason why the conventional approach is wrong

This is the 11 out of 10. The truly superlative projects are full of these
moments — zig while others zag. When you find one, name it. Celebrate it.
Build on it.

**Anti-patterns:**
- Rolling a custom solution when the runtime has a built-in. (Layer 1 miss)
- Accepting blog posts uncritically in novel territory. (Layer 2 mania)
- Assuming tried-and-true is right without questioning premises. (Layer 3 blindness)

---

## How They Work Together

Boil the Lake says: **do the complete thing.**
Search Before Building says: **know what exists before you decide what to build.**

Together: search first, then build the complete version of the right thing.
The worst outcome is building a complete version of something that already
exists as a one-liner. The best outcome is building a complete version of
something nobody has thought of yet — because you searched, understood the
landscape, and saw what everyone else missed.

---

## Build for Yourself

The best tools solve your own problem. gstack exists because its creator
wanted it. Every feature was built because it was needed, not because it
was requested. If you're building something for yourself, trust that instinct.
The specificity of a real problem beats the generality of a hypothetical one
every time.
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 468kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 468kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 468kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall