ar-taskflow

Guides structured development from raw prompt through planning, coding, and PR creation.

1|2|Updated Jul 11, 2026
One-click install
npx skills add https://github.com/mahsanamin/agentic-repos --skill ar-taskflow-mahsanamin
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ar-taskflow
Source: https://github.com/mahsanamin/agentic-repos/tree/main/skills/ar-taskflow
Command: npx skills add https://github.com/mahsanamin/agentic-repos --skill ar-taskflow-mahsanamin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI coding sessions often skip team conventions: they commit straight to main, skip planning, fabricate code details, and lose task documentation. This Skill enforces a consistent Raw Prompt → Understand → Plan → Code → Document workflow so every change follows the same branch, review, and PR process. ## Core Features & Use Cases - Structured five-phase workflow: Moves a task from raw prompt capture through understanding, execution planning, implementation, and archival, with documents like execution_plan.md and acceptance_criteria.json produced along the way. - Git safety enforcement: Detects attempts to commit on the default branch, blocks bare force-pushes, resolves the default branch dynamically, and auto-pushes task documentation to a separate docs repo with conflict resolution. - Configurable autonomy: Reads .claude/config_hints.json for project namespace, ticket tracker, coding standards location, and opt-in autonomous/continuous modes that gate judgement checkpoints and prompt suppression. - Use Case: A developer says "ar-taskflow" with a task folder path; the assistant reads the project config, drafts an execution plan, creates a feature branch like feature/svc-42-add-auth, implements with scoped verification, and opens a PR against the correct base branch. ## Quick Start Say "ar-taskflow" or provide a task folder path and ask the assistant to run the structured workflow for your task.

Frequently Asked Questions about ar-taskflow

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

FAQPage Schema
How do I run a structured task workflow with an AI coding assistant?▼

Invoke the workflow by saying "ar-taskflow" or providing a task folder path. The assistant reads .claude/config_hints.json, then walks through Raw Prompt, Understand, Plan, Code, and Document phases, producing execution_plan.md and opening a PR at the end.

How does the workflow prevent commits directly to main?▼

Before any commit, the skill checks the current branch with git branch --show-current. If it equals the resolved default branch, it stops and asks the user to create execution_plan.md and a feature branch first, never committing to main without explicit override.

Can I use this workflow with Jira or Linear instead of GitHub?▼

Yes. The tracker type is declared in .claude/config_hints.json under project.tracker.type, defaulting to github with the gh CLI. Setting it to jira or linear with a tracker URL routes ticket operations through the MCP integration dispatch table.

What is autonomous mode and how do I enable it?▼

Autonomous mode is an opt-in set via flow.autonomous: true in config_hints.json. It replaces human judgement checkpoints with an independent verifier subagent and implies a continuous Phase 4, while commit and push mechanics still depend on permission settings.

Why does the workflow stop with a default branch error?▼

The skill resolves the default branch from origin/HEAD, git remote show origin, a verified config value, or local refs. If all fail or both main and master exist ambiguously, it stops; fix it with git remote set-head origin -a or set .default_branch in config_hints.json.

When should I not use this structured task workflow?▼

Avoid it for trivial one-line fixes or exploratory spikes where planning documents and branch ceremony add overhead without value. It is designed for tracked, reviewable changes that follow a team's ticket, branch, and PR conventions.