nickcrew/workflow-feature

Feature Development Workflow

Complete workflow for developing new features from design to deployment.

Phases

1. Architecture Design

Define:

• Component structure
• Data models
• API contracts
• Integration points
• Dependencies

Output: Architecture diagram, component list, API specs

Agent: architect-review for complex features

2. Implementation Planning

Break down into:

• Discrete tasks (< 2 hours each)
• Dependencies between tasks
• Parallel workstreams

Output: Task list with estimates

3. Implementation

Guidelines:

• Write tests alongside code (TDD optional but helpful)
• Commit frequently (atomic commits)
• Follow existing patterns in codebase
• Document as you go

Run parallel workstreams:

• Core implementation
• Tests
• Documentation

4. Code Review

Checklist:

• [ ] Code follows project conventions
• [ ] No obvious bugs or edge cases missed
• [ ] Performance acceptable
• [ ] Error handling complete
• [ ] Tests meaningful (not just coverage)

Agent: code-reviewer

5. Security Review

Check:

• Input validation
• Auth/authz on new endpoints
• Sensitive data handling
• No secrets in code

Agent: security-auditor (if auth-related)

6. Testing

Required:

• Unit tests (80%+ coverage on new code)
• Integration tests for API endpoints
• E2E tests for critical paths

Agent: test-automator or debugger

7. Performance Check

Verify:

• Response times acceptable
• No memory leaks
• Bundle size impact (frontend)

Agent: performance-engineer (if perf-sensitive)

8. Documentation

Update:

• API docs (OpenAPI/Swagger)
• User guide (if user-facing)
• Changelog entry
• README if needed

9. Deployment Prep

Checklist:

• [ ] Version bumped
• [ ] Changelog updated
• [ ] Migration scripts (if DB changes)
• [ ] Rollback plan documented
• [ ] Feature flags (if gradual rollout)

Success Criteria

• [ ] All tests pass
• [ ] Security review clean
• [ ] Performance within limits
• [ ] Documentation complete
• [ ] Code reviewed and approved

Review Gate

# Run before marking complete
cortex review -c feature

Quick Start Template

## Feature: [Name]

### Requirements
- [ ] Requirement 1
- [ ] Requirement 2

### Tasks
- [ ] Task 1
- [ ] Task 2
- [ ] Tests
- [ ] Docs

### API Changes
- `POST /api/v1/resource` - Create resource
- `GET /api/v1/resource/:id` - Get resource

### Rollback Plan
1. Revert commit
2. Run down migration
3. Clear cache