# Manage Spec-Driven Development Workflows

Feature work often loses track of requirements, plans, tasks, and review gates. This skill keeps those artifacts aligned through a structured workflow and local validation scripts.

## Install

```bash
npx skillstore add brendanshields/managing-workflow
```

## Metadata

- - Slug: brendanshields-managing-workflow
- - Version: 1.0.0
- - Author: BrendanShields
- - GitHub username: BrendanShields
- - License: MIT
- - Repository: https://github.com/BrendanShields/spec-flow/tree/main/plugins/spec/skills/managing-workflow
- - Ref: main
- - Supported tools: Claude, Claude Code
- - Risk level: medium
- - Risk factors: scripts, filesystem, env\_access, external\_commands
- - Quality score: 69
- - Public page: https://skillstore.pages.dev/skills/brendanshields-managing-workflow
- - Manifest: https://skillstore.pages.dev/api/skills/brendanshields-managing-workflow/manifest

## Capabilities

- Loads current workflow context from .spec project artifacts.
- Detects feature phase from spec.md frontmatter and related files.
- Guides creation of spec.md, plan.md, tasks.md, and metrics.md.
- Validates phase transitions before planning, implementation, or completion.
- Updates status, timestamps, activity logs, and task progress.
- Archives completed features into .spec/archive when approved.

## Use Cases

- Plan a New Feature: Create a structured specification, review unclear requirements, and move into planning only after phase checks pass.
- Control Implementation Readiness: Confirm that specifications, plans, and task lists exist before implementation starts.
- Track and Archive Completed Work: Update task progress, log activity, mark completion, and archive finished feature artifacts.

## Prompt Templates

### Start a Feature

```
Use managing-workflow to define a new feature for adding user profile avatars. Ask me for any missing scope details.
```

### Create a Plan

```
Use managing-workflow to review the current spec, resolve any clarification tags, and create a technical plan.
```

### Prepare Implementation Tasks

```
Use managing-workflow to validate the current feature phase and create implementation tasks with priorities and dependencies.
```

### Validate and Archive

```
Use managing-workflow to verify all tasks are complete, update workflow status, log the final activity, and archive the feature after approval.
```

## Limitations

- Requires filesystem and Bash access to run its local helper scripts.
- Assumes projects use the .spec directory and expected artifact names.
- Does not connect to issue trackers, pull requests, or CI systems.
- Imported shared utility behavior is not fully visible in this skill package.

## Best Practices

- Review each generated artifact before approving the next phase.
- Keep feature identifiers simple and limited to the expected .spec feature names.
- Run validation before implementation and completion transitions.

## Anti Patterns

- Do not skip directly from a rough idea to implementation.
- Do not pass arbitrary filesystem paths into the helper scripts.
- Do not mark a feature complete while tasks remain unchecked.

## Security Audit

- - Safe to publish: true
- - Audited at: 2026-06-28T17:15:54.744\+00:00
- - Summary: The static report overstates risk because many high alerts are false positives from Markdown examples, relative imports, and template placeholders. The real risk is moderate: the skill intentionally runs local Node scripts and those scripts can read, write, or move files based on command arguments without strict path validation.

## Stats

- - Views: 183
- - Downloads: 1
- - Favorites: 0
- - Popularity score: 0