andreadellacorte/groove-work-spec
skills/groove-work-spec/SKILL.md
Create outcome spec (overview, decisions, steps, edge cases). Use $ARGUMENTS as spec topic if provided.
$ install --global
skillsauthnpx skillsauth add andreadellacorte/groove groove-work-specInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 24, 2026, 8:33 PM0.4s1 file scanned
SKILL.md
- name:
- groove-work-spec
- description:
- Create outcome spec (overview, decisions, steps, edge cases). Use $ARGUMENTS as spec topic if provided.
- license:
- MIT
- allowed-tools:
- Read Write Edit Glob Grep Bash(git:*) AskUserQuestion
- author:
- andreadellacorte
groove-work-spec
Use $ARGUMENTS as the spec topic if provided.
Outcome
A complete outcome spec that defines what to build and how to verify it — the agent determines the procedure.
Acceptance Criteria
Spec file contains:
- Overview: What to build and why
- Decisions: Key technical choices with rationale
- Implementation Steps: Concrete, ordered steps
- Edge Cases: Error handling, boundary conditions
Constraints
- Sanitize topic for use as filename — strip path separators, special characters, and traversal patterns (
../) - Specs directory is always
.groove/memory/specs/ - Ensure the specs directory exists (create if missing)
- Research codebase first (use Explore agent)
- Interview user for decisions, edge cases, testing approach, scope
- Assess scope: if the work has natural seams (independent components, sequential phases, separable concerns), recommend splitting into a parent spec with child specs
- Parent spec: Overview of the full feature, links to child specs, execution order if sequential
- Child specs: Each self-contained with its own Overview, Decisions, Steps, Edge Cases
- Naming:
<topic>.mdfor single specs,<topic>/index.md+<topic>/01-<part>.mdfor split specs - User decides: Present the split recommendation with rationale, user confirms or overrides
- Write spec in isolated context (use general-purpose agent)
- Verify all required sections exist before completing
- Reference actual codebase patterns, not generic advice
Quality Signals
- Decisions reference real code patterns
- Steps include actual file paths and function names
- Edge cases reflect discovered constraints
Related Skills
andreadellacorte/groove-utilities-stats
testing
VerifiedTrustedCommunity
Quantified compound-loop dashboard: lessons captured vs graduated, adherence streaks, and task velocity. Use to see whether the workflow is actually compounding.
5SKILL.mdUpdated Jun 5, 2026
andreadellacorte/groove
data-ai
VerifiedTrustedCommunity
Groove engineering workflow system. Top-level entry point. Use groove-daily-*, groove-work-*, groove-utilities-*, groove-admin-* for all workflow and admin commands.
5SKILL.mdUpdated Apr 24, 2026
andreadellacorte/groove-work-compound
documentation
VerifiedTrustedCommunity
Document lessons, update rules/templates/docs. Use to capture learnings after review.
5SKILL.mdUpdated Apr 24, 2026
andreadellacorte/groove-utilities-prime
tools
VerifiedTrustedCommunity
Load groove workflow context into the conversation. Run at the start of every session.
5SKILL.mdUpdated Apr 24, 2026