specross 1.0.0

package/template/commands/qc/gen-scripts.md

@@ -0,0 +1,42 @@
+> **Agent:** Read `.claude/agents/qc.md` and adopt that persona fully before proceeding.
+
+---
+
+Generate automation test scripts for story: $ARGUMENTS
+
+## Steps
+
+1. Read `stories/$ARGUMENTS/test/test-cases.md`. If it doesn't exist, stop and say: "Test cases not found. Run `/qc:gen-test-cases $ARGUMENTS` first."
+
+2. Read `stories/$ARGUMENTS/story.md` for business context and AC details.
+
+3. Read `CLAUDE.md` for:
+   - The testing framework in use (e.g. Playwright, Cypress, pytest, Jest, etc.)
+   - Test folder conventions and file naming
+   - Any existing test helpers, fixtures, or page objects to reuse
+
+4. For each test case in test-cases.md, generate an automation script:
+   - Map TC-001 → test function/block with the same ID in a comment
+   - Use the testing framework specified in CLAUDE.md
+   - Write realistic selectors, assertions, and setup/teardown
+   - Use `// TODO:` or `# TODO:` where QC needs to fill in dynamic values (e.g. test user credentials, specific IDs)
+   - Group happy path, edge case, and negative tests into separate describe/class blocks
+
+5. Write scripts to `tests/{story-name}/` using the naming convention in CLAUDE.md. If no convention is specified, use `{story-name}.spec.{ext}`.
+
+6. Add a `tests/{story-name}/README.md` with:
+   - How to run these tests
+   - Any environment variables or setup required
+   - Which TC IDs each test function covers
+
+7. Print a summary:
+
+**Scripts generated for `$ARGUMENTS`:**
+
+| File | TCs covered |
+|------|-------------|
+| tests/$ARGUMENTS/... | TC-001, TC-002, TC-003 |
+
+**Next steps:**
+1. Fill in any `// TODO` values (credentials, test data, selectors)
+2. Run the suite and use `/qc:bug-report $ARGUMENTS {TC-ID}` for any failures

package/template/commands/qc/gen-test-cases.md

@@ -0,0 +1,41 @@
+> **Agent:** Read `.claude/agents/qc.md` and adopt that persona fully before proceeding.
+
+---
+
+Generate test cases for story: $ARGUMENTS
+
+## Steps
+
+1. Read `stories/$ARGUMENTS/story.md` fully. If it doesn't exist, stop and say:
+   "Story not found. Run `/ba:new-story $ARGUMENTS` first."
+
+2. Check that the story has complete Acceptance Criteria. If incomplete, warn the user.
+
+3. Read `CLAUDE.md` for testing conventions, framework, and naming standards.
+
+4. Read `_templates/test-cases.md` — this is the **exact output format** to follow.
+   - Follow the TC numbering scheme, section structure, and coverage matrix from the template
+   - Do not skip sections — if a section has no content, note "None for this story"
+
+5. Check if `stories/$ARGUMENTS/test/test-cases.md` already exists. If so, warn and ask to confirm before overwriting.
+
+6. Generate test cases following `_templates/test-cases.md` exactly, and write to `stories/$ARGUMENTS/test/test-cases.md`.
+   - Fill `{{STORY_NAME}}` with the title-cased story name
+   - Fill `{{STORY_SLUG}}` with `$ARGUMENTS`
+   - Fill `{{DATE}}` with today's date
+   - Every AC → at least 1 happy path TC + 1 negative TC
+   - Every Edge Case from story.md → its own TC
+   - Coverage matrix must list every AC with its TC IDs
+
+7. Read `stories/$ARGUMENTS/CHANGELOG.md` to find the current story version (the latest `## vX.Y.Z` entry at the top). Create `.spec-lock` at `stories/$ARGUMENTS/test/.spec-lock`:
+   ```
+   story: $ARGUMENTS
+   spec-version: {current-story-version}
+   generated: {today}
+   ```
+
+8. Print a coverage summary then next steps:
+   - Total TCs by type (happy path / edge case / negative)
+   - Any ACs that have incomplete coverage (flag as ⚠️)
+   - "Next: `/qc:gen-scripts $ARGUMENTS` to generate automation scripts"
+   - "To customize the TC format, edit `_templates/test-cases.md`"

package/template/commands/qc/status.md

@@ -0,0 +1,51 @@
+> **Agent:** Read `.claude/agents/qc.md` and adopt that persona fully before proceeding.
+
+---
+
+Scan all released stories and show which ones need a test case sync.
+
+## Steps
+
+1. List all subdirectories under `stories/`. Each subdirectory is a story slug.
+   If `stories/` is empty or doesn't exist, print "No stories released yet." and stop.
+
+2. For each story folder, collect its sync status:
+
+   a. Read `stories/{story}/CHANGELOG.md` — extract the latest version (the first `## vX.Y.Z` entry at the top). If CHANGELOG doesn't exist, mark as `unknown`.
+
+   b. Check `stories/{story}/test/.spec-lock`:
+      - If it **doesn't exist** → status: `⚪ No test cases`
+      - If it exists → read `spec-version`
+        - If `spec-version` == latest version → status: `✅ Up to date`
+        - If `spec-version` != latest version → status: `🔴 Outdated  (locked: {spec-version} → latest: {latest})`
+
+3. Print the status table:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📋  QC STATUS
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+[one line per story, sorted: outdated first, then up-to-date, then no test cases]
+
+  🔴  user-authentication   v1.0.0 → v1.3.0   /qc:sync user-authentication
+  🔴  create-order          v1.1.0 → v1.2.0   /qc:sync create-order
+  ✅  payment-flow          v2.0.0
+  ⚪  export-report                            /qc:gen-test-cases export-report
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+{N} stories need sync   {M} up to date   {K} no test cases yet
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+4. If there are outdated stories, print a shortcut block:
+
+```
+Run these to sync:
+[one line per outdated story]
+  /qc:sync {story}
+```
+
+If everything is up to date, print:
+```
+✅  All test cases are up to date.
+```

package/template/commands/qc/sync.md

@@ -0,0 +1,71 @@
+> **Agent:** Read `.claude/agents/qc.md` and adopt that persona fully before proceeding.
+
+---
+
+Check if the story spec has changed since the test cases were generated, and show what needs to be updated.
+
+Story: $ARGUMENTS
+
+## Steps
+
+1. Read `stories/$ARGUMENTS/test/.spec-lock`. If it doesn't exist, say:
+   "No spec-lock found. Run `/qc:gen-test-cases $ARGUMENTS` to generate test cases first."
+
+   The `.spec-lock` contains the story version these test cases were based on (e.g. `v1.0.0`).
+
+2. Read `stories/$ARGUMENTS/CHANGELOG.md` to find the latest released version.
+
+3. Compare the locked version vs the latest version:
+   - If they match → print "✅ Your test cases are up to date. No action needed." and stop.
+   - If they differ → continue.
+
+4. Read the latest release note at `stories/$ARGUMENTS/docs/release-{latest-version}.md` to understand what changed.
+
+5. Read the current `stories/$ARGUMENTS/story.md` fully.
+
+6. Read the current `stories/$ARGUMENTS/test/test-cases.md` fully.
+
+7. Produce a sync report:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🔄  QC SYNC — $ARGUMENTS
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Your test cases: v{locked}
+Latest story:    v{latest}
+
+CHANGES SINCE YOUR LAST SYNC:
+[List each changed AC or edge case, clearly described]
+
+TEST CASES AFFECTED:
+┌─────────────────────────────────────────────────────┐
+│ TC     │ Status     │ Action needed                 │
+├─────────────────────────────────────────────────────┤
+│ TC-003 │ ❌ Invalid  │ AC changed — rewrite steps    │
+│ TC-007 │ ⚠️ Partial  │ Add new assertion for X       │
+│ NEW    │ ✅ Required │ Add TC for AC-05 (remember me)│
+└─────────────────────────────────────────────────────┘
+
+NEW TEST CASES TO ADD:
+[For each new AC or edge case, describe the new TC(s) needed]
+
+SCRIPTS TO UPDATE:
+[If automation scripts exist, note which files need updating]
+
+EFFORT ESTIMATE: Low / Medium / High
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+8. After the report, ask: "Would you like me to update the test cases now with these changes?"
+   - If yes: update `stories/$ARGUMENTS/test/test-cases.md` — edit invalid TCs and append new TCs
+   - If no: leave as-is
+
+9. Once test cases are updated (now or manually), remind them to update `.spec-lock`:
+
+```
+When you've finished updating your test cases and scripts, update your spec-lock:
+
+stories/$ARGUMENTS/test/.spec-lock
+  → change spec-version to: {latest}
+  → change synced: to today's date
+```