# Wcpaxx Spec Kit Brownfield Extensions Brownfield Ears

> EARS Requirements Conversion

- Skill: `tomevault-io/wcpaxx-spec-kit-brownfield-extensions-brownfield-ears` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/wcpaxx-spec-kit-brownfield-extensions-brownfield-ears`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/wcpaxx-spec-kit-brownfield-extensions-brownfield-ears/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/wcpaxx-spec-kit-brownfield-extensions-brownfield-ears

---


# EARS Requirements Conversion

Convert natural language requirements into **EARS format** structured documents.

## What is EARS?

EARS (Easy Approach to Requirements Syntax) uses fixed sentence templates to:
- Eliminate ambiguity in requirements
- Ensure testability
- Improve AI comprehension accuracy

## Quick Start

1. Provide a natural language requirement description
2. This skill converts it to EARS format
3. Output is saved to `.docs/EARS/[NNN]-[feature-name].md`
4. Use the EARS document with `/speckit.specify` for better specs

## EARS Patterns

| Pattern | Template | Use Case |
|---------|----------|----------|
| **Ubiquitous** | `The system shall <function>` | Always-required functionality |
| **Event-Driven** | `When <trigger>, the system shall <response>` | Triggered actions |
| **State-Driven** | `If <state>, then the system shall <behavior>` | State-dependent behavior |
| **Optional** | `Where <condition>, the user can <operation>` | User-optional features |
| **Complex** | `When <trigger>, and <state>, the system shall <response>` | Multi-condition triggers |

## Output Location

```
[Project]/
├── .docs/EARS/              # EARS documents (NOT in .specify/)
│   ├── 001-user-auth.md
│   └── 002-payment.md
├── .specify/                # SDD config (separate)
└── specs/                   # Feature specs (separate)
```

## Workflow

```
[Natural Language] → /brownfield-ears → [EARS Doc] → /speckit.specify → [Spec]
```

## Conversion Process

1. **Parse input** - Extract actors, actions, conditions, data
2. **Categorize** - Map to EARS patterns
3. **Number** - Assign IDs: `[PREFIX]-[TYPE]-[SEQ]` (e.g., AUTH-EV-001)
4. **Generate** - Create structured document

## Reference

- [references/conversion-guide.md](references/conversion-guide.md) - Detailed conversion rules
- [references/document-template.md](references/document-template.md) - Output template
- [references/examples.md](references/examples.md) - Conversion examples

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/wcpaxx) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->