# Manage GHE Requirements

Feature work can drift when requirements are missing or stale. This skill defines requirement files, versioning, issue links, and backup steps.

## Install

```bash
npx skillstore add emasoft/ghe-requirements
```

## Metadata

- Status: approved
- Slug: emasoft-ghe-requirements
- Skillstore revision: r1
- Version status: missing
- Tree hash: 0a313a0731bca55001a68794478b3880cd965ea488c54dfce8b019f8f8d54c4b
- Author: Emasoft
- GitHub username: Emasoft
- License: MIT
- Repository: https://github.com/Emasoft/ghe-marketplace/tree/main/plugins/ghe/skills/ghe-requirements
- Ref: 30c73eac2afe762f6aa9c4553158769369d47351
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: confirmation\_required
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands, filesystem
- Quality score: 38
- Quality tier: warning
- Public page: https://skillstore.pages.dev/skills/emasoft-ghe-requirements
- Manifest: https://skillstore.pages.dev/api/skills/emasoft-ghe-requirements/manifest

## Capabilities

- Defines the REQUIREMENTS folder layout with templates, epic folders, wave folders, standalone files, and a changelog.
- Provides a standard REQ file structure with metadata, acceptance criteria, atomic changes, tests, dependencies, and revision history.
- Describes how to create, approve, version, and commit requirement files.
- Shows how to link requirement documents in GitHub issue threads.
- Includes validation checks for linked requirements and version drift.
- Describes backup of requirement files into SERENA memory.

## Use Cases

- Prepare a Feature Requirement: Create a structured requirement before development starts, with acceptance criteria, atomic changes, tests, and dependencies.
- Coordinate GitHub Issue Work: Link GitHub development issues to the current requirement version so implementers share the same source of truth.
- Review Requirement Drift: Compare issue links, requirement versions, and acceptance criteria before implementation review or test planning.

## Prompt Templates

### Create a Requirement Draft

```
Create a GHE requirement draft for this feature request: [feature]. Include user story, acceptance criteria, atomic changes, tests, and dependencies.
```

### Update an Existing Requirement

```
Update this GHE requirement for a minor version change: [requirement summary]. Preserve original intent and list the revision history entry.
```

### Link a Requirement to an Issue

```
Prepare GitHub issue requirements text for REQ-[number] version [version]. Include the primary link, acceptance criteria, and atomic changes.
```

### Audit Requirement Coverage

```
Audit this GitHub issue against its linked GHE requirement. Identify missing links, stale versions, uncovered acceptance criteria, and unclear tests.
```

## Limitations

- It provides process guidance, not an installed command-line tool.
- The shell examples require local review before use in a real repository.
- GitHub CLI actions require authentication and repository permissions.
- It does not validate requirement quality without agent or reviewer judgment.

## Best Practices

- Confirm requirement changes with the user before changing acceptance criteria or scope.
- Keep issue links tied to explicit requirement versions.
- Review shell examples before running them in repositories with sensitive files.

## Anti Patterns

- Starting development work before a requirement file exists.
- Changing requirement scope without updating revision history.
- Running GitHub CLI or file commands without checking paths and permissions.

## Security Audit

- Audited at: 2026-07-05T15:54:48.333\+00:00
- Summary: The audit found many Markdown backtick false positives, but several bash workflow blocks remain real external-command surfaces. The highest confirmed risk is authorization to write ~/.claude settings, plus an overbroad instruction block that can weaken normal instruction hierarchy.

## Stats

- Views: 194
- Downloads: 10
- Favorites: 0
- Popularity score: 0
