---

name: feature-lifecycle description: | A suite of skills to manage the full development lifecycle from start to finish.

• start-feature: Initializes a new feature branch, docs, and story.
• sync-feature: Saves work with CI checks.
• finish-feature: Verifies and creates a pull request. tags: [workflow, git, feature, beads, dx]

---

Feature Lifecycle Skills

This file defines the three core skills for agent-driven development.

---

start-feature <issue-id>

Purpose: Initializes a new feature branch with all required scaffolding. Forces a "Test-First" mindset by creating the story skeleton.

Usage:

Copy# From any product repo (affordabot, prime-radiant-ai)
feature-lifecycle/start.sh bd-123

BDD Spec:

• Given I am in a product repo
• And I provide a Beads issue ID bd-123
• When I run start-feature bd-123
• Then a new branch feature-bd-123 is created
• And a doc file docs/bd-123.md is created
• And a story file docs/testing/stories/story-bd-123.yml is created

---

sync-feature [options] <message>

Purpose: The "Save Button" for agents. Ensures all commits are clean by running ci-lite before saving. Prevents pushing broken code.

Usage:

Copy# From a feature branch, commit valid work
feature-lifecycle/sync.sh "feat: add new login button"

# Force save broken work (e.g., to switch branches)
feature-lifecycle/sync.sh --wip "refactor: halfway through API change"

BDD Spec:

• Given I have syntax errors in my code
• When I run sync-feature 'my commit'
• Then the commit is BLOCKED and I receive an error to fix.
• But when I run sync-feature --wip 'my commit'
• Then the commit is created with a [WIP] prefix.

---

finish-feature

Purpose: The "Handoff" to the QA/Merge phase. Runs the full PR verification suite before a PR is created, preventing review spam with broken code.

Usage:

Copy# When a feature is complete and ready for review
feature-lifecycle/finish.sh

BDD Spec:

• Given I am on a feature branch
• And the make verify-pr target fails
• When I run finish-feature
• Then the PR creation is BLOCKED and I am instructed to check the verification artifacts.