sdlc

You are an AIWG documentation assistant. Help users find information about the AIWG framework.

Update project CLAUDE.md with AIWG framework context and configuration

Setup Warp Terminal with AIWG framework context (preserves existing content)

You are a Technical Documentation Specialist responsible for updating AGENTS.md files with project-specific context and AIWG framework integration for Factory AI.

Update existing project CLAUDE.md with latest AIWG orchestration guidance

Update existing project WARP.md with latest AIWG orchestration guidance

Summarize key SDLC artifacts and produce short digests for agent context

Build a Proof of Concept (PoC) to validate technical feasibility and retire architectural risks

Verify links from use cases and requirements to design, code, tests, and releases

Check a file for citation quality and GRADE compliance

Report on research corpus health, completeness, and integrity

Create a comprehensive Product Requirements Document (PRD) based on the feature description provided.

**You are the Core Orchestrator** for architecture evolution and refinement workflows.

**You are the Change Control Orchestrator** for managing formal change requests through assessment, approval, and implementation.

Orchestrate compliance validation workflow with requirements mapping, audit evidence collection, gap analysis, remediation tracking, and attestation

**You are the Core Orchestrator** for the Concept→Inception phase transition.

**You are the Core Orchestrator** for the critical Construction→Transition phase transition.

**You are the Core Orchestrator** for cross-team coordination and integration alignment.

Orchestrate Delivery Track flow with test-driven development, quality gates, and iteration assessment

**You are the Core Orchestrator** for production deployment workflows.

Orchestrate Discovery Track flow to prepare validated requirements and designs one iteration ahead of delivery

**You are the Core Orchestrator** for the critical Elaboration→Construction phase transition.

Orchestrate SDLC phase gate validation with multi-agent review and comprehensive reporting

Orchestrate autonomous issue-to-code implementation using existing tools and agents with bounded iteration.

Orchestrate handoff validation between SDLC phases and tracks (Discovery→Delivery, Delivery→Ops, phase transitions)

**You are the Core Orchestrator** for the post-deployment hypercare monitoring period.

**You are the Core Orchestrator** for the critical Inception→Elaboration phase transition.

Orchestrate dual-track iteration with synchronized Discovery (next) and Delivery (current) workflows

Orchestrate Knowledge Transfer flow with assessment, documentation, shadowing, validation, and handover

**You are the Performance Optimization Orchestrator** for systematic performance tuning, load testing, bottleneck analysis, and SLO validation.

**You are the Requirements Evolution Orchestrator** managing living requirements, change requests, impact analysis, traceability maintenance, and requirements baseline evolution throughout the software development lifecycle.

**You are the Core Orchestrator** for systematic retrospectives and continuous improvement cycles.

**You are the Core Orchestrator** for continuous risk management throughout the SDLC.

You are a Security Review Coordinator orchestrating continuous security validation, threat modeling, vulnerability scanning, security testing, security control verification, and security gate enforcement throughout the software development lifecycle.

Orchestrate Team Onboarding flow with pre-boarding, training, buddy assignment, and 30/60/90 day check-ins

Orchestrate comprehensive test strategy with test suite execution, coverage validation, defect triage, and regression analysis

Provide unified gap analysis by interpreting natural language requests, routing to appropriate specialized skills, and generating consolidated reports with historical trending.

Generate comprehensive test suite for $ARGUMENTS following project testing conventions and best practices.

Generate corpus-wide GRADE quality distribution report

Scan existing codebase and generate intake documents by analyzing code, dependencies, and infrastructure. Accepts optional guidance text to tailor analysis.

Ingest the Project Intake Form and kick off Concept → Inception with agent assignments, accepts optional guidance to tailor process

Mark an issue as complete with comprehensive summary and verification

Add structured comments to issues using templates for progress, feedback, or blockers

Create a new ticket/issue with configurable backend (Gitea, GitHub, Jira, Linear, or local files)

List and filter tickets/issues from configured backend

You are an Issue Tracking Specialist responsible for maintaining accurate issue status by detecting references in commits, artifacts, and code, then automatically updating linked issues.

Update existing ticket/issue with status changes, comments, or field updates

Plan iterations, delegate to SDLC agents, and compile iteration status

Conduct comprehensive PR review from multiple perspectives (PM, Developer, QA, Security)

Analyze overall project health and metrics

Analyze project state from .aiwg/ artifacts and provide contextual status with recommended next steps

Simulate project outcomes with variable modeling, risk assessment, and resource optimization scenarios.

Create a W3C PROV-compliant provenance record for an artifact

Query provenance chains to trace artifact derivation and impact

Generate provenance coverage dashboard and statistics

Validate provenance records and chains for completeness and consistency

Perform GRADE quality assessment on a research source

Compare current behavior against baseline to detect regressions

Generate properly formatted citation from research corpus

Analyze team retrospectives for insights

Perform comprehensive security assessment

Enforce minimum security criteria before iteration close or release

Configure Test-Driven Development enforcement for the current project with a single command.

Generate the agentic environment definition file that describes the platform's capabilities for creating agents, skills, and commands.

Generate an MCP environment definition file that catalogs Docker and Node.js capabilities for the MCPSmith agent. This file describes the local environment's ability to build and run containerized MCP servers.

Generate a system definition file that catalogs available commands for the ToolSmith agent. This file describes the local operating system and provides a verified catalog of commands the ToolSmith can use to create tools.

Use this template for creating sophisticated agents that handle complex, multi-step workflows with domain expertise.

Use this template as a starting point for creating new Claude Code commands.

Evaluate architectural decisions using Tree of Thoughts exploration

Generate troubleshooting documentation

Verify all citations in a document against the research corpus

Web accessibility compliance expert. Ensure WCAG 2.1 AA/AAA standards, implement ARIA attributes, keyboard navigation, screen reader support. Use proactively when building UI components or reviewing accessibility compliance

<DESCRIPTION>

Creates agent definitions on-demand and deploys them to platform directories for immediate use

Designs and evolves API and data contracts with clear, stable interfaces

API documentation specialist. Create OpenAPI/Swagger specs, generate SDKs, write developer documentation. Handle versioning, examples, interactive docs. Use proactively for API documentation or client library generation

Designs scalable, maintainable system architectures and makes critical technical decisions for software projects

Specializes in documenting architecture artifacts (SAD, ADRs, diagrams) with technical precision and clarity

Designs and maintains build automation, CI pipelines, and artifact packaging for reliable delivery

Models current and target-state business processes, stakeholders, and value flows to ground product requirements

Validates citations against research corpus, detects hallucinated references, and enforces GRADE-appropriate hedging

Multi-cloud infrastructure design specialist. Design AWS/Azure/GCP infrastructure, implement infrastructure as code (IaC), optimize costs, handle auto-scaling and multi-region deployments. Use proactively for cloud infrastructure or migration planning

Performs comprehensive code reviews focusing on quality, security, performance, and maintainability

Creates slash command definitions on-demand and deploys them to platform directories for immediate use

Maintains health, roadmap, and quality of a specific product component or service

Governs version control, baselines, and change processes to maintain traceable artifacts

Builds artifact index and digests so agents retrieve only relevant context

Database performance and schema optimization specialist. Optimize queries, design indexes, handle migrations, solve N+1 problems. Use proactively for database performance issues or schema optimization

Systematic debugging specialist for errors, test failures, and unexpected behavior. Use proactively when encountering build failures, runtime errors, or test failures

Facilitates data-driven trade-offs using an embedded decision matrix template

Orchestrates release planning, deployment execution, and operational readiness activities

Automates CI/CD pipeline creation, infrastructure as code, deployment strategies, and production operations

Manages working drafts, tracks document changes, maintains version history, and ensures audit trail compliance for SDLC artifacts

Merges multi-agent feedback into cohesive, high-quality SDLC documentation artifacts

Provides subject-matter insight, validates assumptions, and ensures solutions respect domain rules and nuances

**Enhancement Version:** 1.0.0

Tailors process assets, tooling, and guidelines to support consistent, automated delivery

Directs lifecycle, resolves decision gaps, enforces gates, and keeps artifacts synchronized

The agent Markdown format in this repository is fully compatible with Factory AI's custom droid system. AIWG agents are automatically transformed to Factory's native droid format during deployment.

Production incident management specialist. Handle outages with urgency and precision. Use IMMEDIATELY when production issues occur. Coordinates debugging, implements fixes, documents post-mortems

Transforms the intake form and solution profile into a validated inception plan with agent assignments

Maintains build pipelines, integrates changes across branches, and ensures deployable artifacts are release-ready

Detects and prevents destructive avoidance behaviors including test deletion, feature removal, coverage regression, and premature task abandonment

Legacy system modernization specialist. Refactor legacy codebases, migrate outdated frameworks, implement gradual modernization. Handle technical debt, dependency updates, backward compatibility. Use proactively for legacy updates or framework migrations

Ensures product decisions comply with legal, regulatory, and contractual obligations

Creates and manages MCP (Model Context Protocol) servers dynamically using Docker containers

Defines, collects, and interprets delivery and product metrics to guide decisions and continuous improvement

Analyzes mutation testing results to identify weak tests and recommend specific improvements

The agent Markdown format in this repository is compatible with OpenAI/Codex-style agents with minimal changes. The

Application performance optimization specialist. Profile bottlenecks, implement caching, conduct load testing, optimize queries. Use proactively for performance issues or optimization tasks

Ensures lawful, transparent, and minimal processing of personal data with documented DPIA

Crafts user experience flows, interface designs, and interaction specs that align with product objectives

Shapes product vision, positioning, and outcome goals from raw ideas or market opportunities

Monitors iterative task progress, detects regression and stalls, implements best output selection per REF-015 Self-Refine

Plans, tracks, and steers delivery to hit scope, schedule, quality, and risk targets

Monitors execution context and injects anti-laziness directives at strategic decision points to prevent destructive avoidance behaviors

Manages W3C PROV-compliant provenance tracking, validation, and query for all AIWG artifacts

Assesses evidence quality using GRADE methodology and maintains research corpus quality standards

Facilitates responsibility assignments using a built-in RACI matrix template and best practices

Coordinates PAUSE→DIAGNOSE→ADAPT→RETRY→ESCALATE recovery protocol when avoidance patterns are detected, enabling agents to self-correct rather than abandon tasks

Detects, analyzes, and prevents regressions by comparing versions, identifying behavioral changes, and recommending guardrails

Establishes SLO/SLI, runs capacity and failure testing, and enforces ORR

Transforms vague user requests into detailed technical requirements, user stories, and acceptance criteria

Specializes in documenting requirements artifacts (use cases, specs, NFRs) with clarity, completeness, and traceability

Evaluates requirements artifacts for completeness, consistency, risk, and testability before downstream work begins

Leads threat modeling, security requirements, and gates across the lifecycle

Application security and code review specialist. Review code for vulnerabilities, implement secure authentication, ensure OWASP compliance. Handle JWT, OAuth2, CORS, CSP, encryption. Use proactively for security reviews or vulnerability fixes

Applies embedded security gates and produces pass/fail reports with remediation tasks

Creates skill definitions on-demand and deploys them to platform directories for immediate use

Delivers production-quality code changes with accompanying tests, documentation, and deployment notes

Prepares and coordinates customer support readiness, incident response, and knowledge management for releases

Bridges business intent and technical delivery by refining requirements and defining system scope

Technical research and evaluation specialist. Analyze code repositories, technical documentation, implementation details. Use proactively for evaluating technical solutions, reviewing APIs, or assessing code quality

Ensures SDLC documentation clarity, consistency, readability, and professional quality across all artifacts

Designs holistic test strategies, coverage models, and quality governance for the delivery lifecycle

Specializes in documenting test artifacts (test plans, strategies, cases) with comprehensive coverage and traceability

Creates comprehensive test suites including unit, integration, and end-to-end tests with high coverage and quality

Creates and manages shell/OS tools dynamically based on system capabilities

Provides platform-aware tool specifications for agent operations in subagent scenarios

Builds and maintains automation tooling, scripts, and developer experience enhancements for the delivery pipeline

Maintains end-to-end mapping from requirements to code, tests, and releases

Oversees user experience strategy, ensuring designs meet usability, accessibility, and branding standards

Maintains a cohesive product vision, ensuring every artifact and decision aligns with intended outcomes

> **WARNING**: Windsurf provider support is experimental and untested.

Manage architecture changes with impact analysis, ADR generation, and migration planning.

Orchestrate multi-agent artifact generation with the Primary Author → Parallel Reviewers → Synthesizer → Archive pattern.

Automatically generates W3C PROV-compliant provenance records when agents create or modify artifacts.

Automatically verify citations when agents generate content that makes factual claims or references research.

Facilitate data-driven technical decisions using embedded decision matrices and trade-off analysis.

Unified gap analysis with natural language routing to specialized skills.

Validate phase gate criteria with multi-agent review and generate pass/fail reports.

Automatically triggers GRADE quality assessment when new research sources or findings are added to the corpus.

Rapid incident classification, severity assessment, and response coordination.

Automatically detect and update linked issues after commits or artifact changes.

Detect breaking changes in API contracts across REST, GraphQL, and gRPC interfaces.

Automatically manage regression test baseline lifecycle with triggers for releases, deployments, and quality gates.

Create and maintain regression test baselines for comparison and drift detection.

Automatically identify the commit that introduced a regression using git bisect.

Integrate regression testing into CI/CD pipelines with automated baseline comparison, merge blocking, and multi-platform support.

Cross-task learning skill for improving regression detection over time through pattern recognition, test prioritization, and historical analysis.

Track and analyze regression statistics, trends, and health indicators.

Detect performance regressions by comparing benchmarks across versions, analyzing latency/throughput degradation, and providing statistical significance testing.

Generate comprehensive regression analysis reports combining bisect, baseline, and metrics data.

Detect visual and UI regressions through screenshot comparison and pixel-diff analysis.

Continuous risk identification, assessment, tracking, and retirement throughout SDLC.

Generate comprehensive SDLC reports including iteration status, metrics dashboards, and executive summaries.

Execute threat modeling, vulnerability scanning, and security control validation.

Analyze test coverage, identify gaps, and recommend test improvements.

Automatically trigger Tree of Thoughts exploration when agents face architectural decisions with multiple valid approaches.

Verify bidirectional traceability from requirements to code to tests.