Skip to content

feat: natural language skill routing + proactive suggestions (v0.7.1)#195

Merged
garrytan merged 5 commits intomainfrom
garrytan/e2e-natural-language
Mar 19, 2026
Merged

feat: natural language skill routing + proactive suggestions (v0.7.1)#195
garrytan merged 5 commits intomainfrom
garrytan/e2e-natural-language

Conversation

@garrytan
Copy link
Owner

Summary

  • Every gstack workflow skill now has proactive triggers — Claude suggests skills at natural moments in the developer workflow without the user knowing slash commands
  • /debug and /office-hours had zero trigger phrases — now fully discoverable via natural language
  • Lifecycle map in root gstack description teaches Claude the full developer workflow (brainstorm → plan → review → code → debug → test → ship → docs → retro)
  • Natural language preference toggle: "stop suggesting things" opts out, "be proactive again" re-enables
  • 11 journey-stage E2E tests verify correct routing at every lifecycle stage (11/11 pass, $1.31/run)
  • 26 static validation tests catch missing trigger/proactive phrases for free

Test Coverage

CODE PATH COVERAGE
===========================
[+] SKILL.md.tmpl changes (14 files)
    ├── [★★★ TESTED] Trigger phrase presence — skill-validation.test.ts (13 tests)
    ├── [★★★ TESTED] Proactive phrase presence — skill-validation.test.ts (13 tests)
    └── [★★★ TESTED] Routing correctness — skill-routing-e2e.test.ts (11 tests)

COVERAGE: 100% of new code paths tested
Tests: 18 files (no change — new test file added, no app code)

E2E Journey Results (11/11 pass)

  journey-ideation        → /office-hours        ✅ $0.12
  journey-plan-eng        → /plan-eng-review     ✅ $0.11
  journey-think-bigger    → /plan-ceo-review     ✅ $0.15
  journey-debug           → /debug               ✅ $0.10
  journey-qa              → /qa                  ✅ $0.12
  journey-code-review     → /review              ✅ $0.10
  journey-ship            → /ship                ✅ $0.14
  journey-docs            → /document-release    ✅ $0.10
  journey-retro           → /retro               ✅ $0.13
  journey-design-system   → /design-consultation ✅ $0.11
  journey-visual-qa       → /design-review       ✅ $0.13
  Total: $1.31

Pre-Landing Review

No issues found. Changes are entirely skill description text + test code. No application logic, SQL, or LLM trust boundaries.

TODOS

No TODO items completed in this PR.

Test plan

  • 320 static tests pass (skill validation + touchfiles + gen-skill-docs + browse)
  • 11 E2E journey routing tests pass
  • All 14 SKILL.md files regenerated and verified

🤖 Generated with Claude Code

garrytan and others added 5 commits March 18, 2026 20:44
These two skills had zero "Use when asked to..." phrases, making them
completely invisible to natural language. Users saying "debug this" or
"brainstorm an idea" would get no skill invocation.
Every skill now has "Proactively suggest when..." language so Claude
surfaces skills at natural moments — not just when the user says
specific trigger phrases.
Root gstack description now includes a developer workflow guide mapping
12 stages to skills. Preamble reads proactive preference via gstack-config.
Users can opt out with "stop suggesting things" and re-enable with
"be proactive again" — natural language toggle, no CLI needed.
Each test simulates a real development stage (ideation, plan review,
debug, QA, ship, retro...) with realistic project context and verifies
the right skill fires from natural language alone. 11/11 pass.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@garrytan garrytan merged commit 4fe0ce9 into main Mar 19, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant