Orchestrate multi-agent artifact generation with the Primary Author → Parallel Reviewers → Synthesizer → Archive pattern.
Orchestrates a multi-agent workflow to generate high-quality artifacts through primary authoring, parallel expert reviews, and synthesis. Triggers on commands like "generate SAD" or "create deployment plan" to produce documents via the Primary Author → Parallel Reviewers → Synthesizer → Archive pattern.
/plugin marketplace add jmagly/ai-writing-guide/plugin install sdlc@aiwgThis skill inherits all available tools. When active, it can use any tool Claude has access to.
Orchestrate multi-agent artifact generation with the Primary Author → Parallel Reviewers → Synthesizer → Archive pattern.
This skill implements the core AIWG multi-agent documentation pattern that ensures high-quality artifacts through:
When triggered, this skill orchestrates:
Artifact identification:
Workspace setup:
.aiwg/working/{type}/{name}/artifact-metadata skilltemplate-engine skillPrimary author dispatch:
Parallel review dispatch:
parallel-dispatch skillSynthesis:
Archive:
.aiwg/{category}/artifact: software-architecture-document
template: analysis-design/software-architecture-doc-template
primary_author: architecture-designer
reviewers:
- security-architect
- test-architect
- requirements-analyst
- technical-writer
output: .aiwg/architecture/sad.md
artifact: test-plan
template: test/test-plan-template
primary_author: test-architect
reviewers:
- security-auditor
- requirements-analyst
- devops-engineer
output: .aiwg/testing/test-plan.md
artifact: deployment-plan
template: deployment/deployment-plan-template
primary_author: deployment-manager
reviewers:
- devops-engineer
- security-architect
- reliability-engineer
- support-lead
output: .aiwg/deployment/deployment-plan.md
artifact: software-requirements-spec
template: requirements/srs-template
primary_author: requirements-analyst
reviewers:
- domain-expert
- system-analyst
- test-architect
- architecture-designer
output: .aiwg/requirements/srs.md
artifact: threat-model
template: security/threat-model-template
primary_author: security-architect
reviewers:
- privacy-officer
- architecture-designer
- devops-engineer
output: .aiwg/security/threat-model.md
┌─────────────────────────────────────────────────────────┐
│ 1. SETUP │
│ • Create workspace: .aiwg/working/{type}/{name}/ │
│ • Initialize metadata.json │
│ • Load template │
└─────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────┐
│ 2. PRIMARY AUTHOR │
│ • Dispatch: architecture-designer (for SAD) │
│ • Input: template, requirements, context │
│ • Output: drafts/v0.1-primary.md │
└─────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────┐
│ 3. PARALLEL REVIEW (single message, multiple agents) │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ security- │ │ test- │ │ requirements-│ │
│ │ architect │ │ architect │ │ analyst │ │
│ └──────┬───────┘ └──────┬───────┘ └──────┬───────┘ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ reviews/security.md reviews/test.md reviews/req.md│
└─────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────┐
│ 4. SYNTHESIS │
│ • Dispatch: documentation-synthesizer │
│ • Input: draft + all reviews │
│ • Output: synthesis/final.md │
│ • Conflicts: document with rationale │
└─────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────┐
│ 5. ARCHIVE │
│ • Move to: .aiwg/{category}/{artifact}.md │
│ • Update metadata: status=baselined, version=1.0.0 │
│ • Archive workspace to: .aiwg/archive/{date}/ │
└─────────────────────────────────────────────────────────┘
User: "Create the Software Architecture Document"
Skill orchestrates:
1. Setup workspace for SAD
2. Dispatch architecture-designer with SAD template
3. Launch parallel reviews (security, test, requirements, writer)
4. Synthesize feedback
5. Archive to .aiwg/architecture/sad.md
Output:
"SAD generation complete.
Version: 1.0.0
Status: Baselined
Location: .aiwg/architecture/sad.md
Reviews:
✓ Security Architect: Approved with suggestions
✓ Test Architect: Approved
✓ Requirements Analyst: Approved
✓ Technical Writer: Approved (minor edits)
Conflicts resolved: 2
- Auth approach: Chose JWT per security recommendation
- Caching strategy: Balanced performance vs complexity"
User: "Generate deployment plan for production release"
Skill uses project-awareness context:
- Phase: Construction
- Environment: AWS
- Compliance: SOC2
Tailors template and reviewer focus accordingly.
Add custom artifact configurations in .aiwg/config/artifacts.yaml:
artifacts:
custom-api-doc:
template: custom/api-documentation
primary_author: api-documenter
reviewers:
- security-auditor
- api-designer
- technical-writer
output: .aiwg/architecture/api-docs/
review_config:
depth: standard # minimal, standard, comprehensive
timeout: 300 # seconds per reviewer
require_unanimous: false # or true for critical artifacts
This skill uses:
parallel-dispatch: For launching reviewer agentsartifact-metadata: For tracking artifact lifecycletemplate-engine: For loading and instantiating templatesproject-awareness: For context about current phase and stateIf a reviewer times out:
When reviewers disagree:
If template not found:
| Artifact | Output Path |
|---|---|
| SAD | .aiwg/architecture/sad.md |
| ADR | .aiwg/architecture/adr-{number}.md |
| Test Plan | .aiwg/testing/test-plan.md |
| Deployment Plan | .aiwg/deployment/deployment-plan.md |
| SRS | .aiwg/requirements/srs.md |
| Threat Model | .aiwg/security/threat-model.md |
This skill should be used when the user asks to "create a slash command", "add a command", "write a custom command", "define command arguments", "use command frontmatter", "organize commands", "create command with file references", "interactive command", "use AskUserQuestion in command", or needs guidance on slash command structure, YAML frontmatter fields, dynamic arguments, bash execution in commands, user interaction patterns, or command development best practices for Claude Code.
This skill should be used when the user asks to "create an agent", "add an agent", "write a subagent", "agent frontmatter", "when to use description", "agent examples", "agent tools", "agent colors", "autonomous agent", or needs guidance on agent structure, system prompts, triggering conditions, or agent development best practices for Claude Code plugins.
This skill should be used when the user asks to "create a hook", "add a PreToolUse/PostToolUse/Stop hook", "validate tool use", "implement prompt-based hooks", "use ${CLAUDE_PLUGIN_ROOT}", "set up event-driven automation", "block dangerous commands", or mentions hook events (PreToolUse, PostToolUse, Stop, SubagentStop, SessionStart, SessionEnd, UserPromptSubmit, PreCompact, Notification). Provides comprehensive guidance for creating and implementing Claude Code plugin hooks with focus on advanced prompt-based hooks API.