How does the skill handle features that are already shipped?

It treats shipped specs as protected contracts, requiring additive-only changes, specific markers, and mandatory migration entries to ensure contract protection.

Can it detect overlapping features?

Yes, using the 'ag intel spec' command, the skill checks for overlapping features and existing acceptance criteria patterns to prevent duplicate work.

What are YAML contracts in this skill?

YAML contracts are structured files located at spec/contracts/F-XXXX.yaml that define feature assertions, verification commands, and links to relevant tests.

Does it support non-functional requirements?

Yes, it includes built-in tools to check if specific NFRs are applicable to a feature and ensures they are integrated into the spec workflow.

What is persona-aware scoping?

This allows you to link feature assertions and scenarios to specific user types and platforms (like PWA or Web) defined in a personas.yaml configuration.

Feature Spec & Contract Manager

Name: Feature Spec & Contract Manager
Author: tomgun

bytomgun

0•

Productivity & Workflow

Manages the lifecycle of feature specifications and YAML-based behavioral contracts with automated health checks.

The Writing Specs skill provides a robust framework for documenting and enforcing feature requirements within Claude Code. It automates the creation of feature-specific specifications, manages YAML contracts with verifiable assertions, and ensures non-functional requirements (NFRs) are addressed. By integrating persona-aware scoping and mandatory migration paths for shipped features, it prevents regression and maintains high documentation standards throughout the software development lifecycle.

Key Features

01Intelligence-driven overlap detection and acceptance criteria analysis

02Integration with NFR checks and automated spec health audits

03Mandatory migration workflows for evolving shipped specifications

040 GitHub stars

05Automated feature tracking and spec generation via YAML contracts

06Persona-aware scoping for user-specific capabilities and platforms

Use Cases

01Mapping complex feature capabilities to specific user personas and technical platforms

02Defining new feature requirements with strictly typed YAML contracts and acceptance criteria

03Updating existing specifications while preserving historical assertions and ensuring backward compatibility

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add tomgun/agentic-framework writing-specs

For use in Claude.ai and ChatGPT

Key Features

01Intelligence-driven overlap detection and acceptance criteria analysis

02Integration with NFR checks and automated spec health audits

03Mandatory migration workflows for evolving shipped specifications

040 GitHub stars

05Automated feature tracking and spec generation via YAML contracts

06Persona-aware scoping for user-specific capabilities and platforms

Use Cases

01Mapping complex feature capabilities to specific user personas and technical platforms

02Defining new feature requirements with strictly typed YAML contracts and acceptance criteria

03Updating existing specifications while preserving historical assertions and ensuring backward compatibility

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add tomgun/agentic-framework writing-specs

For use in Claude.ai and ChatGPT