archflow-feature

Adds stories to the Archflow backlog or active release and sets up feature branches.

28|4|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/AZidan/archflow --skill archflow-feature-azidan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: archflow-feature
Source: https://github.com/AZidan/archflow/tree/main/adapters/copilot/.github/skills/archflow-feature
Command: npx skills add https://github.com/AZidan/archflow --skill archflow-feature-azidan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams using the Archflow phase-based development framework need a structured way to capture new features, place them in the right epic and release, and start git work without losing traceability between roadmap files and branches. ## Core Features & Use Cases - Feature capture wizard: Add a story by name, free-text description, or by importing an epic/story link from Jira, Linear, Notion, or GitHub via MCP. - Backlog vs. release routing: Append a lightweight stub to backlog.yaml or a fully detailed story with gates, acceptance criteria, and subtasks to the active release file. - Pull-forward workflow: Promote an existing backlog story into the active release, grooming it first when needed. - Git workflow setup: Create the feature branch from main, update current-phase.yaml and current-feature.yaml, and mark the story in_progress. - Use Case: A developer runs /archflow-feature "users can reset their password via email" and gets a new story under the right epic, placed in the active release, with a feature branch ready for Phase 3 implementation. ## Quick Start Ask your agent to run /archflow-feature followed by a feature name or description, for example "/archflow-feature user notifications", to add the story and optionally start its feature branch.

Frequently Asked Questions about archflow-feature

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a feature to the Archflow roadmap?

Run /archflow-feature with an optional name or description, or no argument for the interactive wizard. The skill asks for name, description, acceptance criteria, and priority, then writes the story to backlog.yaml or the active release file.

How do I import a Jira or Linear ticket into Archflow?

Choose the "Paste a link" option in /archflow-feature and provide the epic or story URL. The skill detects the tool, checks MCP configuration, fetches the item with its sub-tasks, and lets you confirm before adding it to the roadmap.

What is the difference between a backlog stub and a release story in Archflow?

A backlog stub in backlog.yaml is a lightweight entry with id, title, priority, and status, captured for later scheduling. A release story in releases/{active_release}.yaml is fully detailed with gates, acceptance criteria, subtasks, and an assigned agent, ready to build.

Can I pull a backlog story into the active release?

Yes. Pass the story id (e.g., S2-11) to /archflow-feature or pick it from the backlog list. Ungroomed stubs are groomed first, then moved into the release file with status spec_ready and a pulled_from: backlog annotation.

Does /archflow-feature merge branches automatically?

No. The skill creates feature and task branches and commits work, but every merge requires explicit user approval. It never auto-merges task branches into feature branches or feature branches into main.

What prerequisites does /archflow-feature require?

The project must have .archflow/current-phase.yaml and .archflow/roadmap.yaml, created by running /archflow-onboard or completing Phase 1. Link-based imports additionally require the relevant tool's MCP server to be configured.