dev-docs

Transforms technical plans into structured task directories for autonomous implementation workflows.

16|1|Updated May 5, 2026
One-click install
npx skills add https://github.com/AIBiz-Automatyzacje/workspace-template-mobile --skill dev-docs-aibiz-automatyzacje
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: dev-docs
Source: https://github.com/AIBiz-Automatyzacje/workspace-template-mobile/tree/main/.claude/skills/dev-docs
Command: npx skills add https://github.com/AIBiz-Automatyzacje/workspace-template-mobile --skill dev-docs-aibiz-automatyzacje

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It bridges the gap between a technical plan and autonomous execution by converting a plan document into a deterministic, machine-readable task structure (branch, phases, checkboxes) that autopilot and review workflows can parse without ambiguity. ## Core Features & Use Cases - Deterministic plan transformation: Converts a technical plan from docs/plans/ into docs/active/<name>/ with a plan map, context file, and checkbox task list, adding no new content of its own. - Strict parser contract: Enforces flat, column-zero checkboxes with literal [Unit], [E2E], and [Manual] markers so autopilot, execute, and review workflows can grep progress reliably. - Readiness gate and handoff: Verifies E2E prerequisites, operator preparation checklists, and git state before launching the dev-autopilot workflow. - Use Case: After running /dev-plan for a new feature, invoke this Skill to create the feature branch, generate the task files, commit the initialization, and hand off directly to the autopilot for implementation. ## Quick Start Run /dev-docs with the path to your latest plan in docs/plans/ to create the task structure and start the autopilot.

Frequently Asked Questions about dev-docs

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

FAQPage Schema
How do I turn a technical plan into an executable task list?▼

Run /dev-docs with the path to your plan file in docs/plans/. It creates a feature branch, generates plan, context, and task files under docs/active/<name>/, commits the initialization, and hands off to the dev-autopilot workflow.

What happens if there is no technical plan for my task?▼

The Skill stops and instructs you to run /dev-plan first. It refuses to invent phases or tasks because the execute workflow's planner needs Implementation Units from docs/plans/ to delegate work to builders.

Why must checkboxes start at column zero with no indentation?▼

The autopilot, execute, and review workflows grep for lines matching ^- [ ] to track progress. An indented checkbox is invisible to these parsers, which would silently break phase completion detection and E2E prechecks.

How are E2E test scenarios handled in the task list?▼

Each [E2E] scenario becomes one flat checkbox line containing the Maestro flow path and optional seed file. These are excluded from execute completion counting and are only checked off after a real Maestro run passes during review.

Can I rerun dev-docs on a task that already exists in docs/active?▼

Yes, it detects the existing folder as a resumption, shows the current autopilot state and completed phases, and asks whether to regenerate only missing files. It never overwrites a task file that contains progress.

What does the readiness gate check before starting the autopilot?▼

It verifies three things: whether E2E scenarios exist and .env.e2e is configured, whether blocking operator preparation items are unchecked, and whether the git tree is clean on the feature branch. Red items must be resolved and committed first.