Create and maintain product documentation including Business Requirements Documents (BRDs), Product Requirements Documents (PRDs), and feature specifications.
/plugin marketplace add marcel-Ngan/ai-dev-team/plugin install marcel-ngan-ai-dev-team@marcel-Ngan/ai-dev-teamThis skill inherits all available tools. When active, it can use any tool Claude has access to.
Create and maintain product documentation including Business Requirements Documents (BRDs), Product Requirements Documents (PRDs), and feature specifications.
| Tool | Purpose |
|---|---|
Atlassian:createConfluencePage | Create new documentation |
Atlassian:updateConfluencePage | Update existing docs |
Atlassian:getConfluencePage | Read current content |
Atlassian:searchConfluenceUsingCql | Find existing docs |
Atlassian:getPagesInConfluenceSpace | List pages in space |
{
"cloudId": "{{confluence.cloudId}}",
"spaceId": "{{confluence.spaceId}}",
"spaceKey": "{{confluence.spaceKey}}",
"parentPages": {
"product": "{{confluence.parentPages.product}}"
}
}
# BRD: {{featureName}}
**Document ID:** BRD-{{number}}
**Author:** Business Analyst Agent
**Created:** {{date}}
**Status:** Draft | In Review | Approved
**Related Epic:** {{jiraEpic}}
---
## Executive Summary
[2-3 sentence overview of the feature and its business value]
---
## Business Objectives
### Problem Statement
[What problem does this solve?]
### Business Goals
- [Goal 1]
- [Goal 2]
### Success Metrics
| Metric | Target | Measurement |
|--------|--------|-------------|
| [Metric] | [Target] | [How measured] |
---
## Stakeholders
| Role | Name | Interest |
|------|------|----------|
| Sponsor | | |
| Primary User | | |
| Secondary User | | |
---
## Requirements
### Functional Requirements
#### FR-1: [Requirement Name]
**Priority:** Must Have | Should Have | Could Have
**Description:** [Detailed description]
**Acceptance Criteria:**
- [ ] [Criterion 1]
- [ ] [Criterion 2]
#### FR-2: [Requirement Name]
...
### Non-Functional Requirements
| Category | Requirement |
|----------|-------------|
| Performance | |
| Security | |
| Accessibility | |
| Scalability | |
---
## User Stories
| Story ID | Summary | Priority | Points |
|----------|---------|----------|--------|
| [PROJ-XX] | [Summary] | Must Have | 5 |
---
## Assumptions & Constraints
### Assumptions
- [Assumption 1]
### Constraints
- [Constraint 1]
### Dependencies
- [Dependency 1]
---
## Out of Scope
- [Item explicitly excluded]
---
## Appendix
### Glossary
| Term | Definition |
|------|------------|
### References
- [Reference 1]
Atlassian:createConfluencePage({
cloudId: "{{confluence.cloudId}}",
spaceId: "{{confluence.spaceId}}",
parentId: "{{confluence.parentPages.product}}",
title: "BRD: User Authentication System",
body: `# BRD: User Authentication System
**Document ID:** BRD-001
**Author:** Business Analyst Agent
**Created:** 2025-01-06
**Status:** Draft
**Related Epic:** MDDEV-100
---
## Executive Summary
Implement a secure user authentication system enabling users to register, log in, and manage their accounts. This is foundational for personalized user experiences.
---
## Business Objectives
### Problem Statement
Users currently cannot create accounts or access personalized features.
### Business Goals
- Enable user registration and authentication
- Support personalized user experiences
- Establish security foundation
### Success Metrics
| Metric | Target | Measurement |
|--------|--------|-------------|
| Registration completion | >80% | Analytics |
| Login success rate | >95% | Monitoring |
| Auth response time | <200ms | APM |
---
## Requirements
### Functional Requirements
#### FR-1: User Registration
**Priority:** Must Have
**Description:** Users can create accounts with email and password
**Acceptance Criteria:**
- [ ] Email validation required
- [ ] Password strength requirements enforced
- [ ] Email verification sent
#### FR-2: User Login
**Priority:** Must Have
**Description:** Users can log in with credentials
**Acceptance Criteria:**
- [ ] Email/password authentication
- [ ] Session management
- [ ] Remember me option
---
## User Stories
| Story ID | Summary | Priority | Points |
|----------|---------|----------|--------|
| MDDEV-101 | User can register | Must Have | 5 |
| MDDEV-102 | User can log in | Must Have | 3 |
| MDDEV-103 | User can reset password | Must Have | 5 |
`,
contentFormat: "markdown"
})
# Feature: {{featureName}}
**Version:** 1.0
**Last Updated:** {{date}}
**Owner:** Product Owner
---
## Overview
[Brief description of the feature]
## User Value
**As a** [user type]
**I want to** [capability]
**So that** [benefit]
## Feature Details
### Capabilities
- [Capability 1]
- [Capability 2]
### User Flow
1. [Step 1]
2. [Step 2]
3. [Step 3]
### Business Rules
- [Rule 1]
- [Rule 2]
## Edge Cases
| Scenario | Expected Behavior |
|----------|-------------------|
| [Scenario] | [Behavior] |
## Related Documentation
- BRD: [Link]
- Technical Spec: [Link]
- Design Spec: [Link]
Atlassian:createConfluencePage({
cloudId: "{{confluence.cloudId}}",
spaceId: "{{confluence.spaceId}}",
parentId: "{{confluence.parentPages.product}}",
title: "Product Vision - {{project.name}}",
body: `# Product Vision
## Vision Statement
[One sentence vision]
## Target Users
| Persona | Description | Primary Need |
|---------|-------------|--------------|
| [Persona] | [Description] | [Need] |
## Key Differentiators
- [Differentiator 1]
- [Differentiator 2]
## Success Criteria
- [Criterion 1]
- [Criterion 2]
## Roadmap Overview
### Phase 1: MVP
- [Feature 1]
- [Feature 2]
### Phase 2: Enhancement
- [Feature 3]
- [Feature 4]
`,
contentFormat: "markdown"
})
| Agent | Document Types |
|---|---|
| Business Analyst | BRDs, Feature Specs |
| Product Owner | Vision, Roadmap, Feature Specs |
| Orchestrator | References for context |
| Error | Cause | Resolution |
|---|---|---|
| 400 Bad Request | Invalid markdown | Check formatting |
| 404 Not Found | Parent page missing | Create parent first |
| 409 Conflict | Title exists | Update existing or rename |
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.