aiox-develop-story

Implements a development story from Ready to ready-for-review using the AIOX develop task.

3.1k|952|Updated Dec 9, 2025
One-click install
npx skills add https://github.com/SynkraAI/aios-core --skill aiox-develop-story
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aiox-develop-story
Source: https://github.com/SynkraAI/aios-core/tree/main/.grok/skills/aiox-develop-story
Command: npx skills add https://github.com/SynkraAI/aios-core --skill aiox-develop-story

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It automates the disciplined implementation of a user story in the AIOX framework, moving it from Ready to InProgress to ready-for-review while enforcing branch rules, quality gates, and strict story-editing boundaries.

Core Features & Use Cases

  • Task-driven execution: Loads and runs the develop task at .aiox-core/development/tasks/dev-develop-story.md as the single source of truth.
  • Branch and commit guardrails: Blocks commits on main/master, enforces feature branches, and forbids push, force-push, and --no-verify.
  • Quality gates: Requires lint, typecheck, and tests to pass before marking tasks complete.
  • Use Case: A developer activates the skill with a story path and interactive mode, and the agent implements the acceptance criteria, updates checkboxes and the File List, and sets the story status to ready-for-review.

Quick Start

Run the develop-story skill with the path to your story file, for example asking the agent to develop the story at docs/stories/1.2.login.md in interactive mode.

Frequently Asked Questions about aiox-develop-story

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

FAQPage Schema
How do I implement a story with the AIOX develop-story skill?

Invoke the skill with the story path as the first argument and an optional mode: yolo, interactive, or preflight (default interactive). The agent loads the develop task, implements the acceptance criteria, runs tests, and updates the story status to ready-for-review.

What modes does the develop-story workflow support?

It supports three modes passed as the second argument: yolo for autonomous execution, interactive for step-by-step collaboration, and preflight for validation before implementation. Interactive is the default when no mode is given.

Can the dev agent edit story acceptance criteria or scope?

No. The skill forbids editing the story title, description, acceptance criteria, or scope, which are owned by the PO. Allowed edits are limited to checkboxes, File List, Dev Agent Record, Change Log, and status transitions.

Why does develop-story block commits on main or master?

The branch guard enforces feature branches named feat/{story-id}-* to keep main stable and reviewable. It also forbids git push, force-push, and --no-verify; pushing is delegated to the devops agent.

What quality gates must pass before a story is ready for review?

The skill requires npm run lint, npm run typecheck, and npm test to pass before tasks are marked complete. Tasks are only checked off when gates pass, and the story status is set to ready-for-review, never Done.