From 145947c5209844ee9372d51c3a21699aafc9189b Mon Sep 17 00:00:00 2001 From: Markus Graf Date: Fri, 20 Feb 2026 17:52:13 +0100 Subject: [PATCH] Add project scope documentation for AI playgroup registration system Define complete non-technical scope for replacing Google Forms registration with an AI-powered conversational agent. Includes: - Registration data requirements (13 fields with validation rules) - Knowledge base content (fees, regulations, schedule, FAQ from official PDFs) - Conversation flow design with bilingual support (German/English) - Agent personality guidelines (warm & friendly tone) - Admin notification routing by playgroup type - Email reminder system for incomplete registrations - Data export formats (CSV/JSON) - Channel configuration (email + chat) - Release priorities (MVP scope defined) Co-Authored-By: Claude Opus 4.5 --- .claude/commands/opsx/apply.md | 152 +++++ .claude/commands/opsx/archive.md | 157 ++++++ .claude/commands/opsx/bulk-archive.md | 242 ++++++++ .claude/commands/opsx/continue.md | 114 ++++ .claude/commands/opsx/explore.md | 174 ++++++ .claude/commands/opsx/ff.md | 94 ++++ .claude/commands/opsx/new.md | 69 +++ .claude/commands/opsx/onboard.md | 525 +++++++++++++++++ .claude/commands/opsx/sync.md | 134 +++++ .claude/commands/opsx/verify.md | 164 ++++++ .claude/skills/openspec-apply-change/SKILL.md | 156 ++++++ .../skills/openspec-archive-change/SKILL.md | 114 ++++ .../openspec-bulk-archive-change/SKILL.md | 246 ++++++++ .../skills/openspec-continue-change/SKILL.md | 118 ++++ .claude/skills/openspec-explore/SKILL.md | 290 ++++++++++ .claude/skills/openspec-ff-change/SKILL.md | 101 ++++ .claude/skills/openspec-new-change/SKILL.md | 74 +++ .claude/skills/openspec-onboard/SKILL.md | 529 ++++++++++++++++++ .claude/skills/openspec-sync-specs/SKILL.md | 138 +++++ .../skills/openspec-verify-change/SKILL.md | 168 ++++++ .gemini/commands/opsx/apply.toml | 149 +++++ .gemini/commands/opsx/archive.toml | 154 +++++ .gemini/commands/opsx/bulk-archive.toml | 239 ++++++++ .gemini/commands/opsx/continue.toml | 111 ++++ .gemini/commands/opsx/explore.toml | 171 ++++++ .gemini/commands/opsx/ff.toml | 91 +++ .gemini/commands/opsx/new.toml | 66 +++ .gemini/commands/opsx/onboard.toml | 522 +++++++++++++++++ .gemini/commands/opsx/sync.toml | 131 +++++ .gemini/commands/opsx/verify.toml | 161 ++++++ .gemini/skills/openspec-apply-change/SKILL.md | 156 ++++++ .../skills/openspec-archive-change/SKILL.md | 114 ++++ .../openspec-bulk-archive-change/SKILL.md | 246 ++++++++ .../skills/openspec-continue-change/SKILL.md | 118 ++++ .gemini/skills/openspec-explore/SKILL.md | 290 ++++++++++ .gemini/skills/openspec-ff-change/SKILL.md | 101 ++++ .gemini/skills/openspec-new-change/SKILL.md | 74 +++ .gemini/skills/openspec-onboard/SKILL.md | 529 ++++++++++++++++++ .gemini/skills/openspec-sync-specs/SKILL.md | 138 +++++ .../skills/openspec-verify-change/SKILL.md | 168 ++++++ .../define-project-scope/.openspec.yaml | 2 + .../content/agent-personality.md | 97 ++++ .../content/channel-config.md | 138 +++++ .../content/conversation-flow.md | 365 ++++++++++++ .../content/export-formats.md | 215 +++++++ .../content/knowledge-base/README.md | 25 + .../Reglement-Spielgruppe-2024.pdf | Bin 0 -> 58806 bytes .../Tarifliste-Spielgruppe-2024_2025.pdf | Bin 0 -> 53945 bytes .../content/knowledge-base/faq.md | 121 ++++ .../content/knowledge-base/fees.md | 75 +++ .../content/knowledge-base/regulations.md | 110 ++++ .../content/knowledge-base/schedule.md | 40 ++ .../content/notification-template.md | 125 +++++ .../content/registration-fields.md | 62 ++ .../content/registration-schema.json | 137 +++++ .../content/release-priorities.md | 58 ++ .../content/sample-responses.md | 205 +++++++ .../content/validation-rules.md | 45 ++ .../changes/define-project-scope/design.md | 90 +++ .../changes/define-project-scope/proposal.md | 42 ++ .../specs/chat-interface/spec.md | 52 ++ .../specs/conversational-registration/spec.md | 67 +++ .../specs/email-channel/spec.md | 45 ++ .../specs/registration-data-store/spec.md | 56 ++ .../specs/registration-notifications/spec.md | 41 ++ .../specs/service-knowledge-base/spec.md | 41 ++ .../changes/define-project-scope/tasks.md | 47 ++ openspec/config.yaml | 20 + 68 files changed, 9809 insertions(+) create mode 100644 .claude/commands/opsx/apply.md create mode 100644 .claude/commands/opsx/archive.md create mode 100644 .claude/commands/opsx/bulk-archive.md create mode 100644 .claude/commands/opsx/continue.md create mode 100644 .claude/commands/opsx/explore.md create mode 100644 .claude/commands/opsx/ff.md create mode 100644 .claude/commands/opsx/new.md create mode 100644 .claude/commands/opsx/onboard.md create mode 100644 .claude/commands/opsx/sync.md create mode 100644 .claude/commands/opsx/verify.md create mode 100644 .claude/skills/openspec-apply-change/SKILL.md create mode 100644 .claude/skills/openspec-archive-change/SKILL.md create mode 100644 .claude/skills/openspec-bulk-archive-change/SKILL.md create mode 100644 .claude/skills/openspec-continue-change/SKILL.md create mode 100644 .claude/skills/openspec-explore/SKILL.md create mode 100644 .claude/skills/openspec-ff-change/SKILL.md create mode 100644 .claude/skills/openspec-new-change/SKILL.md create mode 100644 .claude/skills/openspec-onboard/SKILL.md create mode 100644 .claude/skills/openspec-sync-specs/SKILL.md create mode 100644 .claude/skills/openspec-verify-change/SKILL.md create mode 100644 .gemini/commands/opsx/apply.toml create mode 100644 .gemini/commands/opsx/archive.toml create mode 100644 .gemini/commands/opsx/bulk-archive.toml create mode 100644 .gemini/commands/opsx/continue.toml create mode 100644 .gemini/commands/opsx/explore.toml create mode 100644 .gemini/commands/opsx/ff.toml create mode 100644 .gemini/commands/opsx/new.toml create mode 100644 .gemini/commands/opsx/onboard.toml create mode 100644 .gemini/commands/opsx/sync.toml create mode 100644 .gemini/commands/opsx/verify.toml create mode 100644 .gemini/skills/openspec-apply-change/SKILL.md create mode 100644 .gemini/skills/openspec-archive-change/SKILL.md create mode 100644 .gemini/skills/openspec-bulk-archive-change/SKILL.md create mode 100644 .gemini/skills/openspec-continue-change/SKILL.md create mode 100644 .gemini/skills/openspec-explore/SKILL.md create mode 100644 .gemini/skills/openspec-ff-change/SKILL.md create mode 100644 .gemini/skills/openspec-new-change/SKILL.md create mode 100644 .gemini/skills/openspec-onboard/SKILL.md create mode 100644 .gemini/skills/openspec-sync-specs/SKILL.md create mode 100644 .gemini/skills/openspec-verify-change/SKILL.md create mode 100644 openspec/changes/define-project-scope/.openspec.yaml create mode 100644 openspec/changes/define-project-scope/content/agent-personality.md create mode 100644 openspec/changes/define-project-scope/content/channel-config.md create mode 100644 openspec/changes/define-project-scope/content/conversation-flow.md create mode 100644 openspec/changes/define-project-scope/content/export-formats.md create mode 100644 openspec/changes/define-project-scope/content/knowledge-base/README.md create mode 100644 openspec/changes/define-project-scope/content/knowledge-base/Reglement-Spielgruppe-2024.pdf create mode 100644 openspec/changes/define-project-scope/content/knowledge-base/Tarifliste-Spielgruppe-2024_2025.pdf create mode 100644 openspec/changes/define-project-scope/content/knowledge-base/faq.md create mode 100644 openspec/changes/define-project-scope/content/knowledge-base/fees.md create mode 100644 openspec/changes/define-project-scope/content/knowledge-base/regulations.md create mode 100644 openspec/changes/define-project-scope/content/knowledge-base/schedule.md create mode 100644 openspec/changes/define-project-scope/content/notification-template.md create mode 100644 openspec/changes/define-project-scope/content/registration-fields.md create mode 100644 openspec/changes/define-project-scope/content/registration-schema.json create mode 100644 openspec/changes/define-project-scope/content/release-priorities.md create mode 100644 openspec/changes/define-project-scope/content/sample-responses.md create mode 100644 openspec/changes/define-project-scope/content/validation-rules.md create mode 100644 openspec/changes/define-project-scope/design.md create mode 100644 openspec/changes/define-project-scope/proposal.md create mode 100644 openspec/changes/define-project-scope/specs/chat-interface/spec.md create mode 100644 openspec/changes/define-project-scope/specs/conversational-registration/spec.md create mode 100644 openspec/changes/define-project-scope/specs/email-channel/spec.md create mode 100644 openspec/changes/define-project-scope/specs/registration-data-store/spec.md create mode 100644 openspec/changes/define-project-scope/specs/registration-notifications/spec.md create mode 100644 openspec/changes/define-project-scope/specs/service-knowledge-base/spec.md create mode 100644 openspec/changes/define-project-scope/tasks.md create mode 100644 openspec/config.yaml diff --git a/.claude/commands/opsx/apply.md b/.claude/commands/opsx/apply.md new file mode 100644 index 0000000..bf23721 --- /dev/null +++ b/.claude/commands/opsx/apply.md @@ -0,0 +1,152 @@ +--- +name: "OPSX: Apply" +description: Implement tasks from an OpenSpec change (Experimental) +category: Workflow +tags: [workflow, artifacts, experimental] +--- + +Implement tasks from an OpenSpec change. + +**Input**: Optionally specify a change name (e.g., `/opsx:apply add-auth`). If omitted, check if it can be inferred from conversation context. If vague or ambiguous you MUST prompt for available changes. + +**Steps** + +1. **Select the change** + + If a name is provided, use it. Otherwise: + - Infer from conversation context if the user mentioned a change + - Auto-select if only one active change exists + - If ambiguous, run `openspec list --json` to get available changes and use the **AskUserQuestion tool** to let the user select + + Always announce: "Using change: " and how to override (e.g., `/opsx:apply `). + +2. **Check status to understand the schema** + ```bash + openspec status --change "" --json + ``` + Parse the JSON to understand: + - `schemaName`: The workflow being used (e.g., "spec-driven") + - Which artifact contains the tasks (typically "tasks" for spec-driven, check status for others) + +3. **Get apply instructions** + + ```bash + openspec instructions apply --change "" --json + ``` + + This returns: + - Context file paths (varies by schema) + - Progress (total, complete, remaining) + - Task list with status + - Dynamic instruction based on current state + + **Handle states:** + - If `state: "blocked"` (missing artifacts): show message, suggest using `/opsx:continue` + - If `state: "all_done"`: congratulate, suggest archive + - Otherwise: proceed to implementation + +4. **Read context files** + + Read the files listed in `contextFiles` from the apply instructions output. + The files depend on the schema being used: + - **spec-driven**: proposal, specs, design, tasks + - Other schemas: follow the contextFiles from CLI output + +5. **Show current progress** + + Display: + - Schema being used + - Progress: "N/M tasks complete" + - Remaining tasks overview + - Dynamic instruction from CLI + +6. **Implement tasks (loop until done or blocked)** + + For each pending task: + - Show which task is being worked on + - Make the code changes required + - Keep changes minimal and focused + - Mark task complete in the tasks file: `- [ ]` → `- [x]` + - Continue to next task + + **Pause if:** + - Task is unclear → ask for clarification + - Implementation reveals a design issue → suggest updating artifacts + - Error or blocker encountered → report and wait for guidance + - User interrupts + +7. **On completion or pause, show status** + + Display: + - Tasks completed this session + - Overall progress: "N/M tasks complete" + - If all done: suggest archive + - If paused: explain why and wait for guidance + +**Output During Implementation** + +``` +## Implementing: (schema: ) + +Working on task 3/7: +[...implementation happening...] +✓ Task complete + +Working on task 4/7: +[...implementation happening...] +✓ Task complete +``` + +**Output On Completion** + +``` +## Implementation Complete + +**Change:** +**Schema:** +**Progress:** 7/7 tasks complete ✓ + +### Completed This Session +- [x] Task 1 +- [x] Task 2 +... + +All tasks complete! You can archive this change with `/opsx:archive`. +``` + +**Output On Pause (Issue Encountered)** + +``` +## Implementation Paused + +**Change:** +**Schema:** +**Progress:** 4/7 tasks complete + +### Issue Encountered + + +**Options:** +1.