writing-specs

Automates structured spec-writing workflows with feature specs, NFR mappings, and migrations.

Updated Dec 31, 2025
One-click install
npx skills add https://github.com/tomgun/agentic-framework --skill writing-specs-tomgun
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-specs
Source: https://github.com/tomgun/agentic-framework/tree/main/.agentic/lib/agents/claude/skills/writing-specs
Command: npx skills add https://github.com/tomgun/agentic-framework --skill writing-specs-tomgun

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Writing and maintaining feature specs, acceptance criteria, and migrations is error-prone and time-consuming. This Skill automates structured spec-writing workflows, enforces contract rules, and tracks delta changes across feature lifecycles.

Core Features & Use Cases

  • Spec-writing workflow with protection levels, NFR integration, delta tracking, and spec health checks.
  • Manage next IDs (F-XXXX), create FEATURES.md entries, acceptance criteria, and migrations for new/updated/shipped features.
  • Support audits and evolutions of shipped features with additive changes and justification markers.

Quick Start

Ask Claude to start a new feature spec and follow the F-XXXX workflow to create a FEATURES.md entry, acceptance criteria, and a migration.

Frequently Asked Questions about writing-specs

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

FAQPage Schema
How do I automate feature spec generation and acceptance criteria writing?

Automate feature spec generation by initiating a structured workflow that creates FEATURES.md entries, defines acceptance criteria, maps NFRs, and tracks delta changes across the feature lifecycle. This enforces spec health checks and contract protection.

What is delta tracking for feature specs and when do I need it?

Delta tracking for feature specs records incremental changes and additive updates across planning, in-progress, and shipped stages. You need it when evolving shipped features with justification markers to enforce contract rules and audit spec health.

How to create migrations for updated or shipped features with contract protection?

Create migrations for updated features by applying additive changes with justification markers, enforcing contract protection rules, and coordinating with framework tooling. This guarantees structured spec evolution while tracking deltas and maintaining spec health checks.

Can I manage non-functional requirements and spec health checks within a feature planning workflow?

Yes, you can manage non-functional requirements within the feature planning workflow. The system integrates NFR mappings, enforces spec health checks, and tracks delta changes alongside acceptance criteria and migration creation.

What is the best way to structure feature specs to avoid errors during planning?

The best way to structure feature specs is using an automated workflow with ID management (F-XXXX), FEATURES.md entries, acceptance criteria, and NFR integration. This enforces contract rules, tracks deltas, and maintains spec health across the lifecycle.

Does this spec-writing workflow support auditing shipped features for additive changes?

Yes, the spec-writing workflow supports auditing shipped features by applying additive changes with justification markers. It enforces contract protection, tracks deltas, and coordinates migration creation to ensure structured spec evolution.