skills.rest
joshsmithxrm
joshsmithxrmCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

spec

Create, update, or reconcile specs with source code in PPDS projects.

5|1|Updated Dec 14, 2025
Search Tags:#specification#code-quality#software-engineering#acceptance-criteria#conformance#ppds
One-click install
npx skills add https://github.com/joshsmithxrm/power-platform-developer-suite --skill spec-joshsmithxrm
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec
Source: https://github.com/joshsmithxrm/power-platform-developer-suite/tree/main/.claude/skills/spec
Command: npx skills add https://github.com/joshsmithxrm/power-platform-developer-suite --skill spec-joshsmithxrm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Spec management for PPDS projects helps teams prevent drift between documented requirements and implemented code, reducing rework and miscommunication.

Core Features & Use Cases

  • Forward mode: create new specs that map to existing or planned code.
  • Update mode: modify an existing spec to reflect changes in code.
  • Reconcile mode: compare code against a spec, identify drift, and propose changes.
  • Cross-reference: automatically link specs to code paths and constitution guidelines.
  • Regeneration: update READMEs and changelogs to reflect spec changes.

Quick Start

Create, update, or reconcile a spec against your codebase using PPDS conventions.

Frequently Asked Questions about spec

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prevent drift between software specifications and source code?▼

To prevent specification drift, you can reconcile documented requirements against your codebase. This process scans code paths, identifies misalignment, and proposes changes to enforce numbered acceptance criteria.

What is the best way to update existing project specifications to match code changes?▼

Updating specifications to match code changes involves modifying existing specs to reflect implemented updates. This ensures documented requirements remain consistent with the actual source code within your project conventions.

How do I create new software specifications that map to existing code?▼

Creating new specifications that map to existing code uses a forward workflow. It generates requirements aligned with your current or planned source code paths while adhering to established constitution guidelines.

Can I automatically cross-reference specification acceptance criteria with my codebase?▼

Yes, you can automatically cross-reference acceptance criteria with your codebase. This process links specification documents directly to corresponding code paths and constitution guidelines to ensure conformance.

Do I need a specific project structure to enforce numbered acceptance criteria?▼

Enforcing numbered acceptance criteria operates within PPDS conventions, requiring a constitution and templates. It scans your existing code paths to ensure specification and code alignment across forward, update, and reconcile workflows.

Why do my software requirements and implementation keep falling out of sync?▼

Requirements and implementation fall out of sync due to undocumented code changes over time. Reconciling specs with source code identifies this drift and proposes necessary changes to restore conformance.

Related Skills

Explore More Software Engineering Skills→
samjhechtsamjhecht
4

initialize-governance

Generate Constitution, Roadmap, and process documentation templates for project governance.

Community
Advanced
kent013kent013

zenigame-update-docs

Audit and update Alpha Factory documentation against source code and config defaults.

Community
Advanced
Chang-Shih-YungChang-Shih-Yung

health

Aggregate type checker, linter, and test results into a 0-10 composite score.

Community
Advanced
joshsmithxrmjoshsmithxrm
5

backlog

Automate GitHub issue creation, triage, and grooming with PPDS conventions.

Community
Intermediate