Agent Ops Spec

Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.

majiayu000 c14dcfb 2 files · 1.8 KB Updated 567 repo stars

File contents

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.

majiayu000/claude-skill-registry-data/tree/main/documents/agent-ops-spec commit c14dcfbb0d

Frequently asked questions

npx skillmds add majiayu000/agent-ops-spec