validkeys
- 20 skills
- 0 followers
- 6 hours ago last updated
- ▌ Agent Instruction · validkeysManage AI instruction files in monorepos during development sessions. Use when the user says "add rule", "update CLAUDE.md", "update AGENTS.md", "list instruction rules", "build instruction files", or "show available rules".
- ▌ Contracted · validkeys bundleUse when building TypeScript services with @validkeys/contracted, defineCommand, defineService, defineError, or the service-command pattern. Covers contract definition, implementation, dependency injection, error handling with TaggedErrors, and service composition with Zod validation.
- ▌ Sherpy CLI · validkeysValidate and convert Sherpy YAML documents using the Sherpy CLI tool. Use when you need to validate business requirements, technical requirements, milestones, milestone tasks, timelines, QA test plans, or gap analysis worksheets against their schemas, or convert them to formatted markdown. Triggers when working with Sherpy YAML files, checking document validity, or generating markdown documentation from planning artifacts.
- ▌ Sherpy Flow · validkeysOrchestrates the full Sherpy planning workflow from requirements to QA-ready delivery plan. Supports AI, human, and hybrid audience selection for appropriate task detail levels. Detects which artifacts already exist, shows a visual pipeline status, and guides through each skill in sequence — gap analysis, business interview, technical interview, implementation planning, plan review, definition of done, architecture decisions, delivery timeline, QA test plan, and summary generation. Automatically organizes all artifacts into a structured docs/ folder.
- ▌ QA Test Plan · validkeys bundleGenerates a structured QA test plan from business-requirements.yaml and technical-requirements.yaml. Produces test suites keyed to functional requirements and user personas, covering positive, negative, edge, security, and performance cases. Outputs qa-test-plan.yaml ready for use in delivery timeline QA phases.
- ▌ Delivery Timeline · validkeys bundleGenerates a delivery timeline from a completed milestones.yaml. Asks for a production deploy date, QA rounds, and days per QA session. Updates each milestone with estimated_days, produces timeline.yaml with a complete relative-day schedule, and appends a workback block mapping every item to a real calendar date working backwards from the production deploy date.
- ▌ Developer Summary · validkeys bundleGenerates a concise developer summary from planning artifacts. Auto-discovers business requirements, technical requirements, milestones, and timeline from the docs/ folder structure. Outputs a focused summary with project overview, deliverables, and milestone roadmap.
- ▌ Executive Summary · validkeys bundleGenerates an executive summary from planning artifacts for non-technical stakeholders. Auto-discovers business requirements, technical requirements, and timeline from the docs/ folder structure. Outputs a comprehensive summary covering business problem, solution, features, timeline, success metrics, risks, and resources.
- ▌ Definition Of Done · validkeys bundleEnhances milestones.yaml with detailed acceptance criteria for each milestone. Derives functional acceptance criteria, non-functional gates, testing requirements, documentation requirements, and exit checklists from business and technical requirements. Updates milestones.yaml in place with optional acceptance_criteria and exit_checklist fields.
- ▌ Sherpy CLI Planner · validkeysOrchestrates the full Sherpy planning workflow using the Sherpy CLI. Requires the sherpy CLI to be installed. Supports AI, human, and hybrid audience selection for appropriate task detail levels. Replaces the need for 14 individual skill files by loading step-specific instructions on demand via `sherpy prompt`. Detects existing artifacts, shows visual pipeline status, and guides through each step in sequence.
- ▌ UX Wireframe Planning · validkeys bundleDetects React/webapp changes from the implementation plan and technical requirements. When UI work is found, generates a structured wireframe specification (wireframe-spec.yaml) and low-fidelity Pencil (.pen) wireframes using a shared design library for consistency. Auto-skips for non-webapp projects.
- ▌ Gap Analysis Worksheet · validkeys bundleAnalyzes an initial business requirements document for gaps, ambiguities, and missing information. Generates gap-analysis-worksheet.md with structured requirement/question/answer blocks grouped by category — designed to be completed by a business analyst before formal requirements gathering begins.
- ▌ Implementation Planner · validkeys bundleGenerates implementation plans with milestones and tasks from business and technical requirements. Supports AI, human, and hybrid audiences with appropriate detail levels. Embeds best practices including task sizing (30m-2.5h), style anchors, TDD requirements, and quality constraints. Outputs milestones.yaml and milestone-m*.tasks.yaml files ready for development.
- ▌ Style Anchors Collection · validkeys bundleCollects and documents exemplar code patterns as style anchors between technical requirements and implementation planning. Creates a reusable library of code examples with usage guidelines that implementation-planner references in task instructions to prevent architectural drift.
- ▌ Create Continuation Prompt · validkeysCreates a continuation prompt and posts to the console for easy context clearing and resume
- ▌ Implementation Plan Review · validkeys bundleReviews generated implementation plans against best practices including task sizing (30m-2.5h), style anchors, TDD requirements (AI audience), drift prevention (AI audience), and quality constraints. Validates milestones.yaml and task files for completeness, alignment, and development readiness. Adjusts review criteria based on target audience (AI, human, or hybrid).
- ▌ Architecture Decision Record · validkeys bundleExtracts key architectural decisions from technical-requirements.yaml and formalizes them as individual ADR markdown files in an adrs/ directory. Each ADR captures context, the decision made, alternatives considered, and consequences — creating a durable record of why the system is built the way it is.
- ▌ Business Requirements Interview · validkeys bundleIntelligent, context-aware interview that analyzes your project idea first, identifies gaps, then asks targeted questions. Adapts dynamically based on responses. Generates business-requirements.yaml.
- ▌ Technical Requirements Interview · validkeys bundleConducts structured interviews to derive technical requirements from business requirements. Requires completed business-requirements.yaml as input. Asks targeted technical questions about architecture, technology stack, data model, APIs, security, testing, and deployment. Generates technical-requirements.yaml output.
- ▌ Implementation Plan Best Practices · validkeys bundleEducational guide on best practices for creating implementation plans that prevent drift. Covers style anchors, task sizing, TDD requirements, affirmative instructions, drift handling, and quality gates. Use when creating or improving implementation plans to ensure they follow proven patterns.