# 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.

- Skill: `majiayu000/agent-ops-spec` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/agent-ops-spec`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/agent-ops-spec/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/agent-ops-spec

---


# 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](./templates/spec.template.md).