dev-agent

Automates design-first feature development with stacked branches, TDD, and bounded review loops.

49|11|Updated Jul 31, 2026
One-click install
npx skills add https://github.com/vstorm-co/agenticos --skill dev-agent-vstorm-co
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: dev-agent
Source: https://github.com/vstorm-co/agenticos/tree/main/.claude/skills/dev-agent
Command: npx skills add https://github.com/vstorm-co/agenticos --skill dev-agent-vstorm-co

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It removes the chaos of ad-hoc AI coding by enforcing a disciplined workflow: design and implementation plans are reviewed and merged via PR before any code is written, then tests and implementation are built locally with automated review rounds. ## Core Features & Use Cases - Design-first gating: Opens a draft development PR and a stacked design PR, and refuses to write code until the human confirms the design PR is merged. - Repo-portable conventions: Detects the project's default branch, branch naming, test runner, CI command, and commit style instead of assuming them. - TDD with bounded review loops: Writes failing tests first, then implements, running automated review-fix cycles with configurable iteration limits and resumable checkpoints. - Use Case: You describe a new feature in one sentence; the agent produces a reviewed design PR, then locally builds tests and implementation with review rounds, leaving the final push to you. ## Quick Start Run /dev-agent followed by your requirements text to start a gated design-first development workflow in the current repository.

Frequently Asked Questions about dev-agent

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

FAQPage Schema
How do I run an AI agent that writes code only after design approval?▼

Invoke /dev-agent with your requirements text. It opens a draft development PR and a stacked design PR containing design.md and implementation-plan.md, then pauses until you confirm the design PR is merged before writing any tests or code.

How to resume an interrupted dev-agent workflow?▼

Run /dev-agent --resume. The skill reads .dev-agent/state.json, warns if requirements changed since the last checkpoint, asks whether to resume or restart, checks out the expected branch, and jumps to the recorded phase.

Does dev-agent work with repos that use npm, Go, or pytest?▼

Yes. Before starting, it detects the repo's actual test runner, source and test layout, branch naming, commit convention, and aggregate CI command from package.json, pyproject.toml, Makefiles, or contributor docs, rather than assuming one stack.

Why does dev-agent never push the development branch after the design merge?▼

By design, all test and implementation commits stay local so the human retains control over what ships. The draft PR remains untouched until the user pushes the branch and marks it ready for review themselves.

What are the limitations of the automated review loop?▼

The loop is bounded by configurable iteration limits (default 3 per phase) and may leave unresolved issues, which are recorded in unsolved.json and flagged for manual review. It also requires a code-review tool or falls back to self-review.