Development Workflow

id: "1.1"
title: "Story Title"
description: "What needs to be done and why"
status: "ready" | "in progress" | "Ready for Review" | "completed"

acceptance_criteria:
  - name: "Feature works correctly"
    tasks:
      - "[ ] Implement core functionality"
      - "[ ] Add error handling"
      - "[ ] Write unit tests"

dev_agent_record:
  agent_model: 'claude-sonnet-4-5'
  implementation_date: '2025-01-23'

# Activate Scrum Master
@sm

# Create a new story
*draft

# Activate Product Owner
@po

# Validate the story
*validate-story-draft

# Activate Developer
@dev

# Start implementation
*develop

# Activate QA
@qa

# Review the implementation
*review STORY-ID

# Activate DevOps
@devops

# Push changes
*push

# 1. Update your local repository
git checkout master
git pull origin master

# 2. Check story status
@po
*list-stories

# 3. Pick next story
# Look for stories with status: "ready"

# 4. Start implementation
@dev
*develop

# Check story progress
cat docs/stories/X.X-story.yaml

# Update checkboxes as you complete tasks
# Change: - "[ ] Task"
# To:     - "[x] Task"

# Run quality checks frequently
npm run lint
npm run typecheck
npm test

# 1. Ensure all story tasks are checked
# 2. Update story status to "Ready for Review"
# 3. Run full quality gate
@qa
*review STORY-ID

# 4. If QA passes, commit
git add .
git commit -m "feat: implement feature [Story X.X]"

# 5. Push (triggers pre-push hook)
git push origin feature/my-feature

# 1. Update story status if incomplete
# Keep as "in progress" if work continues tomorrow

# 2. Commit work in progress (optional)
git add .
git commit -m "wip: partial implementation [Story X.X]"

# 3. Document blockers or questions in story
# Add notes section with any issues

# List available tasks
aiox tasks list

# Execute a specific task
*task develop-story --story=1.1

# Get task help
*task --help

# Run with verbose output
*task develop-story --story=1.1 --verbose

User Request → Task → Agent Execution → Output
                 │
            Workflow (if multi-step)

# Start a workflow
*run-workflow story-development-cycle start

# Check workflow status
*run-workflow story-development-cycle status

# Continue to next step
*run-workflow story-development-cycle continue

# Skip optional step
*run-workflow story-development-cycle skip

# Abort workflow
*run-workflow story-development-cycle abort

instance_id: "wf-abc123"
workflow_name: "story-development-cycle"
status: "active"
current_step: 2
total_steps: 4
steps:
  - id: create
    status: completed
  - id: validate
    status: in_progress
  - id: implement
    status: pending
  - id: review
    status: pending

1. @pm creates PRD → *create-epic
   Output: docs/prd/epic.md
   Handoff: "Epic ready for @sm to create stories"

2. @sm creates stories → *draft
   Output: docs/stories/X.X-story.yaml
   Handoff: "Story ready for @po validation"

3. @po validates → *validate-story-draft
   Output: Validation report
   Handoff: "Story approved for @dev implementation"

4. @dev implements → *develop
   Output: Code + tests
   Handoff: "Implementation ready for @qa review"

5. @qa reviews → *review
   Output: QA report
   Handoff: "Approved for @devops to push"

6. @devops pushes → *push
   Output: Commit + PR
   Handoff: "Changes pushed to remote"

# ESLint (code style)
npm run lint

# TypeScript (type checking)
npm run typecheck

# Tests with coverage
npm test

ready → in progress → Ready for Review → completed

# In docs/stories/X.X-story.yaml
# Change this:
status: "in progress"

# To this when all tasks complete:
status: "Ready for Review"

# Check story format
node .aiox-core/utils/aiox-validator.js story docs/stories/X.X-story.yaml

# Common issues:
# - Missing required sections
# - Status doesn't match checkbox completion
# - Invalid YAML syntax

# Run individual checks
npm run lint
npm run typecheck
npm test

# Auto-fix lint issues
npm run lint -- --fix

# See detailed test output
npm test -- --verbose