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.

diegosouzapw Updated 54 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.

diegosouzapw/awesome-omni-skill/tree/main/skills/data-ai/agent-ops-spec commit 1adb548488

Frequently asked questions

npx skillmds@latest add diegosouzapw/agent-ops-spec