Can I use this on an existing project without specs?

Yes. The /spec:init command is designed to scan your existing source code, tests, and configurations to bootstrap a comprehensive spec library automatically.

How does it help with testing?

During the delivery phase, the skill loads acceptance criteria from the spec to serve as TDD targets, ensuring every requirement is covered by at least one test case.

What is the 'Domain > Capability' hierarchy?

It is a product-centric organization method where 'Domains' represent stable business areas and 'Capabilities' represent specific behaviors, ensuring documentation survives code refactors.

How does Spec Awareness differ from a standard backlog?

Backlog items are transient and archived upon completion, whereas Specs are persistent documents stored in docs/specs/ that represent the current state of the product architecture.

Does this skill archive my specifications?

No. While backlog items are moved to archives once finished, specifications are permanent knowledge assets that are only updated or marked as deprecated.

Spec Awareness

Name: Spec Awareness
Author: Elmmly

byElmmly

•

생산성 및 워크플로

Enforces spec-driven development by maintaining persistent product specifications and aligning implementation with defined acceptance criteria.

Spec Awareness is a Claude Code Skill designed to institutionalize spec-driven development (SDD) by creating a persistent source of truth for system behavior. It organizes requirements into a domain-driven hierarchy (docs/specs/{domain}/{capability}.md), ensuring that product specifications outlive transient code refactors and backlog items. The skill automates the entire lifecycle—from bootstrapping specs from existing source code and defining behavioral deltas to enforcing Test-Driven Development (TDD) patterns and verifying implementation against machine-readable acceptance criteria.

주요 기능

01Self-Generating Documentation: Automatically maintains domain-level README files to ensure the specification library remains navigable.

02Workflow Integration: Automatically triggers during load, refresh, design, and delivery phases to provide context-aware guidance.

03Domain-Driven Organization: Groups requirements by stable product domains rather than volatile file structures.

043 GitHub stars

05Acceptance Criteria Management: Tracks the lifecycle of requirements from 'pending' to 'met' within YAML frontmatter.

06Automated Spec Bootstrapping: Scans existing codebases and tests to generate rich, context-aware specifications.

사용 사례

01Managing complex feature handoffs between discovery, design, and implementation phases with automated guidance.

02Retrofitting legacy codebases with clear, structured documentation and behavioral specifications.

03Enforcing rigorous Test-Driven Development by mapping acceptance criteria directly to test cases.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add elmmly/genie-team spec-awareness

For use in Claude.ai and ChatGPT