feature-dev-workflow

# Feature Development Workflow

Structured development workflow skill for any AI coding tool that supports the [Agent Skills open format](https://agentskills.io/home) — guides the full cycle from planning through verified commit with expert review.

This skill ensures every code change goes through planning, validation, implementation, and verification before being committed. Prevents wasted effort by getting alignment early and catching issues before they reach the codebase.

## Who this is for
- Teams using AI coding agents who want consistent, disciplined feature development
- Developers who want a structured plan-validate-implement-verify cycle for every change
- Anyone who has been burned by skipping planning or committing broken code

## How to Use This Skill

### Option A: Using skills.sh (recommended)

Install this skill with a single command:

```bash
bunx skills add https://github.com/moifort/feature-dev-workflow --skill feature-dev-workflow
```

For more information, [visit the skills.sh platform page](https://skills.sh/moifort/feature-dev-workflow/feature-dev-workflow).

Then use the skill in your AI agent, for example:

> Use the feature dev workflow skill to implement this new feature following the full plan-validate-implement-verify cycle

### Option B: Claude Code Plugin

#### Personal Usage

To install this Skill for your personal use in Claude Code:

1. Add the marketplace:

```bash
/plugin marketplace add moifort/feature-dev-workflow
```

2. Install the Skill:

```bash
/plugin install feature-dev-workflow@feature-dev-workflow
```

#### Project Configuration

To automatically provide this Skill to everyone working in a repository, configure the repository's `.claude/settings.json`:

```json
{
  "enabledPlugins": {
    "feature-dev-workflow@feature-dev-workflow": true
  },
  "extraKnownMarketplaces": {
    "feature-dev-workflow": {
      "source": {
        "source": "github",
        "repo": "moifort/feature-dev-workflow"
      }
    }
  }
}
```

When team members open the project, Claude Code will prompt them to install the Skill.

### Option C: Manual install

1. **Clone** this repository.
2. **Install or symlink** the `skills/feature-dev-workflow/` folder following your tool's official skills installation docs (see links below).
3. **Use your AI tool** as usual and ask it to use the "feature-dev-workflow" skill for development tasks.

#### Where to Save Skills

Follow your tool's official documentation, here are a few popular ones:
- **Codex:** [Where to save skills](https://developers.openai.com/codex/skills/#where-to-save-skills)
- **Claude:** [Using Skills](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview#using-skills)
- **Cursor:** [Enabling Skills](https://cursor.com/docs/context/skills#enabling-skills)

## The 4-Phase Cycle

### Phase 1 - Plan
Before writing any code, understand the problem and design the solution. Discover relevant skills, clarify scope, enter plan mode, and track work with tasks.

### Phase 2 - Validate
Present the plan for review and integrate feedback. Never start implementation without explicit approval.

### Phase 3 - Implement
Follow the validated plan step by step. Stay focused, invoke stack-specific skills, and group related changes together.

### Phase 4 - Verify & Commit
Every change must be verified before commit: expert code review, build verification, and conventional commit messages.

## What This Skill Covers

- Structured plan-validate-implement-verify development cycle
- Skill discovery and composition (invoke relevant stack-specific skills)
- Code review via expert review agents
- Build verification before any commit
- Conventional commit format (`feat`, `fix`, `chore`, `refactor`, `docs`, `test`)
- Red flags and common mistakes to avoid
- Scope creep prevention

## Skill Structure

```text
skills/
  feature-dev-workflow/
    SKILL.md — Full workflow reference (4 phases, commit conventions, red flags, common mistakes)
```

## License

This skill is open-source and available under the MIT License.