openspec-playwright 0.1.53 → 0.1.54

package/.claude/skills/openspec-e2e/SKILL.md

@@ -98,7 +98,7 @@ browser_navigate → browser_console_messages → browser_snapshot → browser_t
 
 | Signal | Meaning | Action |
 |--------|---------|--------|
-| HTTP 5xx or unreachable | Server error | **STOP** — tell user: "App has a bug (HTTP <code>). Fix it, then re-run /opsx:e2e." |
+| HTTP 5xx or unreachable | Backend/server error | **STOP** — tell user: "App has a backend error (HTTP <code>). Fix it, then re-run /opsx:e2e." |
 | JS error in console | App runtime error | **STOP** — tell user: "Page has JS errors. Fix them, then re-run /opsx:e2e." |
 | HTTP 404 | Route not in app (metadata issue) | Continue — mark `⚠️ route not found` in app-exploration.md |
 | Auth required, no credentials | Missing auth setup | Continue — skip protected routes, explore login page |
@@ -170,6 +170,7 @@ After writing `app-exploration.md`, extract **project-level shared knowledge** a
 
 | Section | What to extract |
 |---------|----------------|
+| Architecture | Monolith or separated? Backend port? Restart command? |
 | Credential Format | Login endpoint, username format (email vs username) |
 | Common Selector Patterns | New patterns discovered that apply across routes |
 | SPA Routing | SPA framework, routing behavior |
@@ -428,7 +429,7 @@ Reference: `openspec/schemas/playwright-e2e/templates/report.md`
 |----------|----------|
 | No specs | Stop — E2E requires specs |
 | Seed test fails | Stop — fix environment |
-| App has JS errors or HTTP 5xx during exploration | **STOP** — tell user to fix the app first |
+| App has JS errors or HTTP 5xx during exploration | **STOP** — see app-knowledge.md → Architecture section for restart instructions |
 | No auth required | Skip auth setup |
 | app-exploration.md exists | Read and use (never regenerate) |
 | app-knowledge.md exists | Read and use (append new patterns only) |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openspec-playwright",
-  "version": "0.1.53",
+  "version": "0.1.54",
   "description": "OpenSpec + Playwright E2E verification setup tool for Claude Code",
   "type": "module",
   "bin": {

package/release-notes.md

@@ -1,5 +1,5 @@
 ## What's Changed
 
-- fix(SKILL): stop exploration on app-level errors, continue on metadata issues
+- feat: add Architecture section to app-knowledge.md and SKILL.md
 
-**Full Changelog**: https://github.com/wxhou/openspec-playwright/releases/tag/v0.1.53
+**Full Changelog**: https://github.com/wxhou/openspec-playwright/releases/tag/v0.1.54

package/schemas/playwright-e2e/templates/app-knowledge.md

@@ -40,6 +40,14 @@ Priority: `[data-testid]` > `getByRole` > `getByLabel` > `getByText` > CSS
 | success msg | `[data-testid="success-msg"]` | |
 | loading spinner | `[data-testid="loading"]` | |
 
+## Architecture
+
+| Aspect | Value | Notes |
+|--------|-------|-------|
+| Architecture | monolith / separated | Frontend + backend in one repo or separate? |
+| Backend server | `<port>` or `embedded` | e.g. `3001` or `embedded in frontend` |
+| How to restart backend | `<command>` | e.g. `cd backend && npm run dev` |
+
 ## SPA Routing
 
 - Framework: <e.g. React Router / Vue Router / Next.js>