Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
47 commits
Select commit Hold shift + click to select a range
52872de
fix: correct backend room API route handling
RawatePramod Jun 11, 2026
469aaee
chore: add Spec Kit scaffolding
RawatePramod Jun 17, 2026
72b932c
docs: ratify constitution v1.0.0
RawatePramod Jun 17, 2026
eef7d29
docs: add discovery notes
RawatePramod Jun 17, 2026
64ef1e8
docs(spec): specify Feature Group 1 — Room Setup & Lobby
RawatePramod Jun 17, 2026
f4cec58
docs(spec): clarify Group 1 — start auto-advance, join error wording,…
RawatePramod Jun 17, 2026
8f9f816
docs(plan): plan Feature Group 1 — Room Setup & Lobby
RawatePramod Jun 17, 2026
55c338d
docs(tasks): decompose Feature Group 1 into ordered tasks
RawatePramod Jun 17, 2026
adbcced
feat(group1): add room host identity and started state (foundational)
RawatePramod Jun 17, 2026
697a16f
feat(group1): identify the room host in the lobby
RawatePramod Jun 17, 2026
6631574
feat(group1): validate room code on join
RawatePramod Jun 17, 2026
2e4c54e
feat(group1): auto-poll the lobby every 2s
RawatePramod Jun 17, 2026
a1b58c2
feat(group1): add host-only game start with gating and auto-advance
RawatePramod Jun 17, 2026
892c031
chore(group1): validate Scenario 1 and close Feature Group 1
RawatePramod Jun 17, 2026
c937ad5
docs(spec): specify Feature Group 2 — Game Start & Drawer Flow
RawatePramod Jun 17, 2026
ae76f62
docs(spec): clarify Group 2 — word selection, drawer, guesser visibility
RawatePramod Jun 17, 2026
861fc73
docs(plan): plan Feature Group 2 — Game Start & Drawer Flow
RawatePramod Jun 17, 2026
00b8e6a
docs(tasks): decompose Feature Group 2 into ordered tasks
RawatePramod Jun 17, 2026
6758f1f
feat(group2): validate and trim player names
RawatePramod Jun 17, 2026
07126d9
feat(group2): assign and identify the drawer
RawatePramod Jun 17, 2026
66021e5
feat(group2): select a deterministic secret word on start
RawatePramod Jun 17, 2026
9d8babf
feat(group2): reveal the secret word to the drawer only
RawatePramod Jun 17, 2026
dff7c13
chore(group2): validate Scenario 2 and reconcile analyze finding I1
RawatePramod Jun 17, 2026
bde026b
docs(spec): specify Feature Group 3 — Gameplay Interaction
RawatePramod Jun 17, 2026
6ffe3c9
docs(spec): clarify Group 3 — drawer-local canvas, verbatim history, …
RawatePramod Jun 17, 2026
f0ba73a
docs(plan): plan Feature Group 3 — Gameplay Interaction
RawatePramod Jun 17, 2026
dcadd3c
docs(tasks): decompose Feature Group 3 into ordered tasks
RawatePramod Jun 17, 2026
be1a63f
feat(group3): add score and guess-history data shape (foundational)
RawatePramod Jun 17, 2026
6f2687d
feat(group3): add interactive drawing canvas for the drawer
RawatePramod Jun 17, 2026
fc5c02d
feat(group3): submit and validate guesses
RawatePramod Jun 18, 2026
3d7ffa5
feat(group3): sync and render the shared guess history
RawatePramod Jun 18, 2026
a4a87b0
feat(group3): score correct guesses and lock after correct
RawatePramod Jun 18, 2026
beae68b
chore(group3): validate Scenario 3 and close Feature Group 3
RawatePramod Jun 18, 2026
4fd63bd
docs(spec): specify Feature Group 4 — Result, Restart & Final Validation
RawatePramod Jun 18, 2026
05c2b47
docs(spec): clarify Group 4 — host-ended round, restart returns to lobby
RawatePramod Jun 18, 2026
02f7c49
docs(plan): plan Feature Group 4 — Result, Restart & Final Validation
RawatePramod Jun 18, 2026
26251d8
docs(tasks): decompose Feature Group 4 into ordered tasks
RawatePramod Jun 18, 2026
a80948a
feat(group4): end the round and reveal the result to all
RawatePramod Jun 19, 2026
1c674ba
feat(group4): restart to a clean lobby
RawatePramod Jun 19, 2026
57b9796
chore(group4): validate Scenario 4 and close Feature Group 4
RawatePramod Jun 19, 2026
9a0c5ab
docs: add reflection report
RawatePramod Jun 19, 2026
6b54a88
docs: make discovery notes' gaps/assumptions counts explicit
RawatePramod Jun 19, 2026
496e213
docs(spec): specify increment 005 — auto-end round on correct guess
RawatePramod Jun 19, 2026
c465932
docs(plan): plan increment 005 — auto-end round on correct guess
RawatePramod Jun 19, 2026
ec3acfc
docs(tasks): decompose increment 005 into ordered tasks
RawatePramod Jun 19, 2026
893f1fd
feat(group3): end the round automatically on a correct guess
RawatePramod Jun 19, 2026
92b9f18
chore(group3): validate increment 005 and record auto-end decision
RawatePramod Jun 19, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 31 additions & 0 deletions .claude/skills/speckit-agent-context-update/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
---
name: speckit-agent-context-update
description: Refresh the managed Spec Kit section in the coding agent context file
compatibility: Requires spec-kit project structure with .specify/ directory
metadata:
author: github-spec-kit
source: agent-context:commands/speckit.agent-context.update.md
---

# Update Coding Agent Context

Refresh the managed Spec Kit section inside the active coding agent's context/instruction file (e.g. `CLAUDE.md`, `.github/copilot-instructions.md`, `AGENTS.md`).

## Behavior

The script reads the agent-context extension config at
`.specify/extensions/agent-context/agent-context-config.yml` to discover:

- `context_file` — the path of the coding agent context file to manage.
- `context_markers.start` / `.end` — the delimiters surrounding the managed section. Defaults to `<!-- SPECKIT START -->` and `<!-- SPECKIT END -->` when the field is missing.

It then creates, replaces, or appends the managed block so that the section points at the most recent plan path when one can be discovered (`specs/<feature>/plan.md`).

If `context_file` is empty or the file cannot be located, the command reports nothing to do and exits successfully.

## Execution

- **Bash**: `.specify/extensions/agent-context/scripts/bash/update-agent-context.sh [plan_path]`
- **PowerShell**: `.specify/extensions/agent-context/scripts/powershell/update-agent-context.ps1 [plan_path]`

When `plan_path` is omitted, the script auto-detects the most recently modified `specs/*/plan.md`.
260 changes: 260 additions & 0 deletions .claude/skills/speckit-analyze/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,260 @@
---
name: "speckit-analyze"
description: "Perform a non-destructive cross-artifact consistency and quality analysis across spec.md, plan.md, and tasks.md after task generation."
argument-hint: "Optional focus areas for analysis"
compatibility: "Requires spec-kit project structure with .specify/ directory"
metadata:
author: "github-spec-kit"
source: "templates/commands/analyze.md"
user-invocable: true
disable-model-invocation: false
---


## User Input

```text
$ARGUMENTS
```

You **MUST** consider the user input before proceeding (if not empty).

## Pre-Execution Checks

**Check for extension hooks (before analysis)**:
- Check if `.specify/extensions.yml` exists in the project root.
- If it exists, read it and look for entries under the `hooks.before_analyze` key
- If the YAML cannot be parsed or is invalid, skip hook checking silently and continue normally
- Filter out hooks where `enabled` is explicitly `false`. Treat hooks without an `enabled` field as enabled by default.
- For each remaining hook, do **not** attempt to interpret or evaluate hook `condition` expressions:
- If the hook has no `condition` field, or it is null/empty, treat the hook as executable
- If the hook defines a non-empty `condition`, skip the hook and leave condition evaluation to the HookExecutor implementation
- When constructing slash commands from hook command names, replace dots (`.`) with hyphens (`-`). For example, `speckit.git.commit``/speckit-git-commit`.
- For each executable hook, output the following based on its `optional` flag:
- **Optional hook** (`optional: true`):
```
## Extension Hooks
**Optional Pre-Hook**: {extension}
Command: `/{command}`
Description: {description}
Prompt: {prompt}
To execute: `/{command}`
```
- **Mandatory hook** (`optional: false`):
```
## Extension Hooks
**Automatic Pre-Hook**: {extension}
Executing: `/{command}`
EXECUTE_COMMAND: {command}
Wait for the result of the hook command before proceeding to the Goal.
```
- If no hooks are registered or `.specify/extensions.yml` does not exist, skip silently
## Goal
Identify inconsistencies, duplications, ambiguities, and underspecified items across the three core artifacts (`spec.md`, `plan.md`, `tasks.md`) before implementation. This command MUST run only after `/speckit-tasks` has successfully produced a complete `tasks.md`.
## Operating Constraints
**STRICTLY READ-ONLY**: Do **not** modify any files. Output a structured analysis report. Offer an optional remediation plan (user must explicitly approve before any follow-up editing commands would be invoked manually).
**Constitution Authority**: The project constitution (`.specify/memory/constitution.md`) is **non-negotiable** within this analysis scope. Constitution conflicts are automatically CRITICAL and require adjustment of the spec, plan, or tasks—not dilution, reinterpretation, or silent ignoring of the principle. If a principle itself needs to change, that must occur in a separate, explicit constitution update outside `/speckit-analyze`.
## Execution Steps
### 1. Initialize Analysis Context
Run `.specify/scripts/bash/check-prerequisites.sh --json --require-tasks --include-tasks` once from repo root and parse JSON for FEATURE_DIR and AVAILABLE_DOCS. Derive absolute paths:
- SPEC = FEATURE_DIR/spec.md
- PLAN = FEATURE_DIR/plan.md
- TASKS = FEATURE_DIR/tasks.md
Abort with an error message if any required file is missing (instruct the user to run missing prerequisite command).
For single quotes in args like "I'm Groot", use escape syntax: e.g 'I'\''m Groot' (or double-quote if possible: "I'm Groot").
### 2. Load Artifacts (Progressive Disclosure)
Load only the minimal necessary context from each artifact:
**From spec.md:**
- Overview/Context
- Functional Requirements
- Success Criteria (measurable outcomes — e.g., performance, security, availability, user success, business impact)
- User Stories
- Edge Cases (if present)
**From plan.md:**
- Architecture/stack choices
- Data Model references
- Phases
- Technical constraints
**From tasks.md:**
- Task IDs
- Descriptions
- Phase grouping
- Parallel markers [P]
- Referenced file paths
**From constitution:**
- Load `.specify/memory/constitution.md` for principle validation
### 3. Build Semantic Models
Create internal representations (do not include raw artifacts in output):
- **Requirements inventory**: For each Functional Requirement (FR-###) and Success Criterion (SC-###), record a stable key. Use the explicit FR-/SC- identifier as the primary key when present, and optionally also derive an imperative-phrase slug for readability (e.g., "User can upload file" → `user-can-upload-file`). Include only Success Criteria items that require buildable work (e.g., load-testing infrastructure, security audit tooling), and exclude post-launch outcome metrics and business KPIs (e.g., "Reduce support tickets by 50%").
- **User story/action inventory**: Discrete user actions with acceptance criteria
- **Task coverage mapping**: Map each task to one or more requirements or stories (inference by keyword / explicit reference patterns like IDs or key phrases)
- **Constitution rule set**: Extract principle names and MUST/SHOULD normative statements
### 4. Detection Passes (Token-Efficient Analysis)
Focus on high-signal findings. Limit to 50 findings total; aggregate remainder in overflow summary.
#### A. Duplication Detection
- Identify near-duplicate requirements
- Mark lower-quality phrasing for consolidation
#### B. Ambiguity Detection
- Flag vague adjectives (fast, scalable, secure, intuitive, robust) lacking measurable criteria
- Flag unresolved placeholders (TODO, TKTK, ???, `<placeholder>`, etc.)
#### C. Underspecification
- Requirements with verbs but missing object or measurable outcome
- User stories missing acceptance criteria alignment
- Tasks referencing files or components not defined in spec/plan
#### D. Constitution Alignment
- Any requirement or plan element conflicting with a MUST principle
- Missing mandated sections or quality gates from constitution
#### E. Coverage Gaps
- Requirements with zero associated tasks
- Tasks with no mapped requirement/story
- Success Criteria requiring buildable work (performance, security, availability) not reflected in tasks
#### F. Inconsistency
- Terminology drift (same concept named differently across files)
- Data entities referenced in plan but absent in spec (or vice versa)
- Task ordering contradictions (e.g., integration tasks before foundational setup tasks without dependency note)
- Conflicting requirements (e.g., one requires Next.js while other specifies Vue)
### 5. Severity Assignment
Use this heuristic to prioritize findings:
- **CRITICAL**: Violates constitution MUST, missing core spec artifact, or requirement with zero coverage that blocks baseline functionality
- **HIGH**: Duplicate or conflicting requirement, ambiguous security/performance attribute, untestable acceptance criterion
- **MEDIUM**: Terminology drift, missing non-functional task coverage, underspecified edge case
- **LOW**: Style/wording improvements, minor redundancy not affecting execution order
### 6. Produce Compact Analysis Report
Output a Markdown report (no file writes) with the following structure:
## Specification Analysis Report
| ID | Category | Severity | Location(s) | Summary | Recommendation |
|----|----------|----------|-------------|---------|----------------|
| A1 | Duplication | HIGH | spec.md:L120-134 | Two similar requirements ... | Merge phrasing; keep clearer version |
(Add one row per finding; generate stable IDs prefixed by category initial.)
**Coverage Summary Table:**
| Requirement Key | Has Task? | Task IDs | Notes |
|-----------------|-----------|----------|-------|
**Constitution Alignment Issues:** (if any)
**Unmapped Tasks:** (if any)
**Metrics:**
- Total Requirements
- Total Tasks
- Coverage % (requirements with >=1 task)
- Ambiguity Count
- Duplication Count
- Critical Issues Count
### 7. Provide Next Actions
At end of report, output a concise Next Actions block:
- If CRITICAL issues exist: Recommend resolving before `/speckit-implement`
- If only LOW/MEDIUM: User may proceed, but provide improvement suggestions
- Provide explicit command suggestions: e.g., "Run /speckit-specify with refinement", "Run /speckit-plan to adjust architecture", "Manually edit tasks.md to add coverage for 'performance-metrics'"
### 8. Offer Remediation
Ask the user: "Would you like me to suggest concrete remediation edits for the top N issues?" (Do NOT apply them automatically.)
### 9. Check for extension hooks
After reporting, check if `.specify/extensions.yml` exists in the project root.
- If it exists, read it and look for entries under the `hooks.after_analyze` key
- If the YAML cannot be parsed or is invalid, skip hook checking silently and continue normally
- Filter out hooks where `enabled` is explicitly `false`. Treat hooks without an `enabled` field as enabled by default.
- For each remaining hook, do **not** attempt to interpret or evaluate hook `condition` expressions:
- If the hook has no `condition` field, or it is null/empty, treat the hook as executable
- If the hook defines a non-empty `condition`, skip the hook and leave condition evaluation to the HookExecutor implementation
- When constructing slash commands from hook command names, replace dots (`.`) with hyphens (`-`). For example, `speckit.git.commit` → `/speckit-git-commit`.
- For each executable hook, output the following based on its `optional` flag:
- **Optional hook** (`optional: true`):
```
## Extension Hooks
**Optional Hook**: {extension}
Command: `/{command}`
Description: {description}
Prompt: {prompt}
To execute: `/{command}`
```
- **Mandatory hook** (`optional: false`):
```
## Extension Hooks
**Automatic Hook**: {extension}
Executing: `/{command}`
EXECUTE_COMMAND: {command}
```
- If no hooks are registered or `.specify/extensions.yml` does not exist, skip silently
## Operating Principles
### Context Efficiency
- **Minimal high-signal tokens**: Focus on actionable findings, not exhaustive documentation
- **Progressive disclosure**: Load artifacts incrementally; don't dump all content into analysis
- **Token-efficient output**: Limit findings table to 50 rows; summarize overflow
- **Deterministic results**: Rerunning without changes should produce consistent IDs and counts
### Analysis Guidelines
- **NEVER modify files** (this is read-only analysis)
- **NEVER hallucinate missing sections** (if absent, report them accurately)
- **Prioritize constitution violations** (these are always CRITICAL)
- **Use examples over exhaustive rules** (cite specific instances, not generic patterns)
- **Report zero issues gracefully** (emit success report with coverage statistics)
## Context
$ARGUMENTS
Loading
Loading