majiayu000

Spec Management workflow

The most comprehensive Claude Code skills registry | Web Search: https://skills-registry-web.vercel.app

majiayu000 580 88 Updated 6mo ago

Resources

1
GitHub

Install

npx skillscat add majiayu000/claude-skill-registry/skills-core-agent-ops-spec

Install via the SkillsCat registry.

About this skill

This skill manages specification documents in .agent/specs/ to capture and validate user requirements against implementation. It creates traceable specs linked to issues, enabling validation during critical review phases. Use it when tracking feature requirements, acceptance criteria, or detailed feature descriptions that need systematic validation throughout development.

SKILL.md

Spec Management workflow

Purpose

Capture, organize, and trace specifications/requirements so the agent can validate implementation against them.

Location

All specs live in .agent/specs/ with user-specified or auto-generated filenames.

Procedure

Creating a spec

  1. Ask user for filename or generate one (e.g., feature-<name>.spec.md, issue-<id>.spec.md)
  2. Use the spec template
  3. Fill in sections from user input
  4. Link spec to issue(s) in .agent/issues/ via spec_file: field

Validating against spec

  1. Read the linked spec file
  2. Create traceability checklist:
    • Each requirement → implementation location → test(s)
  3. Include in critical review phase

Template

Start from spec template.